@redfx/bun 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,30 @@
+# @redfx/bun
+
+[Bun](https://bun.sh) driver for [@redfx/core](https://www.npmjs.com/package/@redfx/core). It implements the
+`send`-level port over Bun's native `RedisClient` (`Bun.redis`), with pub/sub delivered as a `Stream`.
+
+```ts
+import { Redis } from "@redfx/core"
+import { BunRedis } from "@redfx/bun"
+import { Config } from "effect"
+
+const RedisLive = BunRedis.layerConfig(Config.string("REDIS_URL"))
+// BunRedis.layer({ url, options, commandTimeout })   single connection
+// BunRedis.layerPooled({ url, size: 10 })            pooled commands, dedicated pub/sub
+```
+
+Requires the Bun runtime. Peer dependencies: `effect`, `@redfx/core`.
+
+A few Bun-specific notes:
+
+- `EXISTS` returns a boolean on Bun where ioredis returns 0/1; redfx normalises this so the command
+  surface (`exists` returns `boolean`) matches across adapters.
+- Bun retries a lost connection with backoff before a command rejects (around 30s by default). If
+  you rely on the `catchTag("ConnectionError")` fail-open pattern, set tighter client options or a
+  `commandTimeout`, e.g. `BunRedis.layer({ url, commandTimeout: "2 seconds" })`.
+- Values are treated as UTF-8 text for now: byte args are decoded with `TextDecoder` and replies
+  come back as strings, so non-UTF-8 binary won't round-trip. Use base64 for binary payloads.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import { ConnectionError, type Redis } from "@redfx/core";
+import { RedisClient } from "bun";
+import { type Config, type ConfigError, type Duration, Layer } from "effect";
+type BunRedisOptions = ConstructorParameters<typeof RedisClient>[1];
+export interface ClientConfig {
+    readonly url?: string;
+    readonly options?: BunRedisOptions;
+    /** Effect-level per-command deadline; on expiry the command fails with `TimeoutError`. */
+    readonly commandTimeout?: Duration.DurationInput;
+}
+export declare namespace BunRedis {
+    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 uses a dedicated connection. */
+    const layerPooled: (config: ClientConfig & {
+        readonly size: number;
+    }) => Layer.Layer<Redis, ConnectionError>;
+}
+export {};
+//# 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,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAClC,OAAO,EACL,KAAK,MAAM,EACX,KAAK,WAAW,EAChB,KAAK,QAAQ,EAEb,KAAK,EAGN,MAAM,QAAQ,CAAC;AAEhB,KAAK,eAAe,GAAG,qBAAqB,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AAEpE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,0FAA0F;IAC1F,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC;CAClD;AA6HD,yBAAiB,QAAQ,CAAC;IACjB,MAAM,KAAK,GAAI,SAAQ,YAAiB,KAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,eAAe,CACA,CAAC;IAE9E,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,6EAA6E;IACtE,MAAM,WAAW,GACtB,QAAQ,YAAY,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAC/C,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,eAAe,CAWlC,CAAC;CACL"}

package/dist/index.js

@@ -0,0 +1,88 @@
+import { CommandError, ConnectionError, layerConnection, pooledConnection, } from "@redfx/core";
+import { RedisClient } from "bun";
+import { Effect, Layer, Stream, } from "effect";
+const textDecoder = new TextDecoder();
+const toStr = (a) => typeof a === "string" ? a : textDecoder.decode(a);
+const CONNECTION_CODES = new Set([
+    "ERR_REDIS_CONNECTION_CLOSED",
+    "ECONNREFUSED",
+    "ECONNRESET",
+    "ETIMEDOUT",
+    "ENOTFOUND",
+]);
+const mapError = (command, cause) => {
+    const err = cause;
+    const message = err.message ?? String(cause);
+    if ((err.code !== undefined && CONNECTION_CODES.has(err.code)) ||
+        /connection (is )?closed|connection refused|ERR_REDIS_CONNECTION_CLOSED/i.test(message)) {
+        return new ConnectionError({ message, cause });
+    }
+    return new CommandError({ message, command, code: err.code ?? message.split(" ")[0], cause });
+};
+const makeClient = (config) => Effect.acquireRelease(Effect.tryPromise({
+    try: async () => {
+        const client = new RedisClient(config.url, config.options);
+        await client.connect();
+        return client;
+    },
+    catch: (cause) => new ConnectionError({ message: "bun: failed to connect", cause }),
+}), (client) => Effect.sync(() => client.close()));
+const send = (client) => (command) => Effect.tryPromise({
+    try: () => client.send(command.name, command.args.map(toStr)),
+    catch: (cause) => mapError(command.name, cause),
+});
+// Bun auto-pipelines concurrent sends, so Promise.all is a real pipeline on the wire (order preserved).
+const pipeline = (client) => (commands) => Effect.tryPromise({
+    try: () => Promise.all(commands.map((c) => client.send(c.name, c.args.map(toStr)))),
+    catch: (cause) => mapError("PIPELINE", cause),
+});
+const subscribeStream = (config) => (channels) => Stream.asyncScoped((emit) => Effect.gen(function* () {
+    const sub = yield* makeClient(config);
+    // Surface an unexpected drop; the finalizer (runs before our own close) suppresses teardown.
+    let active = true;
+    yield* Effect.addFinalizer(() => Effect.sync(() => {
+        active = false;
+    }));
+    sub.onclose = (cause) => {
+        if (active)
+            emit.fail(new ConnectionError({ message: "bun: subscriber connection closed", cause }));
+    };
+    const listener = (message, channel) => emit.single({ channel, message });
+    yield* Effect.forEach(channels, (channel) => Effect.tryPromise({
+        try: () => sub.subscribe(channel, listener),
+        catch: (cause) => mapError("SUBSCRIBE", cause),
+    }));
+}));
+// redfx owns reconnection here (pool invalidation / Stream.retry), so disable bun's: otherwise a
+// killed connection silently queues/resends and hangs in-flight commands instead of failing fast.
+const failFastConfig = (config) => ({
+    ...config,
+    options: { ...config.options, autoReconnect: false, enableOfflineQueue: false },
+});
+const dedicatedStream = (config) => (f) => Stream.unwrapScoped(Effect.map(makeClient(failFastConfig(config)), (client) => f({
+    send: send(client),
+    pipeline: pipeline(client),
+    subscribe: subscribeStream(config),
+    dedicated: dedicatedStream(config),
+    close: Effect.sync(() => client.close()),
+})));
+const makeConnection = (config) => Effect.gen(function* () {
+    const client = yield* makeClient(config);
+    return {
+        send: send(client),
+        pipeline: pipeline(client),
+        subscribe: subscribeStream(config),
+        dedicated: dedicatedStream(config),
+        close: Effect.sync(() => client.close()),
+    };
+});
+export var BunRedis;
+(function (BunRedis) {
+    BunRedis.layer = (config = {}) => layerConnection(makeConnection(config), { commandTimeout: config.commandTimeout });
+    BunRedis.layerConfig = (url, config) => Layer.unwrapEffect(Effect.map(url, (resolved) => BunRedis.layer({ ...config, url: resolved })));
+    /** Pools `size` command connections; pub/sub uses a dedicated connection. */
+    BunRedis.layerPooled = (config) => layerConnection(pooledConnection(makeConnection(failFastConfig(config)), config.size, subscribeStream(config), dedicatedStream(config)), {
+        commandTimeout: config.commandTimeout,
+    });
+})(BunRedis || (BunRedis = {}));
+//# 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,52 @@
+{
+  "name": "@redfx/bun",
+  "version": "1.0.0",
+  "description": "Bun driver adapter for redfx: the send-level port over Bun's native RedisClient, with pub/sub as a Stream.",
+  "license": "MIT",
+  "author": "Alex Walker",
+  "homepage": "https://github.com/al3xanderwalker/redfx",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/al3xanderwalker/redfx.git",
+    "directory": "packages/bun"
+  },
+  "keywords": [
+    "effect",
+    "redis",
+    "bun",
+    "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",
+    "@redfx/core": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.2.0",
+    "effect": "^3.21.3",
+    "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,181 @@
+import {
+  CommandError,
+  ConnectionError,
+  type ConnectionService,
+  layerConnection,
+  type PushMessage,
+  pooledConnection,
+  type Redis,
+  type RedisCommand,
+  type RedisError,
+  type RespValue,
+} from "@redfx/core";
+import { RedisClient } from "bun";
+import {
+  type Config,
+  type ConfigError,
+  type Duration,
+  Effect,
+  Layer,
+  type Scope,
+  Stream,
+} from "effect";
+
+type BunRedisOptions = ConstructorParameters<typeof RedisClient>[1];
+
+export interface ClientConfig {
+  readonly url?: string;
+  readonly options?: BunRedisOptions;
+  /** Effect-level per-command deadline; on expiry the command fails with `TimeoutError`. */
+  readonly commandTimeout?: Duration.DurationInput;
+}
+
+const textDecoder = new TextDecoder();
+const toStr = (a: string | Uint8Array): string =>
+  typeof a === "string" ? a : textDecoder.decode(a);
+
+const CONNECTION_CODES = new Set([
+  "ERR_REDIS_CONNECTION_CLOSED",
+  "ECONNREFUSED",
+  "ECONNRESET",
+  "ETIMEDOUT",
+  "ENOTFOUND",
+]);
+
+const mapError = (command: string, cause: unknown): RedisError => {
+  const err = cause as { code?: string; message?: string };
+  const message = err.message ?? String(cause);
+  if (
+    (err.code !== undefined && CONNECTION_CODES.has(err.code)) ||
+    /connection (is )?closed|connection refused|ERR_REDIS_CONNECTION_CLOSED/i.test(message)
+  ) {
+    return new ConnectionError({ message, cause });
+  }
+  return new CommandError({ message, command, code: err.code ?? message.split(" ")[0], cause });
+};
+
+const makeClient = (
+  config: ClientConfig,
+): Effect.Effect<RedisClient, ConnectionError, Scope.Scope> =>
+  Effect.acquireRelease(
+    Effect.tryPromise({
+      try: async () => {
+        const client = new RedisClient(config.url, config.options);
+        await client.connect();
+        return client;
+      },
+      catch: (cause) => new ConnectionError({ message: "bun: failed to connect", cause }),
+    }),
+    (client) => Effect.sync(() => client.close()),
+  );
+
+const send =
+  (client: RedisClient) =>
+  (command: RedisCommand): Effect.Effect<RespValue, RedisError> =>
+    Effect.tryPromise({
+      try: () =>
+        client.send(command.name, command.args.map(toStr)) as unknown as Promise<RespValue>,
+      catch: (cause) => mapError(command.name, cause),
+    });
+
+// Bun auto-pipelines concurrent sends, so Promise.all is a real pipeline on the wire (order preserved).
+const pipeline =
+  (client: RedisClient) =>
+  (commands: ReadonlyArray<RedisCommand>): Effect.Effect<ReadonlyArray<RespValue>, RedisError> =>
+    Effect.tryPromise({
+      try: () =>
+        Promise.all(
+          commands.map((c) => client.send(c.name, c.args.map(toStr))),
+        ) as unknown as Promise<ReadonlyArray<RespValue>>,
+      catch: (cause) => mapError("PIPELINE", cause),
+    });
+
+const subscribeStream =
+  (config: ClientConfig) =>
+  (channels: ReadonlyArray<string>): Stream.Stream<PushMessage, RedisError> =>
+    Stream.asyncScoped<PushMessage, RedisError>((emit) =>
+      Effect.gen(function* () {
+        const sub = yield* makeClient(config);
+        // Surface an unexpected drop; the finalizer (runs before our own close) suppresses teardown.
+        let active = true;
+        yield* Effect.addFinalizer(() =>
+          Effect.sync(() => {
+            active = false;
+          }),
+        );
+        sub.onclose = (cause) => {
+          if (active)
+            emit.fail(new ConnectionError({ message: "bun: subscriber connection closed", cause }));
+        };
+        const listener = (message: string, channel: string) => emit.single({ channel, message });
+        yield* Effect.forEach(channels, (channel) =>
+          Effect.tryPromise({
+            try: () => sub.subscribe(channel, listener),
+            catch: (cause) => mapError("SUBSCRIBE", cause),
+          }),
+        );
+      }),
+    );
+
+// redfx owns reconnection here (pool invalidation / Stream.retry), so disable bun's: otherwise a
+// killed connection silently queues/resends and hangs in-flight commands instead of failing fast.
+const failFastConfig = (config: ClientConfig): ClientConfig => ({
+  ...config,
+  options: { ...config.options, autoReconnect: false, enableOfflineQueue: false },
+});
+
+const dedicatedStream =
+  (config: ClientConfig): ConnectionService["dedicated"] =>
+  (f) =>
+    Stream.unwrapScoped(
+      Effect.map(makeClient(failFastConfig(config)), (client) =>
+        f({
+          send: send(client),
+          pipeline: pipeline(client),
+          subscribe: subscribeStream(config),
+          dedicated: dedicatedStream(config),
+          close: Effect.sync(() => client.close()),
+        }),
+      ),
+    );
+
+const makeConnection = (
+  config: ClientConfig,
+): Effect.Effect<ConnectionService, ConnectionError, Scope.Scope> =>
+  Effect.gen(function* () {
+    const client = yield* makeClient(config);
+    return {
+      send: send(client),
+      pipeline: pipeline(client),
+      subscribe: subscribeStream(config),
+      dedicated: dedicatedStream(config),
+      close: Effect.sync(() => client.close()),
+    } satisfies ConnectionService;
+  });
+
+export namespace BunRedis {
+  export const layer = (config: ClientConfig = {}): Layer.Layer<Redis, ConnectionError> =>
+    layerConnection(makeConnection(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 uses a dedicated connection. */
+  export const layerPooled = (
+    config: ClientConfig & { readonly size: number },
+  ): Layer.Layer<Redis, ConnectionError> =>
+    layerConnection(
+      pooledConnection(
+        makeConnection(failFastConfig(config)),
+        config.size,
+        subscribeStream(config),
+        dedicatedStream(config),
+      ),
+      {
+        commandTimeout: config.commandTimeout,
+      },
+    );
+}