@unyt/datex 0.0.13 → 0.0.15

package/esm/lib/js-core-types/array.js

@@ -0,0 +1,175 @@
+import { CoreLibTypeId } from "../../dif/core.js";
+import { IS_PROXY_ACCESS } from "../../dif/dif-handler.js";
+import { interceptAccessors } from "../../dif/utils.js";
+import { DEBUG_MODE } from "../../global.js";
+import { Option } from "../../utils/option.js";
+export const arrayTypeBinding = {
+    coreLibTypeId: CoreLibTypeId.List,
+    bind(target, pointerAddress) {
+        const metadata = {};
+        const arrayMethods = getArrayMethods(target, pointerAddress, this.difHandler, metadata);
+        // catch acccess (get or set) to original array value, not via proxy - this check is only active in debug mode
+        if (DEBUG_MODE) {
+            interceptAccessors(target, () => {
+                if (!metadata[IS_PROXY_ACCESS]) {
+                    throw new Error("Invalid access to original array value that was moved to a reference");
+                }
+                return Option.None();
+            }, () => {
+                if (!metadata[IS_PROXY_ACCESS]) {
+                    throw new Error("Invalid access to original array value that was moved to a reference");
+                }
+            });
+        }
+        // deno-lint-ignore no-this-alias
+        const self = this;
+        const proxy = new Proxy(target, {
+            get(_target, key) {
+                return self.allowOriginalValueAccess(proxy, () => {
+                    return arrayMethods[key] ??
+                        Reflect.get(target, key);
+                });
+            },
+            set(_target, prop, value, receiver) {
+                console.log("=> array." + String(prop) + " =", value);
+                return self.allowOriginalValueAccess(proxy, () => {
+                    const index = Number(prop);
+                    if (typeof prop === "string" && !isNaN(index) && index >= 0) {
+                        // check if out of bounds - fill with null&js.empty
+                        if (index >= target.length) {
+                            triggerArrayFillEmpty(target, target.length, index, pointerAddress, self.difHandler);
+                        }
+                        self.difHandler.triggerIndexSet(pointerAddress, index, value);
+                    }
+                    else if (prop === "length") {
+                        // if length is reduced, trigger delete for removed items
+                        const newLength = Number(value);
+                        // explicit length value 0 is treated as a full clear
+                        if (newLength == 0) {
+                            self.difHandler.triggerClear(pointerAddress);
+                        }
+                        else if (newLength < target.length) {
+                            self.difHandler.triggerListSplice(pointerAddress, newLength, target.length - newLength, []);
+                        } // if length is increased, trigger set for new empty items
+                        else if (newLength > target.length) {
+                            triggerArrayFillEmpty(target, target.length, newLength, pointerAddress, self.difHandler);
+                        }
+                    }
+                    // x[1..4] = js:empty
+                    return Reflect.set(target, prop, value, receiver);
+                });
+            },
+        });
+        return {
+            value: proxy,
+            metadata,
+        };
+    },
+    handleAppend(target, value) {
+        this.difHandler.getOriginalValueFromProxy(target).push(value);
+        // target.push(value);
+    },
+    handleSet(target, key, value) {
+        this.difHandler.getOriginalValueFromProxy(target)[key] = value;
+    },
+    handleDelete(target, key) {
+        // remove key (splice)
+        this.difHandler.getOriginalValueFromProxy(target).splice(key, 1);
+    },
+    handleClear(target) {
+        this.difHandler.getOriginalValueFromProxy(target).length = 0;
+    },
+    handleReplace(target, newValue) {
+        const original = this.difHandler.getOriginalValueFromProxy(target);
+        original.length = 0;
+        original.push(...newValue);
+    },
+    handleListSplice(target, start, deleteCount, items) {
+        this.difHandler
+            .getOriginalValueFromProxy(target)
+            .splice(start, deleteCount, ...items);
+    },
+};
+/**
+ * Implementes optimized array methods that send DIF updates on mutation.
+ * @returns
+ */
+function getArrayMethods(array, pointerAddress, difHandler, metadata) {
+    const originalPush = array.push.bind(array);
+    const originalUnshift = array.unshift.bind(array);
+    const originalSplice = array.splice.bind(array);
+    const originalFill = array.fill.bind(array);
+    return {
+        push: generateInterceptedArrayPush(array, originalPush, pointerAddress, difHandler),
+        unshift: generateInterceptedArrayUnshift(originalUnshift, pointerAddress, difHandler, metadata),
+        splice: generateInterceptedArraySplice(array, originalSplice, pointerAddress, difHandler, metadata),
+        fill: generateInterceptedArrayFill(array, originalFill, pointerAddress, difHandler, metadata),
+    };
+}
+function generateInterceptedArrayPush(array, originalPush, pointerAddress, difHandler) {
+    return (...items) => {
+        difHandler.triggerListSplice(pointerAddress, array.length, 0, items);
+        return originalPush(...items);
+    };
+}
+function generateInterceptedArrayUnshift(originalUnshift, pointerAddress, difHandler, metadata) {
+    return (...items) => {
+        difHandler.triggerListSplice(pointerAddress, 0, 0, items);
+        try {
+            metadata[IS_PROXY_ACCESS] = true;
+            return originalUnshift(...items);
+        }
+        finally {
+            metadata[IS_PROXY_ACCESS] = false;
+        }
+    };
+}
+function generateInterceptedArraySplice(array, originalSplice, pointerAddress, difHandler, metadata) {
+    return (start, deleteCount, ...items) => {
+        difHandler.triggerListSplice(pointerAddress, start, deleteCount ?? (array.length - start), items);
+        try {
+            metadata[IS_PROXY_ACCESS] = true;
+            return originalSplice(start, deleteCount, ...items);
+        }
+        finally {
+            metadata[IS_PROXY_ACCESS] = false;
+        }
+    };
+}
+function generateInterceptedArrayFill(array, originalFill, pointerAddress, difHandler, metadata) {
+    return (value, start, end) => {
+        const actualStart = start !== undefined
+            ? (start < 0 ? Math.max(array.length + start, 0) : Math.min(start, array.length))
+            : 0;
+        const actualEnd = end !== undefined
+            ? (end < 0 ? Math.max(array.length + end, 0) : Math.min(end, array.length))
+            : array.length;
+        const itemCount = actualEnd - actualStart;
+        // splice to replace the filled range
+        if (itemCount > 0) {
+            difHandler.triggerListSplice(pointerAddress, actualStart, actualEnd - actualStart, new Array(itemCount).fill(value));
+        }
+        try {
+            metadata[IS_PROXY_ACCESS] = true;
+            return originalFill(value, start, end);
+        }
+        finally {
+            metadata[IS_PROXY_ACCESS] = false;
+        }
+    };
+}
+/**
+ * Sends DIF updates that correspond to filling an array up to a certain index with
+ * empty values.
+ */
+function triggerArrayFillEmpty(array, from, to, pointerAddress, difHandler) {
+    const originalLength = array.length;
+    for (let i = from; i < to; i++) {
+        if (i < originalLength) {
+            difHandler.triggerSet(pointerAddress, i, null); // TODO: special js empty value
+        }
+        else {
+            difHandler.triggerAppend(pointerAddress, null); // TODO: special js empty value
+        }
+    }
+}

