miaoda-expo-devkit 0.1.1-beta.112 → 0.1.1-beta.114

package/README.md

@@ -2,8 +2,7 @@
 
 Expo / React Native 开发环境工具集，通过 Metro 构建层注入以下能力：
 
-- **Sentry DSN 替换** — 拦截 `@sentry/react-native`，将真实 DSN 替换为无害 stub，防止开发期错误事件发送到 Sentry 服务器
-- **错误 / 网络捕获** — 内置 `SentryCapture`，自动调用 Metro `/symbolicate` 还原源码位置并输出到 `console.warn`
+- **Sentry 初始化守卫** — Native 透传真实初始化；独立 Expo Web 使用安全 fallback；sandbox Web 由前置 polyfill 唯一初始化
 - **Bundle 首部注入** — 在 expo-router 初始化之前执行自定义脚本
 - **HMR postMessage 控制** — 通过 `window.postMessage` 在运行时启动或停止 Fast Refresh
 - **LogBox 屏蔽** — web 平台禁用 Expo 全屏错误遮罩
@@ -60,7 +59,7 @@ module.exports = withExpoCalendarStub(withExpoMediaLibraryStub(withEntryInjectio
 
 ### Sentry 初始化
 
-照常调用 `Sentry.init`，stub 自动注入内置捕获器，无需额外配置：
+应用可照常调用 `Sentry.init`：
 
 ```ts
 // app/_layout.tsx
@@ -68,34 +67,17 @@ import * as Sentry from '@sentry/react-native';
 
 Sentry.init({
   dsn: 'https://your-key@sentry.io/your-project',
-  // stub 自动拦截 beforeSend / beforeBreadcrumb，错误摘要输出到 console.warn
 });
 ```
 
-#### 自定义回调（可选）
+stub 的行为按平台区分：
 
-传入自己的 `beforeSend` / `beforeBreadcrumb`，会在内置捕获器之后串联执行：
+- iOS/Android：原样调用真实 `@sentry/react-native` init，应用参数不变；
+- 独立 Expo Web：用安全 fallback DSN 初始化，避免开发事件进入真实项目；
+- vite-sandbox Expo Web：sandbox 生成的 Metro polyfill 已经把应用实际依赖的 `@sentry/browser` 与统一观测运行时打包，并先于应用完成唯一一次 init；stub 检测版本字符串在场标记后吞掉应用 init；
+- 版本不一致：只输出 `console.error`，不向编辑器宿主发送消息。
 
-```ts
-import * as Sentry from '@sentry/react-native';
-import { SentryCapture } from 'miaoda-expo-devkit';
-import type { ErrorCaptureInfo, NetworkCaptureInfo } from 'miaoda-expo-devkit';
-
-const capture = new SentryCapture({
-  onError(info: ErrorCaptureInfo) {
-    console.log('Error at:', info.symbolicatedFrames?.[0]);
-  },
-  onNetwork(info: NetworkCaptureInfo) {
-    console.log('Network:', info.method, info.url, info.statusCode);
-  },
-});
-
-Sentry.init({
-  dsn: 'https://your-key@sentry.io/your-project',
-  beforeSend: capture.beforeSend,
-  beforeBreadcrumb: capture.beforeBreadcrumb,
-});
-```
+fetch/XHR 取数、网络与 console 事件、原始数据长度限制、Supabase 白名单、`GLOBAL_ERROR` 和 Metro `/symbolicate` 均由 vite-sandbox 的同一份运行时维护。devkit 不复制这些规则，也不再包含 capture 或 runtime bridge。
 
 ### HMR postMessage 控制
 
@@ -151,75 +133,6 @@ window.__DEVKIT_HMR_ENABLED__  // true | false
 
 ---
 
-### `new SentryCapture(options)`
-
-从 `miaoda-expo-devkit` 引入。
-
-用于自定义捕获行为。stub 内置了一个默认实例（输出到 `console.warn`），此类用于叠加自定义处理逻辑。
-
-| 选项 | 类型 | 说明 |
-|---|---|---|
-| `onError` | `(info: ErrorCaptureInfo) => void` | 捕获到错误时触发，携带符号化后的调用栈 |
-| `onNetwork` | `(info: NetworkCaptureInfo) => void` | 捕获到 HTTP 请求时触发 |
-| `symbolicator` | `MetroSymbolicator` | 可选，单测时注入 mock 以隔离网络依赖 |
-
-构造完成后，将绑定方法传给 `Sentry.init`：
-
-```ts
-Sentry.init({
-  beforeSend: capture.beforeSend,
-  beforeBreadcrumb: capture.beforeBreadcrumb,
-});
-```
-
-#### `ErrorCaptureInfo`
-
-| 字段 | 类型 | 说明 |
-|---|---|---|
-| `message` | `string` | 错误信息 |
-| `symbolicatedFrames` | `MetroFrame[] \| null` | 经 Metro 符号化后还原到源码位置的调用栈帧 |
-| `componentStack` | `string \| null` | React 组件调用栈（ErrorBoundary 捕获的错误才有值） |
-| `mechanismType` | `string \| null` | Sentry 捕获方式：`'onerror'`、`'generic'`、`'auto.function.react.error_boundary'` 等 |
-
-#### `NetworkCaptureInfo`
-
-| 字段 | 类型 | 说明 |
-|---|---|---|
-| `method` | `string \| null` | HTTP 方法 |
-| `url` | `string \| null` | 请求 URL |
-| `statusCode` | `number \| null` | HTTP 状态码（连接级失败为 `null`） |
-
----
-
-### `new MetroSymbolicator(options?)`
-
-从 `miaoda-expo-devkit` 引入。
-
-通过 Metro `/symbolicate` 接口将 bundle 行列号还原为源码位置。`SentryCapture` 内部已默认使用，主要用途是单测时注入 mock。
-
-| 选项 | 类型 | 说明 |
-|---|---|---|
-| `baseUrl` | `string` | Metro server 地址。不传则从 `NativeModules.SourceCode.scriptURL` 自动推断，fallback 到 `localhost:8081`。 |
-
-**单测示例：**
-
-```ts
-const mockSym = {
-  parseErrorStack: jest.fn(() => []),
-  symbolicate: jest.fn(async () => null),
-};
-const onError = jest.fn();
-const capture = new SentryCapture({ onError, symbolicator: mockSym });
-
-await capture.beforeSend(fakeEvent, { originalException: new Error('oops') });
-
-expect(onError).toHaveBeenCalledWith(
-  expect.objectContaining({ message: 'oops' }),
-);
-```
-
----
-
 ## 全局标记
 
 注入脚本在 bundle 执行时（早于任何 React 代码）写入以下全局变量，可用于 E2E 测试断言：
@@ -233,7 +146,7 @@ expect(onError).toHaveBeenCalledWith(
 
 | 变量 | 默认值 | 说明 |
 |---|---|---|
-| `SENTRY_OVERRIDE_DSN` | `https://stubPublicKey@o0.ingest.sentry.io/0` | 覆盖 Sentry DSN，可指向本地 relay 等自定义端点 |
+| `INJECT_SENTRY_DSN` | 安全 stub DSN | vite-sandbox 服务端已有变量；sandbox 会自动编入生成 runtime，应用开发者无需配置 |
 | `METRO_CACHE_DIR` | `projectRoot/.metro-cache` | Metro transform 缓存目录绝对路径，优先级最高，适合容器/CI 挂载外部持久目录 |
 | `METRO_TRANSFORM_LOG` | _(未设置时不记录)_ | 构建日志输出文件的绝对路径（JSONL 格式），仅开发模式（`__DEV__`）下生效 |
 | `EXPO_AI_ERROR_COLLECTOR` | _(未设置时关闭)_ | 设为 `1` 后由 DevKit 管理的 Expo CLI patch 采集当前 Metro 编译状态 |
@@ -265,6 +178,14 @@ AI 进程直接读取这个文件即可，不需要额外的 HTTP 服务或 WebS
 该范围以外的 CLI 版本不会静默套用补丁；升级时需要先检查发布产物，确认兼容后再调整
 `pnpmfile.cjs` 中的范围和对应测试。
 
+以下变量只服务于 sandbox 专项 E2E，不是应用或线上部署配置：
+
+| 变量 | 默认值 | 设置方与用途 |
+|---|---|---|
+| `EXPO_OVERRIDE_METRO_CONFIG` | 无 | 线上由 vite-sandbox 自动设置；专项 E2E 由准备流程指向生成的 `node_modules/.cache/vite-sandbox/metro.config.cjs` |
+| `EXPO_E2E_PORT` | `3001` | 仅在 Playwright 端口冲突时由本地或 CI 覆盖 |
+| `EXPO_E2E_SANDBOX_PROJECT_ID` | `0` | 仅用于断言 Sentry envelope 使用 sandbox DSN 的 project id |
+
 ## 工作原理
 
 ```
@@ -362,18 +283,16 @@ setupHMRMessageControl()
 
 sentry-react-native-stub.js
   └─ init(options)
-       └─ RealSentry.init({ ...options, dsn: OVERRIDE_DSN, beforeSend, beforeBreadcrumb })
-            ├─ _capture.beforeSend(event, hint)         ← 内置 SentryCapture（自动注入）
-            │    ├─ MetroSymbolicator.symbolicate()     →  POST /symbolicate
-            │    └─ onError({ message, frames, ... })   →  console.warn（默认）
-            └─ options.beforeSend?(event, hint)         ← 调用方自定义（可选，串联执行）
+       ├─ Native: RealSentry.init(options)
+       ├─ 独立 Web: RealSentry.init({...options, dsn: FALLBACK_DSN})
+       └─ sandbox Web: 校验版本标记后返回，不重复初始化
 ```
 
 ## Package Exports
 
 | 子路径 | 文件 | 内容 |
 |---|---|---|
-| `.` | `dist/index.js` | `SentryCapture`、`MetroSymbolicator`、全部类型 |
+| `.` | `dist/index.js` | 主入口（当前不导出运行时 API） |
 | `./metro` | `dist/metro.js` | `withDevkit`、`withDevStubs`、`withEntryInjection`、`withPersistentCache`、`withTransformLogger`、`withExpoNotificationsStub`、`withExpoMediaLibraryStub`、`withExpoCalendarStub` 等全部 Metro wrapper |
 | `./babel-plugin-jsx-source` | `dist/babel/plugin-jsx-source.js` | Babel 插件：为 JSX 注入 source 信息 |
 | `./babel-preset` | `dist/babel/preset.js` | Babel Preset：集成 jsx-source 和 lucide 插件 |
@@ -562,13 +481,13 @@ window.postMessage({ type: 'editor-refresh' }, '*')                          //
 `@sentry/react-native` 模块替换 stub，由 `withDevStubs()` 在 Metro 层自动注入。
 
 **功能：**
-- 将用户传入的 DSN 替换为无害的覆盖值（默认 `https://stubPublicKey@o0.ingest.sentry.io/0`）
-- 自动注入内置 SentryCapture，监听并符号化 Sentry 错误事件
-- 串联调用方传入的 `beforeSend` / `beforeBreadcrumb`（内置捕获器先执行）
-- 向父窗口发送 `GLOBAL_ERROR` 事件，携带错误信息
+- Native 原样透传应用的 Sentry init
+- 独立 Web 使用安全 fallback DSN
+- sandbox Web 校验运行时版本标记并阻止重复 init
+- 版本不一致时只向 console 输出诊断信息，不通知编辑器宿主
 
 **环境变量：**
-- `SENTRY_OVERRIDE_DSN`：自定义覆盖 DSN（如指向本地 relay）
+- 应用开发者不需要新增环境变量；`INJECT_SENTRY_DSN` 由 vite-sandbox 启动链路自动处理
 
 ---
 

package/dist/index.d.mts

@@ -1,111 +1,2 @@
-import { ErrorEvent, EventHint, Breadcrumb, BreadcrumbHint } from '@sentry/core';
 
-/**
- * Sentry Capture 模块
- *
- * 提供 Metro 符号化（MetroSymbolicator）和 Sentry 事件捕获（SentryCapture）。
- */
-
-/** Metro /symbolicate 接口的帧格式（请求与响应共用）。 */
-interface MetroFrame {
-    file: string;
-    lineNumber: number;
-    column: number;
-    methodName: string;
-}
-/** SentryCapture.onError 回调参数 */
-interface ErrorCaptureInfo {
-    message: string;
-    symbolicatedFrames: MetroFrame[] | null;
-    componentStack: string | null;
-    /** Sentry Mechanism.type，如 'onerror' / 'generic' / 'auto.function.react.error_boundary' */
-    mechanismType: string | null;
-}
-/** SentryCapture.onNetwork 回调参数 */
-interface NetworkCaptureInfo {
-    method: string | null;
-    url: string | null;
-    statusCode: number | null;
-}
-interface SentryCaptureOptions {
-    onError?: (info: ErrorCaptureInfo) => void;
-    onNetwork?: (info: NetworkCaptureInfo) => void;
-    /** 可注入 mock 实例以在单元测试中隔离网络依赖 */
-    symbolicator?: MetroSymbolicator;
-}
-/**
- * Metro 符号化器。
- * 将 bundle 行列号还原为源码位置（通过 Metro /symbolicate 接口）。
- *
- * @example
- * const sym = new MetroSymbolicator();
- *
- * @example
- * // 单测：注入 baseUrl 并 mock fetch
- * const sym = new MetroSymbolicator({ baseUrl: 'http://localhost:8081' });
- * global.fetch = jest.fn().mockResolvedValue({ ok: true, json: async () => ({ stack: [...] }) });
- */
-declare class MetroSymbolicator {
-    readonly baseUrl: string;
-    constructor({ baseUrl }?: {
-        baseUrl?: string;
-    });
-    /**
-     * 从 NativeModules.SourceCode.scriptURL 推断 Metro server base URL。
-     * web 平台使用相对路径；native 回退到 localhost:8081。
-     */
-    private static _getDefaultBaseUrl;
-    /**
-     * 解析 Error.stack 字符串为 Metro 所需的帧数组。
-     *
-     * 使用 stacktrace-parser 覆盖各 JS 引擎的格式：
-     *   V8/Node.js/Hermes(新)：at methodName (url:line:col)
-     *   Gecko/Firefox/Hermes(旧)：methodName@url:line:col
-     *   JavaScriptCore(iOS)：methodName@url:line:col
-     *
-     * 无法符号化的帧（file 或 lineNumber 为 null）会被过滤掉。
-     */
-    parseErrorStack(stack: string): MetroFrame[];
-    /**
-     * 将帧列表发送到 Metro /symbolicate，返回符号化后的帧数组。
-     */
-    symbolicate(stack: MetroFrame[]): Promise<MetroFrame[] | null>;
-}
-/**
- * Sentry 事件捕获器。
- * 封装 beforeSend / beforeBreadcrumb 逻辑，通过注入的回调将事件数据交给调用方处理。
- *
- * @example
- * const capture = new SentryCapture({
- *   onError(info) { console.log(info.message, info.symbolicatedFrames); },
- *   onNetwork(info) { console.log(info.method, info.url, info.statusCode); },
- * });
- * Sentry.init({ dsn: '...', beforeSend: capture.beforeSend, beforeBreadcrumb: capture.beforeBreadcrumb });
- *
- * @example
- * // 单测：注入 mock symbolicator
- * const mockSym = { parseErrorStack: jest.fn(() => []), symbolicate: jest.fn(async () => null) };
- * const onError = jest.fn();
- * const capture = new SentryCapture({ onError, symbolicator: mockSym });
- * await capture.beforeSend(fakeEvent, { originalException: new Error('oops') });
- * expect(onError).toHaveBeenCalledWith(expect.objectContaining({ message: 'oops' }));
- */
-declare class SentryCapture {
-    private readonly onError;
-    private readonly onNetwork;
-    private readonly symbolicator;
-    constructor({ onError, onNetwork, symbolicator }?: SentryCaptureOptions);
-    /**
-     * Sentry beforeSend hook。
-     * 优先使用原始 Error.stack 进行符号化；若无法获取则回退到 Sentry 事件帧。
-     * 符号化完成后触发 onError 回调，原样返回 event。
-     */
-    beforeSend(event: ErrorEvent, hint: EventHint): Promise<ErrorEvent>;
-    /**
-     * Sentry beforeBreadcrumb hook。
-     * 识别 HTTP 类型的 breadcrumb，触发 onNetwork 回调，原样返回 breadcrumb。
-     */
-    beforeBreadcrumb(breadcrumb: Breadcrumb, _hint?: BreadcrumbHint): Breadcrumb;
-}
-
-export { type ErrorCaptureInfo, type MetroFrame, MetroSymbolicator, type NetworkCaptureInfo, SentryCapture, type SentryCaptureOptions };
+export {  }

package/dist/index.d.ts

@@ -1,111 +1,2 @@
-import { ErrorEvent, EventHint, Breadcrumb, BreadcrumbHint } from '@sentry/core';
 
-/**
- * Sentry Capture 模块
- *
- * 提供 Metro 符号化（MetroSymbolicator）和 Sentry 事件捕获（SentryCapture）。
- */
-
-/** Metro /symbolicate 接口的帧格式（请求与响应共用）。 */
-interface MetroFrame {
-    file: string;
-    lineNumber: number;
-    column: number;
-    methodName: string;
-}
-/** SentryCapture.onError 回调参数 */
-interface ErrorCaptureInfo {
-    message: string;
-    symbolicatedFrames: MetroFrame[] | null;
-    componentStack: string | null;
-    /** Sentry Mechanism.type，如 'onerror' / 'generic' / 'auto.function.react.error_boundary' */
-    mechanismType: string | null;
-}
-/** SentryCapture.onNetwork 回调参数 */
-interface NetworkCaptureInfo {
-    method: string | null;
-    url: string | null;
-    statusCode: number | null;
-}
-interface SentryCaptureOptions {
-    onError?: (info: ErrorCaptureInfo) => void;
-    onNetwork?: (info: NetworkCaptureInfo) => void;
-    /** 可注入 mock 实例以在单元测试中隔离网络依赖 */
-    symbolicator?: MetroSymbolicator;
-}
-/**
- * Metro 符号化器。
- * 将 bundle 行列号还原为源码位置（通过 Metro /symbolicate 接口）。
- *
- * @example
- * const sym = new MetroSymbolicator();
- *
- * @example
- * // 单测：注入 baseUrl 并 mock fetch
- * const sym = new MetroSymbolicator({ baseUrl: 'http://localhost:8081' });
- * global.fetch = jest.fn().mockResolvedValue({ ok: true, json: async () => ({ stack: [...] }) });
- */
-declare class MetroSymbolicator {
-    readonly baseUrl: string;
-    constructor({ baseUrl }?: {
-        baseUrl?: string;
-    });
-    /**
-     * 从 NativeModules.SourceCode.scriptURL 推断 Metro server base URL。
-     * web 平台使用相对路径；native 回退到 localhost:8081。
-     */
-    private static _getDefaultBaseUrl;
-    /**
-     * 解析 Error.stack 字符串为 Metro 所需的帧数组。
-     *
-     * 使用 stacktrace-parser 覆盖各 JS 引擎的格式：
-     *   V8/Node.js/Hermes(新)：at methodName (url:line:col)
-     *   Gecko/Firefox/Hermes(旧)：methodName@url:line:col
-     *   JavaScriptCore(iOS)：methodName@url:line:col
-     *
-     * 无法符号化的帧（file 或 lineNumber 为 null）会被过滤掉。
-     */
-    parseErrorStack(stack: string): MetroFrame[];
-    /**
-     * 将帧列表发送到 Metro /symbolicate，返回符号化后的帧数组。
-     */
-    symbolicate(stack: MetroFrame[]): Promise<MetroFrame[] | null>;
-}
-/**
- * Sentry 事件捕获器。
- * 封装 beforeSend / beforeBreadcrumb 逻辑，通过注入的回调将事件数据交给调用方处理。
- *
- * @example
- * const capture = new SentryCapture({
- *   onError(info) { console.log(info.message, info.symbolicatedFrames); },
- *   onNetwork(info) { console.log(info.method, info.url, info.statusCode); },
- * });
- * Sentry.init({ dsn: '...', beforeSend: capture.beforeSend, beforeBreadcrumb: capture.beforeBreadcrumb });
- *
- * @example
- * // 单测：注入 mock symbolicator
- * const mockSym = { parseErrorStack: jest.fn(() => []), symbolicate: jest.fn(async () => null) };
- * const onError = jest.fn();
- * const capture = new SentryCapture({ onError, symbolicator: mockSym });
- * await capture.beforeSend(fakeEvent, { originalException: new Error('oops') });
- * expect(onError).toHaveBeenCalledWith(expect.objectContaining({ message: 'oops' }));
- */
-declare class SentryCapture {
-    private readonly onError;
-    private readonly onNetwork;
-    private readonly symbolicator;
-    constructor({ onError, onNetwork, symbolicator }?: SentryCaptureOptions);
-    /**
-     * Sentry beforeSend hook。
-     * 优先使用原始 Error.stack 进行符号化；若无法获取则回退到 Sentry 事件帧。
-     * 符号化完成后触发 onError 回调，原样返回 event。
-     */
-    beforeSend(event: ErrorEvent, hint: EventHint): Promise<ErrorEvent>;
-    /**
-     * Sentry beforeBreadcrumb hook。
-     * 识别 HTTP 类型的 breadcrumb，触发 onNetwork 回调，原样返回 breadcrumb。
-     */
-    beforeBreadcrumb(breadcrumb: Breadcrumb, _hint?: BreadcrumbHint): Breadcrumb;
-}
-
-export { type ErrorCaptureInfo, type MetroFrame, MetroSymbolicator, type NetworkCaptureInfo, SentryCapture, type SentryCaptureOptions };
+export {  }

package/dist/index.js

@@ -1,161 +1,2 @@
 "use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var src_exports = {};
-__export(src_exports, {
-  MetroSymbolicator: () => MetroSymbolicator,
-  SentryCapture: () => SentryCapture
-});
-module.exports = __toCommonJS(src_exports);
-
-// src/capture.ts
-var import_stacktrace_parser = require("stacktrace-parser");
-var import_react_native = require("react-native");
-var MetroSymbolicator = class _MetroSymbolicator {
-  constructor({ baseUrl } = {}) {
-    this.baseUrl = baseUrl ?? _MetroSymbolicator._getDefaultBaseUrl();
-  }
-  /**
-   * 从 NativeModules.SourceCode.scriptURL 推断 Metro server base URL。
-   * web 平台使用相对路径；native 回退到 localhost:8081。
-   */
-  static _getDefaultBaseUrl() {
-    try {
-      const scriptURL = import_react_native.NativeModules?.SourceCode?.scriptURL;
-      if (scriptURL) {
-        const url = new URL(scriptURL);
-        return `${url.protocol}//${url.host}`;
-      }
-    } catch (_) {
-    }
-    return import_react_native.Platform.OS === "web" ? "" : "http://localhost:8081";
-  }
-  /**
-   * 解析 Error.stack 字符串为 Metro 所需的帧数组。
-   *
-   * 使用 stacktrace-parser 覆盖各 JS 引擎的格式：
-   *   V8/Node.js/Hermes(新)：at methodName (url:line:col)
-   *   Gecko/Firefox/Hermes(旧)：methodName@url:line:col
-   *   JavaScriptCore(iOS)：methodName@url:line:col
-   *
-   * 无法符号化的帧（file 或 lineNumber 为 null）会被过滤掉。
-   */
-  parseErrorStack(stack) {
-    return (0, import_stacktrace_parser.parse)(stack).filter(
-      (f) => f.file != null && f.lineNumber != null
-    ).map((f) => ({
-      file: f.file,
-      lineNumber: f.lineNumber,
-      column: f.column != null ? f.column - 1 : 0,
-      methodName: f.methodName === "<unknown>" ? "(anonymous)" : f.methodName
-    }));
-  }
-  /**
-   * 将帧列表发送到 Metro /symbolicate，返回符号化后的帧数组。
-   */
-  async symbolicate(stack) {
-    if (stack.length === 0) return null;
-    const endpoint = `${this.baseUrl}/symbolicate`;
-    try {
-      const res = await fetch(endpoint, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ stack })
-      });
-      if (!res.ok) {
-        console.warn(`[SentryCapture] /symbolicate returned ${res.status}`);
-        return null;
-      }
-      const data = await res.json();
-      return data.stack ?? null;
-    } catch (e) {
-      console.warn("[SentryCapture] symbolication failed:", e?.message ?? e);
-      return null;
-    }
-  }
-};
-var SentryCapture = class {
-  constructor({ onError, onNetwork, symbolicator } = {}) {
-    this.onError = onError;
-    this.onNetwork = onNetwork;
-    this.symbolicator = symbolicator ?? new MetroSymbolicator();
-    this.beforeSend = this.beforeSend.bind(this);
-    this.beforeBreadcrumb = this.beforeBreadcrumb.bind(this);
-  }
-  /**
-   * Sentry beforeSend hook。
-   * 优先使用原始 Error.stack 进行符号化；若无法获取则回退到 Sentry 事件帧。
-   * 符号化完成后触发 onError 回调，原样返回 event。
-   */
-  async beforeSend(event, hint) {
-    globalThis.__SENTRY_LAST_RAW__ = { event, hint };
-    const message = event.exception?.values?.[0]?.value ?? event.message ?? "(unknown)";
-    let symbolicatedFrames = null;
-    const originalException = hint?.originalException;
-    const rawStack = originalException instanceof Error && typeof originalException.stack === "string" ? originalException.stack : null;
-    if (rawStack !== null) {
-      const frames = this.symbolicator.parseErrorStack(rawStack);
-      if (frames.length > 0) {
-        symbolicatedFrames = await this.symbolicator.symbolicate(frames);
-      }
-    }
-    if (symbolicatedFrames === null) {
-      const sentryFrames = event.exception?.values?.[0]?.stacktrace?.frames ?? [];
-      const mapped = sentryFrames.filter(
-        (f) => f.filename != null && f.lineno != null
-      ).map(
-        (f) => ({
-          file: f.filename,
-          lineNumber: f.lineno,
-          column: f.colno ?? 0,
-          methodName: f.function ?? "(anonymous)"
-        })
-      );
-      if (mapped.length > 0) {
-        symbolicatedFrames = await this.symbolicator.symbolicate(mapped);
-      }
-    }
-    const componentStack = event.contexts?.react?.componentStack ?? null;
-    const mechanismType = event.exception?.values?.[0]?.mechanism?.type ?? null;
-    this.onError?.({ message, symbolicatedFrames, componentStack, mechanismType });
-    return event;
-  }
-  /**
-   * Sentry beforeBreadcrumb hook。
-   * 识别 HTTP 类型的 breadcrumb，触发 onNetwork 回调，原样返回 breadcrumb。
-   */
-  beforeBreadcrumb(breadcrumb, _hint) {
-    if (breadcrumb.type === "http") {
-      const data = breadcrumb.data;
-      this.onNetwork?.({
-        method: data?.method ?? null,
-        url: data?.url ?? null,
-        statusCode: data?.status_code ?? null
-      });
-    }
-    return breadcrumb;
-  }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  MetroSymbolicator,
-  SentryCapture
-});
 //# sourceMappingURL=index.js.map

