redis-smq-common 8.0.0-rc.30 → 8.0.0-rc.31

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [8.0.0-rc.31](https://github.com/weyoss/redis-smq/compare/v8.0.0-rc.30...v8.0.0-rc.31) (2025-03-22)
+
+### ⚠ BREAKING CHANGES
+
+- merge redis-server and net utils into redis-smq-common
+
+### ♻️ Code Refactoring
+
+- merge redis-server and net utils into redis-smq-common ([3591e20](https://github.com/weyoss/redis-smq/commit/3591e2060dec07ed05d13dba7b3a6154b5bc8057))
+
 ## [8.0.0-rc.30](https://github.com/weyoss/redis-smq/compare/v8.0.0-rc.29...v8.0.0-rc.30) (2025-03-21)
 
 ### 🚀 Chore

package/dist/cjs/index.d.ts

@@ -11,4 +11,6 @@ export * from './src/redis-client/index.js';
 export * from './src/runnable/index.js';
 export * from './src/timer/index.js';
 export * from './src/worker/index.js';
+export * from './src/net/index.js';
+export * from './src/redis-server/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.js

@@ -27,4 +27,6 @@ __exportStar(require("./src/redis-client/index.js"), exports);
 __exportStar(require("./src/runnable/index.js"), exports);
 __exportStar(require("./src/timer/index.js"), exports);
 __exportStar(require("./src/worker/index.js"), exports);
+__exportStar(require("./src/net/index.js"), exports);
+__exportStar(require("./src/redis-server/index.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/src/env/index.d.ts

@@ -1,2 +1,2 @@
-export * from './environment.js';
+export declare function getDirname(): string;
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/src/env/index.js

@@ -1,18 +1,35 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./environment.js"), exports);
+exports.getDirname = getDirname;
+const path_1 = require("path");
+function isStackTraces(stack) {
+    return Array.isArray(stack);
+}
+function getDirname() {
+    const originalPrepareStackTrace = Error.prepareStackTrace;
+    try {
+        Error.prepareStackTrace = (_, stackTraces) => stackTraces;
+        const err = new Error();
+        const stack = err.stack;
+        if (!isStackTraces(stack) || stack.length < 2) {
+            throw new Error('Invalid stack trace');
+        }
+        const callSite = stack[1];
+        const filename = callSite.getFileName();
+        if (!filename) {
+            throw new Error('Unable to determine filename from stack trace');
+        }
+        const cleanFilename = filename.startsWith('file://')
+            ? filename.slice(7)
+            : filename;
+        return (0, path_1.dirname)(cleanFilename);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to get current directory: ${errorMessage}`);
+    }
+    finally {
+        Error.prepareStackTrace = originalPrepareStackTrace;
+    }
+}
 //# sourceMappingURL=index.js.map

package/dist/cjs/src/net/index.d.ts

@@ -0,0 +1,8 @@
+declare function isPortInUse(port: number): Promise<boolean>;
+declare function getRandomPort(): Promise<number>;
+export declare const net: {
+    isPortInUse: typeof isPortInUse;
+    getRandomPort: typeof getRandomPort;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/src/net/index.js

@@ -0,0 +1,52 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.net = void 0;
+const net_1 = require("net");
+function isPortInUse(port) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return new Promise((resolve) => {
+            const server = (0, net_1.createServer)()
+                .once('error', (err) => {
+                if (err.code === 'EADDRINUSE') {
+                    resolve(true);
+                }
+                else {
+                    resolve(false);
+                }
+            })
+                .once('listening', () => {
+                server.close();
+                resolve(false);
+            })
+                .listen(port, '127.0.0.1');
+        });
+    });
+}
+function getRandomPort() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const MIN_PORT = 1024;
+        const MAX_PORT = 65535;
+        const MAX_ATTEMPTS = 100;
+        for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {
+            const port = Math.floor(Math.random() * (MAX_PORT - MIN_PORT + 1)) + MIN_PORT;
+            if (!(yield isPortInUse(port))) {
+                return port;
+            }
+        }
+        throw new Error('Unable to find an available port after multiple attempts');
+    });
+}
+exports.net = {
+    isPortInUse,
+    getRandomPort,
+};
+//# sourceMappingURL=index.js.map

package/dist/cjs/src/redis-server/index.d.ts

@@ -0,0 +1,6 @@
+export declare const redisServer: {
+    startRedisServer(redisPort?: number): Promise<number>;
+    shutdownRedisServer(port: number): Promise<void>;
+    cleanUp(): Promise<void>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/src/redis-server/index.js

@@ -0,0 +1,119 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.redisServer = void 0;
+const child_process_1 = require("child_process");
+const node_util_1 = require("node:util");
+const index_js_1 = require("../net/index.js");
+const execPromise = (0, node_util_1.promisify)(child_process_1.exec);
+const PROCESS_MAP = new Map();
+function getRedisBinPath() {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const { stdout } = yield execPromise('which redis-server || where redis-server');
+            return stdout.trim() || null;
+        }
+        catch (_a) {
+            return null;
+        }
+    });
+}
+function handleExit() {
+    return () => __awaiter(this, void 0, void 0, function* () {
+        yield exports.redisServer.cleanUp();
+        process.exit(0);
+    });
+}
+exports.redisServer = {
+    startRedisServer(redisPort) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const redisBinPath = yield getRedisBinPath();
+            if (!redisBinPath) {
+                throw new Error('Redis binary not found.');
+            }
+            const port = redisPort !== null && redisPort !== void 0 ? redisPort : (yield index_js_1.net.getRandomPort());
+            if (PROCESS_MAP.has(port)) {
+                throw new Error(`Redis server is already running on port ${port}.`);
+            }
+            const process = (0, child_process_1.spawn)(redisBinPath, [
+                '--appendonly',
+                'no',
+                '--save',
+                '',
+                '--port',
+                port.toString(),
+            ]);
+            PROCESS_MAP.set(port, process);
+            process.stderr.on('data', (data) => {
+                console.error(`Redis stderr (${port}): ${data.toString().trim()}`);
+            });
+            return new Promise((resolve, reject) => {
+                const timeout = setTimeout(() => {
+                    cleanup();
+                    reject(new Error('Redis server start timeout'));
+                }, 10000);
+                const cleanup = () => {
+                    clearTimeout(timeout);
+                    process.stdout.removeListener('data', dataListener);
+                    process.removeListener('error', errorListener);
+                    process.removeListener('exit', exitListener);
+                };
+                const dataListener = (data) => {
+                    if (data.toString().includes('Ready to accept connections')) {
+                        cleanup();
+                        resolve(port);
+                    }
+                };
+                const errorListener = (error) => {
+                    cleanup();
+                    PROCESS_MAP.delete(port);
+                    reject(error);
+                };
+                const exitListener = (code) => {
+                    cleanup();
+                    PROCESS_MAP.delete(port);
+                    reject(new Error(`Redis server exited with code ${code}`));
+                };
+                process.stdout.on('data', dataListener);
+                process.on('error', errorListener);
+                process.on('exit', exitListener);
+            });
+        });
+    },
+    shutdownRedisServer(port) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const process = PROCESS_MAP.get(port);
+            if (!process)
+                return;
+            return new Promise((resolve, reject) => {
+                const timeout = setTimeout(() => {
+                    process.kill('SIGKILL');
+                    reject(new Error(`Redis server at port ${port} did not shut down gracefully.`));
+                }, 5000);
+                const cleanup = () => {
+                    clearTimeout(timeout);
+                    PROCESS_MAP.delete(port);
+                    resolve();
+                };
+                process.once('close', cleanup);
+                process.kill('SIGTERM');
+            });
+        });
+    },
+    cleanUp() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield Promise.all(Array.from(PROCESS_MAP.keys()).map(this.shutdownRedisServer));
+        });
+    },
+};
+process.on('SIGINT', handleExit);
+process.on('SIGTERM', handleExit);
+//# sourceMappingURL=index.js.map

package/dist/esm/index.d.ts

@@ -11,4 +11,6 @@ export * from './src/redis-client/index.js';
 export * from './src/runnable/index.js';
 export * from './src/timer/index.js';
 export * from './src/worker/index.js';
+export * from './src/net/index.js';
+export * from './src/redis-server/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/index.js

@@ -11,4 +11,6 @@ export * from './src/redis-client/index.js';
 export * from './src/runnable/index.js';
 export * from './src/timer/index.js';
 export * from './src/worker/index.js';
+export * from './src/net/index.js';
+export * from './src/redis-server/index.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/src/env/index.d.ts

@@ -1,2 +1,2 @@
-export * from './environment.js';
+export declare function getDirname(): string;
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/src/env/index.js

@@ -1,2 +1,32 @@
-export * from './environment.js';
+import { dirname } from 'path';
+function isStackTraces(stack) {
+    return Array.isArray(stack);
+}
+export function getDirname() {
+    const originalPrepareStackTrace = Error.prepareStackTrace;
+    try {
+        Error.prepareStackTrace = (_, stackTraces) => stackTraces;
+        const err = new Error();
+        const stack = err.stack;
+        if (!isStackTraces(stack) || stack.length < 2) {
+            throw new Error('Invalid stack trace');
+        }
+        const callSite = stack[1];
+        const filename = callSite.getFileName();
+        if (!filename) {
+            throw new Error('Unable to determine filename from stack trace');
+        }
+        const cleanFilename = filename.startsWith('file://')
+            ? filename.slice(7)
+            : filename;
+        return dirname(cleanFilename);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to get current directory: ${errorMessage}`);
+    }
+    finally {
+        Error.prepareStackTrace = originalPrepareStackTrace;
+    }
+}
 //# sourceMappingURL=index.js.map

package/dist/esm/src/net/index.d.ts

@@ -0,0 +1,8 @@
+declare function isPortInUse(port: number): Promise<boolean>;
+declare function getRandomPort(): Promise<number>;
+export declare const net: {
+    isPortInUse: typeof isPortInUse;
+    getRandomPort: typeof getRandomPort;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/src/net/index.js

@@ -0,0 +1,36 @@
+import { createServer } from 'net';
+async function isPortInUse(port) {
+    return new Promise((resolve) => {
+        const server = createServer()
+            .once('error', (err) => {
+            if (err.code === 'EADDRINUSE') {
+                resolve(true);
+            }
+            else {
+                resolve(false);
+            }
+        })
+            .once('listening', () => {
+            server.close();
+            resolve(false);
+        })
+            .listen(port, '127.0.0.1');
+    });
+}
+async function getRandomPort() {
+    const MIN_PORT = 1024;
+    const MAX_PORT = 65535;
+    const MAX_ATTEMPTS = 100;
+    for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {
+        const port = Math.floor(Math.random() * (MAX_PORT - MIN_PORT + 1)) + MIN_PORT;
+        if (!(await isPortInUse(port))) {
+            return port;
+        }
+    }
+    throw new Error('Unable to find an available port after multiple attempts');
+}
+export const net = {
+    isPortInUse,
+    getRandomPort,
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/src/redis-server/index.d.ts

@@ -0,0 +1,6 @@
+export declare const redisServer: {
+    startRedisServer(redisPort?: number): Promise<number>;
+    shutdownRedisServer(port: number): Promise<void>;
+    cleanUp(): Promise<void>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/src/redis-server/index.js

@@ -0,0 +1,99 @@
+import { spawn, exec } from 'child_process';
+import { promisify } from 'node:util';
+import { net } from '../net/index.js';
+const execPromise = promisify(exec);
+const PROCESS_MAP = new Map();
+async function getRedisBinPath() {
+    try {
+        const { stdout } = await execPromise('which redis-server || where redis-server');
+        return stdout.trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+function handleExit() {
+    return async () => {
+        await redisServer.cleanUp();
+        process.exit(0);
+    };
+}
+export const redisServer = {
+    async startRedisServer(redisPort) {
+        const redisBinPath = await getRedisBinPath();
+        if (!redisBinPath) {
+            throw new Error('Redis binary not found.');
+        }
+        const port = redisPort ?? (await net.getRandomPort());
+        if (PROCESS_MAP.has(port)) {
+            throw new Error(`Redis server is already running on port ${port}.`);
+        }
+        const process = spawn(redisBinPath, [
+            '--appendonly',
+            'no',
+            '--save',
+            '',
+            '--port',
+            port.toString(),
+        ]);
+        PROCESS_MAP.set(port, process);
+        process.stderr.on('data', (data) => {
+            console.error(`Redis stderr (${port}): ${data.toString().trim()}`);
+        });
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                cleanup();
+                reject(new Error('Redis server start timeout'));
+            }, 10000);
+            const cleanup = () => {
+                clearTimeout(timeout);
+                process.stdout.removeListener('data', dataListener);
+                process.removeListener('error', errorListener);
+                process.removeListener('exit', exitListener);
+            };
+            const dataListener = (data) => {
+                if (data.toString().includes('Ready to accept connections')) {
+                    cleanup();
+                    resolve(port);
+                }
+            };
+            const errorListener = (error) => {
+                cleanup();
+                PROCESS_MAP.delete(port);
+                reject(error);
+            };
+            const exitListener = (code) => {
+                cleanup();
+                PROCESS_MAP.delete(port);
+                reject(new Error(`Redis server exited with code ${code}`));
+            };
+            process.stdout.on('data', dataListener);
+            process.on('error', errorListener);
+            process.on('exit', exitListener);
+        });
+    },
+    async shutdownRedisServer(port) {
+        const process = PROCESS_MAP.get(port);
+        if (!process)
+            return;
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                process.kill('SIGKILL');
+                reject(new Error(`Redis server at port ${port} did not shut down gracefully.`));
+            }, 5000);
+            const cleanup = () => {
+                clearTimeout(timeout);
+                PROCESS_MAP.delete(port);
+                resolve();
+            };
+            process.once('close', cleanup);
+            process.kill('SIGTERM');
+        });
+    },
+    async cleanUp() {
+        await Promise.all(Array.from(PROCESS_MAP.keys()).map(this.shutdownRedisServer));
+    },
+};
+process.on('SIGINT', handleExit);
+process.on('SIGTERM', handleExit);
+//# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "redis-smq-common",
-  "version": "8.0.0-rc.30",
+  "version": "8.0.0-rc.31",
   "description": "RedisSMQ Common Library provides many components that are mainly used by RedisSMQ and RedisSMQ Monitor.",
   "author": "Weyoss <weyoss@protonmail.com>",
   "license": "MIT",
@@ -67,14 +67,6 @@
     "lodash": "4.17.21",
     "uuid": "11.1.0"
   },
