@longzai-intelligence-telemetry/react 0.0.1

package/README.md

@@ -0,0 +1,13 @@
+# @longzai-intelligence-telemetry/react
+
+遥测体系 L1 React Native 表面包（消费 `@longzai-intelligence-telemetry/core` 端口与契约）：Logger 可插拔 listener、fetch 裸传输（无鉴权头/短超时）、SQLite outbox（结构化句柄注入，宿主传 op-sqlite 连接）、全局错误接线（ErrorUtils）、ErrorBoundary、事件常量与 TelemetryClient（分级同意门、成功才删行/毒批即弃/冷却熔断的递送协调、关闭即 purge）。
+
+## 设计约束
+
+- 裸传输纪律：不走业务 http 客户端、不带 Authorization、失败静默三态归类。
+- outbox 句柄端口化：包内零原生依赖，op-sqlite 版本选择与装配由宿主壳层承担。
+- 本包禁止使用业务 Logger（防「上报失败→错误日志→再上报」通道自激）。
+
+## Peer 依赖
+
+`react >= 19`、`react-native >= 0.87`（宿主提供）。

package/dist/index.d.mts

@@ -0,0 +1,564 @@
+import { StoredTelemetryRecord, TelemetryBatchContext, TelemetryChannelKind, TelemetryClockPort, TelemetryConsent, TelemetryEventBatch, TelemetryEventEntry, TelemetryLogBatch, TelemetryLogEntry, TelemetryLogLevel, TelemetryPropertyValue, TelemetrySendResult, TelemetryStoragePort, TelemetryTransportPort } from "@longzai-intelligence-telemetry/core";
+import { Component, ReactNode } from "react";
+//#region src/event-names.constants.d.ts
+/**
+ * 遥测事件名常量表（接线点禁止裸写字符串；catalog 登记随 O4 事件目录维护）
+ */
+declare const TELEMETRY_EVENT_NAMES: {
+  /**
+   * 应用启动（遥测初始化补发）
+   */
+  readonly appLaunch: 'app_launch';
+  /**
+   * 前后台切换（生命周期接线）
+   */
+  readonly appStateChange: 'app_state_change';
+  /**
+   * JS 错误捕获（全局错误接线 / ErrorBoundary）
+   */
+  readonly jsError: 'js_error';
+  /**
+   * 上次会话异常退出（NativeCrashMarkerPort 过渡检测）
+   */
+  readonly previousSessionAbnormalExit: 'previous_session_abnormal_exit';
+};
+/**
+ * 合法事件名联合（track API 的 name 参数类型收窄）
+ */
+type TelemetryEventName = (typeof TELEMETRY_EVENT_NAMES)[keyof typeof TELEMETRY_EVENT_NAMES];
+//#endregion
+//#region src/fetch-transport.utils.d.ts
+/**
+ * fetch 传输配置
+ */
+type FetchTransportOptions = {
+  /**
+   * 服务基址（如 https://telemetry.example.com，不含尾斜杠）
+   */
+  baseUrl: string;
+  /**
+   * 单请求超时毫秒（缺省 8000，对齐 watch 传输口径）
+   */
+  timeoutMs?: number;
+};
+/**
+ * fetch 裸传输器（实现 core TransportPort）
+ */
+declare class FetchTelemetryTransport implements TelemetryTransportPort {
+  /**
+   * 服务基址
+   */
+  private readonly baseUrl;
+  /**
+   * 超时毫秒
+   */
+  private readonly timeoutMs;
+  /**
+   * 构造传输器（记录基址与超时）。
+   *
+   * @param options - 传输配置
+   */
+  constructor(options: FetchTransportOptions);
+  /**
+   * 发送事件批量
+   *
+   * @param batch - 事件批量上报体
+   * @returns 三态发送结果
+   */
+  sendEventBatch(batch: TelemetryEventBatch): Promise<TelemetrySendResult>;
+  /**
+   * 发送日志批量
+   *
+   * @param batch - 日志批量上报体
+   * @returns 三态发送结果
+   */
+  sendLogBatch(batch: TelemetryLogBatch): Promise<TelemetrySendResult>;
+  /**
+   * 单次发送（POST JSON + 超时中断；失败一律静默归类）
+   *
+   * @param path - 端点路径（core 契约端点）
+   * @param body - 批量上报体
+   * @returns 三态发送结果
+   */
+  private send;
+}
+//#endregion
+//#region src/logger.utils.d.ts
+/**
+ * 单条日志条目（listener 消费形态）
+ */
+type LoggerEntry = {
+  /**
+   * 日志级别
+   */
+  level: TelemetryLogLevel;
+  /**
+   * 日志消息（Error 实例已被归一为 message + stack）
+   */
+  message: string;
+  /**
+   * 关联堆栈（非 Error 来源为空字符串）
+   */
+  stack: string;
+  /**
+   * 来源标签
+   */
+  tag: string;
+};
+/**
+ * 日志监听器接口（可插拔）
+ */
+type LoggerListener = {
+  /**
+   * 接收日志条目
+   *
+   * @param entry - 日志条目
+   */
+  log(entry: LoggerEntry): void;
+};
+/**
+ * 日志远程镜像接收面（telemetry listener 转发目标，由 TelemetryClient 实现）
+ */
+type TelemetryLogSink = {
+  /**
+   * 镜像一条日志（仅 WARN+ 会被转发；FATAL 已并入 ERROR）
+   *
+   * @param entry - 已归级的日志条目
+   */
+  mirrorLog(entry: LoggerEntry): void;
+};
+/**
+ * 归一错误结果（消息 + 堆栈）
+ */
+type NormalizedError = {
+  /**
+   * 归一消息
+   */
+  message: string;
+  /**
+   * 归一堆栈（可空）
+   */
+  stack: string;
+};
+/**
+ * 退订函数形态
+ */
+type Unsubscribe = () => void;
+/**
+ * 归一未知错误值为 message + stack（非 Error 形态 String 化、堆栈为空）
+ *
+ * @param value - 任意抛出值
+ * @returns 归一后的消息与堆栈
+ */
+declare function normalizeErrorValue(value: unknown): NormalizedError;
+/**
+ * tagged Logger（级别分发 + 多 listener 扇出； unregister 经返回的退订函数）
+ */
+declare class Logger {
+  /**
+   * 来源标签
+   */
+  private readonly tag;
+  /**
+   * 已挂载 listener 集合
+   */
+  private readonly listeners;
+  /**
+   * 构造 tagged Logger。
+   *
+   * @param tag - 来源标签（模块/页面名）
+   */
+  constructor(tag: string);
+  /**
+   * 挂载 listener。
+   *
+   * @param listener - 日志监听器
+   * @returns 退订函数
+   */
+  addListener(listener: LoggerListener): Unsubscribe;
+  /**
+   * 输出 debug 级日志
+   *
+   * @param message - 消息或 Error 实例
+   */
+  debug(message: unknown): void;
+  /**
+   * 输出 info 级日志
+   *
+   * @param message - 消息或 Error 实例
+   */
+  info(message: unknown): void;
+  /**
+   * 输出 warn 级日志
+   *
+   * @param message - 消息或 Error 实例
+   */
+  warn(message: unknown): void;
+  /**
+   * 输出 error 级日志
+   *
+   * @param message - 消息或 Error 实例
+   */
+  error(message: unknown): void;
+  /**
+   * 按级别分发至全部 listener（Error 实例归一为 message + stack）
+   *
+   * @param level - 日志级别
+   * @param message - 消息或 Error 实例
+   */
+  private dispatch;
+}
+/**
+ * 创建遥测日志 listener（WARN+ 镜像至 sink；FATAL 并入 ERROR——watch 日志通道语义）
+ *
+ * @param sink - 远程镜像接收面
+ * @returns 日志监听器
+ */
+declare function createTelemetryLogListener(sink: TelemetryLogSink): LoggerListener;
+//#endregion
+//#region src/global-error.utils.d.ts
+/**
+ * RN 全局错误处理函数形态
+ */
+type GlobalErrorHandler = (error: unknown, isFatal: boolean) => void;
+/**
+ * ErrorUtils 最小面（宿主可注入；缺省探测 globalThis.ErrorUtils）
+ */
+type ErrorUtilsLike = {
+  /**
+   * 设置全局错误处理器
+   */
+  setGlobalHandler(handler: GlobalErrorHandler): void;
+};
+/**
+ * 捕获错误回调载荷
+ */
+type CapturedError = {
+  /**
+   * 归一消息
+   */
+  message: string;
+  /**
+   * 归一堆栈（可空）
+   */
+  stack: string;
+  /**
+   * 是否致命（RN fatal 标记）
+   */
+  isFatal: boolean;
+};
+/**
+ * 接线选项
+ */
+type GlobalErrorWiringOptions = {
+  /**
+   * 捕获错误回调（fatal 与非 fatal 均回调）
+   */
+  onError: (captured: CapturedError) => void;
+  /**
+   * ErrorUtils 注入（缺省探测 globalThis.ErrorUtils）
+   */
+  errorUtils?: ErrorUtilsLike;
+};
+/**
+ * 接线卸载函数形态
+ */
+type Uninstall = () => void;
+/**
+ * 安装全局错误接线（返回卸载函数；ErrorUtils 不可用时返回空操作卸载）。
+ *
+ * @param options - 接线选项
+ * @returns 卸载函数（回落静默空处理器）
+ */
+declare function installGlobalErrorHandler(options: GlobalErrorWiringOptions): Uninstall;
+//#endregion
+//#region src/telemetry-error-boundary.utils.d.ts
+/**
+ * ErrorBoundary 属性
+ */
+type TelemetryErrorBoundaryProps = {
+  /**
+   * 子树
+   */
+  children?: ReactNode;
+  /**
+   * 捕获后的回退 UI（缺省渲染 null）
+   */
+  fallback?: (error: Error) => ReactNode;
+  /**
+   * 捕获回调（上报接线由此承接）
+   */
+  onError?: (error: Error) => void;
+};
+/**
+ * ErrorBoundary 状态
+ */
+type TelemetryErrorBoundaryState = {
+  /**
+   * 是否已捕获错误
+   */
+  hasError: boolean;
+  /**
+   * 捕获的错误实例
+   */
+  error: Error | null;
+};
+/**
+ * 遥测 ErrorBoundary（渲染异常捕获 → onError 上报 + 回退 UI）
+ */
+declare class TelemetryErrorBoundary extends Component<TelemetryErrorBoundaryProps, TelemetryErrorBoundaryState> {
+  /**
+   * 初始状态（未捕获）
+   */
+  state: TelemetryErrorBoundaryState;
+  /**
+   * 派生状态（渲染异常时置位）
+   *
+   * @param error - 捕获的错误
+   * @returns 捕获态状态
+   */
+  static getDerivedStateFromError(error: Error): TelemetryErrorBoundaryState;
+  /**
+   * 捕获回调（上报接线）
+   *
+   * @param error - 捕获的错误
+   */
+  componentDidCatch(error: Error): void;
+  /**
+   * 渲染（捕获后渲染回退 UI，否则渲染子树）
+   *
+   * @returns 当前渲染节点
+   */
+  render(): ReactNode;
+}
+/**
+ * ErrorBoundary 元素工厂（壳层 createElement 别名，便于无 JSX 接线）
+ *
+ * @param props - ErrorBoundary 属性
+ * @returns React 元素
+ */
+declare function createTelemetryErrorBoundaryElement(props: TelemetryErrorBoundaryProps): ReactNode;
+//#endregion
+//#region src/telemetry-client.utils.d.ts
+/**
+ * 客户端依赖端口集合
+ */
+type TelemetryClientPorts = {
+  /**
+   * 持久存储端口（outbox 载体）
+   */
+  storage: TelemetryStoragePort;
+  /**
+   * 时钟端口
+   */
+  clock: TelemetryClockPort;
+  /**
+   * 传输端口（裸传输）
+   */
+  transport: TelemetryTransportPort;
+};
+/**
+ * 客户端选项
+ */
+type TelemetryClientOptions = {
+  /**
+   * 初始同意状态（缺省为 O-2 推荐口径默认值）
+   */
+  consent?: TelemetryConsent;
+  /**
+   * 递送档位标识（缺省 lossless）
+   */
+  deliveryMode?: 'lossless' | 'balanced' | 'lite';
+  /**
+   * 单批装载条数（缺省 100，契约批上限内）
+   */
+  batchEntries?: number;
+};
+/**
+ * 单次冲刷结果
+ */
+type TelemetryFlushOutcome = {
+  /**
+   * 成功送出的事件批数
+   */
+  eventBatchesSent: number;
+  /**
+   * 成功送出的日志批数
+   */
+  logBatchesSent: number;
+  /**
+   * 是否因失败冷却被整轮跳过
+   */
+  blockedByCooldown: boolean;
+};
+/**
+ * 遥测客户端（端侧装配核心：track / captureError / mirrorLog / flushOnce / setConsent）
+ */
+declare class TelemetryClient {
+  /**
+   * 依赖端口
+   */
+  private readonly ports;
+  /**
+   * 会话批次上下文（batchedAt 每轮冲刷刷新）
+   */
+  private readonly context;
+  /**
+   * 递送档位参数面
+   */
+  private readonly profile;
+  /**
+   * 单批装载条数
+   */
+  private readonly batchEntries;
+  /**
+   * 当前同意状态
+   */
+  private consent;
+  /**
+   * 发送冷却状态
+   */
+  private cooldown;
+  /**
+   * 构造客户端（装配端口、上下文、档位与同意初值）。
+   *
+   * @param ports - 依赖端口集合
+   * @param context - 会话批次上下文
+   * @param options - 客户端选项
+   */
+  constructor(ports: TelemetryClientPorts, context: TelemetryBatchContext, options?: TelemetryClientOptions);
+  /**
+   * 行为事件上报（事件通道经同意门 + 属性封闭字段集清洗）
+   *
+   * @param name - 事件名（常量表联合类型，禁止裸写字符串）
+   * @param properties - 事件属性
+   * @param allowedKeys - 属性白名单（缺省为属性键集合自身）
+   */
+  track(name: TelemetryEventName, properties?: Record<string, TelemetryPropertyValue>, allowedKeys?: readonly string[]): Promise<void>;
+  /**
+   * 错误捕获（崩溃通道：日志条目 + js_error 事件条目双落）
+   *
+   * @param error - 捕获的未知抛出值
+   * @param captureOptions - 捕获选项
+   */
+  captureError(error: unknown, captureOptions?: {
+    isFatal?: boolean;
+    tag?: string;
+  }): Promise<void>;
+  /**
+   * 日志远程镜像（WARN+ 且崩溃通道开启时落日志通道；Logger listener 的 sink 承接）
+   *
+   * @param level - 已归级日志级别（fatal 已并入 error）
+   * @param message - 日志消息
+   * @param stack - 关联堆栈
+   * @param tag - 来源标签
+   */
+  mirrorLog(level: TelemetryLogLevel, message: string, stack: string, tag: string): Promise<void>;
+  /**
+   * 更新同意状态（任一通道关闭即整库 purge——关闭不留存口径）
+   *
+   * @param consent - 新同意状态
+   */
+  setConsent(consent: TelemetryConsent): Promise<void>;
+  /**
+   * 单轮冲刷（双通道批量装载 → 裸传输 → 成功删行 / 拒绝即弃 / 可重试熔断冷却）
+   *
+   * @returns 冲刷结果
+   */
+  flushOnce(): Promise<TelemetryFlushOutcome>;
+  /**
+   * 单通道递送一轮（至多 maxBatchesPerRun 批；可重试失败熔断并登记冷却）
+   *
+   * @param channel - 通道
+   * @param nowMs - 本轮基准时间
+   * @returns 通道轮结果
+   */
+  private runChannel;
+  /**
+   * 装配并发送单批（按通道选装配器；batchedAt 刷新为本轮时间）
+   *
+   * @param channel - 通道
+   * @param records - 装载记录
+   * @param nowMs - 本轮基准时间
+   * @returns 三态发送结果
+   */
+  private sendChannelBatch;
+}
+//#endregion
+//#region src/sqlite-outbox.utils.d.ts
+/**
+ * SQLite 执行结果（对齐 op-sqlite execute 返回形态）
+ */
+type SqliteExecuteResult = {
+  /**
+   * 查询行集合（写入语句为空）
+   */
+  rows?: Record<string, unknown>[];
+  /**
+   * 插入语句分配的自增行号
+   */
+  insertId?: number;
+};
+/**
+ * SQLite 句柄（结构化端口：宿主传入 op-sqlite 连接即可）
+ */
+type SqliteDbHandle = {
+  /**
+   * 执行 SQL（参数绑定）
+   *
+   * @param sql - SQL 文本
+   * @param params - 绑定参数
+   */
+  execute(sql: string, params?: unknown[]): SqliteExecuteResult;
+};
+/**
+ * SQLite outbox（写穿落库、按行号序装载、成功才删行由调用方（TelemetryClient）承接）
+ */
+declare class SqliteOutbox implements TelemetryStoragePort {
+  /**
+   * SQLite 句柄（宿主注入）
+   */
+  private readonly handle;
+  /**
+   * 构造 outbox（建表幂等）。
+   *
+   * @param handle - SQLite 句柄（op-sqlite 连接或测试替身）
+   */
+  constructor(handle: SqliteDbHandle);
+  /**
+   * 追加条目
+   *
+   * @param channel - 通道
+   * @param entry - 条目载荷
+   * @returns 分配的行号（句柄未回传时为 0）
+   */
+  append(channel: TelemetryChannelKind, entry: TelemetryEventEntry | TelemetryLogEntry): Promise<number>;
+  /**
+   * 按行号序装载一批（载荷损坏行自愈跳过——毒行防御）
+   *
+   * @param channel - 通道
+   * @param maxEntries - 单批上限
+   * @returns 装载记录集合
+   */
+  loadBatch(channel: TelemetryChannelKind, maxEntries: number): Promise<StoredTelemetryRecord[]>;
+  /**
+   * 删除指定行（成功后调用——至少一次语义的删行侧）
+   *
+   * @param channel - 通道
+   * @param ids - 行号集合
+   */
+  deleteRecords(channel: TelemetryChannelKind, ids: readonly number[]): Promise<void>;
+  /**
+   * 清空全部通道（同意关闭即 purge）
+   */
+  purgeAll(): Promise<void>;
+  /**
+   * 统计行数
+   *
+   * @param channel - 通道
+   * @returns 行数
+   */
+  count(channel: TelemetryChannelKind): Promise<number>;
+}
+//#endregion
+export { type CapturedError, type ErrorUtilsLike, FetchTelemetryTransport, type FetchTransportOptions, type GlobalErrorHandler, type GlobalErrorWiringOptions, Logger, type LoggerEntry, type LoggerListener, type NormalizedError, type SqliteDbHandle, type SqliteExecuteResult, SqliteOutbox, TELEMETRY_EVENT_NAMES, TelemetryClient, type TelemetryClientOptions, type TelemetryClientPorts, TelemetryErrorBoundary, type TelemetryErrorBoundaryProps, type TelemetryEventName, type TelemetryFlushOutcome, type TelemetryLogSink, type Uninstall, type Unsubscribe, createTelemetryErrorBoundaryElement, createTelemetryLogListener, installGlobalErrorHandler, normalizeErrorValue };

