rn-update 1.0.0

package/src/errorReporting.ts

@@ -0,0 +1,141 @@
+/**
+ * [INPUT]: 依赖全局 ErrorUtils 错误处理链与调用方传入的 error/componentStack/extra 上下文
+ * [OUTPUT]: 提供 serializeException 限长序列化与 installGlobalErrorHandler 链式全局错误捕获
+ * [POS]: src 的错误上报基础层，为客户端遥测链提供可安全外发的异常快照
+ */
+export type ErrorContextValue = string | number | boolean | null;
+
+export interface ErrorReportContext {
+  fatal?: boolean;
+  componentStack?: string;
+  extra?: Record<string, ErrorContextValue>;
+}
+
+export interface ErrorReportingOptions {
+  /** Install a chained React Native ErrorUtils handler. Default: true. */
+  captureGlobal?: boolean;
+}
+
+export interface SerializedException {
+  name: string;
+  message: string;
+  stack: string;
+  fatal: boolean;
+  componentStack?: string;
+  extra?: Record<string, ErrorContextValue>;
+}
+
+const MAX_NAME = 128;
+const MAX_MESSAGE = 2 * 1024;
+const MAX_STACK = 32 * 1024;
+const MAX_COMPONENT_STACK = 16 * 1024;
+const MAX_EXTRA_FIELDS = 32;
+const MAX_EXTRA_KEY = 64;
+const MAX_EXTRA_STRING = 1024;
+const MAX_EXTRA_JSON = 8 * 1024;
+
+const boundedString = (value: unknown, maximum: number) =>
+  typeof value === 'string' ? value.slice(0, maximum) : '';
+
+const normalizeExtra = (
+  extra?: Record<string, ErrorContextValue>
+): Record<string, ErrorContextValue> | undefined => {
+  if (!extra || typeof extra !== 'object') {
+    return undefined;
+  }
+  const result: Record<string, ErrorContextValue> = {};
+  for (const [rawKey, value] of Object.entries(extra).slice(
+    0,
+    MAX_EXTRA_FIELDS
+  )) {
+    const key = rawKey.slice(0, MAX_EXTRA_KEY);
+    if (!key) {
+      continue;
+    }
+    if (typeof value === 'string') {
+      result[key] = value.slice(0, MAX_EXTRA_STRING);
+    } else if (
+      value === null ||
+      typeof value === 'boolean' ||
+      (typeof value === 'number' && Number.isFinite(value))
+    ) {
+      result[key] = value;
+    }
+    // Keep the client comfortably inside the server's byte cap. The server
+    // remains authoritative because JS string length is not UTF-8 byte length.
+    if (JSON.stringify(result).length > MAX_EXTRA_JSON) {
+      delete result[key];
+      break;
+    }
+  }
+  return Object.keys(result).length > 0 ? result : undefined;
+};
+
+export const serializeException = (
+  error: unknown,
+  context: ErrorReportContext = {}
+): SerializedException => {
+  const source =
+    error !== null && (typeof error === 'object' || typeof error === 'function')
+      ? (error as Record<string, unknown>)
+      : undefined;
+  const name = boundedString(source?.name, MAX_NAME).trim() || 'Error';
+  const message = (
+    boundedString(source?.message, MAX_MESSAGE) || String(error ?? '')
+  ).slice(0, MAX_MESSAGE);
+  const stack =
+    boundedString(source?.stack, MAX_STACK) || `${name}: ${message}`;
+  const componentStack = boundedString(
+    context.componentStack,
+    MAX_COMPONENT_STACK
+  );
+  const extra = normalizeExtra(context.extra);
+  return {
+    name,
+    message,
+    stack,
+    fatal: context.fatal === true,
+    ...(componentStack ? { componentStack } : {}),
+    ...(extra ? { extra } : {}),
+  };
+};
+
+type GlobalErrorHandler = (error: unknown, isFatal?: boolean) => void;
+
+interface GlobalErrorUtils {
+  getGlobalHandler?: () => GlobalErrorHandler;
+  setGlobalHandler?: (handler: GlobalErrorHandler) => void;
+}
+
+/**
+ * Install a React Native global error wrapper without taking ownership away
+ * from ExceptionsManager, Sentry, Crashlytics, or a handler installed later.
+ */
+export const installGlobalErrorHandler = (
+  capture: GlobalErrorHandler
+): (() => void) => {
+  const errorUtils = (globalThis as any).ErrorUtils as
+    | GlobalErrorUtils
+    | undefined;
+  if (
+    typeof errorUtils?.getGlobalHandler !== 'function' ||
+    typeof errorUtils.setGlobalHandler !== 'function'
+  ) {
+    return () => {};
+  }
+  const previous = errorUtils.getGlobalHandler();
+  const wrapper: GlobalErrorHandler = (error, isFatal) => {
+    try {
+      capture(error, isFatal);
+    } catch {
+      // Reporting must never alter React Native's original failure path.
+    }
+    previous?.(error, isFatal);
+  };
+  errorUtils.setGlobalHandler(wrapper);
+  return () => {
+    if (errorUtils.getGlobalHandler?.() === wrapper) {
+      errorUtils.setGlobalHandler?.(previous);
+    }
+  };
+};

