alepha 0.20.2 → 0.20.3

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/lock/core/providers/LockProvider.ts","../../../src/lock/core/providers/LockTopicProvider.ts","../../../src/lock/core/providers/MemoryLockProvider.ts","../../../src/lock/core/errors/LockAcquireError.ts","../../../src/lock/core/primitives/$lock.ts","../../../src/lock/core/index.ts"],"sourcesContent":["/**\n * Store Provider Interface\n */\nexport abstract class LockProvider {\n  /**\n   * Set the string value of a key.\n   *\n   * @param key The key of the value to set.\n   * @param value The value to set.\n   * @param nx If set to true, the key will only be set if it does not already exist.\n   * @param px Set the specified expire time, in milliseconds.\n   */\n  public abstract set(\n    key: string,\n    value: string,\n    nx?: boolean,\n    px?: number,\n  ): Promise<string>;\n\n  /**\n   * Remove the specified keys.\n   *\n   * @param keys The keys to delete.\n   */\n  public abstract del(...keys: string[]): Promise<void>;\n}\n","import { TopicProvider } from \"alepha/topic\";\n\nexport abstract class LockTopicProvider extends TopicProvider {}\n","import { $inject } from \"alepha\";\nimport { DateTimeProvider, type Timeout } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport type { LockProvider } from \"./LockProvider.ts\";\n\n/**\n * A simple in-memory store provider.\n */\nexport class MemoryLockProvider implements LockProvider {\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly log = $logger();\n\n  /**\n   * The in-memory store.\n   */\n  protected store: Record<string, string> = {};\n\n  /**\n   * Timeouts used to expire keys.\n   */\n  protected storeTimeout: Record<string, Timeout> = {};\n\n  public async set(\n    key: string,\n    value: string,\n    nx?: boolean,\n    px?: number,\n  ): Promise<string> {\n    if (nx && this.store[key] != null) {\n      return this.store[key];\n    }\n\n    if (px) {\n      this.ttl(key, px);\n    }\n\n    this.store[key] = value;\n\n    return this.store[key];\n  }\n\n  public async del(...keys: string[]): Promise<void> {\n    for (const key of keys) {\n      delete this.store[key];\n      if (this.storeTimeout[key] != null) {\n        this.storeTimeout[key].clear();\n        delete this.storeTimeout[key];\n      }\n    }\n  }\n\n  protected ttl(key: string, ms: number): void {\n    if (this.storeTimeout[key] != null) {\n      this.storeTimeout[key].clear();\n      delete this.storeTimeout[key];\n    }\n\n    this.storeTimeout[key] = this.dateTimeProvider.createTimeout(() => {\n      delete this.store[key];\n      delete this.storeTimeout[key];\n    }, ms);\n  }\n}\n","import { AlephaError } from \"alepha\";\n\nexport class LockAcquireError extends AlephaError {\n  constructor(name: string) {\n    super(`$lock: could not acquire lock '${name}'`);\n  }\n}\n","import {\n  $atom,\n  $context,\n  $inject,\n  $state,\n  AlephaError,\n  type AsyncFn,\n  createMiddleware,\n  type Middleware,\n  Primitive,\n  type Static,\n  t,\n} from \"alepha\";\nimport {\n  type DateTime,\n  DateTimeProvider,\n  type DurationLike,\n} from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { $topic } from \"alepha/topic\";\nimport { LockAcquireError } from \"../errors/LockAcquireError.ts\";\nimport { LockProvider } from \"../providers/LockProvider.ts\";\nimport { LockTopicProvider } from \"../providers/LockTopicProvider.ts\";\n\n/**\n * Distributed lock middleware for `use` arrays in `$action`, `$job`, `$page`, `$pipeline`.\n *\n * Acquires a distributed lock before the handler runs and releases it after completion.\n * Throws `LockAcquireError` if the lock cannot be acquired (unless `wait: true`).\n *\n * ```ts\n * processOrder = $action({\n *   use: [$lock({ name: \"process-order\" })],\n *   handler: async ({ body }) => { ... },\n * });\n * ```\n */\nexport const $lock = (options: LockMiddlewareOptions): Middleware => {\n  const { alepha } = $context();\n  const lockProvider = alepha.inject(LockProvider);\n  const dateTimeProvider = alepha.inject(DateTimeProvider);\n\n  return createMiddleware({\n    name: \"$lock\",\n    options: options as unknown as Record<string, unknown>,\n    handler: ({ next }) => {\n      const id = crypto.randomUUID();\n      const maxDurationMs = dateTimeProvider\n        .duration(options.maxDuration ?? [5, \"minutes\"])\n        .asMilliseconds();\n\n      return async (...args: any[]) => {\n        const name =\n          typeof options.name === \"function\"\n            ? options.name(...args)\n            : options.name;\n        if (!name) {\n          throw new AlephaError(\n            \"$lock middleware requires a name option (no class context available)\",\n          );\n        }\n\n        const value = await lockProvider.set(\n          name,\n          `${id},${dateTimeProvider.nowISOString()}`,\n          true,\n          maxDurationMs,\n        );\n\n        const [lockId, _createdAtStr, endedAtStr] = value.split(\",\");\n\n        // Lock already ended (grace period active)\n        if (endedAtStr) {\n          throw new LockAcquireError(name);\n        }\n\n        // Lock held by someone else\n        if (lockId !== id) {\n          if (options.wait) {\n            // Poll until lock is released\n            const start = dateTimeProvider.nowMillis();\n            while (dateTimeProvider.nowMillis() - start < maxDurationMs) {\n              await dateTimeProvider.wait(500);\n              const current = await lockProvider.set(\n                name,\n                `${id},${dateTimeProvider.nowISOString()}`,\n                true,\n                maxDurationMs,\n              );\n              const [currentId] = current.split(\",\");\n              if (currentId === id) {\n                break;\n              }\n            }\n            // Check if we got the lock\n            const final = await lockProvider.set(\n              name,\n              `${id},${dateTimeProvider.nowISOString()}`,\n              true,\n              maxDurationMs,\n            );\n            const [finalId] = final.split(\",\");\n            if (finalId !== id) {\n              throw new LockAcquireError(name);\n            }\n          } else {\n            throw new LockAcquireError(name);\n          }\n        }\n\n        // We hold the lock — execute handler\n        try {\n          return await next(...args);\n        } finally {\n          await lockProvider.del(name);\n        }\n      };\n    },\n  });\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Options for $lock in middleware mode (no handler).\n */\nexport interface LockMiddlewareOptions {\n  /**\n   * Lock key name. Required in middleware mode (no class context available).\n   * Can be a static string or a function that derives the key from handler args.\n   */\n  name: string | ((...args: any[]) => string);\n\n  /**\n   * Whether to wait for the lock to become available.\n   *\n   * @default false\n   */\n  wait?: boolean;\n\n  /**\n   * Maximum duration the lock can be held before automatic expiration.\n   *\n   * @default [5, \"minutes\"]\n   */\n  maxDuration?: DurationLike;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface LockPrimitiveOptions<TFunc extends AsyncFn> {\n  /**\n   * The function to execute when the lock is successfully acquired.\n   *\n   * This function:\n   * - Only executes on the instance that successfully acquires the lock\n   * - Has exclusive access to the protected resource during execution\n   * - Should contain the critical section logic that must not run concurrently\n   * - Can be async and perform any operations needed\n   * - Will automatically release the lock upon completion or error\n   * - Has access to the full Alepha dependency injection container\n   *\n   * **Handler Design Guidelines**:\n   * - Keep critical sections as short as possible to minimize lock contention\n   * - Include proper error handling to ensure locks are released\n   * - Use timeouts for external operations to prevent deadlocks\n   * - Log important operations for debugging and monitoring\n   * - Consider idempotency for handlers that might be retried\n   *\n   * @param ...args - The arguments passed to the lock execution\n   * @returns Promise that resolves when the protected operation is complete\n   *\n   * @example\n   * ```ts\n   * handler: async (batchId: string) => {\n   *   console.log(`Processing batch ${batchId} - only one instance will run this`);\n   *\n   *   const batch = await this.getBatchData(batchId);\n   *   const results = await this.processBatchItems(batch.items);\n   *   await this.saveBatchResults(batchId, results);\n   *\n   *   console.log(`Batch ${batchId} completed successfully`);\n   * }\n   * ```\n   */\n  handler: TFunc;\n\n  /**\n   * Whether the lock should wait for other instances to complete before giving up.\n   *\n   * **wait = false (default)**:\n   * - Non-blocking behavior - if lock is held, immediately return without executing\n   * - Perfect for scheduled tasks where you only want one execution per trigger\n   * - Use when multiple triggers are acceptable but concurrent execution is not\n   * - Examples: periodic cleanup, cron jobs, background maintenance\n   *\n   * **wait = true**:\n   * - Blocking behavior - wait for the current lock holder to finish\n   * - All instances will eventually execute (one after another)\n   * - Perfect for initialization tasks where all instances need the work completed\n   * - Examples: database migrations, cache warming, resource initialization\n   *\n   * **Trade-offs**:\n   * - Non-waiting: Better performance, may miss executions if timing is off\n   * - Waiting: Guaranteed execution order, slower overall throughput\n   *\n   * @default false\n   *\n   * @example\n   * ```ts\n   * // Scheduled task - don't wait, just skip if already running\n   * scheduledCleanup = $lock({\n   *   wait: false,  // Skip if cleanup already running\n   *   handler: async () => { } // perform cleanup\n   * });\n   *\n   * // Migration - wait for completion before proceeding\n   * migration = $lock({\n   *   wait: true,   // All instances wait for migration to complete\n   *   handler: async () => { } // perform migration\n   * });\n   * ```\n   */\n  wait?: boolean;\n\n  /**\n   * The unique identifier for the lock.\n   *\n   * Can be either:\n   * - **Static string**: A fixed identifier for the lock\n   * - **Dynamic function**: A function that generates the lock key based on arguments\n   *\n   * **Dynamic Lock Keys**:\n   * - Enable per-resource locking (e.g., per-user, per-file, per-product)\n   * - Allow fine-grained concurrency control\n   * - Prevent unnecessary blocking between unrelated operations\n   *\n   * **Key Design Guidelines**:\n   * - Use descriptive names that indicate the protected resource\n   * - Include relevant identifiers for dynamic keys\n   * - Keep keys reasonably short but unique\n   * - Consider using hierarchical naming (e.g., \"service:operation:resource\")\n   *\n   * If not provided, defaults to `{serviceName}:{propertyKey}`.\n   *\n   * @example \"user-migration\"\n   * @example \"daily-report-generation\"\n   * @example (userId: string) => `user-profile-update:${userId}`\n   * @example (fileId: string, operation: string) => `file-${operation}:${fileId}`\n   *\n   * @example\n   * ```ts\n   * // Static lock key - all instances compete for the same lock\n   * globalCleanup = $lock({\n   *   name: \"system-cleanup\",\n   *   handler: async () => { } // perform cleanup\n   * });\n   *\n   * // Dynamic lock key - per-user locks, users don't block each other\n   * updateUserProfile = $lock({\n   *   name: (userId: string) => `user-update:${userId}`,\n   *   handler: async (userId: string, data: UserData) => {\n   *     // Only one update per user at a time, but different users can update concurrently\n   *   }\n   * });\n   * ```\n   */\n  name?: string | ((...args: Parameters<TFunc>) => string);\n\n  /**\n   * Maximum duration the lock can be held before it expires automatically.\n   *\n   * This prevents deadlocks when a process dies while holding a lock or when\n   * operations take longer than expected. The lock will be automatically released\n   * after this duration, allowing other instances to proceed.\n   *\n   * **Duration Guidelines**:\n   * - Set based on expected operation duration plus safety margin\n   * - Too short: Operations may be interrupted by early expiration\n   * - Too long: Failed processes block others for extended periods\n   * - Consider worst-case scenarios and external dependency timeouts\n   *\n   * **Typical Values**:\n   * - Quick operations: 30 seconds - 2 minutes\n   * - Database operations: 5 - 15 minutes\n   * - File processing: 10 - 30 minutes\n   * - Large migrations: 30 minutes - 2 hours\n   *\n   * @default [5, \"minutes\"]\n   *\n   * @example [30, \"seconds\"]    // Quick operations\n   * @example [10, \"minutes\"]    // Database migrations\n   * @example [1, \"hour\"]        // Long-running batch jobs\n   *\n   * @example\n   * ```ts\n   * quickTask = $lock({\n   *   maxDuration: [2, \"minutes\"],  // Quick timeout for fast operations\n   *   handler: async () => { } // perform quick task\n   * });\n   *\n   * heavyProcessing = $lock({\n   *   maxDuration: [30, \"minutes\"], // Longer timeout for heavy work\n   *   handler: async () => { } // perform heavy processing\n   * });\n   * ```\n   */\n  maxDuration?: DurationLike;\n\n  /**\n   * Additional time to keep the lock active after the handler completes successfully.\n   *\n   * This provides a \"cooling off\" period that can be useful for:\n   * - Preventing immediate re-execution of the same operation\n   * - Giving time for related systems to process the results\n   * - Avoiding race conditions with dependent operations\n   * - Providing a buffer for cleanup operations\n   *\n   * Can be either:\n   * - **Static duration**: Fixed grace period for all executions\n   * - **Dynamic function**: Grace period determined by execution arguments\n   * - **undefined**: No grace period, lock released immediately after completion\n   *\n   * **Grace Period Use Cases**:\n   * - File processing: Prevent immediate reprocessing of uploaded files\n   * - Cache updates: Allow time for cache propagation\n   * - Batch operations: Prevent overlapping batch processing\n   * - External API calls: Respect rate limiting requirements\n   *\n   * @default undefined (no grace period)\n   *\n   * @example [5, \"minutes\"]     // Fixed 5-minute grace period\n   * @example [30, \"seconds\"]    // Short grace for quick operations\n   * @example (userId: string) => userId.startsWith(\"premium\") ? [10, \"minutes\"] : [2, \"minutes\"]\n   *\n   * @example\n   * ```ts\n   * fileProcessor = $lock({\n   *   gracePeriod: [10, \"minutes\"],  // Prevent reprocessing same file immediately\n   *   handler: async (filePath: string) => {\n   *     await this.processFile(filePath);\n   *   }\n   * });\n   *\n   * userOperation = $lock({\n   *   gracePeriod: (userId: string, operation: string) => {\n   *     // Dynamic grace based on operation type\n   *     return operation === 'migration' ? [30, \"minutes\"] : [5, \"minutes\"];\n   *   },\n   *   handler: async (userId: string, operation: string) => {\n   *     await this.performUserOperation(userId, operation);\n   *   }\n   * });\n   * ```\n   */\n  gracePeriod?:\n    | ((...args: Parameters<TFunc>) => DurationLike | undefined)\n    | DurationLike;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Lock configuration atom.\n */\nexport const lockOptions = $atom({\n  name: \"alepha.lock.options\",\n  schema: t.object({\n    prefixKey: t.text({\n      default: \"\",\n      description: \"Prefix for all lock keys.\",\n    }),\n  }),\n  default: {\n    prefixKey: \"\",\n  },\n});\n\nexport type LockAtomOptions = Static<typeof lockOptions.schema>;\n\ndeclare module \"alepha\" {\n  interface State {\n    [lockOptions.key]: LockAtomOptions;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class LockPrimitive<TFunc extends AsyncFn> extends Primitive<\n  LockPrimitiveOptions<TFunc>\n> {\n  protected readonly log = $logger();\n  protected readonly provider = $inject(LockProvider);\n  protected readonly settings = $state(lockOptions);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n\n  /**\n   * Lazy-initialized UUID to avoid calling crypto.randomUUID() in global scope.\n   * Cloudflare Workers doesn't allow random value generation during initialization.\n   */\n  protected _id?: string;\n  protected get id(): string {\n    if (!this._id) {\n      this._id = crypto.randomUUID();\n    }\n    return this._id;\n  }\n\n  public readonly maxDuration = this.dateTimeProvider.duration(\n    this.options.maxDuration ?? [5, \"minutes\"],\n  );\n\n  protected readonly topicLockEnd = $topic({\n    name: `${this.settings.prefixKey}lock:end`,\n    provider: LockTopicProvider,\n    schema: {\n      payload: t.object({\n        name: t.text(),\n      }),\n    },\n  });\n\n  public async run(...args: Parameters<TFunc>): Promise<void> {\n    const key = this.key(...args);\n    const handler = this.options.handler;\n\n    const lock = await this.lock(key);\n    if (lock.endedAt) {\n      return;\n    }\n\n    if (lock.id !== this.id) {\n      if (this.options.wait) {\n        // Poll until the lock is released, then re-attempt\n        const start = this.dateTimeProvider.nowMillis();\n        const maxMs = this.maxDuration.as(\"milliseconds\");\n        let acquired = false;\n        while (this.dateTimeProvider.nowMillis() - start < maxMs) {\n          await this.dateTimeProvider.wait(500);\n          const current = await this.lock(key);\n          if (current.id === this.id || !current.id || current.endedAt) {\n            acquired = true;\n            break;\n          }\n        }\n        if (acquired) {\n          return this.run(...args);\n        }\n        this.log.warn(`Lock wait timeout for '${key}', giving up`);\n      }\n\n      return;\n    }\n\n    this.log.debug(`Lock '${key}' ...`);\n\n    try {\n      await handler(...args);\n    } finally {\n      await this.topicLockEnd.publish({\n        name: key,\n      });\n\n      await this.setGracePeriod(key, lock, ...args);\n\n      this.log.debug(`Lock '${key}' OK`);\n    }\n  }\n\n  /**\n   * Set the lock for the given key.\n   */\n  protected async lock(key: string): Promise<LockResult> {\n    const value = await this.provider.set(\n      key,\n      `${this.id},${this.dateTimeProvider.nowISOString()}`,\n      true,\n      this.maxDuration.as(\"milliseconds\"),\n    );\n\n    return this.parse(value);\n  }\n\n  protected async setGracePeriod(\n    key: string,\n    lock: LockResult,\n    ...args: Parameters<TFunc>\n  ): Promise<void> {\n    const gracePeriod = this.options.gracePeriod\n      ? this.dateTimeProvider.isDurationLike(this.options.gracePeriod)\n        ? this.options.gracePeriod\n        : this.options.gracePeriod(...args)\n      : undefined;\n\n    if (gracePeriod) {\n      await this.provider.set(\n        key,\n        `${this.id},${lock.createdAt.toISOString()},${this.dateTimeProvider.nowISOString()}`,\n        false,\n        this.dateTimeProvider.duration(gracePeriod).as(\"milliseconds\"),\n      );\n    } else {\n      await this.provider.del(key);\n    }\n  }\n\n  protected async wait(key: string, maxDuration: DurationLike): Promise<void> {\n    this.log.debug(`Wait for lock '${key}' ...`);\n\n    await this.topicLockEnd.wait({\n      filter: (message) => message.payload.name === key,\n      timeout: maxDuration,\n    });\n\n    this.log.debug(`Wait for lock '${key}' OK`);\n  }\n\n  protected key(...args: Parameters<TFunc>) {\n    let base = \"\";\n\n    if (this.options.name) {\n      if (typeof this.options.name === \"string\") {\n        base = this.options.name;\n      } else {\n        base = this.options.name(...args);\n      }\n    } else {\n      base = `${this.config.service.name}:${this.config.propertyKey}`;\n    }\n\n    return `${this.settings.prefixKey}${base}`;\n  }\n\n  protected parse(value: string): LockResult {\n    const [id, createdAtStr, endedAtStr] = value.split(\",\");\n    const createdAt = this.dateTimeProvider.of(createdAtStr);\n    const endedAt = endedAtStr\n      ? this.dateTimeProvider.of(endedAtStr)\n      : undefined;\n\n    return {\n      id,\n      createdAt,\n      endedAt,\n    };\n  }\n}\n\nexport interface LockResult {\n  id: string;\n  createdAt: DateTime;\n  endedAt?: DateTime;\n  response?: string;\n}\n","import { $module } from \"alepha\";\nimport { MemoryTopicProvider } from \"alepha/topic\";\nimport { LockProvider } from \"./providers/LockProvider.ts\";\nimport { LockTopicProvider } from \"./providers/LockTopicProvider.ts\";\nimport { MemoryLockProvider } from \"./providers/MemoryLockProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./primitives/$lock.ts\";\nexport * from \"./providers/LockProvider.ts\";\nexport * from \"./providers/LockTopicProvider.ts\";\nexport * from \"./providers/MemoryLockProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Resource locking for distributed systems.\n *\n * **Features:**\n * - Distributed locks with timeout\n * - Time-based lock expiration\n * - Automatic release on scope exit\n * - Distributed coordination via Redis\n * - Providers: Memory (dev), Redis (production)\n *\n * @module alepha.lock\n */\nexport const AlephaLock = $module({\n  name: \"alepha.lock\",\n  services: [LockProvider, LockTopicProvider],\n  variants: [MemoryLockProvider],\n  register: (alepha) =>\n    alepha\n      .with({\n        optional: true,\n        provide: LockTopicProvider,\n        use: MemoryTopicProvider,\n      })\n      .with({\n        optional: true,\n        provide: LockProvider,\n        use: MemoryLockProvider,\n      }),\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/lock/core/providers/LockProvider.ts","../../../src/lock/core/providers/LockTopicProvider.ts","../../../src/lock/core/providers/MemoryLockProvider.ts","../../../src/lock/core/errors/LockAcquireError.ts","../../../src/lock/core/primitives/$lock.ts","../../../src/lock/core/index.ts"],"sourcesContent":["/**\n * Store Provider Interface\n */\nexport abstract class LockProvider {\n  /**\n   * Set the string value of a key.\n   *\n   * @param key The key of the value to set.\n   * @param value The value to set.\n   * @param nx If set to true, the key will only be set if it does not already exist.\n   * @param px Set the specified expire time, in milliseconds.\n   */\n  public abstract set(\n    key: string,\n    value: string,\n    nx?: boolean,\n    px?: number,\n  ): Promise<string>;\n\n  /**\n   * Remove the specified keys.\n   *\n   * @param keys The keys to delete.\n   */\n  public abstract del(...keys: string[]): Promise<void>;\n}\n","import { TopicProvider } from \"alepha/topic\";\n\nexport abstract class LockTopicProvider extends TopicProvider {}\n","import { $inject } from \"alepha\";\nimport { DateTimeProvider, type Timeout } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport type { LockProvider } from \"./LockProvider.ts\";\n\n/**\n * A simple in-memory store provider.\n */\nexport class MemoryLockProvider implements LockProvider {\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly log = $logger();\n\n  /**\n   * The in-memory store.\n   */\n  protected store: Record<string, string> = {};\n\n  /**\n   * Timeouts used to expire keys.\n   */\n  protected storeTimeout: Record<string, Timeout> = {};\n\n  public async set(\n    key: string,\n    value: string,\n    nx?: boolean,\n    px?: number,\n  ): Promise<string> {\n    if (nx && this.store[key] != null) {\n      return this.store[key];\n    }\n\n    if (px) {\n      this.ttl(key, px);\n    }\n\n    this.store[key] = value;\n\n    return this.store[key];\n  }\n\n  public async del(...keys: string[]): Promise<void> {\n    for (const key of keys) {\n      delete this.store[key];\n      if (this.storeTimeout[key] != null) {\n        this.storeTimeout[key].clear();\n        delete this.storeTimeout[key];\n      }\n    }\n  }\n\n  protected ttl(key: string, ms: number): void {\n    if (this.storeTimeout[key] != null) {\n      this.storeTimeout[key].clear();\n      delete this.storeTimeout[key];\n    }\n\n    this.storeTimeout[key] = this.dateTimeProvider.createTimeout(() => {\n      delete this.store[key];\n      delete this.storeTimeout[key];\n    }, ms);\n  }\n}\n","import { AlephaError } from \"alepha\";\n\nexport class LockAcquireError extends AlephaError {\n  constructor(name: string) {\n    super(`$lock: could not acquire lock '${name}'`);\n  }\n}\n","import {\n  $atom,\n  $context,\n  $inject,\n  $state,\n  AlephaError,\n  type AsyncFn,\n  createMiddleware,\n  type Middleware,\n  Primitive,\n  type Static,\n  t,\n} from \"alepha\";\nimport {\n  type DateTime,\n  DateTimeProvider,\n  type DurationLike,\n} from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { $topic } from \"alepha/topic\";\nimport { LockAcquireError } from \"../errors/LockAcquireError.ts\";\nimport { LockProvider } from \"../providers/LockProvider.ts\";\nimport { LockTopicProvider } from \"../providers/LockTopicProvider.ts\";\n\n/**\n * Distributed lock middleware for `use` arrays in `$action`, `$job`, `$page`, `$pipeline`.\n *\n * Acquires a distributed lock before the handler runs and releases it after completion.\n * Throws `LockAcquireError` if the lock cannot be acquired (unless `wait: true`).\n *\n * ```ts\n * processOrder = $action({\n *   use: [$lock({ name: \"process-order\" })],\n *   handler: async ({ body }) => { ... },\n * });\n * ```\n */\nexport const $lock = (options: LockMiddlewareOptions): Middleware => {\n  const { alepha } = $context();\n  const lockProvider = alepha.inject(LockProvider);\n  const dateTimeProvider = alepha.inject(DateTimeProvider);\n\n  return createMiddleware({\n    name: \"$lock\",\n    options: options as unknown as Record<string, unknown>,\n    handler: ({ next }) => {\n      const id = crypto.randomUUID();\n      const maxDurationMs = dateTimeProvider\n        .duration(options.maxDuration ?? [5, \"minutes\"])\n        .asMilliseconds();\n\n      return async (...args: any[]) => {\n        const name =\n          typeof options.name === \"function\"\n            ? options.name(...args)\n            : options.name;\n        if (!name) {\n          throw new AlephaError(\n            \"$lock middleware requires a name option (no class context available)\",\n          );\n        }\n\n        const value = await lockProvider.set(\n          name,\n          `${id},${dateTimeProvider.nowISOString()}`,\n          true,\n          maxDurationMs,\n        );\n\n        const [lockId, _createdAtStr, endedAtStr] = value.split(\",\");\n\n        // Lock already ended (grace period active)\n        if (endedAtStr) {\n          throw new LockAcquireError(name);\n        }\n\n        // Lock held by someone else\n        if (lockId !== id) {\n          if (options.wait) {\n            // Poll until lock is released\n            const start = dateTimeProvider.nowMillis();\n            while (dateTimeProvider.nowMillis() - start < maxDurationMs) {\n              await dateTimeProvider.wait(500);\n              const current = await lockProvider.set(\n                name,\n                `${id},${dateTimeProvider.nowISOString()}`,\n                true,\n                maxDurationMs,\n              );\n              const [currentId] = current.split(\",\");\n              if (currentId === id) {\n                break;\n              }\n            }\n            // Check if we got the lock\n            const final = await lockProvider.set(\n              name,\n              `${id},${dateTimeProvider.nowISOString()}`,\n              true,\n              maxDurationMs,\n            );\n            const [finalId] = final.split(\",\");\n            if (finalId !== id) {\n              throw new LockAcquireError(name);\n            }\n          } else {\n            throw new LockAcquireError(name);\n          }\n        }\n\n        // We hold the lock — execute handler\n        try {\n          return await next(...args);\n        } finally {\n          await lockProvider.del(name);\n        }\n      };\n    },\n  });\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Options for $lock in middleware mode (no handler).\n */\nexport interface LockMiddlewareOptions {\n  /**\n   * Lock key name. Required in middleware mode (no class context available).\n   * Can be a static string or a function that derives the key from handler args.\n   */\n  name: string | ((...args: any[]) => string);\n\n  /**\n   * Whether to wait for the lock to become available.\n   *\n   * @default false\n   */\n  wait?: boolean;\n\n  /**\n   * Maximum duration the lock can be held before automatic expiration.\n   *\n   * @default [5, \"minutes\"]\n   */\n  maxDuration?: DurationLike;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface LockPrimitiveOptions<TFunc extends AsyncFn> {\n  /**\n   * The function to execute when the lock is successfully acquired.\n   *\n   * This function:\n   * - Only executes on the instance that successfully acquires the lock\n   * - Has exclusive access to the protected resource during execution\n   * - Should contain the critical section logic that must not run concurrently\n   * - Can be async and perform any operations needed\n   * - Will automatically release the lock upon completion or error\n   * - Has access to the full Alepha dependency injection container\n   *\n   * **Handler Design Guidelines**:\n   * - Keep critical sections as short as possible to minimize lock contention\n   * - Include proper error handling to ensure locks are released\n   * - Use timeouts for external operations to prevent deadlocks\n   * - Log important operations for debugging and monitoring\n   * - Consider idempotency for handlers that might be retried\n   *\n   * @param ...args - The arguments passed to the lock execution\n   * @returns Promise that resolves when the protected operation is complete\n   *\n   * @example\n   * ```ts\n   * handler: async (batchId: string) => {\n   *   console.log(`Processing batch ${batchId} - only one instance will run this`);\n   *\n   *   const batch = await this.getBatchData(batchId);\n   *   const results = await this.processBatchItems(batch.items);\n   *   await this.saveBatchResults(batchId, results);\n   *\n   *   console.log(`Batch ${batchId} completed successfully`);\n   * }\n   * ```\n   */\n  handler: TFunc;\n\n  /**\n   * Whether the lock should wait for other instances to complete before giving up.\n   *\n   * **wait = false (default)**:\n   * - Non-blocking behavior - if lock is held, immediately return without executing\n   * - Perfect for scheduled tasks where you only want one execution per trigger\n   * - Use when multiple triggers are acceptable but concurrent execution is not\n   * - Examples: periodic cleanup, cron jobs, background maintenance\n   *\n   * **wait = true**:\n   * - Blocking behavior - wait for the current lock holder to finish\n   * - All instances will eventually execute (one after another)\n   * - Perfect for initialization tasks where all instances need the work completed\n   * - Examples: database migrations, cache warming, resource initialization\n   *\n   * **Trade-offs**:\n   * - Non-waiting: Better performance, may miss executions if timing is off\n   * - Waiting: Guaranteed execution order, slower overall throughput\n   *\n   * @default false\n   *\n   * @example\n   * ```ts\n   * // Scheduled task - don't wait, just skip if already running\n   * scheduledCleanup = $lock({\n   *   wait: false,  // Skip if cleanup already running\n   *   handler: async () => { } // perform cleanup\n   * });\n   *\n   * // Migration - wait for completion before proceeding\n   * migration = $lock({\n   *   wait: true,   // All instances wait for migration to complete\n   *   handler: async () => { } // perform migration\n   * });\n   * ```\n   */\n  wait?: boolean;\n\n  /**\n   * The unique identifier for the lock.\n   *\n   * Can be either:\n   * - **Static string**: A fixed identifier for the lock\n   * - **Dynamic function**: A function that generates the lock key based on arguments\n   *\n   * **Dynamic Lock Keys**:\n   * - Enable per-resource locking (e.g., per-user, per-file, per-product)\n   * - Allow fine-grained concurrency control\n   * - Prevent unnecessary blocking between unrelated operations\n   *\n   * **Key Design Guidelines**:\n   * - Use descriptive names that indicate the protected resource\n   * - Include relevant identifiers for dynamic keys\n   * - Keep keys reasonably short but unique\n   * - Consider using hierarchical naming (e.g., \"service:operation:resource\")\n   *\n   * If not provided, defaults to `{serviceName}:{propertyKey}`.\n   *\n   * @example \"user-migration\"\n   * @example \"daily-report-generation\"\n   * @example (userId: string) => `user-profile-update:${userId}`\n   * @example (fileId: string, operation: string) => `file-${operation}:${fileId}`\n   *\n   * @example\n   * ```ts\n   * // Static lock key - all instances compete for the same lock\n   * globalCleanup = $lock({\n   *   name: \"system-cleanup\",\n   *   handler: async () => { } // perform cleanup\n   * });\n   *\n   * // Dynamic lock key - per-user locks, users don't block each other\n   * updateUserProfile = $lock({\n   *   name: (userId: string) => `user-update:${userId}`,\n   *   handler: async (userId: string, data: UserData) => {\n   *     // Only one update per user at a time, but different users can update concurrently\n   *   }\n   * });\n   * ```\n   */\n  name?: string | ((...args: Parameters<TFunc>) => string);\n\n  /**\n   * Maximum duration the lock can be held before it expires automatically.\n   *\n   * This prevents deadlocks when a process dies while holding a lock or when\n   * operations take longer than expected. The lock will be automatically released\n   * after this duration, allowing other instances to proceed.\n   *\n   * **Duration Guidelines**:\n   * - Set based on expected operation duration plus safety margin\n   * - Too short: Operations may be interrupted by early expiration\n   * - Too long: Failed processes block others for extended periods\n   * - Consider worst-case scenarios and external dependency timeouts\n   *\n   * **Typical Values**:\n   * - Quick operations: 30 seconds - 2 minutes\n   * - Database operations: 5 - 15 minutes\n   * - File processing: 10 - 30 minutes\n   * - Large migrations: 30 minutes - 2 hours\n   *\n   * @default [5, \"minutes\"]\n   *\n   * @example [30, \"seconds\"]    // Quick operations\n   * @example [10, \"minutes\"]    // Database migrations\n   * @example [1, \"hour\"]        // Long-running batch jobs\n   *\n   * @example\n   * ```ts\n   * quickTask = $lock({\n   *   maxDuration: [2, \"minutes\"],  // Quick timeout for fast operations\n   *   handler: async () => { } // perform quick task\n   * });\n   *\n   * heavyProcessing = $lock({\n   *   maxDuration: [30, \"minutes\"], // Longer timeout for heavy work\n   *   handler: async () => { } // perform heavy processing\n   * });\n   * ```\n   */\n  maxDuration?: DurationLike;\n\n  /**\n   * Additional time to keep the lock active after the handler completes successfully.\n   *\n   * This provides a \"cooling off\" period that can be useful for:\n   * - Preventing immediate re-execution of the same operation\n   * - Giving time for related systems to process the results\n   * - Avoiding race conditions with dependent operations\n   * - Providing a buffer for cleanup operations\n   *\n   * Can be either:\n   * - **Static duration**: Fixed grace period for all executions\n   * - **Dynamic function**: Grace period determined by execution arguments\n   * - **undefined**: No grace period, lock released immediately after completion\n   *\n   * **Grace Period Use Cases**:\n   * - File processing: Prevent immediate reprocessing of uploaded files\n   * - Cache updates: Allow time for cache propagation\n   * - Batch operations: Prevent overlapping batch processing\n   * - External API calls: Respect rate limiting requirements\n   *\n   * @default undefined (no grace period)\n   *\n   * @example [5, \"minutes\"]     // Fixed 5-minute grace period\n   * @example [30, \"seconds\"]    // Short grace for quick operations\n   * @example (userId: string) => userId.startsWith(\"premium\") ? [10, \"minutes\"] : [2, \"minutes\"]\n   *\n   * @example\n   * ```ts\n   * fileProcessor = $lock({\n   *   gracePeriod: [10, \"minutes\"],  // Prevent reprocessing same file immediately\n   *   handler: async (filePath: string) => {\n   *     await this.processFile(filePath);\n   *   }\n   * });\n   *\n   * userOperation = $lock({\n   *   gracePeriod: (userId: string, operation: string) => {\n   *     // Dynamic grace based on operation type\n   *     return operation === 'migration' ? [30, \"minutes\"] : [5, \"minutes\"];\n   *   },\n   *   handler: async (userId: string, operation: string) => {\n   *     await this.performUserOperation(userId, operation);\n   *   }\n   * });\n   * ```\n   */\n  gracePeriod?:\n    | ((...args: Parameters<TFunc>) => DurationLike | undefined)\n    | DurationLike;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Lock configuration atom.\n */\nexport const lockOptions = $atom({\n  name: \"alepha.lock.options\",\n  schema: t.object({\n    prefixKey: t.text({\n      default: \"\",\n      description: \"Prefix for all lock keys.\",\n    }),\n  }),\n  default: {\n    prefixKey: \"\",\n  },\n});\n\nexport type LockAtomOptions = Static<typeof lockOptions.schema>;\n\ndeclare module \"alepha\" {\n  interface State {\n    [lockOptions.key]: LockAtomOptions;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class LockPrimitive<TFunc extends AsyncFn> extends Primitive<\n  LockPrimitiveOptions<TFunc>\n> {\n  protected readonly log = $logger();\n  protected readonly provider = $inject(LockProvider);\n  protected readonly settings = $state(lockOptions);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n\n  /**\n   * Lazy-initialized UUID to avoid calling crypto.randomUUID() in global scope.\n   * Cloudflare Workers doesn't allow random value generation during initialization.\n   */\n  protected _id?: string;\n  protected get id(): string {\n    if (!this._id) {\n      this._id = crypto.randomUUID();\n    }\n    return this._id;\n  }\n\n  public readonly maxDuration = this.dateTimeProvider.duration(\n    this.options.maxDuration ?? [5, \"minutes\"],\n  );\n\n  protected readonly topicLockEnd = $topic({\n    name: `${this.settings.prefixKey}lock:end`,\n    provider: LockTopicProvider,\n    schema: {\n      payload: t.object({\n        name: t.text(),\n      }),\n    },\n  });\n\n  public async run(...args: Parameters<TFunc>): Promise<void> {\n    const key = this.key(...args);\n    const handler = this.options.handler;\n\n    const lock = await this.lock(key);\n    if (lock.endedAt) {\n      return;\n    }\n\n    if (lock.id !== this.id) {\n      if (this.options.wait) {\n        // Poll until the lock is released, then re-attempt\n        const start = this.dateTimeProvider.nowMillis();\n        const maxMs = this.maxDuration.as(\"milliseconds\");\n        let acquired = false;\n        while (this.dateTimeProvider.nowMillis() - start < maxMs) {\n          await this.dateTimeProvider.wait(500);\n          const current = await this.lock(key);\n          if (current.id === this.id || !current.id || current.endedAt) {\n            acquired = true;\n            break;\n          }\n        }\n        if (acquired) {\n          return this.run(...args);\n        }\n        this.log.warn(`Lock wait timeout for '${key}', giving up`);\n      }\n\n      return;\n    }\n\n    this.log.debug(`Lock '${key}' ...`);\n\n    try {\n      await handler(...args);\n    } finally {\n      await this.topicLockEnd.publish({\n        name: key,\n      });\n\n      await this.setGracePeriod(key, lock, ...args);\n\n      this.log.debug(`Lock '${key}' OK`);\n    }\n  }\n\n  /**\n   * Set the lock for the given key.\n   */\n  protected async lock(key: string): Promise<LockResult> {\n    const value = await this.provider.set(\n      key,\n      `${this.id},${this.dateTimeProvider.nowISOString()}`,\n      true,\n      this.maxDuration.as(\"milliseconds\"),\n    );\n\n    return this.parse(value);\n  }\n\n  protected async setGracePeriod(\n    key: string,\n    lock: LockResult,\n    ...args: Parameters<TFunc>\n  ): Promise<void> {\n    const gracePeriod = this.options.gracePeriod\n      ? this.dateTimeProvider.isDurationLike(this.options.gracePeriod)\n        ? this.options.gracePeriod\n        : this.options.gracePeriod(...args)\n      : undefined;\n\n    if (gracePeriod) {\n      await this.provider.set(\n        key,\n        `${this.id},${lock.createdAt.toISOString()},${this.dateTimeProvider.nowISOString()}`,\n        false,\n        this.dateTimeProvider.duration(gracePeriod).as(\"milliseconds\"),\n      );\n    } else {\n      await this.provider.del(key);\n    }\n  }\n\n  protected async wait(key: string, maxDuration: DurationLike): Promise<void> {\n    this.log.debug(`Wait for lock '${key}' ...`);\n\n    await this.topicLockEnd.wait({\n      filter: (message) => message.payload.name === key,\n      timeout: maxDuration,\n    });\n\n    this.log.debug(`Wait for lock '${key}' OK`);\n  }\n\n  protected key(...args: Parameters<TFunc>) {\n    let base = \"\";\n\n    if (this.options.name) {\n      if (typeof this.options.name === \"string\") {\n        base = this.options.name;\n      } else {\n        base = this.options.name(...args);\n      }\n    } else {\n      base = `${this.config.service.name}:${this.config.propertyKey}`;\n    }\n\n    return `${this.settings.prefixKey}${base}`;\n  }\n\n  protected parse(value: string): LockResult {\n    const [id, createdAtStr, endedAtStr] = value.split(\",\");\n    const createdAt = this.dateTimeProvider.of(createdAtStr);\n    const endedAt = endedAtStr\n      ? this.dateTimeProvider.of(endedAtStr)\n      : undefined;\n\n    return {\n      id,\n      createdAt,\n      endedAt,\n    };\n  }\n}\n\nexport interface LockResult {\n  id: string;\n  createdAt: DateTime;\n  endedAt?: DateTime;\n  response?: string;\n}\n","import { $module } from \"alepha\";\nimport { MemoryTopicProvider } from \"alepha/topic\";\nimport { LockProvider } from \"./providers/LockProvider.ts\";\nimport { LockTopicProvider } from \"./providers/LockTopicProvider.ts\";\nimport { MemoryLockProvider } from \"./providers/MemoryLockProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./primitives/$lock.ts\";\nexport * from \"./providers/LockProvider.ts\";\nexport * from \"./providers/LockTopicProvider.ts\";\nexport * from \"./providers/MemoryLockProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Resource locking for distributed systems.\n *\n * **Features:**\n * - Distributed locks with timeout\n * - Time-based lock expiration\n * - Automatic release on scope exit\n * - Distributed coordination via Redis\n * - Providers: Memory (dev), Redis (production)\n *\n * @module alepha.lock\n */\nexport const AlephaLock = $module({\n  name: \"alepha.lock\",\n  services: [LockProvider, LockTopicProvider],\n  variants: [MemoryLockProvider],\n  register: (alepha) =>\n    alepha\n      .with({\n        optional: true,\n        provide: LockTopicProvider,\n        use: MemoryTopicProvider,\n      })\n      .with({\n        optional: true,\n        provide: LockProvider,\n        use: MemoryLockProvider,\n      }),\n});\n"],"mappings":"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"}

