@databricks/appkit 0.0.2

package/dist/server/index.js

@@ -0,0 +1,224 @@
+import { instrumentations } from "../telemetry/instrumentations.js";
+import "../telemetry/index.js";
+import { databricksClientMiddleware } from "../utils/databricks-client-middleware.js";
+import { init_utils } from "../utils/index.js";
+import { Plugin } from "../plugin/plugin.js";
+import { toPlugin } from "../plugin/to-plugin.js";
+import "../plugin/index.js";
+import { RemoteTunnelController } from "./remote-tunnel/remote-tunnel-controller.js";
+import { getRoutes } from "./utils.js";
+import { StaticServer } from "./static-server.js";
+import { ViteDevServer } from "./vite-dev-server.js";
+import path from "node:path";
+import fs from "node:fs";
+import dotenv from "dotenv";
+import express from "express";
+
+//#region src/server/index.ts
+init_utils();
+dotenv.config({ path: path.resolve(process.cwd(), "./.env") });
+/**
+* Server plugin for the AppKit.
+*
+* This plugin is responsible for starting the server and serving the static files.
+* It also handles the remote tunneling for development purposes.
+*
+* @example
+* ```ts
+* createApp({
+*   plugins: [server(), telemetryExamples(), analytics({})],
+* });
+* ```
+*
+*/
+var ServerPlugin = class ServerPlugin extends Plugin {
+	static {
+		this.DEFAULT_CONFIG = {
+			autoStart: true,
+			host: process.env.FLASK_RUN_HOST || "0.0.0.0",
+			port: Number(process.env.DATABRICKS_APP_PORT) || 8e3
+		};
+	}
+	static {
+		this.phase = "deferred";
+	}
+	constructor(config) {
+		super(config);
+		this.name = "server";
+		this.envVars = [];
+		this.serverExtensions = [];
+		this.config = config;
+		this.serverApplication = express();
+		this.server = null;
+		this.serverExtensions = [];
+		this.telemetry.registerInstrumentations([instrumentations.http, instrumentations.express]);
+	}
+	/** Setup the server plugin. */
+	async setup() {
+		if (this.shouldAutoStart()) await this.start();
+	}
+	/** Get the server configuration. */
+	getConfig() {
+		const { plugins: _plugins, ...config } = this.config;
+		return config;
+	}
+	/** Check if the server should auto start. */
+	shouldAutoStart() {
+		return this.config.autoStart;
+	}
+	/**
+	* Start the server.
+	*
+	* This method starts the server and sets up the frontend.
+	* It also sets up the remote tunneling if enabled.
+	*
+	* @returns The express application.
+	*/
+	async start() {
+		this.serverApplication.use(express.json());
+		const endpoints = await this.extendRoutes();
+		for (const extension of this.serverExtensions) extension(this.serverApplication);
+		this.remoteTunnelController = new RemoteTunnelController(this.devFileReader);
+		this.serverApplication.use(this.remoteTunnelController.middleware);
+		await this.setupFrontend(endpoints);
+		const server$1 = this.serverApplication.listen(this.config.port ?? ServerPlugin.DEFAULT_CONFIG.port, this.config.host ?? ServerPlugin.DEFAULT_CONFIG.host, () => this.logStartupInfo());
+		this.server = server$1;
+		this.remoteTunnelController.setServer(server$1);
+		process.on("SIGTERM", () => this._gracefulShutdown());
+		process.on("SIGINT", () => this._gracefulShutdown());
+		if (process.env.NODE_ENV === "development") {
+			const allRoutes = getRoutes(this.serverApplication._router.stack);
+			console.dir(allRoutes, { depth: null });
+		}
+		return this.serverApplication;
+	}
+	/**
+	* Get the low level node.js http server instance.
+	*
+	* Only use this method if you need to access the server instance for advanced usage like a custom websocket server, etc.
+	*
+	* @throws {Error} If the server is not started or autoStart is true.
+	* @returns {HTTPServer} The server instance.
+	*/
+	getServer() {
+		if (this.shouldAutoStart()) throw new Error("Cannot get server when autoStart is true.");
+		if (!this.server) throw new Error("Server not started. Please start the server first by calling the start() method.");
+		return this.server;
+	}
+	/**
+	* Extend the server with custom routes or middleware.
+	*
+	* @param fn - A function that receives the express application.
+	* @returns The server plugin instance for chaining.
+	* @throws {Error} If autoStart is true.
+	*/
+	extend(fn) {
+		if (this.shouldAutoStart()) throw new Error("Cannot extend server when autoStart is true.");
+		this.serverExtensions.push(fn);
+		return this;
+	}
+	/**
+	* Setup the routes with the plugins.
+	*
+	* This method goes through all the plugins and injects the routes into the server application.
+	* Returns a map of plugin names to their registered named endpoints.
+	*/
+	async extendRoutes() {
+		const endpoints = {};
+		if (!this.config.plugins) return endpoints;
+		this.serverApplication.get("/health", (_, res) => {
+			res.status(200).json({ status: "ok" });
+		});
+		this.registerEndpoint("health", "/health");
+		for (const plugin of Object.values(this.config.plugins)) {
+			if (EXCLUDED_PLUGINS.includes(plugin.name)) continue;
+			if (plugin?.injectRoutes && typeof plugin.injectRoutes === "function") {
+				const router = express.Router();
+				if (plugin.requiresDatabricksClient) router.use(await databricksClientMiddleware());
+				plugin.injectRoutes(router);
+				const basePath = `/api/${plugin.name}`;
+				this.serverApplication.use(basePath, router);
+				endpoints[plugin.name] = plugin.getEndpoints();
+			}
+		}
+		return endpoints;
+	}
+	/**
+	* Setup frontend serving based on environment:
+	* - If staticPath is explicitly provided: use static server
+	* - Dev mode (no staticPath): Vite for HMR
+	* - Production (no staticPath): Static files auto-detected
+	*/
+	async setupFrontend(endpoints) {
+		const isDev = process.env.NODE_ENV === "development";
+		if (this.config.staticPath !== void 0) {
+			new StaticServer(this.serverApplication, this.config.staticPath, endpoints).setup();
+			return;
+		}
+		if (isDev) {
+			this.viteDevServer = new ViteDevServer(this.serverApplication, endpoints);
+			await this.viteDevServer.setup();
+			return;
+		}
+		const staticPath = ServerPlugin.findStaticPath();
+		if (staticPath) new StaticServer(this.serverApplication, staticPath, endpoints).setup();
+	}
+	static findStaticPath() {
+		const staticPaths = [
+			"dist",
+			"client/dist",
+			"build",
+			"public",
+			"out"
+		];
+		const cwd = process.cwd();
+		for (const p of staticPaths) {
+			const fullPath = path.resolve(cwd, p);
+			if (fs.existsSync(path.resolve(fullPath, "index.html"))) {
+				console.log(`Static files: serving from ${fullPath}`);
+				return fullPath;
+			}
+		}
+	}
+	logStartupInfo() {
+		const isDev = process.env.NODE_ENV === "development";
+		const hasExplicitStaticPath = this.config.staticPath !== void 0;
+		const port = this.config.port ?? ServerPlugin.DEFAULT_CONFIG.port;
+		const host = this.config.host ?? ServerPlugin.DEFAULT_CONFIG.host;
+		console.log(`Server running on http://${host}:${port}`);
+		if (hasExplicitStaticPath) console.log(`Mode: static (${this.config.staticPath})`);
+		else if (isDev) console.log("Mode: development (Vite HMR)");
+		else console.log("Mode: production (static)");
+		const remoteServerController = this.remoteTunnelController;
+		if (!remoteServerController) console.log("Remote tunnel: disabled (controller not initialized)");
+		else console.log(`Remote tunnel: ${remoteServerController.isAllowedByEnv() ? "allowed" : "blocked"}; ${remoteServerController.isActive() ? "active" : "inactive"}`);
+	}
+	async _gracefulShutdown() {
+		console.log("Starting graceful shutdown...");
+		if (this.viteDevServer) await this.viteDevServer.close();
+		if (this.remoteTunnelController) this.remoteTunnelController.cleanup();
+		if (this.config.plugins) {
+			for (const plugin of Object.values(this.config.plugins)) if (plugin.abortActiveOperations) try {
+				plugin.abortActiveOperations();
+			} catch (err) {
+				console.error(`Error aborting operations for plugin ${plugin.name}:`, err);
+			}
+		}
+		if (this.server) {
+			this.server.close(() => {
+				console.log("Server closed gracefully");
+				process.exit(0);
+			});
+			setTimeout(() => {
+				console.log("Force shutdown after timeout");
+				process.exit(1);
+			}, 15e3);
+		} else process.exit(0);
+	}
+};
+const EXCLUDED_PLUGINS = [ServerPlugin.name];
+const server = toPlugin(ServerPlugin, "server");
+
+//#endregion
+export { server };
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["server","endpoints: PluginEndpoints"],"sources":["../../src/server/index.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport type { Server as HTTPServer } from \"node:http\";\nimport path from \"node:path\";\nimport dotenv from \"dotenv\";\nimport express from \"express\";\nimport type { PluginPhase } from \"shared\";\nimport { Plugin, toPlugin } from \"../plugin\";\nimport { instrumentations } from \"../telemetry\";\nimport { databricksClientMiddleware } from \"../utils\";\nimport { RemoteTunnelController } from \"./remote-tunnel/remote-tunnel-controller\";\nimport { StaticServer } from \"./static-server\";\nimport type { ServerConfig } from \"./types\";\nimport { type PluginEndpoints, getRoutes } from \"./utils\";\nimport { ViteDevServer } from \"./vite-dev-server\";\n\ndotenv.config({ path: path.resolve(process.cwd(), \"./.env\") });\n\n/**\n * Server plugin for the AppKit.\n *\n * This plugin is responsible for starting the server and serving the static files.\n * It also handles the remote tunneling for development purposes.\n *\n * @example\n * ```ts\n * createApp({\n *   plugins: [server(), telemetryExamples(), analytics({})],\n * });\n * ```\n *\n */\nexport class ServerPlugin extends Plugin {\n  public static DEFAULT_CONFIG = {\n    autoStart: true,\n    host: process.env.FLASK_RUN_HOST || \"0.0.0.0\",\n    port: Number(process.env.DATABRICKS_APP_PORT) || 8000,\n  };\n\n  public name = \"server\" as const;\n  public envVars: string[] = [];\n  private serverApplication: express.Application;\n  private server: HTTPServer | null;\n  private viteDevServer?: ViteDevServer;\n  private remoteTunnelController?: RemoteTunnelController;\n  protected declare config: ServerConfig;\n  private serverExtensions: ((app: express.Application) => void)[] = [];\n  static phase: PluginPhase = \"deferred\";\n\n  constructor(config: ServerConfig) {\n    super(config);\n    this.config = config;\n    this.serverApplication = express();\n    this.server = null;\n    this.serverExtensions = [];\n    this.telemetry.registerInstrumentations([\n      instrumentations.http,\n      instrumentations.express,\n    ]);\n  }\n\n  /** Setup the server plugin. */\n  async setup() {\n    if (this.shouldAutoStart()) {\n      await this.start();\n    }\n  }\n\n  /** Get the server configuration. */\n  getConfig() {\n    const { plugins: _plugins, ...config } = this.config;\n\n    return config;\n  }\n\n  /** Check if the server should auto start. */\n  shouldAutoStart() {\n    return this.config.autoStart;\n  }\n\n  /**\n   * Start the server.\n   *\n   * This method starts the server and sets up the frontend.\n   * It also sets up the remote tunneling if enabled.\n   *\n   * @returns The express application.\n   */\n  async start(): Promise<express.Application> {\n    this.serverApplication.use(express.json());\n\n    const endpoints = await this.extendRoutes();\n\n    for (const extension of this.serverExtensions) {\n      extension(this.serverApplication);\n    }\n\n    // register remote tunnel controller (before static/vite)\n    this.remoteTunnelController = new RemoteTunnelController(\n      this.devFileReader,\n    );\n    this.serverApplication.use(this.remoteTunnelController.middleware);\n\n    await this.setupFrontend(endpoints);\n\n    const server = this.serverApplication.listen(\n      this.config.port ?? ServerPlugin.DEFAULT_CONFIG.port,\n      this.config.host ?? ServerPlugin.DEFAULT_CONFIG.host,\n      () => this.logStartupInfo(),\n    );\n\n    this.server = server;\n\n    // attach server to remote tunnel controller\n    this.remoteTunnelController.setServer(server);\n\n    process.on(\"SIGTERM\", () => this._gracefulShutdown());\n    process.on(\"SIGINT\", () => this._gracefulShutdown());\n\n    if (process.env.NODE_ENV === \"development\") {\n      const allRoutes = getRoutes(this.serverApplication._router.stack);\n      console.dir(allRoutes, { depth: null });\n    }\n    return this.serverApplication;\n  }\n\n  /**\n   * Get the low level node.js http server instance.\n   *\n   * Only use this method if you need to access the server instance for advanced usage like a custom websocket server, etc.\n   *\n   * @throws {Error} If the server is not started or autoStart is true.\n   * @returns {HTTPServer} The server instance.\n   */\n  getServer(): HTTPServer {\n    if (this.shouldAutoStart()) {\n      throw new Error(\"Cannot get server when autoStart is true.\");\n    }\n\n    if (!this.server) {\n      throw new Error(\n        \"Server not started. Please start the server first by calling the start() method.\",\n      );\n    }\n\n    return this.server;\n  }\n\n  /**\n   * Extend the server with custom routes or middleware.\n   *\n   * @param fn - A function that receives the express application.\n   * @returns The server plugin instance for chaining.\n   * @throws {Error} If autoStart is true.\n   */\n  extend(fn: (app: express.Application) => void) {\n    if (this.shouldAutoStart()) {\n      throw new Error(\"Cannot extend server when autoStart is true.\");\n    }\n\n    this.serverExtensions.push(fn);\n    return this;\n  }\n\n  /**\n   * Setup the routes with the plugins.\n   *\n   * This method goes through all the plugins and injects the routes into the server application.\n   * Returns a map of plugin names to their registered named endpoints.\n   */\n  private async extendRoutes(): Promise<PluginEndpoints> {\n    const endpoints: PluginEndpoints = {};\n\n    if (!this.config.plugins) return endpoints;\n\n    this.serverApplication.get(\"/health\", (_, res) => {\n      res.status(200).json({ status: \"ok\" });\n    });\n    this.registerEndpoint(\"health\", \"/health\");\n\n    for (const plugin of Object.values(this.config.plugins)) {\n      if (EXCLUDED_PLUGINS.includes(plugin.name)) continue;\n\n      if (plugin?.injectRoutes && typeof plugin.injectRoutes === \"function\") {\n        const router = express.Router();\n\n        // add databricks client middleware to the router if the plugin needs the request context\n        if (plugin.requiresDatabricksClient)\n          router.use(await databricksClientMiddleware());\n\n        plugin.injectRoutes(router);\n\n        const basePath = `/api/${plugin.name}`;\n        this.serverApplication.use(basePath, router);\n\n        // Collect named endpoints from the plugin\n        endpoints[plugin.name] = plugin.getEndpoints();\n      }\n    }\n\n    return endpoints;\n  }\n\n  /**\n   * Setup frontend serving based on environment:\n   * - If staticPath is explicitly provided: use static server\n   * - Dev mode (no staticPath): Vite for HMR\n   * - Production (no staticPath): Static files auto-detected\n   */\n  private async setupFrontend(endpoints: PluginEndpoints) {\n    const isDev = process.env.NODE_ENV === \"development\";\n    const hasExplicitStaticPath = this.config.staticPath !== undefined;\n\n    // explict static path provided\n    if (hasExplicitStaticPath) {\n      const staticServer = new StaticServer(\n        this.serverApplication,\n        this.config.staticPath as string,\n        endpoints,\n      );\n      staticServer.setup();\n      return;\n    }\n\n    // auto-detection based on environment\n    if (isDev) {\n      this.viteDevServer = new ViteDevServer(this.serverApplication, endpoints);\n      await this.viteDevServer.setup();\n      return;\n    }\n\n    // auto-detection based on static path\n    const staticPath = ServerPlugin.findStaticPath();\n    if (staticPath) {\n      const staticServer = new StaticServer(\n        this.serverApplication,\n        staticPath,\n        endpoints,\n      );\n\n      staticServer.setup();\n    }\n  }\n\n  private static findStaticPath() {\n    const staticPaths = [\"dist\", \"client/dist\", \"build\", \"public\", \"out\"];\n    const cwd = process.cwd();\n    for (const p of staticPaths) {\n      const fullPath = path.resolve(cwd, p);\n      if (fs.existsSync(path.resolve(fullPath, \"index.html\"))) {\n        console.log(`Static files: serving from ${fullPath}`);\n        return fullPath;\n      }\n    }\n    return undefined;\n  }\n\n  private logStartupInfo() {\n    const isDev = process.env.NODE_ENV === \"development\";\n    const hasExplicitStaticPath = this.config.staticPath !== undefined;\n    const port = this.config.port ?? ServerPlugin.DEFAULT_CONFIG.port;\n    const host = this.config.host ?? ServerPlugin.DEFAULT_CONFIG.host;\n\n    console.log(`Server running on http://${host}:${port}`);\n\n    if (hasExplicitStaticPath) {\n      console.log(`Mode: static (${this.config.staticPath})`);\n    } else if (isDev) {\n      console.log(\"Mode: development (Vite HMR)\");\n    } else {\n      console.log(\"Mode: production (static)\");\n    }\n\n    const remoteServerController = this.remoteTunnelController;\n    if (!remoteServerController) {\n      console.log(\"Remote tunnel: disabled (controller not initialized)\");\n    } else {\n      console.log(\n        `Remote tunnel: ${\n          remoteServerController.isAllowedByEnv() ? \"allowed\" : \"blocked\"\n        }; ${remoteServerController.isActive() ? \"active\" : \"inactive\"}`,\n      );\n    }\n  }\n\n  private async _gracefulShutdown() {\n    console.log(\"Starting graceful shutdown...\");\n\n    if (this.viteDevServer) {\n      await this.viteDevServer.close();\n    }\n\n    if (this.remoteTunnelController) {\n      this.remoteTunnelController.cleanup();\n    }\n\n    // 1. abort active operations from plugins\n    if (this.config.plugins) {\n      for (const plugin of Object.values(this.config.plugins)) {\n        if (plugin.abortActiveOperations) {\n          try {\n            plugin.abortActiveOperations();\n          } catch (err) {\n            console.error(\n              `Error aborting operations for plugin ${plugin.name}:`,\n              err,\n            );\n          }\n        }\n      }\n    }\n\n    // 2. close the server\n    if (this.server) {\n      this.server.close(() => {\n        console.log(\"Server closed gracefully\");\n        process.exit(0);\n      });\n\n      // 3. timeout to force shutdown after 15 seconds\n      setTimeout(() => {\n        console.log(\"Force shutdown after timeout\");\n        process.exit(1);\n      }, 15000);\n    } else {\n      process.exit(0);\n    }\n  }\n}\n\nconst EXCLUDED_PLUGINS = [ServerPlugin.name];\n\nexport const server = toPlugin<typeof ServerPlugin, ServerConfig, \"server\">(\n  ServerPlugin,\n  \"server\",\n);\n"],"mappings":"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"}

