@devframes/hub 0.9.11 → 0.9.12

package/dist/{assemble-BvY5jfgi.mjs → assemble-CbPTcI7d.mjs}

@@ -1,5 +1,5 @@
 import { a as resolveClientModuleSpecifier } from "./remote-url-UClKLQ5_.mjs";
-import { v as prepareDevframe, y as diagnostics } from "./context-Cdrtg-Kk.mjs";
+import { v as prepareDevframe, y as diagnostics } from "./context-nVwOE7i1.mjs";
 import { joinURL, withTrailingSlash } from "ufo";
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DOCK_IMPORTS_FILENAME, DEVFRAME_MCP_ROUTE, DEVFRAME_WS_ROUTE } from "devframe/constants";
 import { existsSync } from "node:fs";

package/dist/{context-Cdrtg-Kk.mjs → context-nVwOE7i1.mjs}

@@ -48,8 +48,8 @@ const diagnostics = defineDiagnostics({
 			fix: "A hub exposes one aggregate MCP endpoint over every mounted devframe, so per-devframe `mcp` settings are ignored. Drop `mcp: false` from `initHub` (the `'auto'` default mounts the aggregate route once agent tools exist) to surface this devframe's tools, or drop `mcp` from the devframe to silence this warning."
 		},
 		DF8006: {
-			why: (p) => `A static hub build can only write mounts under its own base: "${p.urlBase}" escapes "${p.base}".`,
-			fix: "buildHub maps each mount base to a directory under its `outDir`, so every mount must live under the hub base. Drop the `basePath` override (or the `ctx.install` base) that points outside it, or move the hub `base` up so it contains the mount."
+			why: (p) => `A static hub build writes each mount either under its base ("${p.base}") or as an absolute-path sibling of it, but "${p.urlBase}" is neither.`,
+			fix: "buildHub maps a mount under the hub base into its `outDir`, and any other mount to the deploy root (`outDir`'s parent) by its absolute path. Give the mount an absolute base (starting with `/`) so it resolves to one of those."
 		},
 		DF8100: {
 			why: (p) => `Dock with id "${p.id}" is already registered`,
@@ -162,29 +162,6 @@ async function resolvePageScriptClientScript(ctx, clientScript, base) {
 	};
 }
 /**
-* Framework-neutral primitive backing {@link DevframeHubContext.install} -
-* installs a {@link DevframeDefinition} as a dock inside a hub-aware context:
-* serves the devframe's SPA at the resolved base path, synthesizes an iframe
-* dock entry from the definition's metadata, and runs the definition's
-* `setup(ctx)`. Reach for it through `ctx.install(devframe)` rather than
-* calling it directly.
-*
-* Framework kits wrap `ctx.install` with their own plugin/middleware
-* machinery, e.g. `@vitejs/devtools-kit`'s `createPluginFromDevframe`
-* returns a Vite `Plugin` whose `devtools.setup` ultimately delegates here.
-*/
-/**
-* Phase one of an install: run the duplication guard, serve the SPA + meta,
-* register the iframe dock, and queue the definition's declarative wire
-* services, everything up to (but not including) `setup(ctx)`. Returns a
-* deferred setup thunk, or `null` when the devframe was deduplicated.
-*
-* The hub's initial batch uses this to collect every devframe's services
-* across the whole hub, `ready()` them once, and only then run the setups,
-* so services are ready before any setup, and a plugin can consume a service
-* another plugin declared regardless of mount order.
-*/
-/**
 * Serve a devframe's SPA (and the hub's connection meta) under `base`, if the
 * definition ships client assets.
 */

package/dist/node/build.d.mts

@@ -7,7 +7,10 @@ interface BuildHubOptions {
    * Output directory the hub subtree is written into. It corresponds to the
    * hub {@link BuildHubOptions.base} at serve time: building with
    * `base: '/__devframes/'` into `dist/__devframes` makes the deployed app's
-   * `dist/` servable as-is by any static file server.
+   * `dist/` servable as-is by any static file server. A mount served outside
+   * the hub base (a devframe SPA or asset dir kept as a sibling of it) is
+   * written to this directory's parent (the deploy root) by its absolute path,
+   * so `dist/` still serves the whole layout.
    */
   outDir: string;
   /**

package/dist/node/build.mjs

@@ -1,6 +1,6 @@
 import { a as normalizeHubBase, i as DOCK_RENDERERS_STATE_KEY } from "../constants-Da23JxCZ.mjs";
-import { t as createHubContext, y as diagnostics } from "../context-Cdrtg-Kk.mjs";
-import { i as resolveRendererRegistrations, n as renderClientImportsModule, r as resolveDevframesInput, t as mountDevframes } from "../assemble-BvY5jfgi.mjs";
+import { t as createHubContext, y as diagnostics } from "../context-nVwOE7i1.mjs";
+import { i as resolveRendererRegistrations, n as renderClientImportsModule, r as resolveDevframesInput, t as mountDevframes } from "../assemble-CbPTcI7d.mjs";
 import { joinURL } from "ufo";
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DOCK_IMPORTS_FILENAME } from "devframe/constants";
 import { existsSync } from "node:fs";
@@ -45,13 +45,22 @@ async function buildHub(options) {
 	await options.ui?.setup?.(ctx);
 	if (options.clean !== false && existsSync(outDir)) await fs.rm(outDir, { recursive: true });
 	await fs.mkdir(outDir, { recursive: true });
-	/** Map a hub-base-relative URL base to its on-disk location under `outDir`. */
+	/**
+	* Map a served URL base to its on-disk location. A base under the hub
+	* {@link base} writes into the hub subtree at `outDir` (so `outDir`
+	* corresponds to the hub base). A base outside it is a deploy-root sibling:
+	* `outDir`'s parent is the deploy root, and the base resolves under it by its
+	* absolute path. This is the layout Vite DevTools serves, where devframe SPAs
+	* and assets sit beside `/__devtools/` rather than under it.
+	*/
+	const deployRoot = dirname(outDir);
 	const resolveOutPath = (urlBase) => {
-		if (!urlBase.startsWith(base)) throw diagnostics.DF8006({
+		if (urlBase.startsWith(base)) return resolve(outDir, urlBase.slice(base.length));
+		if (!urlBase.startsWith("/")) throw diagnostics.DF8006({
 			urlBase,
 			base
 		});
-		return resolve(outDir, urlBase.slice(base.length));
+		return resolve(deployRoot, urlBase.slice(1));
 	};
 	await copyBuildStatics(ctx, resolveOutPath);
 	await publishRendererManifest(ctx, rendererRegistrations, base, outDir);

package/dist/node/index.mjs

@@ -1,4 +1,4 @@
-import { _ as DevframeCommandsHost, a as hubMessagesAdd, c as hubMessagesUpdate, d as hubTerminalsRestart, f as hubTerminalsTerminate, g as DevframeDocksHost, h as DevframeMessagesHost, i as hubDocksActivate, l as hubTerminalsRemove, m as DevframeTerminalsHost, n as builtinHubRpcDeclarations, o as hubMessagesClear, p as hubTerminalsWrite, r as hubCommandsExecute, s as hubMessagesRemove, t as createHubContext, u as hubTerminalsResize } from "../context-Cdrtg-Kk.mjs";
+import { _ as DevframeCommandsHost, a as hubMessagesAdd, c as hubMessagesUpdate, d as hubTerminalsRestart, f as hubTerminalsTerminate, g as DevframeDocksHost, h as DevframeMessagesHost, i as hubDocksActivate, l as hubTerminalsRemove, m as DevframeTerminalsHost, n as builtinHubRpcDeclarations, o as hubMessagesClear, p as hubTerminalsWrite, r as hubCommandsExecute, s as hubMessagesRemove, t as createHubContext, u as hubTerminalsResize } from "../context-nVwOE7i1.mjs";
 import "ufo";
 import "node:fs";
 import "node:process";

package/dist/node/initiate.d.mts

@@ -1,6 +1,7 @@
 import { a as InstallDevframeOptions, n as DevframeHubContext, t as CreateHubContextOptions } from "../context-BmHQp89a.mjs";
 import { r as DEVFRAMES_HUB_BASE } from "../constants-Bz4yclHo.mjs";
 import { DevframeInstanceRecord } from "devframe/internal";
+import { AuthBannerFunction } from "devframe/recipes/interactive-auth";
 import { ConnectionMeta, DevframeDefinition, DevframeServiceInput, DevframeSseOptions, DevframeStorageScope, DevframeWsOptions, McpSetting } from "devframe/types";
 import { DevframeAuthHandler } from "devframe/node/auth";
 import { WsOriginRegistry } from "devframe/rpc/transports/ws-server";
@@ -86,6 +87,17 @@ interface DevframeHubUi {
    * The hub stays policy-free about what the UI writes.
    */
   setup?: (ctx: DevframeHubContext) => void | Promise<void>;
+  /**
+   * The interactive OTP banner (auth code + magic-link URL) to print when
+   * {@link InitHubOptions.auth} is left at its default. A node-side
+   * counterpart to `setup`'s browser-facing branding: the reference UI's
+   * `createUi()` derives one from its own `branding.productName` via
+   * `createAuthBanner` (see `devframe/recipes/interactive-auth`), so the
+   * printed code matches the rebranded viewer without the caller wiring
+   * `auth` themselves. Ignored once `auth` is set explicitly - a `false` or
+   * a full {@link DevframeAuthHandler} both mean the caller owns the banner.
+   */
+  authBanner?: AuthBannerFunction;
 }
 type DevframesInput = Array<DevframeDefinition | HubDevframeEntry | Thenable<Arrayable<DevframeDefinition | HubDevframeEntry | null | undefined>> | (() => Thenable<Arrayable<DevframeDefinition | HubDevframeEntry | null | undefined>>)>;
 interface InitHubOptions {

package/dist/node/initiate.mjs

@@ -1,12 +1,13 @@
 import { a as normalizeHubBase, i as DOCK_RENDERERS_STATE_KEY, r as DEVFRAMES_HUB_BASE } from "../constants-Da23JxCZ.mjs";
-import { t as createHubContext, y as diagnostics } from "../context-Cdrtg-Kk.mjs";
-import { i as resolveRendererRegistrations, n as renderClientImportsModule, r as resolveDevframesInput, t as mountDevframes } from "../assemble-BvY5jfgi.mjs";
+import { t as createHubContext, y as diagnostics } from "../context-nVwOE7i1.mjs";
+import { i as resolveRendererRegistrations, n as renderClientImportsModule, r as resolveDevframesInput, t as mountDevframes } from "../assemble-CbPTcI7d.mjs";
 import { joinURL, withoutLeadingSlash } from "ufo";
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DOCK_IMPORTS_FILENAME, DEVFRAME_MCP_ROUTE } from "devframe/constants";
 import { readFile } from "node:fs/promises";
 import process from "node:process";
 import { createH3DevframeHost, createInstanceShell, importRuntimeModule, loadAutoMcpAdapter, resolveInstanceRegister, resolveMcpConfig } from "devframe/internal";
 import { resolve } from "pathe";
+import { createInteractiveAuth } from "devframe/recipes/interactive-auth";
 import { mountStaticHandler } from "devframe/utils/serve-static";
 import { H3 } from "h3";
 //#region src/node/initiate.ts
@@ -81,7 +82,14 @@ function initHub(options) {
 		app,
 		host: options.host,
 		origin: options.origin,
-		auth: options.auth,
+		/**
+		* `false`/an explicit handler are the caller's own call, passed through
+		* as-is; `true`/unset both mean "gate with the defaults", so the handler
+		* is built lazily from `ctx` either way, taking the UI slot's
+		* `authBanner` (e.g. `createUi()`'s branded box) without the caller
+		* wiring `auth` themselves.
+		*/
+		auth: options.auth === false || typeof options.auth === "object" ? options.auth : (ctx) => createInteractiveAuth(ctx, { banner: options.ui?.authBanner }),
 		server: options.server,
 		ws: options.ws,
 		sse: options.sse,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/hub",
   "type": "module",
-  "version": "0.9.11",
+  "version": "0.9.12",
   "description": "Hub layer that orchestrates devframe docks, terminals, messages, and commands on any host.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -35,7 +35,7 @@
     "dist"
   ],
   "peerDependencies": {
-    "devframe": "0.9.11"
+    "devframe": "0.9.12"
   },
   "dependencies": {
     "@standard-schema/spec": "^1.1.0",
@@ -49,7 +49,7 @@
   },
   "devDependencies": {
     "@types/node": "^26.4.0",
-    "devframe": "0.9.11",
+    "devframe": "0.9.12",
     "get-port-please": "^3.2.0",
     "mlly": "^1.8.2",
     "tsdown": "^0.22.14",