@shohaghinfo/aerojs 0.1.0

package/dist/redis/redis-client.js

@@ -0,0 +1,131 @@
+/**
+ * @file redis-client.ts
+ * @description Fluent API providing Redis commands for AeroJS.
+ */
+import { RedisConnection } from './redis-connection.js';
+export class RedisClient {
+    connection;
+    constructor(options) {
+        this.connection = new RedisConnection(options);
+    }
+    connect() {
+        return this.connection.connect();
+    }
+    disconnect() {
+        return this.connection.disconnect();
+    }
+    getRawConnection() {
+        return this.connection;
+    }
+    // --- Basic Commands ---
+    get(key) {
+        return this.connection.sendCommand(['GET', key]);
+    }
+    set(key, value) {
+        return this.connection.sendCommand(['SET', key, value]);
+    }
+    setex(key, seconds, value) {
+        return this.connection.sendCommand(['SETEX', key, seconds, value]);
+    }
+    del(...keys) {
+        return this.connection.sendCommand(['DEL', ...keys]);
+    }
+    exists(key) {
+        return this.connection.sendCommand(['EXISTS', key]);
+    }
+    expire(key, seconds) {
+        return this.connection.sendCommand(['EXPIRE', key, seconds]);
+    }
+    ttl(key) {
+        return this.connection.sendCommand(['TTL', key]);
+    }
+    incr(key) {
+        return this.connection.sendCommand(['INCR', key]);
+    }
+    decr(key) {
+        return this.connection.sendCommand(['DECR', key]);
+    }
+    incrby(key, increment) {
+        return this.connection.sendCommand(['INCRBY', key, increment]);
+    }
+    decrby(key, decrement) {
+        return this.connection.sendCommand(['DECRBY', key, decrement]);
+    }
+    mget(...keys) {
+        return this.connection.sendCommand(['MGET', ...keys]);
+    }
+    mset(data) {
+        const args = ['MSET'];
+        for (const [key, val] of Object.entries(data)) {
+            args.push(key, val);
+        }
+        return this.connection.sendCommand(args);
+    }
+    flushdb() {
+        return this.connection.sendCommand(['FLUSHDB']);
+    }
+    // --- Hashes ---
+    hset(key, field, value) {
+        return this.connection.sendCommand(['HSET', key, field, value]);
+    }
+    hget(key, field) {
+        return this.connection.sendCommand(['HGET', key, field]);
+    }
+    hdel(key, ...fields) {
+        return this.connection.sendCommand(['HDEL', key, ...fields]);
+    }
+    async hgetall(key) {
+        const res = await this.connection.sendCommand(['HGETALL', key]);
+        const obj = {};
+        for (let i = 0; i < res.length; i += 2) {
+            obj[res[i]] = res[i + 1];
+        }
+        return obj;
+    }
+    // --- Lists ---
+    lpush(key, ...elements) {
+        return this.connection.sendCommand(['LPUSH', key, ...elements]);
+    }
+    rpush(key, ...elements) {
+        return this.connection.sendCommand(['RPUSH', key, ...elements]);
+    }
+    lpop(key) {
+        return this.connection.sendCommand(['LPOP', key]);
+    }
+    rpop(key) {
+        return this.connection.sendCommand(['RPOP', key]);
+    }
+    llen(key) {
+        return this.connection.sendCommand(['LLEN', key]);
+    }
+    // --- Sets ---
+    sadd(key, ...members) {
+        return this.connection.sendCommand(['SADD', key, ...members]);
+    }
+    srem(key, ...members) {
+        return this.connection.sendCommand(['SREM', key, ...members]);
+    }
+    smembers(key) {
+        return this.connection.sendCommand(['SMEMBERS', key]);
+    }
+    scard(key) {
+        return this.connection.sendCommand(['SCARD', key]);
+    }
+    // --- Pub/Sub ---
+    publish(channel, message) {
+        return this.connection.sendCommand(['PUBLISH', channel, message]);
+    }
+    subscribe(channel, callback) {
+        this.connection.on('message', (msg) => {
+            // msg format for subscribe is typically ['message', channel, payload]
+            if (Array.isArray(msg) && msg[0] === 'message' && msg[1] === channel) {
+                callback(msg[2]);
+            }
+        });
+        return this.connection.sendCommand(['SUBSCRIBE', channel]);
+    }
+    unsubscribe(channel) {
+        return this.connection.sendCommand(['UNSUBSCRIBE', channel]);
+    }
+}
+//# sourceMappingURL=redis-client.js.map