package/dist/server/remote-tunnel/denied.html

@@ -0,0 +1,68 @@
+<html>
+  <head>
+    <meta charset="UTF-8" />
+    <title>Access Denied</title>
+    <style>
+      body {
+        background: #1b1b1d;
+        height: 100vh;
+        margin: 0;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "Roboto", "Helvetica", "Arial", sans-serif;
+      }
+      .container {
+        text-align: center;
+        padding: 50px 70px;
+        max-width: 500px;
+      }
+      .icon {
+        font-size: 64px;
+        margin-bottom: 24px;
+      }
+      h1 {
+        font-size: 1.5rem;
+        color: #ffffff;
+        margin: 0 0 16px 0;
+        font-weight: 500;
+      }
+      p {
+        font-size: 0.875rem;
+        color: rgba(255, 255, 255, 0.6);
+        line-height: 1.6;
+        margin: 0 0 24px 0;
+      }
+      .retry-btn {
+        background: #ff3621;
+        color: white;
+        border: none;
+        padding: 12px 24px;
+        border-radius: 6px;
+        font-size: 0.875rem;
+        font-weight: 500;
+        cursor: pointer;
+        text-decoration: none;
+        display: inline-block;
+      }
+      .retry-btn:hover {
+        background: #e62e1a;
+      }
+      .tunnel-id {
+        font-size: 0.75rem;
+        color: rgba(255, 255, 255, 0.4);
+        margin-top: 24px;
+        font-family: monospace;
+      }
+    </style>
+  </head>
+  <body>
+    <div class="container">
+      <div class="icon">🚫</div>
+      <h1>Access Denied</h1>
+      <p>The tunnel owner has declined your request to view their local environment.</p>
+      <a href="?dev={{tunnelId}}&retry=true" class="retry-btn">Request Access Again</a>
+      <div class="tunnel-id">Tunnel ID: {{tunnelId}}</div>
+    </div>
+  </body>
+</html>

