@hydranium/glsp-server 1.0.0-next.10

package/lib/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC"}

package/lib/storage/index.js

@@ -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.js.map

package/lib/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC"}

package/lib/storage/save-conflict-policy.d.ts

@@ -0,0 +1,56 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/**
+ * How `HydraniumGlspStorage.saveSourceModel` reacts when a concurrent edit has
+ * advanced the document past the version this diagram was last captured at.
+ *
+ * A save spans otherwise-independent choices — whether to guard on the captured
+ * based-on version, whether the GLSP save action awaits the persist, and what
+ * happens on failure. Each arm bundles those into one coherent, nameable policy
+ * so an adopter selects a whole behaviour rather than assembling an incoherent
+ * mix: fire-and-forget plus rethrow would leave an unhandled rejection. It is a
+ * *selection of configuration*, delivered as a bound option (see the
+ * {@link SaveConflictPolicy} symbol) rather than a behaviour hook.
+ */
+export type SaveConflictPolicy = 
+/**
+ * Last-write-wins: no based-on guard, await the persist, propagate any
+ * failure to the GLSP save action. The default; correct for a single-editor
+ * head where nothing races the save.
+ */
+{
+    kind: 'overwrite';
+}
+/**
+ * Guard on the captured version, await the persist, and surface a
+ * `ConflictError` (and any other failure) to the GLSP save action.
+ */
+ | {
+    kind: 'reject';
+}
+/**
+ * Guard on the captured version, fire-and-forget, and log + swallow every
+ * failure. Correct when another editor of the same document may already have
+ * written the truth, so a stale diagram save is benign and must neither
+ * block the action nor surface as an error.
+ */
+ | {
+    kind: 'drop-and-log';
+};
+/** The policy applied when no {@link SaveConflictPolicy} option is bound. */
+export declare const DEFAULT_SAVE_CONFLICT_POLICY: SaveConflictPolicy;
+/**
+ * DI token for the {@link SaveConflictPolicy} option. Bind a constant value in a
+ * `DiagramModule` to select a non-default policy; left unbound,
+ * `HydraniumGlspStorage` falls back to
+ * {@link DEFAULT_SAVE_CONFLICT_POLICY}. Shares its name with the type, the way a
+ * `class` is both a value and a type.
+ */
+export declare const SaveConflictPolicy: unique symbol;
+//# sourceMappingURL=save-conflict-policy.d.ts.map

package/lib/storage/save-conflict-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-conflict-policy.d.ts","sourceRoot":"","sources":["../../src/storage/save-conflict-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB;AAC3B;;;;GAIG;AACD;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE;AACvB;;;GAGG;GACD;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE;AACpB;;;;;GAKG;GACD;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,CAAC;AAE9B,6EAA6E;AAC7E,eAAO,MAAM,4BAA4B,EAAE,kBAA0C,CAAC;AAEtF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,eAA+B,CAAC"}

package/lib/storage/save-conflict-policy.js

@@ -0,0 +1,19 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/** The policy applied when no {@link SaveConflictPolicy} option is bound. */
+export const DEFAULT_SAVE_CONFLICT_POLICY = { kind: 'overwrite' };
+/**
+ * DI token for the {@link SaveConflictPolicy} option. Bind a constant value in a
+ * `DiagramModule` to select a non-default policy; left unbound,
+ * `HydraniumGlspStorage` falls back to
+ * {@link DEFAULT_SAVE_CONFLICT_POLICY}. Shares its name with the type, the way a
+ * `class` is both a value and a type.
+ */
+export const SaveConflictPolicy = Symbol('SaveConflictPolicy');
+//# sourceMappingURL=save-conflict-policy.js.map

package/lib/storage/save-conflict-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-conflict-policy.js","sourceRoot":"","sources":["../../src/storage/save-conflict-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAkClF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,4BAA4B,GAAuB,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AAEtF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC"}

package/lib/submission/hydranium-glsp-submission-handler.d.ts