package/dist/index.d.ts

@@ -0,0 +1,565 @@
+import "./rolldown-runtime-B7xKLgmA.js";
+import { StoredTelemetryRecord, TelemetryBatchContext, TelemetryChannelKind, TelemetryClockPort, TelemetryConsent, TelemetryEventBatch, TelemetryEventEntry, TelemetryLogBatch, TelemetryLogEntry, TelemetryLogLevel, TelemetryPropertyValue, TelemetrySendResult, TelemetryStoragePort, TelemetryTransportPort } from "@longzai-intelligence-telemetry/core";
+import { Component, ReactNode } from "react";
+//#region src/event-names.constants.d.ts
+/**
+ * 遥测事件名常量表（接线点禁止裸写字符串；catalog 登记随 O4 事件目录维护）
+ */
+declare const TELEMETRY_EVENT_NAMES: {
+  /**
+   * 应用启动（遥测初始化补发）
+   */
+  readonly appLaunch: 'app_launch';
+  /**
+   * 前后台切换（生命周期接线）
+   */
+  readonly appStateChange: 'app_state_change';
+  /**
+   * JS 错误捕获（全局错误接线 / ErrorBoundary）
+   */
+  readonly jsError: 'js_error';
+  /**
+   * 上次会话异常退出（NativeCrashMarkerPort 过渡检测）
+   */
+  readonly previousSessionAbnormalExit: 'previous_session_abnormal_exit';
+};
+/**
+ * 合法事件名联合（track API 的 name 参数类型收窄）
+ */
+type TelemetryEventName = (typeof TELEMETRY_EVENT_NAMES)[keyof typeof TELEMETRY_EVENT_NAMES];
+//#endregion
+//#region src/fetch-transport.utils.d.ts
+/**
+ * fetch 传输配置
+ */
+type FetchTransportOptions = {
+  /**
+   * 服务基址（如 https://telemetry.example.com，不含尾斜杠）
+   */
+  baseUrl: string;
+  /**
+   * 单请求超时毫秒（缺省 8000，对齐 watch 传输口径）
+   */
+  timeoutMs?: number;
+};
+/**
+ * fetch 裸传输器（实现 core TransportPort）
+ */
+declare class FetchTelemetryTransport implements TelemetryTransportPort {
+  /**
+   * 服务基址
+   */
+  private readonly baseUrl;
+  /**
+   * 超时毫秒
+   */
+  private readonly timeoutMs;
+  /**
+   * 构造传输器（记录基址与超时）。
+   *
+   * @param options - 传输配置
+   */
+  constructor(options: FetchTransportOptions);
+  /**
+   * 发送事件批量
+   *
+   * @param batch - 事件批量上报体
+   * @returns 三态发送结果
+   */
+  sendEventBatch(batch: TelemetryEventBatch): Promise<TelemetrySendResult>;
+  /**
+   * 发送日志批量
+   *
+   * @param batch - 日志批量上报体
+   * @returns 三态发送结果
+   */
+  sendLogBatch(batch: TelemetryLogBatch): Promise<TelemetrySendResult>;
+  /**
+   * 单次发送（POST JSON + 超时中断；失败一律静默归类）
+   *
+   * @param path - 端点路径（core 契约端点）
+   * @param body - 批量上报体
+   * @returns 三态发送结果
+   */
+  private send;
+}
+//#endregion
+//#region src/logger.utils.d.ts
+/**
+ * 单条日志条目（listener 消费形态）
+ */
+type LoggerEntry = {
+  /**
+   * 日志级别
+   */
+  level: TelemetryLogLevel;
+  /**
+   * 日志消息（Error 实例已被归一为 message + stack）
+   */
+  message: string;
+  /**
+   * 关联堆栈（非 Error 来源为空字符串）
+   */
+  stack: string;
+  /**
+   * 来源标签
+   */
+  tag: string;
+};
+/**
+ * 日志监听器接口（可插拔）
+ */
+type LoggerListener = {
+  /**
+   * 接收日志条目
+   *
+   * @param entry - 日志条目
+   */
+  log(entry: LoggerEntry): void;
+};
+/**
+ * 日志远程镜像接收面（telemetry listener 转发目标，由 TelemetryClient 实现）
+ */
+type TelemetryLogSink = {
+  /**
+   * 镜像一条日志（仅 WARN+ 会被转发；FATAL 已并入 ERROR）
+   *
+   * @param entry - 已归级的日志条目
+   */
+  mirrorLog(entry: LoggerEntry): void;
+};
+/**
+ * 归一错误结果（消息 + 堆栈）
+ */
+type NormalizedError = {
+  /**
+   * 归一消息
+   */
+  message: string;
+  /**
+   * 归一堆栈（可空）
+   */
+  stack: string;
+};
+/**
+ * 退订函数形态
+ */
+type Unsubscribe = () => void;
+/**
+ * 归一未知错误值为 message + stack（非 Error 形态 String 化、堆栈为空）
+ *
+ * @param value - 任意抛出值
+ * @returns 归一后的消息与堆栈
+ */
+declare function normalizeErrorValue(value: unknown): NormalizedError;
+/**
+ * tagged Logger（级别分发 + 多 listener 扇出； unregister 经返回的退订函数）
+ */
+declare class Logger {
+  /**
+   * 来源标签
+   */
+  private readonly tag;
+  /**
+   * 已挂载 listener 集合
+   */
+  private readonly listeners;
+  /**
+   * 构造 tagged Logger。
+   *
+   * @param tag - 来源标签（模块/页面名）
+   */
+  constructor(tag: string);
+  /**
+   * 挂载 listener。
+   *
+   * @param listener - 日志监听器
+   * @returns 退订函数
+   */
+  addListener(listener: LoggerListener): Unsubscribe;
+  /**
+   * 输出 debug 级日志
+   *
+   * @param message - 消息或 Error 实例
+   */
+  debug(message: unknown): void;
+  /**
+   * 输出 info 级日志
+   *
+   * @param message - 消息或 Error 实例
+   */
+  info(message: unknown): void;
+  /**
+   * 输出 warn 级日志
+   *
+   * @param message - 消息或 Error 实例
+   */
+  warn(message: unknown): void;
+  /**
+   * 输出 error 级日志
+   *
+   * @param message - 消息或 Error 实例
+   */
+  error(message: unknown): void;
+  /**
+   * 按级别分发至全部 listener（Error 实例归一为 message + stack）
+   *
+   * @param level - 日志级别
+   * @param message - 消息或 Error 实例
+   */
+  private dispatch;
+}
+/**
+ * 创建遥测日志 listener（WARN+ 镜像至 sink；FATAL 并入 ERROR——watch 日志通道语义）
+ *
+ * @param sink - 远程镜像接收面
+ * @returns 日志监听器
+ */
+declare function createTelemetryLogListener(sink: TelemetryLogSink): LoggerListener;
+//#endregion
+//#region src/global-error.utils.d.ts
+/**
+ * RN 全局错误处理函数形态
+ */
+type GlobalErrorHandler = (error: unknown, isFatal: boolean) => void;
+/**
+ * ErrorUtils 最小面（宿主可注入；缺省探测 globalThis.ErrorUtils）
+ */
+type ErrorUtilsLike = {
+  /**
+   * 设置全局错误处理器
+   */
+  setGlobalHandler(handler: GlobalErrorHandler): void;
+};
+/**
+ * 捕获错误回调载荷
+ */
+type CapturedError = {
+  /**
+   * 归一消息
+   */
+  message: string;
+  /**
+   * 归一堆栈（可空）
+   */
+  stack: string;
+  /**
+   * 是否致命（RN fatal 标记）
+   */
+  isFatal: boolean;
+};
+/**
+ * 接线选项
+ */
+type GlobalErrorWiringOptions = {
+  /**
+   * 捕获错误回调（fatal 与非 fatal 均回调）
+   */
+  onError: (captured: CapturedError) => void;
+  /**
+   * ErrorUtils 注入（缺省探测 globalThis.ErrorUtils）
+   */
+  errorUtils?: ErrorUtilsLike;
+};
+/**
+ * 接线卸载函数形态
+ */
+type Uninstall = () => void;
+/**
+ * 安装全局错误接线（返回卸载函数；ErrorUtils 不可用时返回空操作卸载）。
+ *
+ * @param options - 接线选项
+ * @returns 卸载函数（回落静默空处理器）
+ */
+declare function installGlobalErrorHandler(options: GlobalErrorWiringOptions): Uninstall;
+//#endregion
+//#region src/telemetry-error-boundary.utils.d.ts
+/**
+ * ErrorBoundary 属性
+ */
+type TelemetryErrorBoundaryProps = {
+  /**
+   * 子树
+   */
+  children?: ReactNode;
+  /**
+   * 捕获后的回退 UI（缺省渲染 null）
+   */
+  fallback?: (error: Error) => ReactNode;
+  /**
+   * 捕获回调（上报接线由此承接）
+   */
+  onError?: (error: Error) => void;
+};
+/**
+ * ErrorBoundary 状态
+ */
+type TelemetryErrorBoundaryState = {
+  /**
+   * 是否已捕获错误
+   */
+  hasError: boolean;
+  /**
+   * 捕获的错误实例
+   */
+  error: Error | null;
+};
+/**
+ * 遥测 ErrorBoundary（渲染异常捕获 → onError 上报 + 回退 UI）
+ */
+declare class TelemetryErrorBoundary extends Component<TelemetryErrorBoundaryProps, TelemetryErrorBoundaryState> {
+  /**
+   * 初始状态（未捕获）
+   */
+  state: TelemetryErrorBoundaryState;
+  /**
+   * 派生状态（渲染异常时置位）
+   *
+   * @param error - 捕获的错误
+   * @returns 捕获态状态
+   */
+  static getDerivedStateFromError(error: Error): TelemetryErrorBoundaryState;
+  /**
+   * 捕获回调（上报接线）
+   *
+   * @param error - 捕获的错误
+   */
+  componentDidCatch(error: Error): void;
+  /**
+   * 渲染（捕获后渲染回退 UI，否则渲染子树）
+   *
+   * @returns 当前渲染节点
+   */
+  render(): ReactNode;
+}
+/**
+ * ErrorBoundary 元素工厂（壳层 createElement 别名，便于无 JSX 接线）
+ *
+ * @param props - ErrorBoundary 属性
+ * @returns React 元素
+ */
+declare function createTelemetryErrorBoundaryElement(props: TelemetryErrorBoundaryProps): ReactNode;
+//#endregion
+//#region src/telemetry-client.utils.d.ts
+/**
+ * 客户端依赖端口集合
+ */
+type TelemetryClientPorts = {
+  /**
+   * 持久存储端口（outbox 载体）
+   */
+  storage: TelemetryStoragePort;
+  /**
+   * 时钟端口
+   */
+  clock: TelemetryClockPort;
+  /**
+   * 传输端口（裸传输）
+   */
+  transport: TelemetryTransportPort;
+};
+/**
+ * 客户端选项
+ */
+type TelemetryClientOptions = {
+  /**
+   * 初始同意状态（缺省为 O-2 推荐口径默认值）
+   */
+  consent?: TelemetryConsent;
+  /**
+   * 递送档位标识（缺省 lossless）
+   */
+  deliveryMode?: 'lossless' | 'balanced' | 'lite';
+  /**
+   * 单批装载条数（缺省 100，契约批上限内）
+   */
+  batchEntries?: number;
+};
+/**
+ * 单次冲刷结果
+ */
+type TelemetryFlushOutcome = {
+  /**
+   * 成功送出的事件批数
+   */
+  eventBatchesSent: number;
+  /**
+   * 成功送出的日志批数
+   */
+  logBatchesSent: number;
+  /**
+   * 是否因失败冷却被整轮跳过
+   */
+  blockedByCooldown: boolean;
+};
+/**
+ * 遥测客户端（端侧装配核心：track / captureError / mirrorLog / flushOnce / setConsent）
+ */
+declare class TelemetryClient {
+  /**
+   * 依赖端口
+   */
+  private readonly ports;
+  /**
+   * 会话批次上下文（batchedAt 每轮冲刷刷新）
+   */
+  private readonly context;
+  /**
+   * 递送档位参数面
+   */
+  private readonly profile;
+  /**
+   * 单批装载条数
+   */
+  private readonly batchEntries;
+  /**
+   * 当前同意状态
+   */
+  private consent;
+  /**
+   * 发送冷却状态
+   */
+  private cooldown;
+  /**
+   * 构造客户端（装配端口、上下文、档位与同意初值）。
+   *
+   * @param ports - 依赖端口集合
+   * @param context - 会话批次上下文
+   * @param options - 客户端选项
+   */
+  constructor(ports: TelemetryClientPorts, context: TelemetryBatchContext, options?: TelemetryClientOptions);
+  /**
+   * 行为事件上报（事件通道经同意门 + 属性封闭字段集清洗）
+   *
+   * @param name - 事件名（常量表联合类型，禁止裸写字符串）
+   * @param properties - 事件属性
+   * @param allowedKeys - 属性白名单（缺省为属性键集合自身）
+   */
+  track(name: TelemetryEventName, properties?: Record<string, TelemetryPropertyValue>, allowedKeys?: readonly string[]): Promise<void>;
+  /**
+   * 错误捕获（崩溃通道：日志条目 + js_error 事件条目双落）
+   *
+   * @param error - 捕获的未知抛出值
+   * @param captureOptions - 捕获选项
+   */
+  captureError(error: unknown, captureOptions?: {
+    isFatal?: boolean;
+    tag?: string;
+  }): Promise<void>;
+  /**
+   * 日志远程镜像（WARN+ 且崩溃通道开启时落日志通道；Logger listener 的 sink 承接）
+   *
+   * @param level - 已归级日志级别（fatal 已并入 error）
+   * @param message - 日志消息
+   * @param stack - 关联堆栈
+   * @param tag - 来源标签
+   */
+  mirrorLog(level: TelemetryLogLevel, message: string, stack: string, tag: string): Promise<void>;
+  /**
+   * 更新同意状态（任一通道关闭即整库 purge——关闭不留存口径）
+   *
+   * @param consent - 新同意状态
+   */
+  setConsent(consent: TelemetryConsent): Promise<void>;
+  /**
+   * 单轮冲刷（双通道批量装载 → 裸传输 → 成功删行 / 拒绝即弃 / 可重试熔断冷却）
+   *
+   * @returns 冲刷结果
+   */
+  flushOnce(): Promise<TelemetryFlushOutcome>;
+  /**
+   * 单通道递送一轮（至多 maxBatchesPerRun 批；可重试失败熔断并登记冷却）
+   *
+   * @param channel - 通道
+   * @param nowMs - 本轮基准时间
+   * @returns 通道轮结果
+   */
+  private runChannel;
+  /**
+   * 装配并发送单批（按通道选装配器；batchedAt 刷新为本轮时间）
+   *
+   * @param channel - 通道
+   * @param records - 装载记录
+   * @param nowMs - 本轮基准时间
+   * @returns 三态发送结果
+   */
+  private sendChannelBatch;
+}
+//#endregion
+//#region src/sqlite-outbox.utils.d.ts
+/**
+ * SQLite 执行结果（对齐 op-sqlite execute 返回形态）
+ */
+type SqliteExecuteResult = {
+  /**
+   * 查询行集合（写入语句为空）
+   */
+  rows?: Record<string, unknown>[];
+  /**
+   * 插入语句分配的自增行号
+   */
+  insertId?: number;
+};
+/**
+ * SQLite 句柄（结构化端口：宿主传入 op-sqlite 连接即可）
+ */
+type SqliteDbHandle = {
+  /**
+   * 执行 SQL（参数绑定）
+   *
+   * @param sql - SQL 文本
+   * @param params - 绑定参数
+   */
+  execute(sql: string, params?: unknown[]): SqliteExecuteResult;
+};
+/**
+ * SQLite outbox（写穿落库、按行号序装载、成功才删行由调用方（TelemetryClient）承接）
+ */
+declare class SqliteOutbox implements TelemetryStoragePort {
+  /**
+   * SQLite 句柄（宿主注入）
+   */
+  private readonly handle;
+  /**
+   * 构造 outbox（建表幂等）。
+   *
+   * @param handle - SQLite 句柄（op-sqlite 连接或测试替身）
+   */
+  constructor(handle: SqliteDbHandle);
+  /**
+   * 追加条目
+   *
+   * @param channel - 通道
+   * @param entry - 条目载荷
+   * @returns 分配的行号（句柄未回传时为 0）
+   */
+  append(channel: TelemetryChannelKind, entry: TelemetryEventEntry | TelemetryLogEntry): Promise<number>;
+  /**
+   * 按行号序装载一批（载荷损坏行自愈跳过——毒行防御）
+   *
+   * @param channel - 通道
+   * @param maxEntries - 单批上限
+   * @returns 装载记录集合
+   */
+  loadBatch(channel: TelemetryChannelKind, maxEntries: number): Promise<StoredTelemetryRecord[]>;
+  /**
+   * 删除指定行（成功后调用——至少一次语义的删行侧）
+   *
+   * @param channel - 通道
+   * @param ids - 行号集合
+   */
+  deleteRecords(channel: TelemetryChannelKind, ids: readonly number[]): Promise<void>;
+  /**
+   * 清空全部通道（同意关闭即 purge）
+   */
+  purgeAll(): Promise<void>;
+  /**
+   * 统计行数
+   *
+   * @param channel - 通道
+   * @returns 行数
+   */
+  count(channel: TelemetryChannelKind): Promise<number>;
+}
+//#endregion
+export { type CapturedError, type ErrorUtilsLike, FetchTelemetryTransport, type FetchTransportOptions, type GlobalErrorHandler, type GlobalErrorWiringOptions, Logger, type LoggerEntry, type LoggerListener, type NormalizedError, type SqliteDbHandle, type SqliteExecuteResult, SqliteOutbox, TELEMETRY_EVENT_NAMES, TelemetryClient, type TelemetryClientOptions, type TelemetryClientPorts, TelemetryErrorBoundary, type TelemetryErrorBoundaryProps, type TelemetryEventName, type TelemetryFlushOutcome, type TelemetryLogSink, type Uninstall, type Unsubscribe, createTelemetryErrorBoundaryElement, createTelemetryLogListener, installGlobalErrorHandler, normalizeErrorValue };

