@unyt/datex 0.0.10 → 0.0.12

package/esm/dif/display.d.ts

@@ -3,7 +3,7 @@
  * @description
  * This module contains helper functions to convert DIF structures to display strings.
  */
-import { type DIFReference, DIFReferenceMutability, type DIFRepresentationValue, type DIFTypeContainer, type DIFValueContainer } from "./definitions.js";
+import { type DIFReference, DIFReferenceMutability, type DIFRepresentationValue, type DIFTypeDefinition, type DIFValueContainer } from "./definitions.js";
 /**
  * Converts a DIF reference mutability to a display string.
  */
@@ -21,9 +21,9 @@ export declare function difValueContainerToDisplayString(container: DIFValueCont
  */
 export declare function difRepresentationValueToDisplayString(difRepValue: DIFRepresentationValue): string;
 /**
- * Converts a DIF type container to a display string.
+ * Converts a DIF type definition to a display string.
  */
-export declare function difTypeContainerToDisplayString(difType: DIFTypeContainer): string;
+export declare function difTypeDefinitionToDisplayString(difType: DIFTypeDefinition): string;
 /**
  * Converts a core type address to a display string.
  */

package/esm/dif/display.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../src/dif/display.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACH,KAAK,YAAY,EACjB,sBAAsB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACzB,MAAM,kBAAkB,CAAC;AAG1B;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,sBAAsB,GAAG,MAAM,CAO7E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACvC,SAAS,EAAE,YAAY,GACxB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC5C,SAAS,EAAE,iBAAiB,GAC7B,MAAM,CAgBR;AAED;;GAEG;AACH,wBAAgB,qCAAqC,CACjD,WAAW,EAAE,sBAAsB,GACpC,MAAM,CAyBR;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC3C,OAAO,EAAE,gBAAgB,GAC1B,MAAM,CAQR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAS9D"}
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../src/dif/display.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACH,KAAK,YAAY,EACjB,sBAAsB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACzB,MAAM,kBAAkB,CAAC;AAG1B;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,sBAAsB,GAAG,MAAM,CAO7E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACvC,SAAS,EAAE,YAAY,GACxB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC5C,SAAS,EAAE,iBAAiB,GAC7B,MAAM,CAcR;AAED;;GAEG;AACH,wBAAgB,qCAAqC,CACjD,WAAW,EAAE,sBAAsB,GACpC,MAAM,CAuBR;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC5C,OAAO,EAAE,iBAAiB,GAC3B,MAAM,CAMR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAS9D"}

package/esm/dif/display.js

@@ -21,7 +21,7 @@ export function mutabilityToDisplayString(mut) {
  * Converts a DIF reference to a display string.
  */
 export function difReferenceToDisplayString(reference) {
-    const typeString = difTypeContainerToDisplayString(reference.allowed_type);
+    const typeString = difTypeDefinitionToDisplayString(reference.allowed_type);
     const valueString = difValueContainerToDisplayString(reference.value);
     const mutString = mutabilityToDisplayString(reference.mut);
     return `${mutString}${valueString} (allowed: ${typeString})`;
@@ -34,9 +34,7 @@ export function difValueContainerToDisplayString(container) {
         return addressToDisplayString(container);
     }
     else {
-        const typeString = container.type
-            ? difTypeContainerToDisplayString(container.type)
-            : null;
+        const typeString = container.type ? difTypeDefinitionToDisplayString(container.type) : null;
         const valueString = difRepresentationValueToDisplayString(container.value);
         if (typeString) {
             return `{ type: ${typeString}, value: ${valueString} }`;
@@ -69,14 +67,14 @@ export function difRepresentationValueToDisplayString(difRepValue) {
     }
 }
 /**
- * Converts a DIF type container to a display string.
+ * Converts a DIF type definition to a display string.
  */
-export function difTypeContainerToDisplayString(difType) {
+export function difTypeDefinitionToDisplayString(difType) {
     if (typeof difType === "string") {
         return addressToDisplayString(difType);
     }
     else {
-        return `{ name: ${difType.name}, kind: ${difType.kind}, def: ${JSON.stringify(difType.def)}, mut: ${difType.mut} }`;
+        return `{ kind: ${difType.kind}, def: ${JSON.stringify(difType.def)} }`;
     }
 }
 /**

package/esm/dif/js-lib.d.ts

@@ -0,0 +1,8 @@
+export declare const JsLibTypeAddress: {
+    readonly undefined: "111111";
+};
+/**
+ * Type representing the unique pointer addresses of js lib types.
+ */
+export type JsLibTypeAddress = typeof JsLibTypeAddress[keyof typeof JsLibTypeAddress];
+//# sourceMappingURL=js-lib.d.ts.map

package/esm/dif/js-lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-lib.d.ts","sourceRoot":"","sources":["../../src/dif/js-lib.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB;;CAEnB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC"}

package/esm/dif/js-lib.js

@@ -0,0 +1,3 @@
+export const JsLibTypeAddress = {
+    undefined: "111111",
+};

package/esm/dif/mod.d.ts

@@ -4,7 +4,6 @@
  * This namespace contains all modules related to the DIF (DATEX Interchange Format) interfaces of the DATEX runtime.
  */
 export * as Definitions from "./definitions.js";
-export * as Builders from "./builders.js";
 export * as Display from "./display.js";
 export { CoreTypeAddress } from "./core.js";
 //# sourceMappingURL=mod.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/dif/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/dif/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}

package/esm/dif/mod.js

@@ -4,6 +4,5 @@
  * This namespace contains all modules related to the DIF (DATEX Interchange Format) interfaces of the DATEX runtime.
  */
 export * as Definitions from "./definitions.js";
-export * as Builders from "./builders.js";
 export * as Display from "./display.js";
 export { CoreTypeAddress } from "./core.js";

package/esm/dif/type-registry.d.ts

@@ -0,0 +1,80 @@
+import { type DIFTypeDefinition, type DIFUpdateData, DIFUpdateKind } from "./definitions.js";
+import { type CustomReferenceMetadata, type DIFHandler } from "./dif-handler.js";
+type ImplMethod = {
+    name: string;
+    implementation: (...args: unknown[]) => unknown;
+};
+type OwnImpl = {
+    methods: ImplMethod[];
+};
+type InterfaceImpl = {
+    interfaceName: string;
+    methods: ImplMethod[];
+};
+export type TypeDefinition = {
+    name: string;
+    structuralDefinition: DIFTypeDefinition;
+    ownImpls?: OwnImpl[];
+    interfaceImpls: InterfaceImpl[];
+};
+export type TypeBindingContext<M extends CustomReferenceMetadata> = {
+    readonly difHandler: DIFHandler;
+    getCustomReferenceMetadata(value: WeakKey): M;
+    allowOriginalValueAccess<R>(target: WeakKey, callback: () => R): R;
+};
+export type BindResult<T, M extends CustomReferenceMetadata> = {
+    value: T;
+    metadata: M;
+};
+export type TypeBindingDefinition<T, M extends CustomReferenceMetadata = CustomReferenceMetadata> = {
+    typeAddress: string;
+    bind(this: TypeBindingContext<M>, value: T, pointerAddress: string): BindResult<T, M>;
+    handleSet?(this: TypeBindingContext<M>, target: T, key: unknown, value: unknown): void;
+    handleAppend?(this: TypeBindingContext<M>, target: T, value: unknown): void;
+    handleReplace?(this: TypeBindingContext<M>, parent: T, newValue: unknown): void;
+    handleDelete?(this: TypeBindingContext<M>, target: T, key: unknown): void;
+    handleClear?(this: TypeBindingContext<M>, target: T): void;
+    handleListSplice?(this: TypeBindingContext<M>, target: T, start: number, deleteCount: number, items: unknown[]): void;
+};
+export declare class TypeRegistry {
+    #private;
+    constructor(difHandler: DIFHandler);
+    /**
+     * Defines a completely new nominal type with optional implementations that can be bound to JS native functions.
+     * @param definition
+     */
+    registerTypeDefinition(_definition: TypeDefinition): void;
+    /**
+     * Binds an existing nominal type to a JS mirror implementation.
+     * @param typePointerAddress The address of the type pointer in the Datex runtime.
+     */
+    registerTypeBinding<T>(typeBindingDefinition: TypeBindingDefinition<T>): void;
+    /**
+     * @private
+     * Gets the type binding for a given type pointer address.
+     */
+    _getTypeBinding(typePointerAddress: string): TypeBinding | null;
+    /**
+     * Gets the type binding for a given type pointer address.
+     */
+    getTypeBinding(typePointerAddress: string): TypeBinding | null;
+}
+export declare class TypeBinding<T extends WeakKey = WeakKey, M extends CustomReferenceMetadata = CustomReferenceMetadata> {
+    #private;
+    get difHandler(): DIFHandler;
+    getCustomReferenceMetadata(value: T): M;
+    constructor(definition: TypeBindingDefinition<T, M>, difHandler: DIFHandler);
+    /**
+     * Binds a new JS value to this type binding.
+     * @returns
+     */
+    bindValue(value: T, pointerAddress: string): BindResult<T, M>;
+    /**
+     * Sets up observers for the given value and pointer address if there are update handlers defined for this type binding.
+     */
+    handleDifUpdate(value: T, pointerAddress: string, difUpdateData: DIFUpdateData): void;
+    getUpdateHandlerTypes(): Set<DIFUpdateKind>;
+    allowOriginalValueAccess<R>(target: T, callback: () => R): R;
+}
+export {};
+//# sourceMappingURL=type-registry.d.ts.map

package/esm/dif/type-registry.d.ts.map

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

package/esm/dif/type-registry.js

@@ -0,0 +1,166 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    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 _TypeRegistry_difHandler, _TypeRegistry_typeBindings, _TypeBinding_difHandler, _TypeBinding_definition;
+import { DEBUG_MODE } from "../global.js";
+import { DIFUpdateKind } from "./definitions.js";
+import { IS_PROXY_ACCESS } from "./dif-handler.js";
+// interface GetProperty<K,V> = {
+//     function getProperty<K>(self: Type, key: K) -> X;
+// }
+// type = {x: fn()->y),}
+// impl Type {
+//     fn autoSelectFamily() -> Family {
+// }
+// impl Type {
+//     fn autoSelectFamily(self) -> Family {
+//     }
+// }
+// Type.self(x);
+// x->autoSelectFamily();
+// MyTrait.autoSelectFamily(x);
+// Type.autoSelectFamily(x);
+// object->contains()
+// obj.hasOwnPropety()
+export class TypeRegistry {
+    constructor(difHandler) {
+        _TypeRegistry_difHandler.set(this, void 0);
+        _TypeRegistry_typeBindings.set(this, new Map());
+        __classPrivateFieldSet(this, _TypeRegistry_difHandler, difHandler, "f");
+    }
+    /**
+     * Defines a completely new nominal type with optional implementations that can be bound to JS native functions.
+     * @param definition
+     */
+    registerTypeDefinition(_definition) {
+        // TODO
+    }
+    /**
+     * Binds an existing nominal type to a JS mirror implementation.
+     * @param typePointerAddress The address of the type pointer in the Datex runtime.
+     */
+    registerTypeBinding(typeBindingDefinition) {
+        __classPrivateFieldGet(this, _TypeRegistry_typeBindings, "f").set(typeBindingDefinition.typeAddress, new TypeBinding(typeBindingDefinition, __classPrivateFieldGet(this, _TypeRegistry_difHandler, "f")));
+    }
+    /**
+     * @private
+     * Gets the type binding for a given type pointer address.
+     */
+    _getTypeBinding(typePointerAddress) {
+        return __classPrivateFieldGet(this, _TypeRegistry_typeBindings, "f").get(typePointerAddress) || null;
+    }
+    /**
+     * Gets the type binding for a given type pointer address.
+     */
+    getTypeBinding(typePointerAddress) {
+        const typeBinding = __classPrivateFieldGet(this, _TypeRegistry_typeBindings, "f").get(typePointerAddress);
+        if (typeBinding) {
+            return typeBinding;
+        }
+        else {
+            return null;
+        }
+    }
+}
+_TypeRegistry_difHandler = new WeakMap(), _TypeRegistry_typeBindings = new WeakMap();
+export class TypeBinding {
+    get difHandler() {
+        return __classPrivateFieldGet(this, _TypeBinding_difHandler, "f");
+    }
+    getCustomReferenceMetadata(value) {
+        return __classPrivateFieldGet(this, _TypeBinding_difHandler, "f").getReferenceMetadataUnsafe(value)
+            .customMetadata;
+    }
+    constructor(definition, difHandler) {
+        _TypeBinding_difHandler.set(this, void 0);
+        _TypeBinding_definition.set(this, void 0);
+        __classPrivateFieldSet(this, _TypeBinding_definition, definition, "f");
+        __classPrivateFieldSet(this, _TypeBinding_difHandler, difHandler, "f");
+    }
+    /**
+     * Binds a new JS value to this type binding.
+     * @returns
+     */
+    bindValue(value, pointerAddress) {
+        const newValue = __classPrivateFieldGet(this, _TypeBinding_definition, "f").bind.call(this, value, pointerAddress);
+        return newValue;
+    }
+    /**
+     * Sets up observers for the given value and pointer address if there are update handlers defined for this type binding.
+     */
+    handleDifUpdate(value, pointerAddress, difUpdateData) {
+        const updateHandlerTypes = this.getUpdateHandlerTypes();
+        // add observer if there are update handlers
+        if (updateHandlerTypes.size > 0) {
+            console.log("got update for pointer:", pointerAddress, difUpdateData);
+            this.allowOriginalValueAccess(value, () => {
+                // call appropriate handler based on update kind
+                if (difUpdateData.kind === DIFUpdateKind.Set &&
+                    __classPrivateFieldGet(this, _TypeBinding_definition, "f").handleSet) {
+                    __classPrivateFieldGet(this, _TypeBinding_definition, "f").handleSet.call(this, value, __classPrivateFieldGet(this, _TypeBinding_difHandler, "f").resolveDIFPropertySync(difUpdateData.key), __classPrivateFieldGet(this, _TypeBinding_difHandler, "f").resolveDIFValueContainerSync(difUpdateData.value));
+                }
+                else if (difUpdateData.kind === DIFUpdateKind.Append &&
+                    __classPrivateFieldGet(this, _TypeBinding_definition, "f").handleAppend) {
+                    __classPrivateFieldGet(this, _TypeBinding_definition, "f").handleAppend.call(this, value, __classPrivateFieldGet(this, _TypeBinding_difHandler, "f").resolveDIFValueContainerSync(difUpdateData.value));
+                }
+                else if (difUpdateData.kind === DIFUpdateKind.Replace &&
+                    __classPrivateFieldGet(this, _TypeBinding_definition, "f").handleReplace) {
+                    __classPrivateFieldGet(this, _TypeBinding_definition, "f").handleReplace.call(this, value, __classPrivateFieldGet(this, _TypeBinding_difHandler, "f").resolveDIFValueContainerSync(difUpdateData.value));
+                }
+                else if (difUpdateData.kind === DIFUpdateKind.Delete &&
+                    __classPrivateFieldGet(this, _TypeBinding_definition, "f").handleDelete) {
+                    __classPrivateFieldGet(this, _TypeBinding_definition, "f").handleDelete.call(this, value, __classPrivateFieldGet(this, _TypeBinding_difHandler, "f").resolveDIFPropertySync(difUpdateData.key));
+                }
+                else if (difUpdateData.kind === DIFUpdateKind.Clear &&
+                    __classPrivateFieldGet(this, _TypeBinding_definition, "f").handleClear) {
+                    __classPrivateFieldGet(this, _TypeBinding_definition, "f").handleClear.call(this, value);
+                }
+                else if (difUpdateData.kind === DIFUpdateKind.ListSplice &&
+                    __classPrivateFieldGet(this, _TypeBinding_definition, "f").handleListSplice) {
+                    __classPrivateFieldGet(this, _TypeBinding_definition, "f").handleListSplice.call(this, value, difUpdateData.start, difUpdateData.delete_count, difUpdateData.items.map((item) => __classPrivateFieldGet(this, _TypeBinding_difHandler, "f").resolveDIFValueContainerSync(item)));
+                }
+            });
+        }
+    }
+    getUpdateHandlerTypes() {
+        const updateHandlerTypes = new Set();
+        if (__classPrivateFieldGet(this, _TypeBinding_definition, "f").handleSet) {
+            updateHandlerTypes.add(DIFUpdateKind.Set);
+        }
+        if (__classPrivateFieldGet(this, _TypeBinding_definition, "f").handleAppend) {
+            updateHandlerTypes.add(DIFUpdateKind.Append);
+        }
+        if (__classPrivateFieldGet(this, _TypeBinding_definition, "f").handleReplace) {
+            updateHandlerTypes.add(DIFUpdateKind.Replace);
+        }
+        if (__classPrivateFieldGet(this, _TypeBinding_definition, "f").handleDelete) {
+            updateHandlerTypes.add(DIFUpdateKind.Delete);
+        }
+        if (__classPrivateFieldGet(this, _TypeBinding_definition, "f").handleClear) {
+            updateHandlerTypes.add(DIFUpdateKind.Clear);
+        }
+        return updateHandlerTypes;
+    }
+    allowOriginalValueAccess(target, callback) {
+        if (!DEBUG_MODE) {
+            return callback();
+        }
+        const metadata = this.getCustomReferenceMetadata(target);
+        metadata[IS_PROXY_ACCESS] = true;
+        try {
+            return callback();
+        }
+        finally {
+            metadata[IS_PROXY_ACCESS] = false;
+        }
+    }
+}
+_TypeBinding_difHandler = new WeakMap(), _TypeBinding_definition = new WeakMap();

package/esm/global.d.ts

@@ -0,0 +1,2 @@
+export declare const DEBUG_MODE = true;
+//# sourceMappingURL=global.d.ts.map

package/esm/global.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.d.ts","sourceRoot":"","sources":["../src/global.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,OAAO,CAAC"}

package/esm/global.js

@@ -0,0 +1 @@
+export const DEBUG_MODE = true;

package/esm/{runtime/special-core-types.d.ts → lib/special-core-types/endpoint.d.ts}

@@ -22,5 +22,7 @@ export declare class Endpoint {
      * @returns The string representation of the endpoint.
      */
     toString(): string;
+    get [Symbol.toStringTag](): string;
+    get [Symbol.toPrimitive](): string;
 }
-//# sourceMappingURL=special-core-types.d.ts.map
+//# sourceMappingURL=endpoint.d.ts.map

package/esm/lib/special-core-types/endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../../../src/lib/special-core-types/endpoint.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,QAAQ;;IAIjB,oFAAoF;IACpF,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAa;IAE7D,OAAO;IAKP;;;OAGG;WACW,gBAAgB,CAAC,QAAQ,EAAE,QAAQ;IASjD;;;;OAIG;WACW,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ;IAa7C;;;OAGG;IACI,QAAQ,IAAI,MAAM;IAIzB,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,WAEvB;IAED,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,WAEvB;CACJ"}

package/esm/{runtime/special-core-types.js → lib/special-core-types/endpoint.js}

@@ -56,8 +56,13 @@ export class Endpoint {
     toString() {
         return __classPrivateFieldGet(this, _Endpoint_endpoint, "f");
     }
+    get [(_Endpoint_endpoint = new WeakMap(), Symbol.toStringTag)]() {
+        return __classPrivateFieldGet(this, _Endpoint_endpoint, "f");
+    }
+    get [Symbol.toPrimitive]() {
+        return __classPrivateFieldGet(this, _Endpoint_endpoint, "f");
+    }
 }
-_Endpoint_endpoint = new WeakMap();
 /** map with weak values that keeps track of all currently instantiated endpoints */
 Object.defineProperty(Endpoint, "endpoints", {
     enumerable: true,

package/esm/mod.d.ts

@@ -11,7 +11,7 @@
  * export const runtime: Runtime = await Runtime.create({
  *    interfaces: [{
  *         type: "websocket-client",
- *         config: { address: "wss://example.unyt.land" },
+ *         config: { url: "wss://example.unyt.land" },
  *     }],
  * });
  *
@@ -22,4 +22,6 @@
 export * from "./runtime/runtime.js";
 export * as DIF from "./dif/mod.js";
 export * as Network from "./network/mod.js";
+export * from "./refs/ref.js";
+import "./utils/devtools-formatter.js";
 //# sourceMappingURL=mod.d.ts.map

package/esm/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,qBAAqB,CAAC;AAG7B,cAAc,sBAAsB,CAAC;AACrC,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,qBAAqB,CAAC;AAG7B,cAAc,sBAAsB,CAAC;AACrC,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAC5C,cAAc,eAAe,CAAC;AAC9B,OAAO,+BAA+B,CAAC"}

package/esm/mod.js

@@ -11,7 +11,7 @@
  * export const runtime: Runtime = await Runtime.create({
  *    interfaces: [{
  *         type: "websocket-client",
- *         config: { address: "wss://example.unyt.land" },
+ *         config: { url: "wss://example.unyt.land" },
  *     }],
  * });
  *
@@ -22,3 +22,5 @@
 export * from "./runtime/runtime.js";
 export * as DIF from "./dif/mod.js";
 export * as Network from "./network/mod.js";
+export * from "./refs/ref.js";
+import "./utils/devtools-formatter.js";

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"}