package/esm/lib/js-core-types/map.d.ts

@@ -0,0 +1,15 @@
+import type { TypeBindingDefinition } from "../../dif/type-registry.js";
+import type { DIFTypeDefinition } from "../../dif/types/mod.js";
+declare const ORIGINAL_SET: unique symbol;
+declare const ORIGINAL_DELETE: unique symbol;
+declare const ORIGINAL_CLEAR: unique symbol;
+type MapMetadata<K = unknown, V = unknown> = {
+    [ORIGINAL_SET]: Map<K, V>["set"];
+    [ORIGINAL_DELETE]: Map<K, V>["delete"];
+    [ORIGINAL_CLEAR]: Map<K, V>["clear"];
+};
+export declare const mapTypeBinding: TypeBindingDefinition<Map<unknown, unknown>, MapMetadata>;
+export declare const JS_MAP_TYPE_DEFINITION: DIFTypeDefinition;
+export declare function isJsMapTypeDefinition(typeDef: DIFTypeDefinition): boolean;
+export {};
+//# sourceMappingURL=map.d.ts.map

package/esm/lib/js-core-types/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../../src/lib/js-core-types/map.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAyB,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGvF,QAAA,MAAM,YAAY,eAAyB,CAAC;AAC5C,QAAA,MAAM,eAAe,eAA4B,CAAC;AAClD,QAAA,MAAM,cAAc,eAA2B,CAAC;AAEhD,KAAK,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI;IACzC,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC,eAAe,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC,cAAc,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;CACxC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,qBAAqB,CAC9C,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,EACrB,WAAW,CAsEd,CAAC;AAiBF,eAAO,MAAM,sBAAsB,EAAE,iBAEpC,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAOzE"}

