@mhbdev/redis 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## 0.2.0
+
+### Minor Changes
+
+- Add the typed Redis client, pooling, rate limiting, cache, locks, pub/sub, and reliable queue toolkit.
+
+All notable changes to this project will be documented in this file.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mhbdev
+
+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,173 @@
+# `@mhbdev/redis`
+
+Typed Redis infrastructure for Node.js 20+ and Bun. The package provides a managed
+node-redis client, connection pools, atomic rate limiting, typed caching, distributed
+locks, pub/sub, and reliable at-least-once queues.
+
+## Install
+
+```sh
+npm install @mhbdev/redis
+```
+
+## Client and pooling
+
+```ts
+import { createRedisClient, createRedisPool, withRedisClient } from "@mhbdev/redis";
+
+await withRedisClient(
+  { url: process.env.REDIS_URL!, commandTimeoutMs: 3_000 },
+  async (redis) => {
+    await redis.execute(["SET", "health", "ok"]);
+    await redis.ping();
+  },
+);
+
+// Long-lived services can keep the client and close it during shutdown.
+const redis = createRedisClient({ url: process.env.REDIS_URL! });
+await redis.execute(["SET", "key", "value"]); // connects lazily
+
+const pool = createRedisPool({
+  url: process.env.REDIS_URL!,
+  minimum: 1,
+  maximum: 10,
+  acquireTimeoutMs: 3_000,
+});
+
+await pool.execute(["SET", "key", "value"]);
+await pool.close();
+await redis.close();
+```
+
+Use `pool.use(async (client) => ...)` when a sequence must run on one exclusive
+leased node-redis connection. `minimum`, `maximum`, and `acquireTimeoutMs` bound
+resource usage; `withRedisPool` provides the same scoped lifecycle helper as the
+client helper.
+
+The high-level APIs use typed transport contracts. Node users can use `raw()` when a
+command or Redis module is intentionally outside this package's focused abstractions.
+Custom adapters can implement `RedisExecutor` for other runtimes.
+
+### Adapter choices
+
+The feature modules depend on `RedisExecutor`, so an existing client can be swapped
+without changing cache, limiter, lock, or queue code:
+
+```ts
+import Redis from "ioredis";
+import { createIoredisExecutor } from "@mhbdev/redis/ioredis";
+
+const redis = createIoredisExecutor(new Redis(process.env.REDIS_URL!));
+```
+
+Install `ioredis` only when choosing that adapter:
+
+```sh
+npm install ioredis
+```
+
+Redis-backed queues and BullMQ share the typed `JobQueue` / `QueueWorker` contracts.
+Use `createBullMqQueueAdapter` with an existing BullMQ `Queue` and an injected worker
+factory when BullMQ's scheduling and retry model is preferred. Install `bullmq` only
+for that integration.
+
+## Rate limiting
+
+```ts
+import { createRateLimiter, fixedWindow } from "@mhbdev/redis/rate-limit";
+import { createRedisClient } from "@mhbdev/redis";
+
+const redis = createRedisClient({ url: process.env.REDIS_URL! });
+const limiter = createRateLimiter(fixedWindow(10, 60_000), {
+  redis,
+  prefix: "api",
+  ephemeralCache: true,
+});
+
+const result = await limiter.limit("user-123");
+if (!result.success) {
+  console.log(`Retry in ${result.retryAfterMs}ms`);
+}
+```
+
+Use `slidingWindow(limit, windowMs)` when boundary bursts matter, or
+`tokenBucket(refillRate, intervalMs, maxTokens)` when bursts should be smoothed.
+Rate-limit identifiers are hashed before becoming keys. Redis failures are closed by
+default; use `failureMode: "open"` only when availability is more important than
+strict enforcement.
+
+## Cache, locks, pub/sub, and queues
+
+```ts
+import { createCache, createLockManager, jsonCodec } from "@mhbdev/redis";
+
+const cache = createCache<User>({ redis, prefix: "users" }); // JSON by default
+const binaryCache = createCache({ redis, codec: jsonCodec<User>(), prefix: "users" });
+const user = await cache.getOrSet("42", () => loadUser("42"), { ttlMs: 60_000 });
+
+const locks = createLockManager({ redis });
+await locks.withLock("user:42", async () => updateUser(user));
+```
+
+Queues use Redis Streams and consumer groups. Delivery is at-least-once: handlers must
+be idempotent. Queue and pub/sub factories also use JSON by default and accept a custom
+`RedisCodec<T>` when the payload is binary or must be schema-validated. The public
+factory aliases `createRedisCache`, `createRedisQueue`, `createRedisPubSub`, and
+`createRedisRateLimiter` are available for codebases that prefer explicit names.
+
+## Typed failures
+
+Operational failures are represented by exported error classes and stable `code` values;
+application code never needs to inspect error messages:
+
+```ts
+import {
+  RedisProtocolError,
+  RedisTimeoutError,
+  RedisUnavailableError,
+} from "@mhbdev/redis";
+
+try {
+  await redis.ping();
+} catch (error) {
+  if (error instanceof RedisTimeoutError) return retryLater();
+  if (error instanceof RedisUnavailableError) return failOpenForThisFeature();
+  if (error instanceof RedisProtocolError) return reportProtocolFailure(error);
+  throw error;
+}
+```
+
+All causes are preserved on typed errors. Causes are never used for semantic handling by
+message matching, and sensitive command arguments and payloads are not copied into error
+messages.
+
+## Development
+
+```sh
+npm install
+npm run lint
+npm run typecheck
+npm test
+npm run build
+npm run pack:check
+```
+
+Live Redis tests are separate from the unit suite. Run them with a local Redis service:
+
+```sh
+npm run test:integration
+```
+
+## Documentation
+
+- [Architecture](docs/architecture.md)
+- [Rate limiting](docs/rate-limiting.md)
+- [Queues](docs/queues.md)
+- [Adapter bridges](docs/adapters.md)
+- [Errors and failure handling](docs/errors.md)
+- [Releasing to npm](docs/releasing.md)
+- [Migration from `@dordoone/redis-runtime`](docs/migration.md)
+
+## License
+
+MIT © 2026 mhbdev

