@open-wxa/wxa-runner-core 0.7.0 → 0.8.0

package/dist/runtime/sw.js

@@ -0,0 +1,56 @@
+"use strict";
+(() => {
+  // src/runtime/networkPanel.ts
+  var MOCK_PREFIX = "/__wxa__/mock/";
+  var MOCK_ID_HEADER = "x-wxa-mock-id";
+  function toHeaders(header) {
+    const headers = new Headers();
+    for (const [name, value] of Object.entries(header)) {
+      if (value === void 0 || value === null) continue;
+      try {
+        headers.set(name, String(value));
+      } catch {
+      }
+    }
+    return headers;
+  }
+
+  // src/runtime/sw.ts
+  var scope = self;
+  var NULL_BODY_STATUSES = /* @__PURE__ */ new Set([204, 205, 304]);
+  var URLPatternClass = globalThis.URLPattern;
+  scope.addEventListener("install", (event) => {
+    scope.skipWaiting();
+    if (!event.addRoutes || !URLPatternClass) return;
+    const others = { not: { urlPattern: new URLPatternClass({ pathname: `${MOCK_PREFIX}*` }) } };
+    try {
+      event.waitUntil(event.addRoutes([{ condition: others, source: "network" }]).catch(() => void 0));
+    } catch {
+    }
+  });
+  scope.addEventListener("activate", (event) => event.waitUntil(scope.clients.claim()));
+  scope.addEventListener("fetch", (event) => {
+    const id = event.request.headers.get(MOCK_ID_HEADER);
+    if (!id || !new URL(event.request.url).pathname.startsWith(MOCK_PREFIX)) return;
+    event.respondWith(mockedResponse(event.clientId, id));
+  });
+  async function mockedResponse(clientId, id) {
+    const client = await scope.clients.get(clientId);
+    if (!client) return Response.error();
+    const reply = await new Promise((resolve) => {
+      const channel = new MessageChannel();
+      channel.port1.onmessage = (event) => resolve(event.data);
+      client.postMessage({ type: "wxa-mock-response", id }, [channel.port2]);
+    });
+    if (!reply) return Response.error();
+    try {
+      return new Response(NULL_BODY_STATUSES.has(reply.statusCode) ? null : reply.body, {
+        status: reply.statusCode,
+        headers: toHeaders(reply.header)
+      });
+    } catch {
+      return Response.error();
+    }
+  }
+})();
+//# sourceMappingURL=sw.js.map

