@hashsome/runtime 0.1.0

package/dist/src/server/proxy.js

@@ -0,0 +1,165 @@
+import { encodeMessage, parseClientMessage, parseEntityRef, UnknownEntityError, } from '@hashsome/core';
+const OPEN = 1;
+const RANGES = ['1h', '1d', '1w', '1m'];
+const BUCKETS = ['5m', '1h', '1d'];
+/** A history query's fields, kept only when they are ones it has: the rest came from a browser. A
+ * missing or unknown range is a request that cannot be answered. */
+function historyArgs(args) {
+    const { range, bucket } = args ?? {};
+    if (typeof range !== 'string' || !RANGES.includes(range)) {
+        return undefined;
+    }
+    return {
+        range: range,
+        ...(typeof bucket === 'string' && BUCKETS.includes(bucket)
+            ? { bucket: bucket }
+            : {}),
+    };
+}
+/** The only fields a browse query has, kept only when they are strings: the rest came from a browser. */
+function browseArgs(args) {
+    return {
+        ...(typeof args?.path === 'string' ? { path: args.path } : {}),
+        ...(typeof args?.search === 'string' ? { search: args.search } : {}),
+    };
+}
+/**
+ * Multiplexes browser connections onto server-held integrations. Tokens never
+ * reach the browser; current entities are replayed from the integrations' stores
+ * so a waking tablet gets a full picture immediately.
+ *
+ * The proxy does all the addressing: it parses `<integration>:<id>` and hands the integration only
+ * its local id. A subscription is resolved once the owning integration is connected — until then
+ * the browser has no answer (a component shows its loading state) — and an id the integration does
+ * not have is answered with `entity: null` and logged.
+ */
+export class Proxy {
+    #integrations = new Map();
+    #log;
+    constructor(integrations, options = {}) {
+        for (const integration of integrations) {
+            this.#integrations.set(integration.id, integration);
+        }
+        this.#log = options.log ?? (() => { });
+    }
+    handleConnection(socket) {
+        const send = (message) => {
+            if (socket.readyState === OPEN) {
+                socket.send(encodeMessage(message));
+            }
+        };
+        const subscriptions = new Map();
+        const cleanups = [];
+        for (const integration of this.#integrations.values()) {
+            const report = (status) => send({ type: 'status', integration: integration.id, status });
+            report(integration.status);
+            cleanups.push(integration.onStatusChange(report));
+        }
+        const answer = (id, outcome) => {
+            outcome.then((data) => send({ type: 'result', id, ok: true, ...(data !== undefined ? { data } : {}) }), (error) => send({
+                type: 'result',
+                id,
+                ok: false,
+                error: error instanceof Error ? error.message : String(error),
+            }));
+        };
+        const subscribe = (ref) => {
+            const { integration: integrationId, id } = parseEntityRef(ref);
+            const integration = this.#integrations.get(integrationId);
+            if (!integration) {
+                this.#log(`[proxy] no integration "${integrationId}" for ${ref}`);
+                send({ type: 'entity', ref, entity: null });
+                return () => { };
+            }
+            const start = () => {
+                try {
+                    return integration.subscribe(id, (entity) => send({ type: 'entity', ref, entity: entity ?? null }));
+                }
+                catch (error) {
+                    if (!(error instanceof UnknownEntityError)) {
+                        throw error;
+                    }
+                    this.#log(`[proxy] ${error.message}`);
+                    send({ type: 'entity', ref, entity: null });
+                    return () => { };
+                }
+            };
+            if (integration.status === 'connected') {
+                return start();
+            }
+            let stop;
+            const off = integration.onStatusChange((status) => {
+                if (status === 'connected' && !stop) {
+                    stop = start();
+                }
+            });
+            return () => {
+                off();
+                stop?.();
+            };
+        };
+        socket.on('message', (data) => {
+            const message = parseClientMessage(data.toString());
+            if (!message) {
+                return;
+            }
+            switch (message.type) {
+                case 'subscribe':
+                    if (!subscriptions.has(message.ref)) {
+                        subscriptions.set(message.ref, subscribe(message.ref));
+                    }
+                    return;
+                case 'unsubscribe':
+                    subscriptions.get(message.ref)?.();
+                    subscriptions.delete(message.ref);
+                    return;
+                case 'command': {
+                    const { integration: integrationId, id } = parseEntityRef(message.ref);
+                    const integration = this.#integrations.get(integrationId);
+                    answer(message.id, integration
+                        ? integration.command(id, message.command, message.args)
+                        : Promise.reject(new Error(`Unknown integration "${integrationId}"`)));
+                    return;
+                }
+                case 'query': {
+                    const { integration: integrationId, id } = parseEntityRef(message.ref);
+                    const integration = this.#integrations.get(integrationId);
+                    const history = message.query === 'history' ? historyArgs(message.args) : undefined;
+                    answer(message.id, !integration
+                        ? Promise.reject(new Error(`Unknown integration "${integrationId}"`))
+                        : message.query === 'history'
+                            ? integration.history
+                                ? history
+                                    ? integration.history(id, history)
+                                    : Promise.reject(new Error('A history query needs a range'))
+                                : Promise.reject(new Error(`"${integrationId}" keeps no history`))
+                            : integration.browse
+                                ? integration.browse(id, browseArgs(message.args))
+                                : Promise.reject(new Error(`"${integrationId}" has no media library`)));
+                    return;
+                }
+                case 'raw': {
+                    const integration = this.#integrations.get(message.integration);
+                    answer(message.id, !integration
+                        ? Promise.reject(new Error(`Unknown integration "${message.integration}"`))
+                        : integration.callRaw
+                            ? integration.callRaw(message.request)
+                            : Promise.reject(new Error(`"${message.integration}" has no raw requests`)));
+                    return;
+                }
+            }
+        });
+        const dispose = () => {
+            for (const off of subscriptions.values()) {
+                off();
+            }
+            subscriptions.clear();
+            for (const off of cleanups) {
+                off();
+            }
+            cleanups.length = 0;
+        };
+        socket.on('close', dispose);
+        socket.on('error', dispose);
+    }
+}

