@redfx/ioredis 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alex Walker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,21 @@
+# @redfx/ioredis
+
+[ioredis](https://github.com/redis/ioredis) driver for [@redfx/core](https://www.npmjs.com/package/@redfx/core).
+It implements the `send`-level port over `ioredis.sendCommand`, with a dedicated pub/sub connection
+and an optional connection pool.
+
+```ts
+import { Redis } from "@redfx/core"
+import { IoRedis } from "@redfx/ioredis"
+import { Config } from "effect"
+
+const RedisLive = IoRedis.layerConfig(Config.string("REDIS_URL"))
+// IoRedis.layer({ url, options, commandTimeout })   single connection
+// IoRedis.layerPooled({ url, size: 10 })            pooled commands, dedicated pub/sub
+```
+
+Peer dependencies: `effect`, `ioredis`, `@redfx/core`.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+import { ConnectionError, type Redis } from "@redfx/core";
+import { type Config, type ConfigError, type Duration, Layer } from "effect";
+import { type ClusterNode, type ClusterOptions, type RedisOptions } from "ioredis";
+export interface ClientConfig {
+    readonly url?: string;
+    readonly options?: RedisOptions;
+    /** Effect-level per-command deadline; on expiry the command fails with `TimeoutError`. */
+    readonly commandTimeout?: Duration.DurationInput;
+}
+export interface ClusterConfig {
+    readonly nodes: ReadonlyArray<ClusterNode>;
+    readonly options?: ClusterOptions;
+    readonly commandTimeout?: Duration.DurationInput;
+}
+export declare namespace IoRedis {
+    const layer: (config?: ClientConfig) => Layer.Layer<Redis, ConnectionError>;
+    const layerConfig: (url: Config.Config<string>, config?: Omit<ClientConfig, "url">) => Layer.Layer<Redis, ConnectionError | ConfigError.ConfigError>;
+    /** Pools `size` command connections; pub/sub still uses a dedicated connection. */
+    const layerPooled: (config: ClientConfig & {
+        readonly size: number;
+    }) => Layer.Layer<Redis, ConnectionError>;
+    /** Connects to a Redis Cluster (the client pools per-node internally, so no pooled variant).
+     *  Cross-slot multi-key commands need a shared hash tag `{…}` or they fail with `CROSSSLOT`. */
+    const layerCluster: (config: ClusterConfig) => Layer.Layer<Redis, ConnectionError>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EAKf,KAAK,KAAK,EAIX,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,MAAM,EACX,KAAK,WAAW,EAChB,KAAK,QAAQ,EAEb,KAAK,EAGN,MAAM,QAAQ,CAAC;AAChB,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,cAAc,EAGnB,KAAK,YAAY,EAClB,MAAM,SAAS,CAAC;AAKjB,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,0FAA0F;IAC1F,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC;CAClD;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC;CAClD;AAuLD,yBAAiB,OAAO,CAAC;IAChB,MAAM,KAAK,GAAI,SAAQ,YAAiB,KAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,eAAe,CAGhF,CAAC;IAEE,MAAM,WAAW,GACtB,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAC1B,SAAS,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,KACjC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,eAAe,GAAG,WAAW,CAAC,WAAW,CACyB,CAAC;IAEzF,mFAAmF;IAC5E,MAAM,WAAW,GACtB,QAAQ,YAAY,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAC/C,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,eAAe,CAWpC,CAAC;IAEF;oGACgG;IACzF,MAAM,YAAY,GAAI,QAAQ,aAAa,KAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,eAAe,CAGnF,CAAC;CACN"}

package/dist/index.js

@@ -0,0 +1,137 @@
+import { CommandError, ConnectionError, layerConnection, pooledConnection, } from "@redfx/core";
+import { Effect, Layer, Stream, } from "effect";
+import { Cluster, Command, Redis as IORedisClient, } from "ioredis";
+const DEFAULTS = {
+    lazyConnect: true,
+    maxRetriesPerRequest: 3,
+    retryStrategy: (times) => (times > 5 ? null : Math.min(times * 100, 2000)),
+    keepAlive: 30_000, // surface a silently-dead peer so a blocking read fails instead of hanging
+};
+// The consumer Stream owns reconnection (Stream.retry), so disable ioredis's own recovery: a dropped
+// XREAD must fail fast with a ConnectionError, not be silently reconnected and resent under us.
+const DEDICATED_OVERRIDES = {
+    retryStrategy: () => null,
+    autoResendUnfulfilledCommands: false,
+    enableOfflineQueue: false,
+    maxRetriesPerRequest: 0,
+};
+const CLUSTER_DEFAULTS = {
+    lazyConnect: true,
+    redisOptions: { maxRetriesPerRequest: 3, keepAlive: 30_000 },
+};
+const CONNECTION_CODES = new Set([
+    "ECONNREFUSED",
+    "ECONNRESET",
+    "EPIPE",
+    "ETIMEDOUT",
+    "ENOTFOUND",
+    "EAI_AGAIN",
+    "ERR_REDIS_CONNECTION_CLOSED",
+]);
+const mapError = (command, cause) => {
+    const err = cause;
+    const message = err.message ?? String(cause);
+    if (
+    // MaxRetriesPerRequestError extends AbortError; both mean "aborted because the connection is gone".
+    err.name === "MaxRetriesPerRequestError" ||
+        err.name === "AbortError" ||
+        (err.code !== undefined && CONNECTION_CODES.has(err.code)) ||
+        /connection is closed|stream isn't writeable|connection is already closed|connection ended|reached the max retries|command aborted|failed to refresh slots cache|none of (the )?startup nodes/i.test(message)) {
+        return new ConnectionError({ message, cause });
+    }
+    return new CommandError({ message, command, code: err.code ?? message.split(" ")[0], cause });
+};
+const toArg = (a) => typeof a === "string" ? a : Buffer.from(a);
+const closeQuietly = (client) => Effect.promise(() => client
+    .quit()
+    .then(() => undefined)
+    .catch(() => void client.disconnect()));
+const makeClient = (config) => Effect.acquireRelease(Effect.tryPromise({
+    try: async () => {
+        const client = config.url
+            ? new IORedisClient(config.url, { ...DEFAULTS, ...config.options })
+            : new IORedisClient({ ...DEFAULTS, ...config.options });
+        // Errors surface as command/connect rejections; a listener just prevents Node's unhandled-'error' crash.
+        client.on("error", () => { });
+        await client.connect();
+        return client;
+    },
+    catch: (cause) => new ConnectionError({ message: "ioredis: failed to connect", cause }),
+}), closeQuietly);
+const makeDedicatedClient = (config) => makeClient({ ...config, options: { ...config.options, ...DEDICATED_OVERRIDES } });
+const makeClusterClient = (config) => Effect.acquireRelease(Effect.tryPromise({
+    try: async () => {
+        const client = new Cluster([...config.nodes], { ...CLUSTER_DEFAULTS, ...config.options });
+        client.on("error", () => { });
+        await client.connect();
+        return client;
+    },
+    catch: (cause) => new ConnectionError({ message: "ioredis cluster: failed to connect", cause }),
+}), closeQuietly);
+const send = (client) => (command) => Effect.tryPromise({
+    try: () => client.sendCommand(new Command(command.name, command.args.map(toArg), { replyEncoding: "utf8" })),
+    catch: (cause) => mapError(command.name, cause),
+});
+const pipeline = (client) => (commands) => Effect.tryPromise({
+    // ioredis' batch form dispatches by JS method name (lowercase), unlike `sendCommand`.
+    try: () => client.pipeline(commands.map((c) => [c.name.toLowerCase(), ...c.args.map(toArg)])).exec(),
+    catch: (cause) => mapError("PIPELINE", cause),
+}).pipe(Effect.flatMap((results) => {
+    if (results === null)
+        return Effect.succeed([]);
+    const failed = results.find(([err]) => err != null);
+    if (failed?.[0])
+        return Effect.fail(mapError("PIPELINE", failed[0]));
+    return Effect.succeed(results.map(([, value]) => value));
+}));
+const subscribeStream = (acquire) => (channels) => Stream.asyncScoped((emit) => Effect.gen(function* () {
+    const sub = yield* acquire;
+    sub.on("message", (channel, message) => emit.single({ channel, message }));
+    sub.on("error", (cause) => emit.fail(new ConnectionError({ message: "ioredis: subscriber error", cause })));
+    yield* Effect.tryPromise({
+        try: () => sub.subscribe(...channels),
+        catch: (cause) => mapError("SUBSCRIBE", cause),
+    });
+}));
+const dedicatedStream = (acquire) => (f) => Stream.unwrapScoped(Effect.gen(function* () {
+    const client = yield* acquire;
+    // Force the socket down first (LIFO) so a blocking read aborts at once, not after quit() waits it out.
+    yield* Effect.addFinalizer(() => Effect.sync(() => client.disconnect()));
+    return f({
+        send: send(client),
+        pipeline: pipeline(client),
+        subscribe: subscribeStream(acquire),
+        dedicated: dedicatedStream(acquire),
+        close: closeQuietly(client),
+    });
+}));
+const makeConnection = (acquire, 
+// Defaults to `acquire` (cluster reuses its own client); single-node layers pass a fail-fast one.
+dedicatedAcquire = acquire) => Effect.gen(function* () {
+    const client = yield* acquire;
+    return {
+        send: send(client),
+        pipeline: pipeline(client),
+        subscribe: subscribeStream(acquire),
+        dedicated: dedicatedStream(dedicatedAcquire),
+        close: closeQuietly(client),
+    };
+});
+export var IoRedis;
+(function (IoRedis) {
+    IoRedis.layer = (config = {}) => layerConnection(makeConnection(makeClient(config), makeDedicatedClient(config)), {
+        commandTimeout: config.commandTimeout,
+    });
+    IoRedis.layerConfig = (url, config) => Layer.unwrapEffect(Effect.map(url, (resolved) => IoRedis.layer({ ...config, url: resolved })));
+    /** Pools `size` command connections; pub/sub still uses a dedicated connection. */
+    IoRedis.layerPooled = (config) => {
+        const acquire = makeClient(config);
+        return layerConnection(pooledConnection(makeConnection(acquire), config.size, subscribeStream(acquire), dedicatedStream(makeDedicatedClient(config))), { commandTimeout: config.commandTimeout });
+    };
+    /** Connects to a Redis Cluster (the client pools per-node internally, so no pooled variant).
+     *  Cross-slot multi-key commands need a shared hash tag `{…}` or they fail with `CROSSSLOT`. */
+    IoRedis.layerCluster = (config) => layerConnection(makeConnection(makeClusterClient(config)), {
+        commandTimeout: config.commandTimeout,
+    });
+})(IoRedis || (IoRedis = {}));
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@redfx/ioredis",
+  "version": "1.0.0",
+  "description": "ioredis driver adapter for redfx: the send-level port over ioredis.sendCommand, with pooling and pub/sub.",
+  "license": "MIT",
+  "author": "Alex Walker",
+  "homepage": "https://github.com/al3xanderwalker/redfx",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/al3xanderwalker/redfx.git",
+    "directory": "packages/ioredis"
+  },
+  "keywords": [
+    "effect",
+    "redis",
+    "ioredis",
+    "effect-ts"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "peerDependencies": {
+    "effect": "^3.21.0",
+    "ioredis": "^5.0.0",
+    "@redfx/core": "^1.0.0"
+  },
+  "devDependencies": {
+    "effect": "^3.21.3",
+    "ioredis": "^5.11.0",
+    "typescript": "^5.9.3",
+    "@redfx/core": "1.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}

package/src/index.ts

@@ -0,0 +1,262 @@
+import {
+  CommandError,
+  ConnectionError,
+  type ConnectionService,
+  layerConnection,
+  type PushMessage,
+  pooledConnection,
+  type Redis,
+  type RedisCommand,
+  type RedisError,
+  type RespValue,
+} from "@redfx/core";
+import {
+  type Config,
+  type ConfigError,
+  type Duration,
+  Effect,
+  Layer,
+  type Scope,
+  Stream,
+} from "effect";
+import {
+  Cluster,
+  type ClusterNode,
+  type ClusterOptions,
+  Command,
+  Redis as IORedisClient,
+  type RedisOptions,
+} from "ioredis";
+
+// Redis and Cluster share the surface the port drives, so both run the same connection logic.
+type RedisLike = IORedisClient | Cluster;
+
+export interface ClientConfig {
+  readonly url?: string;
+  readonly options?: RedisOptions;
+  /** Effect-level per-command deadline; on expiry the command fails with `TimeoutError`. */
+  readonly commandTimeout?: Duration.DurationInput;
+}
+
+export interface ClusterConfig {
+  readonly nodes: ReadonlyArray<ClusterNode>;
+  readonly options?: ClusterOptions;
+  readonly commandTimeout?: Duration.DurationInput;
+}
+
+const DEFAULTS: RedisOptions = {
+  lazyConnect: true,
+  maxRetriesPerRequest: 3,
+  retryStrategy: (times) => (times > 5 ? null : Math.min(times * 100, 2000)),
+  keepAlive: 30_000, // surface a silently-dead peer so a blocking read fails instead of hanging
+};
+
+// The consumer Stream owns reconnection (Stream.retry), so disable ioredis's own recovery: a dropped
+// XREAD must fail fast with a ConnectionError, not be silently reconnected and resent under us.
+const DEDICATED_OVERRIDES: RedisOptions = {
+  retryStrategy: () => null,
+  autoResendUnfulfilledCommands: false,
+  enableOfflineQueue: false,
+  maxRetriesPerRequest: 0,
+};
+
+const CLUSTER_DEFAULTS: ClusterOptions = {
+  lazyConnect: true,
+  redisOptions: { maxRetriesPerRequest: 3, keepAlive: 30_000 },
+};
+
+const CONNECTION_CODES = new Set([
+  "ECONNREFUSED",
+  "ECONNRESET",
+  "EPIPE",
+  "ETIMEDOUT",
+  "ENOTFOUND",
+  "EAI_AGAIN",
+  "ERR_REDIS_CONNECTION_CLOSED",
+]);
+
+const mapError = (command: string, cause: unknown): RedisError => {
+  const err = cause as { code?: string; message?: string; name?: string };
+  const message = err.message ?? String(cause);
+  if (
+    // MaxRetriesPerRequestError extends AbortError; both mean "aborted because the connection is gone".
+    err.name === "MaxRetriesPerRequestError" ||
+    err.name === "AbortError" ||
+    (err.code !== undefined && CONNECTION_CODES.has(err.code)) ||
+    /connection is closed|stream isn't writeable|connection is already closed|connection ended|reached the max retries|command aborted|failed to refresh slots cache|none of (the )?startup nodes/i.test(
+      message,
+    )
+  ) {
+    return new ConnectionError({ message, cause });
+  }
+  return new CommandError({ message, command, code: err.code ?? message.split(" ")[0], cause });
+};
+
+const toArg = (a: string | Uint8Array): string | Buffer =>
+  typeof a === "string" ? a : Buffer.from(a);
+
+const closeQuietly = (client: RedisLike): Effect.Effect<void> =>
+  Effect.promise(() =>
+    client
+      .quit()
+      .then(() => undefined)
+      .catch(() => void client.disconnect()),
+  );
+
+const makeClient = (
+  config: ClientConfig,
+): Effect.Effect<IORedisClient, ConnectionError, Scope.Scope> =>
+  Effect.acquireRelease(
+    Effect.tryPromise({
+      try: async () => {
+        const client = config.url
+          ? new IORedisClient(config.url, { ...DEFAULTS, ...config.options })
+          : new IORedisClient({ ...DEFAULTS, ...config.options });
+        // Errors surface as command/connect rejections; a listener just prevents Node's unhandled-'error' crash.
+        client.on("error", () => {});
+        await client.connect();
+        return client;
+      },
+      catch: (cause) => new ConnectionError({ message: "ioredis: failed to connect", cause }),
+    }),
+    closeQuietly,
+  );
+
+const makeDedicatedClient = (
+  config: ClientConfig,
+): Effect.Effect<IORedisClient, ConnectionError, Scope.Scope> =>
+  makeClient({ ...config, options: { ...config.options, ...DEDICATED_OVERRIDES } });
+
+const makeClusterClient = (
+  config: ClusterConfig,
+): Effect.Effect<Cluster, ConnectionError, Scope.Scope> =>
+  Effect.acquireRelease(
+    Effect.tryPromise({
+      try: async () => {
+        const client = new Cluster([...config.nodes], { ...CLUSTER_DEFAULTS, ...config.options });
+        client.on("error", () => {});
+        await client.connect();
+        return client;
+      },
+      catch: (cause) =>
+        new ConnectionError({ message: "ioredis cluster: failed to connect", cause }),
+    }),
+    closeQuietly,
+  );
+
+const send =
+  (client: RedisLike) =>
+  (command: RedisCommand): Effect.Effect<RespValue, RedisError> =>
+    Effect.tryPromise({
+      try: () =>
+        client.sendCommand(
+          new Command(command.name, command.args.map(toArg), { replyEncoding: "utf8" }),
+        ) as Promise<RespValue>,
+      catch: (cause) => mapError(command.name, cause),
+    });
+
+const pipeline =
+  (client: RedisLike) =>
+  (commands: ReadonlyArray<RedisCommand>): Effect.Effect<ReadonlyArray<RespValue>, RedisError> =>
+    Effect.tryPromise({
+      // ioredis' batch form dispatches by JS method name (lowercase), unlike `sendCommand`.
+      try: () =>
+        client.pipeline(commands.map((c) => [c.name.toLowerCase(), ...c.args.map(toArg)])).exec(),
+      catch: (cause) => mapError("PIPELINE", cause),
+    }).pipe(
+      Effect.flatMap((results) => {
+        if (results === null) return Effect.succeed<ReadonlyArray<RespValue>>([]);
+        const failed = results.find(([err]) => err != null);
+        if (failed?.[0]) return Effect.fail(mapError("PIPELINE", failed[0]));
+        return Effect.succeed(results.map(([, value]) => value as RespValue));
+      }),
+    );
+
+const subscribeStream =
+  (acquire: Effect.Effect<RedisLike, ConnectionError, Scope.Scope>) =>
+  (channels: ReadonlyArray<string>): Stream.Stream<PushMessage, RedisError> =>
+    Stream.asyncScoped<PushMessage, RedisError>((emit) =>
+      Effect.gen(function* () {
+        const sub = yield* acquire;
+        sub.on("message", (channel: string, message: string) => emit.single({ channel, message }));
+        sub.on("error", (cause) =>
+          emit.fail(new ConnectionError({ message: "ioredis: subscriber error", cause })),
+        );
+        yield* Effect.tryPromise({
+          try: () => sub.subscribe(...channels),
+          catch: (cause) => mapError("SUBSCRIBE", cause),
+        });
+      }),
+    );
+
+const dedicatedStream =
+  (
+    acquire: Effect.Effect<RedisLike, ConnectionError, Scope.Scope>,
+  ): ConnectionService["dedicated"] =>
+  (f) =>
+    Stream.unwrapScoped(
+      Effect.gen(function* () {
+        const client = yield* acquire;
+        // Force the socket down first (LIFO) so a blocking read aborts at once, not after quit() waits it out.
+        yield* Effect.addFinalizer(() => Effect.sync(() => client.disconnect()));
+        return f({
+          send: send(client),
+          pipeline: pipeline(client),
+          subscribe: subscribeStream(acquire),
+          dedicated: dedicatedStream(acquire),
+          close: closeQuietly(client),
+        });
+      }),
+    );
+
+const makeConnection = (
+  acquire: Effect.Effect<RedisLike, ConnectionError, Scope.Scope>,
+  // Defaults to `acquire` (cluster reuses its own client); single-node layers pass a fail-fast one.
+  dedicatedAcquire: Effect.Effect<RedisLike, ConnectionError, Scope.Scope> = acquire,
+): Effect.Effect<ConnectionService, ConnectionError, Scope.Scope> =>
+  Effect.gen(function* () {
+    const client = yield* acquire;
+    return {
+      send: send(client),
+      pipeline: pipeline(client),
+      subscribe: subscribeStream(acquire),
+      dedicated: dedicatedStream(dedicatedAcquire),
+      close: closeQuietly(client),
+    } satisfies ConnectionService;
+  });
+
+export namespace IoRedis {
+  export const layer = (config: ClientConfig = {}): Layer.Layer<Redis, ConnectionError> =>
+    layerConnection(makeConnection(makeClient(config), makeDedicatedClient(config)), {
+      commandTimeout: config.commandTimeout,
+    });
+
+  export const layerConfig = (
+    url: Config.Config<string>,
+    config?: Omit<ClientConfig, "url">,
+  ): Layer.Layer<Redis, ConnectionError | ConfigError.ConfigError> =>
+    Layer.unwrapEffect(Effect.map(url, (resolved) => layer({ ...config, url: resolved })));
+
+  /** Pools `size` command connections; pub/sub still uses a dedicated connection. */
+  export const layerPooled = (
+    config: ClientConfig & { readonly size: number },
+  ): Layer.Layer<Redis, ConnectionError> => {
+    const acquire = makeClient(config);
+    return layerConnection(
+      pooledConnection(
+        makeConnection(acquire),
+        config.size,
+        subscribeStream(acquire),
+        dedicatedStream(makeDedicatedClient(config)),
+      ),
+      { commandTimeout: config.commandTimeout },
+    );
+  };
+
+  /** Connects to a Redis Cluster (the client pools per-node internally, so no pooled variant).
+   *  Cross-slot multi-key commands need a shared hash tag `{…}` or they fail with `CROSSSLOT`. */
+  export const layerCluster = (config: ClusterConfig): Layer.Layer<Redis, ConnectionError> =>
+    layerConnection(makeConnection(makeClusterClient(config)), {
+      commandTimeout: config.commandTimeout,
+    });
+}