jopi-toolkit 3.0.5 → 3.0.11

package/dist/jk_tools/index.js

@@ -1,72 +1,2 @@
-export function generateUUIDv4() {
-    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
-        return crypto.randomUUID();
-    }
-    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
-        const r = Math.random() * 16 | 0;
-        const v = c === 'x' ? r : (r & 0x3 | 0x8);
-        return v.toString(16);
-    });
-}
-export function isUUIDv4(text) {
-    return /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(text);
-}
-export function getErrorMessage(e) {
-    if (e instanceof Error)
-        return e.message;
-    return "" + e;
-}
-export function applyDefaults(source, defaults) {
-    if (!source)
-        source = {};
-    return { ...defaults, ...source };
-}
-/**
- * Allow knowing the file path of the function calling us.
- */
-export function getCallerFilePath() {
-    try {
-        throw new Error("");
-    }
-    catch (e) {
-        let error = e;
-        if (!error.stack)
-            return undefined;
-        const stackLines = error.stack.split('\n');
-        if (stackLines.length < 4)
-            return undefined;
-        // Here we have something like:
-        // at file:///Users/johan/Projets/jopi-rewrite-workspace/__tests/jopi-ui-sample/dist/mod_sample/routes/tests/test3.page.js:4:1
-        //
-        let fileUrl = stackLines[3].trim();
-        let idx = fileUrl.indexOf("file://");
-        fileUrl = fileUrl.substring(idx);
-        idx = fileUrl.lastIndexOf(":");
-        fileUrl = fileUrl.substring(0, idx);
-        idx = fileUrl.lastIndexOf(":");
-        if (idx !== -1)
-            fileUrl = fileUrl.substring(0, idx);
-        return fileUrl;
-    }
-}
-export var PriorityLevel;
-(function (PriorityLevel) {
-    PriorityLevel[PriorityLevel["veryLow"] = -200] = "veryLow";
-    PriorityLevel[PriorityLevel["low"] = -100] = "low";
-    PriorityLevel[PriorityLevel["default"] = 0] = "default";
-    PriorityLevel[PriorityLevel["high"] = 100] = "high";
-    PriorityLevel[PriorityLevel["veryHigh"] = 200] = "veryHigh";
-})(PriorityLevel || (PriorityLevel = {}));
-export function sortByPriority(values) {
-    if (values === undefined)
-        return undefined;
-    values.sort((a, b) => {
-        if (a.priority < b.priority)
-            return -1;
-        if (a.priority > b.priority)
-            return 1;
-        return 0;
-    });
-    return values.map(v => v.value);
-}
+export * from "./jBundler_ifServer.js";
 //# sourceMappingURL=index.js.map

package/dist/jk_tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jk_tools/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jk_tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/dist/jk_tools/jBundler_ifBrowser.d.ts

@@ -0,0 +1 @@
+export * from "./common.ts";

package/dist/jk_tools/jBundler_ifBrowser.js

@@ -0,0 +1,2 @@
+export * from "./common.js";
+//# sourceMappingURL=jBundler_ifBrowser.js.map

package/dist/jk_tools/jBundler_ifBrowser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jBundler_ifBrowser.js","sourceRoot":"","sources":["../../src/jk_tools/jBundler_ifBrowser.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/jk_tools/jBundler_ifServer.d.ts

@@ -0,0 +1,22 @@
+export * from "./common.ts";
+export interface GithubDownloadParams {
+    /**
+     * The file or directory to download.
+     * Must be of type: https://github.com/ownerName/repoName/tree/branchName/path/to/folder
+     */
+    url: string;
+    /**
+     * Where to save the files.
+     * If downloading a directory: download the directory inside this folder.
+     * If downloading a file: this path is the name of the downloaded file.
+     */
+    downloadPath: string;
+    /**
+     * If true, then log the download progress.
+     */
+    log?: boolean;
+}
+/**
+ * Download a file or a directory from a GitHub repository.
+ */
+export declare function githubDownload(params: GithubDownloadParams): Promise<void>;

package/dist/jk_tools/jBundler_ifServer.js

