@adep/vite-plugin 0.1.1

package/dist/dev-server.d.ts

@@ -0,0 +1,102 @@
+/**
+ * @adep/vite-plugin —— 云函数 Vite 插件核心（IDE-030，自 CLI-014 `@adep/cli/vite` 抽出）。
+ *
+ * 目标：`vite dev` 一个命令即可调试前端 + 云函数（全栈开发体验）；同时供 Web IDE /
+ * 非 CLI 用户独立使用。
+ *
+ * 工作原理：
+ * - 若注入 `createDevServer`（CLI 注入 `startDevServer`）：在 vite dev server 进程内
+ *   启动本地 adep dev server，把 `/{prefix}/*` 代理到它（默认前缀 /api，与线上函数路由
+ *   `/api/{fn}` 对齐；读配置的 `functions_prefix`，未配置时强制 /api）；
+ * - 始终挂中间件 serve `/@adep/fn-proxy.js`（浏览器端 fetch 拦截器，Web IDE 预览路径），
+ *   并经 transformIndexHtml 把它注入 index.html（CLI 模式下脚本自检 window.parent ===
+ *   window 不激活，无害）。
+ *
+ * 依赖注入端口（避免循环依赖：CLI → vite-plugin → CLI）：
+ * - `createDevServer`：本地 sim 运行时是 CLI 专有实现，由 CLI 注入；未提供时本插件不
+ *   启动 dev server、不挂函数代理（仍 serve 拦截器脚本——纯 IDE 预览场景）；
+ * - `loadConfig`：读 `adep.config.ts` 的 `functions_prefix` 也是 CLI 专有（esbuild 转译），
+ *   由 CLI 注入；未提供时 prefix 缺省 /api。
+ *
+ * 边界：
+ * - 只代理 `/{prefix}/*` 形态；浏览器直接地址栏访问会被 vite 的 SPA 回退改写（前端
+ *   `fetch()` 调用不受影响）；
+ * - 不参与 `vite build`（构建时无需代理；构建产物见 vite.config.ts 的 outDir）。
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+/** 本地 adep dev server 句柄（CLI `startDevServer` 返回值的结构子集）。 */
+export interface AdepDevServerHandle {
+    /** `http://127.0.0.1:<port>`（随机端口时为真实端口）。 */
+    baseUrl: string;
+    close: () => Promise<void>;
+}
+/**
+ * 本地 adep dev server 工厂（CLI 注入 `startDevServer`）。`port=0` 表示让系统分配
+ * 随机端口（插件端口占用重试时用）。
+ */
+export interface AdepDevServerFactory {
+    (opts: {
+        cwd: string;
+        port: number;
+        prefix: string;
+        log: (line: string) => void;
+    }): Promise<AdepDevServerHandle>;
+}
+/** 读 `adep.config.ts` 的 `functions_prefix`（CLI 注入 `loadAdepConfigModule`）。 */
+export interface AdepConfigLoader {
+    (cwd: string): Promise<{
+        functions_prefix?: string;
+    } | null | undefined>;
+}
+export interface AdepVitePluginOptions {
+    /** adep dev 监听端口（缺省 8787；被占用时自动换随机端口）。 */
+    port?: number;
+    /** 代理前缀覆盖（缺省读 config 的 `functions_prefix`，再缺省 /api）。 */
+    prefix?: string;
+    /** 项目根目录（缺省 process.cwd()，即 vite 工程根）。 */
+    cwd?: string;
+    /**
+     * 启动本地 adep dev server 的工厂（CLI 注入）；未提供时不启动 dev server、不挂函数
+     * 代理（仍 serve `/@adep/fn-proxy.js`——纯 IDE 预览场景）。
+     */
+    createDevServer?: AdepDevServerFactory;
+    /** 读项目配置（CLI 注入）；未提供时 prefix 缺省 /api。 */
+    loadConfig?: AdepConfigLoader;
+}
+/** vite server 结构子集（插件不依赖 vite 包，仅按需消费这些字段）。 */
+export interface AdepViteServer {
+    middlewares: {
+        use(fn: (req: IncomingMessage, res: ServerResponse, next: () => void) => void): void;
+    };
+    config: {
+        logger: {
+            info(msg: string): void;
+            error(msg: string): void;
+        };
+    };
+    httpServer?: {
+        on(event: 'close', listener: () => void): void;
+    };
+}
+export interface AdepVitePlugin {
+    name: string;
+    /** 插件始终实现以下钩子（结构类型对齐 Vite Plugin 的子集，本包不依赖 vite 包）。 */
+    configureServer: (server: AdepViteServer) => void | Promise<void>;
+    configurePreviewServer: (server: AdepViteServer) => void | Promise<void>;
+    /** 注入 fetch 拦截器 script 标签（幂等）。 */
+    transformIndexHtml: (html: string) => string;
+    closeBundle: () => void | Promise<void>;
+}
+/**
+ * 云函数 Vite 插件：注入了 `createDevServer` 时启动内置 adep dev server 并代理
+ * `/{prefix}/*` 到云函数；同时始终 serve `/@adep/fn-proxy.js`（IDE 预览 fetch 拦截器）。
+ * 用法（项目根 vite.config.ts）：
+ * ```ts
+ * import { defineConfig } from 'vite'
+ * import vue from '@vitejs/plugin-vue'
+ * import { adepPlugin } from '@adep/vite-plugin'
+ * export default defineConfig({ plugins: [vue(), adepPlugin()] })
+ * ```
+ */
+export declare function adepPlugin(options?: AdepVitePluginOptions): AdepVitePlugin;
+export default adepPlugin;