package/src/globals.d.ts

@@ -0,0 +1,6 @@
+/**
+ * [INPUT]: 依赖 Metro/React Native 在运行时注入的开发模式标志
+ * [OUTPUT]: 对 TypeScript 全局提供只读的 __DEV__ 布尔声明
+ * [POS]: src 的编译环境契约，使业务代码无需污染模块依赖即可安全分支开发态行为
+ */
+declare const __DEV__: boolean;

package/src/i18n.ts

@@ -0,0 +1,113 @@
+/**
+ * [INPUT]: 依赖 locales/en 与 locales/zh 的同构翻译字典
+ * [OUTPUT]: 对外提供 I18n 类、i18n 单例及默认导出，支持语言切换、键回退和模板插值
+ * [POS]: src 的轻量国际化服务，被客户端、Provider、错误提示和日志消费，不引入第三方运行时
+ */
+import enTranslations from './locales/en';
+import zhTranslations from './locales/zh';
+
+type TranslationKey = keyof typeof zhTranslations | keyof typeof enTranslations;
+type TranslationValues = Record<string, string | number>;
+
+class I18n {
+  private currentLocale: 'zh' | 'en' = 'en';
+  private translations = {
+    zh: zhTranslations,
+    en: enTranslations,
+  };
+
+  /**
+   * Set locale directly
+   * @param locale - 'zh' or 'en'
+   */
+  setLocale(locale: 'zh' | 'en') {
+    this.currentLocale = locale;
+  }
+
+  /**
+   * Get current locale
+   */
+  getLocale(): 'zh' | 'en' {
+    return this.currentLocale;
+  }
+
+  /**
+   * Translate a key with optional interpolation
+   * @param key - Translation key
+   * @param values - Values for interpolation (optional)
+   * @returns Translated string with interpolated values
+   */
+  t(key: TranslationKey, values?: TranslationValues): string {
+    const translation =
+      this.translations[this.currentLocale][
+        key as keyof (typeof this.translations)[typeof this.currentLocale]
+      ];
+
+    if (!translation) {
+      // Fallback to the other locale if key not found
+      const fallbackLocale = this.currentLocale === 'zh' ? 'en' : 'zh';
+      const fallbackTranslation =
+        this.translations[fallbackLocale][
+          key as keyof (typeof this.translations)[typeof fallbackLocale]
+        ];
+
+      if (!fallbackTranslation) {
+        // If still not found, return the key itself
+        return String(key);
+      }
+
+      return this.interpolate(fallbackTranslation, values);
+    }
+
+    return this.interpolate(translation, values);
+  }
+
+  /**
+   * Interpolate values into a string template
+   * Supports {{key}} syntax
+   * @param template - String template with {{key}} placeholders
+   * @param values - Values to interpolate
+   * @returns Interpolated string
+   */
+  private interpolate(template: string, values?: TranslationValues): string {
+    if (!values) {
+      return template;
+    }
+
+    return template.replace(/\{\{(\w+)\}\}/g, (match, key) => {
+      const value = values[key];
+      return value !== undefined ? String(value) : match;
+    });
+  }
+
+  /**
+   * Add or update translations for a specific locale
+   * @param locale - Target locale
+   * @param translations - Translation object to merge
+   */
+  addTranslations(locale: 'zh' | 'en', translations: Record<string, string>) {
+    this.translations[locale] = {
+      ...this.translations[locale],
+      ...translations,
+    };
+  }
+}
+
+// Create singleton instance
+const i18n = new I18n();
+
+// Export both the instance and the class for flexibility
+export { I18n, i18n };
+export default i18n;
+
+/**
+ * Usage examples:
+ *
+ * // Direct locale setting (new preferred method)
+ * i18n.setLocale('zh'); // Chinese
+ * i18n.setLocale('en'); // English
+ *
+ * // Get translations
+ * i18n.t('checking_update'); // Based on current locale
+ * i18n.t('download_progress', { progress: 50 }); // With interpolation
+ */