package/dist/server/remote-tunnel/gate.js

@@ -0,0 +1,51 @@
+//#region src/server/remote-tunnel/gate.ts
+/** Assets prefixes that are served through the remote tunnel */
+const REMOTE_TUNNEL_ASSET_PREFIXES = [
+	"/@vite/",
+	"/@fs/",
+	"/node_modules/.vite/deps/",
+	"/node_modules/vite/",
+	"/src/",
+	"/@react-refresh"
+];
+/**
+* Check if the server is running in local development mode
+* - NODE_ENV is set to "development"
+* @param env - the environment variables
+* @returns true if the server is running in local development mode
+*/
+function isLocalDev(env = process.env) {
+	return env.NODE_ENV === "development";
+}
+/**
+* Check if the environment allows the remote tunnel
+* - not in local development mode
+* - DISABLE_REMOTE_SERVING is not set to "true"
+* - DATABRICKS_CLIENT_SECRET is set
+* @param env - the environment variables
+* @returns true if the environment allows the remote tunnel
+*/
+function isRemoteTunnelAllowedByEnv(env = process.env) {
+	return !isLocalDev(env) && env.DISABLE_REMOTE_SERVING !== "true" && Boolean(env.DATABRICKS_CLIENT_SECRET);
+}
+/**
+* Check if the request has a dev query parameter
+* @param req - the request
+* @returns true if the request has a dev query parameter
+*/
+function hasDevQuery(req) {
+	return "dev" in req.query;
+}
+/**
+* Check if the request is an asset request
+* @param req - the request
+* @returns true if the request is an asset request
+*/
+function isRemoteTunnelAssetRequest(req) {
+	const path = req.originalUrl;
+	return REMOTE_TUNNEL_ASSET_PREFIXES.some((prefix) => path.startsWith(prefix));
+}
+
+//#endregion
+export { REMOTE_TUNNEL_ASSET_PREFIXES, hasDevQuery, isLocalDev, isRemoteTunnelAllowedByEnv, isRemoteTunnelAssetRequest };
+//# sourceMappingURL=gate.js.map