package/dist/redis/redis-client.js.map

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

package/dist/redis/redis-connection.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @file redis-connection.ts
+ * @description TCP connection manager for Redis with auto-reconnect and pipeline buffering.
+ */
+import { EventEmitter } from 'node:events';
+export interface RedisConnectionOptions {
+    host?: string;
+    port?: number;
+    password?: string;
+    db?: number;
+    retryStrategy?: (times: number) => number | null;
+}
+export declare class RedisConnection extends EventEmitter {
+    private socket;
+    private options;
+    private isConnected;
+    private isConnecting;
+    private shouldReconnect;
+    private retryAttempts;
+    private connectionTimeout;
+    private readBuffer;
+    private offlineQueue;
+    private commandQueue;
+    constructor(options?: RedisConnectionOptions);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    sendCommand(args: (string | number | Buffer)[]): Promise<any>;
+    private handleData;
+    private scheduleReconnect;
+    private flushOfflineQueue;
+}
+//# sourceMappingURL=redis-connection.d.ts.map

package/dist/redis/redis-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-connection.d.ts","sourceRoot":"","sources":["../../src/redis/redis-connection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CAClD;AAQD,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,iBAAiB,CAA+B;IAExD,OAAO,CAAC,UAAU,CAAmB;IAGrC,OAAO,CAAC,YAAY,CAAqB;IAEzC,OAAO,CAAC,YAAY,CAAqB;gBAE7B,OAAO,GAAE,sBAA2B;IASzC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA8DlB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAiBpE,OAAO,CAAC,UAAU;IAuBlB,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,iBAAiB;CAO1B"}

package/dist/redis/redis-connection.js

