@hatchkit/dev-plugin-vite 0.1.45

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import type { Plugin } from "vite";
+export interface LocalDevOptions {
+    slug?: string;
+    /** Suppress all stdout output (Caddy fragment + tailscale probe
+     *  still run, just no banner). */
+    silent?: boolean;
+}
+export declare function localDev(options?: LocalDevOptions): Plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiDA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;sCACkC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,MAAM,CAgC9D"}

package/dist/index.js

@@ -0,0 +1,137 @@
+/*
+ * @hatchkit/dev-plugin-vite — Vite integration for hatchkit's
+ * Tailscale-served dev URL flow.
+ *
+ * Usage:
+ *
+ *   // vite.config.ts
+ *   import { defineConfig } from "vite";
+ *   import react from "@vitejs/plugin-react";
+ *   import { localDev } from "@hatchkit/dev-plugin-vite";
+ *
+ *   export default defineConfig({
+ *     plugins: [react(), localDev({ slug: "raptor-runner" })],
+ *   });
+ *
+ * What it does on `vite` (dev server) startup:
+ *
+ *   1. Resolves the project's slug from (in order): the explicit
+ *      `slug` option → `.hatchkit.json` (walking up from cwd) →
+ *      package.json `name`.
+ *   2. Reads the live dev port from the running server's
+ *      `httpServer.address()` — so `--port` overrides are respected.
+ *   3. Writes ~/.config/dev/projects/<slug>.caddy with a
+ *      `reverse_proxy 127.0.0.1:<port>` directive. Caddy's --watch
+ *      picks the change up without a restart.
+ *   4. Probes `tailscale serve status` for the TCP=443 bridge that
+ *      `hatchkit dev-setup init` registers once per machine.
+ *   5. Replaces Vite's default `Local / Network` URL banner with
+ *      `Local / Tailscale`. Network-IP entries are dropped — the
+ *      Tailscale URL covers every device that matters.
+ *
+ * Failure modes surface inline with actionable hints (see the banner
+ * cases in initLocalDev). The plugin never throws — a broken local-dev
+ * pipeline should not break the dev server.
+ *
+ * Opt out entirely with `HATCHKIT_LOCAL_DEV=0`. Production builds
+ * (`apply: "serve"`) are pass-through.
+ */
+import { isLocalDevActive, localDevUrl, readCaddyPort, resolveSlug, tailscaleIdentity, tailscaleServeTcpTarget, writeProjectFragment, } from "@hatchkit/dev-shared";
+export function localDev(options = {}) {
+    return {
+        name: "@hatchkit/dev-plugin-vite",
+        apply: "serve",
+        configureServer(server) {
+            if (process.env.HATCHKIT_LOCAL_DEV === "0")
+                return;
+            const originalPrintUrls = server.printUrls.bind(server);
+            server.printUrls = () => {
+                const info = server.config.logger.info;
+                const resolved = server.resolvedUrls;
+                // resolvedUrls is null when the host check rejected every binding;
+                // fall back to Vite's own printer so the user still sees something.
+                if (!resolved) {
+                    originalPrintUrls();
+                    return;
+                }
+                for (const url of resolved.local) {
+                    info(`  \x1b[32m➜\x1b[0m  \x1b[1mLocal\x1b[0m:   \x1b[36m${url}\x1b[0m`);
+                }
+                const addr = server.httpServer?.address();
+                const port = typeof addr === "object" && addr ? addr.port : null;
+                if (port === null)
+                    return;
+                // Tailscale state is async; fire-and-forget so the banner
+                // appends after Local. Vite's logger handles ordering fine
+                // even when we trail behind by a few hundred ms.
+                void appendTailscaleBanner({ port, options, info });
+            };
+        },
+    };
+}
+async function appendTailscaleBanner({ port, options, info }) {
+    const label = (text) => `\x1b[1mTailscale\x1b[0m: ${text}`;
+    const greenArrow = "\x1b[32m➜\x1b[0m";
+    const yellowArrow = "\x1b[33m➜\x1b[0m";
+    const dimArrow = "\x1b[2m➜\x1b[0m";
+    const resolved = resolveSlug({ explicit: options.slug });
+    if (!resolved) {
+        info(`  ${yellowArrow}  ${label("local-dev disabled (no slug — set { slug } or add a package.json name).")}`);
+        return;
+    }
+    let fragmentResult = "unchanged";
+    try {
+        fragmentResult = writeProjectFragment(resolved.slug, port);
+    }
+    catch (err) {
+        info(`  ${yellowArrow}  ${label(`Caddy fragment write failed: ${err.message}`)}`);
+        return;
+    }
+    if (fragmentResult === "created" || fragmentResult === "updated") {
+        info(`  ${dimArrow}  ${label(`rewriting Caddy fragment for port ${port}…`)}`);
+    }
+    if (!isLocalDevActive()) {
+        info(`  ${yellowArrow}  ${label("host bridge not configured.")}`);
+        info("        Run once: `hatchkit dev-setup init` (sets up Caddy + tailscale serve).");
+        return;
+    }
+    const caddyPort = readCaddyPort();
+    if (caddyPort === null) {
+        info(`  ${yellowArrow}  ${label("Caddyfile has no https_port directive — re-run `hatchkit dev-setup init`.")}`);
+        return;
+    }
+    const tsId = await tailscaleIdentity();
+    if (!tsId) {
+        // Tailscale offline / not installed — silent no-op, the user simply
+        // isn't on the tailnet today. The Caddy fragment is still in place
+        // for when they come back.
+        return;
+    }
+    const tcpTarget = await tailscaleServeTcpTarget();
+    if (tcpTarget === null) {
+        info(`  ${yellowArrow}  ${label("no port-443 bridge configured.")}`);
+        info(`        Run once: \x1b[2mtailscale serve --bg --tcp=443 tcp://localhost:${caddyPort}\x1b[0m`);
+        return;
+    }
+    if (tcpTarget !== caddyPort) {
+        info(`  ${yellowArrow}  ${label(`bridge points at localhost:${tcpTarget} but Caddy listens on ${caddyPort}.`)}`);
+        info("        Run: `hatchkit dev-setup init` to reconcile.");
+        return;
+    }
+    if (options.silent)
+        return;
+    const url = localDevUrl(resolved.slug);
+    const where = describeSource(resolved);
+    info(`  ${greenArrow}  ${label(`\x1b[36m${url}\x1b[0m  \x1b[2m(slug: ${where})\x1b[0m`)}`);
+}
+function describeSource(resolved) {
+    switch (resolved.source) {
+        case "explicit":
+            return "option";
+        case "manifest":
+            return ".hatchkit.json";
+        case "package-json":
+            return "package.json";
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@hatchkit/dev-plugin-vite",
+  "version": "0.1.45",
+  "description": "Vite plugin for hatchkit's local-dev integration. Writes the project's Caddy fragment on dev startup, replaces Vite's Local/Network URL banner with Local/Tailscale.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@hatchkit/dev-shared": "0.1.45"
+  },
+  "peerDependencies": {
+    "vite": ">=5"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0",
+    "vite": "^5.4.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  }
+}