@@ -0,0 +1,109 @@
+/********************************************************************************
+ * Copyright (c) 2024-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
+ ********************************************************************************/
+import { type Action, type DirtyStateChangeReason, type GModelRootSchema, type LayoutOperation, ModelSubmissionHandler, type SetModelAction } from '@eclipse-glsp/server';
+import { type AstNode, type DocumentState } from '@hydranium/langium';
+import { type AbstractHydraniumGlspState } from '../state/abstract-hydranium-glsp-state.js';
+/**
+ * GLSP {@link ModelSubmissionHandler} base shared by all hydranium adopters.
+ * Wraps {@link submitModel} with an optional document-state ready-gate and
+ * post-action observability logging; preserves the {@link createSetModeAction}
+ * handshake log; exposes a {@link hasPendingInitialRequest} guard adopters
+ * use to suppress external rebuild reactions while the initial-load
+ * `RequestModelAction` is still in flight.
+ *
+ * **What stays adopter-side.** Translation of the source AST to a GModel is
+ * owned by GLSP's existing `GModelFactory` interface, bound separately
+ * per `DiagramModule`. The submission handler is strictly orchestration —
+ * deliberately no `translateToGModel` hook here; adopters wire their per-
+ * diagram-type `GModelFactory` subclass via `bindGModelFactory()`.
+ *
+ * **Hooks.**
+ * - {@link readyEvent} — {@link DocumentState} the {@link submitModel} flow
+ *   awaits via {@link AbstractHydraniumGlspState.ready} before delegating to
+ *   `super.submitModel`. Default {@link IntegrityService.SettledState}
+ *   (`IndexedReferences`) — the GModel-factory walk sees a fully linked AST
+ *   with cross-document references resolved AND post-build integrity rules
+ *   applied. Adopters that need a different phase (earlier `Linked` for
+ *   simpler models, later `Validated` to consume diagnostics, or `undefined`
+ *   to opt out entirely) override this field.
+ * - {@link formatSourceRoot} — adopter-specific AST description used in
+ *   the submit-log line. Default returns `root.$type`.
+ *
+ * Logs through {@link AbstractHydraniumGlspState.logger} (the state's
+ * URI-tagged tracer), so it carries no log-label field of its own.
+ */
+export declare class HydraniumGlspSubmissionHandler<TRoot extends AstNode, TSourceModel = string> extends ModelSubmissionHandler {
+    protected modelState: AbstractHydraniumGlspState<TRoot, TSourceModel>;
+    /**
+     * Document-state gate awaited before {@link submitModel} delegates to
+     * `super.submitModel`. Default {@link IntegrityService.SettledState} so the
+     * GModel factory walks a fully-linked, integrity-settled AST out of the
+     * box. Adopters override (including to `undefined` to opt out entirely)
+     * when their submission flow doesn't need to wait.
+     */
+    protected readyEvent: DocumentState | undefined;
+    /**
+     * True when a `RequestModelAction` has been accepted but the
+     * corresponding {@link SetModelAction} response has not yet been
+     * dispatched. Adopter storage uses this to suppress the "external
+     * submit" rebuild reaction during the initial-load handshake: that
+     * rebuild reaction would call `submitModel('external')`, which rebuilds
+     * the GModel and bumps its revision; once the revision changes, the
+     * client's first `computedBounds` (still carrying the old revision) is
+     * dropped and the initial `SetModelAction` never fires.
+     */
+    hasPendingInitialRequest(): boolean;
+    submitModel(reason?: DirtyStateChangeReason, layout?: LayoutOperation): Promise<Action[]>;
+    /**
+     * Content signature of the last submission, whatever its reason.
+     *
+     * **Tracked across every reason because the CLIENT cannot tell them apart.**
+     * An operation submit and a later external rebuild that produce the same
+     * graph are the same delivery as far as the canvas is concerned, so a
+     * comparison scoped to one reason reports "changed" for a model the client
+     * already has. `undefined` until the first submit.
+     */
+    get lastSubmittedSignature(): string | undefined;
+    protected _lastSubmittedSignature?: string;
+    /**
+     * Serialise the model-bearing actions of a submission into a comparable
+     * signature.
+     *
+     * `requestId` is fresh per action and `revision` is a monotonic `GModelRoot`
+     * counter bumped on every rebuild, so neither reflects content.
+     *
+     * **`SetDirtyStateAction` is dropped whole rather than having its `reason`
+     * stripped by key, and the distinction is load-bearing.** Measured: an
+     * operation submit and the external rebuild echoing it are byte-identical
+     * across the entire GModel and differ only in that action's `reason`, so
+     * leaving it in defeats the comparison outright. Stripping the KEY instead
+     * would reach further than intended — `reason` carries meaning on other
+     * actions, `SetMarkersAction` among them — and would quietly weaken any
+     * later comparison that includes one. Dropping the action also keeps
+     * `isDirty` out, which is correct: dirty state is not part of "is this the
+     * same model", and a genuine dirty-to-clean change must not be suppressed as
+     * a duplicate model.
+     */
+    protected signatureOf(actions: Action[]): string;
+    /**
+     * Logs the {@link SetModelAction} dispatch so the initial
+     * `requestModel → setModel` handshake is observable in the server log
+     * alongside `Submit model` and `ComputedBounds accepted`.
+     */
+    protected createSetModeAction(newRoot: GModelRootSchema): SetModelAction;
+    protected logSubmit(reason: DirtyStateChangeReason | undefined, actions: Action[]): void;
+    /**
+     * Hook for adopter-specific AST description in the submit-log line.
+     * Default returns `root.$type` (or `'none'` when the source root is
+     * undefined). Adopters with multi-shape source roots override to add
+     * per-shape detail.
+     */
+    protected formatSourceRoot(root: TRoot | undefined): string;
+}
+//# sourceMappingURL=hydranium-glsp-submission-handler.d.ts.map

