@hydranium/data-server 1.0.0-next.42 → 1.0.0-next.421

package/package.json

@@ -1,30 +1,37 @@
 {
   "name": "@hydranium/data-server",
-  "version": "1.0.0-next.42",
+  "version": "1.0.0-next.421",
   "description": "Typed-RPC protocol head for the hydranium framework. Peer of @hydranium/core/lsp and @hydranium/glsp-server; built on @hydranium/core.",
   "keywords": [
+    "data-server",
     "hydranium",
     "langium",
     "language-server",
     "lsp",
-    "rpc",
-    "data-server"
+    "rpc"
   ],
   "homepage": "https://github.com/eclipse-emfcloud/hydranium/tree/main/packages/data-server",
   "bugs": {
     "url": "https://github.com/eclipse-emfcloud/hydranium/issues"
   },
+  "license": "MIT",
+  "author": {
+    "name": "Hydranium Team"
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/eclipse-emfcloud/hydranium.git",
     "directory": "packages/data-server"
   },
-  "license": "MIT",
-  "author": {
-    "name": "Hydranium Team"
-  },
-  "sideEffects": false,
+  "files": [
+    "lib",
+    "src",
+    "!lib/**/*.tsbuildinfo"
+  ],
   "type": "module",
+  "sideEffects": false,
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
   "exports": {
     ".": {
       "types": "./lib/index.d.ts",
@@ -34,69 +41,50 @@
       "types": "./lib/node/index.d.ts",
       "default": "./lib/node/index.js"
     },
-    "./lib/node": {
-      "types": "./lib/node/index.d.ts",
-      "default": "./lib/node/index.js"
+    "./browser": {
+      "types": "./lib/browser/index.d.ts",
+      "default": "./lib/browser/index.js"
     },
     "./messages": {
       "types": "./lib/messages/index.d.ts",
       "default": "./lib/messages/index.js"
     },
-    "./lib/messages": {
-      "types": "./lib/messages/index.d.ts",
-      "default": "./lib/messages/index.js"
-    },
     "./testing": {
       "types": "./lib/testing/index.d.ts",
       "default": "./lib/testing/index.js"
-    },
-    "./lib/testing": {
-      "types": "./lib/testing/index.d.ts",
-      "default": "./lib/testing/index.js"
     }
   },
-  "main": "lib/index.js",
-  "browser": {
-    "./lib/default-diagnostics.js": "./lib/default-diagnostics.browser.js"
+  "publishConfig": {
+    "access": "public"
   },
-  "types": "lib/index.d.ts",
-  "files": [
-    "lib",
-    "src",
-    "!lib/**/*.tsbuildinfo"
-  ],
   "scripts": {
     "build": "tsc -b",
     "clean": "rimraf lib tsconfig.tsbuildinfo",
-    "lint": "eslint src test --max-warnings 0",
+    "lint": "oxlint --format stylish --config ../../oxlint.config.cjs src test --max-warnings 0",
     "prepack": "node -e \"const m=require('./package.json'),fs=require('node:fs');const missing=[m.main,...Object.values(m.bin||{})].filter(entry=>entry&&!fs.existsSync(entry));if(missing.length){console.error('prepack '+m.name+': not built ('+missing.join(', ')+' missing). Run the build before packing: a files entry that matches nothing is skipped silently, so the tarball would ship src only.');process.exit(1);}\"",
     "test": "npm run typecheck:test && vitest run",
     "typecheck:test": "tsc --noEmit -p tsconfig.test.json",
     "watch": "tsc -b -w --preserveWatchOutput"
   },
   "devDependencies": {
-    "@hydranium/core": "1.0.0-next.42",
-    "@hydranium/langium": "1.0.0-next.42",
-    "@hydranium/protocol": "1.0.0-next.42",
+    "@hydranium/core": "1.0.0-next.421",
+    "@hydranium/langium": "1.0.0-next.421",
+    "@hydranium/protocol": "1.0.0-next.421",
     "rimraf": "^5.0.0",
-    "typescript": "^5.8.0",
-    "vscode-jsonrpc": "9.0.1",
+    "typescript": "^7.0.2",
+    "vscode-jsonrpc": "9.0.3",
     "vscode-languageserver-textdocument": "^1.0.12"
   },
   "peerDependencies": {
-    "@hydranium/core": "1.0.0-next.42",
-    "@hydranium/langium": "1.0.0-next.42",
-    "@hydranium/protocol": "1.0.0-next.42",
-    "vscode-jsonrpc": "9.0.1",
+    "@hydranium/core": "1.0.0-next.421",
+    "@hydranium/langium": "1.0.0-next.421",
+    "@hydranium/protocol": "1.0.0-next.421",
+    "vscode-jsonrpc": "^9.0.3",
     "vscode-languageserver-textdocument": "^1.0.12"
   },
   "engines": {
     "node": ">=22.13"
   },
-  "publishConfig": {
-    "access": "public"
-  },
-  "//browser": "Selects the diagnostics default per platform, the same mechanism @eclipse-glsp/server uses to swap its node build for its browser one. The Node module imports @hydranium/core/node; a browser bundler resolves the twin instead and therefore never follows that import, which is what keeps this package's `.` entry bundleable. Node ignores this field, so a Node host keeps the real implementation with no configuration. `check:neutral` is the proof it still applies — it bundles `.` for the browser and would fail on node:fs the moment the mapping stops matching.",
-  "//peerDependencies": "`vscode-jsonrpc` is EXACT rather than a range, because it is one link of an atomic chain with no independently movable link: `vscode-languageserver-protocol` depends on it at exactly 9.0.1, so any other value an adopter supplies is a SECOND physical copy rather than an upgrade. This wire stack breaks on copy identity rather than on structure — `ParameterStructures.auto` is a singleton compared by `===` in connection.js, so a request type built by one copy and sent over a connection owned by the other throws `Unknown parameter structure auto`. A caret or union range was rejected because npm then resolves a `vscode-jsonrpc@8.2.0` tree SILENTLY, with no diagnostic at all, and the failure surfaces only later at server init. Exact does not fail the install either — npm downgrades an unsatisfiable peer to a warning — but it is a NAMED ERESOLVE warning printing the required version beside the found one, and a hard error for anyone installing with `--strict-peer-deps`. It does NOT prevent a NESTED copy — `@eclipse-glsp/*` carries its own exact `vscode-jsonrpc@8.2.0` dependency and root `overrides` do not ship — so a consumer of the GLSP head must pin the chain in its own manifest.",
-  "//prepack": "The publish guard, and it deliberately is NOT a `prepare`: npm runs a workspace `prepare` BEFORE the root `postinstall` that applies patches/vscode-jsonrpc+9.0.1.patch, so building there fails on a cold clone and npm rolls the entire install back. `prepack` runs only when a tarball is made (`npm pack`, `npm publish`) and never on install, so it cannot break the install it has no business touching. It FAILS rather than rebuilds, because the rebuild is exactly the part that ordering defeats. What it defends against: `files` lists `lib`, `lib` is gitignored, and a `files` entry matching nothing is skipped SILENTLY — so `npm publish` from an unbuilt tree emits a tarball of `src` and nothing else, with no error."
+  "//peerDependencies": "`vscode-jsonrpc` takes a caret, so the framework shares the transport the LSP connection resolves, which an `init` scaffold pins: each `vscode-languageserver-protocol` release pins its transport exactly, so an exact peer would name a copy a fresh install rarely holds. The caret starts at 9.0.3, the transport protocol 3.18.4 pins, since an earlier one leaves an unhandled rejection for a request written to a destroyed stream, and no protocol this framework accepts pins it. The caret excludes 8.x, so a tree whose top holds GLSP's copy fails the peer with a named ERESOLVE warning, an error under `--strict-peer-deps`, rather than resolving silently. No peer reaches a NESTED copy, such as GLSP's or one the LSP packages nest. The wire compares message types and `ResponseError`s by copy identity, so the framework sends typed messages by method name and recognises errors with `isResponseError` rather than `instanceof`.",
+  "//prepack": "The publish guard, a `prepack` rather than a `prepare`: `prepack` runs only when a tarball is made (`npm pack`, `npm publish`) and never on install, so it cannot break the install it has no business touching. What it defends against: `files` lists `lib`, `lib` is gitignored, and a `files` entry matching nothing is skipped SILENTLY — so `npm publish` from an unbuilt tree emits a tarball of `src` and nothing else, with no error."
 }

package/src/browser/index.ts

@@ -0,0 +1,15 @@
+/********************************************************************************
+ * Copyright (c) 2026 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
+ ********************************************************************************/
+
+// Browser-only entry (`@hydranium/data-server/browser`). Holds the worker
+// starter, whose connection comes from `vscode-jsonrpc/browser`. The portable
+// `.` entry stays free of that import for the same reason it stays free of the
+// node one: it must resolve under both platforms, and a build that names one
+// has picked.
+export * from './start-data-server-in-worker.js';

package/src/browser/start-data-server-in-worker.ts

@@ -0,0 +1,35 @@
+/********************************************************************************
+ * Copyright (c) 2026 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 { createMessagePortTransport, type TransferredMessagePort } from '@hydranium/protocol';
+import type { ServerSharedServicesMinimal } from '@hydranium/core';
+import { createMessageConnection, type MessageConnection } from 'vscode-jsonrpc/browser';
+
+/**
+ * Start the data head on the port the page transferred for it, on the same
+ * shared tier the LSP head runs on, and return the server `create` built.
+ *
+ * `create` constructs the adopter's `DataServer`, or a subclass of it, around
+ * the connection, as a Node host's socket callback does, and the connection
+ * listens once it has returned, in the order the Node launcher uses. The
+ * page's end of the port closing disposes the server, which ends every
+ * session this connection registered.
+ */
+export function startDataServerInWorker<TServer>(
+   port: TransferredMessagePort,
+   shared: Pick<ServerSharedServicesMinimal, 'Logger'>,
+   create: (connection: MessageConnection) => TServer
+): TServer {
+   // Both ends use `createMessagePortTransport`; see it for why.
+   const transport = createMessagePortTransport(port);
+   const connection = createMessageConnection(transport.reader, transport.writer, shared.Logger.with('ModelServer'));
+   const server = create(connection);
+   connection.listen();
+   return server;
+}