@forthix/forthic 0.9.0 → 0.11.0

package/dist/esm/jsonrpc/server.js

@@ -0,0 +1,349 @@
+/**
+ * TypeScript JSON-RPC 2.0 Server for Forthic
+ *
+ * Mirrors the four methods of the gRPC server:
+ *   executeWord, executeSequence, listModules, getModuleInfo
+ *
+ * Transport: HTTP POST /rpc with JSON-RPC 2.0 envelopes.
+ * Uses Node's built-in `http` module — zero new dependencies.
+ *
+ * `executeSequence` is a single JSON-RPC call with an array of words; it is
+ * NOT a JSON-RPC batch. Batch envelopes are rejected with code -32600.
+ */
+import * as http from 'http';
+import { StandardInterpreter } from '../forthic/interpreter.js';
+import { serializeValue, deserializeValue } from '../grpc/serializer.js';
+import { FsModule } from '../forthic/modules/typescript/fs_module.js';
+import { JsonRpcErrorCode } from './errors.js';
+class ForthicJsonRpcServicer {
+    runtimeModules;
+    constructor() {
+        this.runtimeModules = {
+            fs: new FsModule(),
+        };
+    }
+    async executeWord(params) {
+        const wordName = params?.word_name;
+        if (typeof wordName !== 'string') {
+            throw makeInvalidParams('executeWord requires string "word_name"');
+        }
+        const stackParam = params?.stack;
+        if (!Array.isArray(stackParam)) {
+            throw makeInvalidParams('executeWord requires array "stack"');
+        }
+        const stack = stackParam.map((sv) => deserializeValue(sv));
+        const resultStack = await this._executeWithStack(wordName, stack);
+        return { result_stack: resultStack.map((v) => serializeValue(v)) };
+    }
+    async executeSequence(params) {
+        const wordNames = params?.word_names;
+        if (!Array.isArray(wordNames) || !wordNames.every((w) => typeof w === 'string')) {
+            throw makeInvalidParams('executeSequence requires string[] "word_names"');
+        }
+        const stackParam = params?.stack;
+        if (!Array.isArray(stackParam)) {
+            throw makeInvalidParams('executeSequence requires array "stack"');
+        }
+        const stack = stackParam.map((sv) => deserializeValue(sv));
+        const resultStack = await this._executeSequenceWithStack(wordNames, stack);
+        return { result_stack: resultStack.map((v) => serializeValue(v)) };
+    }
+    async listModules(_params) {
+        const modules = [];
+        for (const [name, mod] of Object.entries(this.runtimeModules)) {
+            modules.push({
+                name,
+                description: `TypeScript-specific ${name} module`,
+                word_count: this._getModuleWordCount(mod),
+                runtime_specific: true,
+            });
+        }
+        return { modules };
+    }
+    async getModuleInfo(params) {
+        const moduleName = params?.module_name;
+        if (typeof moduleName !== 'string') {
+            throw makeInvalidParams('getModuleInfo requires string "module_name"');
+        }
+        if (!(moduleName in this.runtimeModules)) {
+            throw new JsonRpcMethodError(JsonRpcErrorCode.ModuleNotFound, `Module '${moduleName}' not found`);
+        }
+        const mod = this.runtimeModules[moduleName];
+        const words = [];
+        if (typeof mod.getWordDocs === 'function') {
+            for (const doc of mod.getWordDocs()) {
+                words.push({
+                    name: doc.name,
+                    stack_effect: doc.stackEffect,
+                    description: doc.description,
+                });
+            }
+        }
+        else {
+            const exportedWords = mod.exportable || {};
+            for (const [name, _word] of Object.entries(exportedWords)) {
+                words.push({
+                    name,
+                    stack_effect: '( -- )',
+                    description: `${name} word from ${moduleName} module`,
+                });
+            }
+        }
+        return {
+            name: moduleName,
+            description: `TypeScript-specific ${moduleName} module`,
+            words,
+        };
+    }
+    buildRuntimeError(exception, wordName = null, context = {}) {
+        const stackTrace = exception?.stack ? String(exception.stack).split('\n') : [];
+        const errorType = exception?.constructor?.name || 'Error';
+        const errorContext = {};
+        if (wordName)
+            errorContext['word_name'] = wordName;
+        Object.assign(errorContext, context);
+        const errorInfo = {
+            message: exception?.message ?? String(exception),
+            runtime: 'typescript',
+            stack_trace: stackTrace,
+            error_type: errorType,
+            context: errorContext,
+        };
+        if (stackTrace.length > 0) {
+            const m = stackTrace[0].match(/\((.*):(\d+):\d+\)/);
+            if (m)
+                errorInfo.word_location = `${m[1]}:${m[2]}`;
+        }
+        return errorInfo;
+    }
+    getRegisteredModuleNames() {
+        return Object.keys(this.runtimeModules);
+    }
+    async _executeWithStack(wordName, stack) {
+        const interp = new StandardInterpreter();
+        for (const [_n, m] of Object.entries(this.runtimeModules)) {
+            interp.register_module(m);
+        }
+        if (Object.keys(this.runtimeModules).length > 0) {
+            interp.use_modules(Object.keys(this.runtimeModules));
+        }
+        for (const item of stack)
+            interp.stack_push(item);
+        await interp.run(wordName);
+        return interp.get_stack().get_items();
+    }
+    async _executeSequenceWithStack(wordNames, stack) {
+        const interp = new StandardInterpreter();
+        for (const [_n, m] of Object.entries(this.runtimeModules)) {
+            interp.register_module(m);
+        }
+        if (Object.keys(this.runtimeModules).length > 0) {
+            interp.use_modules(Object.keys(this.runtimeModules));
+        }
+        for (const item of stack)
+            interp.stack_push(item);
+        for (const wordName of wordNames) {
+            await interp.run(wordName);
+        }
+        return interp.get_stack().get_items();
+    }
+    _getModuleWordCount(mod) {
+        if (typeof mod.getWordDocs === 'function')
+            return mod.getWordDocs().length;
+        if (mod.exportable)
+            return Object.keys(mod.exportable).length;
+        return 0;
+    }
+}
+class JsonRpcMethodError extends Error {
+    code;
+    data;
+    constructor(code, message, data) {
+        super(message);
+        this.code = code;
+        this.data = data;
+        this.name = 'JsonRpcMethodError';
+    }
+}
+function makeInvalidParams(message) {
+    return new JsonRpcMethodError(JsonRpcErrorCode.InvalidParams, message);
+}
+async function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', (c) => chunks.push(c));
+        req.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+        req.on('error', reject);
+    });
+}
+function writeJsonRpc(res, status, payload) {
+    const body = JSON.stringify(payload);
+    res.writeHead(status, {
+        'Content-Type': 'application/json',
+        'Content-Length': Buffer.byteLength(body),
+    });
+    res.end(body);
+}
+async function dispatch(servicer, request) {
+    const id = request.id ?? null;
+    const method = request.method;
+    const params = request.params ?? {};
+    try {
+        let result;
+        switch (method) {
+            case 'executeWord':
+                try {
+                    result = await servicer.executeWord(params);
+                }
+                catch (err) {
+                    if (err instanceof JsonRpcMethodError)
+                        throw err;
+                    // Treat as Forthic runtime error with rich data
+                    const data = servicer.buildRuntimeError(err, params?.word_name ?? null);
+                    throw new JsonRpcMethodError(JsonRpcErrorCode.RuntimeError, data.message, data);
+                }
+                break;
+            case 'executeSequence':
+                try {
+                    result = await servicer.executeSequence(params);
+                }
+                catch (err) {
+                    if (err instanceof JsonRpcMethodError)
+                        throw err;
+                    const seqContext = Array.isArray(params?.word_names)
+                        ? { word_sequence: params.word_names.join(', ') }
+                        : {};
+                    const data = servicer.buildRuntimeError(err, null, seqContext);
+                    throw new JsonRpcMethodError(JsonRpcErrorCode.RuntimeError, data.message, data);
+                }
+                break;
+            case 'listModules':
+                result = await servicer.listModules(params);
+                break;
+            case 'getModuleInfo':
+                result = await servicer.getModuleInfo(params);
+                break;
+            default:
+                throw new JsonRpcMethodError(JsonRpcErrorCode.MethodNotFound, `Method not found: ${method}`);
+        }
+        return { jsonrpc: '2.0', id, result };
+    }
+    catch (err) {
+        if (err instanceof JsonRpcMethodError) {
+            const error = { code: err.code, message: err.message };
+            if (err.data !== undefined)
+                error.data = err.data;
+            return { jsonrpc: '2.0', id, error };
+        }
+        return {
+            jsonrpc: '2.0',
+            id,
+            error: {
+                code: JsonRpcErrorCode.InternalError,
+                message: err?.message ?? String(err),
+            },
+        };
+    }
+}
+export async function serve(port = 8765) {
+    const servicer = new ForthicJsonRpcServicer();
+    const server = http.createServer(async (req, res) => {
+        if (req.method !== 'POST') {
+            res.writeHead(405, { 'Content-Type': 'text/plain', Allow: 'POST' });
+            res.end('Method Not Allowed');
+            return;
+        }
+        if (req.url !== '/rpc' && req.url !== '/') {
+            res.writeHead(404, { 'Content-Type': 'text/plain' });
+            res.end('Not Found');
+            return;
+        }
+        const ctype = (req.headers['content-type'] || '').toString().toLowerCase();
+        if (!ctype.includes('application/json')) {
+            res.writeHead(415, { 'Content-Type': 'text/plain' });
+            res.end('Unsupported Media Type');
+            return;
+        }
+        let raw;
+        try {
+            raw = await readBody(req);
+        }
+        catch {
+            writeJsonRpc(res, 200, {
+                jsonrpc: '2.0',
+                id: null,
+                error: { code: JsonRpcErrorCode.ParseError, message: 'Failed to read request body' },
+            });
+            return;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (err) {
+            writeJsonRpc(res, 200, {
+                jsonrpc: '2.0',
+                id: null,
+                error: { code: JsonRpcErrorCode.ParseError, message: `Parse error: ${err.message}` },
+            });
+            return;
+        }
+        if (Array.isArray(parsed)) {
+            writeJsonRpc(res, 200, {
+                jsonrpc: '2.0',
+                id: null,
+                error: {
+                    code: JsonRpcErrorCode.InvalidRequest,
+                    message: 'Batch requests are not supported',
+                },
+            });
+            return;
+        }
+        if (!parsed ||
+            parsed.jsonrpc !== '2.0' ||
+            typeof parsed.method !== 'string' ||
+            !('id' in parsed)) {
+            writeJsonRpc(res, 200, {
+                jsonrpc: '2.0',
+                id: parsed?.id ?? null,
+                error: {
+                    code: JsonRpcErrorCode.InvalidRequest,
+                    message: 'Invalid JSON-RPC 2.0 request',
+                },
+            });
+            return;
+        }
+        const response = await dispatch(servicer, parsed);
+        writeJsonRpc(res, 200, response);
+    });
+    return new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(port, '0.0.0.0', () => {
+            const loaded = servicer.getRegisteredModuleNames();
+            if (loaded.length > 0) {
+                console.log(`  - Available runtime modules: ${loaded.join(', ')}`);
+            }
+            else {
+                console.log('  - No runtime-specific modules loaded');
+            }
+            resolve(server);
+        });
+    });
+}
+export async function main() {
+    const args = process.argv.slice(2);
+    let port = 8765;
+    const portIndex = args.indexOf('--port');
+    if (portIndex !== -1 && args[portIndex + 1]) {
+        port = parseInt(args[portIndex + 1], 10);
+    }
+    await serve(port);
+    console.log(`Forthic JSON-RPC server listening on port ${port}`);
+}
+if (require.main === module) {
+    main().catch((error) => {
+        console.error('Fatal error:', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/esm/jsonrpc/server.js.map

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

package/dist/esm/websocket/serializer.d.ts

@@ -12,16 +12,16 @@ export interface StackValue {
  * Serialize a JavaScript value to a JSON StackValue
  * Uses shared type detection and maps to JSON format
  */
-export declare function serializeValue(value: any): StackValue;
+export declare function serializeValue(value: any, path?: string): StackValue;
 /**
  * Deserialize a JSON StackValue to a JavaScript value
  */
-export declare function deserializeValue(stackValue: StackValue): any;
+export declare function deserializeValue(stackValue: StackValue, path?: string): any;
 /**
  * Serialize an array of values (stack)
  */
-export declare function serializeStack(stack: any[]): StackValue[];
+export declare function serializeStack(stack: any[], pathPrefix?: string): StackValue[];
 /**
  * Deserialize an array of StackValues (stack)
  */
-export declare function deserializeStack(stackValues: StackValue[]): any[];
+export declare function deserializeStack(stackValues: StackValue[], pathPrefix?: string): any[];

package/dist/esm/websocket/serializer.js

@@ -4,13 +4,13 @@
  * Handles: int, float, string, bool, null, array, record, temporal types
  * Uses shared type detection from common/type_utils
  */
-import { getForthicType } from "../common/type_utils.js";
+import { getForthicType, pathSegmentForKey } from "../common/type_utils.js";
 /**
  * Serialize a JavaScript value to a JSON StackValue
  * Uses shared type detection and maps to JSON format
  */
-export function serializeValue(value) {
-    const type = getForthicType(value);
+export function serializeValue(value, path = '') {
+    const type = getForthicType(value, path);
     switch (type) {
         case 'null':
             return { type: 'null', value: null };
@@ -25,17 +25,18 @@ export function serializeValue(value) {
         case 'array':
             return {
                 type: 'array',
-                value: value.map((item) => serializeValue(item)),
+                value: value.map((item, i) => serializeValue(item, `${path}[${i}]`)),
             };
-        case 'record':
+        case 'record': {
             const fields = {};
             for (const [key, val] of Object.entries(value)) {
-                fields[key] = serializeValue(val);
+                fields[key] = serializeValue(val, `${path}${pathSegmentForKey(key)}`);
             }
             return {
                 type: 'record',
                 value: fields,
             };
+        }
         case 'instant':
             return {
                 type: 'instant',
@@ -52,13 +53,13 @@ export function serializeValue(value) {
                 value: value.toString(),
             };
         default:
-            throw new Error(`Unsupported Forthic type: ${type}`);
+            throw new Error(`Unsupported Forthic type: ${type}${path ? ` at path: ${path}` : ''}`);
     }
 }
 /**
  * Deserialize a JSON StackValue to a JavaScript value
  */
-export function deserializeValue(stackValue) {
+export function deserializeValue(stackValue, path = '') {
     switch (stackValue.type) {
         case 'int':
         case 'float':
@@ -68,10 +69,10 @@ export function deserializeValue(stackValue) {
         case 'null':
             return null;
         case 'array':
-            return stackValue.value.map((v) => deserializeValue(v));
+            return stackValue.value.map((v, i) => deserializeValue(v, `${path}[${i}]`));
         case 'record':
             return Object.entries(stackValue.value).reduce((acc, [k, v]) => {
-                acc[k] = deserializeValue(v);
+                acc[k] = deserializeValue(v, `${path}${pathSegmentForKey(k)}`);
                 return acc;
             }, {});
         case 'instant':
@@ -81,19 +82,19 @@ export function deserializeValue(stackValue) {
         case 'zoned_datetime':
             return Temporal.ZonedDateTime.from(stackValue.value);
         default:
-            throw new Error(`Unknown stack value type: ${stackValue.type}`);
+            throw new Error(`Unknown stack value type: ${stackValue.type}${path ? ` at path: ${path}` : ''}`);
     }
 }
 /**
  * Serialize an array of values (stack)
  */
-export function serializeStack(stack) {
-    return stack.map((value) => serializeValue(value));
+export function serializeStack(stack, pathPrefix = '') {
+    return stack.map((value, i) => serializeValue(value, `${pathPrefix}[${i}]`));
 }
 /**
  * Deserialize an array of StackValues (stack)
  */
-export function deserializeStack(stackValues) {
-    return stackValues.map((value) => deserializeValue(value));
+export function deserializeStack(stackValues, pathPrefix = '') {
+    return stackValues.map((value, i) => deserializeValue(value, `${pathPrefix}[${i}]`));
 }
 //# sourceMappingURL=serializer.js.map

package/dist/esm/websocket/serializer.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forthix/forthic",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Stack-based, concatenative language for composable transformations - TypeScript/JavaScript runtime",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -32,6 +32,18 @@
         "import": "./dist/esm/grpc/browser-stub.js",
         "require": "./dist/cjs/grpc/browser-stub.js"
       }
+    },
+    "./jsonrpc": {
+      "node": {
+        "import": "./dist/esm/jsonrpc/index.js",
+        "require": "./dist/cjs/jsonrpc/index.js",
+        "types": "./dist/cjs/jsonrpc/index.d.ts"
+      },
+      "default": {
+        "types": "./dist/cjs/jsonrpc/browser-stub.d.ts",
+        "import": "./dist/esm/jsonrpc/browser-stub.js",
+        "require": "./dist/cjs/jsonrpc/browser-stub.js"
+      }
     }
   },
   "files": [
@@ -54,7 +66,8 @@
     "test:integration": "jest --testPathIgnorePatterns=[]",
     "test:watch": "jest --watch",
     "docs:build": "tsx scripts/generate-docs.ts",
-    "grpc:server": "node dist/cjs/grpc/server.js"
+    "grpc:server": "node dist/cjs/grpc/server.js",
+    "jsonrpc:server": "node dist/cjs/jsonrpc/server.js"
   },
   "keywords": [
     "forthic",