package/dist/server/remote-tunnel/gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.js","names":[],"sources":["../../../src/server/remote-tunnel/gate.ts"],"sourcesContent":["import type express from \"express\";\n\n/** Assets prefixes that are served through the remote tunnel */\nexport const REMOTE_TUNNEL_ASSET_PREFIXES = [\n  \"/@vite/\",\n  \"/@fs/\",\n  \"/node_modules/.vite/deps/\",\n  \"/node_modules/vite/\",\n  \"/src/\",\n  \"/@react-refresh\",\n];\n\n/**\n * Check if the server is running in local development mode\n * - NODE_ENV is set to \"development\"\n * @param env - the environment variables\n * @returns true if the server is running in local development mode\n */\nexport function isLocalDev(env: NodeJS.ProcessEnv = process.env): boolean {\n  return env.NODE_ENV === \"development\";\n}\n\n/**\n * Check if the environment allows the remote tunnel\n * - not in local development mode\n * - DISABLE_REMOTE_SERVING is not set to \"true\"\n * - DATABRICKS_CLIENT_SECRET is set\n * @param env - the environment variables\n * @returns true if the environment allows the remote tunnel\n */\nexport function isRemoteTunnelAllowedByEnv(\n  env: NodeJS.ProcessEnv = process.env,\n): boolean {\n  return (\n    !isLocalDev(env) &&\n    env.DISABLE_REMOTE_SERVING !== \"true\" &&\n    Boolean(env.DATABRICKS_CLIENT_SECRET)\n  );\n}\n\n/**\n * Check if the request has a dev query parameter\n * @param req - the request\n * @returns true if the request has a dev query parameter\n */\nexport function hasDevQuery(req: express.Request): boolean {\n  const queryParams = req.query;\n\n  return \"dev\" in queryParams;\n}\n\n/**\n * Check if the request is an asset request\n * @param req - the request\n * @returns true if the request is an asset request\n */\nexport function isRemoteTunnelAssetRequest(req: express.Request): boolean {\n  const path = req.originalUrl;\n  return REMOTE_TUNNEL_ASSET_PREFIXES.some((prefix) => path.startsWith(prefix));\n}\n"],"mappings":";;AAGA,MAAa,+BAA+B;CAC1C;CACA;CACA;CACA;CACA;CACA;CACD;;;;;;;AAQD,SAAgB,WAAW,MAAyB,QAAQ,KAAc;AACxE,QAAO,IAAI,aAAa;;;;;;;;;;AAW1B,SAAgB,2BACd,MAAyB,QAAQ,KACxB;AACT,QACE,CAAC,WAAW,IAAI,IAChB,IAAI,2BAA2B,UAC/B,QAAQ,IAAI,yBAAyB;;;;;;;AASzC,SAAgB,YAAY,KAA+B;AAGzD,QAAO,SAFa,IAAI;;;;;;;AAU1B,SAAgB,2BAA2B,KAA+B;CACxE,MAAM,OAAO,IAAI;AACjB,QAAO,6BAA6B,MAAM,WAAW,KAAK,WAAW,OAAO,CAAC"}