package/dist/index.js

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@longzai-intelligence-telemetry/core"),t=require("react");const n={appLaunch:`app_launch`,appStateChange:`app_state_change`,jsError:`js_error`,previousSessionAbnormalExit:`previous_session_abnormal_exit`};var r=class{baseUrl;timeoutMs;constructor(e){this.baseUrl=e.baseUrl,this.timeoutMs=e.timeoutMs??8e3}sendEventBatch(t){return this.send(e.TELEMETRY_ENDPOINTS.trackingEventsBatch,t)}sendLogBatch(t){return this.send(e.TELEMETRY_ENDPOINTS.clientLogsBatch,t)}async send(t,n){let r=new AbortController,i=setTimeout(()=>{r.abort()},this.timeoutMs);try{let i=await fetch(`${this.baseUrl}${t}`,{method:`POST`,headers:{"content-type":`application/json`},body:JSON.stringify(n),signal:r.signal});return(0,e.classifyHttpStatus)(i.status)}catch{return(0,e.classifyTransportFailure)()}finally{clearTimeout(i)}}};function i(e){return e instanceof Error?{message:e.message,stack:e.stack??``}:{message:String(e),stack:``}}var a=class{tag;listeners=new Set;constructor(e){this.tag=e}addListener(e){return this.listeners.add(e),()=>{this.listeners.delete(e)}}debug(e){this.dispatch(`debug`,e)}info(e){this.dispatch(`info`,e)}warn(e){this.dispatch(`warn`,e)}error(e){this.dispatch(`error`,e)}dispatch(e,t){let n=i(t),r={level:e,message:n.message,stack:n.stack,tag:this.tag};for(let e of this.listeners)e.log(r)}};function o(e){return{log(t){(t.level===`warn`||t.level===`error`||t.level===`fatal`)&&e.mirrorLog({...t,level:t.level===`fatal`?`error`:t.level})}}}const s=()=>{};function c(){let e=Reflect.get(globalThis,`ErrorUtils`);if(typeof e!=`object`||!e)return;let t=Reflect.get(e,`setGlobalHandler`);if(typeof t==`function`)return{setGlobalHandler:n=>{t.call(e,n)}}}function l(e){let t=e.errorUtils??c();return t===void 0?()=>{}:(t.setGlobalHandler((t,n)=>{let r=i(t);e.onError({...r,isFatal:n})}),()=>{t.setGlobalHandler(s)})}var u=class extends t.Component{state={hasError:!1,error:null};static getDerivedStateFromError(e){return{hasError:!0,error:e}}componentDidCatch(e){this.props.onError?.(e)}render(){return this.state.hasError&&this.state.error!==null?this.props.fallback?.(this.state.error)??null:this.props.children??null}};function d(e){return(0,t.createElement)(u,e)}var f=class{ports;context;profile;batchEntries;consent;cooldown=e.INITIAL_COOLDOWN_STATE;constructor(t,n,r){this.ports=t,this.context=n,this.profile=(0,e.getDeliveryProfile)(r?.deliveryMode??`lossless`),this.batchEntries=r?.batchEntries??100,this.consent=r?.consent??e.DEFAULT_TELEMETRY_CONSENT}async track(t,n={},r){if(!(0,e.isChannelUploadAllowed)(this.consent,`behavioral-events`))return;let i=(0,e.sanitizeProperties)(n,r??Object.keys(n));await this.ports.storage.append(`event`,{name:t,properties:i,occurredAt:this.ports.clock.nowMs()})}async captureError(t,r={}){if(!(0,e.isChannelUploadAllowed)(this.consent,`crash-reporting`))return;let a=i(t),o=r.isFatal??!1,s=r.tag??`global`;await this.ports.storage.append(`log`,{level:o?`fatal`:`error`,message:a.message,stack:a.stack,tag:s,occurredAt:this.ports.clock.nowMs()}),await this.ports.storage.append(`event`,{name:n.jsError,properties:{fatal:o,tag:s},occurredAt:this.ports.clock.nowMs()})}async mirrorLog(t,n,r,i){(t===`warn`||t===`error`)&&(0,e.isChannelUploadAllowed)(this.consent,`crash-reporting`)&&await this.ports.storage.append(`log`,{level:t,message:n,stack:r,tag:i,occurredAt:this.ports.clock.nowMs()})}async setConsent(e){(!e.crashChannelEnabled||!e.behavioralEventsEnabled)&&await this.ports.storage.purgeAll(),this.consent=e}async flushOnce(){let t=this.ports.clock.nowMs();if(!(0,e.shouldAttemptSend)(this.cooldown,t))return{eventBatchesSent:0,logBatchesSent:0,blockedByCooldown:!0};let n=await this.runChannel(`event`,t),r=n.aborted?{batchesSent:0,aborted:!0}:await this.runChannel(`log`,t);return{eventBatchesSent:n.batchesSent,logBatchesSent:r.batchesSent,blockedByCooldown:!1}}async runChannel(t,n){let r=0;for(;r<this.profile.maxBatchesPerRun;){let i=await this.ports.storage.loadBatch(t,this.batchEntries);if(i.length===0)break;let a=await this.sendChannelBatch(t,i,n);if(a.outcome===`success`){await this.ports.storage.deleteRecords(t,i.map(e=>e.id)),this.cooldown=(0,e.registerSendSuccess)(),r+=1;continue}if(a.outcome===`retryable`)return this.cooldown=(0,e.registerSendFailure)(this.cooldown,n,this.profile.failureCooldownMs),{batchesSent:r,aborted:!0};await this.ports.storage.deleteRecords(t,i.map(e=>e.id)),r+=1}return{batchesSent:r,aborted:!1}}async sendChannelBatch(t,n,r){let i={...this.context,batchedAt:r};if(t===`event`){let r=n.filter(e=>`name`in e.entry).map(e=>({id:e.id,channel:t,entry:e.entry})),a=(0,e.assembleEventBatch)(i,r,this.batchEntries);return this.ports.transport.sendEventBatch(a.batch)}let a=n.filter(e=>`level`in e.entry).map(e=>({id:e.id,channel:t,entry:e.entry})),o=(0,e.assembleLogBatch)(i,a,this.batchEntries);return this.ports.transport.sendLogBatch(o.batch)}};const p=`telemetry_outbox_events`,m=`telemetry_outbox_logs`;function h(e){return e===`event`?p:m}function g(e){if(typeof e!=`object`||!e)return!1;let t=Reflect.get(e,`name`),n=Reflect.get(e,`occurredAt`);return typeof t==`string`&&typeof n==`number`}function _(e){if(typeof e!=`object`||!e)return!1;let t=Reflect.get(e,`message`),n=Reflect.get(e,`occurredAt`);return typeof t==`string`&&typeof n==`number`}var v=class{handle;constructor(e){this.handle=e,this.handle.execute(`CREATE TABLE IF NOT EXISTS ${p} (id INTEGER PRIMARY KEY AUTOINCREMENT, payload TEXT NOT NULL)`),this.handle.execute(`CREATE TABLE IF NOT EXISTS ${m} (id INTEGER PRIMARY KEY AUTOINCREMENT, payload TEXT NOT NULL)`)}async append(e,t){return this.handle.execute(`INSERT INTO ${h(e)} (payload) VALUES (?)`,[JSON.stringify(t)]).insertId??0}async loadBatch(e,t){let n=this.handle.execute(`SELECT id, payload FROM ${h(e)} ORDER BY id ASC LIMIT ?`,[t]),r=[];for(let t of n.rows??[]){let n=Number(t.id),i;try{i=JSON.parse(String(t.payload))}catch{continue}if(e===`event`&&g(i)){r.push({id:n,channel:e,entry:i});continue}e===`log`&&_(i)&&r.push({id:n,channel:e,entry:i})}return r}async deleteRecords(e,t){if(t.length===0)return;let n=t.map(()=>`?`).join(`, `);this.handle.execute(`DELETE FROM ${h(e)} WHERE id IN (${n})`,t.slice())}async purgeAll(){this.handle.execute(`DELETE FROM ${p}`),this.handle.execute(`DELETE FROM ${m}`)}async count(e){let t=(this.handle.execute(`SELECT COUNT(*) AS count FROM ${h(e)}`).rows??[])[0];return t===void 0?0:Number(t.count)}};exports.FetchTelemetryTransport=r,exports.Logger=a,exports.SqliteOutbox=v,exports.TELEMETRY_EVENT_NAMES=n,exports.TelemetryClient=f,exports.TelemetryErrorBoundary=u,exports.createTelemetryErrorBoundaryElement=d,exports.createTelemetryLogListener=o,exports.installGlobalErrorHandler=l,exports.normalizeErrorValue=i;