@@ -0,0 +1,151 @@
+/**
+ * @file redis-connection.ts
+ * @description TCP connection manager for Redis with auto-reconnect and pipeline buffering.
+ */
+import * as net from 'node:net';
+import { EventEmitter } from 'node:events';
+import { RESP, RESPError } from './resp-parser.js';
+export class RedisConnection extends EventEmitter {
+    socket = null;
+    options;
+    isConnected = false;
+    isConnecting = false;
+    shouldReconnect = true;
+    retryAttempts = 0;
+    connectionTimeout = null;
+    readBuffer = Buffer.alloc(0);
+    // Tasks waiting to be sent
+    offlineQueue = [];
+    // Tasks sent to Redis, waiting for response
+    commandQueue = [];
+    constructor(options = {}) {
+        super();
+        this.options = {
+            host: '127.0.0.1',
+            port: 6379,
+            ...options,
+        };
+    }
+    connect() {
+        if (this.isConnected || this.isConnecting)
+            return Promise.resolve();
+        return new Promise((resolve, reject) => {
+            this.isConnecting = true;
+            this.shouldReconnect = true;
+            this.socket = net.createConnection({
+                host: this.options.host,
+                port: this.options.port,
+            });
+            this.socket.on('connect', async () => {
+                this.isConnected = true;
+                this.isConnecting = false;
+                this.retryAttempts = 0;
+                this.emit('connect');
+                try {
+                    if (this.options.password) {
+                        await this.sendCommand(['AUTH', this.options.password]);
+                    }
+                    if (this.options.db !== undefined && this.options.db !== 0) {
+                        await this.sendCommand(['SELECT', this.options.db]);
+                    }
+                    this.emit('ready');
+                    this.flushOfflineQueue();
+                    resolve();
+                }
+                catch (err) {
+                    this.emit('error', err);
+                    reject(err);
+                }
+            });
+            this.socket.on('data', (data) => this.handleData(data));
+            this.socket.on('error', (err) => {
+                this.emit('error', err);
+                if (this.isConnecting) {
+                    reject(err);
+                }
+            });
+            this.socket.on('close', () => {
+                this.isConnected = false;
+                this.isConnecting = false;
+                this.emit('close');
+                // Reject all pending commands
+                const err = new Error('Redis connection lost');
+                for (const task of this.commandQueue) {
+                    task.reject(err);
+                }
+                this.commandQueue = [];
+                if (this.shouldReconnect) {
+                    this.scheduleReconnect();
+                }
+            });
+        });
+    }
+    async disconnect() {
+        this.shouldReconnect = false;
+        if (this.connectionTimeout)
+            clearTimeout(this.connectionTimeout);
+        return new Promise((resolve) => {
+            if (!this.socket || !this.isConnected) {
+                return resolve();
+            }
+            this.socket.once('close', () => resolve());
+            this.socket.end();
+        });
+    }
+    sendCommand(args) {
+        return new Promise((resolve, reject) => {
+            const commandBuffer = RESP.serialize(args);
+            const task = { resolve, reject, commandBuffer };
+            if (this.isConnected) {
+                this.commandQueue.push(task);
+                this.socket.write(commandBuffer);
+            }
+            else {
+                this.offlineQueue.push(task);
+                if (this.shouldReconnect && !this.isConnecting) {
+                    this.connect().catch(() => { });
+                }
+            }
+        });
+    }
+    handleData(data) {
+        this.readBuffer = Buffer.concat([this.readBuffer, data]);
+        const bufferObj = { buffer: this.readBuffer };
+        RESP.parseStream(bufferObj, (err, reply) => {
+            const task = this.commandQueue.shift();
+            if (!task) {
+                // This can happen for Push messages (like pub/sub)
+                this.emit('message', reply);
+                return;
+            }
+            if (err) {
+                task.reject(err);
+            }
+            else {
+                task.resolve(reply);
+            }
+        });
+        this.readBuffer = bufferObj.buffer;
+    }
+    scheduleReconnect() {
+        this.retryAttempts++;
+        const strategy = this.options.retryStrategy || ((times) => Math.min(times * 50, 2000));
+        const delay = strategy(this.retryAttempts);
+        if (delay === null) {
+            this.emit('error', new Error('Max retries reached.'));
+            return;
+        }
+        this.emit('reconnecting', { attempt: this.retryAttempts, delay });
+        this.connectionTimeout = setTimeout(() => {
+            this.connect().catch(() => { });
+        }, delay);
+    }
+    flushOfflineQueue() {
+        for (const task of this.offlineQueue) {
+            this.commandQueue.push(task);
+            this.socket.write(task.commandBuffer);
+        }
+        this.offlineQueue = [];
+    }
+}
+//# sourceMappingURL=redis-connection.js.map

package/dist/redis/redis-connection.js.map

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

package/dist/redis/redis-manager.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @file redis-manager.ts
+ * @description Redis Façade / Manager.
+ */
+import { RedisClient } from './redis-client.js';
+import type { RedisConnectionOptions } from './redis-connection.js';
+export declare class RedisManager {
+    private static connections;
+    private static defaultConnectionName;
+    /**
+     * Configure multiple Redis connections.
+     */
+    static configure(connections: Record<string, RedisConnectionOptions>, defaultConnection?: string): void;
+    /**
+     * Add or overwrite a specific connection.
+     */
+    static addConnection(name: string, client: RedisClient): void;
+    /**
+     * Get a RedisClient instance by connection name.
+     */
+    static connection(name?: string): RedisClient;
+    /**
+     * Disconnect all active Redis connections.
+     */
+    static closeAll(): Promise<void>;
+}
+export declare const Redis: typeof RedisManager & RedisClient;
+//# sourceMappingURL=redis-manager.d.ts.map

package/dist/redis/redis-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-manager.d.ts","sourceRoot":"","sources":["../../src/redis/redis-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEpE,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,WAAW,CAAkC;IAC5D,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAa;IAEjD;;OAEG;WACW,SAAS,CACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,EACnD,iBAAiB,SAAY;IAQ/B;;OAEG;WACW,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW;IAI7D;;OAEG;WACW,UAAU,CAAC,IAAI,GAAE,MAAmC,GAAG,WAAW;IAchF;;OAEG;WACiB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ9C;AAGD,eAAO,MAAM,KAAK,EAaZ,OAAO,YAAY,GAAG,WAAW,CAAC"}

package/dist/redis/redis-manager.js

