alepha 0.21.2 → 0.23.0

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/topic/core/primitives/$subscriber.ts","../../../src/topic/core/errors/TopicTimeoutError.ts","../../../src/topic/core/providers/TopicProvider.ts","../../../src/topic/core/providers/MemoryTopicProvider.ts","../../../src/topic/core/primitives/$topic.ts","../../../src/topic/core/index.ts"],"sourcesContent":["import {\n  createPrimitive,\n  KIND,\n  PipelinePrimitive,\n  type PipelinePrimitiveOptions,\n} from \"alepha\";\nimport type {\n  TopicHandler,\n  TopicMessageSchema,\n  TopicPrimitive,\n} from \"./$topic.ts\";\n\n/**\n * Creates a subscriber primitive to listen for messages from a specific topic.\n *\n * Provides a dedicated message subscriber that connects to a topic and processes messages\n * with custom handler logic, enabling scalable pub/sub architectures where multiple\n * subscribers can react to the same events independently.\n *\n * **Key Features**\n * - Seamless integration with any $topic primitive\n * - Full type safety inherited from topic schema\n * - Real-time message delivery when events are published\n * - Error isolation between subscribers\n * - Support for multiple independent subscribers per topic\n *\n * **Common Use Cases**\n * - Notification services and audit logging\n * - Analytics and metrics collection\n * - Data synchronization and real-time UI updates\n *\n * @example\n * ```ts\n * class UserActivityService {\n *   userEvents = $topic({\n *     name: \"user-activity\",\n *     schema: {\n *       payload: t.object({\n *         userId: t.text(),\n *         action: t.enum([\"login\", \"logout\", \"purchase\"]),\n *         timestamp: t.number()\n *       })\n *     }\n *   });\n *\n *   activityLogger = $subscriber({\n *     topic: this.userEvents,\n *     handler: async (message) => {\n *       const { userId, action, timestamp } = message.payload;\n *       await this.auditLogger.log({\n *         userId,\n *         action,\n *         timestamp\n *       });\n *     }\n *   });\n *\n *   async trackUserLogin(userId: string) {\n *     await this.userEvents.publish({\n *       userId,\n *       action: \"login\",\n *       timestamp: Date.now()\n *     });\n *   }\n * }\n * ```\n */\nexport const $subscriber = <T extends TopicMessageSchema>(\n  options: SubscriberPrimitiveOptions<T>,\n): SubscriberPrimitive<T> => {\n  return createPrimitive(SubscriberPrimitive<T>, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface SubscriberPrimitiveOptions<T extends TopicMessageSchema>\n  extends PipelinePrimitiveOptions {\n  /**\n   * The topic primitive that this subscriber will listen to for messages.\n   *\n   * This establishes the connection between the subscriber and its source topic:\n   * - The subscriber inherits the topic's message schema for type safety\n   * - Messages published to the topic will be automatically delivered to this subscriber\n   * - Multiple subscribers can listen to the same topic independently\n   * - The subscriber will use the topic's provider and configuration settings\n   *\n   * **Topic Integration Benefits**:\n   * - Type safety: Subscriber handler gets fully typed message payloads\n   * - Schema validation: Messages are validated before reaching the subscriber\n   * - Real-time delivery: Messages are delivered immediately upon publication\n   * - Error isolation: Subscriber errors don't affect the topic or other subscribers\n   * - Monitoring: Topic metrics include subscriber processing statistics\n   *\n   * @example\n   * ```ts\n   * // First, define a topic\n   * userEvents = $topic({\n   *   name: \"user-activity\",\n   *   schema: {\n   *     payload: t.object({ userId: t.text(), action: t.text() })\n   *   }\n   * });\n   *\n   * // Then, create a subscriber for that topic\n   * activitySubscriber = $subscriber({\n   *   topic: this.userEvents,  // Reference the topic primitive\n   *   handler: async (message) => { } // Process messages here\n   * });\n   * ```\n   */\n  topic: TopicPrimitive<T>;\n\n  /**\n   * Message handler function that processes individual messages from the topic.\n   *\n   * This function:\n   * - Receives fully typed and validated message payloads from the connected topic\n   * - Executes immediately when messages are published to the topic\n   * - Should implement the core business logic for reacting to these events\n   * - Runs independently of other subscribers to the same topic\n   * - Should handle errors gracefully to avoid affecting other subscribers\n   * - Has access to the full Alepha dependency injection container\n   *\n   * **Handler Design Guidelines**:\n   * - Keep handlers focused on a single responsibility\n   * - Use proper error handling and logging\n   * - Consider performance impact for high-frequency topics\n   * - Make handlers idempotent when possible for reliability\n   * - Validate business rules within the handler logic\n   * - Log important processing steps for debugging and monitoring\n   *\n   * **Error Handling Strategy**:\n   * - Log errors but don't re-throw to avoid affecting other subscribers\n   * - Use try-catch blocks for external service calls\n   * - Implement circuit breakers for resilience with external systems\n   * - Monitor error rates and patterns for system health\n   * - Consider implementing retry logic for temporary failures\n   *\n   * **Performance Considerations**:\n   * - Keep handler execution time minimal for high-throughput topics\n   * - Use background queues for heavy processing triggered by events\n   * - Implement batching for efficiency when processing many similar events\n   * - Consider async processing patterns for non-critical operations\n   *\n   * @param message - The topic message with validated payload and optional headers\n   * @param message.payload - The typed message data based on the topic's schema\n   * @returns Promise that resolves when processing is complete\n   *\n   * @example\n   * ```ts\n   * handler: async (message) => {\n   *   const { userId, eventType, timestamp } = message.payload;\n   *\n   *   try {\n   *     // Log event receipt\n   *     this.logger.info(`Processing ${eventType} event for user ${userId}`, {\n   *       timestamp,\n   *       userId,\n   *       eventType\n   *     });\n   *\n   *     // Perform event-specific processing\n   *     switch (eventType) {\n   *       case 'user.login':\n   *         await this.updateLastLogin(userId, timestamp);\n   *         await this.sendWelcomeNotification(userId);\n   *         break;\n   *       case 'user.logout':\n   *         await this.updateSessionDuration(userId, timestamp);\n   *         break;\n   *       case 'user.purchase':\n   *         await this.updateRewardsPoints(userId, message.payload.purchaseAmount);\n   *         await this.triggerRecommendations(userId);\n   *         break;\n   *       default:\n   *         this.logger.warn(`Unknown event type: ${eventType}`);\n   *     }\n   *\n   *     // Update analytics\n   *     await this.analytics.track(eventType, {\n   *       userId,\n   *       timestamp,\n   *       source: 'topic-subscriber'\n   *     });\n   *\n   *     this.logger.info(`Successfully processed ${eventType} for user ${userId}`);\n   *\n   *   } catch (error) {\n   *     // Log error but don't re-throw to avoid affecting other subscribers\n   *     this.logger.error(`Failed to process ${eventType} for user ${userId}`, {\n   *       error: error.message,\n   *       stack: error.stack,\n   *       userId,\n   *       eventType,\n   *       timestamp\n   *     });\n   *\n   *     // Optionally send to error tracking service\n   *     await this.errorTracker.captureException(error, {\n   *       context: { userId, eventType, timestamp },\n   *       tags: { component: 'topic-subscriber' }\n   *     });\n   *   }\n   * }\n   * ```\n   */\n  handler: TopicHandler<T>;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class SubscriberPrimitive<\n  T extends TopicMessageSchema,\n> extends PipelinePrimitive<SubscriberPrimitiveOptions<T>> {}\n\n$subscriber[KIND] = SubscriberPrimitive;\n","import { AlephaError } from \"alepha\";\n\nexport class TopicTimeoutError extends AlephaError {\n  public readonly topic: string;\n  public readonly timeout: number;\n\n  constructor(topic: string, timeout: number) {\n    super(`Timeout of ${timeout}ms exceeded for topic ${topic}`);\n    this.timeout = timeout;\n    this.topic = topic;\n  }\n}\n","import { $inject, Alepha } from \"alepha\";\nimport { DateTimeProvider, type Timeout } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { TemplatedPathParser } from \"alepha/router\";\nimport { TopicTimeoutError } from \"../errors/TopicTimeoutError.ts\";\nimport { $subscriber } from \"../primitives/$subscriber.ts\";\nimport {\n  $topic,\n  type TopicHandler,\n  type TopicMessage,\n  type TopicMessageSchema,\n  type TopicWaitOptions,\n} from \"../primitives/$topic.ts\";\n\n/**\n * Base class for topic providers.\n */\nexport abstract class TopicProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly log = $logger();\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n\n  /**\n   * Publish a raw message to a topic.\n   *\n   * @param topic - The topic to publish to.\n   * @param message - The message to publish.\n   */\n  public abstract publish(\n    topic: string,\n    message: string,\n    options?: TopicPublishOptions,\n  ): Promise<void>;\n\n  /**\n   * Subscribe to a topic with a raw callback.\n   *\n   * @param topic - The topic to subscribe to.\n   * @param callback - The callback to call when a message is received.\n   */\n  public abstract subscribe(\n    topic: string,\n    callback: SubscribeCallback,\n    options?: TopicSubscribeOptions,\n  ): Promise<UnSubscribeFn>;\n\n  /**\n   * Unsubscribe from a topic.\n   *\n   * @param topic - The topic to unsubscribe from.\n   */\n  public abstract unsubscribe(topic: string): Promise<void>;\n\n  /**\n   * Encode and publish a typed message to a topic.\n   */\n  public async publishMessage<T extends TopicMessageSchema>(\n    name: string,\n    schema: T[\"payload\"],\n    payload: TopicMessage<T>[\"payload\"],\n    options?: TopicPublishOptions,\n  ): Promise<void> {\n    let topicName = name;\n    if (options?.params) {\n      const parser = new TemplatedPathParser(name);\n      topicName = parser.interpolate(options.params);\n    }\n\n    await this.publish(\n      topicName,\n      JSON.stringify({\n        payload: this.alepha.codec.encode(schema, payload),\n      }),\n      options,\n    );\n  }\n\n  /**\n   * Parse a raw message string into a typed topic message.\n   */\n  public parseMessage<T extends TopicMessageSchema>(\n    schema: T[\"payload\"],\n    message: string,\n  ): TopicMessage<T> {\n    const { payload } = JSON.parse(message);\n    return {\n      payload: this.alepha.codec.decode(\n        schema,\n        payload,\n      ) as TopicMessage<T>[\"payload\"],\n    } as TopicMessage<T>;\n  }\n\n  /**\n   * Subscribe a typed handler to a topic, with error wrapping and message parsing.\n   */\n  public async subscribeHandler<T extends TopicMessageSchema>(\n    name: string,\n    schema: T[\"payload\"],\n    handler: TopicHandler<T>,\n    options?: TopicSubscribeOptions,\n  ): Promise<UnSubscribeFn> {\n    const parser = new TemplatedPathParser(name);\n    const subscribeTopic = parser.hasParams\n      ? parser.wildcardize(this.wildcardChar())\n      : name;\n\n    return this.subscribe(\n      subscribeTopic,\n      async (message, receivedTopic?: string) => {\n        try {\n          const parsed = this.parseMessage<T>(schema, message);\n\n          if (parser.hasParams && receivedTopic) {\n            const params = parser.extract(receivedTopic) ?? {};\n            await handler({ ...parsed, params } as TopicMessage<T>);\n          } else {\n            await handler(parsed);\n          }\n        } catch (error) {\n          this.log.error(\"Message processing has failed\", error);\n        }\n      },\n      options,\n    );\n  }\n\n  /**\n   * Wait for a single message matching an optional filter, with timeout.\n   */\n  public async waitForMessage<T extends TopicMessageSchema>(\n    name: string,\n    schema: T[\"payload\"],\n    options: TopicWaitOptions<T> = {},\n  ): Promise<TopicMessage<T>> {\n    const filter = options.filter ?? (() => true);\n\n    return new Promise((resolve, reject) => {\n      const ref: { timeout?: Timeout; clear?: () => void } = {};\n\n      (async () => {\n        const clear = await this.subscribe(name, (raw) => {\n          const message = this.parseMessage<T>(schema, raw);\n          if (!filter(message)) {\n            return;\n          }\n\n          ref.timeout?.clear();\n          if (ref.clear) {\n            ref.clear();\n          }\n          resolve(message);\n        });\n\n        ref.clear = clear;\n\n        const timeoutDuration = options.timeout ?? [10, \"seconds\"];\n\n        ref.timeout = this.dateTimeProvider.createTimeout(() => {\n          clear();\n          reject(\n            new TopicTimeoutError(\n              name,\n              this.dateTimeProvider.duration(timeoutDuration).asMilliseconds(),\n            ),\n          );\n        }, timeoutDuration);\n      })();\n    });\n  }\n\n  /**\n   * The wildcard character used for pattern subscriptions.\n   * Override in subclasses for provider-specific wildcards.\n   */\n  protected wildcardChar(): string {\n    return \"+\";\n  }\n\n  /**\n   * Returns the list of $subscribers for this provider.\n   */\n  protected subscribers(): Array<() => Promise<unknown>> {\n    const handlers: Array<() => Promise<unknown>> = [];\n\n    const topics = this.alepha.primitives($topic);\n\n    for (const topic of topics) {\n      if (topic.provider !== this) {\n        continue;\n      }\n\n      const handler = topic.options.handler;\n      if (handler && topic.provider === this) {\n        handlers.push(() => topic.subscribe(handler));\n      }\n    }\n\n    const subscribers = this.alepha.primitives($subscriber);\n    for (const subscriber of subscribers) {\n      if (subscriber.options.topic.provider !== this) {\n        continue;\n      }\n\n      const handler = subscriber.handler.run.bind(subscriber.handler);\n      handlers.push(() => subscriber.options.topic.subscribe(handler));\n    }\n\n    return handlers;\n  }\n}\n\nexport type SubscribeCallback = (\n  message: string,\n  topic?: string,\n) => Promise<void> | void;\n\nexport type UnSubscribeFn = () => Promise<void>;\n\nexport interface TopicPublishOptions {\n  retain?: boolean;\n  params?: Record<string, string>;\n}\n\n// biome-ignore lint/suspicious/noEmptyInterface: augmented by provider-specific modules (e.g. MqttTopicProvider)\nexport interface TopicSubscribeOptions {}\n","import { $hook } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport {\n  type SubscribeCallback,\n  TopicProvider,\n  type TopicPublishOptions,\n  type TopicSubscribeOptions,\n  type UnSubscribeFn,\n} from \"./TopicProvider.ts\";\n\nexport class MemoryTopicProvider extends TopicProvider {\n  protected readonly log = $logger();\n  protected readonly subscriptions: Record<string, SubscribeCallback[]> = {};\n  protected readonly retained: Record<string, string> = {};\n\n  protected readonly start = $hook({\n    on: \"start\",\n    handler: async () => {\n      const subscribers = this.subscribers();\n      if (subscribers.length) {\n        await Promise.all(subscribers.map((fn) => fn()));\n        for (const subscriber of subscribers) {\n          this.log.debug(`Subscribed to topic '${subscriber.name}'`);\n        }\n      }\n    },\n  });\n\n  /**\n   * Publish a message to a topic.\n   *\n   * @param topic\n   * @param message\n   * @param options\n   */\n  public async publish(\n    topic: string,\n    message: string,\n    options?: TopicPublishOptions,\n  ): Promise<void> {\n    if (options?.retain) {\n      this.retained[topic] = message;\n    }\n\n    for (const [pattern, callbacks] of Object.entries(this.subscriptions)) {\n      if (this.topicMatches(pattern, topic)) {\n        for (const callback of callbacks) {\n          await callback(message, topic);\n        }\n      }\n    }\n  }\n\n  /**\n   * Subscribe to a topic.\n   *\n   * @param topic - The topic to subscribe to.\n   * @param callback\n   */\n\n  public async subscribe(\n    topic: string,\n    callback: SubscribeCallback,\n    _options?: TopicSubscribeOptions,\n  ): Promise<UnSubscribeFn> {\n    if (!this.subscriptions[topic]) {\n      this.subscriptions[topic] = [];\n    }\n\n    this.subscriptions[topic].push(callback);\n\n    // Deliver retained messages matching the pattern\n    for (const [retainedTopic, retainedMessage] of Object.entries(\n      this.retained,\n    )) {\n      if (this.topicMatches(topic, retainedTopic)) {\n        await callback(retainedMessage, retainedTopic);\n      }\n    }\n\n    return async () => {\n      const callbacks = this.subscriptions[topic];\n      if (!callbacks) {\n        return;\n      }\n\n      this.subscriptions[topic] = callbacks.filter((cb) => cb !== callback);\n      if (this.subscriptions[topic].length === 0) {\n        delete this.subscriptions[topic];\n      }\n    };\n  }\n\n  /**\n   * Unsubscribe from a topic.\n   *\n   * @param topic - The topic to unsubscribe from.\n   */\n  public async unsubscribe(topic: string): Promise<void> {\n    delete this.subscriptions[topic];\n  }\n\n  /**\n   * Check if a topic matches a subscription pattern.\n   * Supports `+` single-level wildcard.\n   */\n  protected topicMatches(pattern: string, topic: string): boolean {\n    if (pattern === topic) {\n      return true;\n    }\n\n    const patternParts = pattern.split(\"/\");\n    const topicParts = topic.split(\"/\");\n\n    if (patternParts.length !== topicParts.length) {\n      return false;\n    }\n\n    return patternParts.every(\n      (part, i) => part === \"+\" || part === topicParts[i],\n    );\n  }\n}\n","import {\n  createPrimitive,\n  KIND,\n  Primitive,\n  type Service,\n  type Static,\n  type TSchema,\n} from \"alepha\";\nimport type { DurationLike } from \"alepha/datetime\";\nimport { MemoryTopicProvider } from \"../providers/MemoryTopicProvider.ts\";\nimport {\n  TopicProvider,\n  type TopicPublishOptions,\n  type UnSubscribeFn,\n} from \"../providers/TopicProvider.ts\";\n\n/**\n * Creates a topic primitive for publish/subscribe messaging and event-driven architecture.\n *\n * Enables decoupled communication through a pub/sub pattern where publishers send messages\n * and multiple subscribers receive them. Supports type-safe messages, real-time delivery,\n * event filtering, and pluggable backends (memory, Redis, custom providers).\n *\n * **Use Cases**: User notifications, real-time chat, event broadcasting, microservice communication\n *\n * @example\n * ```ts\n * class NotificationService {\n *   userActivity = $topic({\n *     name: \"user-activity\",\n *     schema: {\n *       payload: t.object({\n *         userId: t.text(),\n *         action: t.enum([\"login\", \"logout\", \"purchase\"]),\n *         timestamp: t.number()\n *       })\n *     },\n *     handler: async (message) => {\n *       console.log(`User ${message.payload.userId}: ${message.payload.action}`);\n *     }\n *   });\n *\n *   async trackLogin(userId: string) {\n *     await this.userActivity.publish({ userId, action: \"login\", timestamp: Date.now() });\n *   }\n *\n *   async subscribeToEvents() {\n *     await this.userActivity.subscribe(async (message) => {\n *       // Additional subscriber logic\n *     });\n *   }\n * }\n * ```\n */\nexport const $topic = <T extends TopicMessageSchema>(\n  options: TopicPrimitiveOptions<T>,\n): TopicPrimitive<T> => {\n  return createPrimitive(TopicPrimitive<T>, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface TopicPrimitiveOptions<T extends TopicMessageSchema> {\n  /**\n   * Unique name identifier for the topic.\n   *\n   * This name is used for:\n   * - Topic identification across the pub/sub system\n   * - Message routing between publishers and subscribers\n   * - Logging and debugging topic-related operations\n   * - Provider-specific topic management (channels, keys, etc.)\n   *\n   * If not provided, defaults to the property key where the topic is declared.\n   *\n   * **Naming Conventions**:\n   * - Use descriptive, hierarchical names: \"user.activity\", \"order.events\"\n   * - Avoid spaces and special characters\n   * - Consider using dot notation for categorization\n   * - Keep names concise but meaningful\n   *\n   * @example \"user-activity\"\n   * @example \"chat.messages\"\n   * @example \"system.health.checks\"\n   * @example \"payment.webhooks\"\n   */\n  name?: string;\n\n  /**\n   * Human-readable description of the topic's purpose and usage.\n   *\n   * Used for:\n   * - Documentation generation and API references\n   * - Developer onboarding and understanding\n   * - Monitoring dashboards and admin interfaces\n   * - Team communication about system architecture\n   *\n   * **Description Best Practices**:\n   * - Explain what events/messages this topic handles\n   * - Mention key use cases and subscribers\n   * - Include any important timing or ordering guarantees\n   * - Note any special processing requirements\n   *\n   * @example \"Real-time user activity events for analytics and notifications\"\n   * @example \"Order lifecycle events from creation to delivery\"\n   * @example \"Chat messages broadcast to all room participants\"\n   * @example \"System health checks and service status updates\"\n   */\n  description?: string;\n\n  /**\n   * Topic provider configuration for message storage and delivery.\n   *\n   * Options:\n   * - **\"memory\"**: In-memory provider (default for development, lost on restart)\n   * - **Service<TopicProvider>**: Custom provider class (e.g., RedisTopicProvider)\n   * - **undefined**: Uses the default topic provider from dependency injection\n   *\n   * **Provider Selection Guidelines**:\n   * - **Development**: Use \"memory\" for fast, simple testing without external dependencies\n   * - **Production**: Use Redis or message brokers for persistence and scalability\n   * - **Distributed systems**: Use Redis/RabbitMQ for cross-service communication\n   * - **High-throughput**: Use specialized providers with connection pooling\n   * - **Real-time**: Ensure provider supports low-latency message delivery\n   *\n   * **Provider Capabilities**:\n   * - Message persistence and durability\n   * - Subscriber management and connection handling\n   * - Message ordering and delivery guarantees\n   * - Horizontal scaling and load distribution\n   *\n   * @default Uses injected TopicProvider\n   * @example \"memory\"\n   * @example RedisTopicProvider\n   * @example RabbitMQTopicProvider\n   */\n  provider?: \"memory\" | Service<TopicProvider>;\n\n  /**\n   * TypeBox schema defining the structure of messages published to this topic.\n   *\n   * The schema must include:\n   * - **payload**: Required schema for the main message data\n   * - **headers**: Optional schema for message metadata\n   *\n   * This schema:\n   * - Validates all messages published to the topic\n   * - Provides full TypeScript type inference for subscribers\n   * - Ensures type safety between publishers and subscribers\n   * - Enables automatic serialization/deserialization\n   *\n   * **Schema Design Best Practices**:\n   * - Keep payload schemas focused and cohesive\n   * - Use optional fields for data that might not always be present\n   * - Include timestamp fields for event ordering\n   * - Consider versioning for schema evolution\n   * - Use union types for different event types in the same topic\n   *\n   * @example\n   * ```ts\n   * {\n   *   payload: t.object({\n   *     eventId: t.text(),\n   *     eventType: t.enum([\"created\", \"updated\"]),\n   *     data: t.record(t.text(), t.any()),\n   *     timestamp: t.number(),\n   *     userId: t.optional(t.text())\n   *   }),\n   *   headers: t.optional(t.object({\n   *     source: t.text(),\n   *     correlationId: t.text()\n   *   }))\n   * }\n   * ```\n   */\n  schema: T;\n\n  /**\n   * Default subscriber handler function that processes messages published to this topic.\n   *\n   * This handler:\n   * - Automatically subscribes when the topic is initialized\n   * - Receives all messages published to the topic\n   * - Runs for every message without additional subscription setup\n   * - Can be supplemented with additional subscribers via `subscribe()` method\n   * - Should handle errors gracefully to avoid breaking other subscribers\n   *\n   * **Handler Design Guidelines**:\n   * - Keep handlers focused on a single responsibility\n   * - Use proper error handling and logging\n   * - Consider performance impact for high-frequency topics\n   * - Make handlers idempotent when possible\n   * - Validate business rules within the handler logic\n   * - Log important processing steps for debugging\n   *\n   * **Error Handling Strategy**:\n   * - Log errors but don't re-throw to avoid affecting other subscribers\n   * - Use try-catch blocks for external service calls\n   * - Consider implementing circuit breakers for resilience\n   * - Monitor error rates and patterns for system health\n   *\n   * @param message - The topic message with validated payload and headers\n   * @param message.payload - The typed message data based on the schema\n   * @returns Promise that resolves when processing is complete\n   *\n   * @example\n   * ```ts\n   * handler: async (message) => {\n   *   const { eventType, data, timestamp } = message.payload;\n   *\n   *   try {\n   *     // Log message receipt\n   *     this.logger.info(`Processing ${eventType} event`, { timestamp, data });\n   *\n   *     // Process based on event type\n   *     switch (eventType) {\n   *       case \"created\":\n   *         await this.handleCreation(data);\n   *         break;\n   *       case \"updated\":\n   *         await this.handleUpdate(data);\n   *         break;\n   *       default:\n   *         this.logger.warn(`Unknown event type: ${eventType}`);\n   *     }\n   *\n   *     this.logger.info(`Successfully processed ${eventType} event`);\n   *\n   *   } catch (error) {\n   *     // Log error but don't re-throw to avoid affecting other subscribers\n   *     this.logger.error(`Failed to process ${eventType} event`, {\n   *       error: error.message,\n   *       eventType,\n   *       timestamp,\n   *       data\n   *     });\n   *   }\n   * }\n   * ```\n   */\n  handler?: TopicHandler<T>;\n\n  /**\n   * Whether the last published message should be retained and delivered to new subscribers.\n   *\n   * When enabled, the provider stores the last message for this topic.\n   * New subscribers immediately receive the retained message upon subscribing.\n   *\n   * Supported by Memory, Redis, and MQTT providers.\n   *\n   * @default false\n   */\n  retain?: boolean;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class TopicPrimitive<T extends TopicMessageSchema> extends Primitive<\n  TopicPrimitiveOptions<T>\n> {\n  public readonly provider = this.$provider();\n\n  public get name(): string {\n    return this.options.name || this.config.propertyKey;\n  }\n\n  public async publish(\n    message: T extends { params: TSchema }\n      ? { params: Static<T[\"params\"]>; payload: TopicMessage<T>[\"payload\"] }\n      : TopicMessage<T>[\"payload\"],\n  ): Promise<void> {\n    const hasParams = this.options.schema.params;\n    const payload = hasParams ? (message as any).payload : message;\n    const params = hasParams ? (message as any).params : undefined;\n\n    await this.provider.publishMessage<T>(\n      this.name,\n      this.options.schema.payload,\n      payload,\n      {\n        retain: this.options.retain,\n        mqtt: (this.options as any).mqtt,\n        params,\n      } as TopicPublishOptions,\n    );\n  }\n\n  public async subscribe(handler: TopicHandler<T>): Promise<UnSubscribeFn> {\n    return this.provider.subscribeHandler<T>(\n      this.name,\n      this.options.schema.payload,\n      handler,\n      { mqtt: (this.options as any).mqtt },\n    );\n  }\n\n  public async wait(\n    options: TopicWaitOptions<T> = {},\n  ): Promise<TopicMessage<T>> {\n    return this.provider.waitForMessage<T>(\n      this.name,\n      this.options.schema.payload,\n      options,\n    );\n  }\n\n  protected $provider(): TopicProvider {\n    if (!this.options.provider) {\n      return this.alepha.inject(TopicProvider);\n    }\n\n    if (this.options.provider === \"memory\") {\n      return this.alepha.inject(MemoryTopicProvider);\n    }\n\n    return this.alepha.inject(this.options.provider);\n  }\n}\n\n$topic[KIND] = TopicPrimitive;\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface TopicMessage<T extends TopicMessageSchema> {\n  payload: Static<T[\"payload\"]>;\n  params: T extends { params: TSchema } ? Static<T[\"params\"]> : never;\n}\n\nexport interface TopicWaitOptions<T extends TopicMessageSchema> {\n  timeout?: DurationLike;\n  filter?: (message: { payload: Static<T[\"payload\"]> }) => boolean;\n}\n\nexport interface TopicMessageSchema {\n  payload: TSchema;\n  params?: TSchema;\n}\n\nexport type TopicHandler<T extends TopicMessageSchema = TopicMessageSchema> = (\n  message: TopicMessage<T>,\n) => unknown;\n","import { $module, type Alepha } from \"alepha\";\nimport { $subscriber } from \"./primitives/$subscriber.ts\";\nimport { $topic } from \"./primitives/$topic.ts\";\nimport { MemoryTopicProvider } from \"./providers/MemoryTopicProvider.ts\";\nimport { TopicProvider } from \"./providers/TopicProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./errors/TopicTimeoutError.ts\";\nexport * from \"./primitives/$subscriber.ts\";\nexport * from \"./primitives/$topic.ts\";\nexport * from \"./providers/MemoryTopicProvider.ts\";\nexport * from \"./providers/TopicProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Publish/subscribe messaging for event-driven architectures.\n *\n * **Features:**\n * - Pub/sub topics with type-safe messages\n * - Topic subscription handlers\n * - Multiple subscriber support\n * - Message filtering and routing\n * - Providers: Memory (dev), Redis (production)\n *\n * @module alepha.topic\n */\nexport const AlephaTopic = $module({\n  name: \"alepha.topic\",\n  primitives: [$topic, $subscriber],\n  services: [TopicProvider],\n  variants: [MemoryTopicProvider],\n  register: (alepha: Alepha) =>\n    alepha.with({\n      optional: true,\n      provide: TopicProvider,\n      use: MemoryTopicProvider,\n    }),\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmEA,MAAa,eACX,YAC2B;CAC3B,OAAO,gBAAgB,qBAAwB,QAAQ;;AA6IzD,IAAa,sBAAb,cAEU,kBAAiD;AAE3D,YAAY,QAAQ;;;ACrNpB,IAAa,oBAAb,cAAuC,YAAY;CACjD;CACA;CAEA,YAAY,OAAe,SAAiB;EAC1C,MAAM,cAAc,QAAQ,wBAAwB,QAAQ;EAC5D,KAAK,UAAU;EACf,KAAK,QAAQ;;;;;;;;ACQjB,IAAsB,gBAAtB,MAAoC;CAClC,SAA4B,QAAQ,OAAO;CAC3C,MAAyB,SAAS;CAClC,mBAAsC,QAAQ,iBAAiB;;;;CAoC/D,MAAa,eACX,MACA,QACA,SACA,SACe;EACf,IAAI,YAAY;EAChB,IAAI,SAAS,QAEX,YAAY,IADO,oBAAoB,KACrB,CAAC,YAAY,QAAQ,OAAO;EAGhD,MAAM,KAAK,QACT,WACA,KAAK,UAAU,EACb,SAAS,KAAK,OAAO,MAAM,OAAO,QAAQ,QAAQ,EACnD,CAAC,EACF,QACD;;;;;CAMH,aACE,QACA,SACiB;EACjB,MAAM,EAAE,YAAY,KAAK,MAAM,QAAQ;EACvC,OAAO,EACL,SAAS,KAAK,OAAO,MAAM,OACzB,QACA,QACD,EACF;;;;;CAMH,MAAa,iBACX,MACA,QACA,SACA,SACwB;EACxB,MAAM,SAAS,IAAI,oBAAoB,KAAK;EAC5C,MAAM,iBAAiB,OAAO,YAC1B,OAAO,YAAY,KAAK,cAAc,CAAC,GACvC;EAEJ,OAAO,KAAK,UACV,gBACA,OAAO,SAAS,kBAA2B;GACzC,IAAI;IACF,MAAM,SAAS,KAAK,aAAgB,QAAQ,QAAQ;IAEpD,IAAI,OAAO,aAAa,eAAe;KACrC,MAAM,SAAS,OAAO,QAAQ,cAAc,IAAI,EAAE;KAClD,MAAM,QAAQ;MAAE,GAAG;MAAQ;MAAQ,CAAoB;WAEvD,MAAM,QAAQ,OAAO;YAEhB,OAAO;IACd,KAAK,IAAI,MAAM,iCAAiC,MAAM;;KAG1D,QACD;;;;;CAMH,MAAa,eACX,MACA,QACA,UAA+B,EAAE,EACP;EAC1B,MAAM,SAAS,QAAQ,iBAAiB;EAExC,OAAO,IAAI,SAAS,SAAS,WAAW;GACtC,MAAM,MAAiD,EAAE;GAEzD,CAAC,YAAY;IACX,MAAM,QAAQ,MAAM,KAAK,UAAU,OAAO,QAAQ;KAChD,MAAM,UAAU,KAAK,aAAgB,QAAQ,IAAI;KACjD,IAAI,CAAC,OAAO,QAAQ,EAClB;KAGF,IAAI,SAAS,OAAO;KACpB,IAAI,IAAI,OACN,IAAI,OAAO;KAEb,QAAQ,QAAQ;MAChB;IAEF,IAAI,QAAQ;IAEZ,MAAM,kBAAkB,QAAQ,WAAW,CAAC,IAAI,UAAU;IAE1D,IAAI,UAAU,KAAK,iBAAiB,oBAAoB;KACtD,OAAO;KACP,OACE,IAAI,kBACF,MACA,KAAK,iBAAiB,SAAS,gBAAgB,CAAC,gBAAgB,CACjE,CACF;OACA,gBAAgB;OACjB;IACJ;;;;;;CAOJ,eAAiC;EAC/B,OAAO;;;;;CAMT,cAAuD;EACrD,MAAM,WAA0C,EAAE;EAElD,MAAM,SAAS,KAAK,OAAO,WAAW,OAAO;EAE7C,KAAK,MAAM,SAAS,QAAQ;GAC1B,IAAI,MAAM,aAAa,MACrB;GAGF,MAAM,UAAU,MAAM,QAAQ;GAC9B,IAAI,WAAW,MAAM,aAAa,MAChC,SAAS,WAAW,MAAM,UAAU,QAAQ,CAAC;;EAIjD,MAAM,cAAc,KAAK,OAAO,WAAW,YAAY;EACvD,KAAK,MAAM,cAAc,aAAa;GACpC,IAAI,WAAW,QAAQ,MAAM,aAAa,MACxC;GAGF,MAAM,UAAU,WAAW,QAAQ,IAAI,KAAK,WAAW,QAAQ;GAC/D,SAAS,WAAW,WAAW,QAAQ,MAAM,UAAU,QAAQ,CAAC;;EAGlE,OAAO;;;;;ACtMX,IAAa,sBAAb,cAAyC,cAAc;CACrD,MAAyB,SAAS;CAClC,gBAAwE,EAAE;CAC1E,WAAsD,EAAE;CAExD,QAA2B,MAAM;EAC/B,IAAI;EACJ,SAAS,YAAY;GACnB,MAAM,cAAc,KAAK,aAAa;GACtC,IAAI,YAAY,QAAQ;IACtB,MAAM,QAAQ,IAAI,YAAY,KAAK,OAAO,IAAI,CAAC,CAAC;IAChD,KAAK,MAAM,cAAc,aACvB,KAAK,IAAI,MAAM,wBAAwB,WAAW,KAAK,GAAG;;;EAIjE,CAAC;;;;;;;;CASF,MAAa,QACX,OACA,SACA,SACe;EACf,IAAI,SAAS,QACX,KAAK,SAAS,SAAS;EAGzB,KAAK,MAAM,CAAC,SAAS,cAAc,OAAO,QAAQ,KAAK,cAAc,EACnE,IAAI,KAAK,aAAa,SAAS,MAAM,EACnC,KAAK,MAAM,YAAY,WACrB,MAAM,SAAS,SAAS,MAAM;;;;;;;;CAatC,MAAa,UACX,OACA,UACA,UACwB;EACxB,IAAI,CAAC,KAAK,cAAc,QACtB,KAAK,cAAc,SAAS,EAAE;EAGhC,KAAK,cAAc,OAAO,KAAK,SAAS;EAGxC,KAAK,MAAM,CAAC,eAAe,oBAAoB,OAAO,QACpD,KAAK,SACN,EACC,IAAI,KAAK,aAAa,OAAO,cAAc,EACzC,MAAM,SAAS,iBAAiB,cAAc;EAIlD,OAAO,YAAY;GACjB,MAAM,YAAY,KAAK,cAAc;GACrC,IAAI,CAAC,WACH;GAGF,KAAK,cAAc,SAAS,UAAU,QAAQ,OAAO,OAAO,SAAS;GACrE,IAAI,KAAK,cAAc,OAAO,WAAW,GACvC,OAAO,KAAK,cAAc;;;;;;;;CAUhC,MAAa,YAAY,OAA8B;EACrD,OAAO,KAAK,cAAc;;;;;;CAO5B,aAAuB,SAAiB,OAAwB;EAC9D,IAAI,YAAY,OACd,OAAO;EAGT,MAAM,eAAe,QAAQ,MAAM,IAAI;EACvC,MAAM,aAAa,MAAM,MAAM,IAAI;EAEnC,IAAI,aAAa,WAAW,WAAW,QACrC,OAAO;EAGT,OAAO,aAAa,OACjB,MAAM,MAAM,SAAS,OAAO,SAAS,WAAW,GAClD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AClEL,MAAa,UACX,YACsB;CACtB,OAAO,gBAAgB,gBAAmB,QAAQ;;AAuMpD,IAAa,iBAAb,cAAkE,UAEhE;CACA,WAA2B,KAAK,WAAW;CAE3C,IAAW,OAAe;EACxB,OAAO,KAAK,QAAQ,QAAQ,KAAK,OAAO;;CAG1C,MAAa,QACX,SAGe;EACf,MAAM,YAAY,KAAK,QAAQ,OAAO;EACtC,MAAM,UAAU,YAAa,QAAgB,UAAU;EACvD,MAAM,SAAS,YAAa,QAAgB,SAAS,KAAA;EAErD,MAAM,KAAK,SAAS,eAClB,KAAK,MACL,KAAK,QAAQ,OAAO,SACpB,SACA;GACE,QAAQ,KAAK,QAAQ;GACrB,MAAO,KAAK,QAAgB;GAC5B;GACD,CACF;;CAGH,MAAa,UAAU,SAAkD;EACvE,OAAO,KAAK,SAAS,iBACnB,KAAK,MACL,KAAK,QAAQ,OAAO,SACpB,SACA,EAAE,MAAO,KAAK,QAAgB,MAAM,CACrC;;CAGH,MAAa,KACX,UAA+B,EAAE,EACP;EAC1B,OAAO,KAAK,SAAS,eACnB,KAAK,MACL,KAAK,QAAQ,OAAO,SACpB,QACD;;CAGH,YAAqC;EACnC,IAAI,CAAC,KAAK,QAAQ,UAChB,OAAO,KAAK,OAAO,OAAO,cAAc;EAG1C,IAAI,KAAK,QAAQ,aAAa,UAC5B,OAAO,KAAK,OAAO,OAAO,oBAAoB;EAGhD,OAAO,KAAK,OAAO,OAAO,KAAK,QAAQ,SAAS;;;AAIpD,OAAO,QAAQ;;;;;;;;;;;;;;;AClSf,MAAa,cAAc,QAAQ;CACjC,MAAM;CACN,YAAY,CAAC,QAAQ,YAAY;CACjC,UAAU,CAAC,cAAc;CACzB,UAAU,CAAC,oBAAoB;CAC/B,WAAW,WACT,OAAO,KAAK;EACV,UAAU;EACV,SAAS;EACT,KAAK;EACN,CAAC;CACL,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/topic/core/primitives/$subscriber.ts","../../../src/topic/core/errors/TopicTimeoutError.ts","../../../src/topic/core/providers/TopicProvider.ts","../../../src/topic/core/providers/MemoryTopicProvider.ts","../../../src/topic/core/primitives/$topic.ts","../../../src/topic/core/index.ts"],"sourcesContent":["import {\n  createPrimitive,\n  KIND,\n  PipelinePrimitive,\n  type PipelinePrimitiveOptions,\n} from \"alepha\";\nimport type {\n  TopicHandler,\n  TopicMessageSchema,\n  TopicPrimitive,\n} from \"./$topic.ts\";\n\n/**\n * Creates a subscriber primitive to listen for messages from a specific topic.\n *\n * Provides a dedicated message subscriber that connects to a topic and processes messages\n * with custom handler logic, enabling scalable pub/sub architectures where multiple\n * subscribers can react to the same events independently.\n *\n * **Key Features**\n * - Seamless integration with any $topic primitive\n * - Full type safety inherited from topic schema\n * - Real-time message delivery when events are published\n * - Error isolation between subscribers\n * - Support for multiple independent subscribers per topic\n *\n * **Common Use Cases**\n * - Notification services and audit logging\n * - Analytics and metrics collection\n * - Data synchronization and real-time UI updates\n *\n * @example\n * ```ts\n * class UserActivityService {\n *   userEvents = $topic({\n *     name: \"user-activity\",\n *     schema: {\n *       payload: t.object({\n *         userId: t.text(),\n *         action: t.enum([\"login\", \"logout\", \"purchase\"]),\n *         timestamp: t.number()\n *       })\n *     }\n *   });\n *\n *   activityLogger = $subscriber({\n *     topic: this.userEvents,\n *     handler: async (message) => {\n *       const { userId, action, timestamp } = message.payload;\n *       await this.auditLogger.log({\n *         userId,\n *         action,\n *         timestamp\n *       });\n *     }\n *   });\n *\n *   async trackUserLogin(userId: string) {\n *     await this.userEvents.publish({\n *       userId,\n *       action: \"login\",\n *       timestamp: Date.now()\n *     });\n *   }\n * }\n * ```\n */\nexport const $subscriber = <T extends TopicMessageSchema>(\n  options: SubscriberPrimitiveOptions<T>,\n): SubscriberPrimitive<T> => {\n  return createPrimitive(SubscriberPrimitive<T>, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface SubscriberPrimitiveOptions<T extends TopicMessageSchema>\n  extends PipelinePrimitiveOptions {\n  /**\n   * The topic primitive that this subscriber will listen to for messages.\n   *\n   * This establishes the connection between the subscriber and its source topic:\n   * - The subscriber inherits the topic's message schema for type safety\n   * - Messages published to the topic will be automatically delivered to this subscriber\n   * - Multiple subscribers can listen to the same topic independently\n   * - The subscriber will use the topic's provider and configuration settings\n   *\n   * **Topic Integration Benefits**:\n   * - Type safety: Subscriber handler gets fully typed message payloads\n   * - Schema validation: Messages are validated before reaching the subscriber\n   * - Real-time delivery: Messages are delivered immediately upon publication\n   * - Error isolation: Subscriber errors don't affect the topic or other subscribers\n   * - Monitoring: Topic metrics include subscriber processing statistics\n   *\n   * @example\n   * ```ts\n   * // First, define a topic\n   * userEvents = $topic({\n   *   name: \"user-activity\",\n   *   schema: {\n   *     payload: t.object({ userId: t.text(), action: t.text() })\n   *   }\n   * });\n   *\n   * // Then, create a subscriber for that topic\n   * activitySubscriber = $subscriber({\n   *   topic: this.userEvents,  // Reference the topic primitive\n   *   handler: async (message) => { } // Process messages here\n   * });\n   * ```\n   */\n  topic: TopicPrimitive<T>;\n\n  /**\n   * Message handler function that processes individual messages from the topic.\n   *\n   * This function:\n   * - Receives fully typed and validated message payloads from the connected topic\n   * - Executes immediately when messages are published to the topic\n   * - Should implement the core business logic for reacting to these events\n   * - Runs independently of other subscribers to the same topic\n   * - Should handle errors gracefully to avoid affecting other subscribers\n   * - Has access to the full Alepha dependency injection container\n   *\n   * **Handler Design Guidelines**:\n   * - Keep handlers focused on a single responsibility\n   * - Use proper error handling and logging\n   * - Consider performance impact for high-frequency topics\n   * - Make handlers idempotent when possible for reliability\n   * - Validate business rules within the handler logic\n   * - Log important processing steps for debugging and monitoring\n   *\n   * **Error Handling Strategy**:\n   * - Log errors but don't re-throw to avoid affecting other subscribers\n   * - Use try-catch blocks for external service calls\n   * - Implement circuit breakers for resilience with external systems\n   * - Monitor error rates and patterns for system health\n   * - Consider implementing retry logic for temporary failures\n   *\n   * **Performance Considerations**:\n   * - Keep handler execution time minimal for high-throughput topics\n   * - Use background queues for heavy processing triggered by events\n   * - Implement batching for efficiency when processing many similar events\n   * - Consider async processing patterns for non-critical operations\n   *\n   * @param message - The topic message with validated payload and optional headers\n   * @param message.payload - The typed message data based on the topic's schema\n   * @returns Promise that resolves when processing is complete\n   *\n   * @example\n   * ```ts\n   * handler: async (message) => {\n   *   const { userId, eventType, timestamp } = message.payload;\n   *\n   *   try {\n   *     // Log event receipt\n   *     this.logger.info(`Processing ${eventType} event for user ${userId}`, {\n   *       timestamp,\n   *       userId,\n   *       eventType\n   *     });\n   *\n   *     // Perform event-specific processing\n   *     switch (eventType) {\n   *       case 'user.login':\n   *         await this.updateLastLogin(userId, timestamp);\n   *         await this.sendWelcomeNotification(userId);\n   *         break;\n   *       case 'user.logout':\n   *         await this.updateSessionDuration(userId, timestamp);\n   *         break;\n   *       case 'user.purchase':\n   *         await this.updateRewardsPoints(userId, message.payload.purchaseAmount);\n   *         await this.triggerRecommendations(userId);\n   *         break;\n   *       default:\n   *         this.logger.warn(`Unknown event type: ${eventType}`);\n   *     }\n   *\n   *     // Update analytics\n   *     await this.analytics.track(eventType, {\n   *       userId,\n   *       timestamp,\n   *       source: 'topic-subscriber'\n   *     });\n   *\n   *     this.logger.info(`Successfully processed ${eventType} for user ${userId}`);\n   *\n   *   } catch (error) {\n   *     // Log error but don't re-throw to avoid affecting other subscribers\n   *     this.logger.error(`Failed to process ${eventType} for user ${userId}`, {\n   *       error: error.message,\n   *       stack: error.stack,\n   *       userId,\n   *       eventType,\n   *       timestamp\n   *     });\n   *\n   *     // Optionally send to error tracking service\n   *     await this.errorTracker.captureException(error, {\n   *       context: { userId, eventType, timestamp },\n   *       tags: { component: 'topic-subscriber' }\n   *     });\n   *   }\n   * }\n   * ```\n   */\n  handler: TopicHandler<T>;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class SubscriberPrimitive<\n  T extends TopicMessageSchema,\n> extends PipelinePrimitive<SubscriberPrimitiveOptions<T>> {}\n\n$subscriber[KIND] = SubscriberPrimitive;\n","import { AlephaError } from \"alepha\";\n\nexport class TopicTimeoutError extends AlephaError {\n  public readonly topic: string;\n  public readonly timeout: number;\n\n  constructor(topic: string, timeout: number) {\n    super(`Timeout of ${timeout}ms exceeded for topic ${topic}`);\n    this.timeout = timeout;\n    this.topic = topic;\n  }\n}\n","import { $inject, Alepha } from \"alepha\";\nimport { DateTimeProvider, type Timeout } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { TemplatedPathParser } from \"alepha/router\";\nimport { TopicTimeoutError } from \"../errors/TopicTimeoutError.ts\";\nimport { $subscriber } from \"../primitives/$subscriber.ts\";\nimport {\n  $topic,\n  type TopicHandler,\n  type TopicMessage,\n  type TopicMessageSchema,\n  type TopicWaitOptions,\n} from \"../primitives/$topic.ts\";\n\n/**\n * Base class for topic providers.\n */\nexport abstract class TopicProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly log = $logger();\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n\n  /**\n   * Publish a raw message to a topic.\n   *\n   * @param topic - The topic to publish to.\n   * @param message - The message to publish.\n   */\n  public abstract publish(\n    topic: string,\n    message: string,\n    options?: TopicPublishOptions,\n  ): Promise<void>;\n\n  /**\n   * Subscribe to a topic with a raw callback.\n   *\n   * @param topic - The topic to subscribe to.\n   * @param callback - The callback to call when a message is received.\n   */\n  public abstract subscribe(\n    topic: string,\n    callback: SubscribeCallback,\n    options?: TopicSubscribeOptions,\n  ): Promise<UnSubscribeFn>;\n\n  /**\n   * Unsubscribe from a topic.\n   *\n   * @param topic - The topic to unsubscribe from.\n   */\n  public abstract unsubscribe(topic: string): Promise<void>;\n\n  /**\n   * Encode and publish a typed message to a topic.\n   */\n  public async publishMessage<T extends TopicMessageSchema>(\n    name: string,\n    schema: T[\"payload\"],\n    payload: TopicMessage<T>[\"payload\"],\n    options?: TopicPublishOptions,\n  ): Promise<void> {\n    let topicName = name;\n    if (options?.params) {\n      const parser = new TemplatedPathParser(name);\n      topicName = parser.interpolate(options.params);\n    }\n\n    await this.publish(\n      topicName,\n      JSON.stringify({\n        payload: this.alepha.codec.encode(schema, payload),\n      }),\n      options,\n    );\n  }\n\n  /**\n   * Parse a raw message string into a typed topic message.\n   */\n  public parseMessage<T extends TopicMessageSchema>(\n    schema: T[\"payload\"],\n    message: string,\n  ): TopicMessage<T> {\n    const { payload } = JSON.parse(message);\n    return {\n      payload: this.alepha.codec.decode(\n        schema,\n        payload,\n      ) as TopicMessage<T>[\"payload\"],\n    } as TopicMessage<T>;\n  }\n\n  /**\n   * Subscribe a typed handler to a topic, with error wrapping and message parsing.\n   */\n  public async subscribeHandler<T extends TopicMessageSchema>(\n    name: string,\n    schema: T[\"payload\"],\n    handler: TopicHandler<T>,\n    options?: TopicSubscribeOptions,\n  ): Promise<UnSubscribeFn> {\n    const parser = new TemplatedPathParser(name);\n    const subscribeTopic = parser.hasParams\n      ? parser.wildcardize(this.wildcardChar())\n      : name;\n\n    return this.subscribe(\n      subscribeTopic,\n      async (message, receivedTopic?: string) => {\n        try {\n          const parsed = this.parseMessage<T>(schema, message);\n\n          if (parser.hasParams && receivedTopic) {\n            const params = parser.extract(receivedTopic) ?? {};\n            await handler({ ...parsed, params } as TopicMessage<T>);\n          } else {\n            await handler(parsed);\n          }\n        } catch (error) {\n          this.log.error(\"Message processing has failed\", error);\n        }\n      },\n      options,\n    );\n  }\n\n  /**\n   * Wait for a single message matching an optional filter, with timeout.\n   */\n  public async waitForMessage<T extends TopicMessageSchema>(\n    name: string,\n    schema: T[\"payload\"],\n    options: TopicWaitOptions<T> = {},\n  ): Promise<TopicMessage<T>> {\n    const filter = options.filter ?? (() => true);\n\n    return new Promise((resolve, reject) => {\n      const ref: { timeout?: Timeout; clear?: () => void } = {};\n\n      (async () => {\n        const clear = await this.subscribe(name, (raw) => {\n          const message = this.parseMessage<T>(schema, raw);\n          if (!filter(message)) {\n            return;\n          }\n\n          ref.timeout?.clear();\n          if (ref.clear) {\n            ref.clear();\n          }\n          resolve(message);\n        });\n\n        ref.clear = clear;\n\n        const timeoutDuration = options.timeout ?? [10, \"seconds\"];\n\n        ref.timeout = this.dateTimeProvider.createTimeout(() => {\n          clear();\n          reject(\n            new TopicTimeoutError(\n              name,\n              this.dateTimeProvider.duration(timeoutDuration).asMilliseconds(),\n            ),\n          );\n        }, timeoutDuration);\n      })();\n    });\n  }\n\n  /**\n   * The wildcard character used for pattern subscriptions.\n   * Override in subclasses for provider-specific wildcards.\n   */\n  protected wildcardChar(): string {\n    return \"+\";\n  }\n\n  /**\n   * Returns the list of $subscribers for this provider.\n   */\n  protected subscribers(): Array<() => Promise<unknown>> {\n    const handlers: Array<() => Promise<unknown>> = [];\n\n    const topics = this.alepha.primitives($topic);\n\n    for (const topic of topics) {\n      if (topic.provider !== this) {\n        continue;\n      }\n\n      const handler = topic.options.handler;\n      if (handler && topic.provider === this) {\n        handlers.push(() => topic.subscribe(handler));\n      }\n    }\n\n    const subscribers = this.alepha.primitives($subscriber);\n    for (const subscriber of subscribers) {\n      if (subscriber.options.topic.provider !== this) {\n        continue;\n      }\n\n      const handler = subscriber.handler.run.bind(subscriber.handler);\n      handlers.push(() => subscriber.options.topic.subscribe(handler));\n    }\n\n    return handlers;\n  }\n}\n\nexport type SubscribeCallback = (\n  message: string,\n  topic?: string,\n) => Promise<void> | void;\n\nexport type UnSubscribeFn = () => Promise<void>;\n\nexport interface TopicPublishOptions {\n  retain?: boolean;\n  params?: Record<string, string>;\n}\n\n// biome-ignore lint/suspicious/noEmptyInterface: augmented by provider-specific modules (e.g. MqttTopicProvider)\nexport interface TopicSubscribeOptions {}\n","import { $hook } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport {\n  type SubscribeCallback,\n  TopicProvider,\n  type TopicPublishOptions,\n  type TopicSubscribeOptions,\n  type UnSubscribeFn,\n} from \"./TopicProvider.ts\";\n\nexport class MemoryTopicProvider extends TopicProvider {\n  protected readonly log = $logger();\n  protected readonly subscriptions: Record<string, SubscribeCallback[]> = {};\n  protected readonly retained: Record<string, string> = {};\n\n  protected readonly start = $hook({\n    on: \"start\",\n    handler: async () => {\n      const subscribers = this.subscribers();\n      if (subscribers.length) {\n        await Promise.all(subscribers.map((fn) => fn()));\n        for (const subscriber of subscribers) {\n          this.log.debug(`Subscribed to topic '${subscriber.name}'`);\n        }\n      }\n    },\n  });\n\n  /**\n   * Publish a message to a topic.\n   *\n   * @param topic\n   * @param message\n   * @param options\n   */\n  public async publish(\n    topic: string,\n    message: string,\n    options?: TopicPublishOptions,\n  ): Promise<void> {\n    if (options?.retain) {\n      this.retained[topic] = message;\n    }\n\n    for (const [pattern, callbacks] of Object.entries(this.subscriptions)) {\n      if (this.topicMatches(pattern, topic)) {\n        for (const callback of callbacks) {\n          await callback(message, topic);\n        }\n      }\n    }\n  }\n\n  /**\n   * Subscribe to a topic.\n   *\n   * @param topic - The topic to subscribe to.\n   * @param callback\n   */\n\n  public async subscribe(\n    topic: string,\n    callback: SubscribeCallback,\n    _options?: TopicSubscribeOptions,\n  ): Promise<UnSubscribeFn> {\n    if (!this.subscriptions[topic]) {\n      this.subscriptions[topic] = [];\n    }\n\n    this.subscriptions[topic].push(callback);\n\n    // Deliver retained messages matching the pattern\n    for (const [retainedTopic, retainedMessage] of Object.entries(\n      this.retained,\n    )) {\n      if (this.topicMatches(topic, retainedTopic)) {\n        await callback(retainedMessage, retainedTopic);\n      }\n    }\n\n    return async () => {\n      const callbacks = this.subscriptions[topic];\n      if (!callbacks) {\n        return;\n      }\n\n      this.subscriptions[topic] = callbacks.filter((cb) => cb !== callback);\n      if (this.subscriptions[topic].length === 0) {\n        delete this.subscriptions[topic];\n      }\n    };\n  }\n\n  /**\n   * Unsubscribe from a topic.\n   *\n   * @param topic - The topic to unsubscribe from.\n   */\n  public async unsubscribe(topic: string): Promise<void> {\n    delete this.subscriptions[topic];\n  }\n\n  /**\n   * Check if a topic matches a subscription pattern.\n   * Supports `+` single-level wildcard.\n   */\n  protected topicMatches(pattern: string, topic: string): boolean {\n    if (pattern === topic) {\n      return true;\n    }\n\n    const patternParts = pattern.split(\"/\");\n    const topicParts = topic.split(\"/\");\n\n    if (patternParts.length !== topicParts.length) {\n      return false;\n    }\n\n    return patternParts.every(\n      (part, i) => part === \"+\" || part === topicParts[i],\n    );\n  }\n}\n","import {\n  createPrimitive,\n  KIND,\n  Primitive,\n  type Service,\n  type Static,\n  type TSchema,\n} from \"alepha\";\nimport type { DurationLike } from \"alepha/datetime\";\nimport { MemoryTopicProvider } from \"../providers/MemoryTopicProvider.ts\";\nimport {\n  TopicProvider,\n  type TopicPublishOptions,\n  type UnSubscribeFn,\n} from \"../providers/TopicProvider.ts\";\n\n/**\n * Creates a topic primitive for publish/subscribe messaging and event-driven architecture.\n *\n * Enables decoupled communication through a pub/sub pattern where publishers send messages\n * and multiple subscribers receive them. Supports type-safe messages, real-time delivery,\n * event filtering, and pluggable backends (memory, Redis, custom providers).\n *\n * **Use Cases**: User notifications, real-time chat, event broadcasting, microservice communication\n *\n * @example\n * ```ts\n * class NotificationService {\n *   userActivity = $topic({\n *     name: \"user-activity\",\n *     schema: {\n *       payload: t.object({\n *         userId: t.text(),\n *         action: t.enum([\"login\", \"logout\", \"purchase\"]),\n *         timestamp: t.number()\n *       })\n *     },\n *     handler: async (message) => {\n *       console.log(`User ${message.payload.userId}: ${message.payload.action}`);\n *     }\n *   });\n *\n *   async trackLogin(userId: string) {\n *     await this.userActivity.publish({ userId, action: \"login\", timestamp: Date.now() });\n *   }\n *\n *   async subscribeToEvents() {\n *     await this.userActivity.subscribe(async (message) => {\n *       // Additional subscriber logic\n *     });\n *   }\n * }\n * ```\n */\nexport const $topic = <T extends TopicMessageSchema>(\n  options: TopicPrimitiveOptions<T>,\n): TopicPrimitive<T> => {\n  return createPrimitive(TopicPrimitive<T>, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface TopicPrimitiveOptions<T extends TopicMessageSchema> {\n  /**\n   * Unique name identifier for the topic.\n   *\n   * This name is used for:\n   * - Topic identification across the pub/sub system\n   * - Message routing between publishers and subscribers\n   * - Logging and debugging topic-related operations\n   * - Provider-specific topic management (channels, keys, etc.)\n   *\n   * If not provided, defaults to the property key where the topic is declared.\n   *\n   * **Naming Conventions**:\n   * - Use descriptive, hierarchical names: \"user.activity\", \"order.events\"\n   * - Avoid spaces and special characters\n   * - Consider using dot notation for categorization\n   * - Keep names concise but meaningful\n   *\n   * @example \"user-activity\"\n   * @example \"chat.messages\"\n   * @example \"system.health.checks\"\n   * @example \"payment.webhooks\"\n   */\n  name?: string;\n\n  /**\n   * Human-readable description of the topic's purpose and usage.\n   *\n   * Used for:\n   * - Documentation generation and API references\n   * - Developer onboarding and understanding\n   * - Monitoring dashboards and admin interfaces\n   * - Team communication about system architecture\n   *\n   * **Description Best Practices**:\n   * - Explain what events/messages this topic handles\n   * - Mention key use cases and subscribers\n   * - Include any important timing or ordering guarantees\n   * - Note any special processing requirements\n   *\n   * @example \"Real-time user activity events for analytics and notifications\"\n   * @example \"Order lifecycle events from creation to delivery\"\n   * @example \"Chat messages broadcast to all room participants\"\n   * @example \"System health checks and service status updates\"\n   */\n  description?: string;\n\n  /**\n   * Topic provider configuration for message storage and delivery.\n   *\n   * Options:\n   * - **\"memory\"**: In-memory provider (default for development, lost on restart)\n   * - **Service<TopicProvider>**: Custom provider class (e.g., RedisTopicProvider)\n   * - **undefined**: Uses the default topic provider from dependency injection\n   *\n   * **Provider Selection Guidelines**:\n   * - **Development**: Use \"memory\" for fast, simple testing without external dependencies\n   * - **Production**: Use Redis or message brokers for persistence and scalability\n   * - **Distributed systems**: Use Redis/RabbitMQ for cross-service communication\n   * - **High-throughput**: Use specialized providers with connection pooling\n   * - **Real-time**: Ensure provider supports low-latency message delivery\n   *\n   * **Provider Capabilities**:\n   * - Message persistence and durability\n   * - Subscriber management and connection handling\n   * - Message ordering and delivery guarantees\n   * - Horizontal scaling and load distribution\n   *\n   * @default Uses injected TopicProvider\n   * @example \"memory\"\n   * @example RedisTopicProvider\n   * @example RabbitMQTopicProvider\n   */\n  provider?: \"memory\" | Service<TopicProvider>;\n\n  /**\n   * TypeBox schema defining the structure of messages published to this topic.\n   *\n   * The schema must include:\n   * - **payload**: Required schema for the main message data\n   * - **headers**: Optional schema for message metadata\n   *\n   * This schema:\n   * - Validates all messages published to the topic\n   * - Provides full TypeScript type inference for subscribers\n   * - Ensures type safety between publishers and subscribers\n   * - Enables automatic serialization/deserialization\n   *\n   * **Schema Design Best Practices**:\n   * - Keep payload schemas focused and cohesive\n   * - Use optional fields for data that might not always be present\n   * - Include timestamp fields for event ordering\n   * - Consider versioning for schema evolution\n   * - Use union types for different event types in the same topic\n   *\n   * @example\n   * ```ts\n   * {\n   *   payload: t.object({\n   *     eventId: t.text(),\n   *     eventType: t.enum([\"created\", \"updated\"]),\n   *     data: t.record(t.text(), t.any()),\n   *     timestamp: t.number(),\n   *     userId: t.optional(t.text())\n   *   }),\n   *   headers: t.optional(t.object({\n   *     source: t.text(),\n   *     correlationId: t.text()\n   *   }))\n   * }\n   * ```\n   */\n  schema: T;\n\n  /**\n   * Default subscriber handler function that processes messages published to this topic.\n   *\n   * This handler:\n   * - Automatically subscribes when the topic is initialized\n   * - Receives all messages published to the topic\n   * - Runs for every message without additional subscription setup\n   * - Can be supplemented with additional subscribers via `subscribe()` method\n   * - Should handle errors gracefully to avoid breaking other subscribers\n   *\n   * **Handler Design Guidelines**:\n   * - Keep handlers focused on a single responsibility\n   * - Use proper error handling and logging\n   * - Consider performance impact for high-frequency topics\n   * - Make handlers idempotent when possible\n   * - Validate business rules within the handler logic\n   * - Log important processing steps for debugging\n   *\n   * **Error Handling Strategy**:\n   * - Log errors but don't re-throw to avoid affecting other subscribers\n   * - Use try-catch blocks for external service calls\n   * - Consider implementing circuit breakers for resilience\n   * - Monitor error rates and patterns for system health\n   *\n   * @param message - The topic message with validated payload and headers\n   * @param message.payload - The typed message data based on the schema\n   * @returns Promise that resolves when processing is complete\n   *\n   * @example\n   * ```ts\n   * handler: async (message) => {\n   *   const { eventType, data, timestamp } = message.payload;\n   *\n   *   try {\n   *     // Log message receipt\n   *     this.logger.info(`Processing ${eventType} event`, { timestamp, data });\n   *\n   *     // Process based on event type\n   *     switch (eventType) {\n   *       case \"created\":\n   *         await this.handleCreation(data);\n   *         break;\n   *       case \"updated\":\n   *         await this.handleUpdate(data);\n   *         break;\n   *       default:\n   *         this.logger.warn(`Unknown event type: ${eventType}`);\n   *     }\n   *\n   *     this.logger.info(`Successfully processed ${eventType} event`);\n   *\n   *   } catch (error) {\n   *     // Log error but don't re-throw to avoid affecting other subscribers\n   *     this.logger.error(`Failed to process ${eventType} event`, {\n   *       error: error.message,\n   *       eventType,\n   *       timestamp,\n   *       data\n   *     });\n   *   }\n   * }\n   * ```\n   */\n  handler?: TopicHandler<T>;\n\n  /**\n   * Whether the last published message should be retained and delivered to new subscribers.\n   *\n   * When enabled, the provider stores the last message for this topic.\n   * New subscribers immediately receive the retained message upon subscribing.\n   *\n   * Supported by Memory, Redis, and MQTT providers.\n   *\n   * @default false\n   */\n  retain?: boolean;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class TopicPrimitive<T extends TopicMessageSchema> extends Primitive<\n  TopicPrimitiveOptions<T>\n> {\n  public readonly provider = this.$provider();\n\n  public get name(): string {\n    return this.options.name || this.config.propertyKey;\n  }\n\n  public async publish(\n    message: T extends { params: TSchema }\n      ? { params: Static<T[\"params\"]>; payload: TopicMessage<T>[\"payload\"] }\n      : TopicMessage<T>[\"payload\"],\n  ): Promise<void> {\n    const hasParams = this.options.schema.params;\n    const payload = hasParams ? (message as any).payload : message;\n    const params = hasParams ? (message as any).params : undefined;\n\n    await this.provider.publishMessage<T>(\n      this.name,\n      this.options.schema.payload,\n      payload,\n      {\n        retain: this.options.retain,\n        mqtt: (this.options as any).mqtt,\n        params,\n      } as TopicPublishOptions,\n    );\n  }\n\n  public async subscribe(handler: TopicHandler<T>): Promise<UnSubscribeFn> {\n    return this.provider.subscribeHandler<T>(\n      this.name,\n      this.options.schema.payload,\n      handler,\n      { mqtt: (this.options as any).mqtt },\n    );\n  }\n\n  public async wait(\n    options: TopicWaitOptions<T> = {},\n  ): Promise<TopicMessage<T>> {\n    return this.provider.waitForMessage<T>(\n      this.name,\n      this.options.schema.payload,\n      options,\n    );\n  }\n\n  protected $provider(): TopicProvider {\n    if (!this.options.provider) {\n      return this.alepha.inject(TopicProvider);\n    }\n\n    if (this.options.provider === \"memory\") {\n      return this.alepha.inject(MemoryTopicProvider);\n    }\n\n    return this.alepha.inject(this.options.provider);\n  }\n}\n\n$topic[KIND] = TopicPrimitive;\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface TopicMessage<T extends TopicMessageSchema> {\n  payload: Static<T[\"payload\"]>;\n  params: T extends { params: TSchema } ? Static<T[\"params\"]> : never;\n}\n\nexport interface TopicWaitOptions<T extends TopicMessageSchema> {\n  timeout?: DurationLike;\n  filter?: (message: { payload: Static<T[\"payload\"]> }) => boolean;\n}\n\nexport interface TopicMessageSchema {\n  payload: TSchema;\n  params?: TSchema;\n}\n\nexport type TopicHandler<T extends TopicMessageSchema = TopicMessageSchema> = (\n  message: TopicMessage<T>,\n) => unknown;\n","import { $module, type Alepha } from \"alepha\";\nimport { $subscriber } from \"./primitives/$subscriber.ts\";\nimport { $topic } from \"./primitives/$topic.ts\";\nimport { MemoryTopicProvider } from \"./providers/MemoryTopicProvider.ts\";\nimport { TopicProvider } from \"./providers/TopicProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./errors/TopicTimeoutError.ts\";\nexport * from \"./primitives/$subscriber.ts\";\nexport * from \"./primitives/$topic.ts\";\nexport * from \"./providers/MemoryTopicProvider.ts\";\nexport * from \"./providers/TopicProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Publish/subscribe messaging for event-driven architectures.\n *\n * **Features:**\n * - Pub/sub topics with type-safe messages\n * - Topic subscription handlers\n * - Multiple subscriber support\n * - Message filtering and routing\n * - Providers: Memory (dev), Redis (production)\n *\n * @module alepha.topic\n */\nexport const AlephaTopic = $module({\n  name: \"alepha.topic\",\n  primitives: [$topic, $subscriber],\n  services: [TopicProvider],\n  variants: [MemoryTopicProvider],\n  register: (alepha: Alepha) =>\n    alepha.with({\n      optional: true,\n      provide: TopicProvider,\n      use: MemoryTopicProvider,\n    }),\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmEA,MAAa,eACX,YAC2B;CAC3B,OAAO,gBAAgB,qBAAwB,OAAO;AACxD;AA4IA,IAAa,sBAAb,cAEU,kBAAiD,CAAC;AAE5D,YAAY,QAAQ;;;ACrNpB,IAAa,oBAAb,cAAuC,YAAY;CACjD;CACA;CAEA,YAAY,OAAe,SAAiB;EAC1C,MAAM,cAAc,QAAQ,wBAAwB,OAAO;EAC3D,KAAK,UAAU;EACf,KAAK,QAAQ;CACf;AACF;;;;;;ACMA,IAAsB,gBAAtB,MAAoC;CAClC,SAA4B,QAAQ,MAAM;CAC1C,MAAyB,QAAQ;CACjC,mBAAsC,QAAQ,gBAAgB;;;;CAoC9D,MAAa,eACX,MACA,QACA,SACA,SACe;EACf,IAAI,YAAY;EAChB,IAAI,SAAS,QAEX,YAAY,IADO,oBAAoB,IACtB,EAAE,YAAY,QAAQ,MAAM;EAG/C,MAAM,KAAK,QACT,WACA,KAAK,UAAU,EACb,SAAS,KAAK,OAAO,MAAM,OAAO,QAAQ,OAAO,EACnD,CAAC,GACD,OACF;CACF;;;;CAKA,aACE,QACA,SACiB;EACjB,MAAM,EAAE,YAAY,KAAK,MAAM,OAAO;EACtC,OAAO,EACL,SAAS,KAAK,OAAO,MAAM,OACzB,QACA,OACF,EACF;CACF;;;;CAKA,MAAa,iBACX,MACA,QACA,SACA,SACwB;EACxB,MAAM,SAAS,IAAI,oBAAoB,IAAI;EAC3C,MAAM,iBAAiB,OAAO,YAC1B,OAAO,YAAY,KAAK,aAAa,CAAC,IACtC;EAEJ,OAAO,KAAK,UACV,gBACA,OAAO,SAAS,kBAA2B;GACzC,IAAI;IACF,MAAM,SAAS,KAAK,aAAgB,QAAQ,OAAO;IAEnD,IAAI,OAAO,aAAa,eAAe;KACrC,MAAM,SAAS,OAAO,QAAQ,aAAa,KAAK,CAAC;KACjD,MAAM,QAAQ;MAAE,GAAG;MAAQ;KAAO,CAAoB;IACxD,OACE,MAAM,QAAQ,MAAM;GAExB,SAAS,OAAO;IACd,KAAK,IAAI,MAAM,iCAAiC,KAAK;GACvD;EACF,GACA,OACF;CACF;;;;CAKA,MAAa,eACX,MACA,QACA,UAA+B,CAAC,GACN;EAC1B,MAAM,SAAS,QAAQ,iBAAiB;EAExC,OAAO,IAAI,SAAS,SAAS,WAAW;GACtC,MAAM,MAAiD,CAAC;GAExD,CAAC,YAAY;IACX,MAAM,QAAQ,MAAM,KAAK,UAAU,OAAO,QAAQ;KAChD,MAAM,UAAU,KAAK,aAAgB,QAAQ,GAAG;KAChD,IAAI,CAAC,OAAO,OAAO,GACjB;KAGF,IAAI,SAAS,MAAM;KACnB,IAAI,IAAI,OACN,IAAI,MAAM;KAEZ,QAAQ,OAAO;IACjB,CAAC;IAED,IAAI,QAAQ;IAEZ,MAAM,kBAAkB,QAAQ,WAAW,CAAC,IAAI,SAAS;IAEzD,IAAI,UAAU,KAAK,iBAAiB,oBAAoB;KACtD,MAAM;KACN,OACE,IAAI,kBACF,MACA,KAAK,iBAAiB,SAAS,eAAe,EAAE,eAAe,CACjE,CACF;IACF,GAAG,eAAe;GACpB,GAAG;EACL,CAAC;CACH;;;;;CAMA,eAAiC;EAC/B,OAAO;CACT;;;;CAKA,cAAuD;EACrD,MAAM,WAA0C,CAAC;EAEjD,MAAM,SAAS,KAAK,OAAO,WAAW,MAAM;EAE5C,KAAK,MAAM,SAAS,QAAQ;GAC1B,IAAI,MAAM,aAAa,MACrB;GAGF,MAAM,UAAU,MAAM,QAAQ;GAC9B,IAAI,WAAW,MAAM,aAAa,MAChC,SAAS,WAAW,MAAM,UAAU,OAAO,CAAC;EAEhD;EAEA,MAAM,cAAc,KAAK,OAAO,WAAW,WAAW;EACtD,KAAK,MAAM,cAAc,aAAa;GACpC,IAAI,WAAW,QAAQ,MAAM,aAAa,MACxC;GAGF,MAAM,UAAU,WAAW,QAAQ,IAAI,KAAK,WAAW,OAAO;GAC9D,SAAS,WAAW,WAAW,QAAQ,MAAM,UAAU,OAAO,CAAC;EACjE;EAEA,OAAO;CACT;AACF;;;ACxMA,IAAa,sBAAb,cAAyC,cAAc;CACrD,MAAyB,QAAQ;CACjC,gBAAwE,CAAC;CACzE,WAAsD,CAAC;CAEvD,QAA2B,MAAM;EAC/B,IAAI;EACJ,SAAS,YAAY;GACnB,MAAM,cAAc,KAAK,YAAY;GACrC,IAAI,YAAY,QAAQ;IACtB,MAAM,QAAQ,IAAI,YAAY,KAAK,OAAO,GAAG,CAAC,CAAC;IAC/C,KAAK,MAAM,cAAc,aACvB,KAAK,IAAI,MAAM,wBAAwB,WAAW,KAAK,EAAE;GAE7D;EACF;CACF,CAAC;;;;;;;;CASD,MAAa,QACX,OACA,SACA,SACe;EACf,IAAI,SAAS,QACX,KAAK,SAAS,SAAS;EAGzB,KAAK,MAAM,CAAC,SAAS,cAAc,OAAO,QAAQ,KAAK,aAAa,GAClE,IAAI,KAAK,aAAa,SAAS,KAAK,GAClC,KAAK,MAAM,YAAY,WACrB,MAAM,SAAS,SAAS,KAAK;CAIrC;;;;;;;CASA,MAAa,UACX,OACA,UACA,UACwB;EACxB,IAAI,CAAC,KAAK,cAAc,QACtB,KAAK,cAAc,SAAS,CAAC;EAG/B,KAAK,cAAc,OAAO,KAAK,QAAQ;EAGvC,KAAK,MAAM,CAAC,eAAe,oBAAoB,OAAO,QACpD,KAAK,QACP,GACE,IAAI,KAAK,aAAa,OAAO,aAAa,GACxC,MAAM,SAAS,iBAAiB,aAAa;EAIjD,OAAO,YAAY;GACjB,MAAM,YAAY,KAAK,cAAc;GACrC,IAAI,CAAC,WACH;GAGF,KAAK,cAAc,SAAS,UAAU,QAAQ,OAAO,OAAO,QAAQ;GACpE,IAAI,KAAK,cAAc,OAAO,WAAW,GACvC,OAAO,KAAK,cAAc;EAE9B;CACF;;;;;;CAOA,MAAa,YAAY,OAA8B;EACrD,OAAO,KAAK,cAAc;CAC5B;;;;;CAMA,aAAuB,SAAiB,OAAwB;EAC9D,IAAI,YAAY,OACd,OAAO;EAGT,MAAM,eAAe,QAAQ,MAAM,GAAG;EACtC,MAAM,aAAa,MAAM,MAAM,GAAG;EAElC,IAAI,aAAa,WAAW,WAAW,QACrC,OAAO;EAGT,OAAO,aAAa,OACjB,MAAM,MAAM,SAAS,OAAO,SAAS,WAAW,EACnD;CACF;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACpEA,MAAa,UACX,YACsB;CACtB,OAAO,gBAAgB,gBAAmB,OAAO;AACnD;AAsMA,IAAa,iBAAb,cAAkE,UAEhE;CACA,WAA2B,KAAK,UAAU;CAE1C,IAAW,OAAe;EACxB,OAAO,KAAK,QAAQ,QAAQ,KAAK,OAAO;CAC1C;CAEA,MAAa,QACX,SAGe;EACf,MAAM,YAAY,KAAK,QAAQ,OAAO;EACtC,MAAM,UAAU,YAAa,QAAgB,UAAU;EACvD,MAAM,SAAS,YAAa,QAAgB,SAAS,KAAA;EAErD,MAAM,KAAK,SAAS,eAClB,KAAK,MACL,KAAK,QAAQ,OAAO,SACpB,SACA;GACE,QAAQ,KAAK,QAAQ;GACrB,MAAO,KAAK,QAAgB;GAC5B;EACF,CACF;CACF;CAEA,MAAa,UAAU,SAAkD;EACvE,OAAO,KAAK,SAAS,iBACnB,KAAK,MACL,KAAK,QAAQ,OAAO,SACpB,SACA,EAAE,MAAO,KAAK,QAAgB,KAAK,CACrC;CACF;CAEA,MAAa,KACX,UAA+B,CAAC,GACN;EAC1B,OAAO,KAAK,SAAS,eACnB,KAAK,MACL,KAAK,QAAQ,OAAO,SACpB,OACF;CACF;CAEA,YAAqC;EACnC,IAAI,CAAC,KAAK,QAAQ,UAChB,OAAO,KAAK,OAAO,OAAO,aAAa;EAGzC,IAAI,KAAK,QAAQ,aAAa,UAC5B,OAAO,KAAK,OAAO,OAAO,mBAAmB;EAG/C,OAAO,KAAK,OAAO,OAAO,KAAK,QAAQ,QAAQ;CACjD;AACF;AAEA,OAAO,QAAQ;;;;;;;;;;;;;;;AClSf,MAAa,cAAc,QAAQ;CACjC,MAAM;CACN,YAAY,CAAC,QAAQ,WAAW;CAChC,UAAU,CAAC,aAAa;CACxB,UAAU,CAAC,mBAAmB;CAC9B,WAAW,WACT,OAAO,KAAK;EACV,UAAU;EACV,SAAS;EACT,KAAK;CACP,CAAC;AACL,CAAC"}