@@ -0,0 +1,75 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+export * from "./common.js";
+import * as jk_timer from "jopi-toolkit/jk_timer";
+/**
+ * Download a file or a directory from a GitHub repository.
+ */
+export async function githubDownload(params) {
+    async function downloadFile(localPath, contentUrl) {
+        const localDir = path.dirname(localPath);
+        const headers = {};
+        await fs.mkdir(localDir, { recursive: true });
+        const response = await fetch(contentUrl, { headers: headers, });
+        if (!response.ok) {
+            throw new Error(`Github download error: ${response.status} ${response.statusText}`);
+        }
+        const buffer = await response.arrayBuffer();
+        await fs.writeFile(localPath, Buffer.from(buffer));
+        if (params.log)
+            console.log("Downloaded", contentUrl);
+    }
+    async function fetchAndProcessContent(currentPath, downloadRoot) {
+        const apiUrl = `https://api.github.com/repos/${repoOwner}/${repoName}/contents/${currentPath}?ref=${branchName}`;
+        const headers = {};
+        const response = await fetch(apiUrl, { headers });
+        if (!response.ok) {
+            throw new Error(`Github download error: ${response.status} ${response.statusText}`);
+        }
+        const data = await response.json();
+        const isFile = !Array.isArray(data) && (data.type === 'file');
+        if (isFile && isFirst) {
+            await downloadFile(downloadRoot, data.download_url);
+            return;
+        }
+        const contents = Array.isArray(data) ? data : [data];
+        isFirst = false;
+        for (const item of contents) {
+            // Reduce, otherwise we get a "403 rate limit exceed" error.
+            await jk_timer.tick(gRateLimit);
+            if (item.type === 'file' && item.download_url) {
+                let itemPath = item.path;
+                itemPath = itemPath.substring(pathInsideRepo.length + 1);
+                await downloadFile(path.join(downloadRoot, itemPath), item.download_url);
+            }
+            else if (item.type === 'dir') {
+                await fetchAndProcessContent(item.path, downloadRoot);
+            }
+        }
+    }
+    let isFirst = true;
+    let 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);
+    let parts = url.split("/").reverse();
+    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");
+    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();
+//# sourceMappingURL=jBundler_ifServer.js.map

package/dist/jk_tools/jBundler_ifServer.js.map

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

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "3.0.5",
+  "version": "3.0.11",
   "name": "jopi-toolkit",
   "license": "MIT",
   "homepage": "https://github.com/johanpiquet/jopi-toolkit",
@@ -21,20 +21,23 @@
     "clean": "rm -rf ./dist .turbo tsconfig.tsbuildinfo",
     "tsc": "tsc",
     "bun-publish": "npx tsc && bun publish",
-    "untrack": "git rm -r --cached -- ./dist/**;"
+    "untrack": "git rm -r --cached -- ./dist/**;",
+    "jopiLink": "npx jopi-mono link-add"
   },
   "devDependencies": {
+    "@types/adm-zip": "^0.5.7",
     "@types/bun": "latest",
     "@types/mime-types": "latest",
     "@types/node": "latest"
   },
   "dependencies": {
     "@types/ws": "^8.18.1",
+    "adm-zip": "^0.5.9",
     "mime-types": "^3.0.1",
     "ws": "^8.18.3"
   },
-  "publishedDate": "11/19/2025",
-  "publicPublishedDate": "11/19/2025",
+  "publishedDate": "12/8/2025",
+  "publicPublishedDate": "12/8/2025",
   "exports": {
     "./jk_schema": {
       "bun": "./src/jk_schemas/index.ts",
@@ -95,6 +98,10 @@
     "./jk_webSocket": {
       "bun": "./src/jk_webSocket/index.ts",
       "default": "./dist/jk_webSocket/index.js"
+    },
+    "./jk_logs": {
+      "bun": "./src/jk_logs/index.ts",
+      "default": "./dist/jk_logs/index.js"
     }
   }
 }

package/src/jk_crypto/jBundler_ifServer.ts

@@ -1,20 +1,20 @@
 import crypto from "node:crypto";
 import {isNodeJS} from "jopi-toolkit/jk_what";
 
