@unyt/datex 0.0.7 → 0.0.9

package/esm/datex-core/datex_core_js.js

@@ -1,20 +1,17 @@
-import * as dntShim from "../_dnt.shims.js";
 import * as imports from "./datex_core_js.internal.js";
-// for deno-to-node builds, fetch does not support streaming webassembly instantiation
-// FIXME const isDntBuild = !!globalThis[Symbol.for("import-meta-ponyfill-commonjs")];
-const isBrowser = !globalThis.navigator?.userAgent.startsWith("Deno") &&
-    !globalThis.navigator?.userAgent.startsWith("Node.js") &&
-    !globalThis.navigator?.userAgent.startsWith("Bun");
-const wasm = (isBrowser // TODO: Deno should also do instantiateStreaming (globalThis.Deno && !isDntBuild)
-    ? await WebAssembly.instantiateStreaming(
-    // dnt-shim-ignore
-    fetch(new URL("datex_core_js.wasm", import.meta.url)), {
-        "./datex_core_js.internal.js": imports,
-    })
-    : await WebAssembly.instantiate(await dntShim.Deno.readFile(new URL("datex_core_js.wasm", globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).url)), {
-        "./datex_core_js.internal.js": imports,
-    })).instance;
+import { runtimeInterface, detectRuntime } from "../utils/js-runtime-compat/js-runtime.js";
+
+let wasmUrl;
+if (detectRuntime() == "browser") {
+    wasmUrl = (await import("./wasm_url.node.js")).default;
+} else {
+    wasmUrl = new URL("datex_core_js.wasm", import.meta.url);
+}
+
+const wasm = (await runtimeInterface.instantiateWebAssembly(wasmUrl, {
+    "./datex_core_js.internal.js": imports,
+})).instance;
 export * from "./datex_core_js.internal.js";
 import { __wbg_set_wasm } from "./datex_core_js.internal.js";
 __wbg_set_wasm(wasm.exports);
-wasm.exports.__wbindgen_start();
+wasm.exports.__wbindgen_start();

package/esm/datex-core/wasm_url.node.js

@@ -0,0 +1 @@
+export { default } from "./datex_core_js.wasm?url";

package/esm/datex-core.d.ts

@@ -1,2 +1,8 @@
+/**
+ * @module datex-core.ts
+ * @description
+ * This module serves as the core of the Datex library, re-exporting
+ * essential types and functionalities from the Datex core JavaScript implementation.
+ */
 export * from "./datex-core/datex_core_js.js";
 //# sourceMappingURL=datex-core.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"datex-core.d.ts","sourceRoot":"","sources":["../src/datex-core.ts"],"names":[],"mappings":"AACA,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"datex-core.d.ts","sourceRoot":"","sources":["../src/datex-core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,+BAA+B,CAAC"}

package/esm/datex-core.js

@@ -1,2 +1,8 @@
+/**
+ * @module datex-core.ts
+ * @description
+ * This module serves as the core of the Datex library, re-exporting
+ * essential types and functionalities from the Datex core JavaScript implementation.
+ */
 /* @ts-types="./datex-core/datex_core_js.d.ts" */
 export * from "./datex-core/datex_core_js.js";

package/esm/default.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @module default.ts
+ * @description
+ * This module exports an instance of the DATEX runtime.
+ */
+import { Runtime } from "./runtime/runtime.js";
+/**
+ * The default instance of the Datex runtime.
+ */
+export declare const Datex: Runtime;
+//# sourceMappingURL=default.d.ts.map

package/esm/default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../src/default.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,qBAAqB,CAAC;AAG7B,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAa/C;;GAEG;AACH,eAAO,MAAM,KAAK,EAAE,OAElB,CAAC"}

package/esm/default.js

@@ -0,0 +1,22 @@
+/**
+ * @module default.ts
+ * @description
+ * This module exports an instance of the DATEX runtime.
+ */
+import { Runtime } from "./runtime/runtime.js";
+/**
+ * The default configuration for the Datex runtime.
+ */
+const defaultConfig = {
+    interfaces: [{
+            type: "websocket-client",
+            config: { address: "wss://example.unyt.land" },
+        }],
+    debug: false, // set to true to show info/debug messages
+};
+/**
+ * The default instance of the Datex runtime.
+ */
+export const Datex = await Runtime.create(defaultConfig, {
+    allow_unsigned_blocks: true,
+});

