@gixcopilot/redis 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ahmed khaled
+
+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,37 @@
+# @gixcopilot/redis
+
+Redis coordination for multi-instance AI Copilot deployments (**Beta**). Redis holds
+ephemeral, shared state only; durable state lives in PostgreSQL.
+
+## Install
+
+```bash
+npm install @gixcopilot/redis
+```
+
+Requires Node.js >=22.12.0. ESM only.
+
+| Export | Purpose |
+| --- | --- |
+| `createRedisRateLimiter(client)` | Distributed fixed-window limiter: one atomic Lua script per check, window derived from the Redis server clock (instances with skewed clocks share windows), weighted `cost` (e.g. tokens), rejected requests do not consume |
+| `createMemoryRateLimiter()` | Same interface in-process (development, tests, single instance) |
+| `createRedisLock(client)` | Lease lock (`SET NX PX` + token-checked release) for temporary coordination; work under it must still be idempotent |
+| `redisHealth(client)` | Readiness check (PING with timeout), never throws |
+
+```ts
+const limiter = createRedisRateLimiter(new Redis(config.secrets.redisUrl.reveal()));
+const decision = await limiter.consume(`tenant:${tenantId}:requests`, { limit: 100, windowMs: 60_000 });
+```
+
+Background jobs use BullMQ through `@gixcopilot/jobs`. Tested against real Redis with three
+limiter instances sharing one limit. Server-only.
+
+## Documentation
+
+- [production guide](https://github.com/AfoudaSWE/gix_ai_copilot_nx/blob/main/docs/guides/production.md)
+- [Getting started](https://github.com/AfoudaSWE/gix_ai_copilot_nx/blob/main/docs/guides/getting-started.md)
+- [Source](https://github.com/AfoudaSWE/gix_ai_copilot_nx/tree/main/packages/redis)
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { createMemoryRateLimiter, createRedisRateLimiter } from './rate-limiter.js';
+export type { DistributedRateLimitDecision, DistributedRateLimitRule, DistributedRateLimiter } from './rate-limiter.js';
+export { createRedisLock, redisHealth } from './lock.js';
+export type { DistributedLock, LockHandle } from './lock.js';
+//# 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,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACpF,YAAY,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACxH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createMemoryRateLimiter, createRedisRateLimiter } from './rate-limiter.js';
+export { createRedisLock, redisHealth } from './lock.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEpF,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/lock.d.ts

@@ -0,0 +1,25 @@
+import type { Redis } from 'ioredis';
+export interface LockHandle {
+    readonly key: string;
+    /** Releases only if this holder still owns the lock (never another holder's lock). */
+    release(): Promise<boolean>;
+}
+export interface DistributedLock {
+    /** Returns a handle, or `undefined` when another holder has the lock. */
+    tryAcquire(key: string, ttlMs: number): Promise<LockHandle | undefined>;
+}
+/**
+ * A single-Redis lease lock for temporary coordination (e.g. one maintenance job at a time).
+ * It is a lease, not a correctness guarantee across Redis failover: work guarded by it must
+ * still be idempotent. Durable state stays in PostgreSQL.
+ */
+export declare function createRedisLock(client: Redis, options?: {
+    readonly prefix?: string;
+}): DistributedLock;
+/** Readiness check: PING with a timeout. Never throws. */
+export declare function redisHealth(client: Redis, timeoutMs?: number): Promise<{
+    readonly ok: boolean;
+    readonly latencyMs: number;
+    readonly error?: string;
+}>;
+//# sourceMappingURL=lock.d.ts.map

package/dist/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../src/lock.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sFAAsF;IACtF,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;CACzE;AAID;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,GAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,eAAe,CAc1G;AAED,0DAA0D;AAC1D,wBAAsB,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAQzJ"}

package/dist/lock.js

@@ -0,0 +1,35 @@
+import { randomUUID } from 'node:crypto';
+const RELEASE = `if redis.call('GET', KEYS[1]) == ARGV[1] then return redis.call('DEL', KEYS[1]) else return 0 end`;
+/**
+ * A single-Redis lease lock for temporary coordination (e.g. one maintenance job at a time).
+ * It is a lease, not a correctness guarantee across Redis failover: work guarded by it must
+ * still be idempotent. Durable state stays in PostgreSQL.
+ */
+export function createRedisLock(client, options = {}) {
+    const prefix = options.prefix ?? 'aicopilot:lock';
+    return {
+        async tryAcquire(key, ttlMs) {
+            const token = randomUUID();
+            const full = `${prefix}:${key}`;
+            const ok = await client.set(full, token, 'PX', ttlMs, 'NX');
+            if (ok !== 'OK')
+                return undefined;
+            return {
+                key,
+                release: async () => (await client.eval(RELEASE, 1, full, token)) === 1,
+            };
+        },
+    };
+}
+/** Readiness check: PING with a timeout. Never throws. */
+export async function redisHealth(client, timeoutMs = 1000) {
+    const started = performance.now();
+    try {
+        await Promise.race([client.ping(), new Promise((_, reject) => setTimeout(() => reject(new Error('timeout')), timeoutMs).unref())]);
+        return { ok: true, latencyMs: Math.round(performance.now() - started) };
+    }
+    catch (error) {
+        return { ok: false, latencyMs: Math.round(performance.now() - started), error: error instanceof Error && error.message === 'timeout' ? 'redis timeout' : 'redis unreachable' };
+    }
+}
+//# sourceMappingURL=lock.js.map

package/dist/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../src/lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAczC,MAAM,OAAO,GAAG,mGAAmG,CAAC;AAEpH;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAAa,EAAE,UAAwC,EAAE;IACvF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,gBAAgB,CAAC;IAClD,OAAO;QACL,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK;YACzB,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC;YAChC,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YAC5D,IAAI,EAAE,KAAK,IAAI;gBAAE,OAAO,SAAS,CAAC;YAClC,OAAO;gBACL,GAAG;gBACH,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC;aACxE,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAa,EAAE,SAAS,GAAG,IAAI;IAC/D,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QACnI,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;IAC1E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC;IACjL,CAAC;AACH,CAAC"}

package/dist/rate-limiter.d.ts

@@ -0,0 +1,22 @@
+import type { Redis } from 'ioredis';
+export interface DistributedRateLimitRule {
+    readonly limit: number;
+    readonly windowMs: number;
+}
+export interface DistributedRateLimitDecision {
+    readonly allowed: boolean;
+    readonly remaining: number;
+    /** Milliseconds until the current window resets. */
+    readonly resetMs: number;
+    readonly limit: number;
+}
+/** Async rate limiter shared by every server instance (Section 76). */
+export interface DistributedRateLimiter {
+    consume(key: string, rule: DistributedRateLimitRule, cost?: number): Promise<DistributedRateLimitDecision>;
+}
+export declare function createRedisRateLimiter(client: Redis, options?: {
+    readonly prefix?: string;
+}): DistributedRateLimiter;
+/** In-process equivalent for development/tests and single-instance deployments. */
+export declare function createMemoryRateLimiter(now?: () => number): DistributedRateLimiter;
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../src/rate-limiter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,uEAAuE;AACvE,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;CAC5G;AA6BD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,GAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,sBAAsB,CAUxH;AAED,mFAAmF;AACnF,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,MAAM,MAAiB,GAAG,sBAAsB,CAc5F"}

package/dist/rate-limiter.js

@@ -0,0 +1,56 @@
+/*
+ * Fixed-window counter, evaluated atomically in Redis. The window bucket uses the Redis
+ * server's clock (TIME), so instances with skewed clocks still share one window. A rejected
+ * request does not consume capacity.
+ */
+const SCRIPT = `
+local now = redis.call('TIME')
+local nowMs = tonumber(now[1]) * 1000 + math.floor(tonumber(now[2]) / 1000)
+local windowMs = tonumber(ARGV[2])
+local bucket = math.floor(nowMs / windowMs)
+local key = KEYS[1] .. ':' .. bucket
+local cost = tonumber(ARGV[1])
+local limit = tonumber(ARGV[3])
+local current = tonumber(redis.call('GET', key) or '0')
+local resetMs = (bucket + 1) * windowMs - nowMs
+if current + cost > limit then
+  return {0, current, resetMs}
+end
+current = redis.call('INCRBY', key, cost)
+if current == cost then
+  redis.call('PEXPIRE', key, windowMs + 1000)
+end
+return {1, current, resetMs}
+`;
+const KEY = /^[A-Za-z0-9._:|@-]{1,256}$/;
+export function createRedisRateLimiter(client, options = {}) {
+    const prefix = options.prefix ?? 'aicopilot:rl';
+    return {
+        async consume(key, rule, cost = 1) {
+            if (!KEY.test(key))
+                throw new Error('Invalid rate-limit key.');
+            if (!Number.isInteger(rule.limit) || rule.limit < 0 || !Number.isInteger(rule.windowMs) || rule.windowMs < 1)
+                throw new Error('Invalid rate-limit rule.');
+            const [allowed, count, resetMs] = (await client.eval(SCRIPT, 1, `${prefix}:${key}`, String(cost), String(rule.windowMs), String(rule.limit)));
+            return { allowed: allowed === 1, remaining: Math.max(rule.limit - count, 0), resetMs, limit: rule.limit };
+        },
+    };
+}
+/** In-process equivalent for development/tests and single-instance deployments. */
+export function createMemoryRateLimiter(now = Date.now) {
+    const windows = new Map();
+    return {
+        consume(key, rule, cost = 1) {
+            const time = now();
+            const bucket = Math.floor(time / rule.windowMs);
+            const entry = windows.get(key);
+            const count = entry?.bucket === bucket ? entry.count : 0;
+            const resetMs = (bucket + 1) * rule.windowMs - time;
+            if (count + cost > rule.limit)
+                return Promise.resolve({ allowed: false, remaining: Math.max(rule.limit - count, 0), resetMs, limit: rule.limit });
+            windows.set(key, { bucket, count: count + cost });
+            return Promise.resolve({ allowed: true, remaining: Math.max(rule.limit - count - cost, 0), resetMs, limit: rule.limit });
+        },
+    };
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../src/rate-limiter.ts"],"names":[],"mappings":"AAoBA;;;;GAIG;AACH,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;CAkBd,CAAC;AAEF,MAAM,GAAG,GAAG,4BAA4B,CAAC;AAEzC,MAAM,UAAU,sBAAsB,CAAC,MAAa,EAAE,UAAwC,EAAE;IAC9F,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC;IAChD,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC;YAC/B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC/D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC1J,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,MAAM,IAAI,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAA6B,CAAC;YAC1K,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QAC5G,CAAC;KACF,CAAC;AACJ,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,uBAAuB,CAAC,MAAoB,IAAI,CAAC,GAAG;IAClE,MAAM,OAAO,GAAG,IAAI,GAAG,EAA6C,CAAC;IACrE,OAAO;QACL,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC;YACzB,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;YAChD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC/B,MAAM,KAAK,GAAG,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACzD,MAAM,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACpD,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC,KAAK;gBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAClJ,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,CAAC,CAAC;YAClD,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,GAAG,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3H,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@gixcopilot/redis",
+  "version": "0.1.0",
+  "description": "Redis coordination for multi-instance deployments: distributed rate limiting, lease locks and health checks.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AfoudaSWE/gix_ai_copilot_nx.git",
+    "directory": "packages/redis"
+  },
+  "homepage": "https://github.com/AfoudaSWE/gix_ai_copilot_nx/tree/main/packages/redis#readme",
+  "bugs": {
+    "url": "https://github.com/AfoudaSWE/gix_ai_copilot_nx/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.spec.*",
+    "!dist/**/*.spec-helper.*",
+    "!dist/**/*.integration.spec.*",
+    "!dist/**/*.tsbuildinfo"
+  ],
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "ioredis": "5.11.1"
+  },
+  "devDependencies": {
+    "@testcontainers/redis": "^12.1.0",
+    "testcontainers": "^12.1.0",
+    "vitest": "5.0.1"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.json",
+    "typecheck": "tsc -b tsconfig.json",
+    "test": "vitest run",
+    "lint": "eslint src"
+  }
+}