package/src/index.ts

@@ -0,0 +1,46 @@
+/**
+ * [INPUT]: 依赖 client、context、core、error 与 provider 已稳定的公开契约
+ * [OUTPUT]: 对外提供 npm 包支持的 Pakta 客户端、Provider、Context/hooks、原生模块与错误 API
+ * [POS]: src 的唯一公共门面，隔离内部文件布局，消费端应从包入口而非深路径导入
+ */
+export type { UpdateErrorListener } from './client';
+export { Pakta } from './client';
+export type { UpdateContextValue } from './context';
+export {
+  ProgressContext,
+  UpdateContext,
+  usePakta,
+  useUpdate,
+  useUpdateProgress,
+} from './context';
+export { buildTime, channel, PaktaModule, UpdateModule } from './core';
+export type { UpdateErrorCode } from './error';
+export { UpdateError } from './error';
+export type {
+  ErrorContextValue,
+  ErrorReportContext,
+  ErrorReportingOptions,
+  SerializedException,
+} from './errorReporting';
+export type { CrashReporterLike, UpdateMetadata } from './metadata';
+export {
+  attachToCrashlytics,
+  attachToSentry,
+  attachUpdateMetadata,
+  getUpdateMetadata,
+  updateMetadataTags,
+} from './metadata';
+export { PaktaProvider, UpdateProvider } from './provider';
+export type {
+  BeforeReloadContext,
+  CheckResult,
+  ClientOptions,
+  EventData,
+  EventType,
+  ProgressData,
+  UpdateCheckState,
+  UpdateEventsLogger,
+  UpdateServerConfig,
+  UpdateTestPayload,
+  VersionInfo,
+} from './type';

package/src/locales/en.ts

@@ -0,0 +1,77 @@
+/**
+ * [INPUT]: 不依赖运行时代码，键集合需与中文字典和 i18n 调用保持兼容
+ * [OUTPUT]: 默认导出英文界面、错误、日志与更新流程文案字典
+ * [POS]: src/locales 的英文语义数据源，由 i18n.ts 装载，禁止在此执行格式化或平台判断
+ */
+export default {
+  // Common messages
+  checking_update: 'Checking for updates...',
+  update_failed: 'Update failed',
+
+  // Progress messages with interpolation
+  download_progress: 'Download progress: {{progress}}%',
+
+  // Alert messages
+  alert_title: 'Notice',
+  alert_update_ready: 'Download completed. Update now?',
+  alert_next_time: 'Later',
+  alert_update_now: 'Update Now',
+  alert_app_updated:
+    'Your app version has been updated. Click update to download and install the new version',
+  alert_update_button: 'Update',
+  alert_cancel: 'Cancel',
+  alert_confirm: 'OK',
+  alert_info: 'Info',
+  alert_no_update_wait:
+    'No update found, please wait 10s for the server to generate the patch package',
+
+  // Error messages
+  error_appkey_required: 'appKey is required',
+  error_no_endpoints: 'No update server endpoints configured',
+  error_client_singleton:
+    'A second update client was created: the SDK is a process-level singleton — create one client and reuse it everywhere (use client.setOptions to change options at runtime)',
+  error_provider_singleton:
+    'A second UpdateProvider was mounted: make sure the app renders exactly one UpdateProvider',
+  error_parse_version_info: 'Failed to parse currentVersionInfo: {{info}}',
+  warn_unknown_bundle:
+    'The bundle embedded in this binary is not registered on the update platform; incremental updates are degraded to full downloads. Upload the package with pakta uploadIpa / uploadApk / uploadApp.',
+  error_update_check_failed: 'Update check failed',
+  error_cannot_connect_server:
+    'Can not connect to update server. Please check your network.',
+  error_cannot_connect_backup:
+    'Can not connect to update server: {{message}}. Trying backup endpoints.',
+  error_diff_failed: 'diff error: {{message}}',
+  error_pdiff_failed: 'pdiff error: {{message}}',
+  error_full_patch_failed: 'full patch error: {{message}}',
+  error_all_promises_rejected: 'All promises were rejected',
+  error_ping_failed: 'Ping failed',
+  error_ping_timeout: 'Ping timeout',
+  error_insecure_redirect:
+    'Request was redirected from https to plaintext http',
+  error_invalid_check_response: 'Update check response is not a valid verdict',
+  error_http_status: '{{status}} {{statusText}}',
+  error_apk_pending_install:
+    'The APK has been downloaded, please complete the installation in the system installer',
+  error_apk_download_failed: 'Failed to download or install the APK',
+  error_reset_not_supported:
+    'resetToPackagedBundle is not available in the installed native module. Please rebuild the app with the latest rn-update.',
+
+  // Development messages
+  dev_debug_disabled:
+    'You are currently in the development environment and have not enabled debug mode. {{matter}} will not be performed. If you need to debug {{matter}} in the development environment, please set debug to true in the client.',
+  dev_log_prefix: 'rn-update: ',
+  dev_web_not_supported:
+    'rn-update does not support the Web platform and will not perform any operations',
+
+  // More alert messages
+  alert_new_version_found:
+    'New version {{name}} found. Download now?\n{{description}}',
+
+  // Development environment messages
+  dev_incremental_update_disabled:
+    'Currently in development environment, incremental hot update cannot be executed and restart will not take effect. If you need to test effective full hot update in development environment (but will reconnect to metro after restart), please enable "ignore timestamp" in app settings in admin dashboard and retry.',
+
+  // Context error messages
+  error_use_update_outside_provider:
+    'useUpdate must be used within an UpdateProvider. Please wrap your component tree with <UpdateProvider client={...}>.',
+};

