@guckdev/vite 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,39 @@
+# @guckdev/vite
+
+Vite dev server plugin that proxies `/guck/emit` to a shared Guck MCP ingest
+endpoint and injects the project config server-side.
+
+## Install
+
+```sh
+pnpm add -D @guckdev/vite
+```
+
+## Usage
+
+```ts
+import { defineConfig } from "vite";
+import { guckVitePlugin } from "@guckdev/vite";
+
+export default defineConfig({
+  plugins: [guckVitePlugin()],
+});
+```
+
+Then point the browser SDK at `/guck/emit`.
+
+## Options
+
+```ts
+guckVitePlugin({
+  ingestUrl: "http://127.0.0.1:7331/guck/emit", // shared MCP ingest
+  configPath: "/absolute/path/or/project/root", // defaults to process.cwd()
+  path: "/guck/emit", // local Vite endpoint
+  enabled: true, // auto-disabled for non-dev
+});
+```
+
+Notes:
+- This plugin only runs in Vite dev server mode (`apply: "serve"`).
+- The project config path is injected as a header on the server side.
+- CORS preflight is handled for browser requests.

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import type { Plugin } from "vite";
+export type GuckVitePluginOptions = {
+    ingestUrl?: string;
+    configPath?: string;
+    path?: string;
+    enabled?: boolean;
+};
+export declare const guckVitePlugin: (options?: GuckVitePluginOptions) => 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":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AAIlD,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AA0EF,eAAO,MAAM,cAAc,aAAa,qBAAqB,KAAQ,MAsCpE,CAAC"}

package/dist/index.js

@@ -0,0 +1,99 @@
+import { Buffer } from "node:buffer";
+const DEFAULT_INGEST_URL = "http://127.0.0.1:7331/guck/emit";
+const DEFAULT_PATH = "/guck/emit";
+const applyCors = (res) => {
+    res.setHeader("Access-Control-Allow-Origin", "*");
+    res.setHeader("Access-Control-Allow-Methods", "POST, OPTIONS");
+    res.setHeader("Access-Control-Allow-Headers", "Content-Type");
+};
+const readBody = async (req) => {
+    return await new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (chunk) => {
+            chunks.push(Buffer.from(chunk));
+        });
+        req.on("end", () => resolve(Buffer.concat(chunks)));
+        req.on("aborted", () => reject(new Error("aborted")));
+        req.on("error", reject);
+    });
+};
+const readContentType = (req) => {
+    const header = req.headers["content-type"];
+    if (Array.isArray(header)) {
+        return header[0] ?? "application/json";
+    }
+    return header ?? "application/json";
+};
+const handleProxy = async (req, res, ingestUrl, configPath) => {
+    let body;
+    try {
+        body = await readBody(req);
+    }
+    catch {
+        applyCors(res);
+        res.statusCode = 400;
+        res.setHeader("Content-Type", "application/json; charset=utf-8");
+        res.end(JSON.stringify({ ok: false, error: "Request aborted" }));
+        return;
+    }
+    try {
+        const response = await fetch(ingestUrl, {
+            method: "POST",
+            headers: {
+                "content-type": readContentType(req),
+                "x-guck-config-path": configPath,
+            },
+            body,
+        });
+        applyCors(res);
+        res.statusCode = response.status;
+        const contentType = response.headers.get("content-type");
+        if (contentType) {
+            res.setHeader("Content-Type", contentType);
+        }
+        const payload = Buffer.from(await response.arrayBuffer());
+        res.end(payload);
+    }
+    catch {
+        applyCors(res);
+        res.statusCode = 502;
+        res.setHeader("Content-Type", "application/json; charset=utf-8");
+        res.end(JSON.stringify({ ok: false, error: "Upstream unreachable" }));
+    }
+};
+export const guckVitePlugin = (options = {}) => {
+    const ingestUrl = options.ingestUrl ?? DEFAULT_INGEST_URL;
+    const configPath = options.configPath ?? process.cwd();
+    const path = options.path ?? DEFAULT_PATH;
+    const enabled = options.enabled ?? true;
+    return {
+        name: "guck-vite",
+        apply: "serve",
+        configureServer(server) {
+            if (!enabled) {
+                return;
+            }
+            server.middlewares.use(async (req, res, next) => {
+                const url = new URL(req.url ?? "", "http://localhost");
+                if (url.pathname !== path) {
+                    next();
+                    return;
+                }
+                if (req.method === "OPTIONS") {
+                    applyCors(res);
+                    res.statusCode = 204;
+                    res.end();
+                    return;
+                }
+                if (req.method !== "POST") {
+                    applyCors(res);
+                    res.statusCode = 404;
+                    res.end();
+                    return;
+                }
+                await handleProxy(req, res, ingestUrl, configPath);
+            });
+        },
+    };
+};
+//# 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,40 @@
+{
+  "name": "@guckdev/vite",
+  "version": "0.1.0",
+  "description": "Vite plugin for Guck browser ingest",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tillkolter/guck-mcp"
+  },
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "tsconfig.json"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "vite": "^5.0.0 || ^6.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "25.2.2",
+    "vite": "^5.4.0"
+  },
+  "scripts": {
+    "build": "pnpm --package=typescript@5.6.3 dlx tsc -p tsconfig.json",
+    "build:watch": "pnpm --package=typescript@5.6.3 dlx tsc -p tsconfig.json --watch",
+    "test": "pnpm run build && node --test test/*.test.js"
+  }
+}