package/dist/runtime/sw.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/runtime/networkPanel.ts","../../src/runtime/sw.ts"],"sourcesContent":["/**\n * 小程序的请求在浏览器 Network 面板里的样子，宿主、Service Worker 和开发服务器共用\n *\n * 原地址放在路径里：/__wxa__/proxy/https/api.example.com/user/info?id=1。Name 列显示接口名（info?id=1），\n * 按域名、路径过滤也直接可用；放在查询参数里时每一行都是 proxy?url=https%3A%2F%2F…，分不出是哪个接口。\n *\n * - 经开发服务器转发的请求：/__wxa__/proxy/…\n * - 被拦截规则拦下的请求：/__wxa__/mock/…，由 Service Worker 返回规则给出的响应，只用于显示（见 sw.ts）\n */\n\nimport type { MockedResponse } from './host/api/routes';\n\nexport const PROXY_PREFIX = '/__wxa__/proxy/';\nexport const MOCK_PREFIX = '/__wxa__/mock/';\n\n/** 显示被拦截请求的 fetch 带上这个头，Service Worker 凭它向宿主要对应的响应 */\nexport const MOCK_ID_HEADER = 'x-wxa-mock-id';\n\n/** Service Worker 向宿主要响应时发的消息，附带一个 MessagePort，宿主从这个端口回复 MockReply */\nexport interface MockQuery {\n  type: 'wxa-mock-response';\n  id: string;\n}\n\n/** 请求被取消、拦截规则出错，或宿主已经不认识这个 id 时为 null，Network 面板里显示为失败 */\nexport type MockReply = MockedResponse | null;\n\n/**\n * 原地址在开发服务器上对应的路径，prefix 是 PROXY_PREFIX 或 MOCK_PREFIX。不是 http(s) 地址时返回 null\n *\n * 先按 URL 规范化：路径里的 .. 要在拼接前解析掉，否则浏览器会在代理路径上解析，把域名那一段也吃掉\n */\nexport function toServerPath(prefix: string, url: string): string | null {\n  let target: URL;\n  try {\n    target = new URL(url);\n  } catch {\n    return null;\n  }\n  if (target.protocol !== 'http:' && target.protocol !== 'https:') return null;\n  return `${prefix}${target.protocol.slice(0, -1)}/${target.host}${target.pathname}${target.search}`;\n}\n\n/**\n * toServerPath 的逆运算，格式不对或还原出的地址不合法时返回 null\n *\n * 只校验不规范化，返回拼出的原样字符串：路径里的 %2F 等编码要原样转发\n */\nexport function fromServerPath(prefix: string, serverPath: string): string | null {\n  if (!serverPath.startsWith(prefix)) return null;\n  const match = /^(https?)\\/([^/?#]+)(.*)$/.exec(serverPath.slice(prefix.length));\n  if (!match) return null;\n  const url = `${match[1]}://${match[2]}${match[3]}`;\n  try {\n    new URL(url);\n    return url;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * 用于显示的请求、响应头。浏览器不允许设置的（cookie、set-cookie 等）会被忽略，\n * 名字或值不合法的（如值里有中文）跳过：它们只影响 Network 面板里的显示，小程序拿到的头不受影响。\n * 值为 undefined、null 的和代理一样不发\n */\nexport function toHeaders(header: Record<string, unknown>): Headers {\n  const headers = new Headers();\n  for (const [name, value] of Object.entries(header)) {\n    if (value === undefined || value === null) continue;\n    try {\n      headers.set(name, String(value));\n    } catch {\n      // 跳过\n    }\n  }\n  return headers;\n}\n","/**\n * Service Worker（打包为 /__wxa__/runtime/sw.js）：让被拦截的 wx.request 也出现在 Network 面板里\n *\n * 宿主照原请求向 /__wxa__/mock/… 发一个带 x-wxa-mock-id 头的 fetch（见 host/mockMirror.ts），\n * 这里拦下它，向发出请求的页面要拦截规则给出的响应。其余请求一律不处理，照常走网络。\n */\n\nimport { MOCK_ID_HEADER, MOCK_PREFIX, MockQuery, MockReply, toHeaders } from './networkPanel';\n\n// tsconfig 只带 DOM 的类型，这里只声明用到的 Service Worker 接口\ninterface ExtendableEvent extends Event {\n  waitUntil(promise: Promise<unknown>): void;\n}\ninterface InstallEvent extends ExtendableEvent {\n  /** Static Routing API，Chrome 123 起支持 */\n  addRoutes?(rules: object[]): Promise<void>;\n}\ninterface FetchEvent extends ExtendableEvent {\n  request: Request;\n  clientId: string;\n  respondWith(response: Promise<Response>): void;\n}\ninterface WorkerScope {\n  skipWaiting(): Promise<void>;\n  clients: {\n    claim(): Promise<void>;\n    get(id: string): Promise<{ postMessage(message: MockQuery, transfer: Transferable[]): void } | undefined>;\n  };\n  addEventListener(type: 'install', listener: (event: InstallEvent) => void): void;\n  addEventListener(type: 'activate', listener: (event: ExtendableEvent) => void): void;\n  addEventListener(type: 'fetch', listener: (event: FetchEvent) => void): void;\n}\n\nconst scope = self as unknown as WorkerScope;\n\n/** 这些状态码的响应不能带响应体，带了 Response 构造函数会报错 */\nconst NULL_BODY_STATUSES = new Set([204, 205, 304]);\n\nconst URLPatternClass = (globalThis as { URLPattern?: new (init: { pathname: string }) => object }).URLPattern;\n\nscope.addEventListener('install', event => {\n  // 新版本装好后立即接替旧版本，不用等所有标签页关闭\n  scope.skipWaiting();\n  // 其余请求不唤起 Service Worker，直接走网络。不支持的浏览器里照样能用，只是每个请求都先经过 fetch 事件\n  if (!event.addRoutes || !URLPatternClass) return;\n  const others = { not: { urlPattern: new URLPatternClass({ pathname: `${MOCK_PREFIX}*` }) } };\n  try {\n    event.waitUntil(event.addRoutes([{ condition: others, source: 'network' }]).catch(() => undefined));\n  } catch {\n    // 早期版本不支持 not 条件，同上\n  }\n});\n\n// 第一次打开页面时就接管它，不用刷新\nscope.addEventListener('activate', event => event.waitUntil(scope.clients.claim()));\n\nscope.addEventListener('fetch', event => {\n  const id = event.request.headers.get(MOCK_ID_HEADER);\n  if (!id || !new URL(event.request.url).pathname.startsWith(MOCK_PREFIX)) return;\n  event.respondWith(mockedResponse(event.clientId, id));\n});\n\nasync function mockedResponse(clientId: string, id: string): Promise<Response> {\n  const client = await scope.clients.get(clientId);\n  if (!client) return Response.error();\n  const reply = await new Promise<MockReply>(resolve => {\n    const channel = new MessageChannel();\n    channel.port1.onmessage = event => resolve(event.data);\n    client.postMessage({ type: 'wxa-mock-response', id }, [channel.port2]);\n  });\n  if (!reply) return Response.error();\n  try {\n    return new Response(NULL_BODY_STATUSES.has(reply.statusCode) ? null : reply.body, {\n      status: reply.statusCode,\n      headers: toHeaders(reply.header)\n    });\n  } catch {\n    // 状态码不在 200～599：小程序照样拿得到，浏览器的 Response 表示不了\n    return Response.error();\n  }\n}\n"],"mappings":";;;AAaO,MAAM,cAAc;AAGpB,MAAM,iBAAiB;AAkDvB,WAAS,UAAU,QAA0C;AAClE,UAAM,UAAU,IAAI,QAAQ;AAC5B,eAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,MAAM,GAAG;AAClD,UAAI,UAAU,UAAa,UAAU,KAAM;AAC3C,UAAI;AACF,gBAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AAAA,MACjC,QAAQ;AAAA,MAER;AAAA,IACF;AACA,WAAO;AAAA,EACT;;;AC5CA,MAAM,QAAQ;AAGd,MAAM,qBAAqB,oBAAI,IAAI,CAAC,KAAK,KAAK,GAAG,CAAC;AAElD,MAAM,kBAAmB,WAA2E;AAEpG,QAAM,iBAAiB,WAAW,WAAS;AAEzC,UAAM,YAAY;AAElB,QAAI,CAAC,MAAM,aAAa,CAAC,gBAAiB;AAC1C,UAAM,SAAS,EAAE,KAAK,EAAE,YAAY,IAAI,gBAAgB,EAAE,UAAU,GAAG,WAAW,IAAI,CAAC,EAAE,EAAE;AAC3F,QAAI;AACF,YAAM,UAAU,MAAM,UAAU,CAAC,EAAE,WAAW,QAAQ,QAAQ,UAAU,CAAC,CAAC,EAAE,MAAM,MAAM,MAAS,CAAC;AAAA,IACpG,QAAQ;AAAA,IAER;AAAA,EACF,CAAC;AAGD,QAAM,iBAAiB,YAAY,WAAS,MAAM,UAAU,MAAM,QAAQ,MAAM,CAAC,CAAC;AAElF,QAAM,iBAAiB,SAAS,WAAS;AACvC,UAAM,KAAK,MAAM,QAAQ,QAAQ,IAAI,cAAc;AACnD,QAAI,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,QAAQ,GAAG,EAAE,SAAS,WAAW,WAAW,EAAG;AACzE,UAAM,YAAY,eAAe,MAAM,UAAU,EAAE,CAAC;AAAA,EACtD,CAAC;AAED,iBAAe,eAAe,UAAkB,IAA+B;AAC7E,UAAM,SAAS,MAAM,MAAM,QAAQ,IAAI,QAAQ;AAC/C,QAAI,CAAC,OAAQ,QAAO,SAAS,MAAM;AACnC,UAAM,QAAQ,MAAM,IAAI,QAAmB,aAAW;AACpD,YAAM,UAAU,IAAI,eAAe;AACnC,cAAQ,MAAM,YAAY,WAAS,QAAQ,MAAM,IAAI;AACrD,aAAO,YAAY,EAAE,MAAM,qBAAqB,GAAG,GAAG,CAAC,QAAQ,KAAK,CAAC;AAAA,IACvE,CAAC;AACD,QAAI,CAAC,MAAO,QAAO,SAAS,MAAM;AAClC,QAAI;AACF,aAAO,IAAI,SAAS,mBAAmB,IAAI,MAAM,UAAU,IAAI,OAAO,MAAM,MAAM;AAAA,QAChF,QAAQ,MAAM;AAAA,QACd,SAAS,UAAU,MAAM,MAAM;AAAA,MACjC,CAAC;AAAA,IACH,QAAQ;AAEN,aAAO,SAAS,MAAM;AAAA,IACxB;AAAA,EACF;","names":[]}

package/dist/{setup-DZ5FeKay.d.mts → setup-Bac8XdhR.d.mts}

@@ -5,6 +5,8 @@
  * 不经过 postMessage：同步 API（如 getStorageSync）因此可以同步返回。
  */
 type FrameKind = 'service' | 'webview';
+/** 把浏览器里的报错转发到开发服务器的终端：errors 只转发报错，all 再加上 console.warn / console.error，false 不转发 */
+type ForwardConsole = 'errors' | 'all' | false;
 interface DeviceProfile {
     model: string;
     screenWidth: number;
@@ -32,6 +34,8 @@ interface AppInfo {
         env: Record<string, string>;
         error?: string;
     };
+    /** 没有时不转发 */
+    forwardConsole?: ForwardConsole;
 }
 
 /**
@@ -196,4 +200,4 @@ interface SetupApi {
 /** 只用于获得类型提示，原样返回传入的配置 */
 declare function defineSetup<T extends SetupDefinition>(setup: T): T;
 
-export { type ApiContext as A, type DeviceProfile as D, type FrameKind as F, type KnownMocks as K, type MockConfig as M, type NetworkConfig as N, type RouteHandler as R, type SetupApi as S, type UserInfo as U, type ApiHandler as a, type ApiResult as b, type AppInfo as c, type MockRequest as d, type MockResponse as e, type MockValue as f, type SetupConfig as g, type SetupContext as h, type SetupDefinition as i, type SetupEnv as j, defineSetup as k };
+export { type ApiContext as A, type DeviceProfile as D, type ForwardConsole as F, type KnownMocks as K, type MockConfig as M, type NetworkConfig as N, type RouteHandler as R, type SetupApi as S, type UserInfo as U, type ApiHandler as a, type ApiResult as b, type AppInfo as c, type MockRequest as d, type MockResponse as e, type MockValue as f, type SetupConfig as g, type SetupContext as h, type SetupDefinition as i, type FrameKind as j, type SetupEnv as k, defineSetup as l };

package/dist/{setup-DZ5FeKay.d.ts → setup-Bac8XdhR.d.ts}

@@ -5,6 +5,8 @@
  * 不经过 postMessage：同步 API（如 getStorageSync）因此可以同步返回。
  */
 type FrameKind = 'service' | 'webview';
+/** 把浏览器里的报错转发到开发服务器的终端：errors 只转发报错，all 再加上 console.warn / console.error，false 不转发 */
+type ForwardConsole = 'errors' | 'all' | false;
 interface DeviceProfile {
     model: string;
     screenWidth: number;
@@ -32,6 +34,8 @@ interface AppInfo {
         env: Record<string, string>;
         error?: string;
     };
+    /** 没有时不转发 */
+    forwardConsole?: ForwardConsole;
 }
 
 /**
@@ -196,4 +200,4 @@ interface SetupApi {
 /** 只用于获得类型提示，原样返回传入的配置 */
 declare function defineSetup<T extends SetupDefinition>(setup: T): T;
 
-export { type ApiContext as A, type DeviceProfile as D, type FrameKind as F, type KnownMocks as K, type MockConfig as M, type NetworkConfig as N, type RouteHandler as R, type SetupApi as S, type UserInfo as U, type ApiHandler as a, type ApiResult as b, type AppInfo as c, type MockRequest as d, type MockResponse as e, type MockValue as f, type SetupConfig as g, type SetupContext as h, type SetupDefinition as i, type SetupEnv as j, defineSetup as k };
+export { type ApiContext as A, type DeviceProfile as D, type ForwardConsole as F, type KnownMocks as K, type MockConfig as M, type NetworkConfig as N, type RouteHandler as R, type SetupApi as S, type UserInfo as U, type ApiHandler as a, type ApiResult as b, type AppInfo as c, type MockRequest as d, type MockResponse as e, type MockValue as f, type SetupConfig as g, type SetupContext as h, type SetupDefinition as i, type FrameKind as j, type SetupEnv as k, defineSetup as l };

package/dist/setup.d.mts

@@ -1 +1 @@
-export { K as KnownMocks, M as MockConfig, d as MockRequest, e as MockResponse, f as MockValue, N as NetworkConfig, R as RouteHandler, S as SetupApi, g as SetupConfig, h as SetupContext, i as SetupDefinition, j as SetupEnv, U as UserInfo, k as defineSetup } from './setup-DZ5FeKay.mjs';
+export { K as KnownMocks, M as MockConfig, d as MockRequest, e as MockResponse, f as MockValue, N as NetworkConfig, R as RouteHandler, S as SetupApi, g as SetupConfig, h as SetupContext, i as SetupDefinition, k as SetupEnv, U as UserInfo, l as defineSetup } from './setup-Bac8XdhR.mjs';

package/dist/setup.d.ts

@@ -1 +1 @@
-export { K as KnownMocks, M as MockConfig, d as MockRequest, e as MockResponse, f as MockValue, N as NetworkConfig, R as RouteHandler, S as SetupApi, g as SetupConfig, h as SetupContext, i as SetupDefinition, j as SetupEnv, U as UserInfo, k as defineSetup } from './setup-DZ5FeKay.js';
+export { K as KnownMocks, M as MockConfig, d as MockRequest, e as MockResponse, f as MockValue, N as NetworkConfig, R as RouteHandler, S as SetupApi, g as SetupConfig, h as SetupContext, i as SetupDefinition, k as SetupEnv, U as UserInfo, l as defineSetup } from './setup-Bac8XdhR.js';

package/dist/test-api.d.mts

@@ -1,5 +1,5 @@
-import { W as WxaTestApi } from './testApi-CnZOLyWw.mjs';
-import './setup-DZ5FeKay.mjs';
+import { W as WxaTestApi } from './testApi-DHuEW5Cl.mjs';
+import './setup-Bac8XdhR.mjs';
 
 /**
  * window.__wxa_test_api__ 的全局类型声明，供测试代码按需引用：

package/dist/test-api.d.ts

@@ -1,5 +1,5 @@
-import { W as WxaTestApi } from './testApi-BLozOgCt.js';
-import './setup-DZ5FeKay.js';
+import { W as WxaTestApi } from './testApi-BOZSXSnV.js';
+import './setup-Bac8XdhR.js';
 
 /**
  * window.__wxa_test_api__ 的全局类型声明，供测试代码按需引用：

package/dist/{testApi-BLozOgCt.d.ts → testApi-BOZSXSnV.d.ts}

@@ -1,11 +1,11 @@
-import { d as MockRequest, F as FrameKind, a as ApiHandler, b as ApiResult, R as RouteHandler } from './setup-DZ5FeKay.js';
+import { d as MockRequest, j as FrameKind, a as ApiHandler, b as ApiResult, R as RouteHandler } from './setup-Bac8XdhR.js';
 
 /**
  * 网络 API：wx.request / downloadFile / uploadFile / connectSocket
  *
  * 基础库 3.x 的协议是「创建任务同步返回 taskId，结果通过 on<Type>TaskStateChange 事件推送」。
- * HTTP 请求经开发服务器的 /__wxa__/proxy 转发：既绕开 CORS，也能携带浏览器禁止设置的
- * cookie / referer 等请求头。
+ * HTTP 请求经开发服务器的 /__wxa__/proxy/ 转发：既绕开 CORS，也能携带浏览器禁止设置的
+ * cookie / referer 等请求头。地址的写法见 networkPanel.ts
  *
  * 基础库自己的请求（数据上报、配置拉取等）不发出，只放行 InnerAudioContext 下载音频，见 byCaller。
  */

package/dist/{testApi-CnZOLyWw.d.mts → testApi-DHuEW5Cl.d.mts}

@@ -1,11 +1,11 @@
-import { d as MockRequest, F as FrameKind, a as ApiHandler, b as ApiResult, R as RouteHandler } from './setup-DZ5FeKay.mjs';
+import { d as MockRequest, j as FrameKind, a as ApiHandler, b as ApiResult, R as RouteHandler } from './setup-Bac8XdhR.mjs';
 
 /**
  * 网络 API：wx.request / downloadFile / uploadFile / connectSocket
  *
  * 基础库 3.x 的协议是「创建任务同步返回 taskId，结果通过 on<Type>TaskStateChange 事件推送」。
- * HTTP 请求经开发服务器的 /__wxa__/proxy 转发：既绕开 CORS，也能携带浏览器禁止设置的
- * cookie / referer 等请求头。
+ * HTTP 请求经开发服务器的 /__wxa__/proxy/ 转发：既绕开 CORS，也能携带浏览器禁止设置的
+ * cookie / referer 等请求头。地址的写法见 networkPanel.ts
  *
  * 基础库自己的请求（数据上报、配置拉取等）不发出，只放行 InnerAudioContext 下载音频，见 byCaller。
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-wxa/wxa-runner-core",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Dev server and browser runtime that run WeChat mini-programs on the official base library",
   "license": "MIT",
   "author": "open-wxa",
@@ -46,11 +46,11 @@
   ],
   "dependencies": {
     "chokidar": "^3.5.3",
-    "esbuild": "^0.27.0",
+    "esbuild": "^0.28.2",
     "express": "^4.18.2",
     "ws": "^8.14.2",
-    "@open-wxa/wxa-runner-compiler": "0.7.0",
-    "@open-wxa/wxa-runner-extractor": "0.7.0"
+    "@open-wxa/wxa-runner-extractor": "0.8.0",
+    "@open-wxa/wxa-runner-compiler": "0.8.0"
   },
   "devDependencies": {
     "@types/express": "^4.17.21",