jopi-toolkit 3.1.25 → 3.1.34

package/dist/jk_tools/common.js.map

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

package/dist/jk_tools/index.d.ts

@@ -1 +1,2 @@
 export * from "./jBundler_ifServer.ts";
+export type Translatable = string | Record<string, string>;

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "3.1.25",
+  "version": "3.1.34",
   "name": "jopi-toolkit",
   "license": "MIT",
   "homepage": "https://github.com/johanpiquet/jopi-toolkit",
@@ -18,7 +18,6 @@
   ],
   "scripts": {
     "jopiLink": "npx jopi-mono link-add",
-    "bunLink": "bun link",
     "dev:build": "tsc",
     "dev:tsc-watch": "tsc --watch",
     "dev:tsc-check": "tsc --noEmit"
@@ -33,8 +32,8 @@
     "mime-types": "^3.0.1",
     "ws": "^8.18.3"
   },
-  "publishedDate": "1/12/2026",
-  "publicPublishedDate": "1/12/2026",
+  "publishedDate": "1/29/2026",
+  "publicPublishedDate": "1/29/2026",
   "exports": {
     "./jk_schema": {
       "types": "./src/jk_schemas/index.ts",
@@ -115,6 +114,11 @@
       "types": "./src/jk_logs/index.ts",
       "bun": "./src/jk_logs/index.ts",
       "default": "./dist/jk_logs/index.js"
+    },
+    "./jk_memcache": {
+      "types": "./src/jk_memcache/index.ts",
+      "bun": "./src/jk_memcache/index.ts",
+      "default": "./dist/jk_memcache/index.js"
     }
   }
 }

package/src/jk_app/common.ts

@@ -291,12 +291,22 @@ export function getCompiledCodeDir(): string {
     return rootDir;
 }
 