-function node_md5(text: string): string {
-    return crypto.createHash('md5').update(text).digest('hex');
+function node_md5(data: string | Uint8Array): string {
+    return crypto.createHash('md5').update(data).digest('hex');
 }
 
-function node_fastHash(text: string): string {
-    return crypto.createHash('sha256').update(text).digest('hex');
+function node_fastHash(data: string | Uint8Array): string {
+    return crypto.createHash('sha256').update(data).digest('hex');
 }
 
-function bun_fastHash(text: string): string {
-    return Bun.hash(text).toString();
+function bun_fastHash(data: string | Uint8Array): string {
+    return Bun.hash(data, 12346).toString();
 }
 
-function bun_md5(text: string): string {
-    return Bun.MD5.hash(text, "hex");
+function bun_md5(data: string | Uint8Array): string {
+    return Bun.MD5.hash(data, "hex");
 }
 
 export const md5 = isNodeJS ? node_md5 : bun_md5;

package/src/jk_events/index.ts

@@ -43,6 +43,10 @@ export class EventGroup {
     }
 
     async sendAsyncEvent(eventName: string, e?: any|undefined): Promise<void> {
+        if (eventName[0]!=='@') {
+            throw new Error(`Async events ${eventName} must start with @`);
+        }
+
         if (this.evenSpy) this.evenSpy(eventName, e);
 
         let events = this.listenersFor[eventName];
@@ -135,7 +139,15 @@ interface PriorityArrayEntry<T> {
 
 //endregion
 
-export class StaticEvent {
+export interface StaticEvent {
+    send<T>(data: T): T;
+}
+
+export interface SEventController {
+    addListener(listener: SyncEventListener): (() => void);
+}
+
+class StaticEventImpl implements StaticEvent, SEventController {
     constructor(public readonly eventName: string, private readonly eventItems: SyncEventListener[]) {
     }
 
@@ -146,10 +158,19 @@ export class StaticEvent {
 
         return data;
     }
+
+    addListener(listener: SyncEventListener): () => void {
+        this.eventItems.push(listener);
+
+        return () => {
+            let idx = this.eventItems.indexOf(listener);
+            if (idx >= 0) this.eventItems.splice(idx, 1);
+        };
+    }
 }
 
-export function createStaticEvent(eventName: string, eventItems: EventListener[]): StaticEvent {
-    return new StaticEvent(eventName, eventItems);
+export function createStaticEvent(eventName: string, eventItems: SyncEventListener[]): StaticEvent {
+    return new StaticEventImpl(eventName, eventItems);
 }
 
 export const defaultEventGroup = new EventGroup();

package/src/jk_fs/jBundler_ifBrowser.ts

@@ -56,7 +56,7 @@ export async function writeTextToFile(filePath: string, text: string, createDir:
     throw new Error("Not implemented");
 }
 
-export function writeTextSyncToFile(filePath: string, text: string, createDir: boolean = true): void {
+export function writeTextToFileSync(filePath: string, text: string, createDir: boolean = true): void {
     throw new Error("Not implemented");
 }
 
@@ -64,7 +64,7 @@ export function readTextFromFile(filePath: string): Promise<string> {
     throw new Error("Not implemented");
 }
 
-export function readTextSyncFromFile(filePath: string): string {
+export function readTextFromFileSync(filePath: string): string {
     throw new Error("Not implemented");
 }
 

package/src/jk_fs/jBundler_ifServer.ts

@@ -1,13 +1,15 @@
 // noinspection JSUnusedGlobalSymbols
 
 import fs from "node:fs/promises";
-import fss, {createReadStream} from "node:fs";
+import fss, {createReadStream, createWriteStream} from "node:fs";
 import {fileURLToPath as n_fileURLToPath, pathToFileURL as n_pathToFileURL } from "node:url";
 import {lookup} from "mime-types";
 import {Readable} from "node:stream";
 import path from "node:path";
+import {createHash} from "node:crypto";
 import {isBunJS} from "jopi-toolkit/jk_what";
 import type {DirItem, FileState} from "./common.ts";
+import AdmZip from 'adm-zip';
 
 class WebToNodeReadableStreamAdapter extends Readable {
     private webStreamReader: ReadableStreamDefaultReader<any>;
@@ -170,7 +172,7 @@ export async function writeTextToFile(filePath: string, text: string, createDir:
     await fs.writeFile(filePath, text, {encoding: 'utf8', flag: 'w'});
 }
 
-export function writeTextSyncToFile(filePath: string, text: string, createDir: boolean = true): void {
+export function writeTextToFileSync(filePath: string, text: string, createDir: boolean = true): void {
     if (createDir) {
         try {
             fss.mkdirSync(path.dirname(filePath), {recursive: true});
@@ -183,7 +185,12 @@ export function readTextFromFile(filePath: string): Promise<string> {
     return fs.readFile(filePath, 'utf8');
 }
 
-export function readTextSyncFromFile(filePath: string): string {
+export async function readJsonFromFile<T = any>(filePath: string): Promise<T> {
+    let txt = await fs.readFile(filePath, 'utf8');
+    return JSON.parse(txt) as T;
+}
+
+export function readTextFromFileSync(filePath: string): string {
     return fss.readFileSync(filePath, 'utf8');
 }
 
@@ -287,6 +294,56 @@ export async function listDir(dirPath: string): Promise<DirItem[]> {
     return result;
 }
 
+const MEGA = 1024 * 1024;
+
+async function calcFileHash_bun(filePath: string): Promise<string|undefined> {
+    const file = Bun.file(filePath);
+    if (!await file.exists()) return undefined;
+
+    if (file.size>10 * MEGA) {
+        return calcFileHash_bun_streamed(file)
+    }
+
+    return Bun.hash(await file.arrayBuffer(), 12346).toString();
+}
+
+async function calcFileHash_bun_streamed(file: Bun.BunFile): Promise<string|undefined> {
+    const stream = file.stream();
+    const reader = stream.getReader();
+    const hasher = new Bun.CryptoHasher("sha256");
+
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done) break;
+            hasher.update(value);
+        }
+
+        return hasher.digest("hex");
+    } finally {
+        reader.releaseLock();
+    }
+}
+
+function calcFileHash_node(filePath: string): Promise<string|undefined> {
+    if (!isFile(filePath)) return Promise.resolve(undefined);
+
+    return new Promise((resolve, reject) => {
+        const hash = createHash('sha256');
+        const stream = createReadStream(filePath);
+        stream.on('data', (data) => hash.update(data));
+        stream.on('end', () => resolve(hash.digest('hex')));
+        stream.on('error', (error) => reject(error));
+    });
+}
+
+/**
+ * Calculate the hash of a file.
+ * Allows using it for HTTP ETag or another change proof.
+ * This version is optimized to use streams and avoid loading the whole file in memory.
+ */
+export const calcFileHash = isBunJS ? calcFileHash_bun : calcFileHash_node;
+
 /**
  * Convert a simple win32 path to a linux path.
  */
@@ -294,6 +351,114 @@ export function win32ToLinuxPath(filePath: string): string {
     return filePath.replace(/\\/g, '/');
 }
 
+/**
+ * Copy a directory recursively.
+ * Is optimized for large files.
+ */
+export async function copyDirectory(srcDir: string, destDir: string): Promise<void> {
+    if (!await isDirectory(srcDir)) {
+        throw new Error(`Directory doesn't exist : ${srcDir}`);
+    }
+
+    await mkDir(destDir);
+    const entries = await fs.readdir(srcDir, { withFileTypes: true });
+
+    await Promise.all(entries.map(async (entry) => {
+        const srcPath = path.join(srcDir, entry.name);
+        const destPath = path.join(destDir, entry.name);
+
+        if (entry.isDirectory()) {
+            await copyDirectory(srcPath, destPath);
+        } else {
+            try {
+                await copyFile(srcPath, destPath);
+            } catch {
+                console.warn(`jk_fs.copyDirectory - Failed to copy file ${srcPath}`);
+            }
+        }
+    }));
+}
+
+/**
+ * Copy of a file.
+ * Is optimized for large files.
+ */
+export async function copyFile(srcPath: string, destPath: string): Promise<void> {
+    let stat = await getFileStat(srcPath);
+    if (!stat) return;
+
+    // Assert the symlink exist.
+    if (stat.isSymbolicLink()) {
+        const symStat = await fs.lstat(srcPath);
+        if (!symStat) return;
+        if (!symStat.isFile()) return;
+    }
+
+    return new Promise<void>((resolve, reject) => {
+        const readStream = createReadStream(srcPath);
+        const writeStream = createWriteStream(destPath);
+
+        readStream.on('error', reject);
+        writeStream.on('error', reject);
+        writeStream.on('finish', resolve);
+
+        readStream.pipe(writeStream);
+    });
+}
+
+/**
+ * Unzip a .zip file in an optimized way.
+ * Note was using : "@types/unzipper": "^0.10.11"
+ * which has some bug, files/folders was forgottens.
+ * import * as unzipper from "unzipper";
+ */
+/*export async function unzipFile_old(zipFilePath: string, outputDir: string): Promise<void> {
+    if (!await isFile(zipFilePath)) {
+        throw new Error(`File doesn't exist : ${zipFilePath}`);
+    }
+
+    if (!await isDirectory(outputDir)) {
+        await mkDir(outputDir);
+    }
+
+    await createReadStream(zipFilePath)
+        .pipe(unzipper.Extract({path: outputDir}))
+        .promise();
+}*/
+
+/**
+ * Unzip a .zip file in an optimized way.
+ */
+export async function unzipFile(zipFilePath: string, outputDir: string): Promise<void> {
+    if (!await isFile(zipFilePath)) {
+        throw new Error(`File doesn't exist : ${zipFilePath}`);
+    }
+
+    if (!await isDirectory(outputDir)) {
+        await mkDir(outputDir);
+    }
+
+    const zip = new AdmZip(zipFilePath);
+    zip.extractAllTo(outputDir, true);
+}
+
+/**
+ * Create a temporary directory.
+ * Return an object containing the directory path and a cleanup function.
+ */
+export async function createTempDir(prefix: string): Promise<{path: string, remove: ()=>Promise<void>}> {
+    const dirPath = await fs.mkdtemp(prefix);
+
+    return {
+        path: dirPath,
+        remove: async () => {
+            return fs.rm(dirPath, {recursive: true, force: true});
+        }
+    }
+}
+
+//region Node.js functions
+
 export const join = path.join;
 export const resolve = path.resolve;
 export const dirname = path.dirname;
@@ -305,4 +470,6 @@ export const normalize = path.normalize;
 export const basename = path.basename;
 
 export const symlink = fs.symlink;
-export const rename = fs.rename;
+export const rename = fs.rename;
+
+//endregion