@solarisdk/core 0.1.0

package/dist/ws.js

@@ -0,0 +1,63 @@
+// A tiny WebSocket abstraction so `desktop.ts` works identically in Node (via
+// the `ws` package) and in the browser (native `WebSocket`). We deliberately
+// keep the surface minimal: open/close, send text, and three callbacks.
+import { ConnectionError } from "./errors.js";
+/** True when running somewhere with a usable native `WebSocket` (browsers). */
+function hasNativeWebSocket() {
+    return typeof globalThis !== "undefined" &&
+        typeof globalThis.WebSocket === "function";
+}
+/**
+ * Open a WebSocket using the best available implementation. In Node this
+ * dynamically imports `ws`; in the browser it uses the global `WebSocket`.
+ * `headers` are only honored by the Node path (browsers can't set them).
+ */
+export async function openWebSocket(url, headers, cb) {
+    if (hasNativeWebSocket()) {
+        return openNative(url, cb);
+    }
+    return openNodeWs(url, headers, cb);
+}
+function openNative(url, cb) {
+    const NativeWebSocket = globalThis.WebSocket;
+    const sock = new NativeWebSocket(url);
+    const OPEN = 1;
+    sock.onopen = () => cb.onOpen();
+    sock.onmessage = (ev) => {
+        cb.onMessage(typeof ev.data === "string" ? ev.data : String(ev.data));
+    };
+    sock.onclose = (ev) => cb.onClose(ev.code, ev.reason);
+    sock.onerror = () => cb.onError(new ConnectionError("WebSocket error"));
+    return {
+        send(data) {
+            sock.send(data);
+        },
+        close() {
+            sock.close();
+        },
+        get isOpen() {
+            return sock.readyState === OPEN;
+        },
+    };
+}
+async function openNodeWs(url, headers, cb) {
+    const mod = await import("ws");
+    const WebSocketImpl = (mod.default ?? mod);
+    const sock = new WebSocketImpl(url, { headers });
+    sock.on("open", () => cb.onOpen());
+    sock.on("message", (data) => cb.onMessage(String(data)));
+    sock.on("close", (code, reason) => cb.onClose(code, reason.toString()));
+    sock.on("error", (err) => cb.onError(err));
+    return {
+        send(data) {
+            sock.send(data);
+        },
+        close() {
+            sock.close();
+        },
+        get isOpen() {
+            return sock.readyState === WebSocketImpl.OPEN;
+        },
+    };
+}
+//# sourceMappingURL=ws.js.map

package/dist/ws.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@solarisdk/core",
+  "version": "0.1.0",
+  "description": "Shared runtime for the Solari SDK — transport, session handles, images, templates, and types used by @solarisdk/desktop and @solarisdk/sandbox.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "solari",
+    "sdk",
+    "core"
+  ],
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.12",
+    "typescript": "^5.6.0"
+  }
+}