package/src/locales/zh.ts

@@ -0,0 +1,71 @@
+/**
+ * [INPUT]: 不依赖运行时代码，键集合需与英文字典和 i18n 调用保持兼容
+ * [OUTPUT]: 默认导出中文界面、错误、日志与更新流程文案字典
+ * [POS]: src/locales 的中文语义数据源，由 i18n.ts 装载，作为翻译键类型推导的一部分
+ */
+export default {
+  // Common messages
+  checking_update: '正在检查更新...',
+  update_failed: '更新失败',
+
+  // Progress messages with interpolation
+  download_progress: '下载进度: {{progress}}%',
+
+  // Alert messages
+  alert_title: '提示',
+  alert_update_ready: '下载完毕，是否立即更新?',
+  alert_next_time: '下次再说',
+  alert_update_now: '立即更新',
+  alert_app_updated: '您的应用版本已更新，点击更新下载安装新版本',
+  alert_update_button: '更新',
+  alert_cancel: '取消',
+  alert_confirm: '确定',
+  alert_info: '信息',
+  alert_no_update_wait: '未发现更新，请等待10秒让服务器生成补丁包',
+
+  // Error messages
+  error_appkey_required: '需要提供 appKey',
+  error_no_endpoints: '未配置更新服务器端点',
+  error_client_singleton:
+    '检测到重复创建热更新 client：SDK 是进程级单例，请只创建一个 client 并在全局复用（运行期改配置请调用 client.setOptions）',
+  error_provider_singleton:
+    '检测到同时挂载多个 UpdateProvider：请确保应用中只有一个 UpdateProvider',
+  error_parse_version_info: '解析 currentVersionInfo 失败: {{info}}',
+  warn_unknown_bundle:
+    '当前二进制内嵌 bundle 未在更新平台注册，增量更新已降级为全量。请使用 pakta uploadIpa / uploadApk / uploadApp 上传对应安装包。',
+  error_update_check_failed: '更新检查失败',
+  error_cannot_connect_server: '无法连接到更新服务器。请检查网络连接。',
+  error_cannot_connect_backup:
+    '无法连接到更新服务器: {{message}}。正在尝试备用端点。',
+  error_diff_failed: 'diff 错误: {{message}}',
+  error_pdiff_failed: 'pdiff 错误: {{message}}',
+  error_full_patch_failed: '完整补丁错误: {{message}}',
+  error_all_promises_rejected: '所有请求都被拒绝',
+  error_ping_failed: 'Ping 失败',
+  error_ping_timeout: 'Ping 超时',
+  error_insecure_redirect: '请求被从 https 重定向到明文 http',
+  error_invalid_check_response: '更新检查响应不是有效结果',
+  error_http_status: '{{status}} {{statusText}}',
+  error_apk_pending_install: '安装包已下载完成，请在系统安装界面完成安装',
+  error_apk_download_failed: '安装包下载或安装失败',
+  error_reset_not_supported:
+    '当前安装的原生模块不支持 resetToPackagedBundle，请使用最新版 rn-update 重新打包后再试。',
+
+  // Development messages
+  dev_debug_disabled:
+    '您当前处于开发环境且未启用调试模式。{{matter}} 将不会执行。如需在开发环境中调试 {{matter}}，请在客户端中将 debug 设为 true。',
+  dev_log_prefix: 'rn-update: ',
+  dev_web_not_supported: 'rn-update 不支持 Web 平台，不会执行任何操作',
+
+  // More alert messages
+  alert_new_version_found:
+    '检查到新的版本{{name}}，是否下载？\n{{description}}',
+
+  // Development environment messages
+  dev_incremental_update_disabled:
+    '当前是开发环境，无法执行增量式热更新，重启不会生效。如果需要在开发环境中测试可生效的全量热更新（但也会在再次重启后重新连接 metro），请在网页管理后台的应用设置中打开"忽略时间戳"开关再重试。',
+
+  // Context error messages
+  error_use_update_outside_provider:
+    'useUpdate 必须在 UpdateProvider 内部使用。请使用 <UpdateProvider client={...}> 包裹您的组件树。',
+};

