@adep/web-container 0.2.1 → 0.2.2

package/dist/function-fetch-proxy.d.ts

@@ -28,9 +28,15 @@ export interface OfflineRunner {
 /**
  * 浏览器端 fetch 拦截器脚本（IIFE，纯 JS——必须能直接内联进 `<script>`，不能有 TS / ESM）。
  *
- * **同步纪律**：本字符串与 `shared/sdk/web-project-template.ts` 里 web/vite.config.ts 模板的
- * `FN_PROXY_SCRIPT` 必须**逐字一致**（两处复制粘贴，无共享 import——预览 iframe 与浏览器内
- * vite-dev 是两个独立加载上下文，共享一份源码反而会引入打包耦合）。改这里务必同步另一侧。
+ * **同步纪律**：本字符串与 `packages/vite-plugin/src/ide-proxy.ts` 的
+ * `FN_FETCH_INTERCEPTOR_SCRIPT`（单一真相源）必须**逐字一致**（两处复制粘贴，无共享
+ * import——预览 iframe 与浏览器内 vite-dev 是两个独立加载上下文，共享一份源码反而会引入
+ * 打包耦合）。改这里务必同步另一侧。
+ *
+ * blob base 兼容（2026-09-11 修复）：浏览器内 vite-dev 预览文档的 baseURI 是 blob: URL，
+ * `new URL('/api/x', 'blob:…')` 抛 TypeError → 拦截器退化成原生 fetch 报
+ * "Failed to parse URL"。首次解析失败时用 `window.location.origin`（blob 继承创建者
+ * origin）兜底再解析一次。
  */
 export declare const FN_FETCH_INTERCEPTOR_SCRIPT: string;
 /** IDE 主线程侧的消息处理器类型：直接挂到 `window.addEventListener('message', handler)`。 */

package/dist/index.js

@@ -105,6 +105,27 @@ function withinPackage(pkgDirAbs, rel, context) {
   }
   return abs;
 }
