@adep/web-container 0.2.0 → 0.2.2

package/dist/index.js

@@ -8,7 +8,7 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
-// src/path.ts
+// packages/web-container/src/path.ts
 var path_exports = {};
 __export(path_exports, {
   SEP: () => SEP,
@@ -73,13 +73,13 @@ function isValidSegment(name) {
 }
 var SEP;
 var init_path = __esm({
-  "src/path.ts"() {
+  "packages/web-container/src/path.ts"() {
     "use strict";
     SEP = "/";
   }
 });
 
-// src/node-resolve.ts
+// packages/web-container/src/node-resolve.ts
 function parsePackageMeta(content, context) {
   let parsed;
   try {
@@ -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({
-  "src/node-resolve.ts"() {
+  "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) {
@@ -251,7 +265,7 @@ var init_node_resolve = __esm({
   }
 });
 
-// src/strip-types.ts
+// packages/web-container/src/strip-types.ts
 function isAnnotationLeader(token) {
   return ANNOTATION_LEADERS.has(token) || TS_MODIFIERS.has(token);
 }
@@ -260,7 +274,7 @@ function stripTypes(source) {
 }
 var UnsupportedTsSyntaxError, IDENT_START, IDENT_PART, DECL_KEYWORDS, TS_MODIFIERS, ANNOTATION_LEADERS, Eraser;
 var init_strip_types = __esm({
-  "src/strip-types.ts"() {
+  "packages/web-container/src/strip-types.ts"() {
     "use strict";
     UnsupportedTsSyntaxError = class extends Error {
       constructor(construct, line) {
@@ -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);
@@ -866,7 +892,7 @@ var init_strip_types = __esm({
   }
 });
 
-// src/preview-server.ts
+// packages/web-container/src/preview-server.ts
 var preview_server_exports = {};
 __export(preview_server_exports, {
   buildPreviewDocument: () => buildPreviewDocument,
@@ -965,14 +991,14 @@ function createPreviewServer(vfs, options = {}) {
 }
 var EXTERNAL_SRC;
 var init_preview_server = __esm({
-  "src/preview-server.ts"() {
+  "packages/web-container/src/preview-server.ts"() {
     "use strict";
     init_path();
     EXTERNAL_SRC = /(?:^https?:)?\/\//i;
   }
 });
 
-// src/function-fetch-proxy.ts
+// packages/web-container/src/function-fetch-proxy.ts
 function parseBodyByContentType(rawBody, headers) {
   if (rawBody === null) return void 0;
   const contentType = headers["content-type"] ?? headers["Content-Type"] ?? headers["CONTENT-TYPE"] ?? "";
@@ -1098,7 +1124,7 @@ function createFunctionFetchHandler(options) {
 }
 var FN_FETCH_INTERCEPTOR_SCRIPT;
 var init_function_fetch_proxy = __esm({
-  "src/function-fetch-proxy.ts"() {
+  "packages/web-container/src/function-fetch-proxy.ts"() {
     "use strict";
     FN_FETCH_INTERCEPTOR_SCRIPT = (function() {
       var src = [
@@ -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);",
         "    }",
@@ -1198,7 +1227,7 @@ var init_function_fetch_proxy = __esm({
   }
 });
 
-// src/vite-dev.ts
+// packages/web-container/src/vite-dev.ts
 var vite_dev_exports = {};
 __export(vite_dev_exports, {
   ViteDevError: () => ViteDevError,
@@ -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);
@@ -1551,7 +1609,7 @@ function createViteServer(vfs, options = {}) {
 }
 var ViteDevError, REGEX_PRECEDING_CHARS, REGEX_PRECEDING_KEYWORDS, isIdentStart, isIdentPart, VITE_RESOLVE_SUFFIXES, INLINE_PREFIX, EXTERNAL_SPECIFIER, DATA_OR_BLOB, MODULE_SCRIPT_SRC_RE, MODULE_SCRIPT_INLINE_RE;
 var init_vite_dev = __esm({
-  "src/vite-dev.ts"() {
+  "packages/web-container/src/vite-dev.ts"() {
     "use strict";
     init_path();
     init_node_resolve();
@@ -1615,7 +1673,7 @@ var init_vite_dev = __esm({
   }
 });
 
-// src/vfs.ts
+// packages/web-container/src/vfs.ts
 init_path();
 var ensureAbs = (path) => path.startsWith("/") ? normalize(path) : `/${normalize(path).replace(/^\/+/, "")}`;
 var ROOT = "/";
@@ -1825,13 +1883,13 @@ var VirtualFileSystem = class {
   }
 };
 
-// src/container.ts
+// packages/web-container/src/container.ts
 init_path();
 
-// src/shell.ts
+// packages/web-container/src/shell.ts
 init_path();
 
-// src/completion.ts
+// packages/web-container/src/completion.ts
 init_path();
 var SHELL_COMMANDS = [
   "pwd",
@@ -1943,7 +2001,7 @@ function helpText() {
 `;
 }
 
-// src/shell.ts
+// packages/web-container/src/shell.ts
 function tokenize(line) {
   const tokens = [];
   let current = "";
@@ -2576,7 +2634,7 @@ function wgetFileName(url) {
   }
 }
 
-// src/tar.ts
+// packages/web-container/src/tar.ts
 var BLOCK = 512;
 var GZIP_MAGIC_0 = 31;
 var GZIP_MAGIC_1 = 139;
@@ -2663,7 +2721,7 @@ async function unpackNpmTarball(bytes) {
   return out;
 }
 
-// src/npm-client.ts
+// packages/web-container/src/npm-client.ts
 init_node_resolve();
 var DEFAULT_MAX_INSTALL_DEPTH = 5;
 var defaultFetch = (url, init) => globalThis.fetch(url, init).then((res) => res);
@@ -2815,7 +2873,7 @@ function createNpmClient(options) {
   };
 }
 
-// src/relay-fetch.ts
+// packages/web-container/src/relay-fetch.ts
 var defaultFetch2 = (url, init) => globalThis.fetch(url, init).then((res) => res);
 function createRelayFetch(options) {
   const fetchImpl = options.fetchImpl ?? defaultFetch2;
@@ -2865,7 +2923,7 @@ function createRelayFetch(options) {
   };
 }
 
-// src/module-loader.ts
+// packages/web-container/src/module-loader.ts
 init_node_resolve();
 function interopDefault(value) {
   if (value !== null && typeof value === "object" && "__esModule" in value) {
@@ -2974,7 +3032,7 @@ function composeRequire(vfs, entryFileAbs, cache) {
   };
 }
 
-// src/worker-runtime.ts
+// packages/web-container/src/worker-runtime.ts
 async function evaluateSource(source, filename, args, extraGlobals) {
   const output = [];
   const fakeConsole = {
@@ -3072,10 +3130,10 @@ function createWorkerRuntime(vfs, options = {}) {
   };
 }
 
-// src/test-runner.ts
+// packages/web-container/src/test-runner.ts
 init_strip_types();
 
-// src/test-framework.ts
+// packages/web-container/src/test-framework.ts
 var TestAssertionError = class extends Error {
   constructor(message, expected, received) {
     super(message);
@@ -3338,7 +3396,7 @@ function stringify(value, seen) {
   return `{ ${entries.join(", ")} }`;
 }
 
-// src/test-runner.ts
+// packages/web-container/src/test-runner.ts
 var TEST_FILE_PATTERN = /\.(?:test|spec)\.[cm]?[jt]s$/;
 var IGNORED_SEGMENTS = /* @__PURE__ */ new Set(["node_modules", ".git", ".adep"]);
 function createTestRunner(options) {
@@ -3507,7 +3565,7 @@ function exampleTestSource(name = "example") {
   ].join("\n");
 }
 
-// src/container.ts
+// packages/web-container/src/container.ts
 function viteBanner(server, fresh) {
   return [
     fresh ? `  VITE \u6D4F\u89C8\u5668\u5185 dev server \u5DF2\u5C31\u7EEA\uFF08root: ${server.root}\uFF09
@@ -3713,12 +3771,12 @@ function bootstrap(options) {
   };
 }
 
-// src/index.ts
+// packages/web-container/src/index.ts
 init_node_resolve();
 init_vite_dev();
 init_path();
 
-// src/persistence.ts
+// packages/web-container/src/persistence.ts
 function cloneEntries(entries) {
   return entries.map(
     (entry) => entry.kind === "file" ? { path: entry.path, kind: "file", contents: entry.contents ?? "" } : { path: entry.path, kind: "dir" }
@@ -3931,10 +3989,10 @@ function createCommandHistory(options) {
   };
 }
 
-// src/index.ts
+// packages/web-container/src/index.ts
 init_strip_types();
 
-// src/offline/net.ts
+// packages/web-container/src/offline/net.ts
 var HEALTH_CHECK_INTERVAL_MS = 3e4;
 var HEALTH_CHECK_TIMEOUT_MS = 5e3;
 var HEALTH_ENDPOINT = "/api/v1/health";
@@ -4054,7 +4112,7 @@ function onNetworkChange(listener) {
   return networkMonitor.subscribe(listener);
 }
 
-// src/offline/queue.ts
+// packages/web-container/src/offline/queue.ts
 var STORAGE_KEY = "adep:offline:publish-queue";
 function simpleHash(input) {
   let hash = 0;
@@ -4195,7 +4253,7 @@ var PublishQueue = class {
 };
 var publishQueue = new PublishQueue();
 
-// src/offline/workspace.ts
+// packages/web-container/src/offline/workspace.ts
 var DB_NAME = "adep-offline-workspace";
 function requestError(request) {
   return request.error ?? new Error("IndexedDB operation failed");
@@ -4387,7 +4445,7 @@ var OfflineWorkspace = class {
 };
 var offlineWorkspace = new OfflineWorkspace();
 
-// src/sim/kv.ts
+// packages/web-container/src/sim/kv.ts
 function createMemorySimKv() {
   const map = /* @__PURE__ */ new Map();
   return {
@@ -4453,12 +4511,14 @@ function pickDefaultSimKv() {
   return typeof indexedDB !== "undefined" ? createIdbSimKv() : createMemorySimKv();
 }
 
-// ../runtime/src/shared/capability-keys.ts
+// packages/runtime/src/shared/capability-keys.ts
 var RPC_CAPABILITY_KEY = "__adepRpc";
 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`。 */
@@ -4485,7 +4545,7 @@ var REALTIME_CAPABILITY_METHODS = [
   "unsubscribe"
 ];
 
-// ../runtime/src/database/builder/dialect.ts
+// packages/runtime/src/database/builder/dialect.ts
 var sqliteDialect = {
   name: "sqlite",
   placeholder: () => "?",
@@ -4504,7 +4564,7 @@ function dialectFor(driver) {
   return driver.engine === "pg" ? postgresDialect : sqliteDialect;
 }
 
-// ../runtime/src/database/provision/identifier.ts
+// packages/runtime/src/database/provision/identifier.ts
 var DbError = class extends Error {
   constructor(status, code, message) {
     super(message);
@@ -4528,31 +4588,45 @@ function quoteIdentifier(name) {
   return `"${name.replace(/"/g, '""')}"`;
 }
 
-// ../runtime/src/database/builder/guards.ts
+// packages/runtime/src/database/builder/guards.ts
 function unsafeOperation(message) {
   return new DbError(400, "DB_UNSAFE_OP", 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"
+    );
+  }
 }
 
-// ../runtime/src/database/builder/owned.ts
+// packages/runtime/src/database/builder/owned.ts
 var OWNED_PK = "id";
 var OWNED_OWNER_KEY = "__owner_key";
 var CHANGE_LOG_PREFIX = "_adep_changes_";
@@ -4665,7 +4739,7 @@ async function readChanges(driver, table, query = {}) {
   return rows.map(parseChange);
 }
 
-// ../runtime/src/database/builder/ulid.ts
+// packages/runtime/src/database/builder/ulid.ts
 var ENCODING = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
 var TIME_LEN = 10;
 var RANDOM_LEN = 16;
@@ -4731,7 +4805,7 @@ function ulid(now = Date.now()) {
   return time + random;
 }
 
-// ../runtime/src/database/builder/table.ts
+// packages/runtime/src/database/builder/table.ts
 var OPERATORS = /* @__PURE__ */ new Set([
   "=",
   "!=",
@@ -5050,7 +5124,7 @@ function createTableBuilder(table, driver, dialect, options = {}) {
   return build(initialState);
 }
 
-// ../runtime/src/database/builder/index.ts
+// packages/runtime/src/database/builder/index.ts
 var TX_STATES = /* @__PURE__ */ new WeakMap();
 function createCloudDb(driver, options = {}) {
   const dialect = options.dialect ?? dialectFor(driver);
@@ -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);
       }
@@ -5104,13 +5186,14 @@ function createCloudDb(driver, options = {}) {
   return makeHandle({ allowWriteDuringTx: false });
 }
 
-// ../runtime/src/database/sdk/cloud.ts
+// packages/runtime/src/database/sdk/cloud.ts
 var CLOUD_DB_SPEC = {
   kind: "cloud-db",
   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);
@@ -5208,7 +5295,7 @@ function createDbCapability(driver, options = {}) {
   };
 }
 
-// ../runtime/src/sim/sql-engine.ts
+// packages/runtime/src/sim/sql-engine.ts
 var SimDbError = class extends Error {
   constructor(code, message) {
     super(message);
@@ -5626,7 +5713,7 @@ function project(rows, selectRaw) {
   });
 }
 
-// src/sim/db.ts
+// packages/web-container/src/sim/db.ts
 function simDbKey(projectId) {
   return `db:${projectId}`;
 }
@@ -5654,7 +5741,7 @@ function createBrowserSimDb(options) {
   return { bundle, engine, driver };
 }
 
-// ../runtime/src/storage/driver.ts
+// packages/runtime/src/storage/driver.ts
 var PROJECT_QUOTA_BYTES = 1024 * 1024 * 1024;
 var StorageError = class extends Error {
   constructor(status, code, message) {
@@ -5695,7 +5782,7 @@ function assertSafeStoragePath(path) {
   return path;
 }
 
-// ../runtime/src/storage/hmac-sha256.ts
+// packages/runtime/src/storage/hmac-sha256.ts
 var K = new Uint32Array([
   1116352408,
   1899447441,
@@ -5856,7 +5943,7 @@ function hmacSha256Hex(key, message) {
   return [...hmacSha256(key, message)].map((b) => b.toString(16).padStart(2, "0")).join("");
 }
 
-// ../runtime/src/storage/signature.ts
+// packages/runtime/src/storage/signature.ts
 var DEFAULT_SIGN_TTL_SECONDS = 15 * 60;
 var SIGN_EXPIRES_KEY = "x-expires";
 var SIGN_SIGNATURE_KEY = "x-signature";
@@ -5871,7 +5958,7 @@ function signDownloadUrl(config, projectId, path, ttlSeconds = DEFAULT_SIGN_TTL_
   return `${base}?${SIGN_EXPIRES_KEY}=${expires}&${SIGN_SIGNATURE_KEY}=${signature}`;
 }
 
-// ../runtime/src/storage/cloud.ts
+// packages/runtime/src/storage/cloud.ts
 var DEFAULT_VISIBILITY = "private";
 function asBytes(data) {
   if (typeof data === "string") return new TextEncoder().encode(data);
@@ -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": {
@@ -5930,7 +6020,7 @@ function createStorageCapability(driver, signer, projectId) {
   };
 }
 
-// src/sim/storage.ts
+// packages/web-container/src/sim/storage.ts
 function toMeta(object) {
   return {
     path: object.path,
@@ -6043,7 +6133,7 @@ function createBrowserSimStorage(options) {
   return { bundle, driver };
 }
 
-// ../runtime/src/sim/realtime.ts
+// packages/runtime/src/sim/realtime.ts
 var SimRealtime = class {
   seq = 0;
   subscribers = /* @__PURE__ */ new Map();
@@ -6085,7 +6175,7 @@ var SimRealtime = class {
 };
 var REALTIME_CODES = REALTIME_CAPABILITY_CODES;
 
-// src/sim/realtime.ts
+// packages/web-container/src/sim/realtime.ts
 function defaultTicketProvider(projectId) {
   return async () => {
     const res = await fetch("/api/v1/realtime/ticket", {
@@ -6255,7 +6345,7 @@ function createBrowserRealtime(options) {
   };
 }
 
-// ../runtime/src/functions/runtime/chain.ts
+// packages/runtime/src/functions/runtime/chain.ts
 function isChainCapability(value) {
   if (typeof value !== "object" || value === null) return false;
   const spec = value[CHAIN_CAPABILITY_KEY];
@@ -6326,7 +6416,7 @@ function createChainClient(capability, port, pending, nextId, spec) {
   return makeRoot(void 0);
 }
 
-// ../runtime/src/functions/runtime/cloud-container.ts
+// packages/runtime/src/functions/runtime/cloud-container.ts
 var KNOWN_CAPABILITY_HINTS = {
   db: {
     code: "DB_NOT_PROVISIONED",
@@ -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 {
@@ -6402,7 +6496,7 @@ function createCloudContainer() {
   };
 }
 
-// src/sim/ctx.ts
+// packages/web-container/src/sim/ctx.ts
 function createLocalPort(handler) {
   const listeners = [];
   const dispatch = (message) => {
@@ -6482,7 +6576,7 @@ function buildCloudFromBundle(bundle) {
   return container.cloud;
 }
 
-// ../runtime/src/functions/runtime/exports.ts
+// packages/runtime/src/functions/runtime/exports.ts
 function transformModule(code) {
   let out = code;
   const named = [];
@@ -6524,7 +6618,7 @@ function transformModule(code) {
   return out;
 }
 
-// src/sim/runner.ts
+// packages/web-container/src/sim/runner.ts
 init_strip_types();
 function safeStringify2(value) {
   if (typeof value === "string") return value;
@@ -6655,7 +6749,107 @@ function createOfflineFunctionRunner(options = {}) {
   return { run };
 }
 
-// src/sim/runtime.ts
+// 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 = [];
   const byName = /* @__PURE__ */ new Map();
@@ -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 {
@@ -6702,7 +6897,7 @@ async function createBrowserSimRuntime(options) {
   };
 }
 
-// src/index.ts
+// packages/web-container/src/index.ts
 init_function_fetch_proxy();
 export {
   COMPLETABLE_COMMANDS,