package/dist/bullmq/adapter.d.ts

@@ -0,0 +1,49 @@
+import { type RedisCodec } from "../core/codec.js";
+import type { EnqueueOptions, QueueJob, QueueWorker, QueueWorkerOptions } from "../queue/queue.js";
+export interface BullMqQueueLike {
+    add(name: string, data: unknown, options?: Readonly<{
+        delay?: number;
+        jobId?: string;
+        attempts?: number;
+    }>): Promise<{
+        id?: string | number;
+    }>;
+    close?(): Promise<void>;
+}
+export interface BullMqJobLike {
+    id?: string | number;
+    data: unknown;
+}
+export interface BullMqWorkerLike {
+    close(): Promise<void>;
+}
+export type BullMqWorkerFactory = (name: string, processor: (job: BullMqJobLike) => Promise<void>, options?: QueueWorkerOptions) => BullMqWorkerLike;
+export declare class BullMqQueueAdapter<T> {
+    private readonly queue;
+    private readonly options;
+    private readonly jobName;
+    constructor(queue: BullMqQueueLike, options: Readonly<{
+        codec?: RedisCodec<T>;
+        jobName?: string;
+        maxAttempts?: number;
+        workerFactory?: BullMqWorkerFactory;
+    }>);
+    private readonly codec;
+    enqueue(data: T, enqueueOptions?: EnqueueOptions): Promise<string>;
+    worker(handler: (job: QueueJob<T>) => Promise<void>, workerOptions?: QueueWorkerOptions): BullMqWorkerAdapter;
+    close(): Promise<void>;
+    private decodeJob;
+}
+export declare class BullMqWorkerAdapter implements QueueWorker {
+    private readonly worker;
+    constructor(worker: BullMqWorkerLike);
+    start(): Promise<void>;
+    close(): Promise<void>;
+}
+export declare function createBullMqQueueAdapter<T>(queue: BullMqQueueLike, options: Readonly<{
+    codec?: RedisCodec<T>;
+    jobName?: string;
+    maxAttempts?: number;
+    workerFactory?: BullMqWorkerFactory;
+}>): BullMqQueueAdapter<T>;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/bullmq/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/bullmq/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,KAAK,EACX,cAAc,EACd,QAAQ,EACR,WAAW,EACX,kBAAkB,EAClB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,eAAe;IAC/B,GAAG,CACF,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,QAAQ,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GACvE,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC7B,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAChC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,MAAM,mBAAmB,GAAG,CACjC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,EAChD,OAAO,CAAC,EAAE,kBAAkB,KACxB,gBAAgB,CAAC;AAEtB,qBAAa,kBAAkB,CAAC,CAAC;IAI/B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,YACkB,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,QAAQ,CAAC;QAClC,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,mBAAmB,CAAC;KACpC,CAAC,EAIF;IAED,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IAEhC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,cAAc,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAO3E;IAED,MAAM,CACL,OAAO,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAC5C,aAAa,GAAE,kBAAuB,GACpC,mBAAmB,CAWrB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;IAED,OAAO,CAAC,SAAS;CASjB;AAED,qBAAa,mBAAoB,YAAW,WAAW;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAnC,YAA6B,MAAM,EAAE,gBAAgB,EAAI;IAEzD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAErB;IAED,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAErB;CACD;AAED,wBAAgB,wBAAwB,CAAC,CAAC,EACzC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,QAAQ,CAAC;IACjB,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACpC,CAAC,GACA,kBAAkB,CAAC,CAAC,CAAC,CAEvB"}