package/esm/lib/js-core-types/map.js

@@ -0,0 +1,88 @@
+import { CoreLibTypeId } from "../../dif/core.js";
+import { JsLibTypeAddress } from "../../dif/js-lib.js";
+const ORIGINAL_SET = Symbol("ORIGINAL_SET");
+const ORIGINAL_DELETE = Symbol("ORIGINAL_DELETE");
+const ORIGINAL_CLEAR = Symbol("ORIGINAL_CLEAR");
+export const mapTypeBinding = {
+    coreLibTypeId: CoreLibTypeId.Map,
+    bind(value, pointerAddress) {
+        const originalSet = value.set.bind(value);
+        const originalDelete = value.delete.bind(value);
+        const originalClear = value.clear.bind(value);
+        Object.defineProperties(value, {
+            set: {
+                value: (key, val) => {
+                    this.difHandler.triggerSet(pointerAddress, key, val);
+                    return originalSet.call(value, key, val);
+                },
+                configurable: true,
+                writable: true,
+            },
+            delete: {
+                value: (key) => {
+                    this.difHandler.triggerDelete(pointerAddress, key);
+                    return originalDelete.call(value, key);
+                },
+                configurable: true,
+                writable: true,
+            },
+            clear: {
+                value: () => {
+                    console.warn("triggering clear for pointer address:", pointerAddress);
+                    this.difHandler.triggerClear(pointerAddress);
+                    return originalClear.call(value);
+                },
+                configurable: true,
+                writable: true,
+            },
+        });
+        return {
+            value,
+            metadata: {
+                [ORIGINAL_SET]: originalSet,
+                [ORIGINAL_DELETE]: originalDelete,
+                [ORIGINAL_CLEAR]: originalClear,
+            },
+        };
+    },
+    handleSet(target, key, value) {
+        const set = this.getCustomReferenceMetadata(target)[ORIGINAL_SET];
+        set.call(target, key, value);
+    },
+    handleDelete(target, key) {
+        const del = this.getCustomReferenceMetadata(target)[ORIGINAL_DELETE];
+        del.call(target, key);
+    },
+    handleClear(target) {
+        const clear = this.getCustomReferenceMetadata(target)[ORIGINAL_CLEAR];
+        clear.call(target);
+    },
+    handleReplace(target, newValue) {
+        const metadata = this.getCustomReferenceMetadata(target);
+        metadata[ORIGINAL_CLEAR].call(target);
+        for (const [key, value] of newValue.entries()) {
+            metadata[ORIGINAL_SET].call(target, key, value);
+        }
+    },
+};
+const JS_MAP_IMPL_TYPE_DEFINITION = [
+    CoreLibTypeId.Map,
+    [JsLibTypeAddress.map],
+];
+function isJsMapImplTypeDefinition(impl) {
+    return (Array.isArray(impl) &&
+        impl.length === 2 &&
+        impl[0] === CoreLibTypeId.Map &&
+        Array.isArray(impl[1]) &&
+        impl[1].length === 1 &&
+        impl[1][0] === JsLibTypeAddress.map);
+}
+export const JS_MAP_TYPE_DEFINITION = {
+    impl_type: JS_MAP_IMPL_TYPE_DEFINITION,
+};
+export function isJsMapTypeDefinition(typeDef) {
+    return (typeof typeDef === "object" &&
+        typeDef !== null &&
+        "impl_type" in typeDef &&
+        isJsMapImplTypeDefinition(typeDef.impl_type));
+}

