@unyt/datex 0.0.11 → 0.0.13

package/esm/network/com-hub.d.ts

@@ -1,43 +1,41 @@
-import type { JSComHub } from "../datex-core/datex_core_js";
-import { ComInterface, type ComInterfaceImpl } from "./com-interface.js";
+import type { ComHubMetadata, ComInterfaceConfiguration, JSComHub, NetworkTraceResult } from "../datex-web/datex_web";
+import type { Runtime } from "../runtime/runtime.js";
+export type ComInterfaceFactory<SetupData = unknown> = {
+    interfaceType: string;
+    factory: ComInterfaceFactoryFn<SetupData>;
+};
+export type ComInterfaceFactoryFn<SetupData = unknown> = (setup_data: SetupData) => ComInterfaceConfiguration | Promise<ComInterfaceConfiguration>;
+export type ComInterfaceUUID = `com_interface::${string}`;
+export type ComInterfaceSocketUUID = `socket::${string}`;
 /**
  * Communication hub for managing communication interfaces.
  */
 export declare class ComHub {
     #private;
-    constructor(jsComHub: JSComHub);
-    /**
-     * Registers a communication interface implementation.
-     * @param interfaceType The type of the interface.
-     * @param impl The implementation class of the interface.
-     */
-    static registerInterfaceImpl<N extends string>(interfaceType: N, impl: typeof ComInterfaceImpl<unknown>): void;
+    constructor(jsComHub: JSComHub, runtime: Runtime);
+    registerInterfaceFactory<SetupData>(factoryDefinition: ComInterfaceFactory<SetupData>): void;
     /**
      * Creates a new communication interface.
-     * @param interfaceType The type of the interface to create.
+     * @param type The type of the interface to create.
      * @param setupData The setup data for the interface.
+     * @param priority The priority of the interface (optional).
+     * @returns A promise that resolves to the UUID of the created interface.
      */
-    createInterface<T extends typeof ComInterfaceImpl<unknown>>(interfaceType: T, setupData: T extends typeof ComInterfaceImpl<infer P> ? P : never): Promise<ComInterface<InstanceType<T>>>;
-    createInterface<T extends ComInterfaceImpl<unknown>>(interfaceType: string, setupData: T extends ComInterfaceImpl<infer P> ? P : never): Promise<ComInterface<T>>;
-    _update(): Promise<void>;
-    _drain_incoming_blocks(): Uint8Array<ArrayBufferLike>[];
+    createInterface<SetupData>(type: string, setupData: SetupData, priority?: number): Promise<ComInterfaceUUID>;
+    removeInterface(interface_uuid: ComInterfaceUUID): Promise<void>;
+    removeSocket(socket_uuid: ComInterfaceSocketUUID): Promise<void>;
     /**
      * Prints the metadata of the ComHub. Only available in debug builds.
+     * Only exists in debug builds
      */
     printMetadata(): void;
+    getMetadata(): ComHubMetadata;
     /**
      * Prints the trace for a specific endpoint. Only available in debug builds.
      * @param endpoint The endpoint for which to print the trace.
      */
     printTrace(endpoint: string): Promise<void>;
-    /**
-     * Sends a block of data to a specific interface and socket.
-     * @param block The data block to send.
-     * @param interface_uuid The UUID of the interface to send the block to.
-     * @param socket_uuid The UUID of the socket to send the block to.
-     * @returns A promise that resolves to true if the block was sent successfully, false otherwise.
-     */
-    sendBlock(block: Uint8Array, interface_uuid: string, socket_uuid: string): Promise<boolean>;
+    getTrace(endpoint: string): Promise<NetworkTraceResult | undefined>;
     /**
      * Registers a callback to intercept incoming blocks.
      * @param callback The callback to be invoked for each incoming block.

package/esm/network/com-hub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"com-hub.d.ts","sourceRoot":"","sources":["../../src/network/com-hub.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEzE;;GAEG;AACH,qBAAa,MAAM;;gBAgBH,QAAQ,EAAE,QAAQ;IAI9B;;;;OAIG;IACH,MAAM,CAAC,qBAAqB,CAAC,CAAC,SAAS,MAAM,EACzC,aAAa,EAAE,CAAC,EAChB,IAAI,EAAE,OAAO,gBAAgB,CAAC,OAAO,CAAC;IAW1C;;;;OAIG;IACG,eAAe,CAAC,CAAC,SAAS,OAAO,gBAAgB,CAAC,OAAO,CAAC,EAC5D,aAAa,EAAE,CAAC,EAChB,SAAS,EAAE,CAAC,SAAS,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,GAClE,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,eAAe,CACjB,CAAC,SAAS,gBAAgB,CAAC,OAAO,CAAC,EAEnC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,CAAC,SAAS,gBAAgB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,GAC3D,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAkCpB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,sBAAsB,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE;IAI9D;;OAEG;IACI,aAAa,IAAI,IAAI;IAO5B;;;OAGG;IACU,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxD;;;;;;OAMG;IACI,SAAS,CACZ,KAAK,EAAE,UAAU,EACjB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC;IAInB;;;OAGG;IACI,gCAAgC,CACnC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,GAC3D,IAAI;IAIP;;;OAGG;IACI,gCAAgC,CACnC,QAAQ,EAAE,CACN,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EAAE,KAClB,IAAI,GACV,IAAI;CAGV"}
+{"version":3,"file":"com-hub.d.ts","sourceRoot":"","sources":["../../src/network/com-hub.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,cAAc,EACd,yBAAyB,EACzB,QAAQ,EACR,kBAAkB,EACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,MAAM,mBAAmB,CAAC,SAAS,GAAG,OAAO,IAAI;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAAC,SAAS,GAAG,OAAO,IAAI,CACrD,UAAU,EAAE,SAAS,KACpB,yBAAyB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;AAEpE,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,MAAM,EAAE,CAAC;AAC1D,MAAM,MAAM,sBAAsB,GAAG,WAAW,MAAM,EAAE,CAAC;AAEzD;;GAEG;AACH,qBAAa,MAAM;;gBAKH,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO;IAKzC,wBAAwB,CAAC,SAAS,EACrC,iBAAiB,EAAE,mBAAmB,CAAC,SAAS,CAAC;IAWrD;;;;;;OAMG;IACU,eAAe,CAAC,SAAS,EAClC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,SAAS,EACpB,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC;IAQrB,eAAe,CAClB,cAAc,EAAE,gBAAgB,GACjC,OAAO,CAAC,IAAI,CAAC;IAIT,YAAY,CACf,WAAW,EAAE,sBAAsB,GACpC,OAAO,CAAC,IAAI,CAAC;IAIhB;;;OAGG;IACI,aAAa,IAAI,IAAI;IAKrB,WAAW,IAAI,cAAc;IAKpC;;;OAGG;IACU,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAK1E;;;OAGG;IACI,gCAAgC,CACnC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,GAC3D,IAAI;IAIP;;;OAGG;IACI,gCAAgC,CACnC,QAAQ,EAAE,CACN,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EAAE,KAClB,IAAI,GACV,IAAI;CAGV"}

package/esm/network/com-hub.js

@@ -9,67 +9,58 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _a, _ComHub_interfaceImpls, _ComHub_interfaceImplsByClass, _ComHub_jsComHub;
-import { ComInterface } from "./com-interface.js";
+var _ComHub_jsComHub, _ComHub_runtime;
 /**
  * Communication hub for managing communication interfaces.
  */
 export class ComHub {
-    constructor(jsComHub) {
+    constructor(jsComHub, runtime) {
         /** The JS communication hub. */
         _ComHub_jsComHub.set(this, void 0);
+        _ComHub_runtime.set(this, void 0);
         __classPrivateFieldSet(this, _ComHub_jsComHub, jsComHub, "f");
+        __classPrivateFieldSet(this, _ComHub_runtime, runtime, "f");
+    }
+    registerInterfaceFactory(factoryDefinition) {
+        __classPrivateFieldGet(this, _ComHub_jsComHub, "f").register_interface_factory(factoryDefinition.interfaceType, async (setupData) => {
+            const setupDataJS = await __classPrivateFieldGet(this, _ComHub_runtime, "f").dif.resolveDIFValueContainer(setupData);
+            return factoryDefinition.factory(setupDataJS);
+        });
     }
     /**
-     * Registers a communication interface implementation.
-     * @param interfaceType The type of the interface.
-     * @param impl The implementation class of the interface.
+     * Creates a new communication interface.
+     * @param type The type of the interface to create.
+     * @param setupData The setup data for the interface.
+     * @param priority The priority of the interface (optional).
+     * @returns A promise that resolves to the UUID of the created interface.
      */
-    static registerInterfaceImpl(interfaceType, impl) {
-        if (__classPrivateFieldGet(this, _a, "f", _ComHub_interfaceImpls).has(interfaceType)) {
-            throw new Error(`Interface implementation for ${interfaceType} already registered.`);
-        }
-        __classPrivateFieldGet(this, _a, "f", _ComHub_interfaceImpls).set(interfaceType, impl);
-        __classPrivateFieldGet(this, _a, "f", _ComHub_interfaceImplsByClass).set(impl, interfaceType);
-    }
-    async createInterface(interfaceType, setupData) {
-        const type = typeof interfaceType === "string"
-            ? interfaceType
-            : __classPrivateFieldGet(_a, _a, "f", _ComHub_interfaceImplsByClass).get(interfaceType);
-        if (type === undefined) {
-            throw new Error(`Interface implementation for ${interfaceType.name} not registered.`);
-        }
-        const implClass = __classPrivateFieldGet(_a, _a, "f", _ComHub_interfaceImpls).get(type);
-        if (implClass === undefined) {
-            throw new Error(`Interface implementation for ${type} not registered.`);
-        }
-        const uuid = await __classPrivateFieldGet(this, _ComHub_jsComHub, "f").create_interface(type, JSON.stringify(setupData));
-        const impl = new implClass(uuid, setupData, __classPrivateFieldGet(this, _ComHub_jsComHub, "f"));
-        await impl.init?.();
-        return new ComInterface(uuid, impl, __classPrivateFieldGet(this, _ComHub_jsComHub, "f"));
+    async createInterface(type, setupData, priority) {
+        return await __classPrivateFieldGet(this, _ComHub_jsComHub, "f").create_interface(type, __classPrivateFieldGet(this, _ComHub_runtime, "f").dif.convertJSValueToDIFValueContainer(setupData), priority);
     }
-    _update() {
-        return __classPrivateFieldGet(this, _ComHub_jsComHub, "f").update();
+    removeInterface(interface_uuid) {
+        return __classPrivateFieldGet(this, _ComHub_jsComHub, "f").remove_interface(interface_uuid);
     }
-    _drain_incoming_blocks() {
-        return __classPrivateFieldGet(this, _ComHub_jsComHub, "f")._drain_incoming_blocks();
+    removeSocket(socket_uuid) {
+        return __classPrivateFieldGet(this, _ComHub_jsComHub, "f").remove_socket(socket_uuid);
     }
     /**
      * Prints the metadata of the ComHub. Only available in debug builds.
+     * Only exists in debug builds
      */
     printMetadata() {
-        // as any required because get_metadata_string only exists in debug builds
-        // deno-lint-ignore no-explicit-any
         const metadata = __classPrivateFieldGet(this, _ComHub_jsComHub, "f").get_metadata_string();
         console.log(metadata);
     }
+    getMetadata() {
+        // as any required because get_metadata only exists in debug builds
+        return __classPrivateFieldGet(this, _ComHub_jsComHub, "f").get_metadata();
+    }
     /**
      * Prints the trace for a specific endpoint. Only available in debug builds.
      * @param endpoint The endpoint for which to print the trace.
      */
     async printTrace(endpoint) {
         // as any required because get_trace_string only exists in debug builds
-        // deno-lint-ignore no-explicit-any
         const trace = await __classPrivateFieldGet(this, _ComHub_jsComHub, "f").get_trace_string(endpoint);
         if (trace === undefined) {
             console.warn(`No trace available for endpoint: ${endpoint}`);
@@ -77,15 +68,9 @@ export class ComHub {
         }
         console.log(trace);
     }
-    /**
-     * Sends a block of data to a specific interface and socket.
-     * @param block The data block to send.
-     * @param interface_uuid The UUID of the interface to send the block to.
-     * @param socket_uuid The UUID of the socket to send the block to.
-     * @returns A promise that resolves to true if the block was sent successfully, false otherwise.
-     */
-    sendBlock(block, interface_uuid, socket_uuid) {
-        return __classPrivateFieldGet(this, _ComHub_jsComHub, "f").send_block(block, interface_uuid, socket_uuid);
+    getTrace(endpoint) {
+        // as any required because get_trace_string only exists in debug builds
+        return __classPrivateFieldGet(this, _ComHub_jsComHub, "f").get_trace(endpoint);
     }
     /**
      * Registers a callback to intercept incoming blocks.
@@ -102,8 +87,4 @@ export class ComHub {
         __classPrivateFieldGet(this, _ComHub_jsComHub, "f").register_outgoing_block_interceptor(callback);
     }
 }
-_a = ComHub, _ComHub_jsComHub = new WeakMap();
-/** Static map of registered interface implementations. */
-_ComHub_interfaceImpls = { value: new Map() };
-/** Static map of interface implementations by class. */
-_ComHub_interfaceImplsByClass = { value: new Map() };
+_ComHub_jsComHub = new WeakMap(), _ComHub_runtime = new WeakMap();

package/esm/network/interfaces/websocket-server-base.d.ts

@@ -0,0 +1,8 @@
+import type { ComInterfaceFactory } from "../com-hub.js";
+import type { WebSocketServerInterfaceSetupData } from "../../datex.js";
+/**
+ * Utility function to create a WebSocket server communication interface factory from a given server factory function.
+ * @param serverFactory
+ */
+export declare function createWebsocketServerComInterfaceFactory(serverFactory: (setupData: WebSocketServerInterfaceSetupData) => ReadableStream<WebSocket>): ComInterfaceFactory<WebSocketServerInterfaceSetupData>;
+//# sourceMappingURL=websocket-server-base.d.ts.map

package/esm/network/interfaces/websocket-server-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-server-base.d.ts","sourceRoot":"","sources":["../../../src/network/interfaces/websocket-server-base.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAuB,iCAAiC,EAAE,MAAM,gBAAgB,CAAC;AAE7F;;;GAGG;AACH,wBAAgB,wCAAwC,CACpD,aAAa,EAAE,CAAC,SAAS,EAAE,iCAAiC,KAAK,cAAc,CAAC,SAAS,CAAC,GAC3F,mBAAmB,CAAC,iCAAiC,CAAC,CAiDxD"}

package/esm/network/interfaces/websocket-server-base.js

@@ -0,0 +1,93 @@
+/**
+ * Utility function to create a WebSocket server communication interface factory from a given server factory function.
+ * @param serverFactory
+ */
+export function createWebsocketServerComInterfaceFactory(serverFactory) {
+    return {
+        interfaceType: "websocket-server",
+        factory: (setupData) => {
+            // FIXME: workaround, convert map to object if map provided as setupData
+            if (setupData instanceof Map) {
+                setupData = Object.fromEntries(Array.from(setupData.entries()));
+            }
+            return {
+                properties: {
+                    interface_type: "websocket-server",
+                    channel: "websocket",
+                    name: setupData.bind_address,
+                    direction: "InOut",
+                    round_trip_time: 0,
+                    max_bandwidth: 0,
+                    continuous_connection: false,
+                    allow_redirects: false,
+                    is_secure_channel: false,
+                    reconnection_config: "NoReconnect",
+                    auto_identify: true,
+                    connectable_interfaces: [], // TODO add websocket client connections
+                },
+                has_single_socket: false,
+                new_sockets_iterator: serverFactory(setupData).pipeThrough(new TransformStream({
+                    async transform(socket, controller) {
+                        const incoming_data_stream = await createSocketDataIterator(socket);
+                        controller.enqueue({
+                            properties: {
+                                direction: "InOut",
+                                channel_factor: 1,
+                                connection_timestamp: Date.now(),
+                                direct_endpoint: undefined,
+                            },
+                            iterator: incoming_data_stream,
+                            send_callback: (data) => {
+                                socket.send(data);
+                            },
+                        });
+                    },
+                })),
+            };
+        },
+    };
+}
+/**
+ * Utility function that returns an async generator yielding ArrayBuffers from a WebSocket
+ */
+async function createSocketDataIterator(webSocket) {
+    const { promise, resolve, reject } = Promise.withResolvers();
+    webSocket.addEventListener("open", () => resolve(), { once: true });
+    webSocket.addEventListener("error", (event) => reject(new Error(`WebSocket error: ${event}`)), { once: true });
+    // wait until the socket is open before starting to yield messages
+    if (webSocket.readyState === WebSocket.OPEN) {
+        resolve();
+    }
+    else if (webSocket.readyState === WebSocket.CLOSED || webSocket.readyState === WebSocket.CLOSING) {
+        reject(new Error("WebSocket is already closed"));
+    }
+    else {
+        // otherwise, wait for the open event
+        console.log("Waiting for WebSocket to open...");
+    }
+    await promise;
+    let closed = false;
+    return new ReadableStream({
+        start(controller) {
+            webSocket.onmessage = (event) => {
+                // ignore if not ArrayBuffer
+                if (!(event.data instanceof ArrayBuffer)) {
+                    console.warn("Received non-ArrayBuffer message, ignoring");
+                    return;
+                }
+                controller.enqueue(event.data);
+            };
+            webSocket.onerror = () => {
+                controller.error(new Error("WebSocket error"));
+            };
+            webSocket.onclose = () => {
+                if (!closed)
+                    controller.close();
+            };
+        },
+        cancel() {
+            webSocket.close();
+            closed = true;
+        },
+    });
+}

package/esm/network/interfaces/websocket-server-deno.d.ts

@@ -0,0 +1,4 @@
+import type { WebSocketServerInterfaceSetupData } from "../../datex.js";
+import type { ComInterfaceFactory } from "../com-hub.js";
+export declare const websocketServerDenoComInterfaceFactory: ComInterfaceFactory<WebSocketServerInterfaceSetupData>;
+//# sourceMappingURL=websocket-server-deno.d.ts.map

package/esm/network/interfaces/websocket-server-deno.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-server-deno.d.ts","sourceRoot":"","sources":["../../../src/network/interfaces/websocket-server-deno.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,gBAAgB,CAAC;AAExE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AA4BzD,eAAO,MAAM,sCAAsC,EAAE,mBAAmB,CAAC,iCAAiC,CAC3C,CAAC"}

package/esm/network/interfaces/websocket-server-deno.js

@@ -0,0 +1,22 @@
+import { createWebsocketServerComInterfaceFactory } from "./websocket-server-base.js";
+function denoServerFactory(setupData) {
+    const [hostname, maybe_port] = setupData.bind_address.split(":");
+    const port = maybe_port ? parseInt(maybe_port) : undefined;
+    let server;
+    return new ReadableStream({
+        start(controller) {
+            server = Deno.serve({ port, hostname }, (req) => {
+                if (req.headers.get("upgrade") != "websocket") {
+                    return new Response(null, { status: 501 });
+                }
+                const { socket, response } = Deno.upgradeWebSocket(req);
+                controller.enqueue(socket);
+                return response;
+            });
+        },
+        async cancel() {
+            await server.shutdown();
+        },
+    });
+}
+export const websocketServerDenoComInterfaceFactory = createWebsocketServerComInterfaceFactory(denoServerFactory);

package/esm/network/mod.d.ts

@@ -5,5 +5,4 @@
  * communication hubs and interfaces.
  */
 export * from "./com-hub.js";
-export * from "./com-interface.js";
 //# sourceMappingURL=mod.d.ts.map

package/esm/network/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/network/mod.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/network/mod.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,cAAc,CAAC"}

package/esm/network/mod.js

@@ -5,4 +5,3 @@
  * communication hubs and interfaces.
  */
 export * from "./com-hub.js";
-export * from "./com-interface.js";

package/esm/runtime/runtime.d.ts

@@ -1,12 +1,11 @@
-import { type DecompileOptions, type JSRuntime } from "../datex-core.js";
+import { type DecompileOptions, type JSRuntime } from "../datex.js";
 import { ComHub } from "../network/com-hub.js";
 import { DIFHandler, type PointerOut } from "../dif/dif-handler.js";
-import type { DIFReferenceMutability, DIFTypeDefinition } from "../dif/definitions.js";
+import type { DIFSharedValueMutability, DIFTypeDefinition } from "../dif/definitions.js";
 import type { Ref } from "../refs/ref.js";
 /** debug flags for the runtime */
-interface DebugFlags {
-    allow_unsigned_blocks?: boolean;
-    enable_deterministic_behavior?: boolean;
+interface DebugConfig {
+    log_level?: "error" | "warn" | "info" | "debug" | "trace" | null;
 }
 /** configuration for the runtime  */
 export type RuntimeConfig = {
@@ -15,7 +14,7 @@ export type RuntimeConfig = {
         type: string;
         config: unknown;
     }[];
-    debug?: boolean;
+    env?: Record<string, string>;
 };
 /**
  * The main Runtime class for executing Datex scripts and managing communication interfaces.
@@ -23,20 +22,14 @@ export type RuntimeConfig = {
 export declare class Runtime {
     #private;
     readonly js_version: string;
-    constructor(config: RuntimeConfig, debug_flags?: DebugFlags);
+    private constructor();
     /**
      * Creates a new Runtime instance.
      * @param config Runtime configuration
-     * @param debug_flags Debug flags for the runtime
+     * @param debugConfig Debug flags for the runtime
      * @returns A promise that resolves to the created Runtime instance
      */
-    static create(config: RuntimeConfig, debug_flags?: DebugFlags): Promise<Runtime>;
-    /**
-     * Starts the runtime.
-     * @returns A promise that resolves when the runtime has started.
-     */
-    start(): Promise<void>;
-    _stop(): Promise<void>;
+    static create(config: RuntimeConfig, debugConfig?: DebugConfig): Promise<Runtime>;
     /**
      * Gets the endpoint of the runtime.
      */
@@ -122,7 +115,6 @@ export declare class Runtime {
      * @returns The string representation of the value.
      */
     valueToString(value: unknown, decompileOptions?: DecompileOptions | null): string;
-    _execute_internal(datexScript: string): boolean;
     /**
      * Creates a new reference containg the given JS value.
      * For primitive values, a Ref wrapper is returned.
@@ -133,7 +125,7 @@ export declare class Runtime {
      * @param mutability Optional mutability of the reference (default is Mutable).
      * @returns A proxy object representing the pointer in JS.
      */
-    createTransparentReference<V, M extends DIFReferenceMutability = typeof DIFReferenceMutability.Mutable>(value: V & {}, allowedType?: DIFTypeDefinition | null, mutability?: M): PointerOut<V, M>;
+    createTransparentReference<V, M extends DIFSharedValueMutability = typeof DIFSharedValueMutability.Mutable>(value: V & {}, allowedType?: DIFTypeDefinition | null, mutability?: M): PointerOut<V, M>;
     /**
      * Creates or retrieves a wrapped reference for the given value.
      * If the value is already a reference, it returns the existing reference.
@@ -143,7 +135,7 @@ export declare class Runtime {
      * @param mutability
      * @returns
      */
-    createOrGetWrappedReference<V, M extends DIFReferenceMutability = typeof DIFReferenceMutability.Mutable>(_value: V, _allowedType?: DIFTypeDefinition | null, _mutability?: M): Ref<V>;
+    createOrGetWrappedReference<V, M extends DIFSharedValueMutability = typeof DIFSharedValueMutability.Mutable>(_value: V, _allowedType?: DIFTypeDefinition | null, _mutability?: M): Ref<V>;
     startLSP(callback: (data: string) => void): (data: string) => void;
 }
 export {};

package/esm/runtime/runtime.d.ts.map

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

package/esm/runtime/runtime.js

@@ -10,18 +10,18 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _Runtime_instances, _Runtime_runtime, _Runtime_comHub, _Runtime_difHandler, _Runtime_executeInternal, _Runtime_executeSyncInternal, _Runtime_getScriptAndValues;
-import { create_runtime, execute_internal, } from "../datex-core.js";
+import { create_runtime } from "../datex.js";
 import { ComHub } from "../network/com-hub.js";
 import { DIFHandler } from "../dif/dif-handler.js";
 import { unimplemented } from "../utils/exceptions.js";
 // TODO: move to global.ts
 /** auto-generated version - do not edit: */
-const VERSION = "0.0.11";
+const VERSION = "0.0.13";
 /**
  * The main Runtime class for executing Datex scripts and managing communication interfaces.
  */
 export class Runtime {
-    constructor(config, debug_flags) {
+    constructor(jsRuntime) {
         _Runtime_instances.add(this);
         Object.defineProperty(this, "js_version", {
             enumerable: true,
@@ -32,30 +32,21 @@ export class Runtime {
         _Runtime_runtime.set(this, void 0);
         _Runtime_comHub.set(this, void 0);
         _Runtime_difHandler.set(this, void 0);
-        __classPrivateFieldSet(this, _Runtime_runtime, create_runtime(JSON.stringify(config), debug_flags), "f");
-        __classPrivateFieldSet(this, _Runtime_comHub, new ComHub(__classPrivateFieldGet(this, _Runtime_runtime, "f").com_hub), "f");
+        __classPrivateFieldSet(this, _Runtime_runtime, jsRuntime, "f");
+        __classPrivateFieldSet(this, _Runtime_comHub, new ComHub(__classPrivateFieldGet(this, _Runtime_runtime, "f").com_hub, this), "f");
         __classPrivateFieldSet(this, _Runtime_difHandler, new DIFHandler(__classPrivateFieldGet(this, _Runtime_runtime, "f")), "f");
     }
     /**
      * Creates a new Runtime instance.
      * @param config Runtime configuration
-     * @param debug_flags Debug flags for the runtime
+     * @param debugConfig Debug flags for the runtime
      * @returns A promise that resolves to the created Runtime instance
      */
-    static async create(config, debug_flags) {
-        const runtime = new Runtime(config, debug_flags);
-        await runtime.start();
-        return runtime;
-    }
-    /**
-     * Starts the runtime.
-     * @returns A promise that resolves when the runtime has started.
-     */
-    start() {
-        return __classPrivateFieldGet(this, _Runtime_runtime, "f").start();
-    }
-    _stop() {
-        return __classPrivateFieldGet(this, _Runtime_runtime, "f")._stop();
+    static async create(config, debugConfig) {
+        // workaround: temp dif handler without runtime to convert config to DIF
+        const configDIF = DIFHandler.convertJSValueToDIFValueContainer(config);
+        const jsRuntime = await create_runtime(configDIF, debugConfig);
+        return new Runtime(jsRuntime);
     }
     /**
      * Gets the endpoint of the runtime.
@@ -125,9 +116,6 @@ export class Runtime {
     valueToString(value, decompileOptions = null) {
         return __classPrivateFieldGet(this, _Runtime_runtime, "f").value_to_string(__classPrivateFieldGet(this, _Runtime_difHandler, "f").convertJSValueToDIFValueContainer(value), decompileOptions);
     }
-    _execute_internal(datexScript) {
-        return execute_internal(datexScript);
-    }
     /**
      * Creates a new reference containg the given JS value.
      * For primitive values, a Ref wrapper is returned.

package/esm/utils/devtools-formatter.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=devtools-formatter.d.ts.map

package/esm/utils/devtools-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-formatter.d.ts","sourceRoot":"","sources":["../../src/utils/devtools-formatter.ts"],"names":[],"mappings":""}

package/esm/utils/devtools-formatter.js

@@ -0,0 +1,40 @@
+import { Endpoint } from "../lib/special-core-types/endpoint.js";
+import { Ref } from "../refs/ref.js";
+// @ts-ignore devtoolsFormatters
+globalThis.devtoolsFormatters = [
+    {
+        header(obj) {
+            if (obj instanceof Endpoint) {
+                return ["span", { style: "color: #58d452" }, obj.toString()];
+            }
+            else if (obj instanceof Ref) {
+                return [
+                    "span",
+                    {},
+                    [
+                        "span",
+                        {},
+                        [
+                            "span",
+                            { style: "color: #1279d5" },
+                            "&mut ",
+                        ],
+                        [
+                            "span",
+                            {},
+                            // TODO: only proof of concept, syntax highlighting does not match JS
+                            obj.value,
+                        ],
+                    ],
+                ];
+            }
+            return null; // fall back to default
+        },
+        hasBody(_) {
+            return false;
+        },
+        body(_) {
+            return null;
+        },
+    },
+];

package/esm/utils/js-runtime-compat/js-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"js-runtime.d.ts","sourceRoot":"","sources":["../../../src/utils/js-runtime-compat/js-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACR,kBAAkB,EAClB,aAAa,EAChB,MAAM,2BAA2B,CAAC;AAInC,wBAAgB,aAAa,IAAI,aAAa,CAU7C;AAkBD,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,EAAE,kBAE9B,CAAC"}
+{"version":3,"file":"js-runtime.d.ts","sourceRoot":"","sources":["../../../src/utils/js-runtime-compat/js-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAInF,wBAAgB,aAAa,IAAI,aAAa,CAU7C;AAkBD,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,EAAE,kBAE9B,CAAC"}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@unyt/datex",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/unyt-org/datex-core-js.git"
+    "url": "git+https://github.com/unyt-org/datex-web.git"
   },
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/unyt-org/datex-core-js/issues"
+    "url": "https://github.com/unyt-org/datex-web/issues"
   },
   "module": "./esm/mod.js",
   "exports": {
@@ -17,11 +17,11 @@
     "./default": {
       "import": "./esm/default.js"
     },
-    "./interface-impls/base": {
-      "import": "./esm/network/interface-impls/base.js"
+    "./interfaces/websocket-server-base": {
+      "import": "./esm/network/interfaces/websocket-server-base.js"
     },
-    "./interface-impls/websocket-client": {
-      "import": "./esm/network/interface-impls/websocket-client.js"
+    "./interfaces/websocket-server-deno": {
+      "import": "./esm/network/interfaces/websocket-server-deno.js"
     }
   },
   "scripts": {},

package/esm/datex-core/datex_core_js.d.ts

@@ -1,2 +0,0 @@
-export * from "./datex_core_js.internal.js";
-//# sourceMappingURL=datex_core_js.d.ts.map

package/esm/datex-core/datex_core_js.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"datex_core_js.d.ts","sourceRoot":"","sources":["../../src/datex-core/datex_core_js.js"],"names":[],"mappings":""}