package/dist/src/server/proxy.js.map

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

package/dist/src/server/websocket.d.ts

@@ -0,0 +1,5 @@
+import type { Server as HttpServer } from 'node:http';
+import type { Proxy } from './proxy.ts';
+export declare const WS_PATH = "/ws";
+/** Attaches the proxy to `/ws` on an http server, leaving other upgrades (Vite HMR) alone. */
+export declare function attachWebSocket(server: HttpServer, proxy: Proxy): () => void;

package/dist/src/server/websocket.js

@@ -0,0 +1,17 @@
+import { WebSocketServer } from 'ws';
+export const WS_PATH = '/ws';
+/** Attaches the proxy to `/ws` on an http server, leaving other upgrades (Vite HMR) alone. */
+export function attachWebSocket(server, proxy) {
+    const wss = new WebSocketServer({ noServer: true });
+    const onUpgrade = (request, socket, head) => {
+        if (new URL(request.url ?? '/', 'http://localhost').pathname !== WS_PATH) {
+            return;
+        }
+        wss.handleUpgrade(request, socket, head, (ws) => proxy.handleConnection(ws));
+    };
+    server.on('upgrade', onUpgrade);
+    return () => {
+        server.off('upgrade', onUpgrade);
+        wss.close();
+    };
+}

package/dist/src/server/websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../../../src/server/websocket.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AAGrC,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,CAAC;AAE7B,8FAA8F;AAC9F,MAAM,UAAU,eAAe,CAAC,MAAkB,EAAE,KAAY;IAC9D,MAAM,GAAG,GAAG,IAAI,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,CAChB,OAA4C,EAC5C,MAAoC,EACpC,IAAY,EACZ,EAAE;QACF,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACzE,OAAO;QACT,CAAC;QAED,GAAG,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/E,CAAC,CAAC;IAEF,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAChC,OAAO,GAAG,EAAE;QACV,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACjC,GAAG,CAAC,KAAK,EAAE,CAAC;IACd,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/vite-config.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Sensible default, re-exported by the project's own `vite.config.ts` (the React Router plugin
+ * requires a config file at the project root). Server settings and the dev proxy are supplied
+ * inline by the CLI.
+ *
+ * A function, so every load of the config gets its own React Router plugin. The SPA build starts a
+ * preview server that loads this config again in the same process; a plugin created once at import
+ * would be shared, and the preview's `serve` would overwrite the build's state in it
+ * ("Expected build manifest").
+ */
+declare const _default: import("vite").UserConfigFnObject;
+export default _default;