package/dist/lock/redis/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/lock/redis/providers/RedisLockProvider.ts","../../../src/lock/redis/index.ts"],"sourcesContent":["import { $inject } from \"alepha\";\nimport type { LockProvider } from \"alepha/lock\";\nimport { $logger } from \"alepha/logger\";\nimport { RedisProvider, type RedisSetOptions } from \"alepha/redis\";\n\nexport class RedisLockProvider implements LockProvider {\n  protected readonly log = $logger();\n  protected readonly redisProvider = $inject(RedisProvider);\n\n  public async set(\n    key: string,\n    value: string,\n    nx?: boolean,\n    px?: number,\n  ): Promise<string> {\n    const options: RedisSetOptions = {\n      GET: true, // all the secrets of $lock is based on this\n    };\n\n    if (px) {\n      options.expiration = {\n        type: \"PX\",\n        value: px,\n      };\n    }\n\n    if (nx) {\n      options.condition = \"NX\";\n    }\n\n    const resp = await this.redisProvider.set(key, value, options);\n\n    return resp.toString(\"utf-8\");\n  }\n\n  public async del(...keys: string[]): Promise<void> {\n    await this.redisProvider.del(keys);\n  }\n}\n","import { $module, type Alepha } from \"alepha\";\nimport { AlephaLock, LockProvider, LockTopicProvider } from \"alepha/lock\";\nimport { RedisTopicProvider } from \"alepha/topic/redis\";\nimport { RedisLockProvider } from \"./providers/RedisLockProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./providers/RedisLockProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Plugin for Alepha that provides a locking mechanism.\n *\n * @see {@link RedisLockProvider}\n * @module alepha.lock.redis\n */\nexport const AlephaLockRedis = $module({\n  name: \"alepha.lock.redis\",\n  services: [RedisLockProvider, RedisTopicProvider],\n  register: (alepha: Alepha) =>\n    alepha\n      .with({\n        optional: true,\n        provide: LockTopicProvider,\n        use: RedisTopicProvider,\n      })\n      .with({\n        optional: true,\n        provide: LockProvider,\n        use: RedisLockProvider,\n      })\n      .with(AlephaLock),\n});\n"],"mappings":";;;;;;AAKA,IAAa,oBAAb,MAAuD;CACrD,MAAyB,SAAS;CAClC,gBAAmC,QAAQ,cAAc;CAEzD,MAAa,IACX,KACA,OACA,IACA,IACiB;EACjB,MAAM,UAA2B,EAC/B,KAAK,MACN;AAED,MAAI,GACF,SAAQ,aAAa;GACnB,MAAM;GACN,OAAO;GACR;AAGH,MAAI,GACF,SAAQ,YAAY;AAKtB,UAFa,MAAM,KAAK,cAAc,IAAI,KAAK,OAAO,QAAQ,EAElD,SAAS,QAAQ;;CAG/B,MAAa,IAAI,GAAG,MAA+B;AACjD,QAAM,KAAK,cAAc,IAAI,KAAK;;;;;;;;;;;ACnBtC,MAAa,kBAAkB,QAAQ;CACrC,MAAM;CACN,UAAU,CAAC,mBAAmB,mBAAmB;CACjD,WAAW,WACT,OACG,KAAK;EACJ,UAAU;EACV,SAAS;EACT,KAAK;EACN,CAAC,CACD,KAAK;EACJ,UAAU;EACV,SAAS;EACT,KAAK;EACN,CAAC,CACD,KAAK,WAAW;CACtB,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/lock/redis/providers/RedisLockProvider.ts","../../../src/lock/redis/index.ts"],"sourcesContent":["import { $inject } from \"alepha\";\nimport type { LockProvider } from \"alepha/lock\";\nimport { $logger } from \"alepha/logger\";\nimport { RedisProvider, type RedisSetOptions } from \"alepha/redis\";\n\nexport class RedisLockProvider implements LockProvider {\n  protected readonly log = $logger();\n  protected readonly redisProvider = $inject(RedisProvider);\n\n  public async set(\n    key: string,\n    value: string,\n    nx?: boolean,\n    px?: number,\n  ): Promise<string> {\n    const options: RedisSetOptions = {\n      GET: true, // all the secrets of $lock is based on this\n    };\n\n    if (px) {\n      options.expiration = {\n        type: \"PX\",\n        value: px,\n      };\n    }\n\n    if (nx) {\n      options.condition = \"NX\";\n    }\n\n    const resp = await this.redisProvider.set(key, value, options);\n\n    return resp.toString(\"utf-8\");\n  }\n\n  public async del(...keys: string[]): Promise<void> {\n    await this.redisProvider.del(keys);\n  }\n}\n","import { $module, type Alepha } from \"alepha\";\nimport { AlephaLock, LockProvider, LockTopicProvider } from \"alepha/lock\";\nimport { RedisTopicProvider } from \"alepha/topic/redis\";\nimport { RedisLockProvider } from \"./providers/RedisLockProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./providers/RedisLockProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Plugin for Alepha that provides a locking mechanism.\n *\n * @see {@link RedisLockProvider}\n * @module alepha.lock.redis\n */\nexport const AlephaLockRedis = $module({\n  name: \"alepha.lock.redis\",\n  services: [RedisLockProvider, RedisTopicProvider],\n  register: (alepha: Alepha) =>\n    alepha\n      .with({\n        optional: true,\n        provide: LockTopicProvider,\n        use: RedisTopicProvider,\n      })\n      .with({\n        optional: true,\n        provide: LockProvider,\n        use: RedisLockProvider,\n      })\n      .with(AlephaLock),\n});\n"],"mappings":";;;;;;AAKA,IAAa,oBAAb,MAAuD;CACrD,MAAyB,SAAS;CAClC,gBAAmC,QAAQ,cAAc;CAEzD,MAAa,IACX,KACA,OACA,IACA,IACiB;EACjB,MAAM,UAA2B,EAC/B,KAAK,MACN;AAED,MAAI,GACF,SAAQ,aAAa;GACnB,MAAM;GACN,OAAO;GACR;AAGH,MAAI,GACF,SAAQ,YAAY;AAKtB,UAAO,MAFY,KAAK,cAAc,IAAI,KAAK,OAAO,QAAQ,EAElD,SAAS,QAAQ;;CAG/B,MAAa,IAAI,GAAG,MAA+B;AACjD,QAAM,KAAK,cAAc,IAAI,KAAK;;;;;;;;;;;ACnBtC,MAAa,kBAAkB,QAAQ;CACrC,MAAM;CACN,UAAU,CAAC,mBAAmB,mBAAmB;CACjD,WAAW,WACT,OACG,KAAK;EACJ,UAAU;EACV,SAAS;EACT,KAAK;EACN,CAAC,CACD,KAAK;EACJ,UAAU;EACV,SAAS;EACT,KAAK;EACN,CAAC,CACD,KAAK,WAAW;CACtB,CAAC"}

