jopi-toolkit 3.0.11 → 3.0.15

package/src/jk_tools/jBundler_ifServer.js

@@ -0,0 +1,215 @@
+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());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+export * from "./common.ts";
+import * as jk_timer from "jopi-toolkit/jk_timer";
+import { exec } from 'child_process';
+import os from 'os';
+/**
+ * Download a file or a directory from a GitHub repository.
+ */
+export function githubDownload(params) {
+    return __awaiter(this, void 0, void 0, function () {
+        function downloadFile(localPath, contentUrl) {
+            return __awaiter(this, void 0, void 0, function () {
+                var localDir, headers, response, buffer;
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0:
+                            localDir = path.dirname(localPath);
+                            headers = {};
+                            return [4 /*yield*/, fs.mkdir(localDir, { recursive: true })];
+                        case 1:
+                            _a.sent();
+                            return [4 /*yield*/, fetch(contentUrl, { headers: headers, })];
+                        case 2:
+                            response = _a.sent();
+                            if (!response.ok) {
+                                throw new Error("Github download error: ".concat(response.status, " ").concat(response.statusText));
+                            }
+                            return [4 /*yield*/, response.arrayBuffer()];
+                        case 3:
+                            buffer = _a.sent();
+                            return [4 /*yield*/, fs.writeFile(localPath, Buffer.from(buffer))];
+                        case 4:
+                            _a.sent();
+                            if (params.log)
+                                console.log("Downloaded", contentUrl);
+                            return [2 /*return*/];
+                    }
+                });
+            });
+        }
+        function fetchAndProcessContent(currentPath, downloadRoot) {
+            return __awaiter(this, void 0, void 0, function () {
+                var apiUrl, headers, response, data, isFile, contents, _i, contents_1, item, itemPath;
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0:
+                            apiUrl = "https://api.github.com/repos/".concat(repoOwner, "/").concat(repoName, "/contents/").concat(currentPath, "?ref=").concat(branchName);
+                            headers = {};
+                            return [4 /*yield*/, fetch(apiUrl, { headers: headers })];
+                        case 1:
+                            response = _a.sent();
+                            if (!response.ok) {
+                                throw new Error("Github download error: ".concat(response.status, " ").concat(response.statusText));
+                            }
+                            return [4 /*yield*/, response.json()];
+                        case 2:
+                            data = _a.sent();
+                            isFile = !Array.isArray(data) && (data.type === 'file');
+                            if (!(isFile && isFirst)) return [3 /*break*/, 4];
+                            return [4 /*yield*/, downloadFile(downloadRoot, data.download_url)];
+                        case 3:
+                            _a.sent();
+                            return [2 /*return*/];
+                        case 4:
+                            contents = Array.isArray(data) ? data : [data];
+                            isFirst = false;
+                            _i = 0, contents_1 = contents;
+                            _a.label = 5;
+                        case 5:
+                            if (!(_i < contents_1.length)) return [3 /*break*/, 11];
+                            item = contents_1[_i];
+                            // Reduce, otherwise we get a "403 rate limit exceed" error.
+                            return [4 /*yield*/, jk_timer.tick(50)];
+                        case 6:
+                            // Reduce, otherwise we get a "403 rate limit exceed" error.
+                            _a.sent();
+                            if (!(item.type === 'file' && item.download_url)) return [3 /*break*/, 8];
+                            itemPath = item.path;
+                            itemPath = itemPath.substring(pathInsideRepo.length + 1);
+                            return [4 /*yield*/, downloadFile(path.join(downloadRoot, itemPath), item.download_url)];
+                        case 7:
+                            _a.sent();
+                            return [3 /*break*/, 10];
+                        case 8:
+                            if (!(item.type === 'dir')) return [3 /*break*/, 10];
+                            return [4 /*yield*/, fetchAndProcessContent(item.path, downloadRoot)];
+                        case 9:
+                            _a.sent();
+                            _a.label = 10;
+                        case 10:
+                            _i++;
+                            return [3 /*break*/, 5];
+                        case 11: return [2 /*return*/];
+                    }
+                });
+            });
+        }
+        var isFirst, url, parts, repoOwner, repoName, tree, branchName, pathInsideRepo;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    isFirst = true;
+                    url = params.url;
+                    if (!url.startsWith("https://github.com/"))
+                        throw new Error("Invalid URL - Must be of type https://github.com/ownerName/repoName/tree/branchName/path/to/folder");
+                    url = url.substring("https://github.com/".length);
+                    parts = url.split("/").reverse();
+                    repoOwner = parts.pop();
+                    repoName = parts.pop();
+                    tree = parts.pop();
+                    if (tree !== "tree")
+                        throw new Error("Invalid URL - Must be of type https://github.com/ownerName/repoName/tree/branchName/path/to/folder");
+                    branchName = parts.pop();
+                    pathInsideRepo = parts.reverse().join("/");
+                    return [4 /*yield*/, fetchAndProcessContent(pathInsideRepo, params.downloadPath)];
+                case 1:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    });
+}
+export function killPort(port) {
+    var _this = this;
+    if (port === void 0) { port = '3000'; }
+    return new Promise(function (resolve) {
+        var isWindows = os.platform() === 'win32';
+        var command = isWindows
+            ? "netstat -ano | findstr :".concat(port)
+            : "lsof -ti :".concat(port);
+        exec(command, function (_error, stdout) {
+            if (!stdout) {
+                resolve();
+                return;
+            }
+            var pids = isWindows
+                ? __spreadArray([], new Set(stdout.trim().split('\n').map(function (line) {
+                    var parts = line.trim().split(/\s+/);
+                    return parts[parts.length - 1];
+                }).filter(function (pid) { return pid && /^\d+$/.test(pid) && pid !== '0'; })), true) : stdout.trim().split('\n');
+            var killCmd = isWindows ? 'taskkill /PID' : 'kill -9';
+            var pending = pids.length;
+            if (pending === 0) {
+                resolve();
+                return;
+            }
+            pids.forEach(function (pid) {
+                exec("".concat(killCmd, " ").concat(pid).concat(isWindows ? ' /F' : ''), function (err) { return __awaiter(_this, void 0, void 0, function () {
+                    return __generator(this, function (_a) {
+                        switch (_a.label) {
+                            case 0:
+                                if (err)
+                                    console.error("Failed to kill process ".concat(pid));
+                                else
+                                    console.log("\u26A0\uFE0F  Process ".concat(pid, " automatically killed to free the port ").concat(port));
+                                if (!(--pending === 0)) return [3 /*break*/, 2];
+                                return [4 /*yield*/, jk_timer.tick(250)];
+                            case 1:
+                                _a.sent();
+                                resolve();
+                                _a.label = 2;
+                            case 2: return [2 /*return*/];
+                        }
+                    });
+                }); });
+            });
+        });
+    });
+}