package/dist/server/remote-tunnel/index.html

@@ -0,0 +1,165 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <title>Local Environment Preview</title>
+  </head>
+  <body>
+    <div id="root">
+      <style>
+        body {
+          background: #1b1b1d;
+          height: 100vh;
+          margin: 0;
+          display: flex;
+          align-items: center;
+          justify-content: center;
+          font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "Roboto",
+            "Helvetica", "Arial", sans-serif;
+        }
+        .loader-container {
+          display: flex;
+          flex-direction: column;
+          align-items: center;
+          padding: 50px 70px;
+        }
+        .logo {
+          width: 64px;
+          height: 64px;
+          margin-bottom: 32px;
+          position: relative;
+        }
+        .logo svg {
+          width: 100%;
+          height: 100%;
+        }
+        .spinner {
+          width: 32px;
+          height: 32px;
+          border: 3px solid rgba(255, 255, 255, 0.1);
+          border-top: 3px solid #ff3621;
+          border-radius: 50%;
+          animation: spin 0.8s linear infinite;
+          margin-bottom: 32px;
+        }
+        @keyframes spin {
+          0% {
+            transform: rotate(0deg);
+          }
+          100% {
+            transform: rotate(360deg);
+          }
+        }
+        .loading-text {
+          font-size: 1.125rem;
+          color: #ffffff;
+          letter-spacing: 0.02em;
+          font-weight: 400;
+          text-align: center;
+          margin-top: 0;
+          opacity: 0.9;
+        }
+        .databricks-brand {
+          font-size: 0.875rem;
+          color: rgba(255, 255, 255, 0.5);
+          margin-top: 16px;
+          letter-spacing: 0.05em;
+          text-transform: uppercase;
+          font-weight: 500;
+        }
+        .dots {
+          display: inline-block;
+          animation: dots 1.5s steps(4, end) infinite;
+        }
+        @keyframes dots {
+          0%,
+          20% {
+            content: ".";
+          }
+          40% {
+            content: "..";
+          }
+          60%,
+          100% {
+            content: "...";
+          }
+        }
+      </style>
+      <div class="loader-container">
+        <div class="logo">
+          <svg
+            version="1.1"
+            id="Layer_1"
+            xmlns:x="ns_extend;"
+            xmlns:i="ns_ai;"
+            xmlns:graph="ns_graphs;"
+            xmlns="http://www.w3.org/2000/svg"
+            xmlns:xlink="http://www.w3.org/1999/xlink"
+            x="0px"
+            y="0px"
+            viewBox="0 0 40.1 42"
+            style="enable-background: new 0 0 40.1 42"
+            xml:space="preserve"
+          >
+            <style type="text/css">
+              .st0 {
+                fill: #ff3621;
+              }
+            </style>
+            <metadata>
+              <sfw xmlns="ns_sfw;">
+                <slices></slices>
+                <sliceSourceBounds
+                  bottomLeftOrigin="true"
+                  height="42"
+                  width="40.1"
+                  x="-69.1"
+                  y="-10.5"
+                ></sliceSourceBounds>
+              </sfw>
+            </metadata>
+            <g>
+              <path
+                class="st0"
+                d="M40.1,31.1v-7.4l-0.8-0.5L20.1,33.7l-18.2-10l0-4.3l18.2,9.9l20.1-10.9v-7.3l-0.8-0.5L20.1,21.2L2.6,11.6
+           L20.1,2l14.1,7.7l1.1-0.6V8.3L20.1,0L0,10.9V12L20.1,23l18.2-10v4.4l-18.2,10L0.8,16.8L0,17.3v7.4l20.1,10.9l18.2-9.9v4.3l-18.2,10
+           L0.8,29.5L0,30v1.1L20.1,42L40.1,31.1z"
+              ></path>
+            </g>
+          </svg>
+        </div>
+
+        <div class="spinner"></div>
+        <div class="loading-text">
+          Loading local environment<span class="dots">...</span>
+        </div>
+        <div class="databricks-brand">Databricks</div>
+      </div>
+    </div>
+    <script type="module">
+      import RefreshRuntime from "/@react-refresh";
+      if (!window.__vite_plugin_react_preamble_installed__) {
+        RefreshRuntime.injectIntoGlobalHook(window);
+        window.$RefreshReg$ = () => {};
+        window.$RefreshSig$ = () => (type) => type;
+        window.__vite_plugin_react_preamble_installed__ = true;
+      }
+    </script>
+
+    <script id="vite-client" type="module" src="/@vite/client"></script>
+    <script type="module" src="/src/main.tsx"></script>
+    <script>
+      const viteClient = document.getElementById("vite-client");
+      if (viteClient) {
+        viteClient.onload = () => {
+          console.log("Vite client loaded");
+        };
+        viteClient.onerror = () => {
+          setTimeout(() => {
+            window.location.reload();
+          }, 1000);
+        };
+      }
+    </script>
+  </body>
+</html>