package/src/metadata.ts

@@ -0,0 +1,175 @@
+/**
+ * [INPUT]: 依赖 core 冻结的启动身份（cInfo/packageVersion/buildTime/currentVersion 等安装记录）
+ * [OUTPUT]: 提供 getUpdateMetadata、updateMetadataTags、attachUpdateMetadata 及 Sentry/Crashlytics 便捷封装
+ * [POS]: src 的崩溃报告元数据桥，把运行中 bundle 身份映射到外部崩溃平台的 tag/context
+ */
+import {
+  buildTime,
+  channel,
+  cInfo,
+  currentBundleSha256,
+  currentVersion,
+  currentVersionInfo,
+  getBundleHash,
+  isFirstTime,
+  isRolledBack,
+  packageVersion,
+  rolledBackVersion,
+} from './core';
+
+/**
+ * Everything a crash report needs to be mapped back to the exact JS bundle
+ * that was running: attach it as tags/context in Sentry, Crashlytics, Bugly…
+ * The `currentVersion` hash (empty = the binary's embedded bundle) is the
+ * key that selects the matching source map on the update platform.
+ */
+export interface UpdateMetadata {
+  /** rn-update SDK version. */
+  sdkVersion: string;
+  /** Native binary version the update decision is keyed on. */
+  packageVersion: string;
+  /** Build time of the native binary (empty in debug). */
+  buildTime: string;
+  /** Immutable distribution channel from the native package. */
+  channel: string;
+  /** Hash of the running hot-update version; '' when the embedded bundle runs. */
+  currentVersion: string;
+  /** Publisher-facing name/description/metaInfo of the running version. */
+  versionName: string;
+  versionDescription: string;
+  metaInfo: string;
+  /** SHA-256 of the embedded bundle; '' until computed / unavailable. */
+  bundleHash: string;
+  /**
+   * SHA-256 of the running hot-update bundle from its install record
+   * (matches the `bundleSha256` the CLI archives with the source map); ''
+   * for the embedded bundle or a legacy install.
+   */
+  bundleSha256: string;
+  /** First launch of `currentVersion` (crash protection still armed). */
+  isFirstTime: boolean;
+  /** This launch is the result of a rollback; `rolledBackVersion` names the culprit. */
+  isRolledBack: boolean;
+  rolledBackVersion: string;
+  /**
+   * How the running version got activated when not by the JS flow:
+   * 'forceBoot' — the server's per-version override applied by the native
+   * cold-start check; 'crashRescue' — activated by the crash-time rescue.
+   */
+  rescueSource: 'forceBoot' | 'crashRescue' | null;
+  /** Stable per-install client id (gray-release bucketing key). */
+  uuid: string;
+  os: string;
+}
+
+export function getUpdateMetadata(): UpdateMetadata {
+  const info = currentVersionInfo || {};
+  return {
+    sdkVersion: cInfo.rnu,
+    packageVersion,
+    buildTime,
+    channel,
+    currentVersion: currentVersion || '',
+    versionName: typeof info.name === 'string' ? info.name : '',
+    versionDescription:
+      typeof info.description === 'string' ? info.description : '',
+    metaInfo: typeof info.metaInfo === 'string' ? info.metaInfo : '',
+    bundleHash: getBundleHash(),
+    bundleSha256: currentBundleSha256 || '',
+    isFirstTime,
+    isRolledBack,
+    rolledBackVersion: rolledBackVersion || '',
+    rescueSource: info.forceBootRescue
+      ? 'forceBoot'
+      : info.crashRescue
+        ? 'crashRescue'
+        : null,
+    uuid: cInfo.uuid,
+    os: cInfo.os,
+  };
+}
+
+/**
+ * The duck-typed surface of a crash reporter. Sentry exposes setTag/setContext,
+ * Firebase Crashlytics setAttributes/setAttribute; any object with one of
+ * those works.
+ */
+export interface CrashReporterLike {
+  setTag?: (key: string, value: string) => unknown;
+  setContext?: (
+    name: string,
+    context: Record<string, unknown> | null
+  ) => unknown;
+  setAttributes?: (attributes: Record<string, string>) => unknown;
+  setAttribute?: (key: string, value: string) => unknown;
+}
+
+/** Flat string tags (`pakta.currentVersion` …) for the running update. */
+export function updateMetadataTags(
+  metadata: UpdateMetadata = getUpdateMetadata(),
+  prefix = 'pakta.'
+): Record<string, string> {
+  const tags: Record<string, string> = {};
+  for (const [key, value] of Object.entries(metadata)) {
+    tags[`${prefix}${key}`] =
+      value === null || value === undefined ? '' : String(value);
+  }
+  return tags;
+}
+
+/**
+ * Attach the running update's metadata to a crash reporter so every event can
+ * be mapped to the exact bundle (and source map) it came from. Call once after
+ * the reporter is initialised; safe to call again (e.g. after markSuccess).
+ * Every reporter method is optional and failures are swallowed — a reporting
+ * hiccup must never break the app.
+ */
+export function attachUpdateMetadata(
+  reporter: CrashReporterLike,
+  options: { prefix?: string; contextName?: string | null } = {}
+): UpdateMetadata {
+  const metadata = getUpdateMetadata();
+  const tags = updateMetadataTags(metadata, options.prefix ?? 'pakta.');
+  const swallow = (fn: () => unknown) => {
+    try {
+      const result = fn();
+      if (result && typeof (result as Promise<unknown>).catch === 'function') {
+        (result as Promise<unknown>).catch(() => {});
+      }
+    } catch {
+      // never let a reporter failure propagate
+    }
+  };
+  if (typeof reporter.setTag === 'function') {
+    for (const [key, value] of Object.entries(tags)) {
+      swallow(() => reporter.setTag?.(key, value));
+    }
+  } else if (typeof reporter.setAttributes === 'function') {
+    swallow(() => reporter.setAttributes?.(tags));
+  } else if (typeof reporter.setAttribute === 'function') {
+    for (const [key, value] of Object.entries(tags)) {
+      swallow(() => reporter.setAttribute?.(key, value));
+    }
+  }
+  if (
+    options.contextName !== null &&
+    typeof reporter.setContext === 'function'
+  ) {
+    swallow(() =>
+      reporter.setContext?.(options.contextName ?? 'pakta', { ...metadata })
+    );
+  }
+  return metadata;
+}
+
+/** `attachUpdateMetadata` for `@sentry/react-native` (tags + a `pakta` context). */
+export function attachToSentry(sentry: CrashReporterLike): UpdateMetadata {
+  return attachUpdateMetadata(sentry, { contextName: 'pakta' });
+}
+
+/** `attachUpdateMetadata` for `@react-native-firebase/crashlytics` (custom keys). */
+export function attachToCrashlytics(
+  crashlytics: CrashReporterLike
+): UpdateMetadata {
+  return attachUpdateMetadata(crashlytics, { contextName: null });
+}