package/dist/ide-proxy.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Web IDE 预览云函数 fetch 拦截器（IDE-030：从 shared/sdk/web-project-template.ts 迁移过来，
+ * 本文件为**单一真相源**；IDE-032 起 shared 模板不再保留文本副本，改由本包
+ * `adepPlugin()` 在 dev 时经 transformIndexHtml 自动注入）。
+ *
+ * 背景：浏览器端 IIFE，patch window.fetch，把 /api/* 请求经 window.parent.postMessage
+ * 转发到 IDE 主线程（Nodebox 真 vite 预览路径）；CLI 模式下脚本自检 window.parent ===
+ * window 不激活，无害。
+ *
+ * **同步纪律**：本字符串必须与以下两处**逐字一致**（复制粘贴，无共享 import——预览
+ * iframe / 浏览器内 vite-dev 是两个独立加载上下文）：
+ * - packages/web-container/src/function-fetch-proxy.ts 的 FN_FETCH_INTERCEPTOR_SCRIPT
+ *   （浏览器内 vite-dev 预览经 @adep/web-container buildDocument() 注入）。
+ * 改拦截器务必同步后一处（文本复制，不改语义）。脚本内不得出现反引号或模板插值。
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+/** 浏览器端 fetch 拦截器脚本（IIFE，纯 JS——必须能直接内联进 script 标签，无 TS / ESM）。 */
+export declare const FN_FETCH_INTERCEPTOR_SCRIPT = "(function () {\n  if (window.__adepFnProxyInstalled) return;\n  window.__adepFnProxyInstalled = true;\n  var ORIGINAL_FETCH = window.fetch.bind(window);\n  var pending = {};\n  var nextId = 1;\n  var TIMEOUT_MS = 15000;\n\n  window.addEventListener(\"message\", function (event) {\n    var data = event.data;\n    if (!data || data.__adepFnResponse !== true) return;\n    var entry = pending[data.id];\n    if (!entry) return;\n    delete pending[data.id];\n    clearTimeout(entry.timer);\n    var headers;\n    try { headers = new Headers(data.headers || {}); }\n    catch (e) { headers = new Headers({ \"content-type\": \"text/plain\" }); }\n    var body = data.body == null ? null : data.body;\n    try {\n      entry.resolve(new Response(body, { status: data.status || 200, statusText: \"\", headers: headers }));\n    } catch (e2) {\n      entry.resolve(new Response(String(body), { status: data.status || 200, headers: { \"content-type\": \"text/plain\" } }));\n    }\n  });\n\n  function readBody(input, init) {\n    if (typeof Request !== \"undefined\" && input instanceof Request) {\n      return input.text().catch(function () { return null; });\n    }\n    var body = init && init.body !== undefined ? init.body : input;\n    if (body == null) return Promise.resolve(null);\n    if (typeof body === \"string\") return Promise.resolve(body);\n    if (typeof ArrayBuffer !== \"undefined\" && body instanceof ArrayBuffer) {\n      return Promise.resolve(new TextDecoder().decode(body));\n    }\n    if (typeof Blob !== \"undefined\" && body instanceof Blob) return body.text();\n    if (typeof URLSearchParams !== \"undefined\" && body instanceof URLSearchParams) {\n      return Promise.resolve(body.toString());\n    }\n    try { return Promise.resolve(String(body)); } catch (e) { return Promise.resolve(null); }\n  }\n\n  function collectHeaders(input, init) {\n    var out = {};\n    try { input.headers.forEach(function (v, k) { out[k] = v; }); } catch (e) {}\n    if (init && init.headers) {\n      try { new Headers(init.headers).forEach(function (v, k) { out[k] = v; }); } catch (e2) {}\n    }\n    return out;\n  }\n\n  window.fetch = function (input, init) {\n    var urlStr;\n    var method;\n    var headers = {};\n    var isRequest = typeof Request !== \"undefined\" && input instanceof Request;\n    if (isRequest) {\n      urlStr = String(input.url);\n      method = (init && init.method) || input.method || \"GET\";\n      headers = collectHeaders(input, init);\n    } else if (typeof input === \"string\" || (typeof URL !== \"undefined\" && input instanceof URL)) {\n      urlStr = String(input);\n      method = (init && init.method) || \"GET\";\n      try { new Headers(init && init.headers || {}).forEach(function (v, k) { headers[k] = v; }); } catch (e) {}\n    } else {\n      return ORIGINAL_FETCH(input, init);\n    }\n    var u;\n    try { u = new URL(urlStr, document.baseURI); }\n    catch (e) { return ORIGINAL_FETCH(input, init); }\n    if (u.pathname.indexOf(\"/api/\") !== 0 && u.pathname !== \"/api\") {\n      return ORIGINAL_FETCH(input, init);\n    }\n    if (window.parent === window) return ORIGINAL_FETCH(input, init);\n    method = (method || \"GET\").toUpperCase();\n    var target = u.pathname + u.search;\n    return readBody(input, init).then(function (textBody) {\n      return new Promise(function (resolve) {\n        var id = nextId++;\n        var timer = setTimeout(function () {\n          delete pending[id];\n          resolve(new Response('{\"error\":{\"code\":\"FN_PROXY_TIMEOUT\",\"message\":\"\\u4e91\\u51fd\\u6570\\u6267\\u884c\\u8d85\\u65f6\"}}', { status: 504, headers: { \"content-type\": \"application/json\" } }));\n        }, TIMEOUT_MS);\n        pending[id] = { resolve: resolve, timer: timer };\n        window.parent.postMessage({ __adepFnRequest: true, id: id, method: method, url: target, headers: headers, body: textBody }, \"*\");\n      });\n    });\n  };\n})();";
+/**
+ * 构造中间件：serve `/@adep/fn-proxy.js`（返回上面的拦截器脚本）。
+ * vite dev / preview server 均挂；路径未命中则 next() 放行。
+ */
+export declare function createAdepFnProxyScriptMiddleware(): (req: IncomingMessage, res: ServerResponse, next: () => void) => void;
+/**
+ * 把 fetch 拦截器 script 标签注入 index.html 的 </head> 前（幂等：已注入过则原样返回）。
+ * Web IDE 预览路径用（CLI 模式下脚本自检 window.parent === window 不激活，无害）。
+ */
+export declare function injectFnProxyScriptTag(html: string): string;

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @adep/vite-plugin（IDE-030）—— 云函数 Vite 插件独立包，自 CLI-014 `@adep/cli/vite` 抽出。
+ *
+ * 公开面：
+ * - `adepPlugin(options?)`：主入口（命名 + 默认导出）；
+ * - `normalizeFunctionPrefix` / `createAdepProxyMiddleware` / `isAddrInUse`：前缀与代理
+ *   原语，供测试与高级集成复用；
+ * - `FN_FETCH_INTERCEPTOR_SCRIPT` / `createAdepFnProxyScriptMiddleware` /
+ *   `injectFnProxyScriptTag`：Web IDE 预览 fetch 拦截器（单一真相源，详见 ide-proxy.ts）；
+ * - 全部类型（AdepVitePluginOptions / AdepDevServerFactory / AdepConfigLoader /
+ *   AdepDevServerHandle / AdepVitePlugin / AdepViteServer）。
+ *
+ * 本包不 import vite（结构类型对齐其子集）、不 import CLI——本地 sim 运行时与配置加载
+ * 经 options 注入端口接入（dev-server.ts 头部注释）。
+ */
+export { adepPlugin, default } from './dev-server';
+export type { AdepConfigLoader, AdepDevServerFactory, AdepDevServerHandle, AdepVitePlugin, AdepVitePluginOptions, AdepViteServer, } from './dev-server';
+export { normalizeFunctionPrefix } from './prefix';
+export { createAdepProxyMiddleware, isAddrInUse } from './proxy';
+export { createAdepFnProxyScriptMiddleware, FN_FETCH_INTERCEPTOR_SCRIPT, injectFnProxyScriptTag, } from './ide-proxy';