package/esm/lib/js-core-types/mod.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @module js-core-types
+ * @description
+ * This module contains all core type definitions that have a builtin JS mapping, such as arrays and maps.
+ */
+export * from "./map.js";
+export * from "./array.js";
+//# sourceMappingURL=mod.d.ts.map

package/esm/lib/js-core-types/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/lib/js-core-types/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}

package/esm/lib/js-core-types/mod.js

@@ -0,0 +1,7 @@
+/**
+ * @module js-core-types
+ * @description
+ * This module contains all core type definitions that have a builtin JS mapping, such as arrays and maps.
+ */
+export * from "./map.js";
+export * from "./array.js";

package/esm/lib/mod.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @module lib
+ * @description
+ * This module contains all core library types and utilities for the DATEX runtime.
+ */
+export * from "./js-core-types/mod.js";
+export * from "./special-core-types/mod.js";
+//# sourceMappingURL=mod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/lib/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC"}

package/esm/lib/mod.js

@@ -0,0 +1,7 @@
+/**
+ * @module lib
+ * @description
+ * This module contains all core library types and utilities for the DATEX runtime.
+ */
+export * from "./js-core-types/mod.js";
+export * from "./special-core-types/mod.js";

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

@@ -1 +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"}
+{"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,IAAI,MAAM,CAEjC;IAED,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;CACJ"}

package/esm/lib/special-core-types/mod.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @module special-core-types
+ * @description
+ * This module contains type definitions for special core types in the DATEX runtime, such as endpoints and ranges.
+ */
+export * from "./endpoint.js";
+export * from "./range.js";
+export * from "./tagged.js";
+//# sourceMappingURL=mod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/lib/special-core-types/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/esm/lib/special-core-types/mod.js

@@ -0,0 +1,8 @@
+/**
+ * @module special-core-types
+ * @description
+ * This module contains type definitions for special core types in the DATEX runtime, such as endpoints and ranges.
+ */
+export * from "./endpoint.js";
+export * from "./range.js";
+export * from "./tagged.js";

package/esm/lib/special-core-types/range.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Represents a range of numbers with a start and end.
+ */
+export declare class Range {
+    start: number;
+    end: number;
+    constructor(start: number, end: number);
+    /**
+     * Gets the length of the range (end - start).
+     */
+    get length(): number;
+    /**
+     * Checks if a given value is within the range (inclusive of start, exclusive of end).
+     * @param value The number to check.
+     * @returns True if the value is within the range, false otherwise.
+     */
+    contains(value: number): boolean;
+    /**
+     * Turns a string representation of the range in the format
+     * @returns The string representation of the range.
+     */
+    toString(): string;
+    get [Symbol.toStringTag](): string;
+    get [Symbol.toPrimitive](): string;
+}
+//# sourceMappingURL=range.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../../../src/lib/special-core-types/range.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,KAAK;IACK,KAAK,EAAE,MAAM;IAAS,GAAG,EAAE,MAAM;gBAAjC,KAAK,EAAE,MAAM,EAAS,GAAG,EAAE,MAAM;IAEpD;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;;OAIG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIvC;;;OAGG;IACI,QAAQ,IAAI,MAAM;IAIzB,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;IACD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;CACJ"}

package/esm/lib/special-core-types/range.js