package/lib/submission/hydranium-glsp-submission-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydranium-glsp-submission-handler.d.ts","sourceRoot":"","sources":["../../src/submission/hydranium-glsp-submission-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EACJ,KAAK,MAAM,EACX,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,eAAe,EAEpB,sBAAsB,EAEtB,KAAK,cAAc,EACrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,KAAK,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AAE5F;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBACa,8BAA8B,CAAC,KAAK,SAAS,OAAO,EAAE,YAAY,GAAG,MAAM,CAAE,SAAQ,sBAAsB;IACrH,UAAsC,UAAU,EAAE,0BAA0B,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IAElG;;;;;;OAMG;IACH,SAAS,CAAC,UAAU,EAAE,aAAa,GAAG,SAAS,CAAiC;IAEhF;;;;;;;;;OASG;IACH,wBAAwB,IAAI,OAAO;IAIpB,WAAW,CAAC,MAAM,CAAC,EAAE,sBAAsB,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAcxG;;;;;;;;OAQG;IACH,IAAI,sBAAsB,IAAI,MAAM,GAAG,SAAS,CAE/C;IAED,SAAS,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAE3C;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM;IAOhD;;;;OAIG;cACgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc;IAQjF,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,sBAAsB,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAYxF;;;;;OAKG;IACH,SAAS,CAAC,gBAAgB,CAAC,IAAI,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM;CAG7D"}

package/lib/submission/hydranium-glsp-submission-handler.js