package/dist/index.js

@@ -0,0 +1,246 @@
+// packages/vite-plugin/src/dev-server.ts
+import { resolve } from "node:path";
+
+// packages/vite-plugin/src/prefix.ts
+function normalizeFunctionPrefix(raw) {
+  const value = (raw ?? "").trim();
+  if (value.length === 0 || value === "/") return "";
+  return value.replace(/^\/+|\/+$/g, "");
+}
+
+// packages/vite-plugin/src/proxy.ts
+import { request as httpRequest } from "node:http";
+function isAddrInUse(error) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === "EADDRINUSE";
+}
+function createAdepProxyMiddleware(prefix, targetBase) {
+  const normalized = normalizeFunctionPrefix(prefix);
+  const prefixPath = normalized === "" ? "" : `/${normalized}`;
+  return (req, res, next) => {
+    if (prefixPath === "") return next();
+    const url = new URL(req.url ?? "/", "http://127.0.0.1");
+    if (url.pathname !== prefixPath && !url.pathname.startsWith(`${prefixPath}/`)) {
+      return next();
+    }
+    const target = new URL(url.pathname + url.search, targetBase);
+    const proxyReq = httpRequest(
+      target,
+      { method: req.method, headers: { ...req.headers, host: target.host } },
+      (proxyRes) => {
+        res.writeHead(proxyRes.statusCode ?? 502, proxyRes.headers);
+        proxyRes.pipe(res);
+      }
+    );
+    proxyReq.on("error", (error) => {
+      if (!res.headersSent) {
+        res.writeHead(502, { "content-type": "application/json" });
+      }
+      res.end(
+        JSON.stringify({
+          error: {
+            code: "ADEP_DEV_UNAVAILABLE",
+            message: `\u4E91\u51FD\u6570\u4EE3\u7406\u5931\u8D25\uFF08adep dev server \u4E0D\u53EF\u8FBE\uFF09\uFF1A${error.message}`
+          }
+        })
+      );
+    });
+    req.pipe(proxyReq);
+  };
+}
+
+// packages/vite-plugin/src/ide-proxy.ts
+var FN_FETCH_INTERCEPTOR_SCRIPT = `(function () {
+  if (window.__adepFnProxyInstalled) return;
+  window.__adepFnProxyInstalled = true;
+  var ORIGINAL_FETCH = window.fetch.bind(window);
+  var pending = {};
+  var nextId = 1;
+  var TIMEOUT_MS = 15000;
+
+  window.addEventListener("message", function (event) {
+    var data = event.data;
+    if (!data || data.__adepFnResponse !== true) return;
+    var entry = pending[data.id];
+    if (!entry) return;
+    delete pending[data.id];
+    clearTimeout(entry.timer);
+    var headers;
+    try { headers = new Headers(data.headers || {}); }
+    catch (e) { headers = new Headers({ "content-type": "text/plain" }); }
+    var body = data.body == null ? null : data.body;
+    try {
+      entry.resolve(new Response(body, { status: data.status || 200, statusText: "", headers: headers }));
+    } catch (e2) {
+      entry.resolve(new Response(String(body), { status: data.status || 200, headers: { "content-type": "text/plain" } }));
+    }
+  });
+
+  function readBody(input, init) {
+    if (typeof Request !== "undefined" && input instanceof Request) {
+      return input.text().catch(function () { return null; });
+    }
+    var body = init && init.body !== undefined ? init.body : input;
+    if (body == null) return Promise.resolve(null);
+    if (typeof body === "string") return Promise.resolve(body);
+    if (typeof ArrayBuffer !== "undefined" && body instanceof ArrayBuffer) {
+      return Promise.resolve(new TextDecoder().decode(body));
+    }
+    if (typeof Blob !== "undefined" && body instanceof Blob) return body.text();
+    if (typeof URLSearchParams !== "undefined" && body instanceof URLSearchParams) {
+      return Promise.resolve(body.toString());
+    }
+    try { return Promise.resolve(String(body)); } catch (e) { return Promise.resolve(null); }
+  }
+
+  function collectHeaders(input, init) {
+    var out = {};
+    try { input.headers.forEach(function (v, k) { out[k] = v; }); } catch (e) {}
+    if (init && init.headers) {
+      try { new Headers(init.headers).forEach(function (v, k) { out[k] = v; }); } catch (e2) {}
+    }
+    return out;
+  }
+
+  window.fetch = function (input, init) {
+    var urlStr;
+    var method;
+    var headers = {};
+    var isRequest = typeof Request !== "undefined" && input instanceof Request;
+    if (isRequest) {
+      urlStr = String(input.url);
+      method = (init && init.method) || input.method || "GET";
+      headers = collectHeaders(input, init);
+    } else if (typeof input === "string" || (typeof URL !== "undefined" && input instanceof URL)) {
+      urlStr = String(input);
+      method = (init && init.method) || "GET";
+      try { new Headers(init && init.headers || {}).forEach(function (v, k) { headers[k] = v; }); } catch (e) {}
+    } else {
+      return ORIGINAL_FETCH(input, init);
+    }
+    var u;
+    try { u = new URL(urlStr, document.baseURI); }
+    catch (e) { return ORIGINAL_FETCH(input, init); }
+    if (u.pathname.indexOf("/api/") !== 0 && u.pathname !== "/api") {
+      return ORIGINAL_FETCH(input, init);
+    }
+    if (window.parent === window) return ORIGINAL_FETCH(input, init);
+    method = (method || "GET").toUpperCase();
+    var target = u.pathname + u.search;
+    return readBody(input, init).then(function (textBody) {
+      return new Promise(function (resolve) {
+        var id = nextId++;
+        var timer = setTimeout(function () {
+          delete pending[id];
+          resolve(new Response('{"error":{"code":"FN_PROXY_TIMEOUT","message":"\\u4e91\\u51fd\\u6570\\u6267\\u884c\\u8d85\\u65f6"}}', { status: 504, headers: { "content-type": "application/json" } }));
+        }, TIMEOUT_MS);
+        pending[id] = { resolve: resolve, timer: timer };
+        window.parent.postMessage({ __adepFnRequest: true, id: id, method: method, url: target, headers: headers, body: textBody }, "*");
+      });
+    });
+  };
+})();`;
+function createAdepFnProxyScriptMiddleware() {
+  return (req, res, next) => {
+    const pathname = (req.url ?? "").split("?")[0];
+    if (pathname !== "/@adep/fn-proxy.js") return next();
+    res.setHeader("content-type", "application/javascript; charset=utf-8");
+    res.end(FN_FETCH_INTERCEPTOR_SCRIPT);
+  };
+}
+function injectFnProxyScriptTag(html) {
+  if (html.includes("/@adep/fn-proxy.js")) return html;
+  return html.replace("</head>", '<script src="/@adep/fn-proxy.js"></script></head>');
+}
+
+// packages/vite-plugin/src/dev-server.ts
+function adepPlugin(options = {}) {
+  const cwd = resolve(options.cwd ?? process.cwd());
+  let dev;
+  let prefix = normalizeFunctionPrefix(options.prefix);
+  let prefixPath = "";
+  let startPromise;
+  const startAdepDev = async (log) => {
+    if (startPromise !== void 0) return startPromise;
+    const create = options.createDevServer;
+    startPromise = (async () => {
+      if (create === void 0) return;
+      if (prefix === "") {
+        const config = options.loadConfig ? await options.loadConfig(cwd) : void 0;
+        prefix = normalizeFunctionPrefix(config?.functions_prefix);
+        if (prefix === "") {
+          log("[adep] adep.config.ts \u672A\u914D\u7F6E functions_prefix\uFF0C\u4E91\u51FD\u6570\u4EE3\u7406\u524D\u7F00\u9ED8\u8BA4 /api");
+          prefix = "api";
+        }
+      }
+      prefixPath = `/${prefix}`;
+      const targetPort = options.port ?? 8787;
+      try {
+        dev = await create({ cwd, port: targetPort, prefix, log });
+      } catch (error) {
+        if (isAddrInUse(error)) {
+          log(`[adep] \u7AEF\u53E3 ${targetPort} \u88AB\u5360\u7528\uFF0C\u6539\u7528\u968F\u673A\u7AEF\u53E3`);
+          dev = await create({ cwd, port: 0, prefix, log });
+        } else {
+          log(
+            `[adep] \u4E91\u51FD\u6570 dev server \u542F\u52A8\u5931\u8D25\uFF1A${error instanceof Error ? error.message : String(error)}\uFF08vite \u524D\u7AEF\u7167\u5E38\uFF0C\u51FD\u6570\u4EE3\u7406\u4E0D\u53EF\u7528\uFF09`
+          );
+        }
+      }
+      if (dev !== void 0) {
+        log(
+          `[adep] \u4E91\u51FD\u6570\u5DF2\u5C31\u7EEA\uFF1A${dev.baseUrl}${prefixPath}/<fn>\uFF08vite \u4EE3\u7406 ${prefixPath}/* \u2192 \u4E91\u51FD\u6570\uFF09`
+        );
+      }
+    })();
+    try {
+      await startPromise;
+    } finally {
+      startPromise = void 0;
+    }
+  };
+  const disposeAdepDev = async () => {
+    if (dev === void 0) return;
+    const target = dev;
+    dev = void 0;
+    await target.close();
+  };
+  const attachMiddlewares = (server) => {
+    if (dev !== void 0 && prefixPath !== "") {
+      server.middlewares.use(createAdepProxyMiddleware(prefixPath, dev.baseUrl));
+    }
+    server.middlewares.use(createAdepFnProxyScriptMiddleware());
+  };
+  return {
+    name: "adep-cloud-functions",
+    async configureServer(server) {
+      const log = (line) => server.config.logger.info(line);
+      await startAdepDev(log);
+      attachMiddlewares(server);
+      server.httpServer?.on("close", () => {
+        void disposeAdepDev();
+      });
+    },
+    async configurePreviewServer(server) {
+      const log = (line) => server.config.logger.info(line);
+      await startAdepDev(log);
+      attachMiddlewares(server);
+    },
+    transformIndexHtml(html) {
+      return injectFnProxyScriptTag(html);
+    },
+    async closeBundle() {
+      await disposeAdepDev();
+    }
+  };
+}
+var dev_server_default = adepPlugin;
+export {
+  FN_FETCH_INTERCEPTOR_SCRIPT,
+  adepPlugin,
+  createAdepFnProxyScriptMiddleware,
+  createAdepProxyMiddleware,
+  dev_server_default as default,
+  injectFnProxyScriptTag,
+  isAddrInUse,
+  normalizeFunctionPrefix
+};