package/dist/server/remote-tunnel/remote-tunnel-controller.js

@@ -0,0 +1,100 @@
+import { hasDevQuery, isLocalDev, isRemoteTunnelAllowedByEnv, isRemoteTunnelAssetRequest } from "./gate.js";
+
+//#region src/server/remote-tunnel/remote-tunnel-controller.ts
+/**
+* Controller for the remote tunnel
+*
+* - Reads files from the dev file reader
+* - Manages the remote tunnel manager
+* - Sets up the web socket
+* - Cleans up the remote tunnel
+*/
+var RemoteTunnelController = class {
+	constructor(devFileReader) {
+		this.middleware = async (req, res, next) => {
+			if (isLocalDev()) return next();
+			if (!this.isAllowedByEnv()) return next();
+			const wantsDev = hasDevQuery(req);
+			const wantsRemoteAssets = isRemoteTunnelAssetRequest(req);
+			if (!wantsDev && !wantsRemoteAssets) return next();
+			const manager = await this.getOrInitManager();
+			if (!manager) return next();
+			if (wantsDev) return manager.devModeMiddleware()(req, res, next);
+			try {
+				await manager.assetMiddleware()(req, res);
+			} catch (error) {
+				next(error);
+			}
+		};
+		this.devFileReader = devFileReader;
+		this.manager = null;
+		this.initPromise = null;
+		this.wsReady = false;
+	}
+	/**
+	* Set the server instance
+	* @param server
+	*/
+	setServer(server) {
+		this.server = server;
+		this.maybeSetupWebSocket();
+	}
+	/** Check if the remote tunnel is active */
+	isActive() {
+		return this.manager != null;
+	}
+	/** Check if the remote tunnel is allowed by the environment */
+	isAllowedByEnv() {
+		return isRemoteTunnelAllowedByEnv();
+	}
+	/** Cleanup the remote tunnel */
+	cleanup() {
+		try {
+			this.manager?.cleanup();
+		} finally {
+			this.manager = null;
+			this.initPromise = null;
+			this.wsReady = false;
+		}
+	}
+	/**
+	* Get or initialize the remote tunnel manager
+	* - If the manager is already initialized, return it
+	* - If the manager is not initialized, initialize it
+	* - If the manager is not allowed by the environment, return null
+	* @returns the remote tunnel manager
+	*/
+	async getOrInitManager() {
+		if (this.manager) return this.manager;
+		if (this.initPromise) return await this.initPromise;
+		this.initPromise = (async () => {
+			if (isLocalDev() || !isRemoteTunnelAllowedByEnv()) return null;
+			const remoteTunnelManager = new (await (import("./remote-tunnel-manager.js"))).RemoteTunnelManager(this.devFileReader);
+			this.manager = remoteTunnelManager;
+			this.maybeSetupWebSocket();
+			console.log("RemoteTunnel: initialized (on-demand)");
+			return remoteTunnelManager;
+		})();
+		return this.initPromise;
+	}
+	/**
+	* Setup the web socket
+	* - If the server is not set, return
+	* - If the manager is not set, return
+	* - If the web socket is already setup, return
+	* - Setup the web socket
+	*/
+	maybeSetupWebSocket() {
+		if (!this.server) return;
+		if (!this.manager) return;
+		if (this.wsReady) return;
+		this.manager.setServer(this.server);
+		this.manager.setupWebSocket();
+		this.wsReady = true;
+		console.log("RemoteTunnel: web socket setup complete");
+	}
+};
+
+//#endregion
+export { RemoteTunnelController };
+//# sourceMappingURL=remote-tunnel-controller.js.map