@@ -0,0 +1,46 @@
+/**
+ * Represents a range of numbers with a start and end.
+ */
+export class Range {
+    constructor(start, end) {
+        Object.defineProperty(this, "start", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: start
+        });
+        Object.defineProperty(this, "end", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: end
+        });
+    }
+    /**
+     * Gets the length of the range (end - start).
+     */
+    get length() {
+        return this.end - this.start;
+    }
+    /**
+     * Checks if a given value is within the range (inclusive of start, exclusive of end).
+     * @param value The number to check.
+     * @returns True if the value is within the range, false otherwise.
+     */
+    contains(value) {
+        return value >= this.start && value < this.end;
+    }
+    /**
+     * Turns a string representation of the range in the format
+     * @returns The string representation of the range.
+     */
+    toString() {
+        return `${this.start}..${this.end}`;
+    }
+    get [Symbol.toStringTag]() {
+        return this.toString();
+    }
+    get [Symbol.toPrimitive]() {
+        return this.toString();
+    }
+}

package/esm/lib/special-core-types/tagged.d.ts

@@ -0,0 +1,17 @@
+export declare const EMPTY_TAG: unique symbol;
+/**
+ * A simple wrapper type that allows to associate a string tag with a value.
+ */
+export declare class Tagged<Tag extends string, const Value = typeof EMPTY_TAG> {
+    #private;
+    constructor(tag: Tag, value?: Value);
+    get value(): Value;
+    set value(newValue: Value);
+    get tag(): Tag;
+}
+/**
+ * Creates a new Tagged instance with the given tag and value.
+ */
+export declare function tagged<Tag extends string>(tag: Tag): Tagged<Tag, typeof EMPTY_TAG>;
+export declare function tagged<Tag extends string, const Value>(tag: Tag, value: Value): Tagged<Tag, Value>;
+//# sourceMappingURL=tagged.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tagged.d.ts","sourceRoot":"","sources":["../../../src/lib/special-core-types/tagged.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,eAAsB,CAAC;AAE7C;;GAEG;AACH,qBAAa,MAAM,CAAC,GAAG,SAAS,MAAM,EAAE,KAAK,CAAC,KAAK,GAAG,OAAO,SAAS;;gBAK9D,GAAG,EAAE,GAAG,EACR,KAAK,GAAE,KAA0B;IAMrC,IAAW,KAAK,IAAI,KAAK,CAExB;IAED,IAAW,KAAK,CAAC,QAAQ,EAAE,KAAK,EAE/B;IAED,IAAW,GAAG,IAAI,GAAG,CAEpB;CACJ;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,GAAG,SAAS,MAAM,EACrC,GAAG,EAAE,GAAG,GACT,MAAM,CAAC,GAAG,EAAE,OAAO,SAAS,CAAC,CAAC;AACjC,wBAAgB,MAAM,CAAC,GAAG,SAAS,MAAM,EAAE,KAAK,CAAC,KAAK,EAClD,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,KAAK,GACb,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC"}

package/esm/lib/special-core-types/tagged.js

@@ -0,0 +1,37 @@
+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 _Tagged_tag, _Tagged_value;
+export const EMPTY_TAG = Symbol("EMPTY_TAG");
+/**
+ * A simple wrapper type that allows to associate a string tag with a value.
+ */
+export class Tagged {
+    constructor(tag, value = EMPTY_TAG) {
+        _Tagged_tag.set(this, void 0);
+        _Tagged_value.set(this, void 0);
+        __classPrivateFieldSet(this, _Tagged_tag, tag, "f");
+        __classPrivateFieldSet(this, _Tagged_value, value, "f");
+    }
+    get value() {
+        return __classPrivateFieldGet(this, _Tagged_value, "f");
+    }
+    set value(newValue) {
+        __classPrivateFieldSet(this, _Tagged_value, newValue, "f");
+    }
+    get tag() {
+        return __classPrivateFieldGet(this, _Tagged_tag, "f");
+    }
+}
+_Tagged_tag = new WeakMap(), _Tagged_value = new WeakMap();
+export function tagged(tag, value = EMPTY_TAG) {
+    return new Tagged(tag, value);
+}

