jopi-node-space 0.0.1

package/README.md

@@ -0,0 +1,24 @@
+## What is it?
+
+### Server Side or Browser Side
+
+Le premier rôle de Jopi NodeSpace, est de permettre de créer des librairies dont le code source est le même pour le serveur et le browser.
+
+* Il permet de détecter automatiquement si nous sommes côté serveur ou navigateur.
+* Il permet de gommer certains écarts entre le fonctionnement serveur/browser, notamment quant aux WebWorkers.
+* Il permet un accès uniformisé aux variables d'environnement, que l'on soit browser ou serveur (proccess.env).
+* Il permet d'accéder à des fonctionnalités serveur, sans devoir ajouter des dépendances.
+
+> NodeSpace inclut des fonctionnalités d'accès aux fichiers et différents éléments serveur.
+> Ils ne fonctionnent que lorsque nous sommes côté serveur, cependant ils évitent d'avoir à faire des *import*
+lesquels sont incompatibles avec les bundlers (ex: ViteJS).
+
+### Packed with common tools
+
+Le second objectif de Jopi NodeSpace est d'apporter des outils communs.
+
+* Cycle de vie de l'application : pouvoir associer des écouteurs, afin d'être prévenu quand l'application quitte.
+* Hot-Reload: détection et gestion des hot-reload (une fonctionnalité bun.js).
+* Points d'extension: permet de créer une application extensible.
+* Logs: inclut des fonctionnalités de logs (basé sur jopi-logs).
+* User: inclut des fonctionnalités permettant d'obtenir des informations sur l'utilisateur actuel (app side).

package/bun.lock

@@ -0,0 +1,25 @@
+{
+  "lockfileVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "jopi-node-space",
+      "devDependencies": {
+        "@types/bun": "latest",
+        "@types/node": "latest",
+      },
+    },
+  },
+  "packages": {
+    "@types/bun": ["@types/bun@1.2.19", "", { "dependencies": { "bun-types": "1.2.19" } }, "sha512-d9ZCmrH3CJ2uYKXQIUuZ/pUnTqIvLDS0SK7pFmbx8ma+ziH/FRMoAq5bYpRG7y+w1gl+HgyNZbtqgMq4W4e2Lg=="],
+
+    "@types/node": ["@types/node@24.1.0", "", { "dependencies": { "undici-types": "~7.8.0" } }, "sha512-ut5FthK5moxFKH2T1CUOC6ctR67rQRvvHdFLCD2Ql6KXmMuCrjsSsRI9UsLCm9M18BMwClv4pn327UvB7eeO1w=="],
+
+    "@types/react": ["@types/react@19.1.9", "", { "dependencies": { "csstype": "^3.0.2" } }, "sha512-WmdoynAX8Stew/36uTSVMcLJJ1KRh6L3IZRx1PZ7qJtBqT3dYTgyDTx8H1qoRghErydW7xw9mSJ3wS//tCRpFA=="],
+
+    "bun-types": ["bun-types@1.2.19", "", { "dependencies": { "@types/node": "*" }, "peerDependencies": { "@types/react": "^19" } }, "sha512-uAOTaZSPuYsWIXRpj7o56Let0g/wjihKCkeRqUBhlLVM/Bt+Fj9xTo+LhC1OV1XDaGkz4hNC80et5xgy+9KTHQ=="],
+
+    "csstype": ["csstype@3.1.3", "", {}, "sha512-M1uQkMl8rQK/szD0LNhtqxIPLpimGm8sOBwU7lLnCpSbTyY3yeU1Vc7l4KT5zT4s/yOxHH5O7tIuuLOCnLADRw=="],
+
+    "undici-types": ["undici-types@7.8.0", "", {}, "sha512-9UJ2xGDvQ43tYyVMpuHlsgApydB8ZKfVYTsLDhXkFL/6gfkp+U8xTGdh8pMJv1SpZna0zxG1DwsKZsreLbXBxw=="],
+  }
+}

package/dist/browser.d.ts

@@ -0,0 +1 @@
+export declare function initBrowser(): void;

package/dist/browser.js

