Rewrite for typescript support, ESM & CJS integration

.gitignore

@@ -0,0 +1,4 @@
+node_modules
+dist
+.env
+.proto

README.md

@@ -1,9 +1,19 @@
 # QuorielEdge
-An extended set of functions for ForgeScript, designed to optimize workflows, simplify the execution of various tasks, and support script integration and processing.
+A super-set of ForgeScript, designed to optimize workflows, apply community patches, simplify the execution of various tasks, and support script integration and processing.
+
+
 
 ## Installation
-```
-npm i github:quoriel/edge
+```bash
+# Install using your package managers
+
+# Using NPM
+npm install github:quoriel/edge
+
+# or using 3rd package managers
+yarn install github:quoriel/edge
+pnpm install github:quoriel/edge
+bun  install github:quoriel/edge
 ```
 
 ## Connection
@@ -18,4 +28,21 @@ const client = new ForgeClient({
 });
 
 client.login("...");
+```
+
+## Building from source
+You can clone this repository to your project workspace
+> The code were build with bun's transpiler (ESM) and TypeScript (CJS)
+
+```bash
+# Run the following commands
+# Using Bun
+bun run build
+
+# or using NodeJS v23
+# Make sure to install bun if you're using nodejs
+# npm install --save-dev bun
+
+node --experimental-strip-types scripts/build.ts
+
 ```

ROADMAP.md

@@ -0,0 +1,7 @@
+# Roadmap
+This is an extension focused as a super-set for forgescript and potentially optimizing the internal interpeter's workflow for better time execution
+
+## Core Features
+- [] Better approach for function implementation
+- [] Bytecode
+- [] Serverless execution

metadata/functions.json

@@ -1 +1 @@
-[{"name":"$execution","description":"Executes code exported as a string from the specified file","version":"1.0.0","output":["Unknown"],"brackets":true,"unwrap":true,"args":[{"name":"path","description":"File path","type":"String","required":true,"rest":false}]},{"name":"$jsonAssign","description":"Combines multiple JSON objects into a single JSON object","version":"1.0.0","output":["Json"],"brackets":true,"unwrap":true,"args":[{"name":"json","description":"JSON objects for merging","type":"Json","required":true,"rest":true}]},{"name":"$require","description":"Dynamically loads the module","version":"1.0.0","output":["Unknown"],"brackets":true,"unwrap":true,"args":[{"name":"path","description":"Module path","type":"String","required":true,"rest":false}]},{"name":"$requireCache","description":"Deletes a module from the cache or reloads it (including dependencies)","version":"1.0.0","output":["Boolean"],"brackets":true,"unwrap":true,"args":[{"name":"path","description":"Module path","type":"String","required":true,"rest":false},{"name":"type","description":"Type of action","type":"Enum","enum":["delete","update"],"required":true,"rest":false,"enumName":"ActionType"},{"name":"recursive","description":"Whether to clear cache recursively","type":"Boolean","rest":false}]}]
+[{"name":"$execution","description":"Executes code exported as a string from the specified file","version":"1.0.0","output":["Unknown"],"brackets":true,"unwrap":true,"args":[{"name":"path","description":"File path","type":"String","required":true,"rest":false}]},{"name":"$jsonAssign","description":"Combines multiple JSON objects into a single JSON object","version":"1.0.0","output":["Json"],"brackets":true,"unwrap":true,"args":[{"name":"json","description":"JSON objects for merging","type":"Json","required":true,"rest":true}]},{"name":"$append","description":"Appends items into the last of list","unwrap":true,"brackets":true,"args":[{"name":"sourcesToAppend","description":"The source or target of items to be inserted","type":"Unknown","rest":false,"required":true},{"name":"items","description":"The items to append","type":"Unknown","rest":true,"required":true}],"category":"object","version":"1.0.0"},{"name":"$delete","description":"Deletes a key from an object or context","unwrap":true,"brackets":true,"args":[{"name":"propertyKey","description":"The name of the property or key of object","type":"String","rest":false,"required":true},{"name":"object","description":"The source of object","type":"Unknown","rest":false,"required":false}],"category":"object","version":"1.0.0"},{"name":"$deserialize","description":"Deserializes a serialized input into an object","unwrap":true,"brackets":true,"args":[{"name":"input","description":"The input that is to be deserialized","type":"String","rest":false,"required":false},{"name":"deserializer","description":"A deserializer instance or name of a registered service","type":"Unknown","rest":false,"required":false}],"category":"object","version":"1.0.0"},{"name":"$require","description":"Loads the module to $require","output":["Unknown"],"brackets":true,"unwrap":true,"args":[{"name":"path","description":"Module path","type":"String","required":true,"rest":false}],"category":"object","version":"1.0.0"},{"name":"$serialize","description":"Serializes an object into a serializer","unwrap":true,"brackets":true,"args":[{"name":"object","description":"The object that is to be serialized","type":"Unknown","rest":false,"required":false},{"name":"serializer","description":"A serializer instance or name of a registered service","type":"Unknown","rest":false,"required":false}],"category":"object","version":"1.0.0"},{"name":"$requireCache","description":"Deletes a module from the cache or reloads it (including dependencies)","version":"1.0.0","output":["Boolean"],"brackets":true,"unwrap":true,"args":[{"name":"path","description":"Module path","type":"String","required":true,"rest":false},{"name":"type","description":"Type of action","type":"Enum","enum":["delete","update"],"required":true,"rest":false,"enumName":"ActionType"},{"name":"recursive","description":"Whether to clear cache recursively","type":"Boolean","rest":false}]}]