package/esm/lib/special-core-types/undefined.d.ts

@@ -0,0 +1,7 @@
+import type { DIFValue } from "../../dif/types/mod.js";
+import type { DIFTypeDefinition } from "../../dif/types/type.js";
+export declare const JS_UNDEFINED_TYPE_DEFINITION: DIFTypeDefinition;
+export declare function isJsUndefinedTypeDefinition(typeDef: DIFTypeDefinition): boolean;
+export declare const JS_UNDEFINED: DIFValue;
+export declare function isJsUndefined(value: DIFValue): boolean;
+//# sourceMappingURL=undefined.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"undefined.d.ts","sourceRoot":"","sources":["../../../src/lib/special-core-types/undefined.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAyB,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAiBxF,eAAO,MAAM,4BAA4B,EAAE,iBAE1C,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAO/E;AAED,eAAO,MAAM,YAAY,EAAE,QAAmE,CAAC;AAC/F,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAGtD"}

package/esm/lib/special-core-types/undefined.js

@@ -0,0 +1,28 @@
+import { CoreLibTypeId } from "../../dif/core.js";
+import { JsLibTypeAddress } from "../../dif/js-lib.js";
+const JS_UNDEFINED_IMPL_TYPE_DEFINITION = [
+    CoreLibTypeId.null,
+    [JsLibTypeAddress.undefined],
+];
+function isJsUndefinedImplTypeDefinition(impl) {
+    return (Array.isArray(impl) &&
+        impl.length === 2 &&
+        impl[0] === CoreLibTypeId.null &&
+        Array.isArray(impl[1]) &&
+        impl[1].length === 1 &&
+        impl[1][0] === JsLibTypeAddress.undefined);
+}
+export const JS_UNDEFINED_TYPE_DEFINITION = {
+    impl_type: JS_UNDEFINED_IMPL_TYPE_DEFINITION,
+};
+export function isJsUndefinedTypeDefinition(typeDef) {
+    return (typeof typeDef === "object" &&
+        typeDef !== null &&
+        "impl_type" in typeDef &&
+        isJsUndefinedImplTypeDefinition(typeDef.impl_type));
+}
+export const JS_UNDEFINED = [CoreLibTypeId.null, null, JS_UNDEFINED_TYPE_DEFINITION];
+export function isJsUndefined(value) {
+    return Array.isArray(value) && value.length === 3 && value[0] === CoreLibTypeId.null && value[1] === null &&
+        isJsUndefinedTypeDefinition(value[2]);
+}

package/esm/mod.d.ts

@@ -22,6 +22,8 @@
 export * from "./runtime/runtime.js";
 export * as DIF from "./dif/mod.js";
 export * as Network from "./network/mod.js";
-export * from "./refs/ref.js";
+export * as Builtins from "./lib/mod.js";
+export * as Shared from "./shared-container/mod.js";
+export * from "./repl/mod.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;AAC5C,cAAc,eAAe,CAAC;AAC9B,OAAO,+BAA+B,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,OAAO,KAAK,QAAQ,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,cAAc,eAAe,CAAC;AAC9B,OAAO,+BAA+B,CAAC"}

package/esm/mod.js

@@ -22,5 +22,7 @@
 export * from "./runtime/runtime.js";
 export * as DIF from "./dif/mod.js";
 export * as Network from "./network/mod.js";
-export * from "./refs/ref.js";
+export * as Builtins from "./lib/mod.js";
+export * as Shared from "./shared-container/mod.js";
+export * from "./repl/mod.js";
 import "./utils/devtools-formatter.js";

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

@@ -1,9 +1,36 @@
-import type { ComHubMetadata, ComInterfaceConfiguration, JSComHub, NetworkTraceResult } from "../datex-web/datex_web";
 import type { Runtime } from "../runtime/runtime.js";