@@ -0,0 +1,68 @@
+/**
+ * @file redis-manager.ts
+ * @description Redis Façade / Manager.
+ */
+import { RedisClient } from './redis-client.js';
+export class RedisManager {
+    static connections = new Map();
+    static defaultConnectionName = 'default';
+    /**
+     * Configure multiple Redis connections.
+     */
+    static configure(connections, defaultConnection = 'default') {
+        this.defaultConnectionName = defaultConnection;
+        for (const [name, config] of Object.entries(connections)) {
+            this.connections.set(name, new RedisClient(config));
+        }
+    }
+    /**
+     * Add or overwrite a specific connection.
+     */
+    static addConnection(name, client) {
+        this.connections.set(name, client);
+    }
+    /**
+     * Get a RedisClient instance by connection name.
+     */
+    static connection(name = this.defaultConnectionName) {
+        let client = this.connections.get(name);
+        if (!client) {
+            if (name === 'default' && this.connections.size === 0) {
+                // Auto-create default local connection if none configured
+                client = new RedisClient();
+                this.connections.set(name, client);
+            }
+            else {
+                throw new Error(`Redis connection [${name}] not configured.`);
+            }
+        }
+        return client;
+    }
+    /**
+     * Disconnect all active Redis connections.
+     */
+    static async closeAll() {
+        const promises = [];
+        for (const client of this.connections.values()) {
+            promises.push(client.disconnect());
+        }
+        await Promise.all(promises);
+        this.connections.clear();
+    }
+}
+// Global Façade
+export const Redis = new Proxy(RedisManager, {
+    get(target, prop, receiver) {
+        if (Reflect.has(target, prop)) {
+            return Reflect.get(target, prop, receiver);
+        }
+        // Delegate unhandled properties/methods to the default connection
+        const defaultClient = target.connection();
+        const value = Reflect.get(defaultClient, prop);
+        if (typeof value === 'function') {
+            return value.bind(defaultClient);
+        }
+        return value;
+    }
+});
+//# sourceMappingURL=redis-manager.js.map

package/dist/redis/redis-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-manager.js","sourceRoot":"","sources":["../../src/redis/redis-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,MAAM,OAAO,YAAY;IACf,MAAM,CAAC,WAAW,GAAG,IAAI,GAAG,EAAuB,CAAC;IACpD,MAAM,CAAC,qBAAqB,GAAG,SAAS,CAAC;IAEjD;;OAEG;IACI,MAAM,CAAC,SAAS,CACrB,WAAmD,EACnD,iBAAiB,GAAG,SAAS;QAE7B,IAAI,CAAC,qBAAqB,GAAG,iBAAiB,CAAC;QAC/C,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YACzD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,aAAa,CAAC,IAAY,EAAE,MAAmB;QAC3D,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,UAAU,CAAC,OAAe,IAAI,CAAC,qBAAqB;QAChE,IAAI,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACtD,0DAA0D;gBAC1D,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;gBAC3B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,mBAAmB,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,KAAK,CAAC,QAAQ;QAC1B,MAAM,QAAQ,GAAG,EAAE,CAAC;QACpB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/C,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACrC,CAAC;QACD,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5B,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;;AAGH,gBAAgB;AAChB,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,YAAY,EAAE;IAC3C,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;QACxB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;YAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC7C,CAAC;QACD,kEAAkE;QAClE,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAC/C,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAsC,CAAC"}

package/dist/redis/resp-parser.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @file resp-parser.ts
+ * @description Zero-dependency Redis Serialization Protocol (RESP) parser and serializer.
+ * Supports RESP2 basic types: Simple Strings, Errors, Integers, Bulk Strings, Arrays.
+ */
+export declare class RESPError extends Error {
+    constructor(message: string);
+}
+export declare class RESP {
+    /**
+     * Serializes commands into a RESP array of bulk strings.
+     */
+    static serialize(args: (string | number | Buffer)[]): Buffer;
+    /**
+     * Parses RESP formatted buffer into JS values.
+     */
+    static parse(buffer: Buffer): {
+        value: any;
+        offset: number;
+    };
+    /**
+     * Parses multiple RESP responses from a buffer stream.
+     * Modifies the input buffer object by advancing it if partial or fully consumed.
+     */
+    static parseStream(bufferObj: {
+        buffer: Buffer;
+    }, onResponse: (err: Error | null, reply: any) => void): void;
+}
+//# sourceMappingURL=resp-parser.d.ts.map