@@ -0,0 +1,15 @@
+import { init_nodeSpaceWhat } from "./nodeSpaceWhat.js";
+import { init_nodeSpaceApp } from "./nodeSpaceApp.js";
+import { init_nodeSpaceProcess } from "./nodeSpaceProcess.js";
+import { init_nodeSpaceTimer } from "./nodeSpaceTimer.js";
+import { init_nodeSpaceThread } from "./nodeSpaceThread.js";
+import { init_nodeSpaceExtensionPoints } from "./nodeSpaceExtensionPoints";
+export function initBrowser() {
+    init_nodeSpaceWhat();
+    init_nodeSpaceApp();
+    init_nodeSpaceProcess();
+    init_nodeSpaceTimer();
+    init_nodeSpaceThread();
+    init_nodeSpaceExtensionPoints();
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAC,qBAAqB,EAAC,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAC,mBAAmB,EAAC,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAC,oBAAoB,EAAC,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAC,6BAA6B,EAAC,MAAM,4BAA4B,CAAC;AAEzE,MAAM,UAAU,WAAW;IACvB,kBAAkB,EAAE,CAAC;IACrB,iBAAiB,EAAE,CAAC;IACpB,qBAAqB,EAAE,CAAC;IACxB,mBAAmB,EAAE,CAAC;IACtB,oBAAoB,EAAE,CAAC;IACvB,6BAA6B,EAAE,CAAC;AACpC,CAAC"}

package/dist/common.d.ts

@@ -0,0 +1,85 @@
+declare global {
+    var NodeSpace: NodeSpaceType;
+    var jopiHotReloader: HotReloadType;
+}
+export declare function execListeners(listeners: Listener[]): Promise<void>;
+export declare function isServerSide(): boolean;
+export declare function isBunJs(): boolean;
+export declare function isNodeJs(): boolean;
+export declare function tick(delayMs: number): Promise<void>;
+export type ServerType = "nodejs" | "bunjs" | "browser";
+export type Listener = () => void | Promise<void>;
+export interface NodeSpaceType {
+    what: WhatInfos;
+    thread: ThreadImpl;
+    process: ProcessImpl;
+    timer: TimerImpl;
+    app: AppImpl;
+    fs?: FileSystemImpl;
+    extensionPoints?: ExtensionPointImpl;
+}
+export interface HotReloadType {
+    onHotReload: Listener[];
+    memory: {
+        [key: string]: any;
+    };
+}
+interface WhatInfos {
+    isNodeJS: boolean;
+    isBunJs: boolean;
+    isBrowser: boolean;
+    isServerSide: boolean;
+    serverType: ServerType;
+}
+interface ThreadImpl {
+    isMainThread: boolean;
+    currentWorker: Worker | null;
+    newWorker: (fileName: string | URL, data?: any) => Worker;
+    getCurrentWorkerData: () => any;
+    unrefThisWorker(worker: Worker): void;
+    closeCurrentThread(): void;
+}
+interface ProcessImpl {
+    argv: string[];
+    env: {
+        [key: string]: string;
+    };
+    isProduction: boolean;
+}
+interface TimerImpl {
+    tick: (delayMs: number) => Promise<void>;
+}
+interface FileSystemImpl {
+    mkDir: (dirPath: string) => Promise<string | undefined>;
+}
+interface AppImpl {
+    onServerSideReady(listener: Listener): void;
+    waitServerSideReady: () => Promise<void>;
+    declareServerSideReady(): void;
+    onAppStart(listener: Listener): void;
+    onAppExiting(listener: Listener): void;
+    onAppExited(listener: Listener): void;
+    executeApp(app: Listener): void;
+    declareAppStarted(): void;
+    declareAppExiting(): void;
+    onHotReload(listener: Listener): void;
+    keepOnHotReload<T>(key: string, provider: () => T): T;
+}
+export type EpCaller = (...values: unknown[]) => Promise<void>;
+export type EpListener = (...values: unknown[]) => void | Promise<void>;
+interface ExtensionPointImpl {
+    /**
+     * Register an extension point.
+     * Allow knowing who is using it as an host.
+     */
+    newHost(epName: string, importMetaUrl: string): EpCaller;
+    /**
+     * Get a caller, allowing to call the extension point.
+     */
+    getCaller(epName: string, importMetaUrl: string): EpCaller;
+    /**
+     * Add a function which is called when the extension point is called.
+     */
+    on(epName: string, importMetaUrl: string, fct: EpListener): void;
+}
+export {};

package/dist/common.js

@@ -0,0 +1,34 @@
+globalThis.NodeSpace = {};
+let _isBunJs = false;
+let _isNodeJs = false;
+export async function execListeners(listeners) {
+    const list = [...listeners];
+    listeners.splice(0);
+    for (const listener of list) {
+        try {
+            const res = listener();
+            if (res instanceof Promise)
+                await res;
+        }
+        catch (e) {
+            console.error(e);
+        }
+    }
+}
+export function isServerSide() {
+    return isBunJs() || isNodeJs();
+}
+export function isBunJs() {
+    if (_isBunJs)
+        return _isBunJs;
+    return _isBunJs = typeof (Bun) !== "undefined";
+}
+export function isNodeJs() {
+    if (_isNodeJs)
+        return _isNodeJs;
+    return _isNodeJs = typeof (self) === "undefined";
+}
+export function tick(delayMs) {
+    return new Promise((resolve) => setTimeout(resolve, delayMs));
+}
+//# sourceMappingURL=common.js.map

package/dist/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAKA,UAAU,CAAC,SAAS,GAAG,EAAmB,CAAC;AAE3C,IAAI,QAAQ,GAAG,KAAK,CAAC;AACrB,IAAI,SAAS,GAAG,KAAK,CAAC;AAEtB,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,SAAqB;IACrD,MAAM,IAAI,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;IAC5B,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAEpB,KAAK,MAAM,QAAQ,IAAI,IAAI,EAAE,CAAC;QAC1B,IAAI,CAAC;YACD,MAAM,GAAG,GAAG,QAAQ,EAAE,CAAC;YACvB,IAAI,GAAG,YAAY,OAAO;gBAAE,MAAM,GAAG,CAAC;QAC1C,CAAC;QACD,OAAO,CAAC,EAAE,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC;IACL,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY;IACxB,OAAO,OAAO,EAAE,IAAI,QAAQ,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,OAAO;IACnB,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,OAAO,QAAQ,GAAG,OAAM,CAAC,GAAG,CAAC,KAAG,WAAW,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,QAAQ;IACpB,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,OAAO,SAAS,GAAG,OAAM,CAAC,IAAI,CAAC,KAAG,WAAW,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,OAAe;IAChC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,37 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { isBunJs, isNodeJs, isServerSide } from "./common.js";
+export * from "./common.js";
+import { initBrowser } from "./browser.js";
+// Will init with the common stuffs.
+initBrowser();
+if (isServerSide()) {
+    let serverType = "nodejs";
+    if (isBunJs())
+        serverType = "bunjs";
+    // Allow conditional code to be ok
+    // despite the "await import" is not done yet.
+    //
+    const nodeSpace = globalThis.NodeSpace;
+    nodeSpace.what = {
+        isNodeJS: isNodeJs(),
+        isBunJs: isBunJs(),
+        isBrowser: false,
+        isServerSide: true,
+        serverType: serverType,
+    };
+    let ext = import.meta.filename.split(".").pop();
+    const fileName = "./serverSide." + ext;
+    // To know: the caller will not wait for the await to resolve.
+    // Wait is after will not be interpreted immediately by the caller
+    // doing that specifics server-side things will not be ok now.
+    //
+    await import(__rewriteRelativeImportExtension(/* @vite-ignore */ fileName));
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;AAAA,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE7E,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AAEzC,oCAAoC;AACpC,WAAW,EAAE,CAAC;AAEd,IAAI,YAAY,EAAE,EAAE,CAAC;IACjB,IAAI,UAAU,GAAe,QAAQ,CAAC;IACtC,IAAI,OAAO,EAAE;QAAE,UAAU,GAAG,OAAO,CAAC;IAEpC,kCAAkC;IAClC,8CAA8C;IAC9C,EAAE;IACF,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;IAEvC,SAAS,CAAC,IAAI,GAAG;QACb,QAAQ,EAAE,QAAQ,EAAE;QACpB,OAAO,EAAE,OAAO,EAAE;QAClB,SAAS,EAAE,KAAK;QAChB,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,UAAU;KACzB,CAAA;IAED,IAAI,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;IAChD,MAAM,QAAQ,GAAG,eAAe,GAAG,GAAG,CAAC;IAEvC,8DAA8D;IAC9D,kEAAkE;IAClE,8DAA8D;IAC9D,EAAE;IACF,MAAM,MAAM,kCAAC,kBAAkB,CAAC,QAAQ,EAAC,CAAC;AAC9C,CAAC"}

package/dist/internal.d.ts

@@ -0,0 +1,3 @@
+export declare let gIsUsingWorkers: boolean;
+export declare function declareUsingWorker(): void;
+export declare function isUsingWorker(): boolean;

package/dist/internal.js

@@ -0,0 +1,8 @@
+export let gIsUsingWorkers = false;
+export function declareUsingWorker() {
+    gIsUsingWorkers = true;
+}
+export function isUsingWorker() {
+    return gIsUsingWorkers;
+}
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,IAAI,eAAe,GAAG,KAAK,CAAC;AAEnC,MAAM,UAAU,kBAAkB;IAC9B,eAAe,GAAG,IAAI,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,aAAa;IACzB,OAAO,eAAe,CAAC;AAC3B,CAAC"}

package/dist/nodeSpaceApp.d.ts

@@ -0,0 +1 @@
+export declare function init_nodeSpaceApp(): void;

package/dist/nodeSpaceApp.js

@@ -0,0 +1,105 @@
+import { execListeners, isBunJs, isNodeJs } from "./common.js";
+import { isUsingWorker } from "./internal.js";
+export function init_nodeSpaceApp() {
+    const onServerSideReady = [];
+    const onAppExiting = [];
+    const onAppExited = [];
+    const onAppStart = [];
+    let isServerSideReady = !(isNodeJs() || isBunJs());
+    let isHotReload = globalThis.jopiHotReloader !== undefined;
+    let isAppStarted = false;
+    if (isHotReload) {
+        execListeners(globalThis.jopiHotReloader.onHotReload).then();
+    }
+    else {
+        globalThis.jopiHotReloader = {
+            onHotReload: [],
+            memory: {}
+        };
+    }
+    const onHotReload = globalThis.jopiHotReloader.onHotReload;
+    const memory = globalThis.jopiHotReloader.memory;
+    NodeSpace.app = {
+        onServerSideReady: (listener) => {
+            if (isServerSideReady)
+                listener();
+            else
+                onServerSideReady.push(listener);
+        },
+        waitServerSideReady: () => {
+            if (isServerSideReady) {
+                return Promise.resolve();
+            }
+            return new Promise(r => {
+                NodeSpace.app.onServerSideReady(r);
+            });
+        },
+        declareServerSideReady: async () => {
+            isServerSideReady = true;
+            await execListeners(onServerSideReady);
+        },
+        onAppStart: (listener) => {
+            if (isAppStarted)
+                listener();
+            else
+                onAppStart.push(listener);
+        },
+        onAppExiting: (listener) => {
+            if (!isAppStarted)
+                listener();
+            else
+                onAppExiting.push(listener);
+        },
+        onAppExited: (listener) => {
+            if (!isAppStarted)
+                listener();
+            else
+                onAppExited.push(listener);
+        },
+        declareAppStarted: async () => {
+            isAppStarted = true;
+            await execListeners(onAppStart);
+        },
+        declareAppExiting: async () => {
+            if (isUsingWorker()) {
+                // Wait 1 sec, which allows the worker to correctly initialize.
+                await NodeSpace.timer.tick(1000);
+            }
+            isAppStarted = false;
+            await execListeners(onAppExiting);
+            if (isUsingWorker()) {
+                // Allows to worker to correctly stop their activity.
+                await NodeSpace.timer.tick(100);
+            }
+            if (!NodeSpace.thread.isMainThread) {
+                // Allows to worker to correctly stop their activity.
+                await NodeSpace.timer.tick(50);
+            }
+            if (onAppExited.length)
+                debugger;
+            await execListeners(onAppExited);
+        },
+        executeApp: async (app) => {
+            await NodeSpace.app.waitServerSideReady();
+            NodeSpace.app.declareAppStarted();
+            try {
+                const res = app();
+                if (res instanceof Promise)
+                    await res;
+            }
+            finally {
+                NodeSpace.app.declareAppExiting();
+            }
+        },
+        onHotReload(listener) {
+            onHotReload.push(listener);
+        },
+        keepOnHotReload: (key, provider) => {
+            let current = memory[key];
+            if (current !== undefined)
+                return current;
+            return memory[key] = provider();
+        }
+    };
+}
+//# sourceMappingURL=nodeSpaceApp.js.map

package/dist/nodeSpaceApp.js.map

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

package/dist/nodeSpaceExtensionPoints.d.ts

@@ -0,0 +1 @@
+export declare function init_nodeSpaceExtensionPoints(): void;

package/dist/nodeSpaceExtensionPoints.js

@@ -0,0 +1,51 @@
+import {} from "./common.js";
+const gExtensionPoints = {};
+function createExtensionPoint(epName, hostInfo, callerInfo, listenerInfo) {
+    async function caller(...args) {
+        for (const listener of ep.listeners) {
+            const res = listener(...args);
+            if (res instanceof Promise)
+                await res;
+        }
+    }
+    const listeners = [];
+    const ep = {
+        listeners, caller,
+        allHostPath: [],
+        allCallerPath: [],
+        allListenerPath: []
+    };
+    gExtensionPoints[epName] = ep;
+    if (hostInfo) {
+        ep.allHostPath.push(hostInfo);
+    }
+    if (callerInfo) {
+        ep.allCallerPath.push(callerInfo);
+    }
+    if (listenerInfo) {
+        ep.allListenerPath.push(listenerInfo);
+    }
+}
+export function init_nodeSpaceExtensionPoints() {
+    NodeSpace.extensionPoints = {
+        newHost(epName, importMetaUrl) {
+            const ep = gExtensionPoints[epName];
+            if (!ep)
+                createExtensionPoint(epName, importMetaUrl, null, null);
+            return ep.caller;
+        },
+        getCaller(epName, importMetaUrl) {
+            const ep = gExtensionPoints[epName];
+            if (!ep)
+                createExtensionPoint(epName, null, importMetaUrl, null);
+            return ep.caller;
+        },
+        on(epName, importMetaUrl, listener) {
+            const ep = gExtensionPoints[epName];
+            if (!ep)
+                createExtensionPoint(epName, null, null, importMetaUrl);
+            ep.listeners.push(listener);
+        }
+    };
+}
+//# sourceMappingURL=nodeSpaceExtensionPoints.js.map

package/dist/nodeSpaceExtensionPoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeSpaceExtensionPoints.js","sourceRoot":"","sources":["../src/nodeSpaceExtensionPoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,MAAM,aAAa,CAAC;AAW3D,MAAM,gBAAgB,GAAuC,EAC5D,CAAA;AAED,SAAS,oBAAoB,CAAC,MAAc,EAAE,QAAqB,EAAE,UAAuB,EAAE,YAAyB;IACnH,KAAK,UAAU,MAAM,CAAC,GAAG,IAAe;QACpC,KAAK,MAAM,QAAQ,IAAI,EAAE,CAAC,SAAS,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;YAC9B,IAAI,GAAG,YAAY,OAAO;gBAAE,MAAM,GAAG,CAAC;QAC1C,CAAC;IACL,CAAC;IAED,MAAM,SAAS,GAAiB,EAAE,CAAC;IAEnC,MAAM,EAAE,GAAmB;QACvB,SAAS,EAAE,MAAM;QACjB,WAAW,EAAE,EAAE;QACf,aAAa,EAAE,EAAE;QACjB,eAAe,EAAE,EAAE;KACtB,CAAC;IAEF,gBAAgB,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;IAE9B,IAAI,QAAQ,EAAE,CAAC;QACX,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACb,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACf,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1C,CAAC;AACL,CAAC;AAED,MAAM,UAAU,6BAA6B;IACzC,SAAS,CAAC,eAAe,GAAG;QACxB,OAAO,CAAC,MAAc,EAAE,aAAqB;YACzC,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,CAAC,EAAE;gBAAE,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YACjE,OAAO,EAAE,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,SAAS,CAAC,MAAc,EAAE,aAAqB;YAC3C,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,CAAC,EAAE;gBAAE,oBAAoB,CAAC,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;YACjE,OAAO,EAAE,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,EAAE,CAAC,MAAc,EAAE,aAAqB,EAAE,QAAoB;YAC1D,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,CAAC,EAAE;gBAAE,oBAAoB,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;YACjE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/nodeSpaceProcess.d.ts

@@ -0,0 +1 @@
+export declare function init_nodeSpaceProcess(): void;

package/dist/nodeSpaceProcess.js

@@ -0,0 +1,15 @@
+export function init_nodeSpaceProcess() {
+    NodeSpace.process = {
+        isProduction: false,
+        argv: [],
+        env: {},
+    };
+    // For bundlers.
+    try {
+        NodeSpace.process.env = import.meta.env;
+        NodeSpace.process.isProduction = (import.meta.env.PROD === "true");
+    }
+    catch {
+    }
+}
+//# sourceMappingURL=nodeSpaceProcess.js.map

package/dist/nodeSpaceProcess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeSpaceProcess.js","sourceRoot":"","sources":["../src/nodeSpaceProcess.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,qBAAqB;IACjC,SAAS,CAAC,OAAO,GAAG;QAChB,YAAY,EAAE,KAAK;QACnB,IAAI,EAAE,EAAE;QACR,GAAG,EAAE,EAAE;KACV,CAAC;IAEF,gBAAgB;IAChB,IAAI,CAAC;QACD,SAAS,CAAC,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAkC,CAAC;QACvE,SAAS,CAAC,OAAO,CAAC,YAAY,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;IACT,CAAC;AACL,CAAC"}

package/dist/nodeSpaceThread.d.ts

@@ -0,0 +1 @@
+export declare function init_nodeSpaceThread(): void;

package/dist/nodeSpaceThread.js

@@ -0,0 +1,19 @@
+import { declareUsingWorker } from "./internal.js";
+export function init_nodeSpaceThread() {
+    NodeSpace.thread = {
+        isMainThread: true,
+        currentWorker: null,
+        getCurrentWorkerData: () => { },
+        unrefThisWorker: () => { },
+        newWorker: (fileName) => {
+            declareUsingWorker();
+            return new Worker(fileName, { type: 'module' });
+        },
+        closeCurrentThread() {
+            if (self.close) {
+                self.close();
+            }
+        }
+    };
+}
+//# sourceMappingURL=nodeSpaceThread.js.map

package/dist/nodeSpaceThread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeSpaceThread.js","sourceRoot":"","sources":["../src/nodeSpaceThread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,eAAe,CAAC;AAEjD,MAAM,UAAU,oBAAoB;IAChC,SAAS,CAAC,MAAM,GAAG;QACf,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,IAAI;QACnB,oBAAoB,EAAE,GAAG,EAAE,GAAE,CAAC;QAC9B,eAAe,EAAE,GAAG,EAAE,GAAE,CAAC;QAEzB,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE;YACpB,kBAAkB,EAAE,CAAC;YACrB,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAC,CAAC,CAAA;QACjD,CAAC;QAED,kBAAkB;YACd,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACb,IAAI,CAAC,KAAK,EAAE,CAAC;YACjB,CAAC;QACL,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/nodeSpaceTimer.d.ts

@@ -0,0 +1 @@
+export declare function init_nodeSpaceTimer(): void;

package/dist/nodeSpaceTimer.js

@@ -0,0 +1,7 @@
+import { tick } from "./common.js";
+export function init_nodeSpaceTimer() {
+    NodeSpace.timer = {
+        tick: tick
+    };
+}
+//# sourceMappingURL=nodeSpaceTimer.js.map

package/dist/nodeSpaceTimer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeSpaceTimer.js","sourceRoot":"","sources":["../src/nodeSpaceTimer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAC;AAEjC,MAAM,UAAU,mBAAmB;IAC/B,SAAS,CAAC,KAAK,GAAG;QACd,IAAI,EAAE,IAAI;KACb,CAAC;AACN,CAAC"}

package/dist/nodeSpaceWhat.d.ts

@@ -0,0 +1 @@
+export declare function init_nodeSpaceWhat(): void;

package/dist/nodeSpaceWhat.js

@@ -0,0 +1,10 @@
+export function init_nodeSpaceWhat() {
+    NodeSpace.what = {
+        isNodeJS: false,
+        isBunJs: false,
+        isServerSide: false,
+        isBrowser: true,
+        serverType: "browser",
+    };
+}
+//# sourceMappingURL=nodeSpaceWhat.js.map

package/dist/nodeSpaceWhat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeSpaceWhat.js","sourceRoot":"","sources":["../src/nodeSpaceWhat.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,kBAAkB;IAC9B,SAAS,CAAC,IAAI,GAAG;QACb,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,KAAK;QACd,YAAY,EAAE,KAAK;QACnB,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,SAAS;KACxB,CAAC;AACN,CAAC"}

package/dist/serverSide.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/serverSide.js

@@ -0,0 +1,34 @@
+import { isMainThread, parentPort, Worker as NodeWorker, workerData } from "node:worker_threads";
+import { declareUsingWorker } from "./internal.js";
+import fs from "node:fs/promises";
+NodeSpace.process = {
+    argv: process.argv,
+    env: process.env,
+    isProduction: process.env.NODE_ENV === 'production'
+};
+NodeSpace.thread = {
+    isMainThread: isMainThread,
+    currentWorker: parentPort,
+    getCurrentWorkerData: () => workerData,
+    newWorker: (fileName, data) => {
+        declareUsingWorker();
+        const res = data ?
+            new NodeWorker(fileName, { workerData: data }) :
+            new NodeWorker(fileName);
+        return res;
+    },
+    unrefThisWorker: (worker) => {
+        worker.unref();
+    },
+    closeCurrentThread() {
+        if (parentPort) {
+            parentPort.close();
+        }
+    }
+};
+NodeSpace.fs = {
+    mkDir: (dirPath) => fs.mkdir(dirPath, { recursive: true })
+};
+NodeSpace.app.declareServerSideReady();
+process.on('exit', () => NodeSpace.app.declareAppExiting());
+//# sourceMappingURL=serverSide.js.map

package/dist/serverSide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverSide.js","sourceRoot":"","sources":["../src/serverSide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,UAAU,EAAE,UAAU,EAAC,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EAAC,kBAAkB,EAAC,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAElC,SAAS,CAAC,OAAO,GAAG;IAChB,IAAI,EAAE,OAAO,CAAC,IAAI;IAClB,GAAG,EAAE,OAAO,CAAC,GAAgC;IAC7C,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;CACtD,CAAC;AAEF,SAAS,CAAC,MAAM,GAAG;IACf,YAAY,EAAE,YAAY;IAC1B,aAAa,EAAE,UAA+B;IAC9C,oBAAoB,EAAE,GAAG,EAAE,CAAC,UAAU;IAEtC,SAAS,EAAE,CAAC,QAAQ,EAAE,IAAU,EAAE,EAAE;QAChC,kBAAkB,EAAE,CAAC;QAErB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC;YACd,IAAI,UAAU,CAAC,QAAQ,EAAE,EAAC,UAAU,EAAE,IAAI,EAAC,CAAC,CAAC,CAAC;YAC9C,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC;QAE7B,OAAO,GAAwB,CAAA;IACnC,CAAC;IAED,eAAe,EAAE,CAAC,MAAc,EAAE,EAAE;QAC/B,MAAgC,CAAC,KAAK,EAAE,CAAC;IAC9C,CAAC;IAED,kBAAkB;QACd,IAAI,UAAU,EAAE,CAAC;YACb,UAAU,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;IACL,CAAC;CACJ,CAAA;AAED,SAAS,CAAC,EAAE,GAAG;IACX,KAAK,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC;CACnE,CAAA;AAED,SAAS,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC;AAEvC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "version": "0.0.1",
+  "private": false,
+  "name": "jopi-node-space",
+  "license": "MIT",
+  "homepage": "https://github.com/johanpiquet/jopi-node-space",
+
+  "keywords": [],
+  "author": "Johan PIQUET",
+  "description": "An helper for hybrid apps",
+
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+
+  "devDependencies": {
+    "@types/node": "latest",
+    "@types/bun": "latest"
+  },
+
+  "scripts": {
+    "bun-install": "bun install",
+    "tsc": "tsc",
+
+    "npm-publish": "npm publish"
+  }
+}

package/src/browser.ts

@@ -0,0 +1,15 @@
+import {init_nodeSpaceWhat} from "./nodeSpaceWhat.ts";
+import {init_nodeSpaceApp} from "./nodeSpaceApp.ts";
+import {init_nodeSpaceProcess} from "./nodeSpaceProcess.ts";
+import {init_nodeSpaceTimer} from "./nodeSpaceTimer.ts";
+import {init_nodeSpaceThread} from "./nodeSpaceThread.ts";
+import {init_nodeSpaceExtensionPoints} from "./nodeSpaceExtensionPoints";
+
+export function initBrowser() {
+    init_nodeSpaceWhat();
+    init_nodeSpaceApp();
+    init_nodeSpaceProcess();
+    init_nodeSpaceTimer();
+    init_nodeSpaceThread();
+    init_nodeSpaceExtensionPoints();
+}

package/src/common.ts

@@ -0,0 +1,128 @@
+declare global {
+    var NodeSpace: NodeSpaceType;
+    var jopiHotReloader: HotReloadType;
+}
+
+globalThis.NodeSpace = {} as NodeSpaceType;
+
+let _isBunJs = false;
+let _isNodeJs = false;
+
+export async function execListeners(listeners: Listener[]) {
+    const list = [...listeners];
+    listeners.splice(0);
+
+    for (const listener of list) {
+        try {
+            const res = listener();
+            if (res instanceof Promise) await res;
+        }
+        catch (e) {
+            console.error(e);
+        }
+    }
+}
+
+export function isServerSide(): boolean {
+    return isBunJs() || isNodeJs();
+}
+
+export function isBunJs(): boolean {
+    if (_isBunJs) return _isBunJs;
+    return _isBunJs = typeof(Bun)!=="undefined";
+}
+
+export function isNodeJs(): boolean {
+    if (_isNodeJs) return _isNodeJs;
+    return _isNodeJs = typeof(self)==="undefined";
+}
+
+export function tick(delayMs: number): Promise<void> {
+    return new Promise((resolve) => setTimeout(resolve, delayMs));
+}
+
+export type ServerType = "nodejs"|"bunjs"|"browser";
+export type Listener = ()=>void|Promise<void>;
+
+export interface NodeSpaceType {
+    what: WhatInfos;
+    thread: ThreadImpl;
+    process: ProcessImpl;
+    timer: TimerImpl;
+    app: AppImpl;
+    fs?: FileSystemImpl;
+    extensionPoints?: ExtensionPointImpl;
+}
+
+export interface HotReloadType {
+    onHotReload: Listener[];
+    memory: { [key: string]: any };
+}
+
+interface WhatInfos {
+    isNodeJS: boolean;
+    isBunJs: boolean;
+    isBrowser: boolean;
+    isServerSide: boolean;
+    serverType: ServerType;
+}
+
+interface ThreadImpl {
+    isMainThread: boolean;
+    currentWorker: Worker | null;
+    newWorker: (fileName: string | URL, data?: any) => Worker;
+    getCurrentWorkerData: ()=>any;
+    unrefThisWorker(worker: Worker): void;
+    closeCurrentThread(): void;
+}
+
+interface ProcessImpl {
+    argv: string[];
+    env: { [key: string]: string };
+    isProduction: boolean;
+}
+
+interface TimerImpl {
+    tick: (delayMs: number) => Promise<void>;
+}
+
+interface FileSystemImpl {
+    mkDir: (dirPath: string) => Promise<string | undefined>;
+}
+
+interface AppImpl {
+    onServerSideReady(listener: Listener): void;
+    waitServerSideReady: () => Promise<void>;
+    declareServerSideReady(): void;
+
+    onAppStart(listener: Listener): void;
+    onAppExiting(listener: Listener): void;
+    onAppExited(listener: Listener): void;
+    executeApp(app: Listener): void;
+    declareAppStarted(): void;
+    declareAppExiting(): void;
+
+    onHotReload(listener: Listener): void;
+    keepOnHotReload<T>(key: string, provider: ()=>T): T;
+}
+
+export type EpCaller = (...values:  unknown[]) => Promise<void>;
+export type EpListener = (...values:  unknown[]) => void|Promise<void>;
+
+interface ExtensionPointImpl {
+    /**
+     * Register an extension point.
+     * Allow knowing who is using it as an host.
+     */
+    newHost(epName: string, importMetaUrl: string): EpCaller;
+
+    /**
+     * Get a caller, allowing to call the extension point.
+     */
+    getCaller(epName: string, importMetaUrl: string): EpCaller;
+
+    /**
+     * Add a function which is called when the extension point is called.
+     */
+    on(epName: string, importMetaUrl: string, fct: EpListener): void;
+}

package/src/index.ts

@@ -0,0 +1,35 @@
+import {isBunJs, isNodeJs, isServerSide, type ServerType} from "./common.ts";
+
+export * from "./common.ts";
+
+import {initBrowser} from "./browser.ts";
+
+// Will init with the common stuffs.
+initBrowser();
+
+if (isServerSide()) {
+    let serverType: ServerType = "nodejs";
+    if (isBunJs()) serverType = "bunjs";
+
+    // Allow conditional code to be ok
+    // despite the "await import" is not done yet.
+    //
+    const nodeSpace = globalThis.NodeSpace;
+
+    nodeSpace.what = {
+        isNodeJS: isNodeJs(),
+        isBunJs: isBunJs(),
+        isBrowser: false,
+        isServerSide: true,
+        serverType: serverType,
+    }
+
+    let ext = import.meta.filename.split(".").pop();
+    const fileName = "./serverSide." + ext;
+
+    // To know: the caller will not wait for the await to resolve.
+    // Wait is after will not be interpreted immediately by the caller
+    // doing that specifics server-side things will not be ok now.
+    //
+    await import(/* @vite-ignore */ fileName);
+}

package/src/internal.ts

@@ -0,0 +1,9 @@
+export let gIsUsingWorkers = false;
+
+export function declareUsingWorker() {
+    gIsUsingWorkers = true;
+}
+
+export function isUsingWorker(): boolean {
+    return gIsUsingWorkers;
+}

package/src/nodeSpaceApp.ts

@@ -0,0 +1,113 @@
+import {execListeners, isBunJs, isNodeJs, type Listener} from "./common.ts";
+import {isUsingWorker} from "./internal.ts";
+
+export function init_nodeSpaceApp() {
+    const onServerSideReady: Listener[] = [];
+    const onAppExiting: Listener[] = [];
+    const onAppExited: Listener[] = [];
+    const onAppStart: Listener[] = [];
+    let isServerSideReady = !(isNodeJs() || isBunJs());
+
+    let isHotReload = globalThis.jopiHotReloader !== undefined;
+    let isAppStarted = false;
+
+    if (isHotReload) {
+        execListeners(globalThis.jopiHotReloader.onHotReload).then();
+    } else {
+        globalThis.jopiHotReloader = {
+            onHotReload: [],
+            memory: {}
+        }
+    }
+
+    const onHotReload = globalThis.jopiHotReloader.onHotReload;
+    const memory = globalThis.jopiHotReloader.memory;
+
+    NodeSpace.app = {
+        onServerSideReady: (listener) => {
+            if (isServerSideReady) listener();
+            else onServerSideReady.push(listener);
+        },
+
+        waitServerSideReady: () => {
+            if (isServerSideReady) {
+                return Promise.resolve();
+            }
+
+            return new Promise<void>(r => {
+                NodeSpace.app.onServerSideReady(r);
+            })
+        },
+
+        declareServerSideReady: async () => {
+            isServerSideReady = true;
+            await execListeners(onServerSideReady);
+        },
+
+        onAppStart: (listener: Listener) => {
+            if (isAppStarted) listener();
+            else onAppStart.push(listener);
+        },
+
+        onAppExiting: (listener: Listener) => {
+            if (!isAppStarted) listener();
+            else onAppExiting.push(listener);
+        },
+
+        onAppExited: (listener: Listener) => {
+            if (!isAppStarted) listener();
+            else onAppExited.push(listener);
+        },
+
+        declareAppStarted: async () => {
+            isAppStarted = true;
+            await execListeners(onAppStart);
+        },
+
+        declareAppExiting: async () => {
+            if (isUsingWorker()) {
+                // Wait 1 sec, which allows the worker to correctly initialize.
+                await NodeSpace.timer.tick(1000);
+            }
+
+            isAppStarted = false;
+            await execListeners(onAppExiting);
+
+            if (isUsingWorker()) {
+                // Allows to worker to correctly stop their activity.
+                await NodeSpace.timer.tick(100);
+            }
+
+            if (!NodeSpace.thread.isMainThread) {
+                // Allows to worker to correctly stop their activity.
+                await NodeSpace.timer.tick(50);
+            }
+
+            if (onAppExited.length) debugger;
+            await execListeners(onAppExited);
+        },
+
+        executeApp: async (app) => {
+            await NodeSpace.app.waitServerSideReady();
+            NodeSpace.app.declareAppStarted();
+
+            try {
+                const res = app();
+                if (res instanceof Promise) await res;
+            }
+            finally {
+                NodeSpace.app.declareAppExiting();
+            }
+        },
+
+        onHotReload(listener: Listener) {
+            onHotReload.push(listener);
+        },
+
+        keepOnHotReload: (key, provider) => {
+            let current = memory[key];
+            if (current!==undefined) return current;
+            return memory[key] = provider();
+        }
+    };
+}

package/src/nodeSpaceExtensionPoints.ts

@@ -0,0 +1,67 @@
+import {type EpCaller, type EpListener} from "./common.ts";
+
+interface ExtensionPoint {
+    listeners: EpListener[];
+    caller: EpCaller;
+
+    allHostPath: string[];
+    allCallerPath: string[];
+    allListenerPath: string[];
+}
+
+const gExtensionPoints: {[epName: string]: ExtensionPoint} = {
+}
+
+function createExtensionPoint(epName: string, hostInfo: string|null, callerInfo: string|null, listenerInfo: string|null) {
+    async function caller(...args: unknown[]) {
+        for (const listener of ep.listeners) {
+            const res = listener(...args);
+            if (res instanceof Promise) await res;
+        }
+    }
+
+    const listeners: EpListener[] = [];
+
+    const ep: ExtensionPoint = {
+        listeners, caller,
+        allHostPath: [],
+        allCallerPath: [],
+        allListenerPath: []
+    };
+
+    gExtensionPoints[epName] = ep;
+
+    if (hostInfo) {
+        ep.allHostPath.push(hostInfo);
+    }
+
+    if (callerInfo) {
+        ep.allCallerPath.push(callerInfo);
+    }
+
+    if (listenerInfo) {
+        ep.allListenerPath.push(listenerInfo);
+    }
+}
+
+export function init_nodeSpaceExtensionPoints() {
+    NodeSpace.extensionPoints = {
+        newHost(epName: string, importMetaUrl: string): EpCaller {
+            const ep = gExtensionPoints[epName];
+            if (!ep) createExtensionPoint(epName, importMetaUrl, null, null);
+            return ep.caller;
+        },
+
+        getCaller(epName: string, importMetaUrl: string): EpCaller {
+            const ep = gExtensionPoints[epName];
+            if (!ep) createExtensionPoint(epName, null, importMetaUrl, null);
+            return ep.caller;
+        },
+
+        on(epName: string, importMetaUrl: string, listener: EpListener): void {
+            const ep = gExtensionPoints[epName];
+            if (!ep) createExtensionPoint(epName, null, null, importMetaUrl);
+            ep.listeners.push(listener);
+        }
+    };
+}

package/src/nodeSpaceProcess.ts

@@ -0,0 +1,14 @@
+export function init_nodeSpaceProcess() {
+    NodeSpace.process = {
+        isProduction: false,
+        argv: [],
+        env: {},
+    };
+
+    // For bundlers.
+    try {
+        NodeSpace.process.env = import.meta.env as ({ [key: string]: string });
+        NodeSpace.process.isProduction = (import.meta.env.PROD === "true");
+    } catch {
+    }
+}

package/src/nodeSpaceThread.ts

@@ -0,0 +1,21 @@
+import {declareUsingWorker} from "./internal.ts";
+
+export function init_nodeSpaceThread() {
+    NodeSpace.thread = {
+        isMainThread: true,
+        currentWorker: null,
+        getCurrentWorkerData: () => {},
+        unrefThisWorker: () => {},
+
+        newWorker: (fileName) => {
+            declareUsingWorker();
+            return new Worker(fileName, {type: 'module'})
+        },
+
+        closeCurrentThread() {
+            if (self.close) {
+                self.close();
+            }
+        }
+    };
+}

package/src/nodeSpaceTimer.ts

@@ -0,0 +1,7 @@
+import {tick} from "./common.ts";
+
+export function init_nodeSpaceTimer() {
+    NodeSpace.timer = {
+        tick: tick
+    };
+}

package/src/nodeSpaceWhat.ts

@@ -0,0 +1,9 @@
+export function init_nodeSpaceWhat() {
+    NodeSpace.what = {
+        isNodeJS: false,
+        isBunJs: false,
+        isServerSide: false,
+        isBrowser: true,
+        serverType: "browser",
+    };
+}

package/src/serverSide.ts

@@ -0,0 +1,43 @@
+import {isMainThread, parentPort, Worker as NodeWorker, workerData} from "node:worker_threads";
+import {declareUsingWorker} from "./internal.ts";
+import fs from "node:fs/promises";
+
+NodeSpace.process = {
+    argv: process.argv,
+    env: process.env as { [key: string]: string },
+    isProduction: process.env.NODE_ENV === 'production'
+};
+
+NodeSpace.thread = {
+    isMainThread: isMainThread,
+    currentWorker: parentPort as unknown as Worker,
+    getCurrentWorkerData: () => workerData,
+
+    newWorker: (fileName, data?: any) => {
+        declareUsingWorker();
+
+        const res = data ?
+            new NodeWorker(fileName, {workerData: data}) :
+            new NodeWorker(fileName);
+
+        return res as unknown as Worker
+    },
+
+    unrefThisWorker: (worker: Worker) => {
+        (worker as unknown as NodeWorker).unref();
+    },
+
+    closeCurrentThread() {
+        if (parentPort) {
+            parentPort.close();
+        }
+    }
+}
+
+NodeSpace.fs = {
+    mkDir: (dirPath: string) => fs.mkdir(dirPath, {recursive: true})
+}
+
+NodeSpace.app.declareServerSideReady();
+
+process.on('exit', () => NodeSpace.app.declareAppExiting());

package/tsconfig.json

@@ -0,0 +1,33 @@
+{
+  "compilerOptions": {
+    "sourceMap": true,
+    "declaration": true,
+
+    "outDir": "./dist",
+    "rootDir": "./src",
+
+    // Permet d'avoir des fonctions comme fetch.
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "rewriteRelativeImportExtensions": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmitOnError": false,
+    "verbatimModuleSyntax": true,
+    "allowJs": false
+  },
+
+  "include": [
+    "./src/*.ts"
+  ],
+
+  "exclude": [
+    "node_modules",
+    "**/*.spec.ts"
+  ]
+}