package/dist/topic/redis/index.d.ts

@@ -1,16 +1,13 @@
-import * as _$alepha from "alepha";
 import { Alepha, Static } from "alepha";
 import { SubscribeCallback, TopicProvider, TopicPublishOptions, TopicSubscribeOptions, UnSubscribeFn } from "alepha/topic";
-import * as _$alepha_logger0 from "alepha/logger";
 import { RedisProvider, RedisSubscriberProvider } from "alepha/redis";
-import * as _$typebox from "typebox";
 
 //#region ../../src/topic/redis/providers/RedisTopicProvider.d.ts
 /**
  * Redis topic configuration atom.
  */
-declare const redisTopicOptions: _$alepha.Atom<_$typebox.TObject<{
-  prefix: _$typebox.TString;
+declare const redisTopicOptions: import("alepha").Atom<import("typebox").TObject<{
+  prefix: import("typebox").TString;
 }>, "alepha.topic.redis.options">;
 type RedisTopicOptions = Static<typeof redisTopicOptions.schema>;
 declare module "alepha" {
@@ -25,8 +22,8 @@ declare class RedisTopicProvider extends TopicProvider {
   protected readonly alepha: Alepha;
   protected readonly redisProvider: RedisProvider;
   protected readonly redisSubscriberProvider: RedisSubscriberProvider;
-  protected readonly log: _$alepha_logger0.Logger;
-  protected readonly start: _$alepha.HookPrimitive<"start">;
+  protected readonly log: import("alepha/logger").Logger;
+  protected readonly start: import("alepha").HookPrimitive<"start">;
   protected wildcardChar(): string;
   prefix(queue: string): string;
   /**
@@ -50,7 +47,7 @@ declare class RedisTopicProvider extends TopicProvider {
  * @see {@link RedisTopicProvider}
  * @module alepha.topic.redis
  */
-declare const AlephaTopicRedis: _$alepha.Service<_$alepha.Module>;
+declare const AlephaTopicRedis: import("alepha").Service<import("alepha").Module>;
 //#endregion
 export { AlephaTopicRedis, RedisTopicOptions, RedisTopicProvider, redisTopicOptions };
 //# sourceMappingURL=index.d.ts.map

package/dist/topic/redis/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/topic/redis/providers/RedisTopicProvider.ts","../../../src/topic/redis/index.ts"],"mappings":";;;;;;;;;;;cAgBa,iBAAA,EAAiB,QAAA,CAAA,IAAA,WAAA,OAAA;UAW5B,SAAA,CAAA,OAAA;AAAA;AAAA,KAEU,iBAAA,GAAoB,MAAA,QAAc,iBAAA,CAAkB,MAAA;AAAA;EAAA,UAGpD,KAAA;IAAA,CACP,iBAAA,CAAkB,GAAA,GAAM,iBAAA;EAAA;AAAA;AAAA,cAMhB,kBAAA,SAA2B,aAAA;EAAA,mBACnB,OAAA,EAAO,QAAA;;;qBACP,MAAA,EAAM,MAAA;EAAA,mBACN,aAAA,EAAa,aAAA;EAAA,mBACb,uBAAA,EAAuB,uBAAA;EAAA,mBAEvB,GAAA,EAFuB,gBAAA,CAEpB,MAAA;EAAA,mBAEH,KAAA,EAFG,QAAA,CAEE,aAAA;EAAA,UAaL,YAAA,CAAA;EAIZ,MAAA,CAAO,KAAA;EAnCgB;;;EA0CjB,OAAA,CACX,KAAA,UACA,OAAA,UACA,OAAA,GAAU,mBAAA,GACT,OAAA;EA9CiE;AAAE;;EAwDzD,SAAA,CACX,IAAA,UACA,QAAA,EAAU,iBAAA,EACV,QAAA,GAAW,qBAAA,GACV,OAAA,CAAQ,aAAA;EAxDa;;;EA0EX,WAAA,CACX,IAAA,UACA,QAAA,GAAW,iBAAA,GACV,OAAA;AAAA;;;;;;;;;cC9FQ,gBAAA,EAAgB,QAAA,CAAA,OAAA,CAW3B,QAAA,CAX2B,MAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/topic/redis/providers/RedisTopicProvider.ts","../../../src/topic/redis/index.ts"],"mappings":";;;;;;;AAgBA;cAAa,iBAAA,mBAAiB,IAAA,mBAAA,OAAA;;;KAalB,iBAAA,GAAoB,MAAM,QAAQ,iBAAA,CAAkB,MAAA;AAAA;EAAA,UAGpD,KAAA;IAAA,CACP,iBAAA,CAAkB,GAAG,GAAG,iBAAA;EAAA;AAAA;AAAA,cAMhB,kBAAA,SAA2B,aAAA;EAAA,mBACnB,OAAA,EAAO,QAAA;;;qBACP,MAAA,EAAM,MAAA;EAAA,mBACN,aAAA,EAAa,aAAA;EAAA,mBACb,uBAAA,EAAuB,uBAAA;EAAA,mBAEvB,GAAA,0BAAG,MAAA;EAAA,mBAEH,KAAA,mBAAK,aAAA;EAAA,UAaL,YAAA;EAIZ,MAAA,CAAO,KAAA;;;;EAOD,OAAA,CACX,KAAA,UACA,OAAA,UACA,OAAA,GAAU,mBAAA,GACT,OAAA;EA1CkB;;;EAoDR,SAAA,CACX,IAAA,UACA,QAAA,EAAU,iBAAA,EACV,QAAA,GAAW,qBAAA,GACV,OAAA,CAAQ,aAAA;EAxDiC;AAAA;AAM9C;EAoEe,WAAA,CACX,IAAA,UACA,QAAA,GAAW,iBAAA,GACV,OAAA;AAAA;;;;;;;AA9FL;;cCAa,gBAAA,mBAAgB,OAAA,kBAAA,MAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/topic/redis/providers/RedisTopicProvider.ts","../../../src/topic/redis/index.ts"],"sourcesContent":["import { $atom, $hook, $inject, $state, Alepha, type Static, t } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { RedisProvider, RedisSubscriberProvider } from \"alepha/redis\";\nimport {\n  type SubscribeCallback,\n  TopicProvider,\n  type TopicPublishOptions,\n  type TopicSubscribeOptions,\n  type UnSubscribeFn,\n} from \"alepha/topic\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Redis topic configuration atom.\n */\nexport const redisTopicOptions = $atom({\n  name: \"alepha.topic.redis.options\",\n  schema: t.object({\n    prefix: t.text({\n      default: \"topic\",\n      description: \"Prefix for all topic channels in Redis.\",\n    }),\n  }),\n  default: {\n    prefix: \"topic\",\n  },\n});\n\nexport type RedisTopicOptions = Static<typeof redisTopicOptions.schema>;\n\ndeclare module \"alepha\" {\n  interface State {\n    [redisTopicOptions.key]: RedisTopicOptions;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class RedisTopicProvider extends TopicProvider {\n  protected readonly options = $state(redisTopicOptions);\n  protected readonly alepha = $inject(Alepha);\n  protected readonly redisProvider = $inject(RedisProvider);\n  protected readonly redisSubscriberProvider = $inject(RedisSubscriberProvider);\n\n  protected readonly log = $logger();\n\n  protected readonly start = $hook({\n    on: \"start\",\n    handler: async () => {\n      const subscribers = this.subscribers();\n      if (subscribers.length) {\n        await Promise.all(subscribers.map((fn) => fn()));\n        for (const subscriber of subscribers) {\n          this.log.debug(`Subscribed to topic '${subscriber.name}'`);\n        }\n      }\n    },\n  });\n\n  protected override wildcardChar(): string {\n    return \"*\";\n  }\n\n  public prefix(queue: string): string {\n    return `${this.options.prefix}:${queue}`;\n  }\n\n  /**\n   * Publish a message to a topic.\n   */\n  public async publish(\n    topic: string,\n    message: string,\n    options?: TopicPublishOptions,\n  ): Promise<void> {\n    if (options?.retain) {\n      await this.redisProvider.set(`${this.prefix(topic)}:retained`, message);\n    }\n    await this.redisProvider.publish(this.prefix(topic), message);\n  }\n\n  /**\n   * Subscribe to a topic.\n   */\n  public async subscribe(\n    name: string,\n    callback: SubscribeCallback,\n    _options?: TopicSubscribeOptions,\n  ): Promise<UnSubscribeFn> {\n    const topic = this.prefix(name);\n\n    // Subscribe first to avoid message loss window\n    await this.redisSubscriberProvider.subscribe(topic, callback);\n\n    // Then deliver retained message if exists\n    const retained = await this.redisProvider.get(`${topic}:retained`);\n    if (retained) {\n      await callback(retained.toString());\n    }\n\n    return () => this.unsubscribe(name, callback);\n  }\n\n  /**\n   * Unsubscribe from a topic.\n   */\n  public async unsubscribe(\n    name: string,\n    callback?: SubscribeCallback,\n  ): Promise<void> {\n    const topic = this.prefix(name);\n\n    await this.redisSubscriberProvider.unsubscribe(topic, callback);\n  }\n}\n","import { $module, type Alepha } from \"alepha\";\nimport { AlephaTopic, TopicProvider } from \"alepha/topic\";\nimport { RedisTopicProvider } from \"./providers/RedisTopicProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./providers/RedisTopicProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Plugin for Alepha Topic that provides Redis pub/sub capabilities.\n *\n * @see {@link RedisTopicProvider}\n * @module alepha.topic.redis\n */\nexport const AlephaTopicRedis = $module({\n  name: \"alepha.topic.redis\",\n  services: [RedisTopicProvider],\n  register: (alepha: Alepha): Alepha =>\n    alepha\n      .with({\n        optional: true,\n        provide: TopicProvider,\n        use: RedisTopicProvider,\n      })\n      .with(AlephaTopic),\n});\n"],"mappings":";;;;;;;;AAgBA,MAAa,oBAAoB,MAAM;CACrC,MAAM;CACN,QAAQ,EAAE,OAAO,EACf,QAAQ,EAAE,KAAK;EACb,SAAS;EACT,aAAa;EACd,CAAC,EACH,CAAC;CACF,SAAS,EACP,QAAQ,SACT;CACF,CAAC;AAYF,IAAa,qBAAb,cAAwC,cAAc;CACpD,UAA6B,OAAO,kBAAkB;CACtD,SAA4B,QAAQ,OAAO;CAC3C,gBAAmC,QAAQ,cAAc;CACzD,0BAA6C,QAAQ,wBAAwB;CAE7E,MAAyB,SAAS;CAElC,QAA2B,MAAM;EAC/B,IAAI;EACJ,SAAS,YAAY;GACnB,MAAM,cAAc,KAAK,aAAa;GACtC,IAAI,YAAY,QAAQ;IACtB,MAAM,QAAQ,IAAI,YAAY,KAAK,OAAO,IAAI,CAAC,CAAC;IAChD,KAAK,MAAM,cAAc,aACvB,KAAK,IAAI,MAAM,wBAAwB,WAAW,KAAK,GAAG;;;EAIjE,CAAC;CAEF,eAA0C;EACxC,OAAO;;CAGT,OAAc,OAAuB;EACnC,OAAO,GAAG,KAAK,QAAQ,OAAO,GAAG;;;;;CAMnC,MAAa,QACX,OACA,SACA,SACe;EACf,IAAI,SAAS,QACX,MAAM,KAAK,cAAc,IAAI,GAAG,KAAK,OAAO,MAAM,CAAC,YAAY,QAAQ;EAEzE,MAAM,KAAK,cAAc,QAAQ,KAAK,OAAO,MAAM,EAAE,QAAQ;;;;;CAM/D,MAAa,UACX,MACA,UACA,UACwB;EACxB,MAAM,QAAQ,KAAK,OAAO,KAAK;EAG/B,MAAM,KAAK,wBAAwB,UAAU,OAAO,SAAS;EAG7D,MAAM,WAAW,MAAM,KAAK,cAAc,IAAI,GAAG,MAAM,WAAW;EAClE,IAAI,UACF,MAAM,SAAS,SAAS,UAAU,CAAC;EAGrC,aAAa,KAAK,YAAY,MAAM,SAAS;;;;;CAM/C,MAAa,YACX,MACA,UACe;EACf,MAAM,QAAQ,KAAK,OAAO,KAAK;EAE/B,MAAM,KAAK,wBAAwB,YAAY,OAAO,SAAS;;;;;;;;;;;ACjGnE,MAAa,mBAAmB,QAAQ;CACtC,MAAM;CACN,UAAU,CAAC,mBAAmB;CAC9B,WAAW,WACT,OACG,KAAK;EACJ,UAAU;EACV,SAAS;EACT,KAAK;EACN,CAAC,CACD,KAAK,YAAY;CACvB,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/topic/redis/providers/RedisTopicProvider.ts","../../../src/topic/redis/index.ts"],"sourcesContent":["import { $atom, $hook, $inject, $state, Alepha, type Static, t } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { RedisProvider, RedisSubscriberProvider } from \"alepha/redis\";\nimport {\n  type SubscribeCallback,\n  TopicProvider,\n  type TopicPublishOptions,\n  type TopicSubscribeOptions,\n  type UnSubscribeFn,\n} from \"alepha/topic\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Redis topic configuration atom.\n */\nexport const redisTopicOptions = $atom({\n  name: \"alepha.topic.redis.options\",\n  schema: t.object({\n    prefix: t.text({\n      default: \"topic\",\n      description: \"Prefix for all topic channels in Redis.\",\n    }),\n  }),\n  default: {\n    prefix: \"topic\",\n  },\n});\n\nexport type RedisTopicOptions = Static<typeof redisTopicOptions.schema>;\n\ndeclare module \"alepha\" {\n  interface State {\n    [redisTopicOptions.key]: RedisTopicOptions;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class RedisTopicProvider extends TopicProvider {\n  protected readonly options = $state(redisTopicOptions);\n  protected readonly alepha = $inject(Alepha);\n  protected readonly redisProvider = $inject(RedisProvider);\n  protected readonly redisSubscriberProvider = $inject(RedisSubscriberProvider);\n\n  protected readonly log = $logger();\n\n  protected readonly start = $hook({\n    on: \"start\",\n    handler: async () => {\n      const subscribers = this.subscribers();\n      if (subscribers.length) {\n        await Promise.all(subscribers.map((fn) => fn()));\n        for (const subscriber of subscribers) {\n          this.log.debug(`Subscribed to topic '${subscriber.name}'`);\n        }\n      }\n    },\n  });\n\n  protected override wildcardChar(): string {\n    return \"*\";\n  }\n\n  public prefix(queue: string): string {\n    return `${this.options.prefix}:${queue}`;\n  }\n\n  /**\n   * Publish a message to a topic.\n   */\n  public async publish(\n    topic: string,\n    message: string,\n    options?: TopicPublishOptions,\n  ): Promise<void> {\n    if (options?.retain) {\n      await this.redisProvider.set(`${this.prefix(topic)}:retained`, message);\n    }\n    await this.redisProvider.publish(this.prefix(topic), message);\n  }\n\n  /**\n   * Subscribe to a topic.\n   */\n  public async subscribe(\n    name: string,\n    callback: SubscribeCallback,\n    _options?: TopicSubscribeOptions,\n  ): Promise<UnSubscribeFn> {\n    const topic = this.prefix(name);\n\n    // Subscribe first to avoid message loss window\n    await this.redisSubscriberProvider.subscribe(topic, callback);\n\n    // Then deliver retained message if exists\n    const retained = await this.redisProvider.get(`${topic}:retained`);\n    if (retained) {\n      await callback(retained.toString());\n    }\n\n    return () => this.unsubscribe(name, callback);\n  }\n\n  /**\n   * Unsubscribe from a topic.\n   */\n  public async unsubscribe(\n    name: string,\n    callback?: SubscribeCallback,\n  ): Promise<void> {\n    const topic = this.prefix(name);\n\n    await this.redisSubscriberProvider.unsubscribe(topic, callback);\n  }\n}\n","import { $module, type Alepha } from \"alepha\";\nimport { AlephaTopic, TopicProvider } from \"alepha/topic\";\nimport { RedisTopicProvider } from \"./providers/RedisTopicProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./providers/RedisTopicProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Plugin for Alepha Topic that provides Redis pub/sub capabilities.\n *\n * @see {@link RedisTopicProvider}\n * @module alepha.topic.redis\n */\nexport const AlephaTopicRedis = $module({\n  name: \"alepha.topic.redis\",\n  services: [RedisTopicProvider],\n  register: (alepha: Alepha): Alepha =>\n    alepha\n      .with({\n        optional: true,\n        provide: TopicProvider,\n        use: RedisTopicProvider,\n      })\n      .with(AlephaTopic),\n});\n"],"mappings":";;;;;;;;AAgBA,MAAa,oBAAoB,MAAM;CACrC,MAAM;CACN,QAAQ,EAAE,OAAO,EACf,QAAQ,EAAE,KAAK;EACb,SAAS;EACT,aAAa;CACf,CAAC,EACH,CAAC;CACD,SAAS,EACP,QAAQ,QACV;AACF,CAAC;AAYD,IAAa,qBAAb,cAAwC,cAAc;CACpD,UAA6B,OAAO,iBAAiB;CACrD,SAA4B,QAAQ,MAAM;CAC1C,gBAAmC,QAAQ,aAAa;CACxD,0BAA6C,QAAQ,uBAAuB;CAE5E,MAAyB,QAAQ;CAEjC,QAA2B,MAAM;EAC/B,IAAI;EACJ,SAAS,YAAY;GACnB,MAAM,cAAc,KAAK,YAAY;GACrC,IAAI,YAAY,QAAQ;IACtB,MAAM,QAAQ,IAAI,YAAY,KAAK,OAAO,GAAG,CAAC,CAAC;IAC/C,KAAK,MAAM,cAAc,aACvB,KAAK,IAAI,MAAM,wBAAwB,WAAW,KAAK,EAAE;GAE7D;EACF;CACF,CAAC;CAED,eAA0C;EACxC,OAAO;CACT;CAEA,OAAc,OAAuB;EACnC,OAAO,GAAG,KAAK,QAAQ,OAAO,GAAG;CACnC;;;;CAKA,MAAa,QACX,OACA,SACA,SACe;EACf,IAAI,SAAS,QACX,MAAM,KAAK,cAAc,IAAI,GAAG,KAAK,OAAO,KAAK,EAAE,YAAY,OAAO;EAExE,MAAM,KAAK,cAAc,QAAQ,KAAK,OAAO,KAAK,GAAG,OAAO;CAC9D;;;;CAKA,MAAa,UACX,MACA,UACA,UACwB;EACxB,MAAM,QAAQ,KAAK,OAAO,IAAI;EAG9B,MAAM,KAAK,wBAAwB,UAAU,OAAO,QAAQ;EAG5D,MAAM,WAAW,MAAM,KAAK,cAAc,IAAI,GAAG,MAAM,UAAU;EACjE,IAAI,UACF,MAAM,SAAS,SAAS,SAAS,CAAC;EAGpC,aAAa,KAAK,YAAY,MAAM,QAAQ;CAC9C;;;;CAKA,MAAa,YACX,MACA,UACe;EACf,MAAM,QAAQ,KAAK,OAAO,IAAI;EAE9B,MAAM,KAAK,wBAAwB,YAAY,OAAO,QAAQ;CAChE;AACF;;;;;;;;;ACnGA,MAAa,mBAAmB,QAAQ;CACtC,MAAM;CACN,UAAU,CAAC,kBAAkB;CAC7B,WAAW,WACT,OACG,KAAK;EACJ,UAAU;EACV,SAAS;EACT,KAAK;CACP,CAAC,EACA,KAAK,WAAW;AACvB,CAAC"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "alepha",
   "description": "Easy-to-use modern TypeScript framework for building many kind of applications.",
   "author": "Feunard",
-  "version": "0.21.2",
+  "version": "0.23.0",
   "type": "module",
   "engines": {
     "node": ">=22.0.0",
@@ -21,24 +21,25 @@
     "CLAUDE.md"
   ],
   "dependencies": {
-    "@biomejs/biome": "^2.4.15",
-    "@redis/client": "^5.12.1",
+    "@biomejs/biome": "^2.4.16",
+    "@cloudflare/containers": "^0.3.5",
+    "@redis/client": "^6.0.0",
     "@vitejs/plugin-react": "^6.0.2",
-    "dayjs": "^1.11.20",
+    "dayjs": "^1.11.21",
     "drizzle-kit": "^0.31.10",
     "drizzle-orm": "^0.45.2",
     "postgres": "^3.4.9",
-    "s3mini": "^0.9.4",
-    "tsx": "^4.22.3",
-    "typebox": "^1.1.38",
+    "s3mini": "^0.9.5",
+    "tsx": "^4.22.4",
+    "typebox": "^1.1.39",
     "typescript": "^6.0.3",
-    "vite": "^8.0.13",
+    "vite": "^8.0.14",
     "vite-bundle-analyzer": "^1.3.8",
     "vitest": "^4.1.7"
   },
   "devDependencies": {
-    "@cloudflare/workers-types": "^4.20260520.1",
-    "@electric-sql/pglite": "^0.4.5",
+    "@cloudflare/workers-types": "^4.20260531.1",
+    "@electric-sql/pglite": "^0.4.6",
     "@faker-js/faker": "^10.4.0",
     "@tailwindcss/vite": "^4.3.0",
     "@testing-library/dom": "^10.4.1",
@@ -51,15 +52,14 @@
     "cron-schedule": "^6.0.0",
     "jose": "^6.2.3",
     "jsdom": "^29.1.1",
-    "nodemailer": "^8.0.7",
+    "nodemailer": "^8.0.10",
     "openid-client": "^6.8.4",
     "prom-client": "^15.1.3",
     "react": "^19.2.6",
     "react-dom": "^19.2.6",
-    "shadcn": "^4.7.0",
     "swagger-ui-dist": "^5.32.6",
     "tailwindcss": "^4.3.0",
-    "tsdown": "^0.22.0"
+    "tsdown": "^0.22.1"
   },
   "peerDependencies": {
     "react": "^19",
@@ -174,6 +174,12 @@
       "import": "./dist/api/verifications/index.js",
       "default": "./dist/api/verifications/index.js"
     },
+    "./background": {
+      "types": "./dist/background/index.d.ts",
+      "workerd": "./dist/background/index.workerd.js",
+      "import": "./dist/background/index.js",
+      "default": "./dist/background/index.js"
+    },
     "./batch": {
       "types": "./dist/batch/index.d.ts",
       "import": "./dist/batch/index.js",
@@ -236,6 +242,11 @@
       "import": "./dist/cli/platform/index.js",
       "default": "./dist/cli/platform/index.js"
     },
+    "./cli/platform-lib": {
+      "types": "./dist/cli/platform-lib/index.d.ts",
+      "import": "./dist/cli/platform-lib/index.js",
+      "default": "./dist/cli/platform-lib/index.js"
+    },
     "./cli/vendor": {
       "types": "./dist/cli/vendor/index.d.ts",
       "import": "./dist/cli/vendor/index.js",
@@ -246,11 +257,11 @@
       "import": "./dist/command/index.js",
       "default": "./dist/command/index.js"
     },
-    "./containers": {
-      "types": "./dist/containers/core/index.d.ts",
-      "workerd": "./dist/containers/core/index.workerd.js",
-      "import": "./dist/containers/core/index.js",
-      "default": "./dist/containers/core/index.js"
+    "./container": {
+      "types": "./dist/container/core/index.d.ts",
+      "workerd": "./dist/container/core/index.workerd.js",
+      "import": "./dist/container/core/index.js",
+      "default": "./dist/container/core/index.js"
     },
     ".": {
       "types": "./dist/core/index.d.ts",
@@ -384,6 +395,13 @@
       "import": "./dist/react/router/index.js",
       "default": "./dist/react/router/index.js"
     },
+    "./react/sitemap": {
+      "types": "./dist/react/sitemap/index.d.ts",
+      "react-native": "./dist/react/sitemap/index.browser.js",
+      "browser": "./dist/react/sitemap/index.browser.js",
+      "import": "./dist/react/sitemap/index.js",
+      "default": "./dist/react/sitemap/index.js"
+    },
     "./react/testing": {
       "types": "./dist/react/testing/index.d.ts",
       "import": "./dist/react/testing/index.js",
@@ -598,6 +616,12 @@
         "import": "./dist/api/verifications/index.js",
         "default": "./dist/api/verifications/index.js"
       },
+      "./background": {
+        "types": "./dist/background/index.d.ts",
+        "workerd": "./dist/background/index.workerd.js",
+        "import": "./dist/background/index.js",
+        "default": "./dist/background/index.js"
+      },
       "./batch": {
         "types": "./dist/batch/index.d.ts",
         "import": "./dist/batch/index.js",
@@ -660,6 +684,11 @@
         "import": "./dist/cli/platform/index.js",
         "default": "./dist/cli/platform/index.js"
       },
+      "./cli/platform-lib": {
+        "types": "./dist/cli/platform-lib/index.d.ts",
+        "import": "./dist/cli/platform-lib/index.js",
+        "default": "./dist/cli/platform-lib/index.js"
+      },
       "./cli/vendor": {
         "types": "./dist/cli/vendor/index.d.ts",
         "import": "./dist/cli/vendor/index.js",
@@ -670,11 +699,11 @@
         "import": "./dist/command/index.js",
         "default": "./dist/command/index.js"
       },
-      "./containers": {
-        "types": "./dist/containers/core/index.d.ts",
-        "workerd": "./dist/containers/core/index.workerd.js",
-        "import": "./dist/containers/core/index.js",
-        "default": "./dist/containers/core/index.js"
+      "./container": {
+        "types": "./dist/container/core/index.d.ts",
+        "workerd": "./dist/container/core/index.workerd.js",
+        "import": "./dist/container/core/index.js",
+        "default": "./dist/container/core/index.js"
       },
       ".": {
         "types": "./dist/core/index.d.ts",
@@ -808,6 +837,13 @@
         "import": "./dist/react/router/index.js",
         "default": "./dist/react/router/index.js"
       },
+      "./react/sitemap": {
+        "types": "./dist/react/sitemap/index.d.ts",
+        "react-native": "./dist/react/sitemap/index.browser.js",
+        "browser": "./dist/react/sitemap/index.browser.js",
+        "import": "./dist/react/sitemap/index.js",
+        "default": "./dist/react/sitemap/index.js"
+      },
       "./react/testing": {
         "types": "./dist/react/testing/index.d.ts",
         "import": "./dist/react/testing/index.js",

package/src/api/audits/__tests__/AuditService.spec.ts

@@ -115,136 +115,44 @@ describe("alepha/api/audits - AuditService", () => {
     });
   });
 
-  describe("recordAuth", () => {
-    it("should record login event", async ({ expect }) => {
+  describe("severity from success", () => {
+    it("defaults a failed audit to warning severity", async ({ expect }) => {
       const { auditService } = await setup();
 
-      const entry = await auditService.recordAuth("login", {
-        userId: "550e8400-e29b-41d4-a716-446655440000",
-        ipAddress: "10.0.0.1",
-      });
-
-      expect(entry.type).toBe("auth");
-      expect(entry.action).toBe("login");
-      expect(entry.severity).toBe("info");
-    });
-
-    it("should record failed login with warning severity", async ({
-      expect,
-    }) => {
-      const { auditService } = await setup();
-
-      const entry = await auditService.recordAuth("login_failed", {
-        userEmail: "attacker@example.com",
-        ipAddress: "10.0.0.1",
+      const entry = await auditService.create({
+        type: "auth",
+        action: "login",
+        success: false,
         errorMessage: "Invalid password",
       });
 
-      expect(entry.type).toBe("auth");
-      expect(entry.action).toBe("login_failed");
-      expect(entry.severity).toBe("warning");
-    });
-
-    it("should record logout event", async ({ expect }) => {
-      const { auditService } = await setup();
-
-      const entry = await auditService.recordAuth("logout", {
-        userId: "550e8400-e29b-41d4-a716-446655440000",
-        sessionId: "660e8400-e29b-41d4-a716-446655440001",
-      });
-
-      expect(entry.type).toBe("auth");
-      expect(entry.action).toBe("logout");
-    });
-  });
-
-  describe("recordUser", () => {
-    it("should record user creation event", async ({ expect }) => {
-      const { auditService } = await setup();
-
-      const entry = await auditService.recordUser("create", {
-        userId: "550e8400-e29b-41d4-a716-446655440000",
-        resourceId: "660e8400-e29b-41d4-a716-446655440001",
-        description: "New user registered",
-      });
-
-      expect(entry.type).toBe("user");
-      expect(entry.action).toBe("create");
-      expect(entry.resourceType).toBe("user");
-    });
-
-    it("should record role change event", async ({ expect }) => {
-      const { auditService } = await setup();
-
-      const entry = await auditService.recordUser("role_change", {
-        userId: "550e8400-e29b-41d4-a716-446655440000",
-        resourceId: "660e8400-e29b-41d4-a716-446655440001",
-        metadata: { oldRoles: ["user"], newRoles: ["user", "admin"] },
-      });
-
-      expect(entry.action).toBe("role_change");
-      expect(entry.metadata).toEqual({
-        oldRoles: ["user"],
-        newRoles: ["user", "admin"],
-      });
-    });
-  });
-
-  describe("recordSecurity", () => {
-    it("should record security events with warning severity", async ({
-      expect,
-    }) => {
-      const { auditService } = await setup();
-
-      const entry = await auditService.recordSecurity("permission_denied", {
-        userId: "550e8400-e29b-41d4-a716-446655440000",
-        resourceType: "admin_panel",
-        description: "Attempted to access admin panel without permission",
-      });
-
-      expect(entry.type).toBe("security");
-      expect(entry.action).toBe("permission_denied");
+      expect(entry.success).toBe(false);
       expect(entry.severity).toBe("warning");
     });
 
-    it("should record rate limiting event", async ({ expect }) => {
+    it("defaults a successful audit to info severity", async ({ expect }) => {
       const { auditService } = await setup();
 
-      const entry = await auditService.recordSecurity("rate_limited", {
-        ipAddress: "192.168.1.100",
-        metadata: { endpoint: "/api/login", requests: 100 },
-      });
-
-      expect(entry.action).toBe("rate_limited");
-      expect(entry.severity).toBe("warning");
-    });
-  });
-
-  describe("recordSystem", () => {
-    it("should record system startup", async ({ expect }) => {
-      const { auditService } = await setup();
-
-      const entry = await auditService.recordSystem("startup", {
-        metadata: { version: "1.0.0" },
+      const entry = await auditService.create({
+        type: "auth",
+        action: "login",
       });
 
-      expect(entry.type).toBe("system");
-      expect(entry.action).toBe("startup");
       expect(entry.severity).toBe("info");
     });
 
-    it("should record system error with critical severity", async ({
+    it("respects an explicit severity over the success default", async ({
       expect,
     }) => {
       const { auditService } = await setup();
 
-      const entry = await auditService.recordSystem("error", {
-        errorMessage: "Database connection failed",
-        metadata: { error: "ECONNREFUSED" },
+      const entry = await auditService.create({
+        type: "security",
+        action: "sessions_invalidated",
+        severity: "warning",
       });
 
-      expect(entry.action).toBe("error");
-      expect(entry.severity).toBe("critical");
+      expect(entry.severity).toBe("warning");
     });
   });
 
@@ -396,7 +304,7 @@ describe("alepha/api/audits - AuditService", () => {
       });
       await auditService.create({
         type: "auth",
-        action: "login_failed",
+        action: "login",
         severity: "warning",
         success: false,
       });

package/src/api/audits/controllers/AdminAuditController.ts

@@ -175,6 +175,20 @@ export class AdminAuditController {
       }),
   });
 
+  /**
+   * List distinct action names present in the audit log (for filters).
+   */
+  public readonly getAuditActions = $action({
+    path: `${this.url}/actions`,
+    group: this.group,
+    use: [$secure({ permissions: ["admin:audit:read"] })],
+    description: "List distinct action names present in the audit log",
+    schema: {
+      response: t.array(t.text()),
+    },
+    handler: () => this.auditService.getDistinctActions(),
+  });
+
   /**
    * Get registered audit types.
    */