package/dist/redis/resp-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resp-parser.d.ts","sourceRoot":"","sources":["../../src/redis/resp-parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,IAAI;IACf;;OAEG;WACW,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM;IAgBnE;;OAEG;WACW,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IA+CnE;;;OAGG;WACW,WAAW,CACvB,SAAS,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,EAC7B,UAAU,EAAE,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI;CAyBtD"}

package/dist/redis/resp-parser.js

@@ -0,0 +1,113 @@
+/**
+ * @file resp-parser.ts
+ * @description Zero-dependency Redis Serialization Protocol (RESP) parser and serializer.
+ * Supports RESP2 basic types: Simple Strings, Errors, Integers, Bulk Strings, Arrays.
+ */
+export class RESPError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'RESPError';
+    }
+}
+export class RESP {
+    /**
+     * Serializes commands into a RESP array of bulk strings.
+     */
+    static serialize(args) {
+        const parts = [];
+        parts.push(Buffer.from(`*${args.length}\r\n`));
+        for (const arg of args) {
+            const buffer = Buffer.isBuffer(arg)
+                ? arg
+                : Buffer.from(String(arg));
+            parts.push(Buffer.from(`$${buffer.length}\r\n`));
+            parts.push(buffer);
+            parts.push(Buffer.from('\r\n'));
+        }
+        return Buffer.concat(parts);
+    }
+    /**
+     * Parses RESP formatted buffer into JS values.
+     */
+    static parse(buffer) {
+        let offset = 0;
+        function readNext() {
+            if (offset >= buffer.length)
+                throw new Error('Incomplete chunk');
+            const type = buffer[offset];
+            offset++;
+            if (type === 43) { // '+' Simple String
+                return readLine().toString('utf8');
+            }
+            else if (type === 45) { // '-' Error
+                return new RESPError(readLine().toString('utf8'));
+            }
+            else if (type === 58) { // ':' Integer
+                return parseInt(readLine().toString('utf8'), 10);
+            }
+            else if (type === 36) { // '$' Bulk String
+                const len = parseInt(readLine().toString('utf8'), 10);
+                if (len === -1)
+                    return null;
+                if (offset + len + 2 > buffer.length)
+                    throw new Error('Incomplete chunk');
+                const strBuf = buffer.subarray(offset, offset + len);
+                offset += len + 2; // skip \r\n
+                return strBuf.toString('utf8');
+            }
+            else if (type === 42) { // '*' Array
+                const len = parseInt(readLine().toString('utf8'), 10);
+                if (len === -1)
+                    return null;
+                const arr = [];
+                for (let i = 0; i < len; i++) {
+                    arr.push(readNext());
+                }
+                return arr;
+            }
+            else {
+                throw new Error(`Unknown RESP type byte: ${type}`);
+            }
+        }
+        function readLine() {
+            const end = buffer.indexOf('\r\n', offset);
+            if (end === -1)
+                throw new Error('Incomplete chunk');
+            const line = buffer.subarray(offset, end);
+            offset = end + 2;
+            return line;
+        }
+        const value = readNext();
+        return { value, offset };
+    }
+    /**
+     * Parses multiple RESP responses from a buffer stream.
+     * Modifies the input buffer object by advancing it if partial or fully consumed.
+     */
+    static parseStream(bufferObj, onResponse) {
+        while (bufferObj.buffer.length > 0) {
+            let result;
+            try {
+                result = this.parse(bufferObj.buffer);
+            }
+            catch (err) {
+                if (err.message === 'Incomplete chunk') {
+                    // Wait for more data
+                    break;
+                }
+                else {
+                    // Fatal protocol error
+                    throw err;
+                }
+            }
+            if (result.value instanceof RESPError) {
+                onResponse(result.value, null);
+            }
+            else {
+                onResponse(null, result.value);
+            }
+            bufferObj.buffer = bufferObj.buffer.subarray(result.offset);
+        }
+    }
+}
+//# sourceMappingURL=resp-parser.js.map

package/dist/redis/resp-parser.js.map

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