metadata/paths.json

@@ -1 +1 @@
-{"functions":"src/functions"}
+{"functions":"src/functions"}

package.json

@@ -2,13 +2,27 @@
     "name": "@quoriel/edge",
     "description": "A set of additional functions for ForgeScript to simplify work with various scripts and tasks",
     "version": "1.0.0",
-    "main": "src/main.js",
     "author": "Mlad (https://github.com/eolthar)",
     "license": "GPL-3.0",
     "scripts": {
-        "docgen": "node src/docgen.js"
+        "docgen": "bun run scripts/docgen",
+        "build": "bun run build:src && bun run build:types",
+        "build:src": "bun run scripts/build",
+        "build:types": "bunx tsc -p tsconfig.json",
+        "watch:types": "bunx tsc --watch -p tsconfig.json"
     },
     "dependencies": {
-        "@tryforge/forgescript": "^2.4.1"
-    }
+        "@tryforge/forgescript": "^2.4.1",
+        "zod": "^4.1.12"
+    },
+    "devDependencies": {
+        "@types/bun": "^1.3.1",
+        "toml": "^3.0.0",
+        "typescript": "^5.9.3"
+    },
+    "exports": [
+        "./dist/index.js",
+        "./dist/index.mjs"
+    ],
+    "types": "./dist/types"
 }

scripts/build.ts

@@ -0,0 +1,28 @@
+import { Glob } from "bun";
+import { rmSync } from "fs";
+
+const sourceDirectory = 'src/**/*.ts'
+const glob = new Glob(sourceDirectory)
+var entrypoints = [...glob.scanSync()]
+entrypoints = entrypoints.map((x) => `${x}`)
+
+const BuildOptions: Bun.BuildConfig = {
+    entrypoints: entrypoints,
+    splitting: true,
+    target: 'node',
+    tsconfig: 'tsconfig.json',
+    external: ['@tryforge/forgescript'],
+    naming: '[dir]/[name].mjs',
+    root: 'src'
+}
+
+// Clear existing dist
+rmSync('dist', { recursive: true, force: true })
+
+// Transpiling for ES Modules
+Bun.build({...BuildOptions, format: 'esm', outdir: 'dist'})
+
+// Transpiling for CommonJS
+// # Use tsc since its cleaner
+// BuildOptions.splitting = false
+// Bun.build({...BuildOptions, format: 'cjs', outdir: 'dist/cjs'})

scripts/docgen.ts

@@ -0,0 +1,4 @@
+import { generateMetadata } from "@tryforge/forgescript";
+import { resolve } from "path";
+
+generateMetadata(resolve(process.cwd(), 'dist/functions'), "functions")

src/extension.ts

@@ -0,0 +1,35 @@
+import { ForgeExtension, FunctionManager, type ForgeClient } from "@tryforge/forgescript";
+import { name, description, version } from '../package.json'
+import { resolve, extname } from "path";
+import { globSync } from "fs";
+
+export class QuorielExtension extends ForgeExtension {
+    public readonly name = name
+    public readonly description = description
+    public readonly version = version
+
+    public init(client: ForgeClient) {
+        // The internal handler doesn't support
+        // Dynamic script extension
+        // eg. .mjs, .ts, .cjs
+        const fnEntrypoints = globSync(`${__dirname}/functions/**/*${extname(__filename)}`)
+        let modules = []
+
+        for (const fname of fnEntrypoints) {
+            const module = require(fname)
+            if ('default' in module) {
+                modules.push(module.default)
+                continue;
+            }
+
+            if (Array.isArray(module)) {
+                modules.push(...module)
+                continue;
+            }
+
+            modules.push(module);
+        }
+
+        FunctionManager.addMany(modules)
+    }
+}

src/functions/execution.js → src/functions/execution.ts

@@ -1,8 +1,14 @@
-const { Logger, NativeFunction, ArgType, Compiler, Interpreter } = require("@tryforge/forgescript");
-const { resolve } = require("path");
-const { existsSync } = require("fs");
+import {
+    Compiler,
+    Interpreter,
+    ArgType,
+    NativeFunction,
+    Logger
+} from '@tryforge/forgescript'
+import { resolve } from 'path'
+import { existsSync } from 'fs';
 
-exports.default = new NativeFunction({
+export default new NativeFunction({
     name: "$execution",
     description: "Executes code exported as a string from the specified file",
     version: "1.0.0",
@@ -31,9 +37,9 @@ exports.default = new NativeFunction({
                 data: Compiler.compile(code)
             });
             return result === null ? this.stop() : this.success(result);
-        } catch (error) {
+        } catch (error:unknown) {
             Logger.error(error);
-            return this.error(error);
+            return this.error(error as Error);
         }
     }
 });