@byfriends/vis-server 0.3.4

package/dist/server.d.mts

@@ -0,0 +1,49 @@
+//#region src/server.d.ts
+/** Options for starting a vis HTTP server programmatically. */
+interface StartVisServerOptions {
+  /** Bind host. Defaults to `resolveHost()` (loopback). */
+  readonly host?: string;
+  /** Bind port. Defaults to `resolvePort()` (3001). */
+  readonly port?: number;
+  /** Auth token. Defaults to `resolveVisAuthToken(host)` (required outside loopback). */
+  readonly authToken?: string;
+  /**
+   * Directory holding the built SPA assets to serve. When omitted, the
+   * `public/` directory next to the compiled server bundle is used (if any);
+   * in dev mode this resolves to `null` and only the API is served.
+   */
+  readonly publicDir?: string;
+}
+/** A handle to a running vis server. */
+interface VisServerHandle {
+  /** The host the server is bound to. */
+  readonly host: string;
+  /** The port the server is bound to. */
+  readonly port: number;
+  /** Base URL (`http://<host>:<port>`), with IPv6 hosts bracketed. */
+  readonly url: string;
+  /** Stop the server. Subsequent connections are refused. */
+  close(): void;
+}
+/**
+ * Start the vis HTTP server programmatically. Resolves once the server is
+ * listening. Used by the CLI `byf vis` subcommand (in-process) and by the
+ * standalone `index.ts` entry.
+ */
+declare function startVisServer(options?: StartVisServerOptions): Promise<VisServerHandle>;
+/**
+ * Resolve the BYF_HOME the server reads session records from. Exposed for the
+ * standalone entry's startup banner. CLI consumers rely on the same env var.
+ */
+declare function resolveVisByfHome(): string;
+/**
+ * Format the startup banner text. Exposed so the CLI can reuse the exact same
+ * wording without depending on startup-banner internals.
+ */
+declare function formatVisStartupBanner(input: {
+  readonly authToken?: string;
+  readonly host: string;
+  readonly port: number;
+}): string;
+//#endregion
+export { StartVisServerOptions, VisServerHandle, formatVisStartupBanner, resolveVisByfHome, startVisServer };

package/dist/server.mjs

@@ -0,0 +1,2 @@
+import { n as resolveVisByfHome, r as startVisServer, t as formatVisStartupBanner } from "./server-CqbNDUBH.mjs";
+export { formatVisStartupBanner, resolveVisByfHome, startVisServer };

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@byfriends/vis-server",
+  "version": "0.3.4",
+  "description": "HTTP server for BYF session visualization, serving the API and built SPA assets",
+  "keywords": [
+    "byf",
+    "debugging",
+    "server",
+    "vis",
+    "visualization"
+  ],
+  "homepage": "https://github.com/ByronFinn/byf",
+  "bugs": {
+    "url": "https://github.com/ByronFinn/byf/issues"
+  },
+  "license": "Proprietary",
+  "author": "ByronFinn",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ByronFinn/byf.git"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "imports": {
+    "#/*": [
+      "./src/*.ts",
+      "./src/*/index.ts"
+    ]
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/server.d.mts",
+      "import": "./dist/server.mjs",
+      "default": "./dist/server.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "dependencies": {
+    "@hono/node-server": "^1.13.7",
+    "hono": "^4.7.7",
+    "@byfriends/agent-core": "^0.3.4"
+  },
+  "devDependencies": {
+    "tsx": "^4.21.0",
+    "vitest": "4.1.4",
+    "@byfriends/kosong": "0.3.4",
+    "@byfriends/vis-web": "0.3.2"
+  },
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsdown && node ../scripts/copy-web-dist.mjs",
+    "test": "vitest run"
+  }
+}