package/src/jk_tools/jBundler_ifServer.ts

@@ -3,6 +3,9 @@ import * as path from 'node:path';
 export * from "./common.ts";
 import * as jk_timer from "jopi-toolkit/jk_timer";
 
+import { exec } from 'child_process';
+import os from 'os';
+
 export interface GithubDownloadParams {
     /**
      * The file or directory to download.
@@ -33,7 +36,7 @@ export async function githubDownload(params: GithubDownloadParams) {
 
         await fs.mkdir(localDir, { recursive: true });
 
-        const response = await fetch(contentUrl, {headers: headers,});
+        const response = await fetch(contentUrl, { headers: headers, });
 
         if (!response.ok) {
             throw new Error(`Github download error: ${response.status} ${response.statusText}`);
@@ -68,7 +71,7 @@ export async function githubDownload(params: GithubDownloadParams) {
 
         for (const item of contents) {
             // Reduce, otherwise we get a "403 rate limit exceed" error.
-            await jk_timer.tick(gRateLimit);
+            await jk_timer.tick(50);
 
             if (item.type === 'file' && item.download_url) {
                 let itemPath = item.path;
@@ -91,19 +94,54 @@ export async function githubDownload(params: GithubDownloadParams) {
     let repoOwner = parts.pop();
     let repoName = parts.pop();
     let tree = parts.pop();
-    if (tree!=="tree") throw new Error("Invalid URL - Must be of type https://github.com/ownerName/repoName/tree/branchName/path/to/folder");
+    if (tree !== "tree") throw new Error("Invalid URL - Must be of type https://github.com/ownerName/repoName/tree/branchName/path/to/folder");
     let branchName = parts.pop();
     const pathInsideRepo = parts.reverse().join("/");
 
     await fetchAndProcessContent(pathInsideRepo, params.downloadPath);
 }
 
-function getRateLimit() {
-    let sLimit = process.env.GITHUB_API_LIMIT_SECONDS;
-    if (!sLimit) return 50;
-    let res = parseInt(sLimit);
-    if (isNaN(res)) return 50;
-    return res;
-}
 
-const gRateLimit = getRateLimit();
+export function killPort(port: string = '3000'): Promise<void> {
+    return new Promise<void>((resolve) => {
+        const isWindows = os.platform() === 'win32';
+
+        const command = isWindows
+            ? `netstat -ano | findstr :${port}`
+            : `lsof -ti :${port}`;
+
+        exec(command, (_error, stdout) => {
+            if (!stdout) {
+                resolve();
+                return;
+            }
+
+            const pids = isWindows
+                ? [...new Set(stdout.trim().split('\n').map(line => {
+                    const parts = line.trim().split(/\s+/);
+                    return parts[parts.length - 1];
+                }).filter(pid => pid && /^\d+$/.test(pid) && pid !== '0'))]
+                : stdout.trim().split('\n');
+
+            const killCmd = isWindows ? 'taskkill /PID' : 'kill -9';
+            let pending = pids.length;
+
+            if (pending === 0) {
+                resolve();
+                return;
+            }
+
+            pids.forEach(pid => {
+                exec(`${killCmd} ${pid}${isWindows ? ' /F' : ''}`, async (err) => {
+                    if (err) console.error(`Failed to kill process ${pid}`);
+                    else console.log(`⚠️  Process ${pid} automatically killed to free the port ${port}`);
+
+                    if (--pending === 0) {
+                        await jk_timer.tick(250);
+                        resolve();
+                    }
+                });
+            });
+        });
+    });
+}

package/src/jk_translate/index.js

@@ -0,0 +1,56 @@
+var gCurrentLanguage = 'en';
+var gTranslations = {};
+export function setLanguage(languageName) {
+    gCurrentLanguage = languageName;
+}
+export function translate(key, p) {
+    return translateTo(gCurrentLanguage, key, p);
+}
+export function translateTo(language, key, p) {
+    // Does it exist?
+    if (!gTranslations[language]) {
+        gTranslations[language] = {};
+    }
+    var translation;
+    // Must use plural?
+    //
+    var translationKey = key;
+    //
+    if ((p.count !== undefined) && (p.count > 1)) {
+        var pluralKey = "".concat(key, "_plural");
+        translation = gTranslations[language][pluralKey];
+    }
+    // Get the translation.
+    if (!translation) {
+        translation = gTranslations[language][translationKey];
+    }
+    // Not found?
+    if (!translation) {
+        if (p.default) {
+            gTranslations[language][translationKey] = p.default;
+            return p.default;
+        }
+        translation = "[trNotFound:".concat(key, "]");
+    }
+    // Replace the parameters in the translation.
+    if (p.params && translation.includes("$")) {
+        for (var _i = 0, _a = Object.entries(p.params); _i < _a.length; _i++) {
+            var _b = _a[_i], paramKey = _b[0], paramValue = _b[1];
+            var placeholder = "$" + paramKey;
+            translation = translation.replace(placeholder, String(paramValue));
+        }
+    }
+    return translation;
+}
+export function addTranslation(language, key, value) {
+    if (!gTranslations[language]) {
+        gTranslations[language] = {};
+    }
+    gTranslations[language][key] = value;
+}
+export function addTranslations(language, newTranslations) {
+    if (!gTranslations[language]) {
+        gTranslations[language] = {};
+    }
+    Object.assign(gTranslations[language], newTranslations);
+}

package/src/jk_what/jBundler_ifServer.js

@@ -0,0 +1,5 @@
+export var isNodeJS = typeof (Bun) === "undefined";
+export var isBunJS = typeof (Bun) !== "undefined";
+export var isServerSide = true;
+export var isBrowser = false;
+export var serverType = isNodeJS ? "node" : "bun";

package/src/jk_os/jBundler_ifServer.js

@@ -1,132 +0,0 @@
-"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());
-    });
-};
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
-    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (g && (g = 0, op[0] && (_ = 0)), _) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.whichSync = whichSync;
-exports.exec = exec;
-var node_child_process_1 = require("node:child_process");
-var node_process_1 = require("node:process");
-var path = require("node:path");
-var fs = require("node:fs/promises");
-var node_fs_1 = require("node:fs");
-function which(command, ifNotFound) {
-    return __awaiter(this, void 0, void 0, function () {
-        var pathArray, extensions, _i, pathArray_1, dir, _a, extensions_1, ext, fullPath, stats, _b;
-        return __generator(this, function (_c) {
-            switch (_c.label) {
-                case 0:
-                    pathArray = (node_process_1.env.PATH || '').split(process.platform === 'win32' ? ';' : ':');
-                    extensions = process.platform === 'win32' ? ['.exe', '.cmd', '.bat'] : [''];
-                    _i = 0, pathArray_1 = pathArray;
-                    _c.label = 1;
-                case 1:
-                    if (!(_i < pathArray_1.length)) return [3 /*break*/, 8];
-                    dir = pathArray_1[_i];
-                    _a = 0, extensions_1 = extensions;
-                    _c.label = 2;
-                case 2:
-                    if (!(_a < extensions_1.length)) return [3 /*break*/, 7];
-                    ext = extensions_1[_a];
-                    fullPath = path.join(dir, command + ext);
-                    _c.label = 3;
-                case 3:
-                    _c.trys.push([3, 5, , 6]);
-                    return [4 /*yield*/, fs.stat(fullPath)];
-                case 4:
-                    stats = _c.sent();
-                    if (stats.isFile())
-                        return [2 /*return*/, fullPath];
-                    return [3 /*break*/, 6];
-                case 5:
-                    _b = _c.sent();
-                    return [3 /*break*/, 6];
-                case 6:
-                    _a++;
-                    return [3 /*break*/, 2];
-                case 7:
-                    _i++;
-                    return [3 /*break*/, 1];
-                case 8:
-                    if (ifNotFound)
-                        return [2 /*return*/, ifNotFound];
-                    return [2 /*return*/, null];
-            }
-        });
-    });
-}
-function whichSync(cmd, ifNotFound) {
-    var paths = (process.env.PATH || '').split(path.delimiter);
-    if (process.platform === 'win32') {
-        var extToTest = process.env.PATHEXT ? process.env.PATHEXT.split(';') : ['.EXE', '.CMD', '.BAT'];
-        for (var _i = 0, paths_1 = paths; _i < paths_1.length; _i++) {
-            var p = paths_1[_i];
-            for (var _a = 0, extToTest_1 = extToTest; _a < extToTest_1.length; _a++) {
-                var ext = extToTest_1[_a];
-                var full = path.join(p, cmd + ext.toLowerCase());
-                if (node_fs_1.default.existsSync(full))
-                    return full;
-                var fullUpper = path.join(p, cmd + ext);
-                if (node_fs_1.default.existsSync(fullUpper))
-                    return fullUpper;
-            }
-        }
-    }
-    else {
-        for (var _b = 0, paths_2 = paths; _b < paths_2.length; _b++) {
-            var p = paths_2[_b];
-            var full = path.join(p, cmd);
-            if (node_fs_1.default.existsSync(full))
-                return full;
-            var fullUpper = path.join(p, cmd);
-            if (node_fs_1.default.existsSync(fullUpper))
-                return fullUpper;
-        }
-    }
-    if (ifNotFound)
-        return ifNotFound;
-    return null;
-}
-function exec(command) {
-    return new Promise(function (resolve, reject) {
-        (0, node_child_process_1.exec)(command, function (error) {
-            if (error)
-                reject(error);
-            else
-                resolve();
-        });
-    });
-}