package/esm/deno.json

@@ -1,11 +1,22 @@
 {
     "name": "@unyt/datex",
-    "version": "0.0.7",
+    "version": "0.0.9",
     "license": "MIT",
-    "exports": "./src/mod.ts",
+    "exports": {
+        ".": "./src/mod.ts",
+        "./default": "./src/default.ts",
+        "./interface-impls/base": "./src/network/interface-impls/base.ts",
+        "./interface-impls/serial": "./src/network/interface-impls/serial.ts",
+        "./interface-impls/webrtc": "./src/network/interface-impls/webrtc.ts",
+        "./interface-impls/websocket-client": "./src/network/interface-impls/websocket-client.ts",
+        "./interface-impls/websocket-server-deno": "./src/network/interface-impls/websocket-server-deno.ts"
+    },
     "compilerOptions": {
         "noImplicitOverride": true,
-        "lib": ["deno.window", "dom"]
+        "lib": [
+            "deno.window",
+            "dom"
+        ]
     },
     "tasks": {
         "build": "deno run -A scripts/build-wasm.ts --profile debug",
@@ -21,7 +32,9 @@
     },
     "fmt": {
         "indentWidth": 4,
-        "exclude": ["./npm"]
+        "exclude": [
+            "./npm"
+        ]
     },
     "imports": {
         "@david/path": "jsr:@david/path@^0.2.0",
@@ -32,10 +45,13 @@
         "@std/cli": "jsr:@std/cli@^1.0.23",
         "@std/encoding": "jsr:@std/encoding@^1.0.10",
         "@std/fmt": "jsr:@std/fmt@^1.0.8",
-        "@std/uuid": "jsr:@std/uuid@^1.0.9"
+        "@std/uuid": "jsr:@std/uuid@^1.0.9",
+        "@unyt/speck": "jsr:@unyt/speck@^0.0.10"
     },
     "test": {
-        "exclude": ["./npm"]
+        "exclude": [
+            "./npm"
+        ]
     },
     "publish": {
         "exclude": [

package/esm/dif/builders.d.ts

@@ -1,3 +1,8 @@
+/**
+ * @module
+ * @description
+ * This module contains helper functions to create DIFUpdate objects.
+ */
 import { type DIFUpdateData } from "./definitions.js";
 import type { DIFHandler } from "./dif-handler.js";
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../src/dif/builders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EACzB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,CAAC,GACT,aAAa,CAMf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EACnC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,CAAC,GACT,aAAa,CAQf"}
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../src/dif/builders.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EACzB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,CAAC,GACT,aAAa,CAMf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EACnC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,CAAC,GACT,aAAa,CAQf"}

package/esm/dif/builders.js

@@ -1,3 +1,8 @@
+/**
+ * @module
+ * @description
+ * This module contains helper functions to create DIFUpdate objects.
+ */
 import { DIFUpdateKind } from "./definitions.js";
 /**
  * Creates a DIFUpdate object that describes replacing a pointer's value.

package/esm/dif/core.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Mapping of core type names to their unique pointer addresses.
+ */
+export declare const CoreTypeAddress: {
+    readonly null: "010000";
+    readonly type: "020000";
+    readonly boolean: "030000";
+    readonly endpoint: "070000";
+    readonly text: "080000";
+    readonly list: "090000";
+    readonly unit: "0b0000";
+    readonly map: "0c0000";
+    readonly decimal: "2c0100";
+    readonly decimal_f32: "2d0100";
+    readonly decimal_f64: "2e0100";
+    readonly decimal_big: "2f0100";
+    readonly integer: "640000";
+    readonly integer_u8: "650000";
+    readonly integer_u16: "660000";
+    readonly integer_u32: "670000";
+    readonly integer_u64: "680000";
+    readonly integer_u128: "690000";
+    readonly integer_i8: "6a0000";
+    readonly integer_i16: "6b0000";
+    readonly integer_i32: "6c0000";
+    readonly integer_i64: "6d0000";
+    readonly integer_i128: "6e0000";
+    readonly integer_big: "6f0000";
+};
+/**
+ * Type representing the unique pointer addresses of core types.
+ */
+export type CoreTypeAddress = typeof CoreTypeAddress[keyof typeof CoreTypeAddress];
+/**
+ * Mapping of core type address ranges for categorization.
+ */
+export declare const CoreTypeAddressRanges: {
+    readonly small_unsigned_integers: Set<"650000" | "660000" | "670000" | "680000" | "690000">;
+    readonly big_unsigned_integers: Set<"6f0000">;
+    readonly small_signed_integers: Set<"6a0000" | "6b0000" | "6c0000" | "6d0000" | "6e0000">;
+    readonly big_signed_integers: Set<"6f0000">;
+    readonly decimals: Set<"2c0100" | "2d0100" | "2e0100" | "2f0100">;
+};
+//# sourceMappingURL=core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/dif/core.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;CAyBlB,CAAC;AACX;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;CAuBxB,CAAC"}

package/esm/dif/core.js

@@ -0,0 +1,56 @@
+/**
+ * Mapping of core type names to their unique pointer addresses.
+ */
+export const CoreTypeAddress = {
+    null: "010000",
+    type: "020000",
+    boolean: "030000",
+    endpoint: "070000",
+    text: "080000",
+    list: "090000",
+    unit: "0b0000",
+    map: "0c0000",
+    decimal: "2c0100",
+    decimal_f32: "2d0100",
+    decimal_f64: "2e0100",
+    decimal_big: "2f0100",
+    integer: "640000",
+    integer_u8: "650000",
+    integer_u16: "660000",
+    integer_u32: "670000",
+    integer_u64: "680000",
+    integer_u128: "690000",
+    integer_i8: "6a0000",
+    integer_i16: "6b0000",
+    integer_i32: "6c0000",
+    integer_i64: "6d0000",
+    integer_i128: "6e0000",
+    integer_big: "6f0000",
+};
+/**
+ * Mapping of core type address ranges for categorization.
+ */
+export const CoreTypeAddressRanges = {
+    small_unsigned_integers: new Set([
+        CoreTypeAddress.integer_u8,
+        CoreTypeAddress.integer_u16,
+        CoreTypeAddress.integer_u32,
+        CoreTypeAddress.integer_u64,
+        CoreTypeAddress.integer_u128,
+    ]),
+    big_unsigned_integers: new Set([CoreTypeAddress.integer_big]),
+    small_signed_integers: new Set([
+        CoreTypeAddress.integer_i8,
+        CoreTypeAddress.integer_i16,
+        CoreTypeAddress.integer_i32,
+        CoreTypeAddress.integer_i64,
+        CoreTypeAddress.integer_i128,
+    ]),
+    big_signed_integers: new Set([CoreTypeAddress.integer_big]),
+    decimals: new Set([
+        CoreTypeAddress.decimal,
+        CoreTypeAddress.decimal_f32,
+        CoreTypeAddress.decimal_f64,
+        CoreTypeAddress.decimal_big,
+    ]),
+};

package/esm/dif/definitions.d.ts

@@ -1,44 +1,28 @@
-export declare const CoreTypeAddress: {
-    readonly null: "010000";
-    readonly type: "020000";
-    readonly boolean: "030000";
-    readonly endpoint: "070000";
-    readonly text: "080000";
-    readonly list: "090000";
-    readonly unit: "0b0000";
-    readonly map: "0c0000";
-    readonly decimal: "2c0100";
-    readonly decimal_f32: "2d0100";
-    readonly decimal_f64: "2e0100";
-    readonly decimal_big: "2f0100";
-    readonly integer: "640000";
-    readonly integer_u8: "650000";
-    readonly integer_u16: "660000";
-    readonly integer_u32: "670000";
-    readonly integer_u64: "680000";
-    readonly integer_u128: "690000";
-    readonly integer_i8: "6a0000";
-    readonly integer_i16: "6b0000";
-    readonly integer_i32: "6c0000";
-    readonly integer_i64: "6d0000";
-    readonly integer_i128: "6e0000";
-    readonly integer_big: "6f0000";
-};
-export type CoreTypeAddress = typeof CoreTypeAddress[keyof typeof CoreTypeAddress];
-export declare const CoreTypeAddressRanges: {
-    readonly small_unsigned_integers: Set<"650000" | "660000" | "670000" | "680000" | "690000">;
-    readonly big_unsigned_integers: Set<"6f0000">;
-    readonly small_signed_integers: Set<"6a0000" | "6b0000" | "6c0000" | "6d0000" | "6e0000">;
-    readonly big_signed_integers: Set<"6f0000">;
-    readonly decimals: Set<"2c0100" | "2d0100" | "2e0100" | "2f0100">;
-};
-/** 3, 5, or 26 byte hex string */
+/**
+ * @module
+ * @description
+ * This module contains all definitions related to the DIF (DATEX Interchange Format) interfaces of the DATEX runtime.
+ */
+/**
+ * A DATEX pointer address representation in the DIF format.
+ * (3, 5, or 26 byte hex string)
+ */
 export type DIFPointerAddress = string;
+/**
+ * A DATEX value representation in the DIF format,
+ * which may optionally include type information.
+ */
 export type DIFValue = {
     type?: DIFTypeContainer;
     value: DIFRepresentationValue;
 };
+/**
+ * A DATEX value or pointer address representation in the DIF format.
+ */
 export type DIFContainer = DIFValue | DIFPointerAddress;
+/**
+ * Mapping of DIF type kinds.
+ */
 export declare const DIFTypeKinds: {
     readonly Structural: 0;
     readonly Reference: 1;
@@ -47,31 +31,47 @@ export declare const DIFTypeKinds: {
     readonly Unit: 4;
     readonly Function: 5;
 };
+/** A DIF type kind. */
 export type DIFTypeKind = typeof DIFTypeKinds[keyof typeof DIFTypeKinds];
+/**
+ * Representation of reference mutability (mutable or immutable) in DIF.
+ */
 export declare const DIFReferenceMutability: {
     readonly Mutable: 0;
     readonly Immutable: 1;
-    readonly Final: 2;
 };
+/** A DIF reference mutability. */
 export type DIFReferenceMutability = typeof DIFReferenceMutability[keyof typeof DIFReferenceMutability];
+/** A DIF type definition based on its kind. */
 export type DIFTypeDefinition<Kind extends DIFTypeKind = DIFTypeKind> = Kind extends typeof DIFTypeKinds.Structural ? DIFValue : Kind extends typeof DIFTypeKinds.Reference ? DIFPointerAddress : Kind extends typeof DIFTypeKinds.Intersection ? Array<DIFTypeContainer> : Kind extends typeof DIFTypeKinds.Union ? Array<DIFTypeContainer> : Kind extends typeof DIFTypeKinds.Unit ? null : Kind extends typeof DIFTypeKinds.Function ? unknown : never;
+/** A DIF type representation. */
 export type DIFType<Kind extends DIFTypeKind = DIFTypeKind> = {
     name?: string;
     kind: Kind;
     def: DIFTypeDefinition<Kind>;
     mut?: DIFReferenceMutability;
 };
+/** A representation of a reference in DIF. */
 export type DIFReference = {
     value: DIFValueContainer;
     allowed_type: DIFTypeContainer;
     mut: DIFReferenceMutability;
 };
+/** A representation of a value or pointer address in DIF. */
 export type DIFValueContainer = DIFValue | DIFPointerAddress;
+/** A representation of a type or type pointer address in DIF. */
 export type DIFTypeContainer = DIFType | DIFPointerAddress;
+/** A DIF object, mapping string keys to DIF value containers. */
 export type DIFObject = Record<string, DIFValueContainer>;
+/** A DIF array, containing DIF value containers. */
 export type DIFArray = DIFValueContainer[];
+/** A DIF map, containing key-value pairs of DIF value containers. */
 export type DIFMap = [DIFValueContainer, DIFValueContainer][];
+/** Any DIF representation value (JSON-compatible values). */
 export type DIFRepresentationValue = string | number | boolean | null | DIFObject | DIFMap | DIFArray;
+/**
+ * Representation of a property in DIF, which can be a text key, an index, or a generic value.
+ */
 export type DIFProperty = {
     kind: "text";
     value: string;
@@ -82,6 +82,9 @@ export type DIFProperty = {
     kind: "value";
     value: DIFValueContainer;
 };
+/**
+ * Kinds of updates that can be applied to a DIF value.
+ */
 export declare const DIFUpdateKind: {
     readonly Replace: "replace";
     readonly Push: "push";
@@ -89,7 +92,9 @@ export declare const DIFUpdateKind: {
     readonly Remove: "remove";
     readonly Clear: "clear";
 };
+/** A DIF update kind. */
 export type DIFUpdateKind = typeof DIFUpdateKind[keyof typeof DIFUpdateKind];
+/** Different kinds of updates that can be applied to a DIF value. */
 export type DIFUpdateData = {
     kind: typeof DIFUpdateKind.Replace;
     value: DIFValueContainer;
@@ -106,10 +111,12 @@ export type DIFUpdateData = {
 } | {
     kind: typeof DIFUpdateKind.Clear;
 };
+/** A DIF update struct, associating a source ID with update data. */
 export type DIFUpdate = {
     source_id: number;
     data: DIFUpdateData;
 };
+/** Options for observing DIF pointers. */
 export type ObserveOptions = {
     relay_own_updates: boolean;
 };

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

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

package/esm/dif/definitions.js

@@ -1,53 +1,11 @@
-export const CoreTypeAddress = {
-    null: "010000",
-    type: "020000",
-    boolean: "030000",
-    endpoint: "070000",
-    text: "080000",
-    list: "090000",
-    unit: "0b0000",
-    map: "0c0000",
-    decimal: "2c0100",
-    decimal_f32: "2d0100",
-    decimal_f64: "2e0100",
-    decimal_big: "2f0100",
-    integer: "640000",
-    integer_u8: "650000",
-    integer_u16: "660000",
-    integer_u32: "670000",
-    integer_u64: "680000",
-    integer_u128: "690000",
-    integer_i8: "6a0000",
-    integer_i16: "6b0000",
-    integer_i32: "6c0000",
-    integer_i64: "6d0000",
-    integer_i128: "6e0000",
-    integer_big: "6f0000",
-};
-export const CoreTypeAddressRanges = {
-    small_unsigned_integers: new Set([
-        CoreTypeAddress.integer_u8,
-        CoreTypeAddress.integer_u16,
-        CoreTypeAddress.integer_u32,
-        CoreTypeAddress.integer_u64,
-        CoreTypeAddress.integer_u128,
-    ]),
-    big_unsigned_integers: new Set([CoreTypeAddress.integer_big]),
-    small_signed_integers: new Set([
-        CoreTypeAddress.integer_i8,
-        CoreTypeAddress.integer_i16,
-        CoreTypeAddress.integer_i32,
-        CoreTypeAddress.integer_i64,
-        CoreTypeAddress.integer_i128,
-    ]),
-    big_signed_integers: new Set([CoreTypeAddress.integer_big]),
-    decimals: new Set([
-        CoreTypeAddress.decimal,
-        CoreTypeAddress.decimal_f32,
-        CoreTypeAddress.decimal_f64,
-        CoreTypeAddress.decimal_big,
-    ]),
-};
+/**
+ * @module
+ * @description
+ * This module contains all definitions related to the DIF (DATEX Interchange Format) interfaces of the DATEX runtime.
+ */
+/**
+ * Mapping of DIF type kinds.
+ */
 export const DIFTypeKinds = {
     Structural: 0,
     Reference: 1,
@@ -56,11 +14,16 @@ export const DIFTypeKinds = {
     Unit: 4,
     Function: 5,
 };
+/**
+ * Representation of reference mutability (mutable or immutable) in DIF.
+ */
 export const DIFReferenceMutability = {
     Mutable: 0,
     Immutable: 1,
-    Final: 2,
 };
+/**
+ * Kinds of updates that can be applied to a DIF value.
+ */
 export const DIFUpdateKind = {
     Replace: "replace",
     Push: "push",

package/esm/dif/dif-handler.d.ts

@@ -1,10 +1,27 @@
 import type { JSRuntime, RuntimeDIFHandle } from "../datex-core.js";
 import { Ref } from "../refs/ref.js";
 import { type DIFContainer, type DIFPointerAddress, DIFReferenceMutability, type DIFTypeContainer, type DIFUpdate, type DIFUpdateData, type DIFValue, type DIFValueContainer, type ObserveOptions } from "./definitions.js";
+/**
+ * The DIFHandler class provides methods to interact with the DATEX Core DIF runtime,
+ * including executing Datex scripts, creating and managing pointers, and observing changes.
+ * It includes a local pointer cache to optimize performance and reduce cross-language calls.
+ */
 export declare class DIFHandler {
     #private;
+    /**
+     * Internal property
+     * @returns The map of observers for each pointer address.
+     */
     get _observers(): Map<string, Map<number, (value: DIFUpdateData) => void>>;
+    /**
+     * Internal property
+     * @returns The RuntimeDIFHandle instance.
+     */
     get _handle(): RuntimeDIFHandle;
+    /**
+     * Internal property
+     * @returns The transceiver ID of the DIF client.
+     */
     get _transceiver_id(): number;
     /**
      * Creates a new DIFHandler instance.

package/esm/dif/dif-handler.d.ts.map

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

package/esm/dif/dif-handler.js

@@ -10,18 +10,35 @@ var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (
     return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
 };
 var _DIFHandler_runtime, _DIFHandler_handle, _DIFHandler_transceiver_id, _DIFHandler_cache, _DIFHandler_observers;
-import * as dntShim from "../_dnt.shims.js";
 import { Ref } from "../refs/ref.js";
 import { Endpoint } from "../runtime/special-core-types.js";
-import { CoreTypeAddress, CoreTypeAddressRanges, DIFReferenceMutability, DIFUpdateKind, } from "./definitions.js";
+import { DIFReferenceMutability, DIFUpdateKind, } from "./definitions.js";
+import { CoreTypeAddress, CoreTypeAddressRanges } from "./core.js";
 import { difValueContainerToDisplayString } from "./display.js";
+/**
+ * The DIFHandler class provides methods to interact with the DATEX Core DIF runtime,
+ * including executing Datex scripts, creating and managing pointers, and observing changes.
+ * It includes a local pointer cache to optimize performance and reduce cross-language calls.
+ */
 export class DIFHandler {
+    /**
+     * Internal property
+     * @returns The map of observers for each pointer address.
+     */
     get _observers() {
         return __classPrivateFieldGet(this, _DIFHandler_observers, "f");
     }
+    /**
+     * Internal property
+     * @returns The RuntimeDIFHandle instance.
+     */
     get _handle() {
         return __classPrivateFieldGet(this, _DIFHandler_handle, "f");
     }
+    /**
+     * Internal property
+     * @returns The transceiver ID of the DIF client.
+     */
     get _transceiver_id() {
         return __classPrivateFieldGet(this, _DIFHandler_transceiver_id, "f");
     }
@@ -415,9 +432,9 @@ export class DIFHandler {
      */
     initPointer(ptrAddress, value, mutability, allowedType = null) {
         const refValue = this.wrapJSValueInProxy(value, ptrAddress, allowedType);
-        // if not final, observe  to keep the pointer 'live' and receive updates
+        // if not immutable, observe to keep the pointer 'live' and receive updates
         let observerId = null;
-        if (mutability !== DIFReferenceMutability.Final) {
+        if (mutability !== DIFReferenceMutability.Immutable) {
             observerId = this.observePointerBindDirect(ptrAddress, (update) => {
                 // if source_id is not own transceiver id, handle pointer update
                 if (update.source_id !== __classPrivateFieldGet(this, _DIFHandler_transceiver_id, "f")) {
@@ -467,7 +484,7 @@ export class DIFHandler {
      */
     cacheWrappedPointerValue(address, value, observerId) {
         __classPrivateFieldGet(this, _DIFHandler_cache, "f").set(address, {
-            val: new dntShim.WeakRef(value),
+            val: new WeakRef(value),
             observerId,
         });
         // register finalizer to clean up the cache and free the pointer in the runtime