package/dist/prefix.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 前缀归一化（从 CLI-014 `@adep/cli/vite` 抽出，IDE-030）。
+ *
+ * `'/api'` / `'api'` / `'api/'` → `'api'`（与 CLI dev.ts `resolveRouteFnName`
+ * 的剥斜杠口径一致）；空 / `/` → `''`。
+ */
+export declare function normalizeFunctionPrefix(raw: string | undefined): string;

package/dist/proxy.d.ts

@@ -0,0 +1,9 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+/** 判断监听失败是否为端口占用（插件据此换随机端口重试）。 */
+export declare function isAddrInUse(error: unknown): boolean;
+/**
+ * 构造代理中间件：命中 `/{prefix}` 或 `/{prefix}/*` 的请求转发到 `targetBase`
+ * （adep dev server 的 baseUrl），方法 / 头 / body / query 原样透传；dev server
+ * 不可达回 502 JSON。prefix 为空时不代理任何路径（next() 放行）。
+ */
+export declare function createAdepProxyMiddleware(prefix: string, targetBase: string): (req: IncomingMessage, res: ServerResponse, next: () => void) => void;

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@adep/vite-plugin",
+  "version": "0.1.1",
+  "private": false,
+  "type": "module",
+  "description": "云函数 Vite 插件（IDE-030，自 CLI-014 @adep/cli/vite 抽出）：vite dev 进程内启动本地 adep dev server 并代理 /{prefix}/* 到云函数；同时 serve /@adep/fn-proxy.js（Web IDE 预览 fetch 拦截器）。本地运行时与配置加载经 createDevServer / loadConfig 注入端口接入，供 CLI / Web IDE / 非 CLI 用户独立使用。",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "test": "vitest run",
+    "build": "bun run ../../scripts/build-package.ts vite-plugin"
+  }
+}