package/dist/src/vite-config.js

@@ -0,0 +1,35 @@
+import { reactRouter } from '@react-router/dev/vite';
+import { defineConfig } from 'vite';
+/**
+ * Sensible default, re-exported by the project's own `vite.config.ts` (the React Router plugin
+ * requires a config file at the project root). Server settings and the dev proxy are supplied
+ * inline by the CLI.
+ *
+ * A function, so every load of the config gets its own React Router plugin. The SPA build starts a
+ * preview server that loads this config again in the same process; a plugin created once at import
+ * would be shared, and the preview's `serve` would overwrite the build's state in it
+ * ("Expected build manifest").
+ */
+export default defineConfig(() => ({
+    plugins: [reactRouter()],
+    // React Router's SPA prerender starts a private preview server; pin it to IPv4 so it is
+    // reachable in containers where `localhost` resolves to ::1.
+    preview: { host: '127.0.0.1' },
+    resolve: {
+        // One copy of these across the runtime app and the instance's dashboards.
+        dedupe: ['react', 'react-dom', 'react-router', '@hashsome/core', '@hashsome/ui'],
+    },
+    optimizeDeps: {
+        // Vite's dependency scanner only follows *static* imports reachable from the HTML entry —
+        // route modules are loaded dynamically by React Router's own router, not a plain `import`
+        // statement it can see, so a dashboard's dependencies (e.g. the energy chart's `recharts`)
+        // only surface once that route is actually visited. Without this, navigating to a dashboard
+        // not yet visited in the current dev session triggers a fresh dependency pre-bundle mid-visit
+        // — the page's own module graph update races a React Router navigation already in flight, and
+        // the view can appear stuck (URL changed, nothing rendered) until the resulting full reload,
+        // sometimes several seconds later. Pointing the scanner at every route module upfront (plus
+        // `app/root.tsx`, which pulls in `HashsomeProvider`) lets it discover all of this at
+        // server startup instead.
+        entries: ['app/root.tsx', 'dashboards/**/*.{ts,tsx}'],
+    },
+}));

package/dist/src/vite-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-config.js","sourceRoot":"","sources":["../../src/vite-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEpC;;;;;;;;;GASG;AACH,eAAe,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC;IACjC,OAAO,EAAE,CAAC,WAAW,EAAE,CAAC;IACxB,wFAAwF;IACxF,6DAA6D;IAC7D,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;IAC9B,OAAO,EAAE;QACP,0EAA0E;QAC1E,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,CAAC;KACjF;IACD,YAAY,EAAE;QACZ,0FAA0F;QAC1F,0FAA0F;QAC1F,2FAA2F;QAC3F,4FAA4F;QAC5F,8FAA8F;QAC9F,8FAA8F;QAC9F,6FAA6F;QAC7F,4FAA4F;QAC5F,qFAAqF;QACrF,0BAA0B;QAC1B,OAAO,EAAE,CAAC,cAAc,EAAE,0BAA0B,CAAC;KACtD;CACF,CAAC,CAAC,CAAC"}

package/dist/src/vite.d.ts

@@ -0,0 +1,5 @@
+import { type InlineConfig } from 'vite';
+import type { ResolvedConfig } from './config.ts';
+import type { Proxy } from './server/proxy.ts';
+/** `proxy` is only passed for `dev`; `build` needs no server settings (its prerender starts a private preview server). */
+export declare function createViteConfig(config: ResolvedConfig, proxy?: Proxy): InlineConfig;

package/dist/src/vite.js