package/dist/bullmq/adapter.js

@@ -0,0 +1,56 @@
+import { jsonCodec } from "../core/codec.js";
+import { RedisConfigurationError } from "../core/errors.js";
+export class BullMqQueueAdapter {
+    queue;
+    options;
+    jobName;
+    constructor(queue, options) {
+        this.queue = queue;
+        this.options = options;
+        this.jobName = options.jobName ?? "job";
+        this.codec = options.codec ?? jsonCodec();
+    }
+    codec;
+    async enqueue(data, enqueueOptions = {}) {
+        const job = await this.queue.add(this.jobName, this.codec.encode(data), {
+            delay: enqueueOptions.delayMs,
+            jobId: enqueueOptions.jobId,
+            attempts: this.options.maxAttempts,
+        });
+        return String(job.id ?? enqueueOptions.jobId ?? crypto.randomUUID());
+    }
+    worker(handler, workerOptions = {}) {
+        if (!this.options.workerFactory)
+            throw new RedisConfigurationError("A BullMQ workerFactory is required to create workers");
+        const worker = this.options.workerFactory(this.jobName, async (job) => handler(this.decodeJob(job)), workerOptions);
+        return new BullMqWorkerAdapter(worker);
+    }
+    async close() {
+        await this.queue.close?.();
+    }
+    decodeJob(job) {
+        const encoded = typeof job.data === "string" ? job.data : JSON.stringify(job.data);
+        return {
+            id: String(job.id ?? crypto.randomUUID()),
+            data: this.codec.decode(encoded),
+            attempts: 0,
+            enqueuedAt: Date.now(),
+        };
+    }
+}
+export class BullMqWorkerAdapter {
+    worker;
+    constructor(worker) {
+        this.worker = worker;
+    }
+    start() {
+        return Promise.resolve();
+    }
+    close() {
+        return this.worker.close();
+    }
+}
+export function createBullMqQueueAdapter(queue, options) {
+    return new BullMqQueueAdapter(queue, options);
+}
+//# sourceMappingURL=adapter.js.map

package/dist/bullmq/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/bullmq/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAmB,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAgC5D,MAAM,OAAO,kBAAkB;IAIZ,KAAK;IACL,OAAO;IAJR,OAAO,CAAS;IAEjC,YACkB,KAAsB,EACtB,OAKf;qBANe,KAAK;uBACL,OAAO;QAOxB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC;QACxC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,SAAS,EAAK,CAAC;IAC9C,CAAC;IAEgB,KAAK,CAAgB;IAEtC,KAAK,CAAC,OAAO,CAAC,IAAO,EAAE,cAAc,GAAmB,EAAE;QACzD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;YACvE,KAAK,EAAE,cAAc,CAAC,OAAO;YAC7B,KAAK,EAAE,cAAc,CAAC,KAAK;YAC3B,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW;SAClC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,cAAc,CAAC,KAAK,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,CACL,OAA4C,EAC5C,aAAa,GAAuB,EAAE;QAEtC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa;YAC9B,MAAM,IAAI,uBAAuB,CAChC,sDAAsD,CACtD,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CACxC,IAAI,CAAC,OAAO,EACZ,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAC3C,aAAa,CACb,CAAC;QACF,OAAO,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,KAAK;QACV,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IAC5B,CAAC;IAEO,SAAS,CAAC,GAAkB;QACnC,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnF,OAAO;YACN,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACzC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;YAChC,QAAQ,EAAE,CAAC;YACX,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;IACH,CAAC;CACD;AAED,MAAM,OAAO,mBAAmB;IACF,MAAM;IAAnC,YAA6B,MAAwB;sBAAxB,MAAM;IAAqB,CAAC;IAEzD,KAAK;QACJ,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC;IAED,KAAK;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;CACD;AAED,MAAM,UAAU,wBAAwB,CACvC,KAAsB,EACtB,OAKE;IAEF,OAAO,IAAI,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC"}

