@arms/rum-reactnative 0.1.3-beta.5 → 0.1.4-beta.1

package/lib/module/utils/view.js

@@ -1,88 +1 @@
-"use strict";
-
-import { isFunction
-// IRumSession,
-// IViewData
-} from '@arms/rum-core';
-// import { IPage } from "../types/client";
-
-// export const PAGE_ID = '__rum_view_id';
-//
-// /**
-//  * 获取 RUM 内置的view_id标识
-//  * @param page
-//  * @param session
-//  * @returns
-//  */
-// export async function getRumViewId(page: IPage, session?: IRumSession): Promise<string> {
-//   if (!page) return;
-//   if (page.id) {
-//     return page.id;
-//   }
-//   if (!session) return;
-//   return page.id = session.getViewId();
-// }
-//
-// /**
-//  * 获取当前 view
-//  * @param viewId
-//  * @param ctx
-//  * @returns
-//  */
-// export function getViewById(viewId: string, ctx: IContext): IViewData {
-//   if (!viewId || !ctx) return;
-//   return ctx.getViews().find(view => view.id === viewId);
-// }
-
-/**
- * 获取当前 view
- * @param ctx
- * @returns
- */
-export function getCurView(ctx) {
-  if (!ctx) return;
-  const views = ctx.getViews();
-  if (views && views.length) {
-    return views[views.length - 1];
-  }
-  return null;
-}
-let currentNavigationRef;
-const navigateListeners = [];
-export function addNavigateListener(listener) {
-  if (isFunction(listener)) {
-    navigateListeners.push(listener);
-  }
-}
-export function removeNavigateListener(listener) {
-  navigateListeners.splice(navigateListeners.indexOf(listener), 1);
-}
-function triggerNavigateChange(event) {
-  if (!currentNavigationRef) return;
-  let route = event;
-  if (isFunction(currentNavigationRef.getCurrentRoute)) {
-    route = currentNavigationRef.getCurrentRoute();
-  }
-  if (!route) return;
-  navigateListeners.forEach(listener => {
-    listener(route);
-  });
-}
-export function startTrackingViews(nav) {
-  if (!nav || currentNavigationRef) return;
-  currentNavigationRef = nav;
-  if (isFunction(nav.events)) {
-    // react-native-navigation
-    nav.events().registerComponentDidAppearListener(triggerNavigateChange);
-  } else {
-    // @react-native/navigation
-    nav.addListener('state', triggerNavigateChange);
-  }
-  triggerNavigateChange({});
-}
-export function stopTrackingViews() {
-  if (!currentNavigationRef) return;
-  currentNavigationRef.removeListener('state', triggerNavigateChange);
-  currentNavigationRef = undefined;
-}
-//# sourceMappingURL=view.js.map
+"use strict";import{isFunction}from"@arms/rum-core";export function getCurView(e){if(!e)return;const t=e.getViews();return t&&t.length?t[t.length-1]:null}let currentNavigationRef;const navigateListeners=[];export function addNavigateListener(e){isFunction(e)&&navigateListeners.push(e)}export function removeNavigateListener(e){navigateListeners.splice(navigateListeners.indexOf(e),1)}function triggerNavigateChange(e){if(!currentNavigationRef)return;let t=e;isFunction(currentNavigationRef.getCurrentRoute)&&(t=currentNavigationRef.getCurrentRoute()),t&&navigateListeners.forEach(e=>{e(t)})}export function startTrackingViews(e){e&&!currentNavigationRef&&(currentNavigationRef=e,isFunction(e.events)?e.events().registerComponentDidAppearListener(triggerNavigateChange):e.addListener("state",triggerNavigateChange),triggerNavigateChange({}))}export function stopTrackingViews(){currentNavigationRef&&(currentNavigationRef.removeListener("state",triggerNavigateChange),currentNavigationRef=void 0)}

package/lib/typescript/commonjs/src/NativeRumSdkReactnative.d.ts

@@ -43,6 +43,16 @@ export interface Spec extends TurboModule {
     updateCrashContext(context: string): void;
     /** 触发测试崩溃（仅用于开发调试，调用后 App 立即崩溃） */
     triggerTestCrash(crashType: string): void;
+    /** 获取待上报的 OOM 报告列表（下次启动时调用），JSON 字符串 */
+    getPendingOomReports(): Promise<string>;
+    /** 清除已上报的 OOM 报告文件 */
+    clearOomReports(oomIds: string): Promise<void>;
+    /**
+     * 同步 JS 侧采集器配置到原生（SDK init 时调用），config 为 JSON 字符串。
+     * 当前支持的键：`oom`（boolean，是否开启 OOM 采集，false/缺省不启用）。
+     * 原生侧据此安装状态记录器并执行上次启动的看门狗终止判定。
+     */
+    updateCollectorsConfig(config: string): void;
 }
 declare const _default: Spec;
 export default _default;