@@ -0,0 +1,157 @@
+/********************************************************************************
+ * Copyright (c) 2024-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 { ModelState, ModelSubmissionHandler, SetDirtyStateAction } from '@eclipse-glsp/server';
+import { IntegrityService } from '@hydranium/core';
+import { inject, injectable } from 'inversify';
+/**
+ * GLSP {@link ModelSubmissionHandler} base shared by all hydranium adopters.
+ * Wraps {@link submitModel} with an optional document-state ready-gate and
+ * post-action observability logging; preserves the {@link createSetModeAction}
+ * handshake log; exposes a {@link hasPendingInitialRequest} guard adopters
+ * use to suppress external rebuild reactions while the initial-load
+ * `RequestModelAction` is still in flight.
+ *
+ * **What stays adopter-side.** Translation of the source AST to a GModel is
+ * owned by GLSP's existing `GModelFactory` interface, bound separately
+ * per `DiagramModule`. The submission handler is strictly orchestration —
+ * deliberately no `translateToGModel` hook here; adopters wire their per-
+ * diagram-type `GModelFactory` subclass via `bindGModelFactory()`.
+ *
+ * **Hooks.**
+ * - {@link readyEvent} — {@link DocumentState} the {@link submitModel} flow
+ *   awaits via {@link AbstractHydraniumGlspState.ready} before delegating to
+ *   `super.submitModel`. Default {@link IntegrityService.SettledState}
+ *   (`IndexedReferences`) — the GModel-factory walk sees a fully linked AST
+ *   with cross-document references resolved AND post-build integrity rules
+ *   applied. Adopters that need a different phase (earlier `Linked` for
+ *   simpler models, later `Validated` to consume diagnostics, or `undefined`
+ *   to opt out entirely) override this field.
+ * - {@link formatSourceRoot} — adopter-specific AST description used in
+ *   the submit-log line. Default returns `root.$type`.
+ *
+ * Logs through {@link AbstractHydraniumGlspState.logger} (the state's
+ * URI-tagged tracer), so it carries no log-label field of its own.
+ */
+let HydraniumGlspSubmissionHandler = class HydraniumGlspSubmissionHandler extends ModelSubmissionHandler {
+    /**
+     * Document-state gate awaited before {@link submitModel} delegates to
+     * `super.submitModel`. Default {@link IntegrityService.SettledState} so the
+     * GModel factory walks a fully-linked, integrity-settled AST out of the
+     * box. Adopters override (including to `undefined` to opt out entirely)
+     * when their submission flow doesn't need to wait.
+     */
+    readyEvent = IntegrityService.SettledState;
+    /**
+     * True when a `RequestModelAction` has been accepted but the
+     * corresponding {@link SetModelAction} response has not yet been
+     * dispatched. Adopter storage uses this to suppress the "external
+     * submit" rebuild reaction during the initial-load handshake: that
+     * rebuild reaction would call `submitModel('external')`, which rebuilds
+     * the GModel and bumps its revision; once the revision changes, the
+     * client's first `computedBounds` (still carrying the old revision) is
+     * dropped and the initial `SetModelAction` never fires.
+     */
+    hasPendingInitialRequest() {
+        return this.requestModelAction !== undefined;
+    }
+    async submitModel(reason, layout) {
+        if (this.readyEvent !== undefined) {
+            // Adopters with on-build integrity rules wait so the GModel-factory walk sees
+            // a settled AST; otherwise the GModel could include elements the build pass is
+            // about to rewrite or remove. ready() also refreshes the captured source root
+            // via onReadyRefreshed.
+            await this.modelState.ready(this.readyEvent);
+        }
+        const actions = await super.submitModel(reason, layout);
+        this._lastSubmittedSignature = this.signatureOf(actions);
+        this.logSubmit(reason, actions);
+        return actions;
+    }
+    /**
+     * Content signature of the last submission, whatever its reason.
+     *
+     * **Tracked across every reason because the CLIENT cannot tell them apart.**
+     * An operation submit and a later external rebuild that produce the same
+     * graph are the same delivery as far as the canvas is concerned, so a
+     * comparison scoped to one reason reports "changed" for a model the client
+     * already has. `undefined` until the first submit.
+     */
+    get lastSubmittedSignature() {
+        return this._lastSubmittedSignature;
+    }
+    _lastSubmittedSignature;
+    /**
+     * Serialise the model-bearing actions of a submission into a comparable
+     * signature.
+     *
+     * `requestId` is fresh per action and `revision` is a monotonic `GModelRoot`
+     * counter bumped on every rebuild, so neither reflects content.
+     *
+     * **`SetDirtyStateAction` is dropped whole rather than having its `reason`
+     * stripped by key, and the distinction is load-bearing.** Measured: an
+     * operation submit and the external rebuild echoing it are byte-identical
+     * across the entire GModel and differ only in that action's `reason`, so
+     * leaving it in defeats the comparison outright. Stripping the KEY instead
+     * would reach further than intended — `reason` carries meaning on other
+     * actions, `SetMarkersAction` among them — and would quietly weaken any
+     * later comparison that includes one. Dropping the action also keeps
+     * `isDirty` out, which is correct: dirty state is not part of "is this the
+     * same model", and a genuine dirty-to-clean change must not be suppressed as
+     * a duplicate model.
+     */
+    signatureOf(actions) {
+        return JSON.stringify(actions.filter(action => !SetDirtyStateAction.is(action)), (key, value) => (key === 'requestId' || key === 'revision' ? undefined : value));
+    }
+    /**
+     * Logs the {@link SetModelAction} dispatch so the initial
+     * `requestModel → setModel` handshake is observable in the server log
+     * alongside `Submit model` and `ComputedBounds accepted`.
+     */
+    createSetModeAction(newRoot) {
+        const action = super.createSetModeAction(newRoot);
+        this.modelState.logger.info(`Dispatching SetModelAction (response to requestModel #${action.responseId || '?'}) — initial model handshake complete`);
+        return action;
+    }
+    logSubmit(reason, actions) {
+        const root = this.modelState.root;
+        const gChildren = root?.children?.length ?? 0;
+        const sourceRoot = this.modelState.sourceRoot;
+        const kinds = actions.map(a => a.kind).join(',');
+        this.modelState.logger.info(`Submit model [reason=${reason ?? 'initial'}, actions=[${kinds}], ` +
+            `gmodel={type=${root?.type ?? 'none'}, children=${gChildren}}, ` +
+            `ast={${this.formatSourceRoot(sourceRoot)}}]`);
+    }
+    /**
+     * Hook for adopter-specific AST description in the submit-log line.
+     * Default returns `root.$type` (or `'none'` when the source root is
+     * undefined). Adopters with multi-shape source roots override to add
+     * per-shape detail.
+     */
+    formatSourceRoot(root) {
+        return root?.$type ?? 'none';
+    }
+};
+__decorate([
+    inject(ModelState),
+    __metadata("design:type", Function)
+], HydraniumGlspSubmissionHandler.prototype, "modelState", void 0);
+HydraniumGlspSubmissionHandler = __decorate([
+    injectable()
+], HydraniumGlspSubmissionHandler);
+export { HydraniumGlspSubmissionHandler };
+//# sourceMappingURL=hydranium-glsp-submission-handler.js.map