package/dist/logger/index.js

@@ -101,7 +101,7 @@ var Logger = class {
 		if (typeof message === "string") _message = message;
 		else if (typeof data === "string") _message = data;
 		let _data;
-		if (typeof data === "object" && !!data) _data = data;
+		if (typeof data === "object" && data) _data = data;
 		else if (typeof message === "object" && message) _data = message;
 		const logEntry = {
 			level,
@@ -455,7 +455,32 @@ const AlephaLogger = $module({
 	}
 });
 const envSchema = t.object({
+	/**
+	* Enable debug logging for specific modules using the `debug` package convention.
+	*
+	* @example
+	* DEBUG=1 # Shorthand for LOG_LEVEL=trace LOG_FORMAT=pretty
+	* DEBUG=alepha:* # Enable debug logging for all alepha modules
+	* DEBUG=alepha:orm:* # Enable debug logging for alepha.orm modules
+	* DEBUG=* # Enable debug logging for all modules
+	*/
 	DEBUG: t.optional(t.text({ description: "Enable debug logging for specific modules using the debug package convention. Example: DEBUG=alepha:*" })),
+	/**
+	* Default log level for the application.
+	*
+	* Default by environment:
+	* - dev = info
+	* - prod = info
+	* - test = error
+	*
+	* Levels are: "trace" | "debug" | "info" | "warn" | "error" | "silent"
+	*
+	* Level can be set for a specific module:
+	*
+	* @example
+	* LOG_LEVEL=my.module.name:debug,info # Set debug level for my.module.name and info for all other modules
+	* LOG_LEVEL=alepha:trace, info # Set trace level for all alepha modules and info for all other modules
+	*/
 	LOG_LEVEL: t.optional(t.text({
 		description: `Application log level on startup.
 Levels are: trace, debug, info, warn, error, silent
@@ -464,6 +489,12 @@ Level can be set for a specific module:
 "alepha:trace,info" -> Set trace level for all alepha modules and info for all other modules`,
 		lowercase: true
 	})),
+	/**
+	* Built-in log formats.
+	* - "json" - JSON format, useful for structured logging and log aggregation. {@link JsonFormatterProvider}
+	* - "pretty" - Simple text format, human-readable, with colors. {@link PrettyFormatterProvider}
+	* - "raw" - Raw format, no formatting, just the message. {@link RawFormatterProvider}
+	*/
 	LOG_FORMAT: t.optional(t.enum([
 		"json",
 		"pretty",

package/dist/logger/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/logger/providers/LogDestinationProvider.ts","../../src/logger/providers/LogFormatterProvider.ts","../../src/logger/services/Logger.ts","../../src/logger/primitives/$logger.ts","../../src/logger/providers/ConsoleColorProvider.ts","../../src/logger/providers/ConsoleDestinationProvider.ts","../../src/logger/providers/JsonFormatterProvider.ts","../../src/logger/providers/MemoryDestinationProvider.ts","../../src/logger/providers/PrettyFormatterProvider.ts","../../src/logger/providers/RawFormatterProvider.ts","../../src/logger/schemas/logEntrySchema.ts","../../src/logger/index.ts"],"sourcesContent":["import type { LogEntry } from \"../schemas/logEntrySchema.ts\";\n\nexport abstract class LogDestinationProvider {\n  public abstract write(message: string, entry: LogEntry): void;\n}\n","import type { LogEntry } from \"../schemas/logEntrySchema.ts\";\n\nexport abstract class LogFormatterProvider {\n  public abstract format(entry: LogEntry): string;\n}\n","import {\n  $inject,\n  Alepha,\n  AlephaError,\n  type LoggerInterface,\n  type LogLevel,\n} from \"alepha\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { LogDestinationProvider } from \"../providers/LogDestinationProvider.ts\";\nimport { LogFormatterProvider } from \"../providers/LogFormatterProvider.ts\";\nimport type { LogEntry } from \"../schemas/logEntrySchema.ts\";\n\nexport class Logger implements LoggerInterface {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly formatter = $inject(LogFormatterProvider);\n  protected readonly destination = $inject(LogDestinationProvider);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n\n  protected readonly levels: Record<string, number> = {\n    SILENT: -1,\n    ERROR: 0,\n    WARN: 1,\n    INFO: 2,\n    DEBUG: 3,\n    TRACE: 4,\n  };\n\n  protected readonly service: string;\n  protected readonly module: string;\n  protected readonly app?: string;\n\n  protected appLogLevel: string = \"INFO\";\n  protected logLevel: LogLevel = \"INFO\";\n\n  constructor(service: string, module: string) {\n    this.service = service;\n    this.module = module;\n    this.app = this.alepha.env.APP_NAME;\n  }\n\n  public get context(): string | undefined {\n    return this.alepha.context.get<string>(\"context\");\n  }\n\n  public get level(): string {\n    const stateLogLevel = this.alepha.store.get(\"alepha.logger.level\");\n    if (stateLogLevel && stateLogLevel !== this.appLogLevel) {\n      this.appLogLevel = stateLogLevel;\n      this.logLevel = this.parseLevel(this.appLogLevel, this.module);\n    }\n    return this.logLevel;\n  }\n\n  public parseLevel(level: string, app: string): LogLevel {\n    const parts = level.toLowerCase().split(/[,;]/);\n\n    // First pass: check for module-specific configurations\n    for (const part of parts) {\n      const trimmedPart = part.trim();\n      if (!trimmedPart) continue; // Skip empty parts\n\n      if (trimmedPart.includes(\":\") || trimmedPart.includes(\"=\")) {\n        const [modulePattern, levelValue] = trimmedPart.split(/[:=]/);\n        const trimmedModule = modulePattern.trim();\n        const trimmedLevel = levelValue?.trim();\n\n        if (!trimmedLevel) continue; // Skip if no level specified\n\n        if (this.matchesPattern(app, trimmedModule)) {\n          try {\n            return this.asLogLevel(trimmedLevel);\n          } catch (error) {\n            throw new AlephaError(\n              `Invalid log level '${levelValue?.trim()}' for module pattern '${trimmedModule}'`,\n            );\n          }\n        }\n      }\n    }\n\n    // Second pass: look for global level\n    for (const part of parts) {\n      const trimmedPart = part.trim();\n      if (!trimmedPart) continue; // Skip empty parts\n\n      if (!trimmedPart.includes(\":\") && !trimmedPart.includes(\"=\")) {\n        try {\n          return this.asLogLevel(trimmedPart);\n        } catch (error) {\n          throw new AlephaError(`Invalid global log level \"${trimmedPart}\"`);\n        }\n      }\n    }\n\n    return \"INFO\";\n  }\n\n  protected matchesPattern(moduleName: string, pattern: string): boolean {\n    if (pattern.includes(\"*\")) {\n      // Convert wildcard pattern to regex\n      const regexPattern = pattern.replace(/\\./g, \"\\\\.\").replace(/\\*/g, \".*\");\n      return new RegExp(`^${regexPattern}`).test(moduleName);\n    }\n\n    // Exact prefix match (existing behavior)\n    return moduleName.startsWith(pattern);\n  }\n\n  public asLogLevel(something: string): LogLevel {\n    const level = something.trim().toUpperCase();\n    if (this.levels[level] !== undefined) {\n      return level as LogLevel;\n    }\n\n    throw new AlephaError(`Invalid log level: ${something}`);\n  }\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  public error(message: string, data?: unknown): void {\n    this.log(\"ERROR\", message, data);\n  }\n\n  public warn(message: string, data?: unknown): void {\n    this.log(\"WARN\", message, data);\n  }\n\n  public info(message: string, data?: unknown): void {\n    this.log(\"INFO\", message, data);\n  }\n\n  public debug(message: string, data?: unknown): void {\n    this.log(\"DEBUG\", message, data);\n  }\n\n  public trace(message: string, data?: unknown): void {\n    this.log(\"TRACE\", message, data);\n  }\n\n  protected log(level: LogLevel, message: string, data?: unknown): void {\n    let _message = \"\";\n    if (typeof message === \"string\") {\n      _message = message;\n    } else if (typeof data === \"string\") {\n      _message = data;\n    }\n\n    let _data: object | Error | undefined;\n    if (typeof data === \"object\" && !!data) {\n      _data = data;\n    } else if (typeof message === \"object\" && message) {\n      _data = message;\n    }\n\n    const logEntry: LogEntry = {\n      level,\n      message: _message,\n      data: _data,\n      context: this.context,\n      service: this.service,\n      module: this.module,\n      app: this.app,\n      timestamp: this.dateTimeProvider.nowMillis(),\n    };\n\n    if (this.levels[level] > this.levels[this.level]) {\n      this.emit(logEntry);\n      return;\n    }\n\n    const formatted = this.formatter.format(logEntry);\n\n    this.emit(logEntry, formatted);\n\n    this.destination.write(formatted, logEntry);\n  }\n\n  protected emit(entry: LogEntry, message?: string) {\n    this.alepha.events\n      .emit(\n        \"log\",\n        {\n          message,\n          entry,\n        },\n        {\n          catch: true,\n        },\n      )\n      .catch(() => null);\n  }\n}\n","import { $context, $inject, KIND } from \"alepha\";\nimport { Logger } from \"../services/Logger.ts\";\n\n/**\n * Create a logger.\n *\n * `name` is optional, by default it will use the name of the service.\n *\n * @example\n * ```ts\n * import { $logger } from \"alepha\";\n *\n * class MyService {\n * \tlog = $logger();\n *\n *   constructor() {\n *     this.log.info(\"Service initialized\");\n *     // print something like '[23:45:53.326] INFO <app.MyService>: Service initialized'\n *   }\n * }\n * ```\n */\nexport const $logger = (options: LoggerPrimitiveOptions = {}): Logger => {\n  const { alepha, service, module } = $context();\n\n  return $inject(Logger, {\n    lifetime: \"transient\",\n    args: [\n      options.name ?? service?.name ?? \"Func\",\n      module?.name ?? alepha.env.MODULE_NAME ?? \"app\",\n    ],\n  });\n};\n\nexport interface LoggerPrimitiveOptions {\n  name?: string;\n}\n\n$logger[KIND] = Logger;\n","import { $inject, Alepha } from \"alepha\";\n\nexport class ConsoleColorProvider {\n  static readonly COLORS = {\n    RESET: \"\\x1b[0m\",\n    BLACK: \"\\x1b[30m\",\n    RED: \"\\x1b[31m\",\n    GREEN: \"\\x1b[32m\",\n    ORANGE: \"\\x1b[33m\", // using yellow for orange-ish\n    BLUE: \"\\x1b[34m\",\n    PURPLE: \"\\x1b[35m\",\n    CYAN: \"\\x1b[36m\",\n    GREY_LIGHT: \"\\x1b[37m\",\n    GREY_LIGHT_BOLD: \"\\x1b[1;37m\",\n    GREY_DARK: \"\\x1b[90m\",\n    GREY_DARK_BOLD: \"\\x1b[1;90m\",\n    WHITE: \"\\x1b[97m\",\n    WHITE_BOLD: \"\\x1b[1;97m\",\n    // modifiers\n    DIM: \"\\x1b[2m\",\n    BOLD: \"\\x1b[1m\",\n    INVERSE: \"\\x1b[7m\",\n    // levels\n    SILENT: \"\",\n    ERROR: \"\\x1b[31m\",\n    WARN: \"\\x1b[33m\",\n    INFO: \"\\x1b[32m\",\n    DEBUG: \"\\x1b[34m\",\n    TRACE: \"\\x1b[90m\",\n  };\n\n  protected readonly alepha = $inject(Alepha);\n\n  protected enabled = true;\n\n  constructor() {\n    this.enabled = this.isEnabled();\n  }\n\n  public isEnabled(): boolean {\n    if (this.alepha.env.NO_COLOR) {\n      return false;\n    }\n\n    if (this.alepha.env.FORCE_COLOR) {\n      return true;\n    }\n\n    if (this.alepha.isBrowser() && !navigator.userAgent.includes(\"Chrome\")) {\n      return false;\n    }\n\n    return !this.alepha.isProduction();\n  }\n\n  public set(\n    color: keyof typeof ConsoleColorProvider.COLORS,\n    text: string,\n    reset: string = ConsoleColorProvider.COLORS.RESET,\n  ): string {\n    if (!this.enabled) {\n      return text;\n    }\n\n    return `${ConsoleColorProvider.COLORS[color]}${text}${reset}`;\n  }\n}\n","import { LogDestinationProvider } from \"./LogDestinationProvider.ts\";\n\nexport class ConsoleDestinationProvider extends LogDestinationProvider {\n  public write(message: string): void {\n    console.log(message);\n  }\n}\n","import type { LogEntry } from \"../schemas/logEntrySchema.ts\";\nimport { LogFormatterProvider } from \"./LogFormatterProvider.ts\";\n\nexport class JsonFormatterProvider extends LogFormatterProvider {\n  public format(entry: LogEntry): string {\n    const json: Record<string, any> = {\n      level: entry.level,\n      message: entry.message,\n      context: entry.context,\n      service: entry.service,\n      module: entry.module,\n      app: entry.app,\n      time: entry.timestamp,\n    };\n\n    if (entry.data instanceof Error) {\n      json.error = this.formatJsonError(entry.data);\n    } else {\n      json.data = entry.data;\n    }\n\n    return JSON.stringify(json);\n  }\n\n  public formatJsonError(error: Error): object {\n    return {\n      name: error.name,\n      message: error.message,\n      stack: error.stack,\n      cause:\n        error.cause instanceof Error\n          ? this.formatJsonError(error.cause)\n          : undefined,\n    };\n  }\n}\n","import type { LogEntry } from \"../schemas/logEntrySchema.ts\";\nimport { LogDestinationProvider } from \"./LogDestinationProvider.ts\";\n\nexport class MemoryDestinationProvider extends LogDestinationProvider {\n  protected entries: Array<LogEntry & { formatted: string }> = [];\n\n  public readonly options = {\n    maxEntries: 10_000,\n  };\n\n  public write(formatted: string, entry: LogEntry): void {\n    this.entries.push({ ...entry, formatted });\n\n    if (this.entries.length > this.options.maxEntries) {\n      this.entries = this.entries.slice(\n        -Math.floor(this.options.maxEntries * 0.8),\n      );\n    }\n  }\n\n  public get logs() {\n    return [...this.entries];\n  }\n\n  public clear(): void {\n    this.entries = [];\n  }\n}\n","import { $inject, Alepha } from \"alepha\";\nimport type { LogEntry } from \"../schemas/logEntrySchema.ts\";\nimport { ConsoleColorProvider } from \"./ConsoleColorProvider.ts\";\nimport { LogFormatterProvider } from \"./LogFormatterProvider.ts\";\n\nexport class PrettyFormatterProvider extends LogFormatterProvider {\n  protected color = $inject(ConsoleColorProvider);\n  protected alepha = $inject(Alepha);\n\n  public format(entry: LogEntry): string {\n    const { data, timestamp } = entry;\n\n    let output = \"\";\n    let details = \"\";\n\n    const isError = data instanceof Error;\n    if (isError) {\n      details = this.formatError(data);\n    } else if (data) {\n      let error = \"\";\n      let jsonData = data;\n      if (\"error\" in data && data.error instanceof Error) {\n        error = this.formatError(data.error);\n        const { error: _, ...rest } = data;\n        jsonData = rest;\n      }\n\n      if (Object.keys(jsonData).length > 0) {\n        try {\n          details = JSON.stringify(jsonData);\n        } catch {\n          details = \"[Unserializable Object]\";\n        }\n      }\n\n      if (error) {\n        details += `\\n${error}`;\n      }\n    }\n\n    output += this.color.set(\n      \"GREY_DARK\",\n      `[${this.formatTimestamp(timestamp)}]`,\n    );\n    output += \" \";\n\n    output += this.color.set(entry.level, entry.level.toUpperCase());\n    output += \" \";\n\n    if (entry.app) {\n      output += this.color.set(\"GREY_DARK\", `${entry.app}`);\n      output += \" \";\n    }\n\n    if (entry.context) {\n      output += this.color.set(\n        \"GREY_DARK\",\n        `(${this.formatContext(entry.context)})`,\n      );\n      output += \" \";\n    }\n\n    const module = this.color.set(\"GREY_LIGHT\", `${entry.module}.`);\n    const service = this.color.set(\n      this.alepha.isBrowser() ? \"RESET\" : \"WHITE\",\n      entry.service,\n    );\n\n    output += `<${module}${service}>`;\n\n    if (entry.message) {\n      output += `: ${this.color.set(\"CYAN\", entry.message)}`;\n    } else {\n      output += \":\";\n    }\n\n    if (details) {\n      if (isError) {\n        output += ` \\n${details}`;\n      } else {\n        output += ` ${this.color.set(\"GREY_DARK\", details)}`;\n      }\n    }\n\n    return output;\n  }\n\n  public formatTimestamp(timestamp: number): string {\n    const d = new Date(timestamp);\n    const h = d.getHours();\n    const m = d.getMinutes();\n    const s = d.getSeconds();\n    const ms = d.getMilliseconds();\n\n    return `${this.pad2(h)}:${this.pad2(m)}:${this.pad2(s)}.${this.pad3(ms)}`;\n  }\n\n  protected pad2 = (n: number) => (n < 10 ? \"0\" : \"\") + n;\n  protected pad3 = (n: number) =>\n    n < 10 ? `00${n}` : n < 100 ? `0${n}` : `${n}`;\n\n  /**\n   * Avoid to display the whole UUID in development mode\n   */\n  protected formatContext(context: string): string {\n    if (this.alepha.isProduction()) {\n      return context;\n    }\n\n    return context.slice(0, 8);\n  }\n\n  protected formatError(error: Error): string {\n    // Chrome does not like stack traces with ASCII colors\n    // so we remove the stack trace from log and just print with console.error\n    if (this.alepha.isBrowser()) {\n      // call console.error in a separate tick to avoid messing with log order\n      setTimeout(() => {\n        console.error(error);\n      });\n      return \"\";\n    }\n\n    // hack: use vite's stack trace formatter if available\n    const vite = this.alepha.store.get(\"alepha.vite.server\") as\n      | {\n          ssrFixStacktrace: (error: Error) => void;\n        }\n      | undefined;\n\n    vite?.ssrFixStacktrace(error);\n\n    let str = error.stack ?? error.message;\n\n    let currentCause = (error as any).cause;\n    while (currentCause && currentCause instanceof Error) {\n      vite?.ssrFixStacktrace(currentCause);\n\n      str += `\\nCaused by: ${currentCause.stack ?? currentCause.message}`;\n      currentCause = currentCause.cause;\n    }\n\n    return str;\n  }\n}\n","import type { LogEntry } from \"../schemas/logEntrySchema.ts\";\nimport { LogFormatterProvider } from \"./LogFormatterProvider.ts\";\n\nexport class RawFormatterProvider extends LogFormatterProvider {\n  public format(entry: LogEntry): string {\n    let output = \"\";\n\n    output += `${entry.message}`;\n\n    if (entry.data instanceof Error) {\n      output += `\\n${entry.data.message}`;\n      let cause = entry.data.cause;\n      while (cause instanceof Error) {\n        output += `\\nCaused by: ${cause.message}`;\n        cause = cause.cause;\n      }\n    }\n\n    return output;\n  }\n}\n","import { type Static, t } from \"alepha\";\n\nexport const logEntrySchema = t.object({\n  level: t.enum([\"SILENT\", \"TRACE\", \"DEBUG\", \"INFO\", \"WARN\", \"ERROR\"]),\n  message: t.text({\n    size: \"rich\",\n  }),\n  service: t.text(),\n  module: t.text(),\n  context: t.optional(t.text()),\n  app: t.optional(t.text()),\n  data: t.optional(t.any()),\n  timestamp: t.number(),\n});\n\nexport type LogEntry = Static<typeof logEntrySchema>;\n","import { $module, type Static, t } from \"alepha\";\nimport { $logger } from \"./primitives/$logger.ts\";\nimport { ConsoleColorProvider } from \"./providers/ConsoleColorProvider.ts\";\nimport { ConsoleDestinationProvider } from \"./providers/ConsoleDestinationProvider.ts\";\nimport { JsonFormatterProvider } from \"./providers/JsonFormatterProvider.ts\";\nimport { LogDestinationProvider } from \"./providers/LogDestinationProvider.ts\";\nimport { LogFormatterProvider } from \"./providers/LogFormatterProvider.ts\";\nimport { MemoryDestinationProvider } from \"./providers/MemoryDestinationProvider.ts\";\nimport { PrettyFormatterProvider } from \"./providers/PrettyFormatterProvider.ts\";\nimport { RawFormatterProvider } from \"./providers/RawFormatterProvider.ts\";\nimport type { LogEntry } from \"./schemas/logEntrySchema.ts\";\nimport { Logger } from \"./services/Logger.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./primitives/$logger.ts\";\nexport * from \"./providers/ConsoleColorProvider.ts\";\nexport * from \"./providers/ConsoleDestinationProvider.ts\";\nexport * from \"./providers/JsonFormatterProvider.ts\";\nexport * from \"./providers/LogDestinationProvider.ts\";\nexport * from \"./providers/LogFormatterProvider.ts\";\nexport * from \"./providers/MemoryDestinationProvider.ts\";\nexport * from \"./providers/PrettyFormatterProvider.ts\";\nexport * from \"./schemas/logEntrySchema.ts\";\nexport * from \"./services/Logger.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Configurable logging with multiple outputs.\n *\n * **Features:**\n * - Global logger access\n * - JSON format\n * - Pretty colored output\n * - Raw text format\n * - Console destination\n * - Memory destination (for devtools)\n * - Custom handlers\n * - Configuration via `LOG_LEVEL`, `LOG_FORMAT`, and `DEBUG`\n *\n * @module alepha.logger\n */\nexport const AlephaLogger = $module({\n  name: \"alepha.logger\",\n  primitives: [$logger],\n  services: [Logger, ConsoleColorProvider],\n  variants: [\n    ConsoleDestinationProvider,\n    MemoryDestinationProvider,\n    JsonFormatterProvider,\n    PrettyFormatterProvider,\n    RawFormatterProvider,\n  ],\n  register: (alepha) => {\n    const env = alepha.parseEnv(envSchema);\n\n    // Support DEBUG env var (debug package convention) as shorthand for LOG_LEVEL/LOG_FORMAT.\n    // DEBUG=1 → LOG_LEVEL=trace LOG_FORMAT=pretty\n    // DEBUG=alepha:* → LOG_LEVEL=alepha.*:debug,info LOG_FORMAT=pretty\n    let logLevel = env.LOG_LEVEL;\n    let logFormat = env.LOG_FORMAT;\n    if (env.DEBUG) {\n      if (env.DEBUG === \"1\" || env.DEBUG === \"true\") {\n        logLevel ??= \"trace\";\n      } else {\n        const patterns = env.DEBUG.split(\",\")\n          .map((p) => p.trim().replaceAll(\":\", \".\"))\n          .filter(Boolean);\n        logLevel ??= `${patterns.map((p) => `${p}:debug`).join(\",\")},info`;\n      }\n      logFormat ??= \"pretty\";\n    }\n\n    const getLogDestinationProvider = () => {\n      // in test mode, if no LOG_LEVEL is set, use MemoryDestinationProvider to capture logs for inspection.\n      // logs will be printed to console only if the test fails.\n      if (alepha.isTest() && !logLevel) {\n        const printOnError = (ev: any) => {\n          if (ev.task?.result?.state === \"fail\") {\n            const output = alepha.inject(MemoryDestinationProvider);\n            for (const log of output.logs) {\n              console.log(log.formatted);\n            }\n          }\n        };\n\n        try {\n          alepha.store.get(\"alepha.test.afterEach\")?.(printOnError);\n          alepha.store.get(\"alepha.test.onTestFinished\")?.(printOnError);\n        } catch {\n          // ignore\n        }\n\n        return MemoryDestinationProvider;\n      }\n\n      return ConsoleDestinationProvider;\n    };\n\n    const getLogFormatterProvider = () => {\n      if (logFormat) {\n        if (logFormat === \"json\") {\n          return JsonFormatterProvider;\n        }\n        if (logFormat === \"raw\") {\n          return RawFormatterProvider;\n        }\n        return PrettyFormatterProvider;\n      }\n\n      if (alepha.isProduction() && !alepha.isBrowser()) {\n        return JsonFormatterProvider;\n      }\n\n      return PrettyFormatterProvider;\n    };\n\n    alepha.with({\n      optional: true,\n      provide: LogDestinationProvider,\n      use: getLogDestinationProvider(),\n    });\n\n    alepha.with({\n      optional: true,\n      provide: LogFormatterProvider,\n      use: getLogFormatterProvider(),\n    });\n\n    alepha.store.set(\n      \"alepha.logger\",\n      alepha.inject(Logger, {\n        lifetime: \"transient\",\n        args: [\"Alepha\", \"alepha.core\"],\n      }),\n    );\n\n    alepha.store.set(\n      \"alepha.logger.level\",\n      logLevel ??\n        (alepha.isTest()\n          ? \"trace\"\n          : alepha.isProduction() && alepha.isBrowser()\n            ? \"warn\"\n            : \"info\"),\n    );\n  },\n});\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nconst envSchema = t.object({\n  /**\n   * Enable debug logging for specific modules using the `debug` package convention.\n   *\n   * @example\n   * DEBUG=1 # Shorthand for LOG_LEVEL=trace LOG_FORMAT=pretty\n   * DEBUG=alepha:* # Enable debug logging for all alepha modules\n   * DEBUG=alepha:orm:* # Enable debug logging for alepha.orm modules\n   * DEBUG=* # Enable debug logging for all modules\n   */\n  DEBUG: t.optional(\n    t.text({\n      description:\n        \"Enable debug logging for specific modules using the debug package convention. Example: DEBUG=alepha:*\",\n    }),\n  ),\n\n  /**\n   * Default log level for the application.\n   *\n   * Default by environment:\n   * - dev = info\n   * - prod = info\n   * - test = error\n   *\n   * Levels are: \"trace\" | \"debug\" | \"info\" | \"warn\" | \"error\" | \"silent\"\n   *\n   * Level can be set for a specific module:\n   *\n   * @example\n   * LOG_LEVEL=my.module.name:debug,info # Set debug level for my.module.name and info for all other modules\n   * LOG_LEVEL=alepha:trace, info # Set trace level for all alepha modules and info for all other modules\n   */\n  LOG_LEVEL: t.optional(\n    t.text({\n      description: `Application log level on startup.\nLevels are: trace, debug, info, warn, error, silent\nLevel can be set for a specific module:\n\"my.module.name:debug,info\" -> Set debug level for my.module.name and info for all other modules\n\"alepha:trace,info\" -> Set trace level for all alepha modules and info for all other modules`,\n      lowercase: true,\n    }),\n  ),\n\n  /**\n   * Built-in log formats.\n   * - \"json\" - JSON format, useful for structured logging and log aggregation. {@link JsonFormatterProvider}\n   * - \"pretty\" - Simple text format, human-readable, with colors. {@link PrettyFormatterProvider}\n   * - \"raw\" - Raw format, no formatting, just the message. {@link RawFormatterProvider}\n   */\n  LOG_FORMAT: t.optional(\n    t.enum([\"json\", \"pretty\", \"raw\"], {\n      description: \"Default log format for the application.\",\n      lowercase: true,\n    }),\n  ),\n});\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  export interface Env extends Partial<Static<typeof envSchema>> {}\n\n  export interface State {\n    /**\n     * Current log level for the application or specific modules.\n     */\n    \"alepha.logger.level\"?: string;\n  }\n\n  export interface Hooks {\n    log: {\n      message?: string;\n      entry: LogEntry;\n    };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/logger/providers/LogDestinationProvider.ts","../../src/logger/providers/LogFormatterProvider.ts","../../src/logger/services/Logger.ts","../../src/logger/primitives/$logger.ts","../../src/logger/providers/ConsoleColorProvider.ts","../../src/logger/providers/ConsoleDestinationProvider.ts","../../src/logger/providers/JsonFormatterProvider.ts","../../src/logger/providers/MemoryDestinationProvider.ts","../../src/logger/providers/PrettyFormatterProvider.ts","../../src/logger/providers/RawFormatterProvider.ts","../../src/logger/schemas/logEntrySchema.ts","../../src/logger/index.ts"],"sourcesContent":["import type { LogEntry } from \"../schemas/logEntrySchema.ts\";\n\nexport abstract class LogDestinationProvider {\n  public abstract write(message: string, entry: LogEntry): void;\n}\n","import type { LogEntry } from \"../schemas/logEntrySchema.ts\";\n\nexport abstract class LogFormatterProvider {\n  public abstract format(entry: LogEntry): string;\n}\n","import {\n  $inject,\n  Alepha,\n  AlephaError,\n  type LoggerInterface,\n  type LogLevel,\n} from \"alepha\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { LogDestinationProvider } from \"../providers/LogDestinationProvider.ts\";\nimport { LogFormatterProvider } from \"../providers/LogFormatterProvider.ts\";\nimport type { LogEntry } from \"../schemas/logEntrySchema.ts\";\n\nexport class Logger implements LoggerInterface {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly formatter = $inject(LogFormatterProvider);\n  protected readonly destination = $inject(LogDestinationProvider);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n\n  protected readonly levels: Record<string, number> = {\n    SILENT: -1,\n    ERROR: 0,\n    WARN: 1,\n    INFO: 2,\n    DEBUG: 3,\n    TRACE: 4,\n  };\n\n  protected readonly service: string;\n  protected readonly module: string;\n  protected readonly app?: string;\n\n  protected appLogLevel: string = \"INFO\";\n  protected logLevel: LogLevel = \"INFO\";\n\n  constructor(service: string, module: string) {\n    this.service = service;\n    this.module = module;\n    this.app = this.alepha.env.APP_NAME;\n  }\n\n  public get context(): string | undefined {\n    return this.alepha.context.get<string>(\"context\");\n  }\n\n  public get level(): string {\n    const stateLogLevel = this.alepha.store.get(\"alepha.logger.level\");\n    if (stateLogLevel && stateLogLevel !== this.appLogLevel) {\n      this.appLogLevel = stateLogLevel;\n      this.logLevel = this.parseLevel(this.appLogLevel, this.module);\n    }\n    return this.logLevel;\n  }\n\n  public parseLevel(level: string, app: string): LogLevel {\n    const parts = level.toLowerCase().split(/[,;]/);\n\n    // First pass: check for module-specific configurations\n    for (const part of parts) {\n      const trimmedPart = part.trim();\n      if (!trimmedPart) continue; // Skip empty parts\n\n      if (trimmedPart.includes(\":\") || trimmedPart.includes(\"=\")) {\n        const [modulePattern, levelValue] = trimmedPart.split(/[:=]/);\n        const trimmedModule = modulePattern.trim();\n        const trimmedLevel = levelValue?.trim();\n\n        if (!trimmedLevel) continue; // Skip if no level specified\n\n        if (this.matchesPattern(app, trimmedModule)) {\n          try {\n            return this.asLogLevel(trimmedLevel);\n          } catch (error) {\n            throw new AlephaError(\n              `Invalid log level '${levelValue?.trim()}' for module pattern '${trimmedModule}'`,\n            );\n          }\n        }\n      }\n    }\n\n    // Second pass: look for global level\n    for (const part of parts) {\n      const trimmedPart = part.trim();\n      if (!trimmedPart) continue; // Skip empty parts\n\n      if (!trimmedPart.includes(\":\") && !trimmedPart.includes(\"=\")) {\n        try {\n          return this.asLogLevel(trimmedPart);\n        } catch (error) {\n          throw new AlephaError(`Invalid global log level \"${trimmedPart}\"`);\n        }\n      }\n    }\n\n    return \"INFO\";\n  }\n\n  protected matchesPattern(moduleName: string, pattern: string): boolean {\n    if (pattern.includes(\"*\")) {\n      // Convert wildcard pattern to regex\n      const regexPattern = pattern.replace(/\\./g, \"\\\\.\").replace(/\\*/g, \".*\");\n      return new RegExp(`^${regexPattern}`).test(moduleName);\n    }\n\n    // Exact prefix match (existing behavior)\n    return moduleName.startsWith(pattern);\n  }\n\n  public asLogLevel(something: string): LogLevel {\n    const level = something.trim().toUpperCase();\n    if (this.levels[level] !== undefined) {\n      return level as LogLevel;\n    }\n\n    throw new AlephaError(`Invalid log level: ${something}`);\n  }\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  public error(message: string, data?: unknown): void {\n    this.log(\"ERROR\", message, data);\n  }\n\n  public warn(message: string, data?: unknown): void {\n    this.log(\"WARN\", message, data);\n  }\n\n  public info(message: string, data?: unknown): void {\n    this.log(\"INFO\", message, data);\n  }\n\n  public debug(message: string, data?: unknown): void {\n    this.log(\"DEBUG\", message, data);\n  }\n\n  public trace(message: string, data?: unknown): void {\n    this.log(\"TRACE\", message, data);\n  }\n\n  protected log(level: LogLevel, message: string, data?: unknown): void {\n    let _message = \"\";\n    if (typeof message === \"string\") {\n      _message = message;\n    } else if (typeof data === \"string\") {\n      _message = data;\n    }\n\n    let _data: object | Error | undefined;\n    if (typeof data === \"object\" && data) {\n      _data = data;\n    } else if (typeof message === \"object\" && message) {\n      _data = message;\n    }\n\n    const logEntry: LogEntry = {\n      level,\n      message: _message,\n      data: _data,\n      context: this.context,\n      service: this.service,\n      module: this.module,\n      app: this.app,\n      timestamp: this.dateTimeProvider.nowMillis(),\n    };\n\n    if (this.levels[level] > this.levels[this.level]) {\n      this.emit(logEntry);\n      return;\n    }\n\n    const formatted = this.formatter.format(logEntry);\n\n    this.emit(logEntry, formatted);\n\n    this.destination.write(formatted, logEntry);\n  }\n\n  protected emit(entry: LogEntry, message?: string) {\n    this.alepha.events\n      .emit(\n        \"log\",\n        {\n          message,\n          entry,\n        },\n        {\n          catch: true,\n        },\n      )\n      .catch(() => null);\n  }\n}\n","import { $context, $inject, KIND } from \"alepha\";\nimport { Logger } from \"../services/Logger.ts\";\n\n/**\n * Create a logger.\n *\n * `name` is optional, by default it will use the name of the service.\n *\n * @example\n * ```ts\n * import { $logger } from \"alepha\";\n *\n * class MyService {\n * \tlog = $logger();\n *\n *   constructor() {\n *     this.log.info(\"Service initialized\");\n *     // print something like '[23:45:53.326] INFO <app.MyService>: Service initialized'\n *   }\n * }\n * ```\n */\nexport const $logger = (options: LoggerPrimitiveOptions = {}): Logger => {\n  const { alepha, service, module } = $context();\n\n  return $inject(Logger, {\n    lifetime: \"transient\",\n    args: [\n      options.name ?? service?.name ?? \"Func\",\n      module?.name ?? alepha.env.MODULE_NAME ?? \"app\",\n    ],\n  });\n};\n\nexport interface LoggerPrimitiveOptions {\n  name?: string;\n}\n\n$logger[KIND] = Logger;\n","import { $inject, Alepha } from \"alepha\";\n\nexport class ConsoleColorProvider {\n  static readonly COLORS = {\n    RESET: \"\\x1b[0m\",\n    BLACK: \"\\x1b[30m\",\n    RED: \"\\x1b[31m\",\n    GREEN: \"\\x1b[32m\",\n    ORANGE: \"\\x1b[33m\", // using yellow for orange-ish\n    BLUE: \"\\x1b[34m\",\n    PURPLE: \"\\x1b[35m\",\n    CYAN: \"\\x1b[36m\",\n    GREY_LIGHT: \"\\x1b[37m\",\n    GREY_LIGHT_BOLD: \"\\x1b[1;37m\",\n    GREY_DARK: \"\\x1b[90m\",\n    GREY_DARK_BOLD: \"\\x1b[1;90m\",\n    WHITE: \"\\x1b[97m\",\n    WHITE_BOLD: \"\\x1b[1;97m\",\n    // modifiers\n    DIM: \"\\x1b[2m\",\n    BOLD: \"\\x1b[1m\",\n    INVERSE: \"\\x1b[7m\",\n    // levels\n    SILENT: \"\",\n    ERROR: \"\\x1b[31m\",\n    WARN: \"\\x1b[33m\",\n    INFO: \"\\x1b[32m\",\n    DEBUG: \"\\x1b[34m\",\n    TRACE: \"\\x1b[90m\",\n  };\n\n  protected readonly alepha = $inject(Alepha);\n\n  protected enabled = true;\n\n  constructor() {\n    this.enabled = this.isEnabled();\n  }\n\n  public isEnabled(): boolean {\n    if (this.alepha.env.NO_COLOR) {\n      return false;\n    }\n\n    if (this.alepha.env.FORCE_COLOR) {\n      return true;\n    }\n\n    if (this.alepha.isBrowser() && !navigator.userAgent.includes(\"Chrome\")) {\n      return false;\n    }\n\n    return !this.alepha.isProduction();\n  }\n\n  public set(\n    color: keyof typeof ConsoleColorProvider.COLORS,\n    text: string,\n    reset: string = ConsoleColorProvider.COLORS.RESET,\n  ): string {\n    if (!this.enabled) {\n      return text;\n    }\n\n    return `${ConsoleColorProvider.COLORS[color]}${text}${reset}`;\n  }\n}\n","import { LogDestinationProvider } from \"./LogDestinationProvider.ts\";\n\nexport class ConsoleDestinationProvider extends LogDestinationProvider {\n  public write(message: string): void {\n    console.log(message);\n  }\n}\n","import type { LogEntry } from \"../schemas/logEntrySchema.ts\";\nimport { LogFormatterProvider } from \"./LogFormatterProvider.ts\";\n\nexport class JsonFormatterProvider extends LogFormatterProvider {\n  public format(entry: LogEntry): string {\n    const json: Record<string, any> = {\n      level: entry.level,\n      message: entry.message,\n      context: entry.context,\n      service: entry.service,\n      module: entry.module,\n      app: entry.app,\n      time: entry.timestamp,\n    };\n\n    if (entry.data instanceof Error) {\n      json.error = this.formatJsonError(entry.data);\n    } else {\n      json.data = entry.data;\n    }\n\n    return JSON.stringify(json);\n  }\n\n  public formatJsonError(error: Error): object {\n    return {\n      name: error.name,\n      message: error.message,\n      stack: error.stack,\n      cause:\n        error.cause instanceof Error\n          ? this.formatJsonError(error.cause)\n          : undefined,\n    };\n  }\n}\n","import type { LogEntry } from \"../schemas/logEntrySchema.ts\";\nimport { LogDestinationProvider } from \"./LogDestinationProvider.ts\";\n\nexport class MemoryDestinationProvider extends LogDestinationProvider {\n  protected entries: Array<LogEntry & { formatted: string }> = [];\n\n  public readonly options = {\n    maxEntries: 10_000,\n  };\n\n  public write(formatted: string, entry: LogEntry): void {\n    this.entries.push({ ...entry, formatted });\n\n    if (this.entries.length > this.options.maxEntries) {\n      this.entries = this.entries.slice(\n        -Math.floor(this.options.maxEntries * 0.8),\n      );\n    }\n  }\n\n  public get logs() {\n    return [...this.entries];\n  }\n\n  public clear(): void {\n    this.entries = [];\n  }\n}\n","import { $inject, Alepha } from \"alepha\";\nimport type { LogEntry } from \"../schemas/logEntrySchema.ts\";\nimport { ConsoleColorProvider } from \"./ConsoleColorProvider.ts\";\nimport { LogFormatterProvider } from \"./LogFormatterProvider.ts\";\n\nexport class PrettyFormatterProvider extends LogFormatterProvider {\n  protected color = $inject(ConsoleColorProvider);\n  protected alepha = $inject(Alepha);\n\n  public format(entry: LogEntry): string {\n    const { data, timestamp } = entry;\n\n    let output = \"\";\n    let details = \"\";\n\n    const isError = data instanceof Error;\n    if (isError) {\n      details = this.formatError(data);\n    } else if (data) {\n      let error = \"\";\n      let jsonData = data;\n      if (\"error\" in data && data.error instanceof Error) {\n        error = this.formatError(data.error);\n        const { error: _, ...rest } = data;\n        jsonData = rest;\n      }\n\n      if (Object.keys(jsonData).length > 0) {\n        try {\n          details = JSON.stringify(jsonData);\n        } catch {\n          details = \"[Unserializable Object]\";\n        }\n      }\n\n      if (error) {\n        details += `\\n${error}`;\n      }\n    }\n\n    output += this.color.set(\n      \"GREY_DARK\",\n      `[${this.formatTimestamp(timestamp)}]`,\n    );\n    output += \" \";\n\n    output += this.color.set(entry.level, entry.level.toUpperCase());\n    output += \" \";\n\n    if (entry.app) {\n      output += this.color.set(\"GREY_DARK\", `${entry.app}`);\n      output += \" \";\n    }\n\n    if (entry.context) {\n      output += this.color.set(\n        \"GREY_DARK\",\n        `(${this.formatContext(entry.context)})`,\n      );\n      output += \" \";\n    }\n\n    const module = this.color.set(\"GREY_LIGHT\", `${entry.module}.`);\n    const service = this.color.set(\n      this.alepha.isBrowser() ? \"RESET\" : \"WHITE\",\n      entry.service,\n    );\n\n    output += `<${module}${service}>`;\n\n    if (entry.message) {\n      output += `: ${this.color.set(\"CYAN\", entry.message)}`;\n    } else {\n      output += \":\";\n    }\n\n    if (details) {\n      if (isError) {\n        output += ` \\n${details}`;\n      } else {\n        output += ` ${this.color.set(\"GREY_DARK\", details)}`;\n      }\n    }\n\n    return output;\n  }\n\n  public formatTimestamp(timestamp: number): string {\n    const d = new Date(timestamp);\n    const h = d.getHours();\n    const m = d.getMinutes();\n    const s = d.getSeconds();\n    const ms = d.getMilliseconds();\n\n    return `${this.pad2(h)}:${this.pad2(m)}:${this.pad2(s)}.${this.pad3(ms)}`;\n  }\n\n  protected pad2 = (n: number) => (n < 10 ? \"0\" : \"\") + n;\n  protected pad3 = (n: number) =>\n    n < 10 ? `00${n}` : n < 100 ? `0${n}` : `${n}`;\n\n  /**\n   * Avoid to display the whole UUID in development mode\n   */\n  protected formatContext(context: string): string {\n    if (this.alepha.isProduction()) {\n      return context;\n    }\n\n    return context.slice(0, 8);\n  }\n\n  protected formatError(error: Error): string {\n    // Chrome does not like stack traces with ASCII colors\n    // so we remove the stack trace from log and just print with console.error\n    if (this.alepha.isBrowser()) {\n      // call console.error in a separate tick to avoid messing with log order\n      setTimeout(() => {\n        console.error(error);\n      });\n      return \"\";\n    }\n\n    // hack: use vite's stack trace formatter if available\n    const vite = this.alepha.store.get(\"alepha.vite.server\") as\n      | {\n          ssrFixStacktrace: (error: Error) => void;\n        }\n      | undefined;\n\n    vite?.ssrFixStacktrace(error);\n\n    let str = error.stack ?? error.message;\n\n    let currentCause = (error as any).cause;\n    while (currentCause && currentCause instanceof Error) {\n      vite?.ssrFixStacktrace(currentCause);\n\n      str += `\\nCaused by: ${currentCause.stack ?? currentCause.message}`;\n      currentCause = currentCause.cause;\n    }\n\n    return str;\n  }\n}\n","import type { LogEntry } from \"../schemas/logEntrySchema.ts\";\nimport { LogFormatterProvider } from \"./LogFormatterProvider.ts\";\n\nexport class RawFormatterProvider extends LogFormatterProvider {\n  public format(entry: LogEntry): string {\n    let output = \"\";\n\n    output += `${entry.message}`;\n\n    if (entry.data instanceof Error) {\n      output += `\\n${entry.data.message}`;\n      let cause = entry.data.cause;\n      while (cause instanceof Error) {\n        output += `\\nCaused by: ${cause.message}`;\n        cause = cause.cause;\n      }\n    }\n\n    return output;\n  }\n}\n","import { type Static, t } from \"alepha\";\n\nexport const logEntrySchema = t.object({\n  level: t.enum([\"SILENT\", \"TRACE\", \"DEBUG\", \"INFO\", \"WARN\", \"ERROR\"]),\n  message: t.text({\n    size: \"rich\",\n  }),\n  service: t.text(),\n  module: t.text(),\n  context: t.optional(t.text()),\n  app: t.optional(t.text()),\n  data: t.optional(t.any()),\n  timestamp: t.number(),\n});\n\nexport type LogEntry = Static<typeof logEntrySchema>;\n","import { $module, type Static, t } from \"alepha\";\nimport { $logger } from \"./primitives/$logger.ts\";\nimport { ConsoleColorProvider } from \"./providers/ConsoleColorProvider.ts\";\nimport { ConsoleDestinationProvider } from \"./providers/ConsoleDestinationProvider.ts\";\nimport { JsonFormatterProvider } from \"./providers/JsonFormatterProvider.ts\";\nimport { LogDestinationProvider } from \"./providers/LogDestinationProvider.ts\";\nimport { LogFormatterProvider } from \"./providers/LogFormatterProvider.ts\";\nimport { MemoryDestinationProvider } from \"./providers/MemoryDestinationProvider.ts\";\nimport { PrettyFormatterProvider } from \"./providers/PrettyFormatterProvider.ts\";\nimport { RawFormatterProvider } from \"./providers/RawFormatterProvider.ts\";\nimport type { LogEntry } from \"./schemas/logEntrySchema.ts\";\nimport { Logger } from \"./services/Logger.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./primitives/$logger.ts\";\nexport * from \"./providers/ConsoleColorProvider.ts\";\nexport * from \"./providers/ConsoleDestinationProvider.ts\";\nexport * from \"./providers/JsonFormatterProvider.ts\";\nexport * from \"./providers/LogDestinationProvider.ts\";\nexport * from \"./providers/LogFormatterProvider.ts\";\nexport * from \"./providers/MemoryDestinationProvider.ts\";\nexport * from \"./providers/PrettyFormatterProvider.ts\";\nexport * from \"./schemas/logEntrySchema.ts\";\nexport * from \"./services/Logger.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Configurable logging with multiple outputs.\n *\n * **Features:**\n * - Global logger access\n * - JSON format\n * - Pretty colored output\n * - Raw text format\n * - Console destination\n * - Memory destination (for devtools)\n * - Custom handlers\n * - Configuration via `LOG_LEVEL`, `LOG_FORMAT`, and `DEBUG`\n *\n * @module alepha.logger\n */\nexport const AlephaLogger = $module({\n  name: \"alepha.logger\",\n  primitives: [$logger],\n  services: [Logger, ConsoleColorProvider],\n  variants: [\n    ConsoleDestinationProvider,\n    MemoryDestinationProvider,\n    JsonFormatterProvider,\n    PrettyFormatterProvider,\n    RawFormatterProvider,\n  ],\n  register: (alepha) => {\n    const env = alepha.parseEnv(envSchema);\n\n    // Support DEBUG env var (debug package convention) as shorthand for LOG_LEVEL/LOG_FORMAT.\n    // DEBUG=1 → LOG_LEVEL=trace LOG_FORMAT=pretty\n    // DEBUG=alepha:* → LOG_LEVEL=alepha.*:debug,info LOG_FORMAT=pretty\n    let logLevel = env.LOG_LEVEL;\n    let logFormat = env.LOG_FORMAT;\n    if (env.DEBUG) {\n      if (env.DEBUG === \"1\" || env.DEBUG === \"true\") {\n        logLevel ??= \"trace\";\n      } else {\n        const patterns = env.DEBUG.split(\",\")\n          .map((p) => p.trim().replaceAll(\":\", \".\"))\n          .filter(Boolean);\n        logLevel ??= `${patterns.map((p) => `${p}:debug`).join(\",\")},info`;\n      }\n      logFormat ??= \"pretty\";\n    }\n\n    const getLogDestinationProvider = () => {\n      // in test mode, if no LOG_LEVEL is set, use MemoryDestinationProvider to capture logs for inspection.\n      // logs will be printed to console only if the test fails.\n      if (alepha.isTest() && !logLevel) {\n        const printOnError = (ev: any) => {\n          if (ev.task?.result?.state === \"fail\") {\n            const output = alepha.inject(MemoryDestinationProvider);\n            for (const log of output.logs) {\n              console.log(log.formatted);\n            }\n          }\n        };\n\n        try {\n          alepha.store.get(\"alepha.test.afterEach\")?.(printOnError);\n          alepha.store.get(\"alepha.test.onTestFinished\")?.(printOnError);\n        } catch {\n          // ignore\n        }\n\n        return MemoryDestinationProvider;\n      }\n\n      return ConsoleDestinationProvider;\n    };\n\n    const getLogFormatterProvider = () => {\n      if (logFormat) {\n        if (logFormat === \"json\") {\n          return JsonFormatterProvider;\n        }\n        if (logFormat === \"raw\") {\n          return RawFormatterProvider;\n        }\n        return PrettyFormatterProvider;\n      }\n\n      if (alepha.isProduction() && !alepha.isBrowser()) {\n        return JsonFormatterProvider;\n      }\n\n      return PrettyFormatterProvider;\n    };\n\n    alepha.with({\n      optional: true,\n      provide: LogDestinationProvider,\n      use: getLogDestinationProvider(),\n    });\n\n    alepha.with({\n      optional: true,\n      provide: LogFormatterProvider,\n      use: getLogFormatterProvider(),\n    });\n\n    alepha.store.set(\n      \"alepha.logger\",\n      alepha.inject(Logger, {\n        lifetime: \"transient\",\n        args: [\"Alepha\", \"alepha.core\"],\n      }),\n    );\n\n    alepha.store.set(\n      \"alepha.logger.level\",\n      logLevel ??\n        (alepha.isTest()\n          ? \"trace\"\n          : alepha.isProduction() && alepha.isBrowser()\n            ? \"warn\"\n            : \"info\"),\n    );\n  },\n});\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nconst envSchema = t.object({\n  /**\n   * Enable debug logging for specific modules using the `debug` package convention.\n   *\n   * @example\n   * DEBUG=1 # Shorthand for LOG_LEVEL=trace LOG_FORMAT=pretty\n   * DEBUG=alepha:* # Enable debug logging for all alepha modules\n   * DEBUG=alepha:orm:* # Enable debug logging for alepha.orm modules\n   * DEBUG=* # Enable debug logging for all modules\n   */\n  DEBUG: t.optional(\n    t.text({\n      description:\n        \"Enable debug logging for specific modules using the debug package convention. Example: DEBUG=alepha:*\",\n    }),\n  ),\n\n  /**\n   * Default log level for the application.\n   *\n   * Default by environment:\n   * - dev = info\n   * - prod = info\n   * - test = error\n   *\n   * Levels are: \"trace\" | \"debug\" | \"info\" | \"warn\" | \"error\" | \"silent\"\n   *\n   * Level can be set for a specific module:\n   *\n   * @example\n   * LOG_LEVEL=my.module.name:debug,info # Set debug level for my.module.name and info for all other modules\n   * LOG_LEVEL=alepha:trace, info # Set trace level for all alepha modules and info for all other modules\n   */\n  LOG_LEVEL: t.optional(\n    t.text({\n      description: `Application log level on startup.\nLevels are: trace, debug, info, warn, error, silent\nLevel can be set for a specific module:\n\"my.module.name:debug,info\" -> Set debug level for my.module.name and info for all other modules\n\"alepha:trace,info\" -> Set trace level for all alepha modules and info for all other modules`,\n      lowercase: true,\n    }),\n  ),\n\n  /**\n   * Built-in log formats.\n   * - \"json\" - JSON format, useful for structured logging and log aggregation. {@link JsonFormatterProvider}\n   * - \"pretty\" - Simple text format, human-readable, with colors. {@link PrettyFormatterProvider}\n   * - \"raw\" - Raw format, no formatting, just the message. {@link RawFormatterProvider}\n   */\n  LOG_FORMAT: t.optional(\n    t.enum([\"json\", \"pretty\", \"raw\"], {\n      description: \"Default log format for the application.\",\n      lowercase: true,\n    }),\n  ),\n});\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  export interface Env extends Partial<Static<typeof envSchema>> {}\n\n  export interface State {\n    /**\n     * Current log level for the application or specific modules.\n     */\n    \"alepha.logger.level\"?: string;\n  }\n\n  export interface Hooks {\n    log: {\n      message?: string;\n      entry: LogEntry;\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/mcp/index.js

@@ -730,7 +730,11 @@ $tool[KIND] = ToolPrimitive;
 const mcpSseOptions = $atom({
 	name: "alepha.mcp.sse.options",
 	description: "Configuration options for the MCP SSE transport.",
-	schema: t.object({ path: t.text({ default: "/mcp" }) }),
+	schema: t.object({ 
+	/**
+	* Path for the MCP SSE endpoint.
+	*/
+path: t.text({ default: "/mcp" }) }),
 	default: { path: "/mcp" }
 });
 /**