+import type { DIFValueContainer } from "../dif/types/value.js";
+import type { JSComHub } from "../datex.js";
+import type { ComHubMetadata } from "../datex-web/types/network/com_hub/metadata.js";
+import type { NetworkTraceResult } from "../datex-web/types/network/com_hub/network_tracing.js";
+import type { SocketPropertiesPartial } from "../datex-web/types/network/com_hub.js";
+import type { ComInterfaceProperties } from "../datex-web/types/network/com_interfaces/com_interface/properties.js";
 export type ComInterfaceFactory<SetupData = unknown> = {
     interfaceType: string;
     factory: ComInterfaceFactoryFn<SetupData>;
 };
+export type SocketConfiguration = {
+    properties: DIFValueContainer<SocketPropertiesPartial>;
+    iterator: ReadableStream<ArrayBufferLike>;
+    send_callback: (data: ArrayBuffer) => void;
+};
+export type ComInterfaceConfiguration = {
+    /**
+     * The properties of the interface instance
+     */
+    properties: ComInterfaceProperties;
+    /**
+     * Indicates that this interface only establishes a single socket connection
+     * And stops the sockets iterator after yielding the first socket configuration.
+     * When set to true, the first socket connection is awaited on interface creation.
+     */
+    has_single_socket: boolean;
+    new_sockets_iterator: ReadableStream<SocketConfiguration>;
+    /**
+     * An optional asynchronous callback that is called by the com hub when the interface is closed
+     */
+    close_async_callback?: never;
+};
 export type ComInterfaceFactoryFn<SetupData = unknown> = (setup_data: SetupData) => ComInterfaceConfiguration | Promise<ComInterfaceConfiguration>;
 export type ComInterfaceUUID = `com_interface::${string}`;
 export type ComInterfaceSocketUUID = `socket::${string}`;

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,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"}
+{"version":3,"file":"com-hub.d.ts","sourceRoot":"","sources":["../../src/network/com-hub.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uDAAuD,CAAC;AAChG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uEAAuE,CAAC;AAEpH,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,mBAAmB,GAAG;IAC9B,UAAU,EAAE,iBAAiB,CAAC,uBAAuB,CAAC,CAAC;IACvD,QAAQ,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;IAC1C,aAAa,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACpC;;OAEG;IACH,UAAU,EAAE,sBAAsB,CAAC;IACnC;;;;OAIG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,cAAc,CAAC,mBAAmB,CAAC,CAAC;IAC1D;;OAEG;IACH,oBAAoB,CAAC,EAAE,KAAK,CAAC;CAChC,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;IAerD;;;;;;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

@@ -24,7 +24,11 @@ export class ComHub {
     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);
+            const data = await factoryDefinition.factory(setupDataJS);
+            return {
+                ...data,
+                properties: __classPrivateFieldGet(this, _ComHub_runtime, "f").dif.convertJSValueToDIFValueContainer(data.properties),
+            };
         });
     }
     /**
@@ -53,7 +57,7 @@ export class ComHub {
     }
     getMetadata() {
         // as any required because get_metadata only exists in debug builds
-        return __classPrivateFieldGet(this, _ComHub_jsComHub, "f").get_metadata();
+        return __classPrivateFieldGet(this, _ComHub_runtime, "f").dif.resolveDIFValueContainer(__classPrivateFieldGet(this, _ComHub_jsComHub, "f").get_metadata());
     }
     /**
      * Prints the trace for a specific endpoint. Only available in debug builds.

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

@@ -1,5 +1,5 @@
 import type { ComInterfaceFactory } from "../com-hub.js";
-import type { WebSocketServerInterfaceSetupData } from "../../datex.js";
+import type { WebSocketServerInterfaceSetupData } from "../../datex-web/types/network/com_interfaces/default_setup_data/websocket/websocket_server.js";
 /**
  * Utility function to create a WebSocket server communication interface factory from a given server factory function.
  * @param serverFactory