+function pickConditionTarget(conditions, order, resolveRel, context) {
+  for (const key of order) {
+    const value = conditions[key];
+    if (value === void 0 || value === null) continue;
+    if (typeof value === "string") return resolveRel(value);
+    if (typeof value === "object" && !Array.isArray(value)) {
+      const nested = pickConditionTarget(
+        value,
+        order,
+        resolveRel,
+        context
+      );
+      if (nested !== null) return nested;
+      continue;
+    }
+    throw new ResolveError(
+      `${context}\uFF1Aexports["."]["${key}"] \u5F62\u6001\u4E0D\u652F\u6301\uFF08\u4EC5\u63A5\u53D7\u5B57\u7B26\u4E32 / null / \u6761\u4EF6\u5BF9\u8C61\uFF09`
+    );
+  }
+  return null;
+}
 function resolvePackageEntry(meta, pkgDirAbs, condition) {
   const context = `\u5305 ${meta.name ?? meta.version ?? pkgDirAbs} \u7684 exports/main \u58F0\u660E`;
   const exp = meta.exports;
@@ -125,20 +146,11 @@ function resolvePackageEntry(meta, pkgDirAbs, condition) {
     if (typeof dot !== "object" || Array.isArray(dot)) {
       throw new ResolveError(`${context}\uFF1Aexports["."] \u5F62\u6001\u4E0D\u652F\u6301\uFF08\u4EC5\u63A5\u53D7\u5B57\u7B26\u4E32\u6216\u6761\u4EF6\u5BF9\u8C61\uFF09`);
     }
-    const conditions = dot;
-    const order = condition === "import" ? ["import", "node", "default"] : ["require", "node", "default"];
-    for (const key of order) {
-      const value = conditions[key];
-      if (typeof value === "string") return withinPackage(pkgDirAbs, value, context);
-      if (value !== void 0 && (typeof value !== "object" || value === null)) {
-        throw new ResolveError(
-          `${context}\uFF1Aexports["."]["${key}"] \u5F62\u6001\u4E0D\u652F\u6301\uFF08\u4EC5\u63A5\u53D7\u5B57\u7B26\u4E32\u6216 null\uFF09`
-        );
-      }
-    }
-    throw new ResolveError(
-      `${context}\uFF1Aexports["."] \u6761\u4EF6\u5BF9\u8C61\u91CC\u6CA1\u6709 ${condition}/node/default \u5B57\u7B26\u4E32\u5165\u53E3\uFF08\u5B50\u8DEF\u5F84/\u5D4C\u5957\u6761\u4EF6\u4E0D\u652F\u6301\uFF09`
-    );
+    const order = condition === "import" ? IMPORT_CONDITION_ORDER : REQUIRE_CONDITION_ORDER;
+    const resolveRel = (rel) => withinPackage(pkgDirAbs, rel, context);
+    const hit = pickConditionTarget(dot, order, resolveRel, context);
+    if (hit !== null) return hit;
+    throw new ResolveError(`${context}\uFF1Aexports["."] \u6761\u4EF6\u5BF9\u8C61\u91CC\u6CA1\u6709 ${order.join("/")} \u5165\u53E3`);
   }
   if (meta.main !== void 0) {
     if (typeof meta.main !== "string") {
@@ -236,11 +248,13 @@ function resolveImport(fs, specifier, fromFileAbs, condition = "require") {
     `\u627E\u4E0D\u5230\u5305 "${specifier}"\uFF1A${dirname(fromFileAbs)} \u53CA\u5176\u5404\u7EA7\u7236\u76EE\u5F55\u4E0B\u90FD\u6CA1\u6709 node_modules/${name}\uFF08\u5148\u5728\u7EC8\u7AEF npm install ${name}\uFF09`
   );
 }
-var RESOLVE_EXTENSIONS, ResolveError;
+var IMPORT_CONDITION_ORDER, REQUIRE_CONDITION_ORDER, RESOLVE_EXTENSIONS, ResolveError;
 var init_node_resolve = __esm({
   "packages/web-container/src/node-resolve.ts"() {
     "use strict";
     init_path();
+    IMPORT_CONDITION_ORDER = ["browser", "import", "module", "default"];
+    REQUIRE_CONDITION_ORDER = ["require", "node", "default"];
     RESOLVE_EXTENSIONS = [".js", ".mjs", ".cjs", ".json"];
     ResolveError = class extends Error {
       constructor(message) {
@@ -515,6 +529,7 @@ var init_strip_types = __esm({
             return;
           case "as":
           case "satisfies": {
+            if (this.frames[this.frames.length - 1]?.specifierList === true) return;
             if (this.tokenAt(2) === "*" || this.tokenAt(2) === "type") return;
             const nextChar = this.skipWhitespaceFrom(this.i);
             if (nextChar === null || "=,:]})".includes(this.src[nextChar])) return;
@@ -567,7 +582,8 @@ var init_strip_types = __esm({
           const frame = {
             kind: c === "(" ? "paren" : c === "{" ? "brace" : "bracket",
             declare: false,
-            classBody: false
+            classBody: false,
+            specifierList: c === "{" && this.isImportSpecifierBrace()
           };
           if (c === "{" && this.pendingClassBody) {
             frame.classBody = true;
@@ -653,6 +669,15 @@ var init_strip_types = __esm({
         this.i = end;
         return true;
       }
+      /**
+       * `{` 是 import / export 的说明符列表吗——`{ a as b }` 覆盖 `import { … }`、
+       * `export { … }` 与 `import def, { … }` 三种写法（后者说明符花括号的前驱 token 是 `,`）。
+       */
+      isImportSpecifierBrace() {
+        const back1 = this.tokenAt(1);
+        if (back1 === "import" || back1 === "export") return true;
+        return back1 === "," && this.tokenAt(3) === "import";
+      }
       /**
        * `(` 是否为参数列表（声明位）：`function f(`、类体里的方法 `m(`、箭头 `=> (`，
        * 以及出现在 `(` `,` `=` `>` `:` `[` `{` `}` `;` 之后（如 `map((v: T) => v)` 的内层括号）。
@@ -664,6 +689,7 @@ var init_strip_types = __esm({
         if (this.afterFunctionKeyword) return true;
         if (this.tokenAt(2) === "function" && IDENT_START.test(this.tokenAt(1))) return true;
         if (this.afterArrow) return true;
+        if (this.tokenAt(1) === "return") return true;
         if (this.inClassBody() && IDENT_PART.test(this.prevSignificantChar(at - 1))) return true;
         const prev = this.prevSignificantChar(at - 1);
         return prev === "" || "(,=>:[{};".includes(prev);
@@ -1172,7 +1198,10 @@ var init_function_fetch_proxy = __esm({
         "    }",
         "    var u;",
         "    try { u = new URL(urlStr, document.baseURI); }",
-        "    catch (e) { return ORIGINAL_FETCH(input, init); }",
+        "    catch (e0) {",
+        "      try { u = new URL(urlStr, window.location.origin); }",
+        "      catch (e1) { return ORIGINAL_FETCH(input, init); }",
+        "    }",
         '    if (u.pathname.indexOf("/api/") !== 0 && u.pathname !== "/api") {',
         "      return ORIGINAL_FETCH(input, init);",
         "    }",
@@ -1311,6 +1340,18 @@ function cssModule(css) {
     "export default css;"
   ].join("\n");
 }
+function inlineStyleBlock(css, key) {
+  return [
+    "{",
+    `const css = ${JSON.stringify(css)};`,
+    'const el = document.createElement("style");',
+    'el.setAttribute("data-adep-vite", "");',
+    `el.setAttribute("data-adep-style", ${JSON.stringify(key)});`,
+    "el.textContent = css;",
+    "document.head.appendChild(el);",
+    "}"
+  ].join("\n");
+}
 function jsonModule(source, abs) {
   try {
     JSON.parse(source);
@@ -1361,6 +1402,17 @@ function createViteServer(vfs, options = {}) {
     } catch {
     }
   };
+  const DEFINES = [
+    [/\bprocess\s*\.\s*env\s*\.\s*NODE_ENV\b/g, JSON.stringify("development")],
+    [/\b__VUE_OPTIONS_API__\b/g, "true"],
+    [/\b__VUE_PROD_DEVTOOLS__\b/g, "false"],
+    [/\b__VUE_PROD_HYDRATION_MISMATCH_DETAILS__\b/g, "false"]
+  ];
+  function applyDefines(code) {
+    let out = code;
+    for (const [pattern, value] of DEFINES) out = out.replace(pattern, value);
+    return out;
+  }
   function transformModule2(abs, source) {
     if (abs.endsWith(".css")) return cssModule(source);
     if (abs.endsWith(".json")) return jsonModule(source, abs);
@@ -1371,21 +1423,27 @@ function createViteServer(vfs, options = {}) {
           `${abs} \u662F Vue SFC\uFF0C\u4F46\u5F53\u524D\u73AF\u5883\u672A\u88C5\u914D SFC \u7F16\u8BD1\u5668\uFF08IDE \u4FA7\u9700\u6CE8\u5165 vue/compiler-sfc\uFF09`
         );
       const compiled = sfcCompiler(source, abs);
-      return [...compiled.styles.map((css) => cssModule(css)), compiled.script].join("\n");
+      return [
+        ...compiled.styles.map((css, index) => inlineStyleBlock(css, `${abs}#${index}`)),
+        applyDefines(stripTypes(compiled.script))
+      ].join("\n");
     }
     if (abs.endsWith(".tsx") || abs.endsWith(".jsx"))
       throw new ViteDevError(
         "JSX_UNSUPPORTED",
         `${abs} \u4F7F\u7528 JSX\uFF1A\u6D4F\u89C8\u5668\u5185 vite \u53EA\u64E6\u9664 TS \u7C7B\u578B\u6807\u6CE8\uFF0C\u4E0D\u8F6C\u8BD1 JSX\uFF08\u8BF7\u7528 h() \u6E32\u67D3\u51FD\u6570\u6216 .vue SFC\uFF09`
       );
-    if (abs.endsWith(".ts") || abs.endsWith(".mts")) return stripTypes(source);
-    return source;
+    if (abs.endsWith(".ts") || abs.endsWith(".mts")) return applyDefines(stripTypes(source));
+    return applyDefines(source);
+  }
+  function absoluteFromRoot(spec) {
+    return join(root, spec.replace(/^\/+/, ""));
   }
   async function resolveSpecifier(spec, importerAbs) {
     if (EXTERNAL_SPECIFIER.test(spec) || DATA_OR_BLOB.test(spec)) return spec;
     let target;
     if (spec.startsWith("./") || spec.startsWith("../") || spec.startsWith("/")) {
-      const base = spec.startsWith("/") ? spec : join(dirname(importerAbs), spec);
+      const base = spec.startsWith("/") ? absoluteFromRoot(spec) : join(dirname(importerAbs), spec);
       target = resolveWithSuffixes(vfs, base);
       if (!vfs.exists(target) || vfs.isDirectory(target))
         throw new ViteDevError(
@@ -1474,7 +1532,7 @@ function createViteServer(vfs, options = {}) {
     html = html.replace(
       MODULE_SCRIPT_SRC_RE,
       (_whole, pre, _q1, mid, _q2, src, post) => {
-        const base = src.startsWith("/") ? normalize(src) : join(dirname(entryAbs), src);
+        const base = src.startsWith("/") ? absoluteFromRoot(src) : join(dirname(entryAbs), src);
         const abs = resolveWithSuffixes(vfs, base);
         if (!vfs.exists(abs) || vfs.isDirectory(abs))
           throw new ViteDevError(
@@ -1482,7 +1540,7 @@ function createViteServer(vfs, options = {}) {
             `\u5165\u53E3 module script \u627E\u4E0D\u5230 "${src}"\uFF08root: ${root}\uFF1B\u8BD5\u8FC7\u6269\u5C55\u540D ${VITE_RESOLVE_SUFFIXES.join("/")} \u4E0E\u76EE\u5F55 index\uFF09`
           );
         entryModuleUrls.push(loadModuleUrl(abs));
-        return `<script${pre}${mid}src="__adep_vite_entry_${entryModuleUrls.length - 1}__"${post}></script>`;
+        return `<script${pre}${mid}src="__adep_vite_entry_${entryModuleUrls.length - 1}__"${post} type="module"></script>`;
       }
     );
     html = html.replace(
@@ -1492,7 +1550,7 @@ function createViteServer(vfs, options = {}) {
         const abs = `${INLINE_PREFIX}${inlineSeq++}.mjs`;
         inlineSources.set(abs, body);
         entryModuleUrls.push(loadModuleUrl(abs));
-        return `<script${pre}${post}src="__adep_vite_entry_${entryModuleUrls.length - 1}__"></script>`;
+        return `<script${pre}${post}src="__adep_vite_entry_${entryModuleUrls.length - 1}__" type="module"></script>`;
       }
     );
     const urls = await Promise.all(entryModuleUrls);
@@ -4459,6 +4517,8 @@ var CHAIN_CAPABILITY_KEY = "__adepChain";
 var DB_RPC = {
   /** 直通方法（如 query）：`(method=query, args=[sql, params])`。 */
   query: "query",
+  /** 写路径（CF-013）：`(method=writeQuery, args=[sql, params])` → `{ changes }`。 */
+  writeQuery: "writeQuery",
   /** 读取 owned 表变更流（DB-006）：`(method=changes, args=[table, query])`。 */
   changes: "changes",
   /** 开启事务：`begin → txId`。 */
@@ -4535,21 +4595,35 @@ function unsafeOperation(message) {
 function stripLiterals(sql) {
   return sql.replace(/'[^']*(?:''[^']*)*'/g, "").replace(/"[^"]*(?:""[^"]*)*"/g, "").replace(/--[^\n]*/g, "").replace(/\/\*[\s\S]*?\*\//g, "");
 }
-function assertReadOnlyQuery(sql) {
+function sqlHead(sql) {
+  return sql.trim().replace(/^\(+/, "").trim().toUpperCase();
+}
+function assertSafeStatement(sql) {
   const stripped = stripLiterals(sql);
   if (stripped.includes(";")) {
     throw unsafeOperation("\u4EC5\u5141\u8BB8\u5355\u6761\u8BED\u53E5\uFF0C\u7981\u6B62\u591A\u8BED\u53E5\u5806\u53E0");
   }
-  const head = stripped.trim().replace(/^\(+/, "").trim().toUpperCase();
-  if (!head.startsWith("SELECT") && !head.startsWith("WITH")) {
-    throw unsafeOperation("cloud.db.query \u4EC5\u5141\u8BB8\u53EA\u8BFB\u67E5\u8BE2\uFF08SELECT / WITH\uFF09");
-  }
   if (/ATTACH|DETACH/.test(stripped.toUpperCase())) {
     throw unsafeOperation("\u7981\u6B62\u8DE8\u5E93\u64CD\u4F5C\uFF08ATTACH / DETACH\uFF09");
   }
   if (/SQLITE_\w+/i.test(stripped)) {
     throw unsafeOperation("\u7981\u6B62\u8BBF\u95EE\u7CFB\u7EDF\u8868\uFF08sqlite_*\uFF09");
   }
+  return sqlHead(stripped);
+}
+function assertReadOnlyQuery(sql) {
+  const head = assertSafeStatement(sql);
+  if (!head.startsWith("SELECT") && !head.startsWith("WITH")) {
+    throw unsafeOperation("cloud.db.query \u4EC5\u5141\u8BB8\u53EA\u8BFB\u67E5\u8BE2\uFF08SELECT / WITH\uFF09");
+  }
+}
+function assertWriteQuery(sql) {
+  const head = assertSafeStatement(sql);
+  if (!head.startsWith("INSERT") && !head.startsWith("UPDATE") && !head.startsWith("DELETE")) {
+    throw unsafeOperation(
+      "cloud.db.writeQuery \u4EC5\u5141\u8BB8 DML\uFF08INSERT / UPDATE / DELETE\uFF09\uFF0CDDL \u8BF7\u8D70\u63A7\u5236\u53F0"
+    );
+  }
 }
 
 // packages/runtime/src/database/builder/owned.ts
@@ -5095,6 +5169,14 @@ function createCloudDb(driver, options = {}) {
         assertReadOnlyQuery(sql);
         return driver.all(sql, params);
       },
+      async writeQuery(sql, params) {
+        if (!Array.isArray(params)) {
+          throw unsafeOperation("writeQuery \u7684 params \u5FC5\u987B\u63D0\u4F9B\uFF08\u65E0\u53C2\u4F20 []\uFF09");
+        }
+        guardWrite();
+        assertWriteQuery(sql);
+        return driver.run(sql, params);
+      },
       async changes(table, query = {}) {
         return readChanges(driver, table, query);
       }
@@ -5110,7 +5192,8 @@ var CLOUD_DB_SPEC = {
   rootMethod: "table",
   stepMethods: ["select", "where", "orderBy", "limit", "offset"],
   terminalMethods: ["get", "first", "count", "insert", "insertMany", "update", "delete"],
-  directMethods: ["query", "changes"],
+  // CF-013：writeQuery 是 D1 shim 的写路径（INSERT/UPDATE/DELETE），与 query 并列直通方法。
+  directMethods: ["query", "writeQuery", "changes"],
   transactionMethod: "transaction"
 };
 var WRITE_TERMINALS = /* @__PURE__ */ new Set(["insert", "insertMany", "update", "delete"]);
@@ -5165,6 +5248,10 @@ function createDbCapability(driver, options = {}) {
           const [sql, params] = args;
           return await db.query(sql, params);
         }
+        case DB_RPC.writeQuery: {
+          const [sql, params] = args;
+          return await db.writeQuery(sql, params);
+        }
         case DB_RPC.changes: {
           const [table, query] = args;
           return await db.changes(table, query);
@@ -5894,9 +5981,12 @@ function createStorageCapability(driver, signer, projectId) {
   const handler = async (method, args) => {
     switch (method) {
       case "upload": {
-        const [path, data] = args;
+        const [path, data, options] = args;
         return toStoredFile(
-          await driver.put(projectId, path, asBytes(data), { visibility: DEFAULT_VISIBILITY })
+          await driver.put(projectId, path, asBytes(data), {
+            visibility: DEFAULT_VISIBILITY,
+            ...options?.contentType === void 0 ? {} : { contentType: options.contentType }
+          })
         );
       }
       case "get": {
@@ -6343,6 +6433,10 @@ var KNOWN_CAPABILITY_HINTS = {
   realtime: {
     code: "REALTIME_NOT_AVAILABLE",
     message: "\u5B9E\u65F6\u901A\u9053\u672A\u88C5\u914D\uFF1Arealtime \u57DF\u672A\u88C5\u8F7D\uFF08\u68C0\u67E5\u90E8\u7F72\u5F62\u6001\u4E0E Redis \u914D\u7F6E\uFF09\uFF08REALTIME_NOT_AVAILABLE\uFF09"
+  },
+  kv: {
+    code: "KV_NOT_PROVISIONED",
+    message: "\u9879\u76EE KV \u5B58\u50A8\u672A\u53EF\u7528\uFF1Akv \u968F\u9879\u76EE\u6570\u636E\u5E93\u63D0\u4F9B\uFF0C\u8BF7\u5148\u542F\u52A8\u6570\u636E\u5E93\uFF08KV_NOT_PROVISIONED\uFF09"
   }
 };
 var CapabilityNotRegisteredError = class extends Error {
@@ -6655,6 +6749,106 @@ function createOfflineFunctionRunner(options = {}) {
   return { run };
 }
 
+// packages/runtime/src/database/sdk/kv.ts
+var KV_TABLE = "_adep_kv";
+var KV_RPC = {
+  get: "get",
+  put: "put",
+  delete: "delete",
+  list: "list"
+};
+var KV_CAPABILITY_CODES = {
+  invalidMethod: "KV_INVALID_METHOD"
+};
+var KV_LIST_DEFAULT_LIMIT = 100;
+function nowSeconds() {
+  return Math.floor(Date.now() / 1e3);
+}
+function errorWithCode2(error) {
+  const code = typeof error === "object" && error !== null && typeof error.code === "string" ? error.code : void 0;
+  if (code !== void 0 && error instanceof Error) {
+    return new Error(`[${code}] ${error.message}`);
+  }
+  return error;
+}
+function createKvCapability(driver) {
+  let ensurePromise = null;
+  const ensureTable = () => {
+    if (ensurePromise === null) {
+      ensurePromise = driver.run(
+        `CREATE TABLE IF NOT EXISTS ${KV_TABLE} (key TEXT PRIMARY KEY, value TEXT, expires_at INTEGER)`
+      ).then(() => void 0);
+    }
+    return ensurePromise;
+  };
+  const handler = async (method, args) => {
+    try {
+      await ensureTable();
+      switch (method) {
+        case KV_RPC.get: {
+          const [key] = args;
+          const row = await driver.get(`SELECT value, expires_at FROM ${KV_TABLE} WHERE key = ?`, [
+            key
+          ]);
+          if (row === null || row === void 0) return null;
+          const expiresAt = row.expires_at;
+          if (expiresAt !== null && expiresAt !== void 0 && Number(expiresAt) <= nowSeconds()) {
+            return null;
+          }
+          return row.value;
+        }
+        case KV_RPC.put: {
+          const [key, value, options] = args;
+          const ttl = options?.expirationTtlSeconds;
+          const expiresAt = typeof ttl === "number" && ttl > 0 ? nowSeconds() + Math.floor(ttl) : null;
+          await driver.run(`DELETE FROM ${KV_TABLE} WHERE key = ?`, [key]);
+          await driver.run(`INSERT INTO ${KV_TABLE} (key, value, expires_at) VALUES (?, ?, ?)`, [
+            key,
+            value,
+            expiresAt
+          ]);
+          return void 0;
+        }
+        case KV_RPC.delete: {
+          const [key] = args;
+          await driver.run(`DELETE FROM ${KV_TABLE} WHERE key = ?`, [key]);
+          return void 0;
+        }
+        case KV_RPC.list: {
+          const [options] = args;
+          const prefix = options?.prefix ?? "";
+          const limit = options?.limit ?? KV_LIST_DEFAULT_LIMIT;
+          const rows = prefix === "" ? await driver.all(`SELECT key, expires_at FROM ${KV_TABLE}`) : await driver.all(`SELECT key, expires_at FROM ${KV_TABLE} WHERE key LIKE ?`, [
+            `${prefix}%`
+          ]);
+          const now = nowSeconds();
+          const entries = [];
+          for (const row of rows) {
+            const expiresAt = row.expires_at;
+            if (expiresAt !== null && expiresAt !== void 0 && Number(expiresAt) <= now) continue;
+            entries.push({
+              name: String(row.key),
+              expiration: expiresAt === null || expiresAt === void 0 ? null : Number(expiresAt)
+            });
+            if (entries.length >= limit) break;
+          }
+          return entries;
+        }
+        default:
+          throw new Error(
+            `\u672A\u77E5\u7684 cloud.kv \u65B9\u6CD5 "${String(method)}"\uFF08${KV_CAPABILITY_CODES.invalidMethod}\uFF09`
+          );
+      }
+    } catch (error) {
+      throw errorWithCode2(error);
+    }
+  };
+  return {
+    capabilities: [{ name: "kv", value: { [RPC_CAPABILITY_KEY]: true } }],
+    rpcHandlers: { kv: handler }
+  };
+}
+
 // packages/web-container/src/sim/runtime.ts
 function mergeBundles(bundles) {
   const capabilities = [];
@@ -6689,7 +6883,8 @@ async function createBrowserSimRuntime(options) {
     projectId: options.projectId,
     ...options.realtime === void 0 ? {} : options.realtime
   });
-  const bundle = mergeBundles([db.bundle, storage.bundle, realtime.bundle]);
+  const kvBundle = createKvCapability(db.driver);
+  const bundle = mergeBundles([db.bundle, storage.bundle, kvBundle, realtime.bundle]);
   await db.engine.load();
   const runner = createOfflineFunctionRunner(options.runner ?? {});
   return {

package/dist/vite-dev.d.ts

@@ -11,6 +11,8 @@
  *   （真 live binding、真模块隔离），不是 CJS 打平；
  * - **转换**：`.ts` 复用 stripTypes 擦类型；`.css` 变成「注入 `<style>` 的副作用模块」；
  *   `.json` 变成默认导出对象；`.vue` 经注入的 SFC 编译器（IDE 侧装 `vue/compiler-sfc`）；
+ *   JS 系产物统一过 define 替换（`process.env.NODE_ENV` / `__VUE_*__`），让 esm-bundler
+ *   构建（vue 等）在无打包器的浏览器里也能跑；
  * - **依赖**：裸说明符经 node-resolve 命中 VFS `node_modules/`（终端 `npm install` 的产物），
  *   与 CLI / 线上同一套解析规则；相对说明符支持 Vite 风格省略扩展名（.ts/.js/.vue/…）；
  * - **HMR**：订阅 VFS 变更（`vfs.onMutate`，IDE 保存 / shell 写入 / npm 解包皆触发）→