package/dist/index.mjs

@@ -0,0 +1 @@
+import{DEFAULT_TELEMETRY_CONSENT as e,INITIAL_COOLDOWN_STATE as t,TELEMETRY_ENDPOINTS as n,assembleEventBatch as r,assembleLogBatch as i,classifyHttpStatus as a,classifyTransportFailure as o,getDeliveryProfile as s,isChannelUploadAllowed as c,registerSendFailure as l,registerSendSuccess as u,sanitizeProperties as d,shouldAttemptSend as f}from"@longzai-intelligence-telemetry/core";import{Component as p,createElement as m}from"react";const h={appLaunch:`app_launch`,appStateChange:`app_state_change`,jsError:`js_error`,previousSessionAbnormalExit:`previous_session_abnormal_exit`};var g=class{baseUrl;timeoutMs;constructor(e){this.baseUrl=e.baseUrl,this.timeoutMs=e.timeoutMs??8e3}sendEventBatch(e){return this.send(n.trackingEventsBatch,e)}sendLogBatch(e){return this.send(n.clientLogsBatch,e)}async send(e,t){let n=new AbortController,r=setTimeout(()=>{n.abort()},this.timeoutMs);try{let r=await fetch(`${this.baseUrl}${e}`,{method:`POST`,headers:{"content-type":`application/json`},body:JSON.stringify(t),signal:n.signal});return a(r.status)}catch{return o()}finally{clearTimeout(r)}}};function _(e){return e instanceof Error?{message:e.message,stack:e.stack??``}:{message:String(e),stack:``}}var v=class{tag;listeners=new Set;constructor(e){this.tag=e}addListener(e){return this.listeners.add(e),()=>{this.listeners.delete(e)}}debug(e){this.dispatch(`debug`,e)}info(e){this.dispatch(`info`,e)}warn(e){this.dispatch(`warn`,e)}error(e){this.dispatch(`error`,e)}dispatch(e,t){let n=_(t),r={level:e,message:n.message,stack:n.stack,tag:this.tag};for(let e of this.listeners)e.log(r)}};function y(e){return{log(t){(t.level===`warn`||t.level===`error`||t.level===`fatal`)&&e.mirrorLog({...t,level:t.level===`fatal`?`error`:t.level})}}}const b=()=>{};function x(){let e=Reflect.get(globalThis,`ErrorUtils`);if(typeof e!=`object`||!e)return;let t=Reflect.get(e,`setGlobalHandler`);if(typeof t==`function`)return{setGlobalHandler:n=>{t.call(e,n)}}}function S(e){let t=e.errorUtils??x();return t===void 0?()=>{}:(t.setGlobalHandler((t,n)=>{let r=_(t);e.onError({...r,isFatal:n})}),()=>{t.setGlobalHandler(b)})}var C=class extends p{state={hasError:!1,error:null};static getDerivedStateFromError(e){return{hasError:!0,error:e}}componentDidCatch(e){this.props.onError?.(e)}render(){return this.state.hasError&&this.state.error!==null?this.props.fallback?.(this.state.error)??null:this.props.children??null}};function w(e){return m(C,e)}var T=class{ports;context;profile;batchEntries;consent;cooldown=t;constructor(t,n,r){this.ports=t,this.context=n,this.profile=s(r?.deliveryMode??`lossless`),this.batchEntries=r?.batchEntries??100,this.consent=r?.consent??e}async track(e,t={},n){if(!c(this.consent,`behavioral-events`))return;let r=d(t,n??Object.keys(t));await this.ports.storage.append(`event`,{name:e,properties:r,occurredAt:this.ports.clock.nowMs()})}async captureError(e,t={}){if(!c(this.consent,`crash-reporting`))return;let n=_(e),r=t.isFatal??!1,i=t.tag??`global`;await this.ports.storage.append(`log`,{level:r?`fatal`:`error`,message:n.message,stack:n.stack,tag:i,occurredAt:this.ports.clock.nowMs()}),await this.ports.storage.append(`event`,{name:h.jsError,properties:{fatal:r,tag:i},occurredAt:this.ports.clock.nowMs()})}async mirrorLog(e,t,n,r){(e===`warn`||e===`error`)&&c(this.consent,`crash-reporting`)&&await this.ports.storage.append(`log`,{level:e,message:t,stack:n,tag:r,occurredAt:this.ports.clock.nowMs()})}async setConsent(e){(!e.crashChannelEnabled||!e.behavioralEventsEnabled)&&await this.ports.storage.purgeAll(),this.consent=e}async flushOnce(){let e=this.ports.clock.nowMs();if(!f(this.cooldown,e))return{eventBatchesSent:0,logBatchesSent:0,blockedByCooldown:!0};let t=await this.runChannel(`event`,e),n=t.aborted?{batchesSent:0,aborted:!0}:await this.runChannel(`log`,e);return{eventBatchesSent:t.batchesSent,logBatchesSent:n.batchesSent,blockedByCooldown:!1}}async runChannel(e,t){let n=0;for(;n<this.profile.maxBatchesPerRun;){let r=await this.ports.storage.loadBatch(e,this.batchEntries);if(r.length===0)break;let i=await this.sendChannelBatch(e,r,t);if(i.outcome===`success`){await this.ports.storage.deleteRecords(e,r.map(e=>e.id)),this.cooldown=u(),n+=1;continue}if(i.outcome===`retryable`)return this.cooldown=l(this.cooldown,t,this.profile.failureCooldownMs),{batchesSent:n,aborted:!0};await this.ports.storage.deleteRecords(e,r.map(e=>e.id)),n+=1}return{batchesSent:n,aborted:!1}}async sendChannelBatch(e,t,n){let a={...this.context,batchedAt:n};if(e===`event`){let n=t.filter(e=>`name`in e.entry).map(t=>({id:t.id,channel:e,entry:t.entry})),i=r(a,n,this.batchEntries);return this.ports.transport.sendEventBatch(i.batch)}let o=t.filter(e=>`level`in e.entry).map(t=>({id:t.id,channel:e,entry:t.entry})),s=i(a,o,this.batchEntries);return this.ports.transport.sendLogBatch(s.batch)}};const E=`telemetry_outbox_events`,D=`telemetry_outbox_logs`;function O(e){return e===`event`?E:D}function k(e){if(typeof e!=`object`||!e)return!1;let t=Reflect.get(e,`name`),n=Reflect.get(e,`occurredAt`);return typeof t==`string`&&typeof n==`number`}function A(e){if(typeof e!=`object`||!e)return!1;let t=Reflect.get(e,`message`),n=Reflect.get(e,`occurredAt`);return typeof t==`string`&&typeof n==`number`}var j=class{handle;constructor(e){this.handle=e,this.handle.execute(`CREATE TABLE IF NOT EXISTS ${E} (id INTEGER PRIMARY KEY AUTOINCREMENT, payload TEXT NOT NULL)`),this.handle.execute(`CREATE TABLE IF NOT EXISTS ${D} (id INTEGER PRIMARY KEY AUTOINCREMENT, payload TEXT NOT NULL)`)}async append(e,t){return this.handle.execute(`INSERT INTO ${O(e)} (payload) VALUES (?)`,[JSON.stringify(t)]).insertId??0}async loadBatch(e,t){let n=this.handle.execute(`SELECT id, payload FROM ${O(e)} ORDER BY id ASC LIMIT ?`,[t]),r=[];for(let t of n.rows??[]){let n=Number(t.id),i;try{i=JSON.parse(String(t.payload))}catch{continue}if(e===`event`&&k(i)){r.push({id:n,channel:e,entry:i});continue}e===`log`&&A(i)&&r.push({id:n,channel:e,entry:i})}return r}async deleteRecords(e,t){if(t.length===0)return;let n=t.map(()=>`?`).join(`, `);this.handle.execute(`DELETE FROM ${O(e)} WHERE id IN (${n})`,t.slice())}async purgeAll(){this.handle.execute(`DELETE FROM ${E}`),this.handle.execute(`DELETE FROM ${D}`)}async count(e){let t=(this.handle.execute(`SELECT COUNT(*) AS count FROM ${O(e)}`).rows??[])[0];return t===void 0?0:Number(t.count)}};export{g as FetchTelemetryTransport,v as Logger,j as SqliteOutbox,h as TELEMETRY_EVENT_NAMES,T as TelemetryClient,C as TelemetryErrorBoundary,w as createTelemetryErrorBoundaryElement,y as createTelemetryLogListener,S as installGlobalErrorHandler,_ as normalizeErrorValue};

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@longzai-intelligence-telemetry/react",
+  "version": "0.0.1",
+  "private": false,
+  "keywords": [
+    "observability",
+    "react",
+    "react-native",
+    "telemetry"
+  ],
+  "license": "UNLICENSED",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "lzi-builder",
+    "build:prod": "NODE_ENV=production bun run build",
+    "prepublishOnly": "bun run build:prod",
+    "typecheck": "bun run typecheck:app && bun run typecheck:node && bun run typecheck:test",
+    "typecheck:app": "lzi-tsgo typecheck tsconfig/app.json",
+    "typecheck:node": "lzi-tsgo typecheck tsconfig/node.json",
+    "typecheck:test": "lzi-tsgo typecheck tsconfig/test.json",
+    "lint": "oxlint && oxfmt --check",
+    "lint:fix": "oxlint --fix && oxfmt",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "test:coverage": "bun test --coverage",
+    "clean": "lzi-dev-cli clean"
+  },
+  "dependencies": {
+    "@longzai-intelligence-telemetry/core": "0.0.1"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.15",
+    "react": "^19.2.6"
+  },
+  "peerDependencies": {
+    "react": ">=19.0.0",
+    "react-native": ">=0.87.0"
+  }
+}