package/lib/submission/hydranium-glsp-submission-handler.js.map

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

package/lib/submission/index.d.ts

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * 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-submission-handler.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/submission/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/submission/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,wCAAwC,CAAC"}

package/lib/submission/index.js

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * 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-submission-handler.js';
+//# sourceMappingURL=index.js.map

package/lib/submission/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/submission/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,wCAAwC,CAAC"}

package/lib/testing/glsp-harness.d.ts

@@ -0,0 +1,170 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+import 'reflect-metadata';
+import { type Action, GLSPServer } from '@eclipse-glsp/server';
+import { Logger as GlspLogger, type ServerModule } from '@eclipse-glsp/server/node.js';
+import { ContainerModule, type interfaces } from 'inversify';
+import type { AstNode } from '@hydranium/langium';
+import type { Harness } from '@hydranium/protocol/testing';
+import type { AbstractHydraniumGlspState } from '../state/abstract-hydranium-glsp-state.js';
+/**
+ * Options for {@link makeGlspHarness}.
+ *
+ * The harness drives a REAL {@link GLSPServer} in-process: it composes the
+ * server container the way `startGlspServer` does (framework default app
+ * module + adopter `appModules` + the adopter `serverModule`), but binds
+ * {@link GLSPClientProxy} to a capturing stub instead of a socket-backed
+ * proxy, so every action the server pushes to the client lands in the
+ * harness's `actions` capture. There is no OS socket and no JSON
+ * serialization, so nothing here covers the wire layer.
+ *
+ * `serverModule` + `diagramType` are required; everything else has a
+ * test-friendly default. The adopter's shared services / id provider /
+ * conflict resolver come from `appModules` (typically an
+ * `HydraniumGlspAppModule` subclass) — exactly as in production, so
+ * the harness binds none of them itself.
+ */
+export interface MakeGlspHarnessOptions {
+    /** Adopter {@link ServerModule} with its diagram module(s) pre-configured via `configureDiagramModule`. */
+    readonly serverModule: ServerModule;
+    /** Diagram type id passed to `initializeClientSession`; must match the configured diagram module. */
+    readonly diagramType: string;
+    /**
+     * Adopter Inversify modules loaded AFTER the framework default module
+     * (which binds `InjectionContainer`, GLSP's `Logger`, `LoggerFactory` and
+     * `ActionDispatchScope`). Carries the adopter's
+     * `HydraniumTypes.SharedCoreServices` / `HydraniumTypes.ConflictResolver` /
+     * language-services bindings. Per-language providers come from the diagram
+     * module instead — see `AbstractHydraniumGlspDiagramModule`.
+     */
+    readonly appModules?: ReadonlyArray<ContainerModule>;
+    /**
+     * GLSP logger factory. Default: a silent logger (the harness keeps the
+     * test output clean). Override to capture GLSP framework log lines.
+     */
+    readonly createLogger?: (caller?: string) => GlspLogger;
+    /** `applicationId` for the `initialize` handshake. Default `'test-app'`. */
+    readonly applicationId?: string;
+    /** Client session id used for `initializeClientSession` + every dispatched `ActionMessage`. Default `'test-session'`. */
+    readonly clientSessionId?: string;
+    /**
+     * Adopter-specific client action kinds to forward IN ADDITION to
+     * {@link DEFAULT_CLIENT_ACTION_KINDS}. The server's
+     * `ClientActionForwarder` only forwards declared kinds to the capturing
+     * `GLSPClientProxy`, so list any custom server→client action a test needs
+     * to observe. The standard set covers ordinary round-trips, so most tests
+     * leave this unset.
+     */
+    readonly additionalClientActionKinds?: ReadonlyArray<string>;
+}
+/** Options for {@link GlspHarness.nextModelSubmission}. */
+export interface NextModelSubmissionOptions {
+    /** How long to wait. Defaults to 2000ms. */
+    readonly timeoutMs?: number;
+    /**
+     * Reject on timeout (default `true`) or resolve `undefined` (`false`). Pair
+     * `false` with a short `timeoutMs` — the wait runs to completion in the
+     * passing case.
+     */
+    readonly rejectOnTimeout?: boolean;
+}
+/**
+ * Bundle returned by {@link makeGlspHarness}. Satisfies the uniform
+ * {@link Harness} contract — `state` is the **subject** (the resolved adopter
+ * state under test), `server` + `dispatch`/`nextAction` are the **seam** tests
+ * drive the action round-trip through, `actions` is the **capture** of every
+ * outbound action in arrival order, and `dispose()` is the uniform teardown
+ * hook. `state` / `sessionContainer` are only valid after {@link start} (the
+ * `ModelState` lives in GLSP's per-session child container, created by
+ * `initializeClientSession`).
+ */
+export interface GlspHarness<TState extends AbstractHydraniumGlspState<AstNode, unknown>> extends Harness {
+    /** The real GLSP server under test. */
+    readonly server: GLSPServer;
+    /** The main (app + server) container. */
+    readonly container: interfaces.Container;
+    /** The per-session child container `initializeClientSession` created. Throws if read before {@link start}. */
+    readonly sessionContainer: interfaces.Container;
+    /** The adopter `ModelState` resolved from {@link sessionContainer}. Throws if read before {@link start}. */
+    readonly state: TState;
+    /** Every action the server pushed to the client, in arrival order. Never cleared by the harness. */
+    readonly actions: ReadonlyArray<Action>;
+    /** Drive `initialize` then `initializeClientSession`; resolve once the session container exists. */
+    start(): Promise<void>;
+    /** Drive `server.shutdown()` (disposes client sessions). */
+    shutdown(): Promise<void>;
+    /** Send an action to the server as `{ clientId, action }`. Fire-and-forget (GLSP `process` is `void`). */
+    dispatch(action: Action): void;
+    /**
+     * Resolve with the next captured action whose `kind` matches — an
+     * already-captured-but-unconsumed match resolves immediately, otherwise
+     * waits for the next arrival. Rejects after `timeoutMs` (default 2000) so
+     * a missing action fails fast instead of hanging.
+     */
+    nextAction<T extends Action = Action>(kind: string, timeoutMs?: number): Promise<T>;
+    /**
+     * FAITHFUL fidelity: open `sourceUri` the way a client does — dispatch
+     * `RequestModelAction` with `SOURCE_URI_ARG` — and resolve with the model
+     * the server publishes in response.
+     *
+     * Resolves on **whichever** submission action the diagram produces, because
+     * that depends on its `DiagramConfiguration` rather than on the test:
+     * `SetModelAction` for a server-laid-out diagram, `RequestBoundsAction` for
+     * a client-laid-out one. Awaiting the wrong one is a 2s timeout that names
+     * the wrong subsystem, and a test should not have to know which applies.
+     *
+     * Rejects if nothing is published within `timeoutMs`. Valid only after
+     * {@link start}.
+     */
+    openDocument(sourceUri: string, timeoutMs?: number): Promise<Action>;
+    /**
+     * Resolve with the next action that publishes a model — the settling point
+     * after an operation, since a successful operation re-submits.
+     *
+     * Kind-agnostic for the same reason as {@link openDocument}. Set
+     * `rejectOnTimeout: false` to ask whether a submission happened *at all*.
+     */
+    nextModelSubmission(options?: NextModelSubmissionOptions): Promise<Action | undefined>;
+    /**
+     * LIGHT fidelity: seed the state's source root directly via
+     * `setSourceRoot`, bypassing source-model storage. Valid only after
+     * {@link start}.
+     */
+    seedSourceRoot(uri: string, root: Parameters<TState['setSourceRoot']>[1]): void;
+    /** Idempotent teardown: `server.shutdown()` then `container.unbindAll()`. */
+    dispose(): void;
+}
+/**
+ * The actions that mean "the server published a model".
+ *
+ * Which one arrives depends on the diagram's `DiagramConfiguration`, not on
+ * what the test did: a server-laid-out diagram gets `SetModelAction`, a
+ * client-laid-out one (`needsClientLayout`) gets `RequestBoundsAction`, and a
+ * re-submit after an operation may be `UpdateModelAction`. Tests that only care
+ * *that* the model was published should not have to encode that choice — see
+ * {@link GlspHarness.nextModelSubmission}.
+ *
+ * Exported for the tests that must COUNT submissions rather than await the next
+ * one (asserting that nothing further was published, say). Re-listing the kinds
+ * in such a test is a false-green shape: a kind added here would leave the copy
+ * silently under-counting.
+ */
+export declare const MODEL_SUBMISSION_KINDS: ReadonlyArray<string>;
+/**
+ * Wire a real {@link GLSPServer} in-process and drive a GLSP action
+ * round-trip against it — dispatch an action → operation/request handler →
+ * GModel mutation → response action, captured via a stub
+ * {@link GLSPClientProxy}.
+ *
+ * The harness composes ONE container, collapsing production's parent
+ * app-container / per-connection child split, which exists only to share the
+ * app container across socket connections.
+ */
+export declare function makeGlspHarness<TState extends AbstractHydraniumGlspState<AstNode, unknown>>(options: MakeGlspHarnessOptions): GlspHarness<TState>;
+//# sourceMappingURL=glsp-harness.d.ts.map

package/lib/testing/glsp-harness.d.ts.map

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