@hydranium/glsp-server 1.0.0-next.10

package/lib/storage/hydranium-glsp-storage.js

@@ -0,0 +1,634 @@
+/********************************************************************************
+ * Copyright (c) 2023-2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { MarkersReason, SetMarkersAction } from '@eclipse-glsp/protocol';
+import { ActionDispatcher, ClientSessionManager, CommandStack, EditMode, GLSPServerError, Logger as GlspLogger, ModelState, ModelSubmissionHandler, ModelValidator, SOURCE_URI_ARG, SetEditModeAction, TEMPORARY_CLIENT_ID } from '@eclipse-glsp/server';
+import { Debouncer, DisposableCollection } from '@hydranium/protocol';
+import { inject, injectable, optional, postConstruct } from 'inversify';
+import { URI } from '@hydranium/langium';
+import { AstDocument } from '@hydranium/core';
+import { DiagnosticSeverity } from 'vscode-languageserver-types';
+import { HydraniumTypes } from '../state/hydranium-shared-core-services.js';
+import { DEFAULT_SAVE_CONFLICT_POLICY, SaveConflictPolicy } from './save-conflict-policy.js';
+/** Window (ms) over which back-to-back external rebuilds collapse into one resubmit. */
+const EXTERNAL_SUBMIT_DEBOUNCE_MS = 250;
+/**
+ * A leading URI scheme — two or more characters before the colon.
+ *
+ * RFC 3986 permits a single-character scheme, but requiring two is what keeps a
+ * Windows drive letter from reading as one. No scheme in play here is shorter
+ * than two characters, so the heuristic costs nothing and the alternative
+ * mis-parses every Windows path.
+ */
+const URI_SCHEME = /^[a-zA-Z][a-zA-Z\d+\-.]+:/;
+/**
+ * True when an (untyped) LSP diagnostic marks an unrecoverable syntax problem.
+ * Framework-level diagnostics are `unknown` (the shared `ModelService` is typed
+ * `<AstNode, unknown>`), so the shape is narrowed defensively before reading the
+ * Langium `data.code`.
+ */
+function isStructuralDiagnostic(diagnostic) {
+    if (typeof diagnostic !== 'object' || diagnostic === null) {
+        return false;
+    }
+    const candidate = diagnostic;
+    const code = candidate.data?.code;
+    return candidate.severity === DiagnosticSeverity.Error && (code === 'lexing-error' || code === 'parsing-error');
+}
+/**
+ * GLSP source-model storage base shared by all hydranium adopters.
+ * Provides the DI signature, the {@link ClientSessionListener} +
+ * {@link Disposable} lifecycle plumbing (including the
+ * {@link DisposableCollection} drain on session disposal), the
+ * {@link RequestModelAction} / {@link SaveModelAction} URI-extraction
+ * helpers, and the live load/rebuild/resubmit flow with a settled-root
+ * invariant.
+ *
+ * **The settled-root invariant.** Every {@link AbstractHydraniumGlspState.setSourceRoot}
+ * the framework performs captures a root that has reached
+ * `IntegrityService.SettledState` (post-`Linked`, references indexed, on-build
+ * integrity rules applied). The GModel factory therefore always walks a fully
+ * linked + reprojected AST. The flow never captures off a transient mid-rebuild
+ * snapshot — notably it re-`settled()`s in the resubmit path rather than trusting
+ * the `onModelUpdated` event's document, which can arrive while a re-entered
+ * document is still being rebuilt.
+ *
+ * Adopters with richer needs override the seams ({@link isStructurallyBroken},
+ * {@link onParseErrorChanged}, {@link onSourceModelSettled}) rather than the
+ * whole flow, and select a {@link SaveConflictPolicy} via the bound option to
+ * tune how {@link saveSourceModel} reacts to a concurrent edit.
+ *
+ * **Default `saveSourceModel` flow.** Delegates to `ModelService.save`, which
+ * serialises through the language-specific `Serializer` bound at
+ * `services.serializer.Serializer` (resolved per-URI via `ServiceRegistry`),
+ * updates the multi-client text-document store, drives a rebuild, and writes the
+ * result via the `WritableFileSystemProvider`. The bound
+ * {@link SaveConflictPolicy} (default {@link DEFAULT_SAVE_CONFLICT_POLICY},
+ * `overwrite`) decides the based-on-version guard, await-vs-fire-and-forget, and
+ * failure handling.
+ *
+ * **tempId filter.** GLSP's `DefaultGlobalActionProvider` spins up a
+ * throwaway per-diagram-type container with upstream's {@link TEMPORARY_CLIENT_ID}
+ * placeholder purely to enumerate action kinds, then calls `unbindAll()`.
+ * The {@link postConstruct} hook skips registration for that placeholder so
+ * it doesn't linger in {@link ClientSessionManager}.
+ *
+ * **Lifecycle ordering.** `init` runs after DI resolution and parks the
+ * secondary-write-set watch, which outlives any single load.
+ * {@link sessionDisposed} calls {@link dispose}, which drains
+ * {@link toDispose} idempotently. Every transient subscription created in
+ * {@link doLoadSourceModel} is parked on {@link toDispose} so the drain catches
+ * them on client-detach.
+ */
+let HydraniumGlspStorage = class HydraniumGlspStorage {
+    logger;
+    sharedServices;
+    state;
+    sessionManager;
+    actionDispatcher;
+    submissionHandler;
+    commandStack;
+    /**
+     * Optional {@link ModelValidator} whose markers are pushed to the client by
+     * {@link refreshDiagnosticMarkers}. Bound per diagram via
+     * `DiagramModule.bindModelValidator()`; absent (no push) when the head binds
+     * no validator. The framework default is `HydraniumGlspModelValidator`
+     * (LSP diagnostics → markers).
+     */
+    modelValidator;
+    /**
+     * Selected {@link SaveConflictPolicy} for {@link saveSourceModel}. Bind the
+     * {@link SaveConflictPolicy} token in a `DiagramModule` to choose a policy;
+     * left unbound it resolves to {@link DEFAULT_SAVE_CONFLICT_POLICY}
+     * (`overwrite`, last-write-wins). Read via {@link saveConflictPolicy} so the
+     * fallback is applied even when inversify injects `undefined` for an unbound
+     * `@optional()` member.
+     */
+    boundSaveConflictPolicy;
+    /** Disposables created during {@link doLoadSourceModel}; drained on session disposal. */
+    toDispose = new DisposableCollection();
+    /**
+     * Live update subscriptions for the state's SECONDARY documents, keyed by URI.
+     * Reconciled by {@link reconcileSecondarySubscriptions} after every capture.
+     *
+     * Held apart from {@link toDispose} because this set is not fixed for the
+     * session: a document can leave the write set, and its subscription has to go
+     * with it rather than linger until the client detaches.
+     */
+    secondarySubscriptions = new Map();
+    /**
+     * Whether an external resubmit has ever been dispatched. Gates the
+     * keep-the-last-valid-GModel branch, which needs to know a canvas is already
+     * standing — not what is on it. The content comparison that decides whether a
+     * resubmit is worth dispatching lives on the submission handler, which is the
+     * only place that sees operation submits too.
+     */
+    hasSubmittedExternally = false;
+    /**
+     * Trailing-edge debounce for the external resubmit. Rescheduled on each
+     * {@link handleModelUpdated} so back-to-back rebuilds (cascade relinks,
+     * referenced-document edits) collapse into one {@link doUpdateAndSubmit}.
+     * Constructed in {@link init} (the injected {@link ServerSharedServices} —
+     * hence its `Clock` — is available by then); disposed on session teardown.
+     */
+    resubmitDebouncer;
+    /** Latest event document awaiting the debounced resubmit; read by {@link flushResubmit} (last write wins). */
+    pendingResubmitDocument;
+    init() {
+        this.resubmitDebouncer = new Debouncer(this.sharedServices.Clock, () => this.flushResubmit(), {
+            delayMs: EXTERNAL_SUBMIT_DEBOUNCE_MS
+        });
+        if (this.state.clientId === TEMPORARY_CLIENT_ID) {
+            return;
+        }
+        this.sessionManager.addListener(this, this.state.clientId);
+        // Watched for this storage's whole lifetime rather than per load. The load
+        // flow is a documented override point, so a subscription parked there would
+        // go with it — and the write set is discovered by operation handlers, which
+        // run long after any load.
+        this.toDispose.push(this.state.onSecondaryUrisChanged(() => this.reconcileSecondarySubscriptions()));
+    }
+    /**
+     * Default load flow — {@link doLoadSourceModel}. Adopters whose load flow
+     * needs more than the seams allow override this method.
+     */
+    loadSourceModel(action) {
+        return this.doLoadSourceModel(action);
+    }
+    async doLoadSourceModel(action) {
+        const sourceUri = this.getSourceUri(action);
+        const rootUri = this.toSourceModelUri(sourceUri);
+        const modelService = this.sharedServices.model.ModelService;
+        // Open FIRST: a workspace-scanned-but-never-didOpened document rebuilds here,
+        // so the capture below settles on a built root rather than a transient
+        // mid-rebuild one.
+        this.toDispose.push(await modelService.open({ uri: rootUri, clientId: this.state.clientId }));
+        // GLSP's sessionDisposed is unreliable on Theia tab-close; dispose on client
+        // detach so reopens don't accumulate stale onModelUpdated listeners.
+        this.toDispose.push(modelService.onClientClosed(rootUri, this.state.clientId, () => {
+            this.logger.info(`Client detached (${this.state.clientId}) — disposing storage subscriptions for ${rootUri}`);
+            this.dispose();
+        }));
+        // React to external rebuilds: settle-gated capture + debounced/deduped resubmit.
+        this.toDispose.push(modelService.onModelUpdated(rootUri, event => this.handleModelUpdated(rootUri, event)));
+        // Coordinate the command stack's dirty state when another client saves.
+        this.toDispose.push(modelService.onModelSaved(rootUri, event => this.handleModelSaved(event)));
+        // Capture the initial settled root.
+        const document = await modelService.settled(rootUri);
+        await this.captureSettledRoot(rootUri, document);
+    }
+    /**
+     * Capture the initial settled root and apply the initial edit mode. `settled()`
+     * strips diagnostics by phase contract, so the first edit mode is `EDITABLE`;
+     * the first {@link handleModelUpdated} (at `Validated`, with diagnostics) flips
+     * it READONLY if the document has structural parse errors. Edit-mode +
+     * settle-hook actions are dispatched on a macrotask so the initial
+     * `requestModel → setModel` handshake isn't perturbed.
+     */
+    async captureSettledRoot(rootUri, document) {
+        this.state.setSourceRoot(rootUri, document.root);
+        const actions = [...this.refreshEditMode(document), ...this.onSourceModelSettled(document)];
+        if (actions.length > 0) {
+            // Defer through the injectable Clock (not raw setTimeout) so the dispatch is
+            // testable and cancels on session disposal; parked on toDispose for that.
+            this.toDispose.push(this.sharedServices.Clock.setTimer(() => this.actionDispatcher.dispatchAll(actions), 0));
+        }
+    }
+    /**
+     * Reconcile {@link secondarySubscriptions} against the state's current
+     * secondary write set: dispose what left it, subscribe what arrived. Driven by
+     * {@link AbstractHydraniumGlspState.onSecondaryUrisChanged}, so it runs when
+     * the set actually changes rather than at points a caller guessed it might.
+     *
+     * **Secondaries need a subscription of their own because nothing else
+     * notifies for them.** The state records a secondary's version for the
+     * write-side conflict gate and adopter GModel factories re-read secondary
+     * content on every build, but no rebuild of a secondary reaches the primary's
+     * subscription: Langium's affected-documents walk runs from the referenced
+     * document to the referencing one, so a document that references the primary
+     * is downstream of it and editing it correctly affects nothing upstream.
+     * Manufacturing that invalidation to obtain a notification would cost a real
+     * rebuild per edit and make the affected set mean two things — the missing
+     * piece is a subscription, not an invalidation.
+     */
+    reconcileSecondarySubscriptions() {
+        const current = new Set(this.state.secondaryUris);
+        for (const [uri, subscription] of this.secondarySubscriptions) {
+            if (!current.has(uri)) {
+                subscription.dispose();
+                this.secondarySubscriptions.delete(uri);
+            }
+        }
+        for (const uri of current) {
+            if (!this.secondarySubscriptions.has(uri)) {
+                this.secondarySubscriptions.set(uri, this.sharedServices.model.ModelService.onModelUpdated(uri, event => this.handleSecondaryUpdated(uri, event)));
+            }
+        }
+    }
+    /**
+     * React to a rebuild of a SECONDARY document by resubmitting the diagram, so
+     * an external edit to (say) a layout file reaches the canvas.
+     *
+     * Reuses {@link handleModelUpdated}'s authorship guard, and that is the load-
+     * bearing half rather than the resubmit: a diagram interaction that writes a
+     * secondary — a drag persisting bounds to a layout file — comes back through
+     * this listener as the client's own `changed` edit, and resubmitting on it
+     * fights the optimistic client-side move the user is still holding.
+     *
+     * Schedules the PRIMARY's current document, never the secondary's.
+     * {@link doUpdateAndSubmit} reads its event document only for the edit-mode
+     * and structurally-broken decisions, both of which are statements about the
+     * document the canvas edits: passing the secondary's would let a typo in a
+     * layout file flip the canvas READONLY and take the keep-the-last-valid-GModel
+     * branch off an unrelated document's parse state. The pending-document field
+     * is shared with the primary path, so it would poison a concurrently
+     * scheduled primary resubmit too.
+     *
+     * No marker refresh, unlike the primary path: a secondary's diagnostics reach
+     * the client only if an adopter's index registers elements as rendering that
+     * document, and refreshing here unconditionally would add a dispatch to every
+     * drag this client authors — the guard above gates the resubmit, not the
+     * markers.
+     */
+    handleSecondaryUpdated(uri, event) {
+        if (this.disposeIfStale(uri)) {
+            return;
+        }
+        if (this.state.clientId === event.sourceClientId && event.reason === 'changed') {
+            return;
+        }
+        const primary = this.currentPrimaryDocument();
+        if (primary === undefined) {
+            return;
+        }
+        this.logger.debug(`Secondary ${uri} rebuilt by ${event.sourceClientId} (${event.reason}) — scheduling resubmit`);
+        this.scheduleUpdateAndSubmit(primary);
+    }
+    /**
+     * The primary document's current state, or `undefined` when it is not
+     * registered.
+     *
+     * Synchronous by construction — the phase-agnostic lookup door plus the shared
+     * projection — so reacting to a secondary neither waits nor can force a build.
+     * `settled()` is not an alternative: it strips diagnostics by phase contract,
+     * and diagnostics are the reason {@link doUpdateAndSubmit} takes a separate
+     * event document at all.
+     */
+    currentPrimaryDocument() {
+        const document = this.sharedServices.model.ModelService.getDocument(this.state.sourceUri);
+        return document ? AstDocument.from(document) : undefined;
+    }
+    /**
+     * React to an external rebuild reaching `Validated`. Self-cleans if the
+     * session has vanished but this listener leaked (neither `sessionDisposed`
+     * nor `onClientClosed` fired on tab close). Resubmits for any change not
+     * authored by this client's own optimistic `changed` edit, then refreshes
+     * diagnostic markers for every update — including own edits, which skip
+     * the resubmit but can still change diagnostics.
+     */
+    async handleModelUpdated(rootUri, event) {
+        if (this.disposeIfStale(rootUri)) {
+            return;
+        }
+        if (this.state.clientId !== event.sourceClientId || event.reason !== 'changed') {
+            this.scheduleUpdateAndSubmit(event.document);
+        }
+        await this.refreshDiagnosticMarkers();
+    }
+    /**
+     * Whether this storage has outlived its session — disposing it as a side
+     * effect when so. Checked from every subscription entry point because GLSP's
+     * `sessionDisposed` is unreliable on Theia tab-close and `onClientClosed` can
+     * miss it as well; a listener that survives its session otherwise keeps firing
+     * for the life of the process. `context` names the document whose event
+     * surfaced the leak.
+     */
+    disposeIfStale(context) {
+        if (this.sessionManager.getSession(this.state.clientId)) {
+            return false;
+        }
+        this.logger.warn(`Stale storage (clientId=${this.state.clientId} not in ClientSessionManager) — self-disposing ${context}`);
+        this.dispose();
+        return true;
+    }
+    /**
+     * Record the latest document and (re)arm the trailing-edge
+     * {@link resubmitDebouncer}, so a burst of rebuilds runs
+     * {@link doUpdateAndSubmit} once with the most recent document.
+     */
+    scheduleUpdateAndSubmit(document) {
+        this.pendingResubmitDocument = document;
+        this.resubmitDebouncer.schedule();
+    }
+    /**
+     * Debouncer callback: run the resubmit for the latest pending document
+     * against this storage's (invariant) source URI and dispatch the result.
+     * Fire-and-forget — failures are logged, not surfaced to the timer caller.
+     */
+    flushResubmit() {
+        const document = this.pendingResubmitDocument;
+        if (document === undefined) {
+            return;
+        }
+        const rootUri = this.state.sourceUri;
+        this.doUpdateAndSubmit(rootUri, document).then(actions => this.actionDispatcher.dispatchAll(actions), error => this.logger.error(`Update-and-submit failed for ${rootUri}: ${error instanceof Error ? error.message : String(error)}`));
+    }
+    /**
+     * Coordinate the command stack when another client persists the document:
+     * mark our stack clean so the editor doesn't prompt to re-save identical
+     * content. Our own saves already settle the stack through the save flow.
+     */
+    handleModelSaved(event) {
+        if (this.state.clientId !== event.sourceClientId) {
+            this.commandStack.saveIsDone();
+        }
+    }
+    /**
+     * Re-settle to a guaranteed fully-linked + reprojected root, capture it, and
+     * (unless suppressed) resubmit a deduped external GModel. Diagnostics for the
+     * edit-mode decision come from the event document (`settled()` strips them by
+     * phase contract).
+     */
+    async doUpdateAndSubmit(rootUri, eventDocument) {
+        // Settle-gate the capture: never setSourceRoot off the event's possibly-transient
+        // snapshot — the event can arrive while a re-entered document is mid-rebuild.
+        const document = await this.sharedServices.model.ModelService.settled(rootUri);
+        this.state.setSourceRoot(rootUri, document.root);
+        const editModeActions = this.refreshEditMode(eventDocument);
+        // Skip the external submit until the initial requestModel completes; submitting too
+        // early bumps root.revision and the client's stale first computedBounds is dropped,
+        // leaving the canvas empty.
+        if (this.submissionHandler.hasPendingInitialRequest()) {
+            return editModeActions;
+        }
+        // While the AST is structurally broken, keep the last valid GModel so the canvas
+        // doesn't blank mid-typing. READONLY is still flipped for user feedback.
+        if (this.isStructurallyBroken(eventDocument) && this.hasSubmittedExternally) {
+            return editModeActions;
+        }
+        // Read the handler's signature BEFORE submitting and again after: it records
+        // every submission whatever the reason, so an unmoved signature means this
+        // rebuild produced the graph the client already has. Comparing only against
+        // our own previous EXTERNAL submit cannot see that, which is why a drag used
+        // to be answered by an echo of itself — the operation had delivered the
+        // model, and the external comparison had never heard of it.
+        const previousSignature = this.submissionHandler.lastSubmittedSignature;
+        const submitActions = await this.submissionHandler.submitModel('external');
+        if (this.submissionHandler.lastSubmittedSignature === previousSignature) {
+            return editModeActions;
+        }
+        this.hasSubmittedExternally = true;
+        return [...submitActions, ...editModeActions];
+    }
+    /**
+     * Recompute the desired edit mode from the document's structural-error state,
+     * flip {@link AbstractHydraniumGlspState.editMode}, and — only on a transition —
+     * return the {@link onParseErrorChanged} actions. No transition → no actions.
+     */
+    refreshEditMode(document) {
+        const broken = this.isStructurallyBroken(document);
+        const previousEditMode = this.state.editMode;
+        this.state.editMode = broken ? EditMode.READONLY : EditMode.EDITABLE;
+        if (previousEditMode === this.state.editMode) {
+            return [];
+        }
+        return this.onParseErrorChanged(document, broken);
+    }
+    /**
+     * Seam: is the AST structurally broken (lexing/parsing errors)? Drives both
+     * READONLY mode and the GModel resubmit skip — keeping the last valid canvas
+     * instead of blanking it mid-typing. Default: any error-severity diagnostic
+     * carrying a Langium `lexing-error` / `parsing-error` code. Adopters override
+     * to compose additional break reasons.
+     */
+    isStructurallyBroken(document) {
+        return document.diagnostics.some(diagnostic => isStructuralDiagnostic(diagnostic));
+    }
+    /**
+     * Seam: actions to emit when the structural-broken state transitions. Default:
+     * a single {@link SetEditModeAction} toggling READONLY ↔ EDITABLE — editing is
+     * disabled while the syntax is broken but re-enabled once it parses, a sound
+     * generic for any Langium-backed diagram. Adopters override to add or replace
+     * the transition feedback. The {@link AbstractHydraniumGlspState.editMode}
+     * flip itself is owned by {@link refreshEditMode}.
+     */
+    onParseErrorChanged(_document, broken) {
+        return [SetEditModeAction.create(broken ? EditMode.READONLY : EditMode.EDITABLE)];
+    }
+    /**
+     * Seam: extra actions to dispatch right after the initial settled root is
+     * captured (e.g. an adopter-specific status or palette refresh). Default: none.
+     */
+    onSourceModelSettled(_document) {
+        return [];
+    }
+    /** The effective {@link SaveConflictPolicy}: the bound option, or {@link DEFAULT_SAVE_CONFLICT_POLICY} when unbound. */
+    get saveConflictPolicy() {
+        return this.boundSaveConflictPolicy ?? DEFAULT_SAVE_CONFLICT_POLICY;
+    }
+    /**
+     * Default save flow: route through `ModelService.save`. The framework
+     * serialise-and-persist machinery handles serialisation (via the
+     * language-specific `Serializer` bound at `services.serializer.Serializer`),
+     * the multi-client text-document update, the rebuild, and the eventual
+     * `WritableFileSystemProvider.writeFile`.
+     *
+     * The configured {@link SaveConflictPolicy} (see {@link saveConflictPolicy})
+     * decides how a concurrent edit that advanced the document is handled:
+     * - `overwrite` (default): no based-on guard, await, propagate failures —
+     *   last-write-wins, correct for a single-editor head.
+     * - `reject`: guard on the captured `state.version`, await, surface a
+     *   `ConflictError` (and any other failure) to the GLSP save action.
+     * - `drop-and-log`: guard, fire-and-forget, log + swallow failures — a stale
+     *   diagram save is dropped because a concurrent form/code edit already wrote
+     *   the truth, and GLSP exposes no save-failure back-channel.
+     *
+     * Returns `MaybePromise<void>` to match upstream `SourceModelStorage`:
+     * resolves with the persist under `overwrite`/`reject`, returns synchronously
+     * under `drop-and-log`. Adopters that bypass `ModelService` (writing through
+     * `WritableFileSystemProvider` directly) still override the whole method.
+     */
+    saveSourceModel(action) {
+        // Normalised for the same reason the load path is: `SaveModelAction.fileUri`
+        // is client-supplied on a "Save As" and carries whichever form that client
+        // uses. The state fallback is already a URI string, and normalising one is
+        // idempotent, so this only changes the client-supplied branch. Applied at
+        // the call site rather than inside `getFileUri` so that method's contract —
+        // return what the action said — is unchanged for adopters overriding it.
+        const uri = this.toSourceModelUri(this.getFileUri(action));
+        const policy = this.saveConflictPolicy;
+        const persisted = this.sharedServices.model.ModelService.save({
+            uri,
+            model: this.state.sourceRoot,
+            clientId: this.state.clientId,
+            baseVersion: policy.kind === 'overwrite' ? undefined : this.state.version
+        }).then(() => undefined);
+        if (policy.kind === 'drop-and-log') {
+            // Fire-and-forget: the diagram save lost the race to a concurrent edit
+            // that already persisted the truth, so it must neither block the action
+            // nor surface. Log rather than leave an unhandled rejection.
+            persisted.catch(error => this.logger.error(`Save failed for ${uri}: ${error instanceof Error ? error.message : String(error)}`));
+            return undefined;
+        }
+        // overwrite / reject: await; a ConflictError (reject) or any other failure
+        // propagates to GLSP's save-action handler.
+        return persisted;
+    }
+    /**
+     * Normalise GLSP's `sourceUri` — which may be a filesystem PATH or a URI
+     * string — to the URI string the workspace keys documents by.
+     *
+     * **The protocol does not pin which form a client sends, and the clients in
+     * play disagree.** GLSP's VS Code integration sends `document.uri.toString()`;
+     * a headless caller passes the path it already has. Committing to either one
+     * alone is what this method exists to avoid.
+     *
+     * **Getting it wrong does not throw where the mistake is.** `URI.file` given
+     * a URI string treats the whole thing as a path, percent-encodes the scheme,
+     * and yields an `fsPath` with that scheme buried in the middle. Nothing
+     * rejects it; it travels down to the filesystem and surfaces as an ENOENT
+     * several layers from the coercion that produced it.
+     *
+     * Adopters whose client sends a third form override this.
+     */
+    toSourceModelUri(sourceUri) {
+        return URI_SCHEME.test(sourceUri) ? URI.parse(sourceUri).toString() : URI.file(sourceUri).toString();
+    }
+    /**
+     * Extract the source URI from a {@link RequestModelAction}. Throws
+     * {@link GLSPServerError} if the option is missing or non-string —
+     * GLSP's protocol contract requires the client to pass `sourceUri`
+     * when initiating a model request.
+     *
+     * Returns it VERBATIM, in whatever form the client sent;
+     * {@link toSourceModelUri} is what normalises it.
+     */
+    getSourceUri(action) {
+        const sourceUri = action.options?.[SOURCE_URI_ARG];
+        if (typeof sourceUri !== 'string') {
+            throw new GLSPServerError(`Invalid RequestModelAction! Missing argument with key '${SOURCE_URI_ARG}'`);
+        }
+        return sourceUri;
+    }
+    /**
+     * Resolve the URI to save to: prefer the {@link SaveModelAction.fileUri}
+     * (set when the user chose "Save As"), fall back to the
+     * {@link SOURCE_URI_ARG} mirrored into the inherited properties map by
+     * {@link AbstractHydraniumGlspState.setSourceRoot}.
+     *
+     * A save action carries no request id, so a throw here reaches the user as a
+     * toast built from `message`, with `cause` behind its details control. The
+     * two therefore address different readers and must not be collapsed: the
+     * message names what failed in the user's terms, and the cause names which
+     * lookups came back empty for whom. Neither can name the URI — not having
+     * one IS the failure, and both sources are written together, so the typed
+     * `sourceUri` is equally empty whenever this fires.
+     */
+    getFileUri(action) {
+        const uri = action.fileUri ?? this.state.get(SOURCE_URI_ARG);
+        if (!uri) {
+            throw new GLSPServerError('Could not determine where to save this model', `no fileUri on the save action and no ${SOURCE_URI_ARG} in the model state (clientId=${this.state.clientId})`);
+        }
+        return uri;
+    }
+    /**
+     * Recompute the bound {@link ModelValidator}'s markers and push them to the
+     * client as a `SetMarkersAction` — asynchronously and independently of model
+     * rendering. Called from {@link handleModelUpdated} (which fires at `Validated`),
+     * so diagram markers refresh without gating the diagram submit on validation.
+     * No-op when no validator is bound.
+     *
+     * Always dispatched under {@link MarkersReason.BATCH}: the GLSP client's
+     * `ValidationFeedbackEmitter` keys feedback by reason and replaces the prior
+     * set, so re-pushing the full set clears stale markers (an empty set clears
+     * all once the model is valid), and sharing the tool-palette validate
+     * command's `BATCH` reason means the two paths replace rather than duplicate.
+     */
+    async refreshDiagnosticMarkers() {
+        if (!this.modelValidator) {
+            return;
+        }
+        const markers = await this.modelValidator.validate([this.state.root], MarkersReason.BATCH);
+        this.actionDispatcher.dispatch(SetMarkersAction.create(markers, { reason: MarkersReason.BATCH }));
+    }
+    sessionDisposed(_clientSession) {
+        this.dispose();
+    }
+    /**
+     * Cancel any pending resubmit and drain every subscription — those registered
+     * during {@link doLoadSourceModel} and the per-secondary ones, which live
+     * outside {@link toDispose} because they come and go with the write set.
+     * Idempotent.
+     */
+    dispose() {
+        this.resubmitDebouncer?.dispose();
+        for (const subscription of this.secondarySubscriptions.values()) {
+            subscription.dispose();
+        }
+        this.secondarySubscriptions.clear();
+        this.toDispose.dispose();
+    }
+};
+__decorate([
+    inject(GlspLogger),
+    __metadata("design:type", GlspLogger)
+], HydraniumGlspStorage.prototype, "logger", void 0);
+__decorate([
+    inject(HydraniumTypes.SharedCoreServices),
+    __metadata("design:type", Object)
+], HydraniumGlspStorage.prototype, "sharedServices", void 0);
+__decorate([
+    inject(ModelState),
+    __metadata("design:type", Function)
+], HydraniumGlspStorage.prototype, "state", void 0);
+__decorate([
+    inject(ClientSessionManager),
+    __metadata("design:type", Object)
+], HydraniumGlspStorage.prototype, "sessionManager", void 0);
+__decorate([
+    inject(ActionDispatcher),
+    __metadata("design:type", Object)
+], HydraniumGlspStorage.prototype, "actionDispatcher", void 0);
+__decorate([
+    inject(ModelSubmissionHandler),
+    __metadata("design:type", Function)
+], HydraniumGlspStorage.prototype, "submissionHandler", void 0);
+__decorate([
+    inject(CommandStack),
+    __metadata("design:type", Function)
+], HydraniumGlspStorage.prototype, "commandStack", void 0);
+__decorate([
+    inject(ModelValidator),
+    optional(),
+    __metadata("design:type", Object)
+], HydraniumGlspStorage.prototype, "modelValidator", void 0);
+__decorate([
+    inject(SaveConflictPolicy),
+    optional(),
+    __metadata("design:type", Object)
+], HydraniumGlspStorage.prototype, "boundSaveConflictPolicy", void 0);
+__decorate([
+    postConstruct(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], HydraniumGlspStorage.prototype, "init", null);
+HydraniumGlspStorage = __decorate([
+    injectable()
+], HydraniumGlspStorage);
+export { HydraniumGlspStorage };
+//# sourceMappingURL=hydranium-glsp-storage.js.map

package/lib/storage/hydranium-glsp-storage.js.map

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

package/lib/storage/index.d.ts

@@ -0,0 +1,11 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+export * from './hydranium-glsp-storage.js';
+export * from './save-conflict-policy.js';
+//# sourceMappingURL=index.d.ts.map