js-redis-server 0.0.1 → 0.0.3

package/README.md

@@ -8,13 +8,34 @@
 
 In-memory Redis-compatible server implementation in JavaScript. Useful for testing and development without requiring a real Redis instance.
 
+## Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+  - [As a Library](#as-a-library)
+  - [As a CLI](#as-a-cli)
+  - [CLI Options](#cli-options)
+- [Connecting Clients](#connecting-clients)
+  - [Protocol Version (RESP2 / RESP3)](#protocol-version-resp2--resp3)
+  - [Connecting with ioredis](#connecting-with-ioredis)
+  - [Connecting with node-redis](#connecting-with-node-redis)
+  - [Using in Unit Tests](#using-in-unit-tests)
+- [Cluster Mode](#cluster-mode)
+- [API Reference](#api-reference)
+- [Supported Commands](docs/COMMANDS.md)
+- [Requirements](#requirements)
+- [Development](#development)
+- [Contributing](#contributing)
+- [License](#license)
+
 ## Features
 
-- **Redis-compatible protocol** - Works with any Redis client (ioredis, node-redis, etc.)
+- **RESP2 and RESP3 protocols** - Per-session version negotiation via `HELLO`
 - **Standalone and Cluster modes** - Run a single server or a full cluster
 - **Lua scripting support** - Execute Redis Lua scripts via WebAssembly
 - **No external dependencies** - Pure JavaScript, no Redis installation needed
-- **Dual package** - Supports both ESM and CommonJS
+- **TypeScript support** - Ships with full type definitions
 
 ## Installation
 
@@ -27,22 +48,27 @@ npm install js-redis-server
 ### As a Library
 
 ```typescript
-import { createCustomCommander, Resp2Transport } from 'js-redis-server'
+import {
+  RedisServerState,
+  createRedisCommandExecutor,
+  Resp2Server,
+} from 'js-redis-server'
 
 const logger = {
   info: console.log,
   error: console.error,
+  debug: console.debug,
 }
 
-const factory = await createCustomCommander(logger)
-const transport = new Resp2Transport(logger, factory.createCommander())
+const state = new RedisServerState()
+const executor = createRedisCommandExecutor()
+const server = new Resp2Server({ server: state, executor, logger })
 
-await transport.listen(6379)
-console.log('Redis server listening on port 6379')
+await server.listen(6379)
+console.log(`Redis server listening at ${server.getAddress()}`)
 
 // Cleanup
-await transport.close()
-await factory.shutdown()
+await server.close()
 ```
 
 ### As a CLI
@@ -78,66 +104,193 @@ Cluster options:
   --base-port <number>   Starting port for cluster nodes (default 30000)
 
 General:
+  -d, --debug            Enable debug logging
   -h, --help             Show help
 ```
 
 ## Cluster Mode
 
 ```typescript
-import { ClusterNetwork } from 'js-redis-server'
+import { buildRedisCluster } from 'js-redis-server'
 
-const logger = { info: console.log, error: console.error }
-const cluster = new ClusterNetwork(logger)
+const logger = {
+  info: console.log,
+  error: console.error,
+  debug: console.debug,
+}
 
-await cluster.init({
+const cluster = buildRedisCluster({
   masters: 3,
-  slaves: 1,
+  replicasPerMaster: 1,
   basePort: 30000,
+  logger,
 })
 
+await cluster.listen()
+
 // Get all node addresses
-const nodes = cluster.getAll()
-console.log(nodes.map(n => `${n.host}:${n.port}`))
+console.log(cluster.nodes.map(n => `${n.host}:${n.port}`))
 
 // Cleanup
-await cluster.shutdown()
+await cluster.close()
 ```
 
-## Supported Commands
+## Connecting Clients
 
-### Strings
-`GET`, `SET`, `MGET`, `MSET`, `MSETNX`, `APPEND`, `STRLEN`, `GETSET`, `INCR`, `INCRBY`, `INCRBYFLOAT`, `DECR`, `DECRBY`
+You can connect to `js-redis-server` using any standard Redis client.
 
-### Hashes
-`HGET`, `HSET`, `HMGET`, `HMSET`, `HDEL`, `HEXISTS`, `HGETALL`, `HINCRBY`, `HINCRBYFLOAT`, `HKEYS`, `HLEN`, `HVALS`
+### Protocol Version (RESP2 / RESP3)
 
-### Lists
-`LPUSH`, `RPUSH`, `LPOP`, `RPOP`, `LLEN`, `LRANGE`, `LINDEX`, `LSET`, `LREM`, `LTRIM`
+Each connection starts on RESP2 and can switch to RESP3 by sending `HELLO 3`
+(handled per-session, no server restart needed). Clients that support RESP3
+negotiate this automatically:
 
-### Sets
-`SADD`, `SREM`, `SMEMBERS`, `SISMEMBER`, `SCARD`, `SPOP`, `SRANDMEMBER`, `SMOVE`, `SDIFF`, `SINTER`, `SUNION`
+```typescript
+import { createClient } from 'redis'
 
-### Sorted Sets
-`ZADD`, `ZREM`, `ZSCORE`, `ZRANK`, `ZREVRANK`, `ZCARD`, `ZRANGE`, `ZREVRANGE`, `ZRANGEBYSCORE`, `ZREMRANGEBYSCORE`, `ZINCRBY`
+// node-redis negotiates RESP3 via the `RESP` option
+const client = createClient({
+  url: 'redis://127.0.0.1:6379',
+  RESP: 3,
+})
+await client.connect()
+```
+
+### Connecting with ioredis
 
-### Keys
-`DEL`, `EXISTS`, `EXPIRE`, `EXPIREAT`, `TTL`, `PTTL`, `TYPE`
+```typescript
+import Redis from 'ioredis'
 
-### Server
-`PING`, `QUIT`, `INFO`, `DBSIZE`, `FLUSHDB`, `FLUSHALL`
+// Single Node
+const redis = new Redis(6379, '127.0.0.1')
 
-### Cluster
-`CLUSTER INFO`, `CLUSTER NODES`, `CLUSTER SLOTS`, `CLUSTER SHARDS`
+// Cluster Node
+const cluster = new Redis.Cluster([
+  { host: '127.0.0.1', port: 30000 },
+  { host: '127.0.0.1', port: 30001 },
+  { host: '127.0.0.1', port: 30002 },
+])
+```
+
+### Connecting with node-redis
+
+```typescript
+import { createClient, createCluster } from 'redis'
+
+// Single Node
+const client = createClient({
+  url: 'redis://127.0.0.1:6379'
+})
+await client.connect()
+
+// Cluster Node
+const cluster = createCluster({
+  rootNodes: [
+    { url: 'redis://127.0.0.1:30000' },
+    { url: 'redis://127.0.0.1:30001' },
+    { url: 'redis://127.0.0.1:30002' },
+  ]
+})
+await cluster.connect()
+```
+
+### Using in Unit Tests
+
+Since `js-redis-server` starts instantly, it is perfect for isolated integration testing in Node.js test frameworks (like Mocha, Jest, or Node's test runner):
+
+```typescript
+import { test, before, after } from 'node:test'
+import assert from 'node:assert'
+import Redis from 'ioredis'
+import { RedisServerState, createRedisCommandExecutor, Resp2Server } from 'js-redis-server'
+
+let server: Resp2Server
+let client: Redis
+
+before(async () => {
+  const state = new RedisServerState()
+  const executor = createRedisCommandExecutor()
+  server = new Resp2Server({ server: state, executor })
+  
+  await server.listen(6379)
+  client = new Redis(6379, '127.0.0.1')
+})
+
+after(async () => {
+  await client.quit()
+  await server.close()
+})
+
+test('basic set/get operations', async () => {
+  await client.set('foo', 'bar')
+  const val = await client.get('foo')
+  assert.strictEqual(val, 'bar')
+})
+```
 
-### Scripting
-`EVAL`, `EVALSHA`, `SCRIPT LOAD`
+## API Reference
+
+### `Resp2Server`
+
+Creates a TCP server running the RESP2 protocol.
+
+```typescript
+new Resp2Server(options: Resp2ServerOptions)
+```
+
+**Options (`Resp2ServerOptions`)**:
+
+| Parameter | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| `server` | `RedisServerState` | Yes | The database server state containing database instances. |
+| `executor` | `CommandExecutor` | Yes | The command executor handling pipeline and execution policies. |
+| `logger` | `Pick<Logger, 'error'>` | No | Optional logger for error logging. |
+| `encoder` | `RespEncodeOptions` | No | Custom RESP protocol encoding options. |
+
+---
+
+### `RedisServerState`
+
+Holds the database and keyspace state for the server.
+
+```typescript
+new RedisServerState(options?: RedisServerStateOptions)
+```
+
+**Options (`RedisServerStateOptions`)**:
+
+| Parameter | Type | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `databaseCount` | `number` | `1` | Number of databases to initialize. |
+| `clusterTopology` | `RedisClusterTopology` | `undefined` | Optional cluster topology for slot routing. |
+| `pubsubBroker` | `RedisPubSubBroker` | `undefined` | Optional broker for pub/sub operations. |
+| `scriptCache` | `RedisScriptCache` | `undefined` | Optional cache for Lua scripts. |
+
+---
+
+### `buildRedisCluster`
+
+Utility function to build and configure a complete Redis cluster in-memory.
+
+```typescript
+buildRedisCluster(options: RedisClusterOptions): RedisCluster
+```
+
+**Options (`RedisClusterOptions`)**:
+
+| Parameter | Type | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `masters` | `number` | **Required** | Number of master nodes in the cluster. |
+| `replicasPerMaster` | `number` | `0` | Replicas per master node. |
+| `basePort` | `number` | **Required** | Base port range. If `0`, random OS ports are assigned. |
+| `host` | `string` | `'127.0.0.1'` | Host address to bind to. |
+| `databasesPerNode` | `number` | `1` | Number of databases per cluster node. |
+| `logger` | `Pick<Logger, 'error'>` | `undefined` | Optional logger. |
 
-### Client
-`CLIENT SETNAME`
 
 ## Requirements
 
-- Node.js >= 22
+- Node.js >= 24
 
 ## Development
 
@@ -151,16 +304,34 @@ npm run build
 # Run tests
 npm test
 
+# Lint and format
+npm run lint
+npm run format
+
 # Run integration tests (mock backend)
 npm run test:integration:mock
 
 # Run integration tests (real Redis)
+# Requires a Redis cluster — start one with docker-compose.test.yml first:
+#   docker compose -f docker-compose.test.yml up -d --wait
 npm run test:integration:real
 
 # Run all tests
 npm run test:all
 ```
 
+> **CI** runs four jobs on every push and pull request: lint + format check,
+> unit tests, mock-backend integration tests, and real-backend integration
+> tests against a Redis cluster spun up via `docker-compose.test.yml`.
+
+## Further Documentation
+
+For more details on the architecture, testing infrastructure, and command support, see:
+
+- [Architecture](docs/ARCHITECTURE.md) — layers, command pipeline, execution policies, cluster routing, RESP2/RESP3, and diagrams
+- [Detailed Command Implementation Status](docs/COMMANDS.md)
+- [Integration Testing Infrastructure](docs/TEST-INTEGRATION.md)
+
 ## Contributing
 
 Contributions are welcome! Please read the [contributing guidelines](CONTRIBUTING.md) before submitting a pull request.

package/dist/cli.d.ts

@@ -6,6 +6,7 @@ export type CliOptions = {
     slaves: number;
     basePort: number;
     help: boolean;
+    debug: boolean;
 };
 export declare function parseArgs(args: string[]): CliOptions;
 export declare function main(argv?: string[]): Promise<void>;

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAKA,KAAK,IAAI,GAAG,QAAQ,GAAG,SAAS,CAAA;AAEhC,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,IAAI,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,OAAO,CAAA;CACd,CAAA;AAWD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAsDpD;AAkHD,wBAAsB,IAAI,CAAC,IAAI,WAAwB,iBActD"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAMA,KAAK,IAAI,GAAG,QAAQ,GAAG,SAAS,CAAA;AAEhC,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,IAAI,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,OAAO,CAAA;CACf,CAAA;AAYD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA2DpD;AAqHD,wBAAsB,IAAI,CAAC,IAAI,WAAwB,iBActD"}

package/dist/cli.js

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArgs = parseArgs;
+exports.main = main;
+const commands_1 = require("./commands");
+const server_1 = require("./core/transports/resp2/server");
+const cluster_1 = require("./cluster");
+const state_1 = require("./state");
+const defaultOptions = {
+    mode: 'single',
+    port: 6379,
+    masters: 3,
+    slaves: 0,
+    basePort: 30000,
+    help: false,
+    debug: false,
+};
+function parseArgs(args) {
+    const options = { ...defaultOptions };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--help' || arg === '-h') {
+            options.help = true;
+            continue;
+        }
+        if (arg === '--debug' || arg === '-d') {
+            options.debug = true;
+            continue;
+        }
+        if (arg === '--cluster') {
+            options.mode = 'cluster';
+            continue;
+        }
+        if (arg === '--single') {
+            options.mode = 'single';
+            continue;
+        }
+        if (arg === '--mode') {
+            const value = args[++i];
+            if (value !== 'single' && value !== 'cluster') {
+                throw new Error(`Invalid mode "${value}"`);
+            }
+            options.mode = value;
+            continue;
+        }
+        if (arg === '--port') {
+            options.port = parseInteger(args[++i], '--port');
+            continue;
+        }
+        if (arg === '--base-port') {
+            options.basePort = parseInteger(args[++i], '--base-port');
+            continue;
+        }
+        if (arg === '--masters') {
+            options.masters = parseInteger(args[++i], '--masters');
+            continue;
+        }
+        if (arg === '--slaves') {
+            options.slaves = parseInteger(args[++i], '--slaves');
+            continue;
+        }
+        throw new Error(`Unknown argument "${arg}"`);
+    }
+    return options;
+}
+function parseInteger(value, name) {
+    if (!value) {
+        throw new Error(`Missing value for ${name}`);
+    }
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed)) {
+        throw new Error(`Invalid value for ${name}: ${value}`);
+    }
+    return parsed;
+}
+function validatePort(port, name) {
+    if (!Number.isInteger(port) || port < 0 || port > 65535) {
+        throw new Error(`Invalid ${name} ${port}`);
+    }
+}
+function createLogger(debug = false) {
+    return {
+        info: (msg, metadata) => {
+            if (metadata) {
+                console.log(msg, metadata);
+            }
+            else {
+                console.log(msg);
+            }
+        },
+        error: (msg, metadata) => {
+            if (metadata) {
+                console.error(msg, metadata);
+            }
+            else {
+                console.error(msg);
+            }
+        },
+        debug: (msg, metadata) => {
+            if (debug) {
+                if (metadata) {
+                    console.debug(msg, metadata);
+                }
+                else {
+                    console.debug(msg);
+                }
+            }
+        },
+    };
+}
+function printHelp() {
+    console.log(`Usage: js-redis-server [options]
+
+Modes:
+  --single               Run a single Redis server (default)
+  --cluster              Run a Redis cluster
+  --mode <single|cluster>
+
+Single server options:
+  --port <number>        Port to listen on (default 6379)
+
+Cluster options:
+  --masters <number>     Number of masters (default 3)
+  --slaves <number>      Number of replicas per master (default 0)
+  --base-port <number>   Starting port for cluster nodes (default 30000)
+
+General:
+  -d, --debug            Enable debug logging
+  -h, --help             Show help
+`);
+}
+async function runSingle(options, logger) {
+    validatePort(options.port, 'port');
+    logger.debug('Starting single server mode', { port: options.port });
+    const state = new state_1.RedisServerState();
+    const executor = (0, commands_1.createRedisCommandExecutor)();
+    const server = new server_1.Resp2Server({ server: state, executor, logger });
+    await server.listen(options.port);
+    logger.info(`Single Redis server listening at ${server.getAddress()}`);
+    const shutdown = async () => {
+        await server.close();
+    };
+    process.once('SIGINT', shutdown);
+    process.once('SIGTERM', shutdown);
+}
+async function runCluster(options, logger) {
+    validatePort(options.basePort, 'base-port');
+    logger.debug('Starting cluster mode', {
+        masters: options.masters,
+        slaves: options.slaves,
+        basePort: options.basePort,
+    });
+    const cluster = (0, cluster_1.buildRedisCluster)({
+        masters: options.masters,
+        replicasPerMaster: options.slaves,
+        basePort: options.basePort,
+        logger,
+    });
+    await cluster.listen();
+    const nodes = cluster.nodes.map(n => `${n.id} ${n.host}:${n.port}`).join(', ');
+    logger.info(`Cluster nodes: ${nodes}`);
+    const shutdown = async () => {
+        await cluster.close();
+    };
+    process.once('SIGINT', shutdown);
+    process.once('SIGTERM', shutdown);
+}
+async function main(argv = process.argv.slice(2)) {
+    const options = parseArgs(argv);
+    if (options.help) {
+        printHelp();
+        return;
+    }
+    const logger = createLogger(options.debug);
+    if (options.mode === 'cluster') {
+        await runCluster(options, logger);
+    }
+    else {
+        await runSingle(options, logger);
+    }
+}
+// Run when executed directly as CLI. Node resolves bin symlinks to realpath,
+// so require.main === module works for `npm link` / global installs too.
+if (require.main === module) {
+    main().catch(err => {
+        console.error(err);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/cluster.d.ts

@@ -0,0 +1,36 @@
+import { Resp2Server } from './core/transports/resp2/server';
+import { RedisClusterTopology, RedisServerState } from './state';
+import type { Logger } from './logger';
+export type RedisClusterOptions = {
+    masters: number;
+    replicasPerMaster?: number;
+    basePort: number;
+    host?: string;
+    databasesPerNode?: number;
+    replicaUpdateDelayMs?: number;
+    logger?: Pick<Logger, 'error'>;
+};
+export type RedisClusterNodeHandle = {
+    id: string;
+    role: 'master' | 'replica';
+    host: string;
+    port: number;
+    server: RedisServerState;
+};
+export declare class RedisCluster {
+    readonly topology: RedisClusterTopology;
+    readonly nodes: readonly RedisClusterNodeHandle[];
+    private readonly servers;
+    private readonly replicationLinks;
+    constructor(topology: RedisClusterTopology, nodes: readonly RedisClusterNodeHandle[], servers: readonly Resp2Server[], replicationLinks: readonly ReplicationLink[]);
+    listen(): Promise<void>;
+    close(): Promise<void>;
+    getAddresses(): string[];
+}
+export declare function buildRedisCluster(options: RedisClusterOptions): RedisCluster;
+export declare function computeSlotRange(masterIndex: number, masters: number): [number, number];
+type ReplicationLink = {
+    close(): void;
+};
+export {};
+//# sourceMappingURL=cluster.d.ts.map

package/dist/cluster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster.d.ts","sourceRoot":"","sources":["../src/cluster.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AAC5D,OAAO,EAGL,oBAAoB,EACpB,gBAAgB,EAIjB,MAAM,SAAS,CAAA;AAChB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEtC,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAA;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,gBAAgB,CAAA;CACzB,CAAA;AAED,qBAAa,YAAY;IACvB,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAA;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,sBAAsB,EAAE,CAAA;IAEjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;gBAGlD,QAAQ,EAAE,oBAAoB,EAC9B,KAAK,EAAE,SAAS,sBAAsB,EAAE,EACxC,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,gBAAgB,EAAE,SAAS,eAAe,EAAE;IAQxC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAevB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,YAAY,IAAI,MAAM,EAAE;CAGzB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAqF5E;AAED,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBlB;AA+BD,KAAK,eAAe,GAAG;IACrB,KAAK,IAAI,IAAI,CAAA;CACd,CAAA"}