package/lib/typescript/commonjs/src/collector/exception/oom.d.ts

@@ -0,0 +1,34 @@
+import type { ICollector, IContext, SendEventFn } from '@arms/rum-core';
+/**
+ * OOM（iOS 看门狗终止推断）采集器（Exception 的子类型）：
+ * 1. 初始化时将 oom 开关同步到原生（原生侧据此安装状态记录器并执行
+ *    上次启动的看门狗终止判定）；
+ * 2. 读取上次运行写入的原生 OOM 事件文件，转换为 RumEvent（type='crash' +
+ *    subtype='oom'）通过标准管线上报（每次启动最多 1 条，直接 immediate）；
+ * 3. 复用崩溃 Ack 管线：上报成功后回 ack 删除对应文件，失败保留重试。
+ *
+ * 与 CrashCollector 的关系（D7，采集器配置相互独立、不级联）：
+ * - 本采集器不检查 collectors.crash，crash 关闭时 OOM 仍独立工作；
+ * - 双报防护由原生判定层互斥承担（存在待处理崩溃证据则不产生 OOM 文件）；
+ * - context 同步与 CrashCollector 各自订阅同一事件，原生侧幂等写入无副作用
+ *   （crash 单独关闭而 OOM 开启时 context 同步仍可用）。
+ */
+export default class OomCollector implements ICollector {
+    name: string;
+    private ctx?;
+    private sendEvent?;
+    private initialized;
+    /** 已上报待确认（ack）的 oom_id，成功后才删文件 */
+    private pendingAckIds;
+    setup(ctx: IContext, sendEvent: SendEventFn): void;
+    private processPendingOomReports;
+    private onCrashContextChange;
+    /**
+     * reporter 上报确认回调（复用崩溃 Ack 事件，按 oom_id 归属）：
+     * - 成功：删除对应 oom_id 的 OOM 文件（确保上报成功后才删，不丢数据）；
+     * - 失败：保留文件，下次启动重试，仅从内存待确认集合中移除。
+     */
+    private onCrashReportAck;
+    destroy(): void;
+}
+//# sourceMappingURL=oom.d.ts.map

package/lib/typescript/commonjs/src/collector/index.d.ts

@@ -1,6 +1,7 @@
 export { default as PvCollector } from './view/pv';
 export { default as ExceptionCollector } from './exception/index';
 export { default as CrashCollector } from './exception/crash';
+export { default as OomCollector } from './exception/oom';
 export { default as ApiCollector } from './resource/api';
 export { default as ActionCollector } from './action/index';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/src/shell.d.ts

@@ -2,7 +2,7 @@ import { Shell } from '@arms/rum-core';
 import * as collectors from './collector';
 import { IRNConfig } from './types/client';
 import { NavigationContainerRef } from './types';
