alepha 0.14.4 → 0.15.0

package/dist/redis/index.bun.js

@@ -0,0 +1,285 @@
+import { $env, $hook, $inject, $module, Alepha, AlephaError, t } from "alepha";
+import { $logger } from "alepha/logger";
+
+//#region ../../src/redis/providers/RedisProvider.ts
+/**
+* Abstract Redis provider interface.
+*
+* This abstract class defines the common interface for Redis operations.
+* Implementations include:
+* - {@link NodeRedisProvider} - Uses `@redis/client` for Node.js runtime
+* - {@link BunRedisProvider} - Uses Bun's native `RedisClient` for Bun runtime
+*
+* @example
+* ```ts
+* // Inject the abstract provider - runtime selects the implementation
+* const redis = alepha.inject(RedisProvider);
+*
+* // Use common operations
+* await redis.set("key", "value");
+* const value = await redis.get("key");
+* ```
+*/
+var RedisProvider = class {};
+
+//#endregion
+//#region ../../src/redis/providers/BunRedisProvider.ts
+const envSchema = t.object({ REDIS_URL: t.text({
+	default: "redis://localhost:6379",
+	description: "Redis connection URL"
+}) });
+/**
+* Bun Redis client provider using Bun's native Redis client.
+*
+* This provider uses Bun's built-in `RedisClient` class for Redis connections,
+* which provides excellent performance (7.9x faster than ioredis) on the Bun runtime.
+*
+* @example
+* ```ts
+* // Set REDIS_URL environment variable (default: redis://localhost:6379)
+* // REDIS_URL=redis://:password@myredis.example.com:6379
+*
+* // Or configure programmatically
+* alepha.with({
+*   provide: RedisProvider,
+*   use: BunRedisProvider,
+* });
+* ```
+*/
+var BunRedisProvider = class extends RedisProvider {
+	log = $logger();
+	alepha = $inject(Alepha);
+	env = $env(envSchema);
+	client;
+	get publisher() {
+		if (!this.client?.connected) throw new AlephaError("Redis client is not ready");
+		return this.client;
+	}
+	get isReady() {
+		return this.client?.connected ?? false;
+	}
+	start = $hook({
+		on: "start",
+		handler: () => this.connect()
+	});
+	stop = $hook({
+		on: "stop",
+		handler: () => this.close()
+	});
+	/**
+	* Connect to the Redis server.
+	*/
+	async connect() {
+		if (!this.alepha.isBun()) throw new AlephaError("BunRedisProvider requires the Bun runtime. Use NodeRedisProvider for Node.js.");
+		this.log.debug("Connecting...");
+		this.client = new Bun.RedisClient(this.getUrl(), {
+			autoReconnect: true,
+			enableAutoPipelining: true
+		});
+		this.client.onconnect = () => {
+			this.log.trace("Redis connected");
+		};
+		this.client.onclose = (error) => {
+			if (this.alepha.isStarted() && error) this.log.error("Redis connection closed", error);
+		};
+		await this.client.connect();
+		this.log.info("Connection OK");
+	}
+	/**
+	* Close the connection to the Redis server.
+	*/
+	async close() {
+		if (this.client) {
+			this.log.debug("Closing connection...");
+			this.client.close();
+			this.client = void 0;
+			this.log.info("Connection closed");
+		}
+	}
+	/**
+	* Create a duplicate connection for pub/sub or other isolated operations.
+	*/
+	async duplicate() {
+		if (typeof Bun === "undefined") throw new AlephaError("BunRedisProvider requires the Bun runtime.");
+		const client = new Bun.RedisClient(this.getUrl(), {
+			autoReconnect: true,
+			enableAutoPipelining: true
+		});
+		client.onclose = (error) => {
+			if (this.alepha.isStarted() && error) this.log.error("Redis duplicate connection closed", error);
+		};
+		await client.connect();
+		return client;
+	}
+	async get(key) {
+		this.log.trace(`Getting key ${key}`);
+		const resp = await this.publisher.getBuffer(key);
+		if (resp === null) return;
+		return Buffer.from(resp);
+	}
+	async set(key, value, options) {
+		const buf = Buffer.isBuffer(value) ? value : Buffer.from(value, "utf-8");
+		const args = [key, buf.toString("binary")];
+		if (options?.expiration) if (options.expiration.type === "KEEPTTL") args.push("KEEPTTL");
+		else args.push(options.expiration.type, String(options.expiration.value));
+		if (options?.EX !== void 0) args.push("EX", String(options.EX));
+		if (options?.PX !== void 0) args.push("PX", String(options.PX));
+		if (options?.EXAT !== void 0) args.push("EXAT", String(options.EXAT));
+		if (options?.PXAT !== void 0) args.push("PXAT", String(options.PXAT));
+		if (options?.KEEPTTL) args.push("KEEPTTL");
+		if (options?.condition === "NX") args.push("NX");
+		else if (options?.condition === "XX") args.push("XX");
+		if (options?.NX) args.push("NX");
+		if (options?.XX) args.push("XX");
+		if (options?.GET) args.push("GET");
+		if (args.length === 2) await this.publisher.set(key, buf);
+		else await this.publisher.send("SET", args);
+		return buf;
+	}
+	async has(key) {
+		return this.publisher.exists(key);
+	}
+	async keys(pattern) {
+		const keys = await this.publisher.send("KEYS", [pattern]);
+		if (!Array.isArray(keys)) return [];
+		return keys.map((key) => key instanceof Uint8Array ? Buffer.from(key).toString() : String(key));
+	}
+	async del(keys) {
+		if (keys.length === 0) return;
+		await this.publisher.send("DEL", keys);
+	}
+	async lpush(key, value) {
+		await this.publisher.send("LPUSH", [key, value]);
+	}
+	async rpop(key) {
+		const value = await this.publisher.send("RPOP", [key]);
+		if (value == null) return;
+		if (value instanceof Uint8Array) return Buffer.from(value).toString();
+		return String(value);
+	}
+	async publish(channel, message) {
+		await this.publisher.publish(channel, message);
+	}
+	/**
+	* Get the Redis connection URL.
+	*/
+	getUrl() {
+		return this.env.REDIS_URL;
+	}
+};
+
+//#endregion
+//#region ../../src/redis/providers/RedisSubscriberProvider.ts
+/**
+* Abstract Redis subscriber provider interface.
+*
+* This abstract class defines the common interface for Redis pub/sub subscriptions.
+* Implementations include:
+* - {@link NodeRedisSubscriberProvider} - Uses `@redis/client` for Node.js runtime
+* - {@link BunRedisSubscriberProvider} - Uses Bun's native `RedisClient` for Bun runtime
+*
+* Redis requires separate connections for pub/sub operations, so this provider
+* creates a dedicated connection for subscriptions.
+*
+* @example
+* ```ts
+* // Inject the abstract provider - runtime selects the implementation
+* const subscriber = alepha.inject(RedisSubscriberProvider);
+*
+* // Subscribe to a channel
+* await subscriber.subscribe("my-channel", (message, channel) => {
+*   console.log(`Received: ${message} on ${channel}`);
+* });
+* ```
+*/
+var RedisSubscriberProvider = class {};
+
+//#endregion
+//#region ../../src/redis/providers/BunRedisSubscriberProvider.ts
+/**
+* Bun Redis subscriber provider for pub/sub operations.
+*
+* This provider creates a dedicated Redis connection for subscriptions,
+* as Redis requires separate connections for pub/sub operations.
+*
+* @example
+* ```ts
+* const subscriber = alepha.inject(RedisSubscriberProvider);
+* await subscriber.subscribe("channel", (message, channel) => {
+*   console.log(`Received: ${message} on ${channel}`);
+* });
+* ```
+*/
+var BunRedisSubscriberProvider = class extends RedisSubscriberProvider {
+	log = $logger();
+	alepha = $inject(Alepha);
+	redisProvider = $inject(BunRedisProvider);
+	client;
+	get subscriber() {
+		if (!this.client?.connected) throw new AlephaError("Redis subscriber client is not ready");
+		return this.client;
+	}
+	get isReady() {
+		return this.client?.connected ?? false;
+	}
+	start = $hook({
+		on: "start",
+		handler: () => this.connect()
+	});
+	stop = $hook({
+		on: "stop",
+		handler: () => this.close()
+	});
+	/**
+	* Connect to the Redis server for subscriptions.
+	*/
+	async connect() {
+		this.log.debug("Connecting subscriber...");
+		this.client = await this.redisProvider.duplicate();
+		this.log.info("Subscriber connection OK");
+	}
+	/**
+	* Close the subscriber connection.
+	*/
+	async close() {
+		if (this.client) {
+			this.log.debug("Closing subscriber connection...");
+			this.client.close();
+			this.client = void 0;
+			this.log.info("Subscriber connection closed");
+		}
+	}
+	async subscribe(channel, callback) {
+		await this.subscriber.subscribe(channel, (message, ch) => {
+			callback(typeof message === "object" && message !== null ? Buffer.from(message).toString() : String(message), ch);
+		});
+	}
+	async unsubscribe(channel, _callback) {
+		await this.subscriber.unsubscribe(channel);
+	}
+};
+
+//#endregion
+//#region ../../src/redis/index.bun.ts
+const AlephaRedis = $module({
+	name: "alepha.redis",
+	services: [
+		BunRedisProvider,
+		BunRedisSubscriberProvider,
+		RedisProvider,
+		RedisSubscriberProvider
+	],
+	register: (alepha) => {
+		alepha.with({
+			provide: RedisProvider,
+			use: BunRedisProvider
+		}).with({
+			provide: RedisSubscriberProvider,
+			use: BunRedisSubscriberProvider
+		});
+	}
+});
+
+//#endregion
+export { AlephaRedis, BunRedisProvider, BunRedisSubscriberProvider, RedisProvider, RedisSubscriberProvider };
+//# sourceMappingURL=index.bun.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.bun.js","names":[],"sources":["../../src/redis/providers/RedisProvider.ts","../../src/redis/providers/BunRedisProvider.ts","../../src/redis/providers/RedisSubscriberProvider.ts","../../src/redis/providers/BunRedisSubscriberProvider.ts","../../src/redis/index.bun.ts"],"sourcesContent":["/**\n * Abstract Redis provider interface.\n *\n * This abstract class defines the common interface for Redis operations.\n * Implementations include:\n * - {@link NodeRedisProvider} - Uses `@redis/client` for Node.js runtime\n * - {@link BunRedisProvider} - Uses Bun's native `RedisClient` for Bun runtime\n *\n * @example\n * ```ts\n * // Inject the abstract provider - runtime selects the implementation\n * const redis = alepha.inject(RedisProvider);\n *\n * // Use common operations\n * await redis.set(\"key\", \"value\");\n * const value = await redis.get(\"key\");\n * ```\n */\nexport abstract class RedisProvider {\n  /**\n   * Whether the Redis client is ready to accept commands.\n   */\n  public abstract readonly isReady: boolean;\n\n  /**\n   * Connect to the Redis server.\n   */\n  public abstract connect(): Promise<void>;\n\n  /**\n   * Close the connection to the Redis server.\n   */\n  public abstract close(): Promise<void>;\n\n  /**\n   * Get the value of a key.\n   *\n   * @param key The key to get.\n   * @returns The value as a Buffer, or undefined if the key does not exist.\n   */\n  public abstract get(key: string): Promise<Buffer | undefined>;\n\n  /**\n   * Set the value of a key.\n   *\n   * @param key The key to set.\n   * @param value The value to set (Buffer or string).\n   * @param options Optional set options (EX, PX, NX, XX, etc.).\n   * @returns The value as a Buffer.\n   */\n  public abstract set(\n    key: string,\n    value: Buffer | string,\n    options?: RedisSetOptions,\n  ): Promise<Buffer>;\n\n  /**\n   * Check if a key exists.\n   *\n   * @param key The key to check.\n   * @returns True if the key exists.\n   */\n  public abstract has(key: string): Promise<boolean>;\n\n  /**\n   * Get all keys matching a pattern.\n   *\n   * @param pattern The glob-style pattern to match.\n   * @returns Array of matching key names.\n   */\n  public abstract keys(pattern: string): Promise<string[]>;\n\n  /**\n   * Delete one or more keys.\n   *\n   * @param keys The keys to delete.\n   */\n  public abstract del(keys: string[]): Promise<void>;\n\n  // ---------------------------------------------------------\n  // Queue operations (for alepha/queue-redis)\n  // ---------------------------------------------------------\n\n  /**\n   * Push a value to the left (head) of a list.\n   *\n   * @param key The list key.\n   * @param value The value to push.\n   */\n  public abstract lpush(key: string, value: string): Promise<void>;\n\n  /**\n   * Pop a value from the right (tail) of a list.\n   *\n   * @param key The list key.\n   * @returns The value, or undefined if the list is empty.\n   */\n  public abstract rpop(key: string): Promise<string | undefined>;\n\n  // ---------------------------------------------------------\n  // Pub/Sub operations (for alepha/topic-redis)\n  // ---------------------------------------------------------\n\n  /**\n   * Publish a message to a channel.\n   *\n   * @param channel The channel name.\n   * @param message The message to publish.\n   */\n  public abstract publish(channel: string, message: string): Promise<void>;\n}\n\n/**\n * Common Redis SET command options.\n * Compatible with @redis/client SetOptions format.\n */\nexport interface RedisSetOptions {\n  /**\n   * Set the specified expire time, in seconds.\n   */\n  EX?: number;\n  /**\n   * Set the specified expire time, in milliseconds.\n   */\n  PX?: number;\n  /**\n   * Set the specified Unix time at which the key will expire, in seconds.\n   */\n  EXAT?: number;\n  /**\n   * Set the specified Unix time at which the key will expire, in milliseconds.\n   */\n  PXAT?: number;\n  /**\n   * Only set the key if it does not already exist.\n   */\n  NX?: boolean;\n  /**\n   * Only set the key if it already exists.\n   */\n  XX?: boolean;\n  /**\n   * Retain the time to live associated with the key.\n   */\n  KEEPTTL?: boolean;\n  /**\n   * Return the old string stored at key, or nil if key did not exist.\n   */\n  GET?: boolean;\n  /**\n   * Alternative expiration format (compatible with @redis/client).\n   */\n  expiration?: {\n    type: \"EX\" | \"PX\" | \"EXAT\" | \"PXAT\" | \"KEEPTTL\";\n    value: number;\n  };\n  /**\n   * Alternative condition format (compatible with @redis/client).\n   */\n  condition?: \"NX\" | \"XX\";\n}\n","import {\n  $env,\n  $hook,\n  $inject,\n  Alepha,\n  AlephaError,\n  type Static,\n  t,\n} from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { RedisProvider, type RedisSetOptions } from \"./RedisProvider.ts\";\n\nconst envSchema = t.object({\n  REDIS_URL: t.text({\n    default: \"redis://localhost:6379\",\n    description: \"Redis connection URL\",\n  }),\n});\n\ndeclare module \"alepha\" {\n  interface Env extends Partial<Static<typeof envSchema>> {}\n}\n\n/**\n * Bun Redis client provider using Bun's native Redis client.\n *\n * This provider uses Bun's built-in `RedisClient` class for Redis connections,\n * which provides excellent performance (7.9x faster than ioredis) on the Bun runtime.\n *\n * @example\n * ```ts\n * // Set REDIS_URL environment variable (default: redis://localhost:6379)\n * // REDIS_URL=redis://:password@myredis.example.com:6379\n *\n * // Or configure programmatically\n * alepha.with({\n *   provide: RedisProvider,\n *   use: BunRedisProvider,\n * });\n * ```\n */\nexport class BunRedisProvider extends RedisProvider {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n  protected readonly env = $env(envSchema);\n  protected client?: Bun.RedisClient;\n\n  public get publisher(): Bun.RedisClient {\n    if (!this.client?.connected) {\n      throw new AlephaError(\"Redis client is not ready\");\n    }\n\n    return this.client;\n  }\n\n  public override get isReady(): boolean {\n    return this.client?.connected ?? false;\n  }\n\n  protected readonly start = $hook({\n    on: \"start\",\n    handler: () => this.connect(),\n  });\n\n  protected readonly stop = $hook({\n    on: \"stop\",\n    handler: () => this.close(),\n  });\n\n  /**\n   * Connect to the Redis server.\n   */\n  public override async connect(): Promise<void> {\n    // Check if we're running in Bun\n    if (!this.alepha.isBun()) {\n      throw new AlephaError(\n        \"BunRedisProvider requires the Bun runtime. Use NodeRedisProvider for Node.js.\",\n      );\n    }\n\n    this.log.debug(\"Connecting...\");\n\n    this.client = new Bun.RedisClient(this.getUrl(), {\n      autoReconnect: true,\n      enableAutoPipelining: true,\n    });\n\n    this.client.onconnect = () => {\n      this.log.trace(\"Redis connected\");\n    };\n\n    this.client.onclose = (error) => {\n      if (this.alepha.isStarted() && error) {\n        this.log.error(\"Redis connection closed\", error);\n      }\n    };\n\n    await this.client.connect();\n\n    this.log.info(\"Connection OK\");\n  }\n\n  /**\n   * Close the connection to the Redis server.\n   */\n  public override async close(): Promise<void> {\n    if (this.client) {\n      this.log.debug(\"Closing connection...\");\n      this.client.close();\n      this.client = undefined;\n      this.log.info(\"Connection closed\");\n    }\n  }\n\n  /**\n   * Create a duplicate connection for pub/sub or other isolated operations.\n   */\n  public async duplicate(): Promise<Bun.RedisClient> {\n    if (typeof Bun === \"undefined\") {\n      throw new AlephaError(\"BunRedisProvider requires the Bun runtime.\");\n    }\n\n    const client = new Bun.RedisClient(this.getUrl(), {\n      autoReconnect: true,\n      enableAutoPipelining: true,\n    });\n\n    client.onclose = (error) => {\n      if (this.alepha.isStarted() && error) {\n        this.log.error(\"Redis duplicate connection closed\", error);\n      }\n    };\n\n    await client.connect();\n\n    return client;\n  }\n\n  public override async get(key: string): Promise<Buffer | undefined> {\n    this.log.trace(`Getting key ${key}`);\n    const resp = await this.publisher.getBuffer(key);\n\n    if (resp === null) {\n      return undefined;\n    }\n\n    return Buffer.from(resp);\n  }\n\n  public override async set(\n    key: string,\n    value: Buffer | string,\n    options?: RedisSetOptions,\n  ): Promise<Buffer> {\n    const buf = Buffer.isBuffer(value) ? value : Buffer.from(value, \"utf-8\");\n\n    // Build SET command arguments\n    const args: string[] = [key, buf.toString(\"binary\")];\n\n    // Handle expiration object format (from alepha/cache-redis, alepha/lock-redis)\n    if (options?.expiration) {\n      if (options.expiration.type === \"KEEPTTL\") {\n        args.push(\"KEEPTTL\");\n      } else {\n        args.push(options.expiration.type, String(options.expiration.value));\n      }\n    }\n\n    // Handle direct expiration properties\n    if (options?.EX !== undefined) {\n      args.push(\"EX\", String(options.EX));\n    }\n    if (options?.PX !== undefined) {\n      args.push(\"PX\", String(options.PX));\n    }\n    if (options?.EXAT !== undefined) {\n      args.push(\"EXAT\", String(options.EXAT));\n    }\n    if (options?.PXAT !== undefined) {\n      args.push(\"PXAT\", String(options.PXAT));\n    }\n    if (options?.KEEPTTL) {\n      args.push(\"KEEPTTL\");\n    }\n\n    // Handle condition object format\n    if (options?.condition === \"NX\") {\n      args.push(\"NX\");\n    } else if (options?.condition === \"XX\") {\n      args.push(\"XX\");\n    }\n\n    // Handle direct condition properties\n    if (options?.NX) {\n      args.push(\"NX\");\n    }\n    if (options?.XX) {\n      args.push(\"XX\");\n    }\n    if (options?.GET) {\n      args.push(\"GET\");\n    }\n\n    if (args.length === 2) {\n      // Simple set without options\n      await this.publisher.set(key, buf);\n    } else {\n      // Set with options via raw command\n      await this.publisher.send(\"SET\", args);\n    }\n\n    return buf;\n  }\n\n  public override async has(key: string): Promise<boolean> {\n    return this.publisher.exists(key);\n  }\n\n  public override async keys(pattern: string): Promise<string[]> {\n    const keys = await this.publisher.send(\"KEYS\", [pattern]);\n    if (!Array.isArray(keys)) {\n      return [];\n    }\n    return keys.map((key) =>\n      key instanceof Uint8Array ? Buffer.from(key).toString() : String(key),\n    );\n  }\n\n  public override async del(keys: string[]): Promise<void> {\n    if (keys.length === 0) {\n      return;\n    }\n\n    await this.publisher.send(\"DEL\", keys);\n  }\n\n  // ---------------------------------------------------------\n  // Queue operations\n  // ---------------------------------------------------------\n\n  public override async lpush(key: string, value: string): Promise<void> {\n    await this.publisher.send(\"LPUSH\", [key, value]);\n  }\n\n  public override async rpop(key: string): Promise<string | undefined> {\n    const value = await this.publisher.send(\"RPOP\", [key]);\n    if (value == null) {\n      return undefined;\n    }\n    if (value instanceof Uint8Array) {\n      return Buffer.from(value).toString();\n    }\n    return String(value);\n  }\n\n  // ---------------------------------------------------------\n  // Pub/Sub operations\n  // ---------------------------------------------------------\n\n  public override async publish(\n    channel: string,\n    message: string,\n  ): Promise<void> {\n    await this.publisher.publish(channel, message);\n  }\n\n  /**\n   * Get the Redis connection URL.\n   */\n  protected getUrl(): string {\n    return this.env.REDIS_URL;\n  }\n}\n","/**\n * Abstract Redis subscriber provider interface.\n *\n * This abstract class defines the common interface for Redis pub/sub subscriptions.\n * Implementations include:\n * - {@link NodeRedisSubscriberProvider} - Uses `@redis/client` for Node.js runtime\n * - {@link BunRedisSubscriberProvider} - Uses Bun's native `RedisClient` for Bun runtime\n *\n * Redis requires separate connections for pub/sub operations, so this provider\n * creates a dedicated connection for subscriptions.\n *\n * @example\n * ```ts\n * // Inject the abstract provider - runtime selects the implementation\n * const subscriber = alepha.inject(RedisSubscriberProvider);\n *\n * // Subscribe to a channel\n * await subscriber.subscribe(\"my-channel\", (message, channel) => {\n *   console.log(`Received: ${message} on ${channel}`);\n * });\n * ```\n */\nexport abstract class RedisSubscriberProvider {\n  /**\n   * Whether the Redis subscriber client is ready to accept commands.\n   */\n  public abstract readonly isReady: boolean;\n\n  /**\n   * Connect to the Redis server for subscriptions.\n   */\n  public abstract connect(): Promise<void>;\n\n  /**\n   * Close the subscriber connection.\n   */\n  public abstract close(): Promise<void>;\n\n  /**\n   * Subscribe to a channel.\n   *\n   * @param channel The channel name.\n   * @param callback The callback to invoke when a message is received.\n   */\n  public abstract subscribe(\n    channel: string,\n    callback: SubscribeCallback,\n  ): Promise<void>;\n\n  /**\n   * Unsubscribe from a channel.\n   *\n   * @param channel The channel name.\n   * @param callback Optional specific callback to remove.\n   */\n  public abstract unsubscribe(\n    channel: string,\n    callback?: SubscribeCallback,\n  ): Promise<void>;\n}\n\n/**\n * Callback for subscription messages.\n */\nexport type SubscribeCallback = (message: string, channel: string) => void;\n","import { $hook, $inject, Alepha, AlephaError } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { BunRedisProvider } from \"./BunRedisProvider.ts\";\nimport {\n  RedisSubscriberProvider,\n  type SubscribeCallback,\n} from \"./RedisSubscriberProvider.ts\";\n\n/**\n * Bun Redis subscriber provider for pub/sub operations.\n *\n * This provider creates a dedicated Redis connection for subscriptions,\n * as Redis requires separate connections for pub/sub operations.\n *\n * @example\n * ```ts\n * const subscriber = alepha.inject(RedisSubscriberProvider);\n * await subscriber.subscribe(\"channel\", (message, channel) => {\n *   console.log(`Received: ${message} on ${channel}`);\n * });\n * ```\n */\nexport class BunRedisSubscriberProvider extends RedisSubscriberProvider {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n  protected readonly redisProvider = $inject(BunRedisProvider);\n  protected client?: Bun.RedisClient;\n\n  public get subscriber(): Bun.RedisClient {\n    if (!this.client?.connected) {\n      throw new AlephaError(\"Redis subscriber client is not ready\");\n    }\n\n    return this.client;\n  }\n\n  public override get isReady(): boolean {\n    return this.client?.connected ?? false;\n  }\n\n  protected readonly start = $hook({\n    on: \"start\",\n    handler: () => this.connect(),\n  });\n\n  protected readonly stop = $hook({\n    on: \"stop\",\n    handler: () => this.close(),\n  });\n\n  /**\n   * Connect to the Redis server for subscriptions.\n   */\n  public override async connect(): Promise<void> {\n    this.log.debug(\"Connecting subscriber...\");\n    this.client = await this.redisProvider.duplicate();\n    this.log.info(\"Subscriber connection OK\");\n  }\n\n  /**\n   * Close the subscriber connection.\n   */\n  public override async close(): Promise<void> {\n    if (this.client) {\n      this.log.debug(\"Closing subscriber connection...\");\n      this.client.close();\n      this.client = undefined;\n      this.log.info(\"Subscriber connection closed\");\n    }\n  }\n\n  public override async subscribe(\n    channel: string,\n    callback: SubscribeCallback,\n  ): Promise<void> {\n    await this.subscriber.subscribe(channel, (message, ch) => {\n      // Bun's callback provides Buffer or string, normalize to string\n      const msg =\n        typeof message === \"object\" && message !== null\n          ? Buffer.from(message as Uint8Array).toString()\n          : String(message);\n      callback(msg, ch);\n    });\n  }\n\n  public override async unsubscribe(\n    channel: string,\n    _callback?: SubscribeCallback,\n  ): Promise<void> {\n    // Bun's unsubscribe doesn't support callback filtering\n    await this.subscriber.unsubscribe(channel);\n  }\n}\n","import { $module, type Alepha } from \"alepha\";\nimport { BunRedisProvider } from \"./providers/BunRedisProvider.ts\";\nimport { BunRedisSubscriberProvider } from \"./providers/BunRedisSubscriberProvider.ts\";\nimport { RedisProvider } from \"./providers/RedisProvider.ts\";\nimport { RedisSubscriberProvider } from \"./providers/RedisSubscriberProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./providers/BunRedisProvider.ts\";\nexport * from \"./providers/BunRedisSubscriberProvider.ts\";\nexport * from \"./providers/RedisProvider.ts\";\nexport * from \"./providers/RedisSubscriberProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const AlephaRedis = $module({\n  name: \"alepha.redis\",\n  services: [\n    BunRedisProvider,\n    BunRedisSubscriberProvider,\n    RedisProvider,\n    RedisSubscriberProvider,\n  ],\n  register: (alepha: Alepha) => {\n    alepha\n      .with({\n        provide: RedisProvider,\n        use: BunRedisProvider,\n      })\n      .with({\n        provide: RedisSubscriberProvider,\n        use: BunRedisSubscriberProvider,\n      });\n  },\n});\n"],"mappings":"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"}