package/dist/index.mjs

@@ -1,133 +1 @@
-// src/capture.ts
-import { parse as parseStackTrace } from "stacktrace-parser";
-import { NativeModules, Platform } from "react-native";
-var MetroSymbolicator = class _MetroSymbolicator {
-  constructor({ baseUrl } = {}) {
-    this.baseUrl = baseUrl ?? _MetroSymbolicator._getDefaultBaseUrl();
-  }
-  /**
-   * 从 NativeModules.SourceCode.scriptURL 推断 Metro server base URL。
-   * web 平台使用相对路径；native 回退到 localhost:8081。
-   */
-  static _getDefaultBaseUrl() {
-    try {
-      const scriptURL = NativeModules?.SourceCode?.scriptURL;
-      if (scriptURL) {
-        const url = new URL(scriptURL);
-        return `${url.protocol}//${url.host}`;
-      }
-    } catch (_) {
-    }
-    return Platform.OS === "web" ? "" : "http://localhost:8081";
-  }
-  /**
-   * 解析 Error.stack 字符串为 Metro 所需的帧数组。
-   *
-   * 使用 stacktrace-parser 覆盖各 JS 引擎的格式：
-   *   V8/Node.js/Hermes(新)：at methodName (url:line:col)
-   *   Gecko/Firefox/Hermes(旧)：methodName@url:line:col
-   *   JavaScriptCore(iOS)：methodName@url:line:col
-   *
-   * 无法符号化的帧（file 或 lineNumber 为 null）会被过滤掉。
-   */
-  parseErrorStack(stack) {
-    return parseStackTrace(stack).filter(
-      (f) => f.file != null && f.lineNumber != null
-    ).map((f) => ({
-      file: f.file,
-      lineNumber: f.lineNumber,
-      column: f.column != null ? f.column - 1 : 0,
-      methodName: f.methodName === "<unknown>" ? "(anonymous)" : f.methodName
-    }));
-  }
-  /**
-   * 将帧列表发送到 Metro /symbolicate，返回符号化后的帧数组。
-   */
-  async symbolicate(stack) {
-    if (stack.length === 0) return null;
-    const endpoint = `${this.baseUrl}/symbolicate`;
-    try {
-      const res = await fetch(endpoint, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ stack })
-      });
-      if (!res.ok) {
-        console.warn(`[SentryCapture] /symbolicate returned ${res.status}`);
-        return null;
-      }
-      const data = await res.json();
-      return data.stack ?? null;
-    } catch (e) {
-      console.warn("[SentryCapture] symbolication failed:", e?.message ?? e);
-      return null;
-    }
-  }
-};
-var SentryCapture = class {
-  constructor({ onError, onNetwork, symbolicator } = {}) {
-    this.onError = onError;
-    this.onNetwork = onNetwork;
-    this.symbolicator = symbolicator ?? new MetroSymbolicator();
-    this.beforeSend = this.beforeSend.bind(this);
-    this.beforeBreadcrumb = this.beforeBreadcrumb.bind(this);
-  }
-  /**
-   * Sentry beforeSend hook。
-   * 优先使用原始 Error.stack 进行符号化；若无法获取则回退到 Sentry 事件帧。
-   * 符号化完成后触发 onError 回调，原样返回 event。
-   */
-  async beforeSend(event, hint) {
-    globalThis.__SENTRY_LAST_RAW__ = { event, hint };
-    const message = event.exception?.values?.[0]?.value ?? event.message ?? "(unknown)";
-    let symbolicatedFrames = null;
-    const originalException = hint?.originalException;
-    const rawStack = originalException instanceof Error && typeof originalException.stack === "string" ? originalException.stack : null;
-    if (rawStack !== null) {
-      const frames = this.symbolicator.parseErrorStack(rawStack);
-      if (frames.length > 0) {
-        symbolicatedFrames = await this.symbolicator.symbolicate(frames);
-      }
-    }
-    if (symbolicatedFrames === null) {
-      const sentryFrames = event.exception?.values?.[0]?.stacktrace?.frames ?? [];
-      const mapped = sentryFrames.filter(
-        (f) => f.filename != null && f.lineno != null
-      ).map(
-        (f) => ({
-          file: f.filename,
-          lineNumber: f.lineno,
-          column: f.colno ?? 0,
-          methodName: f.function ?? "(anonymous)"
-        })
-      );
-      if (mapped.length > 0) {
-        symbolicatedFrames = await this.symbolicator.symbolicate(mapped);
-      }
-    }
-    const componentStack = event.contexts?.react?.componentStack ?? null;
-    const mechanismType = event.exception?.values?.[0]?.mechanism?.type ?? null;
-    this.onError?.({ message, symbolicatedFrames, componentStack, mechanismType });
-    return event;
-  }
-  /**
-   * Sentry beforeBreadcrumb hook。
-   * 识别 HTTP 类型的 breadcrumb，触发 onNetwork 回调，原样返回 breadcrumb。
-   */
-  beforeBreadcrumb(breadcrumb, _hint) {
-    if (breadcrumb.type === "http") {
-      const data = breadcrumb.data;
-      this.onNetwork?.({
-        method: data?.method ?? null,
-        url: data?.url ?? null,
-        statusCode: data?.status_code ?? null
-      });
-    }
-    return breadcrumb;
-  }
-};
-export {
-  MetroSymbolicator,
-  SentryCapture
-};
 //# sourceMappingURL=index.mjs.map