package/dist/server/remote-tunnel/remote-tunnel-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-tunnel-controller.js","names":[],"sources":["../../../src/server/remote-tunnel/remote-tunnel-controller.ts"],"sourcesContent":["import type { Server as HTTPServer } from \"node:http\";\nimport type express from \"express\";\nimport type { DevFileReader } from \"../../plugin/dev-reader\";\nimport {\n  hasDevQuery,\n  isLocalDev,\n  isRemoteTunnelAllowedByEnv,\n  isRemoteTunnelAssetRequest,\n} from \"./gate\";\nimport type { RemoteTunnelManager } from \"./remote-tunnel-manager\";\n\n/**\n * Controller for the remote tunnel\n *\n * - Reads files from the dev file reader\n * - Manages the remote tunnel manager\n * - Sets up the web socket\n * - Cleans up the remote tunnel\n */\nexport class RemoteTunnelController {\n  private devFileReader: DevFileReader;\n  private server?: HTTPServer;\n  private manager: RemoteTunnelManager | null;\n  private initPromise: Promise<RemoteTunnelManager | null> | null;\n  private wsReady: boolean;\n\n  constructor(devFileReader: DevFileReader) {\n    this.devFileReader = devFileReader;\n    this.manager = null;\n    this.initPromise = null;\n    this.wsReady = false;\n  }\n\n  /**\n   * Set the server instance\n   * @param server\n   */\n  setServer(server: HTTPServer) {\n    this.server = server;\n    this.maybeSetupWebSocket();\n  }\n\n  /** Check if the remote tunnel is active */\n  isActive(): boolean {\n    return this.manager != null;\n  }\n\n  /** Check if the remote tunnel is allowed by the environment */\n  isAllowedByEnv(): boolean {\n    return isRemoteTunnelAllowedByEnv();\n  }\n\n  /**\n   * Middleware for the remote tunnel\n   * - Hard blocks in local dev\n   * - Blocks when not allowed by env\n   * - Handles dev query and asset requests\n   * @param req - the request\n   * @param res - the response\n   * @param next - the next function\n   * @returns the next function\n   */\n  middleware: express.RequestHandler = async (req, res, next) => {\n    // hard blocker in local dev\n    if (isLocalDev()) return next();\n\n    // if not allowed by env, block\n    if (!this.isAllowedByEnv()) return next();\n\n    const wantsDev = hasDevQuery(req);\n    const wantsRemoteAssets = isRemoteTunnelAssetRequest(req);\n\n    // if not wants dev and not wants remote assets, skip\n    if (!wantsDev && !wantsRemoteAssets) return next();\n\n    const manager = await this.getOrInitManager();\n    // if no manager, skip\n    if (!manager) return next();\n\n    // dev query present, let manager handle it\n    if (wantsDev) {\n      return manager.devModeMiddleware()(req, res, next);\n    }\n\n    // otherwise, handle vite asset fetch paths through the tunnel\n    try {\n      await manager.assetMiddleware()(req, res);\n    } catch (error) {\n      next(error);\n    }\n  };\n\n  /** Cleanup the remote tunnel */\n  cleanup() {\n    try {\n      this.manager?.cleanup();\n    } finally {\n      this.manager = null;\n      this.initPromise = null;\n      this.wsReady = false;\n    }\n  }\n\n  /**\n   * Get or initialize the remote tunnel manager\n   * - If the manager is already initialized, return it\n   * - If the manager is not initialized, initialize it\n   * - If the manager is not allowed by the environment, return null\n   * @returns the remote tunnel manager\n   */\n  private async getOrInitManager(): Promise<RemoteTunnelManager | null> {\n    if (this.manager) return this.manager;\n    if (this.initPromise) return await this.initPromise;\n\n    this.initPromise = (async () => {\n      // double check gate\n      if (isLocalDev() || !isRemoteTunnelAllowedByEnv()) return null;\n      const mod = await import(\"./remote-tunnel-manager\");\n      const remoteTunnelManager = new mod.RemoteTunnelManager(\n        this.devFileReader,\n      );\n      this.manager = remoteTunnelManager;\n\n      // attach server + ws setup\n      this.maybeSetupWebSocket();\n\n      console.log(\"RemoteTunnel: initialized (on-demand)\");\n      return remoteTunnelManager;\n    })();\n\n    return this.initPromise;\n  }\n\n  /**\n   * Setup the web socket\n   * - If the server is not set, return\n   * - If the manager is not set, return\n   * - If the web socket is already setup, return\n   * - Setup the web socket\n   */\n  private maybeSetupWebSocket() {\n    if (!this.server) return;\n    if (!this.manager) return;\n    if (this.wsReady) return;\n\n    this.manager.setServer(this.server);\n    this.manager.setupWebSocket();\n    this.wsReady = true;\n\n    console.log(\"RemoteTunnel: web socket setup complete\");\n  }\n}\n"],"mappings":";;;;;;;;;;;AAmBA,IAAa,yBAAb,MAAoC;CAOlC,YAAY,eAA8B;oBAoCL,OAAO,KAAK,KAAK,SAAS;AAE7D,OAAI,YAAY,CAAE,QAAO,MAAM;AAG/B,OAAI,CAAC,KAAK,gBAAgB,CAAE,QAAO,MAAM;GAEzC,MAAM,WAAW,YAAY,IAAI;GACjC,MAAM,oBAAoB,2BAA2B,IAAI;AAGzD,OAAI,CAAC,YAAY,CAAC,kBAAmB,QAAO,MAAM;GAElD,MAAM,UAAU,MAAM,KAAK,kBAAkB;AAE7C,OAAI,CAAC,QAAS,QAAO,MAAM;AAG3B,OAAI,SACF,QAAO,QAAQ,mBAAmB,CAAC,KAAK,KAAK,KAAK;AAIpD,OAAI;AACF,UAAM,QAAQ,iBAAiB,CAAC,KAAK,IAAI;YAClC,OAAO;AACd,SAAK,MAAM;;;AA7Db,OAAK,gBAAgB;AACrB,OAAK,UAAU;AACf,OAAK,cAAc;AACnB,OAAK,UAAU;;;;;;CAOjB,UAAU,QAAoB;AAC5B,OAAK,SAAS;AACd,OAAK,qBAAqB;;;CAI5B,WAAoB;AAClB,SAAO,KAAK,WAAW;;;CAIzB,iBAA0B;AACxB,SAAO,4BAA4B;;;CA4CrC,UAAU;AACR,MAAI;AACF,QAAK,SAAS,SAAS;YACf;AACR,QAAK,UAAU;AACf,QAAK,cAAc;AACnB,QAAK,UAAU;;;;;;;;;;CAWnB,MAAc,mBAAwD;AACpE,MAAI,KAAK,QAAS,QAAO,KAAK;AAC9B,MAAI,KAAK,YAAa,QAAO,MAAM,KAAK;AAExC,OAAK,eAAe,YAAY;AAE9B,OAAI,YAAY,IAAI,CAAC,4BAA4B,CAAE,QAAO;GAE1D,MAAM,sBAAsB,KADhB,OAAM,OAAO,gCACW,oBAClC,KAAK,cACN;AACD,QAAK,UAAU;AAGf,QAAK,qBAAqB;AAE1B,WAAQ,IAAI,wCAAwC;AACpD,UAAO;MACL;AAEJ,SAAO,KAAK;;;;;;;;;CAUd,AAAQ,sBAAsB;AAC5B,MAAI,CAAC,KAAK,OAAQ;AAClB,MAAI,CAAC,KAAK,QAAS;AACnB,MAAI,KAAK,QAAS;AAElB,OAAK,QAAQ,UAAU,KAAK,OAAO;AACnC,OAAK,QAAQ,gBAAgB;AAC7B,OAAK,UAAU;AAEf,UAAQ,IAAI,0CAA0C"}