package/src/index.ts

@@ -0,0 +1,122 @@
+import type { Plugin, ViteDevServer } from "vite";
+import { Buffer } from "node:buffer";
+import type { IncomingMessage, ServerResponse } from "node:http";
+
+export type GuckVitePluginOptions = {
+  ingestUrl?: string;
+  configPath?: string;
+  path?: string;
+  enabled?: boolean;
+};
+
+const DEFAULT_INGEST_URL = "http://127.0.0.1:7331/guck/emit";
+const DEFAULT_PATH = "/guck/emit";
+
+const applyCors = (res: ServerResponse): void => {
+  res.setHeader("Access-Control-Allow-Origin", "*");
+  res.setHeader("Access-Control-Allow-Methods", "POST, OPTIONS");
+  res.setHeader("Access-Control-Allow-Headers", "Content-Type");
+};
+
+const readBody = async (req: IncomingMessage): Promise<Buffer> => {
+  return await new Promise((resolve, reject) => {
+    const chunks: Buffer[] = [];
+    req.on("data", (chunk) => {
+      chunks.push(Buffer.from(chunk));
+    });
+    req.on("end", () => resolve(Buffer.concat(chunks)));
+    req.on("aborted", () => reject(new Error("aborted")));
+    req.on("error", reject);
+  });
+};
+
+const readContentType = (req: IncomingMessage): string => {
+  const header = req.headers["content-type"];
+  if (Array.isArray(header)) {
+    return header[0] ?? "application/json";
+  }
+  return header ?? "application/json";
+};
+
+const handleProxy = async (
+  req: IncomingMessage,
+  res: ServerResponse,
+  ingestUrl: string,
+  configPath: string,
+): Promise<void> => {
+  let body: Buffer;
+  try {
+    body = await readBody(req);
+  } catch {
+    applyCors(res);
+    res.statusCode = 400;
+    res.setHeader("Content-Type", "application/json; charset=utf-8");
+    res.end(JSON.stringify({ ok: false, error: "Request aborted" }));
+    return;
+  }
+
+  try {
+    const response = await fetch(ingestUrl, {
+      method: "POST",
+      headers: {
+        "content-type": readContentType(req),
+        "x-guck-config-path": configPath,
+      },
+      body,
+    });
+
+    applyCors(res);
+    res.statusCode = response.status;
+    const contentType = response.headers.get("content-type");
+    if (contentType) {
+      res.setHeader("Content-Type", contentType);
+    }
+    const payload = Buffer.from(await response.arrayBuffer());
+    res.end(payload);
+  } catch {
+    applyCors(res);
+    res.statusCode = 502;
+    res.setHeader("Content-Type", "application/json; charset=utf-8");
+    res.end(JSON.stringify({ ok: false, error: "Upstream unreachable" }));
+  }
+};
+
+export const guckVitePlugin = (options: GuckVitePluginOptions = {}): Plugin => {
+  const ingestUrl = options.ingestUrl ?? DEFAULT_INGEST_URL;
+  const configPath = options.configPath ?? process.cwd();
+  const path = options.path ?? DEFAULT_PATH;
+  const enabled = options.enabled ?? true;
+
+  return {
+    name: "guck-vite",
+    apply: "serve",
+    configureServer(server: ViteDevServer) {
+      if (!enabled) {
+        return;
+      }
+      server.middlewares.use(async (req, res, next) => {
+        const url = new URL(req.url ?? "", "http://localhost");
+        if (url.pathname !== path) {
+          next();
+          return;
+        }
+
+        if (req.method === "OPTIONS") {
+          applyCors(res);
+          res.statusCode = 204;
+          res.end();
+          return;
+        }
+
+        if (req.method !== "POST") {
+          applyCors(res);
+          res.statusCode = 404;
+          res.end();
+          return;
+        }
+
+        await handleProxy(req, res, ingestUrl, configPath);
+      });
+    },
+  };
+};

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "rootDir": "src",
+    "outDir": "dist",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "lib": ["ES2022"],
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts"]
+}