-declare const builtInCollectors: readonly (typeof collectors.PvCollector | typeof collectors.ExceptionCollector | typeof collectors.CrashCollector | typeof collectors.ApiCollector | typeof collectors.ActionCollector)[];
+declare const builtInCollectors: readonly (typeof collectors.PvCollector | typeof collectors.ExceptionCollector | typeof collectors.CrashCollector | typeof collectors.OomCollector | typeof collectors.ApiCollector | typeof collectors.ActionCollector)[];
 type CollectorName = (typeof builtInCollectors)[number]['prototype']['name'];
 type CollectorMap = {
     [K in CollectorName]: InstanceType<Extract<(typeof builtInCollectors)[number], {

package/lib/typescript/commonjs/src/types/client.d.ts

@@ -23,5 +23,32 @@ export interface IRNConfig extends IConfiguration {
      * request 自定义解析;
      */
     evaluateApi?(request: any, response: any, error?: Error, xhr?: XMLHttpRequest): Promise<IApiBaseAttr>;
+    /**
+     * 采集器配置。
+     *
+     * 以交叉类型扩展父类型的 index signature，补充各采集器开关的 JSDoc
+     * 默认值说明（对齐 rum-electron 配置类型风格，与配置参考文档双保险
+     * 防默认值漂移）。
+     */
+    collectors?: IConfiguration['collectors'] & {
+        /**
+         * OOM（iOS 看门狗终止推断）采集开关。
+         *
+         * 默认 false，需显式开启（`oom: true`），缺省或 false 均不启用；
+         * 开关方向与 crash 采集器相反（crash 默认开启，`crash === false` 才关闭）。
+         *
+         * 能力范围：仅 iOS 前台看门狗终止的事后推断（无堆栈，timestamp 为
+         * 估算值，`snapshots.estimated: true` 标记推断性质）；Android 无此
+         * 能力（Java OutOfMemoryError 已由崩溃链路捕获）。
+         *
+         * 建议与 `crash` 同时开启；crash 关闭时 KSCrash 崩溃报告只写不删，
+         * 残留报告会使 OOM 判定倾向被抑制（漏判方向保守），而非误报增多。
+         *
+         * 未来若出现子开关需求（内存警告、前后台区分等），本字段计划演进为
+         * `boolean | object` 双形态（参照 rum-electron checkEnable 四态归一），
+         * 本期维持单一 boolean。
+         */
+        oom?: boolean;
+    };
 }
 //# sourceMappingURL=client.d.ts.map

package/lib/typescript/commonjs/src/types/oom.d.ts

@@ -0,0 +1,58 @@
+/**
+ * OOM（iOS 看门狗终止推断）相关类型定义。
+ *
+ * 对应 iOS 原生侧落盘的 oom_{timestamp}_{uuid}.json 事件文件结构
+ * （getPendingOomReports 返回数组的元素），见
+ * dev-docs/OOM采集调研与实施方案.md 4.2.3 节。
+ */
+/** OOM 事件的上次会话上下文（原生从 context.json 恢复） */
+export interface OomContext {
+    session_id?: string;
+    view_id?: string;
+    view_name?: string;
+    user_id?: string;
+}
+/** 上次会话的 App 状态快照（原生 RumAppStateRecorder 状态变更时写入） */
+export interface OomAppState {
+    appVersion?: string;
+    osVersion?: string;
+    /** 系统启动时刻（ISO8601），用于排除设备重启 */
+    systemBootTime?: string;
+    vendorId?: string;
+    /** 上次进程是否前台激活（仅前台被杀才判定，D5） */
+    isActive?: boolean;
+    /** 是否收到正常终止回调（用户强杀排除） */
+    wasTerminated?: boolean;
+    /** 上次是否处于调试态（调试期被杀排除） */
+    isDebugging?: boolean;
+    /** 状态快照写入时刻（ms），供 context 新鲜度评估 */
+    updatedAt?: number;
+}
+/**
+ * 原生 OOM 数据结构（与 iOS 原生侧落盘的 JSON 对齐）。
+ * 仅声明 JS 层会用到的字段。
+ */
+export interface NativeOomData {
+    /**
+     * OOM 事件唯一标识（UUID），承担与 crash_id 等价的 Ack 标识角色。
+     * 防御性声明为可选：缺失时事件仍可上报，仅无法走 ack 删文件链路。
+     */
+    oom_id?: string;
+    /** 估算的案发时刻（ms，取上次会话最后写入的持久化文件 mtime） */
+    timestamp?: number;
+    platform?: string;
+    subtype?: string;
+    /** 事件名，PascalCase（如 WatchdogTermination） */
+    name?: string;
+    /** 英文证据式表述（D8），推断性质由 snapshots.estimated 承载 */
+    message?: string;
+    /** 崩溃机制信息（如 { type: 'watchdog_termination', handled: false }） */
+    mechanism?: Record<string, unknown>;
+    /** 上次会话的 App 状态快照 */
+    app_state?: OomAppState;
+    /** 上次会话上下文（session/view/user 关联依据） */
+    context?: OomContext;
+    app?: Record<string, unknown>;
+    device?: Record<string, unknown>;
+}
+//# sourceMappingURL=oom.d.ts.map

package/lib/typescript/commonjs/src/utils/crash.d.ts

@@ -1,10 +1,23 @@
 import { type RumEvent } from '@arms/rum-core';
 import type { NativeCrashData } from '../types/crash';
+import type { NativeOomData } from '../types/oom';
 /**
  * 将原生崩溃数据转换为 RumEvent 异常事件，对齐存储模型 Exception 表的
  * Attributes（session/view/exception 基础信息）+ Metadata（堆栈、快照等）字段。
  */
 export declare function convertCrashToRumEvent(crashData: NativeCrashData): RumEvent;
+/**
+ * 将原生 OOM（看门狗终止推断）数据转换为 RumEvent 异常事件，
+ * 对齐存储模型 Exception 表。
+ *
+ * 与崩溃事件的差异：
+ * - type='crash' + subtype='oom' 复用现有 exception 链路，不新增 type 枚举（D4）；
+ * - 无堆栈（watchdog 终止无信号可捕获，无现场数据）；
+ * - timestamp 为估算值（snapshots.estimated: true 结构化标记推断性质，D8）；
+ * - session/view 取自上次会话的持久化 context，由 rum-core dispatchEvents
+ *   按 session_id 分组上报，不会因旧 session 被丢弃。
+ */
+export declare function convertOomToRumEvent(oomData: NativeOomData): RumEvent;
 /**
  * 安全调用原生桥方法，异常时静默降级。
  */

package/lib/typescript/module/src/NativeRumSdkReactnative.d.ts

@@ -43,6 +43,16 @@ export interface Spec extends TurboModule {
     updateCrashContext(context: string): void;
     /** 触发测试崩溃（仅用于开发调试，调用后 App 立即崩溃） */
     triggerTestCrash(crashType: string): void;
+    /** 获取待上报的 OOM 报告列表（下次启动时调用），JSON 字符串 */
+    getPendingOomReports(): Promise<string>;
+    /** 清除已上报的 OOM 报告文件 */
+    clearOomReports(oomIds: string): Promise<void>;
+    /**
+     * 同步 JS 侧采集器配置到原生（SDK init 时调用），config 为 JSON 字符串。
+     * 当前支持的键：`oom`（boolean，是否开启 OOM 采集，false/缺省不启用）。
+     * 原生侧据此安装状态记录器并执行上次启动的看门狗终止判定。
+     */
+    updateCollectorsConfig(config: string): void;
 }
 declare const _default: Spec;
 export default _default;

package/lib/typescript/module/src/collector/exception/oom.d.ts

@@ -0,0 +1,34 @@
+import type { ICollector, IContext, SendEventFn } from '@arms/rum-core';
+/**
+ * OOM（iOS 看门狗终止推断）采集器（Exception 的子类型）：
+ * 1. 初始化时将 oom 开关同步到原生（原生侧据此安装状态记录器并执行
+ *    上次启动的看门狗终止判定）；
+ * 2. 读取上次运行写入的原生 OOM 事件文件，转换为 RumEvent（type='crash' +
+ *    subtype='oom'）通过标准管线上报（每次启动最多 1 条，直接 immediate）；
+ * 3. 复用崩溃 Ack 管线：上报成功后回 ack 删除对应文件，失败保留重试。
+ *
+ * 与 CrashCollector 的关系（D7，采集器配置相互独立、不级联）：
+ * - 本采集器不检查 collectors.crash，crash 关闭时 OOM 仍独立工作；
+ * - 双报防护由原生判定层互斥承担（存在待处理崩溃证据则不产生 OOM 文件）；
+ * - context 同步与 CrashCollector 各自订阅同一事件，原生侧幂等写入无副作用
+ *   （crash 单独关闭而 OOM 开启时 context 同步仍可用）。
+ */
+export default class OomCollector implements ICollector {
+    name: string;
+    private ctx?;
+    private sendEvent?;
+    private initialized;
+    /** 已上报待确认（ack）的 oom_id，成功后才删文件 */
+    private pendingAckIds;
+    setup(ctx: IContext, sendEvent: SendEventFn): void;
+    private processPendingOomReports;
+    private onCrashContextChange;
+    /**
+     * reporter 上报确认回调（复用崩溃 Ack 事件，按 oom_id 归属）：
+     * - 成功：删除对应 oom_id 的 OOM 文件（确保上报成功后才删，不丢数据）；
+     * - 失败：保留文件，下次启动重试，仅从内存待确认集合中移除。
+     */
+    private onCrashReportAck;
+    destroy(): void;
+}
+//# sourceMappingURL=oom.d.ts.map

package/lib/typescript/module/src/collector/index.d.ts

@@ -1,6 +1,7 @@
 export { default as PvCollector } from './view/pv';
 export { default as ExceptionCollector } from './exception/index';
 export { default as CrashCollector } from './exception/crash';
+export { default as OomCollector } from './exception/oom';
 export { default as ApiCollector } from './resource/api';
 export { default as ActionCollector } from './action/index';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/src/shell.d.ts

@@ -2,7 +2,7 @@ import { Shell } from '@arms/rum-core';
 import * as collectors from './collector';
 import { IRNConfig } from './types/client';
 import { NavigationContainerRef } from './types';
-declare const builtInCollectors: readonly (typeof collectors.PvCollector | typeof collectors.ExceptionCollector | typeof collectors.CrashCollector | typeof collectors.ApiCollector | typeof collectors.ActionCollector)[];
+declare const builtInCollectors: readonly (typeof collectors.PvCollector | typeof collectors.ExceptionCollector | typeof collectors.CrashCollector | typeof collectors.OomCollector | typeof collectors.ApiCollector | typeof collectors.ActionCollector)[];
 type CollectorName = (typeof builtInCollectors)[number]['prototype']['name'];
 type CollectorMap = {
     [K in CollectorName]: InstanceType<Extract<(typeof builtInCollectors)[number], {

package/lib/typescript/module/src/types/client.d.ts

@@ -23,5 +23,32 @@ export interface IRNConfig extends IConfiguration {
      * request 自定义解析;
      */
     evaluateApi?(request: any, response: any, error?: Error, xhr?: XMLHttpRequest): Promise<IApiBaseAttr>;
+    /**
+     * 采集器配置。
+     *
+     * 以交叉类型扩展父类型的 index signature，补充各采集器开关的 JSDoc
+     * 默认值说明（对齐 rum-electron 配置类型风格，与配置参考文档双保险
+     * 防默认值漂移）。
+     */
+    collectors?: IConfiguration['collectors'] & {
+        /**
+         * OOM（iOS 看门狗终止推断）采集开关。
+         *
+         * 默认 false，需显式开启（`oom: true`），缺省或 false 均不启用；
+         * 开关方向与 crash 采集器相反（crash 默认开启，`crash === false` 才关闭）。
+         *
+         * 能力范围：仅 iOS 前台看门狗终止的事后推断（无堆栈，timestamp 为
+         * 估算值，`snapshots.estimated: true` 标记推断性质）；Android 无此
+         * 能力（Java OutOfMemoryError 已由崩溃链路捕获）。
+         *
+         * 建议与 `crash` 同时开启；crash 关闭时 KSCrash 崩溃报告只写不删，
+         * 残留报告会使 OOM 判定倾向被抑制（漏判方向保守），而非误报增多。
+         *
+         * 未来若出现子开关需求（内存警告、前后台区分等），本字段计划演进为
+         * `boolean | object` 双形态（参照 rum-electron checkEnable 四态归一），
+         * 本期维持单一 boolean。
+         */
+        oom?: boolean;
+    };
 }
 //# sourceMappingURL=client.d.ts.map

package/lib/typescript/module/src/types/oom.d.ts

@@ -0,0 +1,58 @@
+/**
+ * OOM（iOS 看门狗终止推断）相关类型定义。
+ *
+ * 对应 iOS 原生侧落盘的 oom_{timestamp}_{uuid}.json 事件文件结构
+ * （getPendingOomReports 返回数组的元素），见
+ * dev-docs/OOM采集调研与实施方案.md 4.2.3 节。
+ */
+/** OOM 事件的上次会话上下文（原生从 context.json 恢复） */
+export interface OomContext {
+    session_id?: string;
+    view_id?: string;
+    view_name?: string;
+    user_id?: string;
+}
+/** 上次会话的 App 状态快照（原生 RumAppStateRecorder 状态变更时写入） */
+export interface OomAppState {
+    appVersion?: string;
+    osVersion?: string;
+    /** 系统启动时刻（ISO8601），用于排除设备重启 */
+    systemBootTime?: string;
+    vendorId?: string;
+    /** 上次进程是否前台激活（仅前台被杀才判定，D5） */
+    isActive?: boolean;
+    /** 是否收到正常终止回调（用户强杀排除） */
+    wasTerminated?: boolean;
+    /** 上次是否处于调试态（调试期被杀排除） */
+    isDebugging?: boolean;
+    /** 状态快照写入时刻（ms），供 context 新鲜度评估 */
+    updatedAt?: number;
+}
+/**
+ * 原生 OOM 数据结构（与 iOS 原生侧落盘的 JSON 对齐）。
+ * 仅声明 JS 层会用到的字段。
+ */
+export interface NativeOomData {
+    /**
+     * OOM 事件唯一标识（UUID），承担与 crash_id 等价的 Ack 标识角色。
+     * 防御性声明为可选：缺失时事件仍可上报，仅无法走 ack 删文件链路。
+     */
+    oom_id?: string;
+    /** 估算的案发时刻（ms，取上次会话最后写入的持久化文件 mtime） */
+    timestamp?: number;
+    platform?: string;
+    subtype?: string;
+    /** 事件名，PascalCase（如 WatchdogTermination） */
+    name?: string;
+    /** 英文证据式表述（D8），推断性质由 snapshots.estimated 承载 */
+    message?: string;
+    /** 崩溃机制信息（如 { type: 'watchdog_termination', handled: false }） */
+    mechanism?: Record<string, unknown>;
+    /** 上次会话的 App 状态快照 */
+    app_state?: OomAppState;
+    /** 上次会话上下文（session/view/user 关联依据） */
+    context?: OomContext;
+    app?: Record<string, unknown>;
+    device?: Record<string, unknown>;
+}
+//# sourceMappingURL=oom.d.ts.map

package/lib/typescript/module/src/utils/crash.d.ts

@@ -1,10 +1,23 @@
 import { type RumEvent } from '@arms/rum-core';
 import type { NativeCrashData } from '../types/crash';
+import type { NativeOomData } from '../types/oom';
 /**
  * 将原生崩溃数据转换为 RumEvent 异常事件，对齐存储模型 Exception 表的
  * Attributes（session/view/exception 基础信息）+ Metadata（堆栈、快照等）字段。
  */
 export declare function convertCrashToRumEvent(crashData: NativeCrashData): RumEvent;
+/**
+ * 将原生 OOM（看门狗终止推断）数据转换为 RumEvent 异常事件，
+ * 对齐存储模型 Exception 表。
+ *
+ * 与崩溃事件的差异：
+ * - type='crash' + subtype='oom' 复用现有 exception 链路，不新增 type 枚举（D4）；
+ * - 无堆栈（watchdog 终止无信号可捕获，无现场数据）；
+ * - timestamp 为估算值（snapshots.estimated: true 结构化标记推断性质，D8）；
+ * - session/view 取自上次会话的持久化 context，由 rum-core dispatchEvents
+ *   按 session_id 分组上报，不会因旧 session 被丢弃。
+ */
+export declare function convertOomToRumEvent(oomData: NativeOomData): RumEvent;
 /**
  * 安全调用原生桥方法，异常时静默降级。
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arms/rum-reactnative",
-  "version": "0.1.3-beta.5",
+  "version": "0.1.4-beta.1",
   "description": "RUM SDK For ReactNative",
   "homepage": "https://help.aliyun.com/zh/arms/user-experience-monitoring/",
   "main": "./lib/commonjs/index.js",
@@ -64,7 +64,6 @@
     "clean": "del-cli android/build example/ios example/android lib",
     "build": "bob build && node scripts/inject-version.js",
     "build:prod": "bob build && node scripts/minify-prod.js",
-    "prepare": "bob build && node scripts/inject-version.js",
     "prepack": "yarn build:prod",
     "release": "release-it --only-version"
   },

package/src/NativeRumSdkReactnative.ts

@@ -56,6 +56,21 @@ export interface Spec extends TurboModule {
 
   /** 触发测试崩溃（仅用于开发调试，调用后 App 立即崩溃） */
   triggerTestCrash(crashType: string): void;
+
+  // === OOM（看门狗终止）采集相关 ===
+
+  /** 获取待上报的 OOM 报告列表（下次启动时调用），JSON 字符串 */
+  getPendingOomReports(): Promise<string>;
+
+  /** 清除已上报的 OOM 报告文件 */
+  clearOomReports(oomIds: string): Promise<void>;
+
+  /**
+   * 同步 JS 侧采集器配置到原生（SDK init 时调用），config 为 JSON 字符串。
+   * 当前支持的键：`oom`（boolean，是否开启 OOM 采集，false/缺省不启用）。
+   * 原生侧据此安装状态记录器并执行上次启动的看门狗终止判定。
+   */
+  updateCollectorsConfig(config: string): void;
 }
 
 /**
@@ -102,6 +117,9 @@ const fallback: Spec = {
   crashedLastRun: async () => false,
   updateCrashContext: () => {},
   triggerTestCrash: () => {},
+  getPendingOomReports: async () => '[]',
+  clearOomReports: async () => {},
+  updateCollectorsConfig: () => {},
 };
 
 export default nativeModule ?? fallback;