package/dist/bullmq/index.d.ts

@@ -0,0 +1,3 @@
+export type { BullMqJobLike, BullMqQueueLike, BullMqWorkerFactory, BullMqWorkerLike, } from "./adapter.js";
+export { BullMqQueueAdapter, BullMqWorkerAdapter, createBullMqQueueAdapter, } from "./adapter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/bullmq/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bullmq/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,gBAAgB,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,GACxB,MAAM,cAAc,CAAC"}

package/dist/bullmq/index.js

@@ -0,0 +1,2 @@
+export { BullMqQueueAdapter, BullMqWorkerAdapter, createBullMqQueueAdapter, } from "./adapter.js";
+//# sourceMappingURL=index.js.map

package/dist/bullmq/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bullmq/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACN,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,GACxB,MAAM,cAAc,CAAC"}

package/dist/cache/cache.d.ts

@@ -0,0 +1,31 @@
+import { type RedisCodec } from "../core/codec.js";
+import type { RedisExecutor } from "../core/executor.js";
+export type CacheSetOptions = Readonly<{
+    ttlMs?: number;
+    onlyIfAbsent?: boolean;
+    onlyIfPresent?: boolean;
+}>;
+export type RedisCacheOptions<T> = Readonly<{
+    redis: RedisExecutor;
+    /** JSON is used by default. Provide a codec for binary or schema-validated values. */
+    codec?: RedisCodec<T>;
+    prefix?: string;
+    maxKeyLength?: number;
+}>;
+export declare class RedisCache<T> {
+    private readonly options;
+    private readonly prefix;
+    private readonly codec;
+    private readonly pending;
+    constructor(options: RedisCacheOptions<T>);
+    get(key: string): Promise<T | undefined>;
+    set(key: string, value: T, options?: CacheSetOptions): Promise<boolean>;
+    delete(key: string): Promise<boolean>;
+    exists(key: string): Promise<boolean>;
+    getOrSet(key: string, factory: () => Promise<T>, options?: CacheSetOptions): Promise<T>;
+    private key;
+}
+export declare function createCache<T>(options: RedisCacheOptions<T>): RedisCache<T>;
+/** A discoverable alias for applications that prefer Redis-prefixed factory names. */
+export declare const createRedisCache: typeof createCache;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/cache/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,QAAQ,CAAC;IAC3C,KAAK,EAAE,aAAa,CAAC;IACrB,sFAAsF;IACtF,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC,CAAC;AAEH,qBAAa,UAAU,CAAC,CAAC;IAKZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IAErE,YAA6B,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAKzD;IAEK,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAS7C;IAEK,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAYhF;IAEK,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE1C;IAEK,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE1C;IAEK,QAAQ,CACb,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,OAAO,GAAE,eAAoB,GAC3B,OAAO,CAAC,CAAC,CAAC,CAaZ;IAED,OAAO,CAAC,GAAG;CASX;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAE3E;AAED,sFAAsF;AACtF,eAAO,MAAM,gBAAgB,oBAAc,CAAC"}

package/dist/cache/cache.js