+export function toSourceCodeDir(itemPath: string): string {
+    const compiledDir = getCompiledCodeDir();
+
+    if (itemPath.startsWith(compiledDir)) {
+        return getSourceCodeDir() + itemPath.substring(compiledDir.length);
+    }
+
+    return itemPath;
+}
+
 export function getCompiledFilePathFor(sourceFilePath: string, replaceExtension = true): string {
     const compiledCodeDir = getCompiledCodeDir();
     const sourceCodeDir = getSourceCodeDir();
 
     if (!sourceFilePath.startsWith(sourceCodeDir)) {
-        throw new Error("jopi-loader - The source file must be in the source code directory: " + sourceFilePath);
+        return sourceFilePath;
     }
 
     let filePath = sourceFilePath.substring(sourceCodeDir.length);
@@ -321,7 +331,7 @@ export function getSourcesCodePathFor(compiledFilePath: string): string {
     const sourceCodeDir = getSourceCodeDir();
 
     if (!compiledFilePath.startsWith(compiledCodeDir)) {
-        throw new Error("jopi-loader - The compiled file must be in the compiled code directory: " + compiledFilePath);
+        return compiledCodeDir;
     }
 
     let filePath =  jk_fs.join(sourceCodeDir, compiledFilePath.substring(compiledCodeDir.length));

package/src/jk_data/core.ts

@@ -0,0 +1,92 @@
+import {type Schema} from "jopi-toolkit/jk_schema";
+import type { JopiDataTable, JDataReadParams, JDataReadResult, JRowArrayFilter } from "./interfaces.ts";
+export * from "./interfaces.ts";
+
+//region Rows Arrays
+
+/**
+ * Filter the row content according to rules.
+ */
+export function simpleRowArrayFilter(rows: any[], params: JRowArrayFilter): JDataReadResult {
+    // > Apply filter.
+
+    if (params.filter) {
+        const f = params.filter;
+
+        rows = rows.filter(r => {
+            if (f.field) {
+                let v = r[f.field];
+                if (v===undefined) return false;
+                return String(v).includes(f.value);
+            } else {
+                for (let v of Object.values(r)) {
+                    if (v===undefined) continue;
+                    if (String(v).includes(f.value)) return true;
+                }
+
+                return false;
+            }
+        });
+    }
+
+    // > Apply sorting.
+
+    if (params.sorting && params.sorting.length) {
+        const sorting = params.sorting[0];
+        const sortField = sorting.id;
+        const sortDesc = sorting.desc;
+
+        rows = rows.sort((a, b) => {
+            let av = a[sortField];
+            let bv = b[sortField];
+
+            if (av === undefined) av = "";
+            if (bv === undefined) bv = "";
+
+            const avIsNumber = typeof av === "number";
+            const bvIsNumber = typeof bv === "number";
+
+            if (avIsNumber && bvIsNumber) {
+                if (sortDesc) {
+                    return bv - av;
+                } else {
+                    return av - bv;
+                }
+            } else {
+                const avStr = String(av);
+                const bvStr = String(bv);
+
+                if (sortDesc) {
+                    return bvStr.localeCompare(avStr);
+                } else {
+                    return avStr.localeCompare(bvStr);
+                }
+            }
+        });
+    }
+
+    const totalWithoutPagination = rows.length;
+    let offset = 0;
+
+    if (params.page) {
+        offset = params.page.pageIndex * params.page.pageSize;
+        rows = rows.slice(offset, offset + params.page.pageSize);
+    }
+
+    return {rows, total: totalWithoutPagination, offset};
+}
+
+//endregion
+
+//region JDataBinding
+
+export class JDataBinding_UseArray implements JopiDataTable {
+    public constructor(public readonly schema: Schema, private readonly rows: any[]) {
+    }
+
+    async read(params: JDataReadParams): Promise<JDataReadResult> {
+        return simpleRowArrayFilter(this.rows, params);
+    }
+}
+
+//endregion

package/src/jk_data/index.ts

@@ -1,166 +1,3 @@
-import {type Schema} from "jopi-toolkit/jk_schema";
-
-//region Rows Arrays
-
-export interface JFieldSorting {
-    id: string;
-    desc: boolean;
-}
-
-export interface JFieldFilter {
-    value?: string | number | boolean;
-    constraint: JFieldConstraintType;
-    caseSensitive?: boolean;
-}
-
-export type JFieldConstraintType =
-    | "$eq"    // Equals
-    | "$ne"    // Not equals
-    | "$gt"    // Greater than
-    | "$gte"   // Greater than or equals
-    | "$lt"    // Less than
-    | "$lte"   // Less than or equals
-    | "$in"    // In an array of values
-    | "$nin"   // Not in an array of values
-    | "$like"  // Like search %endsWith or startsWith%
-
-export interface JRowsFilter {
-    field?: string;
-    value: string;
-}
-
-export interface JPageExtraction {
-    pageIndex: number;
-    pageSize: number;
-}
-
-export interface JRowArrayFilter {
-    page?: JPageExtraction;
-    filter?: JRowsFilter;
-    sorting?: JFieldSorting[];
-    fieldFilters?: Record<string, JFieldFilter[]>;
-}
-
-/**
- * Filter the row content according to rules.
- */
-export function simpleRowArrayFilter(rows: any[], params: JRowArrayFilter): JTableDs_ReadResult {
-    // > Apply filter.
-
-    if (params.filter) {
-        const f = params.filter;
-
-        rows = rows.filter(r => {
-            if (f.field) {
-                let v = r[f.field];
-                if (v===undefined) return false;
-                return String(v).includes(f.value);
-            } else {
-                for (let v of Object.values(r)) {
-                    if (v===undefined) continue;
-                    if (String(v).includes(f.value)) return true;
-                }
-
-                return false;
-            }
-        });
-    }
-
-    // > Apply sorting.
-
-    if (params.sorting && params.sorting.length) {
-        const sorting = params.sorting[0];
-        const sortField = sorting.id;
-        const sortDesc = sorting.desc;
-
-        rows = rows.sort((a, b) => {
-            let av = a[sortField];
-            let bv = b[sortField];
-
-            if (av === undefined) av = "";
-            if (bv === undefined) bv = "";
-
-            const avIsNumber = typeof av === "number";
-            const bvIsNumber = typeof bv === "number";
-
-            if (avIsNumber && bvIsNumber) {
-                if (sortDesc) {
-                    return bv - av;
-                } else {
-                    return av - bv;
-                }
-            } else {
-                const avStr = String(av);
-                const bvStr = String(bv);
-
-                if (sortDesc) {
-                    return bvStr.localeCompare(avStr);
-                } else {
-                    return avStr.localeCompare(bvStr);
-                }
-            }
-        });
-    }
-
-    const totalWithoutPagination = rows.length;
-    let offset = 0;
-
-    if (params.page) {
-        offset = params.page.pageIndex * params.page.pageSize;
-        rows = rows.slice(offset, offset + params.page.pageSize);
-    }
-
-    return {rows, total: totalWithoutPagination, offset};
-}
-
-//endregion
-
-//region JTableDs
-
-export interface JTableDs_ReadParams extends JRowArrayFilter {
-}
-
-export interface JTableDs_ReadResult {
-    rows: any[];
-    total?: number;
-    offset?: number;
-}
-
-export interface JTableDs {
-    get name(): string;
-    get schema(): Schema;
-    read(params: JTableDs_ReadParams): Promise<JTableDs_ReadResult>;
-}
-
-export class JTableDs_UseArray implements JTableDs {
-    public constructor(public readonly name: string, public readonly schema: Schema, private readonly rows: any[]) {
-    }
-
-    async read(params: JTableDs_ReadParams): Promise<JTableDs_ReadResult> {
-        return simpleRowArrayFilter(this.rows, params);
-    }
-}
-
-export class JTableDs_HttpProxy implements JTableDs {
-    public constructor(public readonly name: string, private readonly url: string, public readonly schema: Schema) {
-    }
-
-    async read(params: JTableDs_ReadParams): Promise<JTableDs_ReadResult> {
-        let toSend = {dsName: this.name, read: params};
-
-        let res = await fetch(this.url, {
-            method: "POST",
-            headers: {"Content-Type": "application/json"},
-            body: JSON.stringify(toSend)
-        });
-
-        if (res.status !== 200) {
-            throw new Error(`Error while reading data source "${this.name}"`);
-        }
-
-        let asJson = await res.json();
-        return asJson as JTableDs_ReadResult;
-    }
-}
-
-//endregion
+export * from "./core.ts";
+export * from "./proxy.ts";
+export * from "./interfaces.ts";

package/src/jk_data/interfaces.ts

@@ -0,0 +1,140 @@
+import { type Schema } from "jopi-toolkit/jk_schema";
+import type {Translatable} from "../jk_tools";
+
+export interface JFieldSorting {
+    id: string;
+    desc: boolean;
+}
+
+export interface IActionContext {
+    refresh: () => void;
+}
+
+export interface JFieldFilter {
+    value?: string | number | boolean;
+    constraint: JFieldConstraintType;
+    caseSensitive?: boolean;
+}
+
+export type JFieldConstraintType =
+    | "$eq"    // Equals
+    | "$ne"    // Not equals
+    | "$gt"    // Greater than
+    | "$gte"   // Greater than or equals
+    | "$lt"    // Less than
+    | "$lte"   // Less than or equals
+    | "$in"    // In an array of values
+    | "$nin"   // Not in an array of values
+    | "$like"  // Like search %endsWith or startsWith%
+    ;
+
+export interface JGlobalFilter {
+    field?: string;
+    value: string;
+}
+
+export interface JPageExtraction {
+    pageIndex: number;
+    pageSize: number;
+}
+
+export interface JRowArrayFilter {
+    page?: JPageExtraction;
+    filter?: JGlobalFilter;
+    sorting?: JFieldSorting[];
+    fieldFilters?: Record<string, JFieldFilter[]>;
+}
+
+export interface JDataReadParams extends JRowArrayFilter {
+}
+
+export interface JDataReadResult {
+    rows: any[];
+    total?: number;
+    offset?: number;
+}
+
+export interface JActionDef {
+    id: string;
+    title?: Translatable;
+    separator?: boolean;
+}
+
+export interface JopiDataTable {
+    readonly schema: Schema;
+    readonly actions?: JActionDef[];
+    read(params: JDataReadParams): Promise<JDataReadResult>;
+}
+
+export interface JDataTable extends JopiDataTable {
+    readonly name: string;
+    executeAction?: (rows: any[], actionName: string, context?: IActionContext) => Promise<JActionResult | void>
+    isActionEnabled?: (actionName: string, rows: any[], context?: IActionContext) => boolean;
+}
+
+export interface JActionPreProcessParams {
+    rows: any[];
+    context?: IActionContext;
+}
+
+export interface JActionResult {
+    isOk?: boolean;
+    errorCode?: string;
+    errorMessage?: string;
+    userMessage?: string;
+    data?: any;
+}
+
+export interface JActionPreProcessResult extends JActionResult {
+    rows?: any[];
+}
+
+export interface JActionPostProcessParams {
+    rows: any[];
+    context?: IActionContext;
+    
+    data?: any[];
+    userMessage?: string;
+}
+
+/**
+ * Defines the behavior of a custom action in the browser for a Jopi table.
+ * allowing to hook into the action lifecycle (pre-process, server call, post-process).
+ */
+export interface JopiTableBrowserActionItem {
+    /**
+     * Callback invoked when an error occurs during the action execution.
+     * This can be triggered by a failure in the `action` handler or a server-side error.
+     */
+    onError?: (params: JActionResult) => Promise<void>,
+
+    /**
+     * The main client-side action handler.
+     * - Can be used to perform checks or data transformation before sending to the server.
+     * - Can be used as a standalone action if `disableServerCall` is true.
+     * - Return `void` to proceed with the default flow.
+     * - Return a `JActionPreProcessResult` to control flow (e.g., stop execution if `isOk` is false) or modify data sent to server.
+     */
+    action?: (params: JActionPreProcessParams) => Promise<JActionPreProcessResult|void>,
+
+    /**
+     * Callback invoked after the server-side action has successfully completed.
+     * Useful for showing notifications, refreshing data, or triggering other UI updates.
+     */
+    afterServerCall?: (params: JActionPostProcessParams) => Promise<void>;
+
+    /**
+     * Function to determine if the action should be enabled/clickable.
+     * Based on the currently selected rows and the current action context.
+     * If not provided, the action is assumed to be always enabled.
+     */
+    canEnable?: (rows: any[], context?: IActionContext) => boolean;
+
+    /**
+     * If set to true, the framework will NOT assume there is a corresponding server-side action to call.
+     * Use this for actions that are purely client-side (e.g., "Copy to clipboard").
+     */
+    disableServerCall?: boolean;
+}
+
+export type JopiTableBrowserActions = Record<string, JopiTableBrowserActionItem>

package/src/jk_data/proxy.ts

@@ -0,0 +1,102 @@
+import type { IActionContext, JopiTableBrowserActions, JDataReadParams, JDataReadResult, JDataTable, JActionDef, JActionResult } from "./interfaces.ts";
+import { schema, type Schema } from "jopi-toolkit/jk_schema";
+
+export interface ProxyParams {
+    name: string;
+    apiUrl: string;
+    actions?: JActionDef[];
+    schema: { meta: any; desc: any; };
+}
+
+export class Proxy implements JDataTable {
+    readonly name: string;
+    readonly schema: Schema;
+    readonly actions?: JActionDef[];
+    private readonly url: string;
+
+    readonly browserActions: JopiTableBrowserActions;
+    
+    constructor(params: ProxyParams, browserActions: JopiTableBrowserActions) {
+        this.name = params.name;
+        this.url = params.apiUrl;
+        this.actions = params.actions;
+        this.schema = schema(params.schema.desc, params.schema.meta);
+        this.browserActions = browserActions;
+    }
+
+    async read(params: JDataReadParams): Promise<JDataReadResult> {
+        const asJson = await this.callServer({ dsName: this.name, read: params });
+        return asJson as JDataReadResult;
+    }
+
+    isActionEnabled(actionName: string, rows: any[], context?: IActionContext): boolean {
+        let actionEntry = this.browserActions[actionName];
+        if (!actionEntry) return false;
+        if (!actionEntry.canEnable) return true;
+        return actionEntry.canEnable(rows, context);
+    }
+
+    async executeAction(rows: any[], actionName: string, context?: IActionContext): Promise<JActionResult|void> {
+        async function processError(res: JActionResult | undefined) {
+            if (!res) return true;
+            
+            if (res.isOk===false||res.errorCode||res.errorMessage) {
+                if (actionEntry.onError) {
+                    await actionEntry.onError(res);
+                    return false;
+                }
+            }
+            
+            return true;
+        }
+
+        let actionEntry = this.browserActions[actionName];
+        if (!actionEntry) return;
+
+        if (actionEntry.action) {
+            let res = await actionEntry.action({ rows, context });
+
+            if (res) {
+                if (!processError(res)) return;
+
+                if (res.rows !== undefined) {
+                    rows = res.rows;
+                }
+            }
+        }
+
+        if (actionEntry.disableServerCall === true) {
+            return;
+        }
+         
+        let serverRes = await this.callServer({ action: actionName, rows });
+        if (!processError(serverRes)) return;
+
+        if (actionEntry.afterServerCall) {
+            await actionEntry.afterServerCall({
+                rows,
+                context,
+                data: serverRes?.data,
+                userMessage: serverRes?.userMessage
+            });
+        }
+    }
+
+    async callServer(data: any): Promise<any> {
+        let res = await fetch(this.url, {
+            method: "POST",
+            headers: {"Content-Type": "application/json"},
+            body: JSON.stringify(data)
+        });
+
+        if (res.status !== 200) {
+            throw new Error(`Error while calling data source "${this.name}"`);
+        }
+
+        return await res.json();
+    }
+}
+
+export function toDataTableProxy(params: ProxyParams, browserActions?: JopiTableBrowserActions): JDataTable {
+    return new Proxy(params, browserActions || {});
+}

package/src/jk_fs/jBundler_ifServer.ts

@@ -516,6 +516,7 @@ export const join = path.join;
 export const resolve = path.resolve;
 export const dirname = path.dirname;
 export const extname = path.extname;
+export const relative = path.relative;
 
 export const sep = path.sep;
 export const isAbsolute = path.isAbsolute;

package/src/jk_logs/index.ts

@@ -51,7 +51,7 @@ export const formater_dateTypeTitleSourceData: LogEntryFormater = (entry: LogEnt
     const date = formatDate1(entry.date);
 
     let json = entry.data ? JSON.stringify(entry.data) : "";
-    const title = (entry.title || "").padEnd(50, " ");
+    const title = String(entry.title || "").padEnd(50, " ");
 
     json = entry.logger + " |>" + json;
 
@@ -71,7 +71,7 @@ export const formater_dateTypeTitleSourceData: LogEntryFormater = (entry: LogEnt
 
 export const formater_typeTitleSourceData_colored: LogEntryFormater = (entry: LogEntry) => {
     let json = entry.data ? JSON.stringify(entry.data) : "";
-    const title = (entry.title || "").padEnd(50, " ");
+    const title = String(entry.title || "").padEnd(50, " ");
 
     json = entry.timeDif === undefined
         ? `${entry.logger} ${json}` : `${entry.logger} (${entry.timeDif} ms) ${json}`;

package/src/jk_memcache/README.md

@@ -0,0 +1,66 @@
+
+# JkMemCache (`jk_memcache`)
+
+A robust, in-memory caching system, designed with optimization and memory management in mind.
+
+## Features
+
+- **Store Anything**: Supports `string`, `ArrayBuffer`, and `Object` (automatically serialized).
+- **Memory Management**: 
+  - **Memory Limit**: Define a maximum size in bytes.
+  - **Count Limit**: Define a maximum number of entries.
+  - **Garbage Collection (GC)**: Automatic cleanup of expired items and intelligent eviction when full.
+- **Smart Eviction**:
+  - **Importance Levels**: Mark entries as critical to prevent them from being discarded easily.
+  - **Access Tracking**: Tracks how often items are used to prioritize keeping frequently accessed data.
+  - **Expiration**: Support for TTL (Time To Live) and absolute expiration dates.
+
+## Usage
+
+### basic
+
+```typescript
+import { JkMemCache } from '@jopi-toolkit/jk_memcache';
+
+// Create a cache with limits
+const cache = new JkMemCache({
+  maxCount: 1000,           // Max 1000 items
+  maxSize: 5 * 1024 * 1024, // Max 5MB
+  cleanupInterval: 30000    // Cleanup every 30s
+});
+
+// Store data
+cache.set('user:123', { name: 'John', role: 'admin' }, {
+  ttl: 60000,    // Expires in 1 minute
+  importance: 5  // High importance (default is 1)
+});
+
+// Retrieve data
+const user = cache.get('user:123'); // { name: 'John', ... }
+```
+
+### Options
+
+#### Constructor Options
+
+| Option | Type | Default | Description |
+|yyy|yyy|yyy|yyy|
+| `maxCount` | `number` | `Infinity` | Maximum number of items allowed in the cache. |
+| `maxSize` | `number` | `50MB` | Maximum estimated memory size in bytes. |
+| `cleanupInterval` | `number` | `60000` | Interval (ms) for running the background cleanup (removes expired items). |
+
+#### `set(key, value, options)` Options
+
+| Option | Type | Default | Description |
+|yyy|yyy|yyy|yyy|
+| `importance` | `number` | `1` | Importance level. Higher values protect the item from eviction when memory is full. |
+| `ttl` | `number` | - | Time To Live in milliseconds. |
+| `expiresAt` | `Date` \| `number` | - | Absolute date when the item expires. |
+
+## Eviction Strategy
+
+When the cache reaches its memory or count limit, the Garbage Collector runs immediately upon the next `set` operation. It selects victims based on a scoring system:
+
+1.  **Low Importance**: Items with lower importance are targeted first.
+2.  **Low Usage**: Least frequently accessed items are targeted next.
+3.  **Age**: Older items are targeted last if importance and usage are equal.

package/src/jk_memcache/_logs.ts

@@ -0,0 +1,3 @@
+import {getLogger} from "jopi-toolkit/jk_logs";
+
+export const logMemCache = getLogger("jk_memcache");