@@ -0,0 +1,42 @@
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { searchForWorkspaceRoot } from 'vite';
+import { serveAsset } from './server/assets.js';
+import { attachWebSocket } from './server/websocket.js';
+const runtimeRoot = join(dirname(fileURLToPath(import.meta.url)), '..');
+/** Dev only: `/healthz`, the `/ws` proxy and the asset route on Vite's own server. */
+function hashsomeDevServer(proxy, config) {
+    return {
+        name: 'hashsome:dev-server',
+        configureServer(server) {
+            server.middlewares.use('/healthz', (_req, res) => {
+                res.setHeader('content-type', 'application/json');
+                res.end('{"status":"ok"}');
+            });
+            server.middlewares.use((req, res, next) => {
+                serveAsset(config.integrations, req, res).then((served) => (served ? undefined : next()), next);
+            });
+            if (server.httpServer) {
+                attachWebSocket(server.httpServer, proxy);
+            }
+        },
+    };
+}
+/** `proxy` is only passed for `dev`; `build` needs no server settings (its prerender starts a private preview server). */
+export function createViteConfig(config, proxy) {
+    return {
+        root: config.root,
+        configFile: join(config.root, 'vite.config.ts'),
+        ...(proxy
+            ? {
+                plugins: [hashsomeDevServer(proxy, config)],
+                server: {
+                    host: config.host,
+                    port: config.port,
+                    strictPort: true,
+                    fs: { allow: [searchForWorkspaceRoot(config.root), runtimeRoot] },
+                },
+            }
+            : {}),
+    };
+}

package/dist/src/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../../src/vite.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAkC,MAAM,MAAM,CAAC;AAE9E,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AAExE,sFAAsF;AACtF,SAAS,iBAAiB,CAAC,KAAY,EAAE,MAAsB;IAC7D,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,eAAe,CAAC,MAAM;YACpB,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;gBAC/C,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;gBAClD,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;YAC7B,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;gBACxC,UAAU,CAAC,MAAM,CAAC,YAAY,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,CAC5C,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EACzC,IAAI,CACL,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,eAAe,CAAC,MAAM,CAAC,UAAwB,EAAE,KAAK,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,0HAA0H;AAC1H,MAAM,UAAU,gBAAgB,CAAC,MAAsB,EAAE,KAAa;IACpE,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC;QAC/C,GAAG,CAAC,KAAK;YACP,CAAC,CAAC;gBACE,OAAO,EAAE,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBAC3C,MAAM,EAAE;oBACN,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,UAAU,EAAE,IAAI;oBAChB,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,sBAAsB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,EAAE;iBAClE;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@hashsome/runtime",
+  "version": "0.1.0",
+  "description": "Server + CLI that serves a project's own dashboards",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    },
+    "./app": {
+      "types": "./dist/app/index.d.ts",
+      "default": "./dist/app/index.js"
+    },
+    "./entry-client": {
+      "types": "./dist/app/entry.client.d.ts",
+      "default": "./dist/app/entry.client.js"
+    },
+    "./entry-server": {
+      "types": "./dist/app/entry.server.d.ts",
+      "default": "./dist/app/entry.server.js"
+    },
+    "./vite-config": {
+      "types": "./dist/src/vite-config.d.ts",
+      "default": "./dist/src/vite-config.js"
+    },
+    "./serve": {
+      "types": "./dist/src/serve.d.ts",
+      "default": "./dist/src/serve.js"
+    }
+  },
+  "devDependencies": {
+    "@testing-library/react": "16.3.3",
+    "@types/express": "5.0.6",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
+    "@types/ws": "8.18.1",
+    "jsdom": "30.1.1"
+  },
+  "dependencies": {
+    "@hashsome/core": "0.1.0",
+    "@hashsome/ui": "0.1.0",
+    "@react-router/dev": "8.4.0",
+    "express": "5.2.1",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
+    "react-router": "8.4.0",
+    "vite": "8.3.1",
+    "ws": "8.21.3"
+  },
+  "bin": {
+    "hashsome": "./dist/bin/hashsome.js"
+  },
+  "license": "GPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dstoyanoff/hashsome.git",
+    "directory": "packages/runtime"
+  },
+  "homepage": "https://github.com/dstoyanoff/hashsome#readme",
+  "bugs": "https://github.com/dstoyanoff/hashsome/issues",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "tsc -b tsconfig.build.json"
+  }
+}