@@ -0,0 +1,78 @@
+import { jsonCodec } from "../core/codec.js";
+import { RedisConfigurationError, RedisSerializationError } from "../core/errors.js";
+export class RedisCache {
+    options;
+    prefix;
+    codec;
+    pending = new Map();
+    constructor(options) {
+        this.options = options;
+        this.prefix = options.prefix ?? "mhbdev:cache";
+        this.codec = options.codec ?? jsonCodec();
+        if (!this.prefix.trim())
+            throw new RedisConfigurationError("Cache prefix is required");
+    }
+    async get(key) {
+        const value = await this.options.redis.execute(["GET", this.key(key)]);
+        if (value === null)
+            return undefined;
+        try {
+            return this.codec.decode(value);
+        }
+        catch (error) {
+            if (error instanceof RedisSerializationError)
+                throw error;
+            throw new RedisSerializationError("Unable to decode cached value", error);
+        }
+    }
+    async set(key, value, options = {}) {
+        const encoded = this.codec.encode(value);
+        const command = ["SET", this.key(key), encoded];
+        if (options.ttlMs !== undefined) {
+            if (!Number.isSafeInteger(options.ttlMs) || options.ttlMs <= 0)
+                throw new RedisConfigurationError("Cache TTL must be positive");
+            command.push("PX", String(options.ttlMs));
+        }
+        if (options.onlyIfAbsent)
+            command.push("NX");
+        if (options.onlyIfPresent)
+            command.push("XX");
+        const result = await this.options.redis.execute(command);
+        return result === "OK";
+    }
+    async delete(key) {
+        return (await this.options.redis.execute(["DEL", this.key(key)])) > 0;
+    }
+    async exists(key) {
+        return (await this.options.redis.execute(["EXISTS", this.key(key)])) > 0;
+    }
+    async getOrSet(key, factory, options = {}) {
+        const existing = await this.get(key);
+        if (existing !== undefined)
+            return existing;
+        const pending = this.pending.get(key);
+        if (pending)
+            return (await pending);
+        const operation = factory()
+            .then(async (value) => {
+            await this.set(key, value, options);
+            return value;
+        })
+            .finally(() => this.pending.delete(key));
+        this.pending.set(key, operation);
+        return operation;
+    }
+    key(key) {
+        if (!key.trim() ||
+            key.length > (this.options.maxKeyLength ?? 512) ||
+            key.includes("\n"))
+            throw new RedisConfigurationError("Cache key is invalid");
+        return `${this.prefix}:${key}`;
+    }
+}
+export function createCache(options) {
+    return new RedisCache(options);
+}
+/** A discoverable alias for applications that prefer Redis-prefixed factory names. */
+export const createRedisCache = createCache;
+//# sourceMappingURL=cache.js.map

package/dist/cache/cache.js.map

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

package/dist/cache/index.d.ts

@@ -0,0 +1,3 @@
+export type { CacheSetOptions, RedisCacheOptions } from "./cache.js";
+export { createCache, createRedisCache, RedisCache } from "./cache.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/cache/index.js

@@ -0,0 +1,2 @@
+export { createCache, createRedisCache, RedisCache } from "./cache.js";
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/codec.d.ts

@@ -0,0 +1,7 @@
+export interface RedisCodec<T> {
+    encode(value: T): string;
+    decode(value: string): T;
+}
+export declare const jsonCodec: <T>() => RedisCodec<T>;
+export declare const stringCodec: RedisCodec<string>;
+//# sourceMappingURL=codec.d.ts.map

package/dist/core/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../src/core/codec.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU,CAAC,CAAC;IAC5B,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC;IACzB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC;CACzB;AAED,eAAO,MAAM,SAAS,GAAI,CAAC,OAAK,UAAU,CAAC,CAAC,CAe1C,CAAC;AAEH,eAAO,MAAM,WAAW,EAAE,UAAU,CAAC,MAAM,CAG1C,CAAC"}

package/dist/core/codec.js

@@ -0,0 +1,24 @@
+import { RedisSerializationError } from "./errors.js";
+export const jsonCodec = () => ({
+    encode(value) {
+        try {
+            return JSON.stringify(value);
+        }
+        catch (error) {
+            throw new RedisSerializationError("Unable to encode Redis value", error);
+        }
+    },
+    decode(value) {
+        try {
+            return JSON.parse(value);
+        }
+        catch (error) {
+            throw new RedisSerializationError("Unable to decode Redis value", error);
+        }
+    },
+});
+export const stringCodec = {
+    encode: (value) => value,
+    decode: (value) => value,
+};
+//# sourceMappingURL=codec.js.map