package/dist/stubs/entry-inject.js

@@ -4,12 +4,10 @@ var import_lgui_control = require("./lgui-control");
 var import_css_control = require("./css-control");
 var import_router_control = require("./router-control");
 var import_screenshot_control = require("./screenshot-control");
-var import_preview_control = require("./preview-control");
 globalThis.__DEVKIT_INJECTED__ = true;
 (0, import_hmr_control.setupHMRMessageControl)();
 (0, import_lgui_control.setupLGUIMessageControl)();
 (0, import_css_control.setupCSSInjectionControl)();
 (0, import_router_control.setupRouterControl)();
 (0, import_screenshot_control.setupScreenshotControl)();
-(0, import_preview_control.setupPreviewControl)();
 //# sourceMappingURL=entry-inject.js.map

package/dist/stubs/sentry-react-native-stub.js

@@ -24,193 +24,28 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 // src/stubs/sentry-react-native-stub.ts
 var RealSentry = __toESM(require("@sentry/react-native"));
-
-// src/capture.ts
-var import_stacktrace_parser = require("stacktrace-parser");
+var import_core = require("@sentry/core");
 var import_react_native = require("react-native");
-var MetroSymbolicator = class _MetroSymbolicator {
-  constructor({ baseUrl } = {}) {
-    this.baseUrl = baseUrl ?? _MetroSymbolicator._getDefaultBaseUrl();
-  }
-  /**
-   * 从 NativeModules.SourceCode.scriptURL 推断 Metro server base URL。
-   * web 平台使用相对路径；native 回退到 localhost:8081。
-   */
-  static _getDefaultBaseUrl() {
-    try {
-      const scriptURL = import_react_native.NativeModules?.SourceCode?.scriptURL;
-      if (scriptURL) {
-        const url = new URL(scriptURL);
-        return `${url.protocol}//${url.host}`;
-      }
-    } catch (_) {
-    }
-    return import_react_native.Platform.OS === "web" ? "" : "http://localhost:8081";
-  }
-  /**
-   * 解析 Error.stack 字符串为 Metro 所需的帧数组。
-   *
-   * 使用 stacktrace-parser 覆盖各 JS 引擎的格式：
-   *   V8/Node.js/Hermes(新)：at methodName (url:line:col)
-   *   Gecko/Firefox/Hermes(旧)：methodName@url:line:col
-   *   JavaScriptCore(iOS)：methodName@url:line:col
-   *
-   * 无法符号化的帧（file 或 lineNumber 为 null）会被过滤掉。
-   */
-  parseErrorStack(stack) {
-    return (0, import_stacktrace_parser.parse)(stack).filter(
-      (f) => f.file != null && f.lineNumber != null
-    ).map((f) => ({
-      file: f.file,
-      lineNumber: f.lineNumber,
-      column: f.column != null ? f.column - 1 : 0,
-      methodName: f.methodName === "<unknown>" ? "(anonymous)" : f.methodName
-    }));
-  }
-  /**
-   * 将帧列表发送到 Metro /symbolicate，返回符号化后的帧数组。
-   */
-  async symbolicate(stack) {
-    if (stack.length === 0) return null;
-    const endpoint = `${this.baseUrl}/symbolicate`;
-    try {
-      const res = await fetch(endpoint, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ stack })
-      });
-      if (!res.ok) {
-        console.warn(`[SentryCapture] /symbolicate returned ${res.status}`);
-        return null;
-      }
-      const data = await res.json();
-      return data.stack ?? null;
-    } catch (e) {
-      console.warn("[SentryCapture] symbolication failed:", e?.message ?? e);
-      return null;
-    }
-  }
-};
-var SentryCapture = class {
-  constructor({ onError, onNetwork, symbolicator } = {}) {
-    this.onError = onError;
-    this.onNetwork = onNetwork;
-    this.symbolicator = symbolicator ?? new MetroSymbolicator();
-    this.beforeSend = this.beforeSend.bind(this);
-    this.beforeBreadcrumb = this.beforeBreadcrumb.bind(this);
-  }
-  /**
-   * Sentry beforeSend hook。
-   * 优先使用原始 Error.stack 进行符号化；若无法获取则回退到 Sentry 事件帧。
-   * 符号化完成后触发 onError 回调，原样返回 event。
-   */
-  async beforeSend(event, hint) {
-    globalThis.__SENTRY_LAST_RAW__ = { event, hint };
-    const message = event.exception?.values?.[0]?.value ?? event.message ?? "(unknown)";
-    let symbolicatedFrames = null;
-    const originalException = hint?.originalException;
-    const rawStack = originalException instanceof Error && typeof originalException.stack === "string" ? originalException.stack : null;
-    if (rawStack !== null) {
-      const frames = this.symbolicator.parseErrorStack(rawStack);
-      if (frames.length > 0) {
-        symbolicatedFrames = await this.symbolicator.symbolicate(frames);
-      }
-    }
-    if (symbolicatedFrames === null) {
-      const sentryFrames = event.exception?.values?.[0]?.stacktrace?.frames ?? [];
-      const mapped = sentryFrames.filter(
-        (f) => f.filename != null && f.lineno != null
-      ).map(
-        (f) => ({
-          file: f.filename,
-          lineNumber: f.lineno,
-          column: f.colno ?? 0,
-          methodName: f.function ?? "(anonymous)"
-        })
-      );
-      if (mapped.length > 0) {
-        symbolicatedFrames = await this.symbolicator.symbolicate(mapped);
-      }
-    }
-    const componentStack = event.contexts?.react?.componentStack ?? null;
-    const mechanismType = event.exception?.values?.[0]?.mechanism?.type ?? null;
-    this.onError?.({ message, symbolicatedFrames, componentStack, mechanismType });
-    return event;
-  }
-  /**
-   * Sentry beforeBreadcrumb hook。
-   * 识别 HTTP 类型的 breadcrumb，触发 onNetwork 回调，原样返回 breadcrumb。
-   */
-  beforeBreadcrumb(breadcrumb, _hint) {
-    if (breadcrumb.type === "http") {
-      const data = breadcrumb.data;
-      this.onNetwork?.({
-        method: data?.method ?? null,
-        url: data?.url ?? null,
-        statusCode: data?.status_code ?? null
-      });
-    }
-    return breadcrumb;
-  }
-};
-
-// src/stubs/sentry-react-native-stub.ts
-function getParentOrigin() {
-  try {
-    const w = globalThis.window;
-    if (!w) return "*";
-    return new URLSearchParams(w.location.search).get("parentOrigin") || "*";
-  } catch {
-    return "*";
-  }
+var SANDBOX_MARKER = /* @__PURE__ */ Symbol.for("vite-sandbox.expo-browser-observability.v2");
+var FALLBACK_DSN = process.env["INJECT_SENTRY_DSN"] ?? "https://stubPublicKey@o0.ingest.sentry.io/0";
+function reportVersionMismatch(expected, actual) {
+  const message = `Sentry SDK \u7248\u672C\u4E0D\u4E00\u81F4\uFF1Asandbox=${expected}\uFF0C@sentry/react-native core=${actual || "unknown"}\u3002\u89C2\u6D4B\u4E8B\u4EF6\u53EF\u80FD\u9759\u9ED8\u4E22\u5931\u3002`;
+  console.error(`[miaoda-expo-devkit] ${message}`);
 }
-var OVERRIDE_DSN = process.env["INJECT_SENTRY_DSN"] ?? "https://stubPublicKey@o0.ingest.sentry.io/0";
-var _capture = new SentryCapture({
-  onError(info) {
-    console.warn("[SentryStub] \u6355\u83B7\u5230\u9519\u8BEF\uFF1A", info.message);
-    if (info.symbolicatedFrames?.length) {
-      const top = info.symbolicatedFrames[0];
-      console.warn(`  at ${top.methodName} (${top.file}:${top.lineNumber}:${top.column})`);
-    }
-    const w = globalThis.window;
-    if (w !== void 0 && w !== w.parent) {
-      w.parent.postMessage(
-        {
-          type: "GLOBAL_ERROR",
-          error: {
-            message: info.message,
-            symbolicatedFrames: info.symbolicatedFrames,
-            componentStack: info.componentStack,
-            mechanismType: info.mechanismType
-          }
-        },
-        getParentOrigin()
-      );
-    }
-  }
-});
 var stub = {
   ...RealSentry,
   /**
-   * 拦截 init()：替换 DSN 并注入内置捕获器。
-   * 调用方传入的 beforeSend / beforeBreadcrumb 在内置捕获器之后串联执行。
+   * Native 保留应用初始化；独立 Web 使用安全 DSN；sandbox Web 已由前置运行时
+   * 初始化，因此这里只校验版本并阻止第二次初始化。
    */
   init: ((options) => {
-    const upstreamBeforeSend = options?.beforeSend;
-    const upstreamBeforeBreadcrumb = options?.beforeBreadcrumb;
-    const initOptions = {
-      ...options,
-      dsn: OVERRIDE_DSN,
-      async beforeSend(event, hint) {
-        const processed = await _capture.beforeSend(event, hint);
-        return upstreamBeforeSend ? await upstreamBeforeSend(processed, hint) : processed;
-      },
-      beforeBreadcrumb(breadcrumb, hint) {
-        const processed = _capture.beforeBreadcrumb(breadcrumb, hint);
-        return upstreamBeforeBreadcrumb ? upstreamBeforeBreadcrumb(processed, hint) : processed;
-      }
-    };
-    return RealSentry.init(initOptions);
+    if (import_react_native.Platform.OS !== "web") return RealSentry.init(options);
+    const sandboxVersion = globalThis[SANDBOX_MARKER];
+    if (typeof sandboxVersion === "string") {
+      if (sandboxVersion !== import_core.SDK_VERSION) reportVersionMismatch(sandboxVersion, import_core.SDK_VERSION);
+      return void 0;
+    }
+    return RealSentry.init({ ...options, dsn: FALLBACK_DSN });
   })
 };
 module.exports = stub;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "miaoda-expo-devkit",
-  "version": "0.1.1-beta.112",
+  "version": "0.1.1-beta.114",
   "description": "Expo 应用开发工具集：Sentry DSN 替换 stub、错误/网络捕获、Metro 符号化",
   "license": "MIT",
   "main": "./dist/index.js",
@@ -90,8 +90,7 @@
     "lodash.throttle": "^4.1.1",
     "metro-minify-esbuild": "^0.2.0",
     "oxc-resolver": "^11.19.1",
-    "package-up": "^5.0.0",
-    "stacktrace-parser": "^0.1.11"
+    "package-up": "^5.0.0"
   },
   "peerDependencies": {
     "@expo/config-plugins": ">=55.0.0",

package/pnpm-patches/@expo__cli@55.0.16-55.0.22.patch

@@ -279,7 +279,7 @@ new file mode 100644
 +                const errorBuildID = isHmrError ? activeBuildID : buildID ?? lastFailedBuildID ?? activeBuildID;
 +                if (!isCurrentBuild(errorBuildID, true)) return;
 +                if (isHmrError) {
-+                    // HMR 错误不携带 Metro build ID，保留变更标识以匹配后续恢复事件。
++                    // HMR errors do not carry Metro build IDs; keep the change token for its recovery event.
 +                    activeHmrChangeID = event.changeID ?? activeHmrChangeID;
 +                }
 +                lastFailedBuildID = errorBuildID;

package/dist/stubs/preview-control.js

@@ -1,60 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var preview_control_exports = {};
-__export(preview_control_exports, {
-  setupPreviewControl: () => setupPreviewControl
-});
-module.exports = __toCommonJS(preview_control_exports);
-function getParentOrigin() {
-  try {
-    const w = globalThis.window;
-    if (!w) return "*";
-    return new URLSearchParams(w.location.search).get("parentOrigin") || "*";
-  } catch {
-    return "*";
-  }
-}
-function postPreviewSuccess() {
-  const w = globalThis.window;
-  if (!w || w.editorPreviewSuccessPosted) {
-    return;
-  }
-  w.editorPreviewSuccessPosted = true;
-  w.parent.postMessage(
-    {
-      type: "editor-preview-success"
-    },
-    getParentOrigin()
-  );
-}
-function setupPreviewControl() {
-  if (typeof document === "undefined" || typeof window === "undefined") {
-    return;
-  }
-  if (document.readyState === "complete") {
-    postPreviewSuccess();
-    return;
-  }
-  window.addEventListener("load", postPreviewSuccess, { once: true });
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  setupPreviewControl
-});
-//# sourceMappingURL=preview-control.js.map