@hydranium/glsp-server 1.0.0-next.31 → 1.0.0-next.315

package/lib/launcher/hydranium-glsp-server.d.ts

@@ -6,33 +6,60 @@
  *
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
-import { type ClientSession, DefaultGLSPServer, type RequestAction, type ResponseAction } from '@eclipse-glsp/server';
+import { type ActionMessage, type ClientSession, DefaultGLSPServer, type InitializeClientSessionParameters, RequestAction, type ResponseAction } from '@eclipse-glsp/server';
 /**
  * The GLSP server the framework binds in place of upstream's
  * {@link DefaultGLSPServer}, so a failed REQUEST reaches its reader with the
- * text the thrower wrote.
+ * text the thrower wrote, and a diagram whose connection ends keeps its unsaved
+ * text for the release grace (see {@link shutdown}).
  *
  * **What breaks without it.** Upstream projects a failing request's detail as
  * `error.cause?.toString()` whenever the error is a {@link GLSPServerError},
  * and that one value feeds both the server log and the client's
  * {@link RejectAction}. A {@link GLSPServerError} carrying no `cause` therefore
- * reaches no reader at all — not the toast, not the details pane, not the log —
- * while a plain `Error` survives, because the other branch reads the error
- * itself. The typed error is the trap, and it is the one upstream's own
+ * reaches its readers as `undefined` — the log line and the client's
+ * action-dispatcher warning both print it — while a plain `Error` survives,
+ * because the other branch reads the error itself. The typed error is the trap,
+ * and it is the one upstream's own
  * `getOrThrow` helper raises: that helper's signature cannot pass a `cause`, so
  * an adopter using the sanctioned helper has no fix available on their side.
  * Restating the cause at each throw site is the alternative, and it costs
  * every adopter a rule they must know and cannot apply to `getOrThrow`.
  *
- * Only the REQUEST path needs this. Non-request actions fail through
- * upstream's `handleProcessError`, which reads `message` directly.
+ * Only the REQUEST path needs this. A non-request action fails through
+ * {@link handleProcessError}, which reads `message` directly; it and
+ * {@link process} are lifted for their logging only.
  *
- * Adopters who bind their own GLSP server should extend this class rather than
- * {@link DefaultGLSPServer}; the framework's server-container override replaces
- * whatever the adopter's `ServerModule` bound, so a subclass of upstream's
- * server would be discarded.
+ * An adopter who binds their own GLSP server extends this class rather than
+ * {@link DefaultGLSPServer}: the framework's server-container override keeps a
+ * server that extends this one and replaces any other, so a subclass of
+ * upstream's server is discarded, and with it both behaviours.
  */
 export declare class HydraniumGlspServer extends DefaultGLSPServer {
+    /**
+     * End each diagram's client session as lost rather than closed, before
+     * upstream disposes the sessions, so its unsaved text waits out the release
+     * grace for the client to reconnect. A shutdown is how the client's
+     * connection ending reaches the server; a client that stops on purpose
+     * shuts the server down the same way, and its diagrams are held as well.
+     */
+    shutdown(): void;
+    /**
+     * End a session the id still has before initializing it again. A model
+     * source initializes once, so a second initialize under one id is a new
+     * widget, a reopened tab whose closed predecessor's dispose never arrived;
+     * upstream would hand it that stale session.
+     */
+    initializeClientSession(params: InitializeClientSessionParameters): Promise<void>;
+    /**
+     * Lifted from `@eclipse-glsp/server` 2.7.0's {@link DefaultGLSPServer.process}:
+     * each action is logged at `debug` rather than `info`, and an action that
+     * fails once its session has ended, which disposing the session's dispatcher
+     * does to every action it holds, is logged at `debug` and told to no client,
+     * since the one that sent it has gone. The accompanying test pins upstream's
+     * source.
+     */
+    process(message: ActionMessage): void;
     /**
      * The detail projected into the client's {@link RejectAction} and the server
      * log when a request fails.
@@ -44,11 +71,29 @@ export declare class HydraniumGlspServer extends DefaultGLSPServer {
      */
     protected requestFailureDetail(error: unknown): string | undefined;
     /**
-     * Lifted verbatim from `@eclipse-glsp/server` 2.7.0's
+     * Lifted from `@eclipse-glsp/server` 2.7.0's
+     * {@link DefaultGLSPServer.handleProcessError}, logging the failure once
+     * with {@link logActionFailure} where upstream logs the action and the
+     * reason as two lines.
+     *
+     * The notification is upstream's, text and all, and this body does not
+     * track upstream: the accompanying test pins upstream's source as it does
+     * for {@link handleClientRequest}.
+     */
+    protected handleProcessError(message: ActionMessage, reason: unknown): void;
+    /**
+     * Lifted from `@eclipse-glsp/server` 2.7.0's
      * {@link DefaultGLSPServer.handleClientRequest}, with the detail computation
-     * delegated to {@link requestFailureDetail}. Nothing else here — the
-     * timeout branch, the response dispatch, the nested send-failure handling —
-     * relates to that fallback.
+     * delegated to {@link requestFailureDetail}, the failure logged once with
+     * its stack, a request that fails once its session has ended logged at
+     * `debug` and answered to no client, as {@link process} treats an action,
+     * and one addition: a failed {@link RequestSaveModelAction} also
+     * raises the error notification a failed `SaveModelAction` raises, through
+     * {@link handleProcessError}, which then logs it instead. A rejection
+     * reaches only the client's log, and a Theia host only logs a rejected save,
+     * so without it a save that failed would tell the user nothing. Nothing else
+     * here — the timeout branch, the response dispatch, the nested send-failure
+     * handling — relates to either.
      *
      * **This body does not track upstream.** A release that changes request
      * handling would silently not apply, on the path every request takes. There

package/lib/launcher/hydranium-glsp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hydranium-glsp-server.d.ts","sourceRoot":"","sources":["../../src/launcher/hydranium-glsp-server.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EACJ,KAAK,aAAa,EAClB,iBAAiB,EAGjB,KAAK,aAAa,EAClB,KAAK,cAAc,EACrB,MAAM,sBAAsB,CAAC;AAG9B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBACa,mBAAoB,SAAQ,iBAAiB;IACvD;;;;;;;;OAQG;IACH,SAAS,CAAC,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS;IAOlE;;;;;;;;;;;;;OAaG;cACsB,mBAAmB,CACzC,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,EACrC,QAAQ,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;CAuBlB"}
+{"version":3,"file":"hydranium-glsp-server.d.ts","sourceRoot":"","sources":["../../src/launcher/hydranium-glsp-server.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EACJ,KAAK,aAAa,EAElB,KAAK,aAAa,EAClB,iBAAiB,EAEjB,KAAK,iCAAiC,EAGtC,aAAa,EACb,KAAK,cAAc,EAErB,MAAM,sBAAsB,CAAC;AAM9B;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBACa,mBAAoB,SAAQ,iBAAiB;IACvD;;;;;;OAMG;IACM,QAAQ,IAAI,IAAI,CAUxB;IAED;;;;;OAKG;IACY,uBAAuB,CAAC,MAAM,EAAE,iCAAiC,GAAG,OAAO,CAAC,IAAI,CAAC,CAW/F;IAED;;;;;;;OAOG;IACM,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAqB7C;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAKjE;IAED;;;;;;;;;OASG;IACH,UAAmB,kBAAkB,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAUnF;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,UAAyB,mBAAmB,CACzC,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,EACrC,QAAQ,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAsCf;CACH"}

package/lib/launcher/hydranium-glsp-server.js

@@ -12,34 +12,108 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     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;
 };
-import { DefaultGLSPServer, GLSPServerError, RejectAction } from '@eclipse-glsp/server';
+import { ClientAction, DefaultGLSPServer, GLSPServerError, MessageAction, RejectAction, RequestAction, SourceModelStorage } from '@eclipse-glsp/server';
+import { describeErrorWithStack, RequestSaveModelAction } from '@hydranium/protocol';
 import { injectable } from 'inversify';
+import { logActionFailure } from '../command/diagram-edit-dropped-error.js';
+import { HydraniumGlspStorage } from '../storage/hydranium-glsp-storage.js';
 /**
  * The GLSP server the framework binds in place of upstream's
  * {@link DefaultGLSPServer}, so a failed REQUEST reaches its reader with the
- * text the thrower wrote.
+ * text the thrower wrote, and a diagram whose connection ends keeps its unsaved
+ * text for the release grace (see {@link shutdown}).
  *
  * **What breaks without it.** Upstream projects a failing request's detail as
  * `error.cause?.toString()` whenever the error is a {@link GLSPServerError},
  * and that one value feeds both the server log and the client's
  * {@link RejectAction}. A {@link GLSPServerError} carrying no `cause` therefore
- * reaches no reader at all — not the toast, not the details pane, not the log —
- * while a plain `Error` survives, because the other branch reads the error
- * itself. The typed error is the trap, and it is the one upstream's own
+ * reaches its readers as `undefined` — the log line and the client's
+ * action-dispatcher warning both print it — while a plain `Error` survives,
+ * because the other branch reads the error itself. The typed error is the trap,
+ * and it is the one upstream's own
  * `getOrThrow` helper raises: that helper's signature cannot pass a `cause`, so
  * an adopter using the sanctioned helper has no fix available on their side.
  * Restating the cause at each throw site is the alternative, and it costs
  * every adopter a rule they must know and cannot apply to `getOrThrow`.
  *
- * Only the REQUEST path needs this. Non-request actions fail through
- * upstream's `handleProcessError`, which reads `message` directly.
+ * Only the REQUEST path needs this. A non-request action fails through
+ * {@link handleProcessError}, which reads `message` directly; it and
+ * {@link process} are lifted for their logging only.
  *
- * Adopters who bind their own GLSP server should extend this class rather than
- * {@link DefaultGLSPServer}; the framework's server-container override replaces
- * whatever the adopter's `ServerModule` bound, so a subclass of upstream's
- * server would be discarded.
+ * An adopter who binds their own GLSP server extends this class rather than
+ * {@link DefaultGLSPServer}: the framework's server-container override keeps a
+ * server that extends this one and replaces any other, so a subclass of
+ * upstream's server is discarded, and with it both behaviours.
  */
 let HydraniumGlspServer = class HydraniumGlspServer extends DefaultGLSPServer {
+    /**
+     * End each diagram's client session as lost rather than closed, before
+     * upstream disposes the sessions, so its unsaved text waits out the release
+     * grace for the client to reconnect. A shutdown is how the client's
+     * connection ending reaches the server; a client that stops on purpose
+     * shuts the server down the same way, and its diagrams are held as well.
+     */
+    shutdown() {
+        for (const session of this.clientSessions.values()) {
+            const storage = session.container.isBound(SourceModelStorage) ? session.container.get(SourceModelStorage) : undefined;
+            if (storage instanceof HydraniumGlspStorage) {
+                storage.dispose('lost');
+            }
+            else if (storage) {
+                this.logger.debug(`Shutdown leaves ending ${session.id} to its storage, which is not a HydraniumGlspStorage`);
+            }
+        }
+        super.shutdown();
+    }
+    /**
+     * End a session the id still has before initializing it again. A model
+     * source initializes once, so a second initialize under one id is a new
+     * widget, a reopened tab whose closed predecessor's dispose never arrived;
+     * upstream would hand it that stale session.
+     */
+    async initializeClientSession(params) {
+        if (!this.clientSessions.has(params.clientSessionId)) {
+            return super.initializeClientSession(params);
+        }
+        this.logger.debug(`Client session ${params.clientSessionId} initialized again before its dispose arrived; ending the old one`);
+        // Not awaited before the initialize: both drop and set the session before
+        // their first await, and the model request that follows is read without
+        // waiting for this one to settle.
+        const disposed = this.disposeClientSession({ clientSessionId: params.clientSessionId });
+        const initialized = super.initializeClientSession(params);
+        await Promise.all([disposed, initialized]);
+    }
+    /**
+     * Lifted from `@eclipse-glsp/server` 2.7.0's {@link DefaultGLSPServer.process}:
+     * each action is logged at `debug` rather than `info`, and an action that
+     * fails once its session has ended, which disposing the session's dispatcher
+     * does to every action it holds, is logged at `debug` and told to no client,
+     * since the one that sent it has gone. The accompanying test pins upstream's
+     * source.
+     */
+    process(message) {
+        this.validateServerInitialized();
+        this.logger.debug(`process [action=${message.action.kind}, clientId=${message.clientId}]`);
+        const clientSessionId = message.clientId;
+        const clientSession = this.clientSessions.get(clientSessionId);
+        if (!clientSession) {
+            throw new Error(`No client session has been initialized for client id: ${clientSessionId}`);
+        }
+        const action = message.action;
+        ClientAction.mark(action);
+        if (RequestAction.is(action)) {
+            void this.handleClientRequest(clientSession, action, message.clientId);
+            return;
+        }
+        clientSession.actionDispatcher.dispatch(action).catch((error) => {
+            if (this.clientSessions.get(clientSessionId) === clientSession) {
+                void this.handleProcessError(message, error);
+            }
+            else {
+                this.logger.debug(`Action '${action.kind}' ended with its session: ${describeErrorWithStack(error)}`);
+            }
+        });
+    }
     /**
      * The detail projected into the client's {@link RejectAction} and the server
      * log when a request fails.
@@ -56,11 +130,39 @@ let HydraniumGlspServer = class HydraniumGlspServer extends DefaultGLSPServer {
         return error === undefined || error === null ? undefined : String(error);
     }
     /**
-     * Lifted verbatim from `@eclipse-glsp/server` 2.7.0's
+     * Lifted from `@eclipse-glsp/server` 2.7.0's
+     * {@link DefaultGLSPServer.handleProcessError}, logging the failure once
+     * with {@link logActionFailure} where upstream logs the action and the
+     * reason as two lines.
+     *
+     * The notification is upstream's, text and all, and this body does not
+     * track upstream: the accompanying test pins upstream's source as it does
+     * for {@link handleClientRequest}.
+     */
+    handleProcessError(message, reason) {
+        const kind = message.action.kind;
+        logActionFailure(this.logger, message.action, reason);
+        let errorMsg = `Could not process action: '${kind}`;
+        let details = stringifyAsUpstream(reason);
+        if (reason instanceof GLSPServerError) {
+            details = stringifyAsUpstream(reason.cause);
+            errorMsg = reason.message;
+        }
+        this.sendToClient({ clientId: message.clientId, action: MessageAction.create(errorMsg, { severity: 'ERROR', details }) });
+    }
+    /**
+     * Lifted from `@eclipse-glsp/server` 2.7.0's
      * {@link DefaultGLSPServer.handleClientRequest}, with the detail computation
-     * delegated to {@link requestFailureDetail}. Nothing else here — the
-     * timeout branch, the response dispatch, the nested send-failure handling —
-     * relates to that fallback.
+     * delegated to {@link requestFailureDetail}, the failure logged once with
+     * its stack, a request that fails once its session has ended logged at
+     * `debug` and answered to no client, as {@link process} treats an action,
+     * and one addition: a failed {@link RequestSaveModelAction} also
+     * raises the error notification a failed `SaveModelAction` raises, through
+     * {@link handleProcessError}, which then logs it instead. A rejection
+     * reaches only the client's log, and a Theia host only logs a rejected save,
+     * so without it a save that failed would tell the user nothing. Nothing else
+     * here — the timeout branch, the response dispatch, the nested send-failure
+     * handling — relates to either.
      *
      * **This body does not track upstream.** A release that changes request
      * handling would silently not apply, on the path every request takes. There
@@ -79,17 +181,34 @@ let HydraniumGlspServer = class HydraniumGlspServer extends DefaultGLSPServer {
             }
         }
         catch (error) {
+            if (this.clientSessions.get(clientSession.id) !== clientSession) {
+                this.logger.debug(`Request '${action.kind}' (${action.requestId}) ended with its session: ${describeErrorWithStack(error)}`);
+                return;
+            }
             const detail = this.requestFailureDetail(error);
-            this.logger.error(`Failed to handle request '${action.kind}' (${action.requestId}):`, detail);
+            const isSave = action.kind === RequestSaveModelAction.KIND;
+            if (!isSave) {
+                this.logger.error(`Failed to handle request '${action.kind}' (${action.requestId}): ${describeErrorWithStack(error)}`);
+            }
+            // Inside the guard: `process` does not await this method, so a throw
+            // here would be an unhandled rejection.
             try {
-                const reject = RejectAction.create(`Failed to handle request '${action.kind}' (${action.requestId})`, {
-                    responseId: action.requestId,
-                    detail
-                });
-                this.sendResponseToClient(clientId, reject);
+                try {
+                    const reject = RejectAction.create(`Failed to handle request '${action.kind}' (${action.requestId})`, {
+                        responseId: action.requestId,
+                        detail
+                    });
+                    this.sendResponseToClient(clientId, reject);
+                }
+                finally {
+                    // Also when the reject could not be sent, since this logs the save's failure.
+                    if (isSave) {
+                        this.handleProcessError({ clientId, action }, error);
+                    }
+                }
             }
             catch (sendError) {
-                this.logger.error(`Failed to send rejection for request '${action.requestId}':`, sendError);
+                this.logger.error(`Failed to send rejection for request '${action.requestId}': ${describeErrorWithStack(sendError)}`);
             }
         }
     }
@@ -98,4 +217,8 @@ HydraniumGlspServer = __decorate([
     injectable()
 ], HydraniumGlspServer);
 export { HydraniumGlspServer };
+/** `value?.toString?.()`, as upstream projects a reason into a notification's details. */
+function stringifyAsUpstream(value) {
+    return value?.toString?.();
+}
 //# sourceMappingURL=hydranium-glsp-server.js.map

package/lib/launcher/hydranium-glsp-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"hydranium-glsp-server.js","sourceRoot":"","sources":["../../src/launcher/hydranium-glsp-server.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;;;;;;;AAElF,OAAO,EAEJ,iBAAiB,EACjB,eAAe,EACf,YAAY,EAGd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEI,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,iBAAiB;IACvD;;;;;;;;OAQG;IACO,oBAAoB,CAAC,KAAc;QAC1C,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;YACpC,OAAO,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClG,CAAC;QACD,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;;;;;;;OAaG;IACgB,KAAK,CAAC,mBAAmB,CACzC,aAA4B,EAC5B,MAAqC,EACrC,QAAgB;QAEhB,IAAI,CAAC;YACF,MAAM,QAAQ,GACX,MAAM,CAAC,OAAO,KAAK,SAAS;gBACzB,CAAC,CAAC,MAAM,aAAa,CAAC,gBAAgB,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC;gBACjF,CAAC,CAAC,MAAM,aAAa,CAAC,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC7D,IAAI,QAAQ,EAAE,CAAC;gBACZ,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACjD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;YAChD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,SAAS,IAAI,EAAE,MAAM,CAAC,CAAC;YAC9F,IAAI,CAAC;gBACF,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,6BAA6B,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,SAAS,GAAG,EAAE;oBACnG,UAAU,EAAE,MAAM,CAAC,SAAS;oBAC5B,MAAM;iBACR,CAAC,CAAC;gBACH,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC/C,CAAC;YAAC,OAAO,SAAkB,EAAE,CAAC;gBAC3B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,MAAM,CAAC,SAAS,IAAI,EAAE,SAAS,CAAC,CAAC;YAC/F,CAAC;QACJ,CAAC;IACJ,CAAC;CACH,CAAA;AA1DY,mBAAmB;IAD/B,UAAU,EAAE;GACA,mBAAmB,CA0D/B"}
+{"version":3,"file":"hydranium-glsp-server.js","sourceRoot":"","sources":["../../src/launcher/hydranium-glsp-server.ts"],"names":[],"mappings":"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"}

package/lib/launcher/index.d.ts

@@ -9,4 +9,6 @@
 export * from './glsp-app-module.js';
 export * from './abstract-hydranium-glsp-diagram-module.js';
 export * from './hydranium-glsp-server.js';
+export * from './drop-notifications-to-gone-client.js';
+export * from './glsp-connection-logger.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/launcher/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,sBAAsB,CAAC;AACrC,cAAc,6CAA6C,CAAC;AAI5D,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/launcher/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,sBAAsB,CAAC;AACrC,cAAc,6CAA6C,CAAC;AAI5D,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wCAAwC,CAAC;AACvD,cAAc,6BAA6B,CAAC"}

package/lib/launcher/index.js

@@ -12,11 +12,12 @@ export * from './abstract-hydranium-glsp-diagram-module.js';
 // rather than upstream's — the server-container override discards a subclass of
 // `DefaultGLSPServer`.
 export * from './hydranium-glsp-server.js';
+export * from './drop-notifications-to-gone-client.js';
+export * from './glsp-connection-logger.js';
 // The socket bringup lives in `@hydranium/glsp-server/node` and the worker
 // bringup in `@hydranium/glsp-server/browser`, not here: each pulls the
 // upstream build for its platform, which the portable `.` entry must stay free
-// of. `glsp-framework-overrides.js` and `glsp-server-overrides.js` are
-// deliberately NOT re-exported — they are the bindings those two bringups share,
-// reached by relative import, and an adopter composing a container by hand wants
-// the launcher rather than its internals.
+// of. The container overrides those two bringups share stay unexported, reached
+// by relative import: an adopter composing a container by hand wants the
+// launcher rather than its internals.
 //# sourceMappingURL=index.js.map

package/lib/launcher/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/launcher/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,sBAAsB,CAAC;AACrC,cAAc,6CAA6C,CAAC;AAC5D,+EAA+E;AAC/E,gFAAgF;AAChF,uBAAuB;AACvB,cAAc,4BAA4B,CAAC;AAC3C,2EAA2E;AAC3E,wEAAwE;AACxE,+EAA+E;AAC/E,uEAAuE;AACvE,iFAAiF;AACjF,iFAAiF;AACjF,0CAA0C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/launcher/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,sBAAsB,CAAC;AACrC,cAAc,6CAA6C,CAAC;AAC5D,+EAA+E;AAC/E,gFAAgF;AAChF,uBAAuB;AACvB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wCAAwC,CAAC;AACvD,cAAc,6BAA6B,CAAC;AAC5C,2EAA2E;AAC3E,wEAAwE;AACxE,+EAA+E;AAC/E,gFAAgF;AAChF,yEAAyE;AACzE,sCAAsC"}

package/lib/logging/glsp-client-logger.d.ts

@@ -17,11 +17,11 @@ import { type LogThreshold } from '@hydranium/protocol';
 export interface GlspClientLoggerOptions extends LspLoggerOptions {
     /**
      * Per-instance NARROWING of the framework threshold. Omit it — the default
-     * tracks `Logger.getLevel()` live, which is what makes one
+     * tracks the framework thresholds live, which is what makes one
      * `HYDRANIUM_LOG_LEVEL` / one LSP setting govern GLSP output too.
      *
      * It can only narrow, never widen, and that is not a policy choice:
-     * `AbstractLogger.send` gates every emission on the process-wide threshold
+     * `AbstractLogger.send` gates every emission on `Logger.isLevelEnabled`
      * before it reaches the output channel, so a value more verbose than the
      * global is silently ineffective. Set it only to make ONE component quieter
      * than the rest.
@@ -48,8 +48,8 @@ export declare function glspLogLevelOf(threshold: LogThreshold): LogLevel;
  * GLSP-specific concerns layered on top of {@link LspLogger}:
  *
  * - A {@link logLevel} field, because GLSP's `Logger` contract declares one.
- *   **It tracks the framework's process-wide threshold by default**, resolving
- *   `Logger.getLevel()` through {@link glspLogLevelOf} on every read — so
+ *   **It tracks the framework's thresholds by default**, resolving them
+ *   through {@link glspLogLevelOf} on every read — so
  *   `HYDRANIUM_LOG_LEVEL`, the LSP log-level setting and the Theia preference
  *   all reach GLSP output without a second knob. Assigning the field (or
  *   passing `logLevel`) pins an explicit per-instance NARROWING; see
@@ -81,7 +81,11 @@ export declare class GlspClientLogger extends LspLogger implements GlspLogger {
      */
     protected logLevelOverride?: LogLevel;
     constructor(services: ServerSharedServices, options?: GlspClientLoggerOptions);
-    /** GLSP's `Logger.logLevel` contract; the framework threshold unless pinned. */
+    /**
+     * GLSP's `Logger.logLevel` contract; unless pinned, the more verbose of
+     * `Logger.getLevel()` and `Logger.getFileLevel()`. The process threshold
+     * alone drops GLSP lines a log file with its own threshold asks for.
+     */
     get logLevel(): LogLevel;
     set logLevel(level: LogLevel);
     /** GLSP's `Logger.caller` contract; reads {@link LspLogger.component}. */
@@ -94,7 +98,7 @@ export declare class GlspClientLogger extends LspLogger implements GlspLogger {
     protected enabled(level: LogLevel): boolean;
     /** Concatenate a message with its varargs, formatting each via {@link formatParam}. */
     protected combine(message: string, params: readonly unknown[]): string;
-    /** Format a single param: errors → `message\nstack`; everything else → JSON.stringify(p, undefined, 4). */
+    /** Format a single param: errors → their stack and causes; everything else → JSON.stringify(p, undefined, 4). */
     protected formatParam(param: unknown): string;
     /**
      * Override of {@link LspLogger.derive} that carries the per-instance

package/lib/logging/glsp-client-logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glsp-client-logger.d.ts","sourceRoot":"","sources":["../../src/logging/glsp-client-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,MAAM,IAAI,UAAU,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC9F,OAAO,EAAU,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEhE;;;;GAIG;AACH,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC9D;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,YAAY,GAAG,QAAQ,CAchE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,gBAAiB,SAAQ,SAAU,YAAW,UAAU;IAClE;;;;;;;OAOG;IACH,SAAS,CAAC,gBAAgB,CAAC,EAAE,QAAQ,CAAC;gBAE1B,QAAQ,EAAE,oBAAoB,EAAE,OAAO,GAAE,uBAA4B;IAKjF,gFAAgF;IAChF,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,IAAI,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAE3B;IAED,0EAA0E;IAC1E,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAE/B;IAEQ,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAOjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAOjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAOlD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAO3D,sEAAsE;IACtE,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAI3C,uFAAuF;IACvF,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM;IAItE,2GAA2G;IAC3G,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAW7C;;;;;;;;OAQG;cACgB,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAIpD"}
+{"version":3,"file":"glsp-client-logger.d.ts","sourceRoot":"","sources":["../../src/logging/glsp-client-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,MAAM,IAAI,UAAU,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC9F,OAAO,EAA+C,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAErG;;;;GAIG;AACH,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC9D;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,YAAY,GAAG,QAAQ,CAchE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,gBAAiB,SAAQ,SAAU,YAAW,UAAU;IAClE;;;;;;;OAOG;IACH,SAAS,CAAC,gBAAgB,CAAC,EAAE,QAAQ,CAAC;IAEtC,YAAY,QAAQ,EAAE,oBAAoB,EAAE,OAAO,GAAE,uBAA4B,EAGhF;IAED;;;;OAIG;IACH,IAAI,QAAQ,IAAI,QAAQ,CAKvB;IAED,IAAI,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAE3B;IAED,0EAA0E;IAC1E,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAE/B;IAEQ,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAKzD;IAEQ,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAKzD;IAEQ,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAK1D;IAEQ,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAK1D;IAED,sEAAsE;IACtE,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAE1C;IAED,uFAAuF;IACvF,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAErE;IAED,iHAAiH;IACjH,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAS5C;IAED;;;;;;;;OAQG;IACH,UAAmB,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGjD;CACH"}

package/lib/logging/glsp-client-logger.js

@@ -8,7 +8,7 @@
  ********************************************************************************/
 import { LogLevel } from '@eclipse-glsp/server';
 import { LspLogger } from '@hydranium/core';
-import { Logger } from '@hydranium/protocol';
+import { describeErrorWithStack, LEVEL_ORDER, Logger } from '@hydranium/protocol';
 /**
  * Map the framework's {@link LogThreshold} onto GLSP's numeric enum.
  *
@@ -43,8 +43,8 @@ export function glspLogLevelOf(threshold) {
  * GLSP-specific concerns layered on top of {@link LspLogger}:
  *
  * - A {@link logLevel} field, because GLSP's `Logger` contract declares one.
- *   **It tracks the framework's process-wide threshold by default**, resolving
- *   `Logger.getLevel()` through {@link glspLogLevelOf} on every read — so
+ *   **It tracks the framework's thresholds by default**, resolving them
+ *   through {@link glspLogLevelOf} on every read — so
  *   `HYDRANIUM_LOG_LEVEL`, the LSP log-level setting and the Theia preference
  *   all reach GLSP output without a second knob. Assigning the field (or
  *   passing `logLevel`) pins an explicit per-instance NARROWING; see
@@ -79,9 +79,16 @@ export class GlspClientLogger extends LspLogger {
         super(services, options);
         this.logLevelOverride = options.logLevel;
     }
-    /** GLSP's `Logger.logLevel` contract; the framework threshold unless pinned. */
+    /**
+     * GLSP's `Logger.logLevel` contract; unless pinned, the more verbose of
+     * `Logger.getLevel()` and `Logger.getFileLevel()`. The process threshold
+     * alone drops GLSP lines a log file with its own threshold asks for.
+     */
     get logLevel() {
-        return this.logLevelOverride ?? glspLogLevelOf(Logger.getLevel());
+        const level = Logger.getLevel();
+        const fileLevel = Logger.getFileLevel();
+        const widest = fileLevel && LEVEL_ORDER[fileLevel] > LEVEL_ORDER[level] ? fileLevel : level;
+        return this.logLevelOverride ?? glspLogLevelOf(widest);
     }
     set logLevel(level) {
         this.logLevelOverride = level;
@@ -122,10 +129,10 @@ export class GlspClientLogger extends LspLogger {
     combine(message, params) {
         return params.length === 0 ? message : `${message} ${params.map(p => this.formatParam(p)).join(',\n')}`;
     }
-    /** Format a single param: errors → `message\nstack`; everything else → JSON.stringify(p, undefined, 4). */
+    /** Format a single param: errors → their stack and causes; everything else → JSON.stringify(p, undefined, 4). */
     formatParam(param) {
         if (param instanceof Error) {
-            return `${param.message}\n${param.stack ?? ''}`;
+            return describeErrorWithStack(param);
         }
         try {
             return JSON.stringify(param, undefined, 4);

package/lib/logging/glsp-client-logger.js.map

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

package/lib/messages/index.d.ts

@@ -9,11 +9,16 @@
 /**
  * Every user-facing message `@hydranium/glsp-server` raises.
  *
- * Enumeration only: GLSP's action protocol carries no slot for a message
- * identity on any of its notification actions, so a diagram error reaches the
- * client as English by upstream constraint. The declarations still earn their
- * place — an adopter rendering their own diagram chrome can key on the code, and
- * the barrel is how they discover the codes exist.
+ * **Each one is rendered AT ITS RAISE SITE**, through the shared
+ * `MessageRenderer`, because GLSP's action protocol carries no slot for an
+ * identity on any of its actions — so the identity is gone the moment a raise
+ * site formats its text, and there is nothing at the error boundary to render
+ * from. That makes this head the one place where a new message can ship
+ * unrendered without any single chokepoint noticing, which is why the package's
+ * own test suite scans for a declaration reached by `.format()` instead.
+ *
+ * The barrel is also how an adopter rendering their own diagram chrome
+ * discovers the codes exist.
  */
-export { SAVE_TARGET_UNKNOWN, SOURCE_URI_MISSING } from '../storage/hydranium-glsp-storage.js';
+export { DIAGRAM_READONLY_PARSE_ERROR, DIAGRAM_SESSION_REFUSED, SAVE_TARGET_UNKNOWN, SOURCE_URI_MISSING } from '../storage/hydranium-glsp-storage.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messages/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;;;;GAQG;AAEH,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messages/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACJ,4BAA4B,EAC5B,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EACpB,MAAM,sCAAsC,CAAC"}

package/lib/messages/index.js

@@ -9,11 +9,16 @@
 /**
  * Every user-facing message `@hydranium/glsp-server` raises.
  *
- * Enumeration only: GLSP's action protocol carries no slot for a message
- * identity on any of its notification actions, so a diagram error reaches the
- * client as English by upstream constraint. The declarations still earn their
- * place — an adopter rendering their own diagram chrome can key on the code, and
- * the barrel is how they discover the codes exist.
+ * **Each one is rendered AT ITS RAISE SITE**, through the shared
+ * `MessageRenderer`, because GLSP's action protocol carries no slot for an
+ * identity on any of its actions — so the identity is gone the moment a raise
+ * site formats its text, and there is nothing at the error boundary to render
+ * from. That makes this head the one place where a new message can ship
+ * unrendered without any single chokepoint noticing, which is why the package's
+ * own test suite scans for a declaration reached by `.format()` instead.
+ *
+ * The barrel is also how an adopter rendering their own diagram chrome
+ * discovers the codes exist.
  */
-export { SAVE_TARGET_UNKNOWN, SOURCE_URI_MISSING } from '../storage/hydranium-glsp-storage.js';
+export { DIAGRAM_READONLY_PARSE_ERROR, DIAGRAM_SESSION_REFUSED, SAVE_TARGET_UNKNOWN, SOURCE_URI_MISSING } from '../storage/hydranium-glsp-storage.js';
 //# sourceMappingURL=index.js.map

package/lib/messages/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/messages/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;;;;GAQG;AAEH,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/messages/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACJ,4BAA4B,EAC5B,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EACpB,MAAM,sCAAsC,CAAC"}