@lionweb/delta-protocol-client 0.7.0-beta.21

package/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+## 0.7.0
+
+Initial creation and publication of this package.
+

package/README.md

@@ -0,0 +1,138 @@
+# The `delta-protocol-client` package
+
+[![license](https://img.shields.io/badge/License-Apache%202.0-green.svg?style=flat)
+](./LICENSE)
+
+An NPM package that can be added to a Node.js/NPM codebase as follows:
+
+```shell
+$ npm add @lionweb/delta-protocol-client
+```
+
+This package implements client that complies with the LionWeb delta protocol is implemented as the `LionWebClient` class.
+It *does not* take care of the message transport protocol!
+It implements the API specification as found [here](https://github.com/LionWeb-io/specification/blob/main/delta/delta-api.adoc).
+
+A LionWeb client manages exactly one “model”, meaning a forest of nodes with root nodes having `Concept`s marked as partitions as their classifiers.
+“To manage” means the following things:
+
+1. Adding to and deleting partitions from the model.
+2. Taking care that changes (AKA “deltas”) to the model are propagated as commands to a LionWeb delta protocol-compliant repository.
+3. Taking care that incoming events are applied to the model.
+
+**Note** that no conflict resolution is implemented at any level.
+Concretely, this means:
+
+* Changes to the model are assumed to be conflict-free with any other changes that may have been concurrently through the connected repository.
+  This means, in particular, that any change is assumed to directly lead to an event (coming from the connected repository) that corresponds *exactly* to the change.
+* Any events coming from the connected repository correspond to a change that’s either already made to the model, or can be applied directly and entirely conflict-free to the model.
+
+The client connects with the repository through a WebSocket connection.
+The details of this connection are entirely encapsulated in two `LowLevelClient` and `LowLevelServer` classes.
+These are quite generic (through type parameters for payload types, and configured callback functions), and not at all specific to the LionWeb delta protocol, which makes unit testing these classes quite simple.
+
+
+## Setting up a client
+
+A client can be instantiated as follows:
+
+```typescript
+import { LionWebClient } from "@lionweb/delta-protocol-client"
+
+const lionWebClient = await LionWebClient.create({
+    <parameter object>
+})
+```
+
+The properties of the `<parameter object>` are as follows:
+
+* `clientId`: (required) a string containing the client’s ID, unique within the scope of the repository it connects to.
+  It’s also exposed as a field on the client object.
+* `url`: (required) a string containing the URL of the WebSocket exposed by the LionWeb delta protocol-compliant repository.
+  (The `wsLocalhostUrl` function may be convenient to use — especially in test contexts.)
+* `languageBases`: (required) an array containing the implementations of `ILanguageBase` for the languages of the model managed by the client.
+* `serializationChunk`: (optional) a `LionWebJsonChunk` that represents the initial state of the model managed by the client.
+  If no serialization chunk is provided, the model’s initial state is *empty* — i.e., no roots/partitions.
+* `instantiateDeltaReceiverForwardingTo`: (optional) a function that, given a (so-called) “downstream” delta receiver, returns an “upstream/forwarding” delta receiver that forwards deltas (that result from changes to the managed model) to that downstream delta receiver.
+  This mechanism is used to intercept changes (as deltas) to the model for purposes other than turning these directly into commands to the LionWeb repository.
+  The “upstream/forwarding” delta receiver has the obligations to (eventually) forward all deltas it receives as commands to the LionWeb repository.
+* `semanticLogger`: (optional) a `SemanticLogger` instance that accepts semantic log items (`ISemanticLogItem`), to be able to provide verbosity on what’s going on.
+  (This is predominantly useful for testing.)
+* `lowLevelClientInstantiator`: (optional) a function that instantiates a `LowLevelClient`, given a client ID, an URL, and a `receiveMessageOnClient` function that handles incoming messages.
+  This is intended solely for testing purposes, to implement a mock implementation of a LionWeb repository, without needing an actual, working repository implementation, nor even a WebSocket connection.
+
+During creation of the client, a WebSocket connection with the LionWeb repository is set up, and if a serialization chunk is given, it gets deserialized as the model.
+After creation of the client, it exposes the following data:
+
+* `.clientId`: the client’s ID.
+* `.model`: the managed model, as an array of nodes of `Concept`s that are marked as partition.
+* `.createNode`: a factory function that instantiates a node having the given classifier and ID.
+  The client ensures that that node is wired-up with an appropriate delta receiver that intercepts changes and propagates these as commands to the connected LionWeb repository.
+* `.participationId`: defined after establishing a participation – see below.
+
+The first thing to do before manipulating the model, is to establish a **participation**, which is done as follows:
+
+```typescript
+await lionWebClient.signOn(<query ID>)
+```
+
+Before a participation has been established, the client can’t send any commands to the LionWeb repository, nor receive any events.
+Provided this call succeeds, the ID of the established participation can be retrieved as `lionWebClient.participationId`.
+
+After having established a participation through signing on, the model available through `lionWebClient.model` can be manipulated.
+Adding and deleting partitions is done through the `.addPartition(<partition>)` and `.deletePartition(<partition>)` methods.
+Changes made to the model are propagated to the effective delta receiver – see the explanation of `instantiateDeltaReceiverForwardingTo` above –, and eventually to the LionWeb repository, as commands.
+
+When you are finished with a client, you can disconnect it from the repository as follows:
+
+```typescript
+await lionWebClient.disconnect()
+```
+
+After this, the client can’t send any queries nor commands, nor receive any events anymore.
+
+
+## Hooking up an undo stack
+
+```typescript
+import { DeltaCompositor, deltaReceiverForwardingTo, IDelta } from "@lionweb/class-core"
+import { LionWebClient } from "@lionweb/delta-protocol-client"
+
+const deltas: IDelta[] = []
+let compositorToCreate: DeltaCompositor
+const lionWebClient = await LionWebClient.create({
+    // ...other parameters...
+    instantiateDeltaReceiverForwardingTo: (commandSender) => {
+        compositorToCreate = new DeltaCompositor(deltaReceiverForwardingTo(
+            (delta) => {
+                deltas.push(delta)
+            },
+            commandSender
+        ))
+        return compositorToCreate.upstreamReceiveDelta
+    }
+})
+const compositor = compositorToCreate!
+```
+
+Now composites can be opened and closed as follows:
+
+```typescript
+compositor.openComposite()
+// ...change the model...
+compositor.closeComposite()
+```
+
+The model changes emanating from the statements between `compositor.{open|close}Composite()` are emitted as the `parts` commands of a `CompositeCommand`.
+
+***TODO***
+
+
+## Development
+
+Build this package from source as follows:
+
+```shell
+npm run build
+```
+

package/dist/client.d.ts

@@ -0,0 +1,58 @@
+import { DeltaReceiver, IdMapping, ILanguageBase, INodeBase, NodeBaseFactory } from "@lionweb/class-core";
+import { LionWebId, LionWebJsonChunk } from "@lionweb/json";
+import { Command, Event, QueryMessage, SemanticLogger, SubscribeToPartitionChangesParameters } from "@lionweb/delta-protocol-common";
+import { LowLevelClientInstantiator } from "./low-level-client.js";
+/**
+ * Type def. for parameters – required and optional – for instantiating a {@link LionWebClient LionWeb delta protocol client}.
+ */
+export type LionWebClientParameters = {
+    clientId: LionWebId;
+    url: string;
+    languageBases: ILanguageBase[];
+    lowLevelClientInstantiator: LowLevelClientInstantiator<Event | QueryMessage, Command | QueryMessage>;
+    serializationChunk?: LionWebJsonChunk;
+    instantiateDeltaReceiverForwardingTo?: (commandSender: DeltaReceiver) => DeltaReceiver;
+    semanticLogger?: SemanticLogger;
+};
+/**
+ * Implementation of a LionWeb delta protocol client.
+ */
+export declare class LionWebClient {
+    readonly clientId: LionWebId;
+    model: INodeBase[];
+    readonly idMapping: IdMapping;
+    readonly createNode: NodeBaseFactory;
+    private readonly effectiveReceiveDelta;
+    private readonly lowLevelClient;
+    private _participationId?;
+    get participationId(): string | undefined;
+    private signedOff;
+    private lastReceivedSequenceNumber;
+    private constructor();
+    private readonly queryResolveById;
+    private static readonly nodesByIdFrom;
+    static create({ clientId, url, languageBases, instantiateDeltaReceiverForwardingTo, serializationChunk, semanticLogger, lowLevelClientInstantiator }: LionWebClientParameters): Promise<LionWebClient>;
+    /**
+     * Sets the model held by the client to the given model, discarding the previous one.
+     * No commands will be sent because of this action.
+     */
+    setModel(newModel: INodeBase[]): void;
+    disconnect(): Promise<void>;
+    /**
+     * Makes the query in the sense that the given query request is sent (as a client message),
+     * and that the `resolve` callback of the associated `Promise` is stored so the promise can be resolved,
+     * so that query call can be `await`ed.
+     */
+    private readonly makeQuery;
+    subscribeToChangingPartitions(queryId: LionWebId, parameters: SubscribeToPartitionChangesParameters): Promise<void>;
+    subscribeToPartitionContents(queryId: LionWebId, partition: LionWebId): Promise<LionWebJsonChunk>;
+    unsubscribeFromPartitionContents(queryId: LionWebId, partition: LionWebId): Promise<void>;
+    signOn(queryId: LionWebId, repositoryId: LionWebId): Promise<void>;
+    signOff(queryId: LionWebId): Promise<void>;
+    reconnect(queryId: LionWebId, participationId: LionWebId, lastReceivedSequenceNumber: number): Promise<void>;
+    private static checkWhetherPartition;
+    private checkSignedOn;
+    addPartition(partition: INodeBase): void;
+    deletePartition(partition: INodeBase): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAiBA,OAAO,EAIH,aAAa,EACb,SAAS,EACT,aAAa,EACb,SAAS,EAET,eAAe,EAIlB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAG3D,OAAO,EAOH,OAAO,EAGP,KAAK,EAIL,YAAY,EAGZ,cAAc,EAMd,qCAAqC,EAIxC,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAAkB,0BAA0B,EAAE,MAAM,uBAAuB,CAAA;AAMlF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IAClC,QAAQ,EAAE,SAAS,CAAA;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,aAAa,EAAE,aAAa,EAAE,CAAA;IAC9B,0BAA0B,EAAE,0BAA0B,CAAC,KAAK,GAAG,YAAY,EAAE,OAAO,GAAG,YAAY,CAAC,CAAA;IACpG,kBAAkB,CAAC,EAAE,gBAAgB,CAAA;IACrC,oCAAoC,CAAC,EAAE,CAAC,aAAa,EAAE,aAAa,KAAK,aAAa,CAAA;IACtF,cAAc,CAAC,EAAE,cAAc,CAAA;CAClC,CAAA;AAGD;;GAEG;AACH,qBAAa,aAAa;aAcF,QAAQ,EAAE,SAAS;IAC5B,KAAK,EAAE,SAAS,EAAE;aACT,SAAS,EAAE,SAAS;aACpB,UAAU,EAAE,eAAe;IAC3C,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAjBnC,OAAO,CAAC,gBAAgB,CAAC,CAAW;IAEpC,IAAI,eAAe,uBAElB;IAED,OAAO,CAAC,SAAS,CAAQ;IAEzB,OAAO,CAAC,0BAA0B,CAAK;IAGvC,OAAO;IASP,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA2D;IAE5F,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CACG;WAE3B,MAAM,CAAC,EAAC,QAAQ,EAAE,GAAG,EAAE,aAAa,EAAE,oCAAoC,EAAE,kBAAkB,EAAE,cAAc,EAAE,0BAA0B,EAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,aAAa,CAAC;IA0F1M;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE;IAKxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAKpB;IAEA,6BAA6B,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,qCAAqC,GAAG,OAAO,CAAC,IAAI,CAAC;IASnH,4BAA4B,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAUjG,gCAAgC,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IASzF,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAelE,OAAO,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1C,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,0BAA0B,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAelH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAUpC,OAAO,CAAC,aAAa;IAMrB,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAUxC,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;CAW9C"}

package/dist/client.js

@@ -0,0 +1,239 @@
+// Copyright 2025 TRUMPF Laser SE and other contributors
+//
+// Licensed under the Apache License, Version 2.0 (the "License")
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// SPDX-FileCopyrightText: 2025 TRUMPF Laser SE and other contributors
+// SPDX-License-Identifier: Apache-2.0
+import { allNodesFrom, applyDelta, combinedFactoryFor, IdMapping, nodeBaseDeserializer, PartitionAddedDelta, PartitionDeletedDelta, serializeDelta } from "@lionweb/class-core";
+import { Concept } from "@lionweb/core";
+import { byIdMap } from "@lionweb/ts-utils";
+import { ansi, ClientAppliedEvent, ClientDidNotApplyEventFromOwnCommand, ClientHadProblem, ClientReceivedMessage, ClientSentMessage, deltaAsCommand, DeltaOccurredOnClient, eventToDeltaTranslator, isEvent, isQueryResponse, semanticLoggerFunctionFrom } from "@lionweb/delta-protocol-common";
+import { priorityQueueAcceptor } from "./priority-queue.js";
+const { clientWarning } = ansi;
+/**
+ * Implementation of a LionWeb delta protocol client.
+ */
+export class LionWebClient {
+    get participationId() {
+        return this._participationId;
+    }
+    // TODO  could also get this from the priority queue (which would need to be adapted for that)
+    constructor(clientId, model, idMapping, createNode, effectiveReceiveDelta, lowLevelClient) {
+        this.clientId = clientId;
+        this.model = model;
+        this.idMapping = idMapping;
+        this.createNode = createNode;
+        this.effectiveReceiveDelta = effectiveReceiveDelta;
+        this.lowLevelClient = lowLevelClient;
+        this.signedOff = false;
+        this.lastReceivedSequenceNumber = -1;
+        this.queryResolveById = {};
+        // queries, in order of the specification (§ 6.3):
+        /**
+         * Makes the query in the sense that the given query request is sent (as a client message),
+         * and that the `resolve` callback of the associated `Promise` is stored so the promise can be resolved,
+         * so that query call can be `await`ed.
+         */
+        this.makeQuery = (queryRequest) => new Promise((resolveResponse, rejectResponse) => {
+            this.queryResolveById[queryRequest.queryId] = resolveResponse;
+            this.lowLevelClient.sendMessage(queryRequest)
+                .catch(rejectResponse);
+        });
+    }
+    static async create({ clientId, url, languageBases, instantiateDeltaReceiverForwardingTo, serializationChunk, semanticLogger, lowLevelClientInstantiator }) {
+        const log = semanticLoggerFunctionFrom(semanticLogger);
+        let loading = true;
+        let commandNumber = 0;
+        const issuedCommandIds = [];
+        const commandSender = (delta) => {
+            try {
+                const serializedDelta = serializeDelta(delta);
+                log(new DeltaOccurredOnClient(clientId, serializedDelta));
+                if (!loading) {
+                    const commandId = `cmd-${++commandNumber}`;
+                    const command = deltaAsCommand(delta, commandId);
+                    if (command !== undefined) {
+                        issuedCommandIds.push(commandId); // (register the ID before actually sending the command so that effectively-synchronous tests mimic the actual behavior more reliably)
+                        lowLevelClient.sendMessage(command);
+                        log(new ClientSentMessage(clientId, command));
+                    }
+                }
+            }
+            catch (e) {
+                console.error(`error occurred during serialization of delta: ${e.message}`);
+                console.dir(delta);
+            }
+        };
+        const effectiveReceiveDelta = instantiateDeltaReceiverForwardingTo === undefined ? commandSender : instantiateDeltaReceiverForwardingTo(commandSender);
+        const deserialized = nodeBaseDeserializer(languageBases, effectiveReceiveDelta);
+        const model = serializationChunk === undefined ? [] : deserialized(serializationChunk);
+        const idMapping = new IdMapping(LionWebClient.nodesByIdFrom(model));
+        const eventAsDelta = eventToDeltaTranslator(languageBases, deserialized);
+        loading = false;
+        const processEvent = (event) => {
+            lionWebClient.lastReceivedSequenceNumber = event.sequenceNumber;
+            const commandOriginatingFromSelf = event.originCommands.find(({ commandId }) => issuedCommandIds.indexOf(commandId) > -1);
+            // Note: we can't remove members from issuedCommandIds because there may be multiple events originating fom a single command.
+            if (commandOriginatingFromSelf === undefined) {
+                try {
+                    const delta = eventAsDelta(event, idMapping);
+                    if (delta !== undefined) {
+                        try {
+                            applyDelta(delta);
+                            log(new ClientAppliedEvent(clientId, event));
+                        }
+                        catch (e) {
+                            log(new ClientHadProblem(clientId, `couldn't apply delta of type ${delta.constructor.name} because of: ${e.message}`));
+                        }
+                    }
+                }
+                catch (eventTranslationError) {
+                    log(new ClientHadProblem(clientId, `couldn't translate event to a delta because of: ${eventTranslationError.message}\n\tdelta = ${JSON.stringify(event)}`));
+                }
+            }
+            else {
+                log(new ClientDidNotApplyEventFromOwnCommand(clientId, commandOriginatingFromSelf.commandId));
+            }
+        };
+        const acceptEvent = priorityQueueAcceptor(({ sequenceNumber }) => sequenceNumber, 0, processEvent);
+        const receiveMessageOnClient = (message) => {
+            log(new ClientReceivedMessage(clientId, message));
+            if (isQueryResponse(message)) {
+                const { queryId } = message;
+                if (queryId in lionWebClient.queryResolveById) {
+                    const resolveResponse = lionWebClient.queryResolveById[queryId];
+                    resolveResponse(message);
+                    delete lionWebClient.queryResolveById[queryId];
+                    return; // ~void
+                }
+                console.log(clientWarning(`client received response for a query with ID="${queryId} without having sent a corresponding request - ignoring`));
+                return;
+            }
+            if (isEvent(message)) {
+                acceptEvent(message);
+                return;
+            }
+        };
+        const lowLevelClient = await lowLevelClientInstantiator({ url, clientId, receiveMessageOnClient /* no logging parameter */ });
+        const lionWebClient = new LionWebClient(clientId, model, idMapping, combinedFactoryFor(languageBases, effectiveReceiveDelta), effectiveReceiveDelta, lowLevelClient); // Note: we need this `lionWebClient` constant non-inlined for write-access to lastReceivedSequenceNumber and queryResolveById.
+        return lionWebClient;
+    }
+    /**
+     * Sets the model held by the client to the given model, discarding the previous one.
+     * No commands will be sent because of this action.
+     */
+    setModel(newModel) {
+        this.model = newModel;
+        this.idMapping.reinitializeWith(LionWebClient.nodesByIdFrom(newModel));
+    }
+    async disconnect() {
+        // TODO  abort responses to all queries that the repository hasn't responded to?
+        await this.lowLevelClient.disconnect();
+    }
+    async subscribeToChangingPartitions(queryId, parameters) {
+        await this.makeQuery({
+            messageKind: "SubscribeToChangingPartitionsRequest",
+            queryId,
+            ...parameters,
+            protocolMessages: []
+        });
+    }
+    async subscribeToPartitionContents(queryId, partition) {
+        const response = await this.makeQuery({
+            messageKind: "SubscribeToPartitionContentsRequest",
+            queryId,
+            partition,
+            protocolMessages: []
+        });
+        return response.contents;
+    }
+    async unsubscribeFromPartitionContents(queryId, partition) {
+        await this.makeQuery({
+            messageKind: "UnsubscribeFromPartitionContentsRequest",
+            queryId,
+            partition,
+            protocolMessages: []
+        });
+    }
+    async signOn(queryId, repositoryId) {
+        if (this.signedOff) {
+            return Promise.reject(new Error(`can't sign on after having signed off`));
+        }
+        const response = await this.makeQuery({
+            messageKind: "SignOnRequest",
+            queryId,
+            repositoryId,
+            deltaProtocolVersion: "2025.1",
+            clientId: this.clientId,
+            protocolMessages: []
+        });
+        this._participationId = response.participationId;
+    }
+    async signOff(queryId) {
+        await this.makeQuery({
+            messageKind: "SignOffRequest",
+            queryId,
+            protocolMessages: []
+        });
+        this.signedOff = true;
+        this._participationId = undefined;
+    }
+    async reconnect(queryId, participationId, lastReceivedSequenceNumber) {
+        const response = await this.makeQuery({
+            messageKind: "ReconnectRequest",
+            queryId,
+            participationId,
+            lastReceivedSequenceNumber,
+            protocolMessages: []
+        });
+        this._participationId = participationId;
+        this.lastReceivedSequenceNumber = response.lastReceivedSequenceNumber;
+    }
+    // commands, in order of the specification (§ 6.5):
+    static checkWhetherPartition(node) {
+        const { classifier } = node;
+        if (!(classifier instanceof Concept)) {
+            throw new Error(`node with classifier ${classifier.name} from language ${classifier.language.name} is not an instance of a Concept`);
+        }
+        if (!classifier.partition) {
+            throw new Error(`classifier ${classifier.name} from language ${classifier.language.name} is not a partition`);
+        }
+    }
+    checkSignedOn() {
+        if (this._participationId === undefined) {
+            throw new Error(`client ${this.clientId} can't send a command without being signed on`);
+        }
+    }
+    addPartition(partition) {
+        this.checkSignedOn();
+        LionWebClient.checkWhetherPartition(partition);
+        if (this.model.indexOf(partition) === -1) {
+            this.model.push(partition);
+            this.idMapping.updateWith(partition);
+            this.effectiveReceiveDelta(new PartitionAddedDelta(partition));
+        } // else: ignore; already done
+    }
+    deletePartition(partition) {
+        this.checkSignedOn();
+        const index = this.model.indexOf(partition);
+        if (index > -1) {
+            this.model.splice(index, 1);
+            this.effectiveReceiveDelta(new PartitionDeletedDelta(partition));
+        }
+        else {
+            throw new Error(`node with id "${partition.id}" is not a partition in the current model`);
+        }
+    }
+}
+LionWebClient.nodesByIdFrom = (model) => byIdMap(model.flatMap(allNodesFrom));
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,EAAE;AACF,iEAAiE;AACjE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,EAAE;AACF,sEAAsE;AACtE,sCAAsC;AAEtC,OAAO,EACH,YAAY,EACZ,UAAU,EACV,kBAAkB,EAElB,SAAS,EAGT,oBAAoB,EAEpB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACjB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAE3C,OAAO,EACH,IAAI,EACJ,kBAAkB,EAClB,oCAAoC,EACpC,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EAEjB,cAAc,EACd,qBAAqB,EAErB,sBAAsB,EACtB,OAAO,EACP,eAAe,EAKf,0BAA0B,EAS7B,MAAM,gCAAgC,CAAA;AAEvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAE3D,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,CAAA;AAiB9B;;GAEG;AACH,MAAM,OAAO,aAAa;IAItB,IAAI,eAAe;QACf,OAAO,IAAI,CAAC,gBAAgB,CAAA;IAChC,CAAC;IAKD,8FAA8F;IAE9F,YACoB,QAAmB,EAC5B,KAAkB,EACT,SAAoB,EACpB,UAA2B,EAC1B,qBAAoC,EACpC,cAAsD;QALvD,aAAQ,GAAR,QAAQ,CAAW;QAC5B,UAAK,GAAL,KAAK,CAAa;QACT,cAAS,GAAT,SAAS,CAAW;QACpB,eAAU,GAAV,UAAU,CAAiB;QAC1B,0BAAqB,GAArB,qBAAqB,CAAe;QACpC,mBAAc,GAAd,cAAc,CAAwC;QAXnE,cAAS,GAAG,KAAK,CAAA;QAEjB,+BAA0B,GAAG,CAAC,CAAC,CAAA;QAYtB,qBAAgB,GAAyD,EAAE,CAAA;QA8G5F,kDAAkD;QAElD;;;;WAIG;QACc,cAAS,GAAG,CAAC,YAA0B,EAAyB,EAAE,CAC/E,IAAI,OAAO,CAAC,CAAC,eAAe,EAAE,cAAc,EAAE,EAAE;YAC5C,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,eAAe,CAAA;YAC7D,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,YAAY,CAAC;iBACxC,KAAK,CAAC,cAAc,CAAC,CAAA;QAC9B,CAAC,CAAC,CAAA;IA5HH,CAAC;IAOJ,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAC,QAAQ,EAAE,GAAG,EAAE,aAAa,EAAE,oCAAoC,EAAE,kBAAkB,EAAE,cAAc,EAAE,0BAA0B,EAA0B;QAC7K,MAAM,GAAG,GAAG,0BAA0B,CAAC,cAAc,CAAC,CAAA;QAEtD,IAAI,OAAO,GAAG,IAAI,CAAA;QAClB,IAAI,aAAa,GAAG,CAAC,CAAA;QACrB,MAAM,gBAAgB,GAAa,EAAE,CAAA;QACrC,MAAM,aAAa,GAAkB,CAAC,KAAK,EAAE,EAAE;YAC3C,IAAI,CAAC;gBACD,MAAM,eAAe,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;gBAC7C,GAAG,CAAC,IAAI,qBAAqB,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAA;gBACzD,IAAI,CAAC,OAAO,EAAE,CAAC;oBACX,MAAM,SAAS,GAAG,OAAO,EAAE,aAAa,EAAE,CAAA;oBAC1C,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;oBAChD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;wBACxB,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA,CAAE,sIAAsI;wBACxK,cAAc,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;wBACnC,GAAG,CAAC,IAAI,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAA;oBACjD,CAAC;gBACL,CAAC;YACL,CAAC;YAAC,OAAO,CAAU,EAAE,CAAC;gBAClB,OAAO,CAAC,KAAK,CAAC,iDAAkD,CAAW,CAAC,OAAO,EAAE,CAAC,CAAA;gBACtF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YACtB,CAAC;QACL,CAAC,CAAA;QACD,MAAM,qBAAqB,GAAG,oCAAoC,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,oCAAoC,CAAC,aAAa,CAAC,CAAA;QAEtJ,MAAM,YAAY,GAAG,oBAAoB,CAAC,aAAa,EAAE,qBAAqB,CAAC,CAAA;QAC/E,MAAM,KAAK,GAAG,kBAAkB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAA;QACtF,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAA;QACnE,MAAM,YAAY,GAAG,sBAAsB,CAAC,aAAa,EAAE,YAAY,CAAC,CAAA;QACxE,OAAO,GAAG,KAAK,CAAA;QAEf,MAAM,YAAY,GAAG,CAAC,KAAY,EAAE,EAAE;YAClC,aAAa,CAAC,0BAA0B,GAAG,KAAK,CAAC,cAAc,CAAA;YAC/D,MAAM,0BAA0B,GAAG,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YACzH,6HAA6H;YAC7H,IAAI,0BAA0B,KAAK,SAAS,EAAE,CAAC;gBAC3C,IAAI,CAAC;oBACD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;oBAC5C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;wBACtB,IAAI,CAAC;4BACD,UAAU,CAAC,KAAK,CAAC,CAAA;4BACjB,GAAG,CAAC,IAAI,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAA;wBAChD,CAAC;wBAAC,OAAO,CAAC,EAAE,CAAC;4BACT,GAAG,CAAC,IAAI,gBAAgB,CAAC,QAAQ,EAAE,gCAAgC,KAAK,CAAC,WAAW,CAAC,IAAI,gBAAiB,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;wBACrI,CAAC;oBACL,CAAC;gBACL,CAAC;gBAAC,OAAO,qBAAqB,EAAE,CAAC;oBAC7B,GAAG,CAAC,IAAI,gBAAgB,CAAC,QAAQ,EAAE,mDAAoD,qBAA+B,CAAC,OAAO,eAAe,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;gBAC1K,CAAC;YACL,CAAC;iBAAM,CAAC;gBACJ,GAAG,CAAC,IAAI,oCAAoC,CAAC,QAAQ,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC,CAAA;YACjG,CAAC;QACL,CAAC,CAAA;QAED,MAAM,WAAW,GAAG,qBAAqB,CAAQ,CAAC,EAAC,cAAc,EAAC,EAAE,EAAE,CAAC,cAAc,EAAE,CAAC,EAAE,YAAY,CAAC,CAAA;QAEvG,MAAM,sBAAsB,GAAG,CAAC,OAA6B,EAAE,EAAE;YAC7D,GAAG,CAAC,IAAI,qBAAqB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAA;YACjD,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAA;gBAC3B,IAAI,OAAO,IAAI,aAAa,CAAC,gBAAgB,EAAE,CAAC;oBAC5C,MAAM,eAAe,GAAG,aAAa,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAA;oBAC/D,eAAe,CAAC,OAAO,CAAC,CAAA;oBACxB,OAAO,aAAa,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAA;oBAC9C,OAAM,CAAE,QAAQ;gBACpB,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,iDAAiD,OAAO,yDAAyD,CAAC,CAAC,CAAA;gBAC7I,OAAM;YACV,CAAC;YACD,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnB,WAAW,CAAC,OAAO,CAAC,CAAA;gBACpB,OAAM;YACV,CAAC;QACL,CAAC,CAAA;QAED,MAAM,cAAc,GAAG,MACnB,0BAA0B,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,sBAAsB,CAAC,0BAA0B,EAAE,CAAC,CAAA;QAEpG,MAAM,aAAa,GAAG,IAAI,aAAa,CACnC,QAAQ,EACR,KAAK,EACL,SAAS,EACT,kBAAkB,CAAC,aAAa,EAAE,qBAAqB,CAAC,EACxD,qBAAqB,EACrB,cAAc,CACjB,CAAA,CAAC,+HAA+H;QACjI,OAAO,aAAa,CAAA;IACxB,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,QAAqB;QAC1B,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAA;QACrB,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,aAAa,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC1E,CAAC;IAED,KAAK,CAAC,UAAU;QACZ,gFAAgF;QAChF,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,CAAA;IAC1C,CAAC;IAiBD,KAAK,CAAC,6BAA6B,CAAC,OAAkB,EAAE,UAAiD;QACrG,MAAM,IAAI,CAAC,SAAS,CAAC;YACjB,WAAW,EAAE,sCAAsC;YACnD,OAAO;YACP,GAAG,UAAU;YACb,gBAAgB,EAAE,EAAE;SACiB,CAAC,CAAA;IAC9C,CAAC;IAED,KAAK,CAAC,4BAA4B,CAAC,OAAkB,EAAE,SAAoB;QACvE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC;YAClC,WAAW,EAAE,qCAAqC;YAClD,OAAO;YACP,SAAS;YACT,gBAAgB,EAAE,EAAE;SACgB,CAAyC,CAAA;QACjF,OAAO,QAAQ,CAAC,QAAQ,CAAA;IAC5B,CAAC;IAED,KAAK,CAAC,gCAAgC,CAAC,OAAkB,EAAE,SAAoB;QAC3E,MAAM,IAAI,CAAC,SAAS,CAAC;YACjB,WAAW,EAAE,yCAAyC;YACtD,OAAO;YACP,SAAS;YACT,gBAAgB,EAAE,EAAE;SACoB,CAAC,CAAA;IACjD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAkB,EAAE,YAAuB;QACpD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC,CAAA;QAC7E,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC;YAClC,WAAW,EAAE,eAAe;YAC5B,OAAO;YACP,YAAY;YACZ,oBAAoB,EAAE,QAAQ;YAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,gBAAgB,EAAE,EAAE;SACN,CAAmB,CAAA;QACrC,IAAI,CAAC,gBAAgB,GAAG,QAAQ,CAAC,eAAe,CAAA;IACpD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAkB;QAC5B,MAAM,IAAI,CAAC,SAAS,CAAC;YACjB,WAAW,EAAE,gBAAgB;YAC7B,OAAO;YACP,gBAAgB,EAAE,EAAE;SACL,CAAC,CAAA;QACpB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;QACrB,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAA;IACrC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAkB,EAAE,eAA0B,EAAE,0BAAkC;QAC9F,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC;YAClC,WAAW,EAAE,kBAAkB;YAC/B,OAAO;YACP,eAAe;YACf,0BAA0B;YAC1B,gBAAgB,EAAE,EAAE;SACH,CAAsB,CAAA;QAC3C,IAAI,CAAC,gBAAgB,GAAG,eAAe,CAAA;QACvC,IAAI,CAAC,0BAA0B,GAAG,QAAQ,CAAC,0BAA0B,CAAA;IACzE,CAAC;IAGD,mDAAmD;IAE3C,MAAM,CAAC,qBAAqB,CAAC,IAAe;QAChD,MAAM,EAAC,UAAU,EAAC,GAAG,IAAI,CAAA;QACzB,IAAI,CAAC,CAAC,UAAU,YAAY,OAAO,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,wBAAwB,UAAU,CAAC,IAAI,kBAAkB,UAAU,CAAC,QAAQ,CAAC,IAAI,kCAAkC,CAAC,CAAA;QACxI,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,cAAc,UAAU,CAAC,IAAI,kBAAkB,UAAU,CAAC,QAAQ,CAAC,IAAI,qBAAqB,CAAC,CAAA;QACjH,CAAC;IACL,CAAC;IAEO,aAAa;QACjB,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,QAAQ,+CAA+C,CAAC,CAAA;QAC3F,CAAC;IACL,CAAC;IAED,YAAY,CAAC,SAAoB;QAC7B,IAAI,CAAC,aAAa,EAAE,CAAA;QACpB,aAAa,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAA;QAC9C,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YAC1B,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;YACpC,IAAI,CAAC,qBAAqB,CAAC,IAAI,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAA;QAClE,CAAC,CAAC,6BAA6B;IACnC,CAAC;IAED,eAAe,CAAC,SAAoB;QAChC,IAAI,CAAC,aAAa,EAAE,CAAA;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QAC3C,IAAI,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;YAC3B,IAAI,CAAC,qBAAqB,CAAC,IAAI,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAA;QACpE,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,KAAK,CAAC,iBAAiB,SAAS,CAAC,EAAE,2CAA2C,CAAC,CAAA;QAC7F,CAAC;IACL,CAAC;;AAjOuB,2BAAa,GAAG,CAAC,KAAkB,EAAE,EAAE,CAC3D,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,AADH,CACG"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { LionWebClient } from "./client.js";
+export type { LionWebClientParameters } from "./client.js";
+export { noOpLowLevelClientLogger } from "./log-types.js";
+export type { MessageReceivedOnClient, MessageSentToServer, TextualLogItem, LowLevelClientLogItem, LowLevelClientLogger } from "./log-types.js";
+export type { LowLevelClient, LowLevelClientInstantiator, LowLevelClientLoggingParameters, LowLevelClientParameters } from "./low-level-client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAE1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AACzD,YAAY,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,cAAc,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAE/I,YAAY,EAAE,cAAc,EAAE,0BAA0B,EAAE,+BAA+B,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/index.js

@@ -0,0 +1,19 @@
+// Copyright 2025 TRUMPF Laser SE and other contributors
+//
+// Licensed under the Apache License, Version 2.0 (the "License")
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// SPDX-FileCopyrightText: 2025 TRUMPF Laser SE and other contributors
+// SPDX-License-Identifier: Apache-2.0
+export { LionWebClient } from "./client.js";
+export { noOpLowLevelClientLogger } from "./log-types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,EAAE;AACF,iEAAiE;AACjE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,EAAE;AACF,sEAAsE;AACtE,sCAAsC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAG3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/log-types.d.ts

@@ -0,0 +1,20 @@
+export type MessageReceivedOnClient<TMessageForClient> = {
+    receivedOnClient: TMessageForClient;
+};
+export type MessageSentToServer<TMessageForServer> = {
+    sentToServer: TMessageForServer;
+};
+export type TextualLogItem = {
+    message: string;
+    error?: boolean;
+};
+/**
+ * Type def. for activity logged by a low-level client.
+ */
+export type LowLevelClientLogItem<TMessageForClient, TMessageForServer> = TextualLogItem | MessageReceivedOnClient<TMessageForClient> | MessageSentToServer<TMessageForServer>;
+export type LowLevelClientLogger<TMessageForClient, TMessageForServer> = (logItem: LowLevelClientLogItem<TMessageForClient, TMessageForServer>) => void;
+/**
+ * Implementation of {@link LowLevelClientLogger} that does nothing.
+ */
+export declare const noOpLowLevelClientLogger: LowLevelClientLogger<unknown, unknown>;
+//# sourceMappingURL=log-types.d.ts.map

package/dist/log-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-types.d.ts","sourceRoot":"","sources":["../src/log-types.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,uBAAuB,CAAC,iBAAiB,IAAI;IACrD,gBAAgB,EAAE,iBAAiB,CAAA;CACtC,CAAA;AAED,MAAM,MAAM,mBAAmB,CAAC,iBAAiB,IAAI;IACjD,YAAY,EAAE,iBAAiB,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,CAAC,iBAAiB,EAAE,iBAAiB,IAChE,cAAc,GACd,uBAAuB,CAAC,iBAAiB,CAAC,GAC1C,mBAAmB,CAAC,iBAAiB,CAAC,CAAA;AAG5C,MAAM,MAAM,oBAAoB,CAAC,iBAAiB,EAAE,iBAAiB,IACjE,CAAC,OAAO,EAAE,qBAAqB,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,KAAK,IAAI,CAAA;AAGlF;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAoB,CAAA"}

package/dist/log-types.js

@@ -0,0 +1,21 @@
+// Copyright 2025 TRUMPF Laser SE and other contributors
+//
+// Licensed under the Apache License, Version 2.0 (the "License")
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// SPDX-FileCopyrightText: 2025 TRUMPF Laser SE and other contributors
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Implementation of {@link LowLevelClientLogger} that does nothing.
+ */
+export const noOpLowLevelClientLogger = (_logItem) => { };
+//# sourceMappingURL=log-types.js.map

package/dist/log-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-types.js","sourceRoot":"","sources":["../src/log-types.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,EAAE;AACF,iEAAiE;AACjE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,EAAE;AACF,sEAAsE;AACtE,sCAAsC;AA4BtC;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAA2C,CAAC,QAAQ,EAAE,EAAE,GAAE,CAAC,CAAA"}

package/dist/low-level-client.d.ts

@@ -0,0 +1,36 @@
+import { LionWebId } from "@lionweb/json";
+import { TextualLogger } from "@lionweb/delta-protocol-common";
+/**
+ * Type def. for a client that's able to send messages.
+ */
+export type LowLevelClient<TMessageToServer> = {
+    sendMessage: (message: TMessageToServer) => Promise<void>;
+    disconnect: () => Promise<void>;
+};
+/**
+ * Type def. for parameters *required* for instantiating a {@link LowLevelClient low-level client}.
+ */
+export type LowLevelClientParameters<TMessageForClient> = {
+    /** The URL of the WebSocket server to connect to. */
+    url: string;
+    /** An ID for the created client. */
+    clientId: LionWebId;
+    /** A function that's called with a received message. */
+    receiveMessageOnClient: (message: TMessageForClient) => void;
+};
+/**
+ * Type def. for optional parameters for a {@link LowLevelClient low-level client} regarding logging.
+ */
+export type LowLevelClientLoggingParameters<TMessageForClient, TMessageToServer> = {
+    /** An optional {@link TextualLogger textual logger}. */
+    textualLogger?: TextualLogger;
+    /** An optional message logger. */
+    messageLogger?: (message: (TMessageForClient | TMessageToServer)) => void;
+};
+/**
+ * Type def. for functions that instantiate a {@link LowLevelClient}.
+ *
+ * Note that the instantiator implementation is responsible for passing logging parameters.
+ */
+export type LowLevelClientInstantiator<TMessageForClient, TMessageToServer> = (lowLevelClientParameters: LowLevelClientParameters<TMessageForClient>) => Promise<LowLevelClient<TMessageToServer>>;
+//# sourceMappingURL=low-level-client.d.ts.map

package/dist/low-level-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"low-level-client.d.ts","sourceRoot":"","sources":["../src/low-level-client.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAG9D;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,gBAAgB,IAAI;IAC3C,WAAW,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACzD,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAClC,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,CAAC,iBAAiB,IAAI;IACtD,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAA;IACX,oCAAoC;IACpC,QAAQ,EAAE,SAAS,CAAA;IACnB,wDAAwD;IACxD,sBAAsB,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAA;CAE/D,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,+BAA+B,CAAC,iBAAiB,EAAE,gBAAgB,IAAI;IAC/E,wDAAwD;IACxD,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,kCAAkC;IAClC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,iBAAiB,GAAG,gBAAgB,CAAC,KAAK,IAAI,CAAA;CAC5E,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,CAAC,iBAAiB,EAAE,gBAAgB,IACtE,CAAC,wBAAwB,EAAE,wBAAwB,CAAC,iBAAiB,CAAC,KAClE,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAAA"}

package/dist/low-level-client.js

@@ -0,0 +1,18 @@
+// Copyright 2025 TRUMPF Laser SE and other contributors
+//
+// Licensed under the Apache License, Version 2.0 (the "License")
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// SPDX-FileCopyrightText: 2025 TRUMPF Laser SE and other contributors
+// SPDX-License-Identifier: Apache-2.0
+export {};
+//# sourceMappingURL=low-level-client.js.map

package/dist/low-level-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"low-level-client.js","sourceRoot":"","sources":["../src/low-level-client.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,EAAE;AACF,iEAAiE;AACjE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,EAAE;AACF,sEAAsE;AACtE,sCAAsC"}

package/dist/priority-queue.d.ts

@@ -0,0 +1,22 @@
+import { Procedure } from "@lionweb/delta-protocol-common";
+/**
+ * @return the index at which `t` should be inserted to keep the array `ts` sorted in the numeric order determined by applying `valueFunc` to its members.
+ * In case `t` has the same numeric value as existing members of `ts`, the lowest index having that numeric value is returned.
+ * (Exported for testing purposes only!)
+ */
+export declare const insertionIndex: <T>(ts: T[], valueFunc: (t: T) => number, tToInsert: T) => number;
+/**
+ * Type def. for a function that takes a `t` and either processes it directly if `t` has the next expected priority,
+ * or enqueues it for later processing.
+ *
+ * (Technically, this can be considered to be a modified {@link https://en.wikipedia.org/wiki/Priority_queue *“monotone priority queue”*}.)
+ */
+export type PriorityQueueAcceptor<T> = (t: T) => void;
+/**
+ * @return a {@link PriorityQueueAcceptor} function that accepts instances of `T`,
+ * passing them to the `process` function in (min-max) priority order,
+ * as computed by the `priorityFunc`, starting with the `firstPriority`.
+ * @throws an {@link Error error} when a `T` is passed with a priority that has already been processed.
+ */
+export declare const priorityQueueAcceptor: <T>(priorityFunc: (t: T) => number, firstPriority: number, process: Procedure<T>) => PriorityQueueAcceptor<T>;
+//# sourceMappingURL=priority-queue.d.ts.map

package/dist/priority-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"priority-queue.d.ts","sourceRoot":"","sources":["../src/priority-queue.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAG1D;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,EAAE,WAAW,CAAC,KAAG,MAmBtF,CAAA;AAGD;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,CAAA;AAErD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,EAAE,eAAe,MAAM,EAAE,SAAS,SAAS,CAAC,CAAC,CAAC,KAAG,qBAAqB,CAAC,CAAC,CAgC9I,CAAA"}