jopi-toolkit 3.0.5 → 3.0.10

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":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,OAAO,KAAK,QAAQ,MAAM,uBAAuB,CAAC;AAsBlD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAA4B;IAC7D,KAAK,UAAU,YAAY,CAAC,SAAiB,EAAE,UAAkB;QAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,OAAO,GAAgB,EAAE,CAAC;QAEhC,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE9C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE,EAAC,OAAO,EAAE,OAAO,GAAE,CAAC,CAAC;QAE9D,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACxF,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAEnD,IAAI,MAAM,CAAC,GAAG;YAAE,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAA;IACzD,CAAC;IAED,KAAK,UAAU,sBAAsB,CAAC,WAAmB,EAAE,YAAoB;QAC3E,MAAM,MAAM,GAAG,gCAAgC,SAAS,IAAI,QAAQ,aAAa,WAAW,QAAQ,UAAU,EAAE,CAAC;QACjH,MAAM,OAAO,GAAgB,EAAE,CAAC;QAEhC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAElD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACxF,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QAE9D,IAAI,MAAM,IAAI,OAAO,EAAE,CAAC;YACpB,MAAM,YAAY,CAAC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;YACpD,OAAO;QACX,CAAC;QAED,MAAM,QAAQ,GAAU,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5D,OAAO,GAAG,KAAK,CAAC;QAEhB,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC1B,4DAA4D;YAC5D,MAAM,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAEhC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC5C,IAAI,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;gBACzB,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACzD,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;YAC7E,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBAC7B,MAAM,sBAAsB,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YAC1D,CAAC;QACL,CAAC;IACL,CAAC;IAED,IAAI,OAAO,GAAG,IAAI,CAAC;IAEnB,IAAI,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IACrB,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,qBAAqB,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oGAAoG,CAAC,CAAC;IAElK,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IAErC,IAAI,SAAS,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;IAC5B,IAAI,QAAQ,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;IAC3B,IAAI,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,IAAI,KAAG,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,oGAAoG,CAAC,CAAC;IACzI,IAAI,UAAU,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEjD,MAAM,sBAAsB,CAAC,cAAc,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,YAAY;IACjB,IAAI,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;IAClD,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,IAAI,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3B,IAAI,KAAK,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1B,OAAO,GAAG,CAAC;AACf,CAAC;AAED,MAAM,UAAU,GAAG,YAAY,EAAE,CAAC"}

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "3.0.5",
+  "version": "3.0.10",
   "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.js

@@ -73,6 +73,9 @@ var EventGroup = /** @class */ (function () {
             return __generator(this, function (_b) {
                 switch (_b.label) {
                     case 0:
+                        if (eventName[0] !== '@') {
+                            throw new Error("Async events ".concat(eventName, " must start with @"));
+                        }
                         if (this.evenSpy)
                             this.evenSpy(eventName, e);
                         events = this.listenersFor[eventName];
@@ -171,24 +174,31 @@ var PriorityArray = /** @class */ (function () {
     });
     return PriorityArray;
 }());
-//endregion
-var StaticEvent = /** @class */ (function () {
-    function StaticEvent(eventName, eventItems) {
+var StaticEventImpl = /** @class */ (function () {
+    function StaticEventImpl(eventName, eventItems) {
         this.eventName = eventName;
         this.eventItems = eventItems;
     }
-    StaticEvent.prototype.send = function (data) {
+    StaticEventImpl.prototype.send = function (data) {
         for (var _i = 0, _a = this.eventItems; _i < _a.length; _i++) {
             var listener = _a[_i];
             listener(data, this.eventName);
         }
         return data;
     };
-    return StaticEvent;
+    StaticEventImpl.prototype.addListener = function (listener) {
+        var _this = this;
+        this.eventItems.push(listener);
+        return function () {
+            var idx = _this.eventItems.indexOf(listener);
+            if (idx >= 0)
+                _this.eventItems.splice(idx, 1);
+        };
+    };
+    return StaticEventImpl;
 }());
-export { StaticEvent };
 export function createStaticEvent(eventName, eventItems) {
-    return new StaticEvent(eventName, eventItems);
+    return new StaticEventImpl(eventName, eventItems);
 }
 export var defaultEventGroup = new EventGroup();
 export function newEventGroup() {

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");
 }