package/dist/core/codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.js","sourceRoot":"","sources":["../../src/core/codec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAOtD,MAAM,CAAC,MAAM,SAAS,GAAG,GAAqB,EAAE,CAAC,CAAC;IACjD,MAAM,CAAC,KAAK;QACX,IAAI,CAAC;YACJ,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,uBAAuB,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;QAC1E,CAAC;IACF,CAAC;IACD,MAAM,CAAC,KAAK;QACX,IAAI,CAAC;YACJ,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAM,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,uBAAuB,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;QAC1E,CAAC;IACF,CAAC;CACD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAuB;IAC9C,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK;IACxB,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK;CACxB,CAAC"}

package/dist/core/errors.d.ts

@@ -0,0 +1,43 @@
+export type RedisErrorCode = "REDIS_CONFIGURATION_ERROR" | "REDIS_CONNECTION_ERROR" | "REDIS_TIMEOUT" | "REDIS_ABORTED" | "REDIS_UNAVAILABLE" | "REDIS_CLIENT_STATE" | "REDIS_PROTOCOL_ERROR" | "REDIS_SERIALIZATION_ERROR" | "REDIS_LOCK_ERROR" | "REDIS_QUEUE_ERROR";
+export declare class RedisError extends Error {
+    readonly code: RedisErrorCode;
+    readonly isOperational: boolean;
+    readonly cause: unknown;
+    constructor(code: RedisErrorCode, message: string, cause?: unknown, isOperational?: boolean);
+}
+export declare class RedisConfigurationError extends RedisError {
+    constructor(message: string, cause?: unknown);
+}
+export declare class RedisConnectionError extends RedisError {
+    constructor(message?: string, cause?: unknown);
+}
+export declare class RedisTimeoutError extends RedisError {
+    constructor(message?: string, cause?: unknown);
+}
+export declare class RedisRequestAbortedError extends RedisError {
+    constructor(cause?: unknown);
+}
+export declare class RedisUnavailableError extends RedisError {
+    constructor(cause?: unknown);
+}
+export declare class RedisClientStateError extends RedisError {
+    constructor(message?: string);
+}
+export declare class RedisProtocolError extends RedisError {
+    constructor(message?: string, cause?: unknown);
+}
+export declare class RedisSerializationError extends RedisError {
+    constructor(message?: string, cause?: unknown);
+}
+export declare class RedisLockError extends RedisError {
+    constructor(message: string, cause?: unknown);
+}
+export declare class RedisQueueError extends RedisError {
+    constructor(message: string, cause?: unknown);
+}
+export declare function asError(error: unknown): Error;
+export declare function isRedisError(error: unknown): error is RedisError;
+export declare function isRedisErrorCode<Code extends RedisErrorCode>(error: unknown, code: Code): error is RedisError & {
+    readonly code: Code;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACvB,2BAA2B,GAC3B,wBAAwB,GACxB,eAAe,GACf,eAAe,GACf,mBAAmB,GACnB,oBAAoB,GACpB,sBAAsB,GACtB,2BAA2B,GAC3B,kBAAkB,GAClB,mBAAmB,CAAC;AAEvB,qBAAa,UAAW,SAAQ,KAAK;IAKnC,QAAQ,CAAC,IAAI,EAAE,cAAc;IAJ9B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,SAAkB,KAAK,EAAE,OAAO,CAAC;IAEjC,YACU,IAAI,EAAE,cAAc,EAC7B,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,OAAO,EACf,aAAa,UAAO,EAMpB;CACD;AAED,qBAAa,uBAAwB,SAAQ,UAAU;IACtD,YAAY,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAG3C;CACD;AAED,qBAAa,oBAAqB,SAAQ,UAAU;IACnD,YAAY,OAAO,SAA4B,EAAE,KAAK,CAAC,EAAE,OAAO,EAG/D;CACD;AAED,qBAAa,iBAAkB,SAAQ,UAAU;IAChD,YAAY,OAAO,SAA4B,EAAE,KAAK,CAAC,EAAE,OAAO,EAG/D;CACD;AAED,qBAAa,wBAAyB,SAAQ,UAAU;IACvD,YAAY,KAAK,CAAC,EAAE,OAAO,EAG1B;CACD;AAED,qBAAa,qBAAsB,SAAQ,UAAU;IACpD,YAAY,KAAK,CAAC,EAAE,OAAO,EAG1B;CACD;AAED,qBAAa,qBAAsB,SAAQ,UAAU;IACpD,YAAY,OAAO,SAAsC,EAGxD;CACD;AAED,qBAAa,kBAAmB,SAAQ,UAAU;IACjD,YAAY,OAAO,SAAuC,EAAE,KAAK,CAAC,EAAE,OAAO,EAG1E;CACD;AAED,qBAAa,uBAAwB,SAAQ,UAAU;IACtD,YAAY,OAAO,SAAqC,EAAE,KAAK,CAAC,EAAE,OAAO,EAGxE;CACD;AAED,qBAAa,cAAe,SAAQ,UAAU;IAC7C,YAAY,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAG3C;CACD;AAED,qBAAa,eAAgB,SAAQ,UAAU;IAC9C,YAAY,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAG3C;CACD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAI7C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,cAAc,EAC3D,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,IAAI,GACR,KAAK,IAAI,UAAU,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;CAAE,CAE/C"}

package/dist/core/errors.js

@@ -0,0 +1,84 @@
+export class RedisError extends Error {
+    code;
+    isOperational;
+    cause;
+    constructor(code, message, cause, isOperational = true) {
+        super(message, { cause });
+        this.code = code;
+        this.name = "RedisError";
+        this.isOperational = isOperational;
+        this.cause = cause;
+    }
+}
+export class RedisConfigurationError extends RedisError {
+    constructor(message, cause) {
+        super("REDIS_CONFIGURATION_ERROR", message, cause);
+        this.name = "RedisConfigurationError";
+    }
+}
+export class RedisConnectionError extends RedisError {
+    constructor(message = "Redis connection failed", cause) {
+        super("REDIS_CONNECTION_ERROR", message, cause);
+        this.name = "RedisConnectionError";
+    }
+}
+export class RedisTimeoutError extends RedisError {
+    constructor(message = "Redis command timed out", cause) {
+        super("REDIS_TIMEOUT", message, cause);
+        this.name = "RedisTimeoutError";
+    }
+}
+export class RedisRequestAbortedError extends RedisError {
+    constructor(cause) {
+        super("REDIS_ABORTED", "The Redis operation was aborted", cause);
+        this.name = "RedisRequestAbortedError";
+    }
+}
+export class RedisUnavailableError extends RedisError {
+    constructor(cause) {
+        super("REDIS_UNAVAILABLE", "The Redis service is unavailable", cause);
+        this.name = "RedisUnavailableError";
+    }
+}
+export class RedisClientStateError extends RedisError {
+    constructor(message = "The Redis client is not available") {
+        super("REDIS_CLIENT_STATE", message);
+        this.name = "RedisClientStateError";
+    }
+}
+export class RedisProtocolError extends RedisError {
+    constructor(message = "Redis returned an invalid response", cause) {
+        super("REDIS_PROTOCOL_ERROR", message, cause);
+        this.name = "RedisProtocolError";
+    }
+}
+export class RedisSerializationError extends RedisError {
+    constructor(message = "Redis value serialization failed", cause) {
+        super("REDIS_SERIALIZATION_ERROR", message, cause);
+        this.name = "RedisSerializationError";
+    }
+}
+export class RedisLockError extends RedisError {
+    constructor(message, cause) {
+        super("REDIS_LOCK_ERROR", message, cause);
+        this.name = "RedisLockError";
+    }
+}
+export class RedisQueueError extends RedisError {
+    constructor(message, cause) {
+        super("REDIS_QUEUE_ERROR", message, cause);
+        this.name = "RedisQueueError";
+    }
+}
+export function asError(error) {
+    return error instanceof Error
+        ? error
+        : new Error("Unknown Redis failure", { cause: error });
+}
+export function isRedisError(error) {
+    return error instanceof RedisError;
+}
+export function isRedisErrorCode(error, code) {
+    return error instanceof RedisError && error.code === code;
+}
+//# sourceMappingURL=errors.js.map