-  "devDependencies": {
-    "redis-smq-tools": "^8.0.0-rc.30"
-  },
-  "scripts": {
-    "test": "../../scripts/test_workspace_esm.sh",
-    "build": "scripts/build.sh",
-    "document": "scripts/document.sh"
-  },
   "engineStrict": true,
   "engines": {
     "node": ">=20"
@@ -86,5 +78,9 @@
     "type": "git",
     "url": "https://github.com/weyoss/redis-smq.git"
   },
-  "gitHead": "e04865007e982e10b31d77a469a85f78d41182ab"
-}
+  "scripts": {
+    "test": "../../scripts/test_workspace_esm.sh",
+    "build": "scripts/build.sh",
+    "document": "scripts/document.sh"
+  }
+}

package/LICENSE

@@ -1,22 +0,0 @@
-MIT License
-
-Copyright (c) Weyoss <weyoss@protonmail.com>, https://github.com/weyoss
-
-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/dist/cjs/src/env/environment.d.ts

@@ -1,2 +0,0 @@
-export declare function getDirname(): string;
-//# sourceMappingURL=environment.d.ts.map

package/dist/cjs/src/env/environment.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDirname = getDirname;
-const path_1 = require("path");
-const index_js_1 = require("../errors/index.js");
-function isStackTraces(stack) {
-    return !!(stack && Array.isArray(stack));
-}
-function getDirname() {
-    const prepareStackTrace = Error.prepareStackTrace;
-    Error.prepareStackTrace = (err, stackTraces) => {
-        return stackTraces;
-    };
-    const err = new Error();
-    const stack = err.stack;
-    Error.prepareStackTrace = prepareStackTrace;
-    if (isStackTraces(stack)) {
-        const filename = stack[1].getFileName();
-        if (filename) {
-            const cleanFilename = filename.startsWith('file://')
-                ? filename.substring(7)
-                : filename;
-            return (0, path_1.dirname)(cleanFilename);
-        }
-    }
-    throw new index_js_1.PanicError(`Could not get current dir`);
-}
-//# sourceMappingURL=environment.js.map

package/dist/esm/src/env/environment.d.ts

@@ -1,2 +0,0 @@
-export declare function getDirname(): string;
-//# sourceMappingURL=environment.d.ts.map

package/dist/esm/src/env/environment.js

@@ -1,25 +0,0 @@
-import { dirname } from 'path';
-import { PanicError } from '../errors/index.js';
-function isStackTraces(stack) {
-    return !!(stack && Array.isArray(stack));
-}
-export function getDirname() {
-    const prepareStackTrace = Error.prepareStackTrace;
-    Error.prepareStackTrace = (err, stackTraces) => {
-        return stackTraces;
-    };
-    const err = new Error();
-    const stack = err.stack;
-    Error.prepareStackTrace = prepareStackTrace;
-    if (isStackTraces(stack)) {
-        const filename = stack[1].getFileName();
-        if (filename) {
-            const cleanFilename = filename.startsWith('file://')
-                ? filename.substring(7)
-                : filename;
-            return dirname(cleanFilename);
-        }
-    }
-    throw new PanicError(`Could not get current dir`);
-}
-//# sourceMappingURL=environment.js.map