leiao 1.0.0

package/src/update-ui.tsx

@@ -0,0 +1,315 @@
+import {useCallback, useEffect, useState, type ReactNode} from 'react';
+import {
+  ActivityIndicator,
+  Modal,
+  Pressable,
+  StyleSheet,
+  Text,
+  View,
+} from 'react-native';
+import {updates} from './updates';
+import type {PromptTheme, StoreUpdateInfo, UpdateState} from './updates/types';
+
+export type UpdatePromptTheme = PromptTheme;
+
+export type UpdatePromptContext = {
+  info: StoreUpdateInfo;
+  theme: UpdatePromptTheme;
+  busy: boolean;
+  error: string;
+  openStore: () => void;
+  dismiss: () => void;
+};
+
+export type UpdatePromptProps = {
+  /** 不传则跟随控制台「设置 → 通用」里配置的样式。 */
+  theme?: UpdatePromptTheme;
+  children?: ReactNode;
+  render?: (ctx: UpdatePromptContext) => ReactNode;
+  component?: (ctx: UpdatePromptContext) => ReactNode;
+};
+
+function resolveTheme(info: StoreUpdateInfo, fallback?: UpdatePromptTheme): UpdatePromptTheme {
+  if (fallback) {
+    return fallback;
+  }
+  if (info.promptTheme === 'sheet' || info.promptTheme === 'banner' || info.promptTheme === 'dialog') {
+    return info.promptTheme;
+  }
+  return 'dialog';
+}
+
+function BuiltIn({ctx}: {ctx: UpdatePromptContext}) {
+  const {info, theme, busy, error, openStore, dismiss} = ctx;
+  const title = info.mandatory ? '需要更新后才能继续' : '请到商店更新';
+  const version = info.appVersion || '';
+  const primaryLabel = busy ? '正在打开商店' : error ? '重试' : '前往商店';
+  const card = (
+    <View style={[styles.card, theme === 'dialog' && styles.cardDialog, theme === 'sheet' && styles.cardSheet]}>
+      {theme === 'sheet' ? <View style={styles.handle} /> : null}
+      <Text style={styles.kicker}>商店更新</Text>
+      <Text style={styles.title}>{title}</Text>
+      {version ? (
+        <View style={styles.metaRow}>
+          <View style={styles.chip}>
+            <Text style={styles.chipText}>{version}</Text>
+          </View>
+        </View>
+      ) : null}
+      <Text style={styles.notes}>{info.notes || '当前安装的原生版本过旧，请到商店安装新包。'}</Text>
+      <Pressable
+        accessibilityRole="button"
+        disabled={busy}
+        onPress={openStore}
+        style={({pressed}) => [styles.primary, pressed && styles.pressed, busy && styles.disabled]}>
+        {busy ? <ActivityIndicator color="#fff" /> : <Text style={styles.primaryText}>{primaryLabel}</Text>}
+      </Pressable>
+      {error ? <Text style={styles.error}>{error}</Text> : null}
+      {info.mandatory ? null : (
+        <Pressable accessibilityRole="button" disabled={busy} onPress={dismiss} style={styles.ghost}>
+          <Text style={styles.ghostText}>稍后再说</Text>
+        </Pressable>
+      )}
+    </View>
+  );
+
+  if (theme === 'banner') {
+    return (
+      <View style={styles.bannerWrap} pointerEvents="box-none">
+        <View style={styles.banner}>
+          <View style={styles.bannerCopy}>
+            <Text style={styles.bannerTitle}>{title}</Text>
+            <Text style={styles.bannerSub} numberOfLines={1}>
+              商店更新
+              {version ? ` · ${version}` : ''}
+              {info.notes ? ` · ${info.notes}` : ''}
+            </Text>
+          </View>
+          <Pressable
+            accessibilityRole="button"
+            disabled={busy}
+            onPress={openStore}
+            style={({pressed}) => [styles.bannerBtn, pressed && styles.pressed]}>
+            {busy ? <ActivityIndicator color="#fff" size="small" /> : <Text style={styles.bannerBtnText}>{error ? '重试' : '更新'}</Text>}
+          </Pressable>
+          {info.mandatory ? null : (
+            <Pressable accessibilityRole="button" onPress={dismiss} style={styles.bannerSkip}>
+              <Text style={styles.bannerSkipText}>×</Text>
+            </Pressable>
+          )}
+        </View>
+      </View>
+    );
+  }
+
+  return (
+    <Modal visible animationType={theme === 'sheet' ? 'slide' : 'fade'} transparent onRequestClose={info.mandatory ? undefined : dismiss}>
+      <View style={[styles.backdrop, theme === 'sheet' && styles.backdropSheet]}>
+        <Pressable style={StyleSheet.absoluteFill} disabled={info.mandatory || busy} onPress={dismiss} />
+        {card}
+      </View>
+    </Modal>
+  );
+}
+
+/**
+ * 只在整包/商店更新时出现的弹层，样式跟随控制台配置（居中 / 底部卡片 / 顶部条）。
+ * 热更全程静默安装，永远不会经过这里。不自己发请求，只订阅 SDK 状态。
+ */
+export function UpdatePrompt({theme, children, render, component}: UpdatePromptProps) {
+  const [state, setState] = useState<UpdateState>(() => updates.getState());
+  const [busy, setBusy] = useState(false);
+  const [error, setError] = useState('');
+
+  useEffect(() => updates.onState(next => {
+    setState(next);
+    if (next.phase !== 'store-required') {
+      setBusy(false);
+      setError('');
+    }
+  }), []);
+
+  const openStore = useCallback(async () => {
+    if (busy) {
+      return;
+    }
+    setBusy(true);
+    setError('');
+    try {
+      await updates.openStore();
+    } catch (err) {
+      setError(err instanceof Error ? err.message : '打开商店失败，请重试');
+    } finally {
+      setBusy(false);
+    }
+  }, [busy]);
+
+  const dismiss = useCallback(() => {
+    if (busy) {
+      return;
+    }
+    updates.dismiss();
+  }, [busy]);
+
+  const ctx: UpdatePromptContext | null =
+    state.phase === 'store-required'
+      ? {info: state.info, theme: resolveTheme(state.info, theme), busy, error, openStore, dismiss}
+      : null;
+  const custom = ctx ? (render || component)?.(ctx) : null;
+
+  return (
+    <View style={styles.root}>
+      {children}
+      {ctx ? custom ?? <BuiltIn ctx={ctx} /> : null}
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  root: {flex: 1},
+  backdrop: {
+    flex: 1,
+    backgroundColor: 'rgba(15, 17, 21, 0.46)',
+    alignItems: 'center',
+    justifyContent: 'center',
+    padding: 24,
+  },
+  backdropSheet: {
+    justifyContent: 'flex-end',
+    padding: 0,
+  },
+  card: {
+    width: '100%',
+    maxWidth: 420,
+    backgroundColor: '#fff',
+    paddingHorizontal: 22,
+    paddingTop: 22,
+    paddingBottom: 18,
+  },
+  cardDialog: {
+    borderRadius: 20,
+  },
+  cardSheet: {
+    maxWidth: '100%',
+    borderTopLeftRadius: 22,
+    borderTopRightRadius: 22,
+    paddingTop: 10,
+    paddingBottom: 28,
+  },
+  handle: {
+    alignSelf: 'center',
+    width: 36,
+    height: 4,
+    borderRadius: 999,
+    backgroundColor: '#e5e5e5',
+    marginBottom: 16,
+  },
+  kicker: {
+    color: '#8a8f98',
+    fontSize: 12,
+    fontWeight: '600',
+    letterSpacing: 0.4,
+    marginBottom: 6,
+  },
+  title: {
+    color: '#111',
+    fontSize: 22,
+    fontWeight: '700',
+    lineHeight: 28,
+  },
+  metaRow: {
+    flexDirection: 'row',
+    alignItems: 'center',
+    gap: 8,
+    marginTop: 12,
+  },
+  chip: {
+    backgroundColor: '#f4f4f5',
+    borderRadius: 999,
+    paddingHorizontal: 10,
+    paddingVertical: 4,
+  },
+  chipText: {
+    color: '#111',
+    fontSize: 12,
+    fontWeight: '600',
+  },
+  notes: {
+    color: '#4b5563',
+    fontSize: 15,
+    lineHeight: 22,
+    marginTop: 14,
+    marginBottom: 10,
+  },
+  error: {
+    color: '#b42318',
+    fontSize: 13,
+    lineHeight: 18,
+    marginTop: 10,
+    textAlign: 'center',
+  },
+  primary: {
+    height: 48,
+    borderRadius: 12,
+    backgroundColor: '#111',
+    alignItems: 'center',
+    justifyContent: 'center',
+  },
+  primaryText: {
+    color: '#fff',
+    fontSize: 16,
+    fontWeight: '600',
+  },
+  ghost: {
+    height: 44,
+    alignItems: 'center',
+    justifyContent: 'center',
+    marginTop: 4,
+  },
+  ghostText: {
+    color: '#667085',
+    fontSize: 15,
+  },
+  pressed: {opacity: 0.86},
+  disabled: {opacity: 0.7},
+  bannerWrap: {
+    position: 'absolute',
+    left: 12,
+    right: 12,
+    top: 54,
+  },
+  banner: {
+    flexDirection: 'row',
+    alignItems: 'center',
+    gap: 10,
+    backgroundColor: '#111',
+    borderRadius: 16,
+    paddingLeft: 14,
+    paddingRight: 8,
+    paddingVertical: 10,
+    shadowColor: '#000',
+    shadowOpacity: 0.18,
+    shadowRadius: 16,
+    shadowOffset: {width: 0, height: 8},
+    elevation: 6,
+  },
+  bannerCopy: {flex: 1, minWidth: 0},
+  bannerTitle: {color: '#fff', fontSize: 14, fontWeight: '700'},
+  bannerSub: {color: 'rgba(255,255,255,0.72)', fontSize: 12, marginTop: 2},
+  bannerBtn: {
+    backgroundColor: '#fff',
+    borderRadius: 999,
+    paddingHorizontal: 12,
+    minHeight: 32,
+    alignItems: 'center',
+    justifyContent: 'center',
+  },
+  bannerBtnText: {color: '#111', fontSize: 13, fontWeight: '700'},
+  bannerSkip: {
+    width: 28,
+    height: 32,
+    alignItems: 'center',
+    justifyContent: 'center',
+  },
+  bannerSkipText: {color: 'rgba(255,255,255,0.72)', fontSize: 18, lineHeight: 20},
+});

package/src/updates/client.ts

@@ -0,0 +1,50 @@
+import {getConfig} from '../core/config';
+import {request} from '../core/request';
+import {ready as deviceReady} from '../identity';
+import {installedBundleVersion, platformOf} from './native';
+import type {CheckResponse} from './types';
+
+export type ReportStatus = 'downloaded' | 'applied' | 'failed' | 'opened';
+
+/** 调 /v2/check。Web 平台直接返回不支持。 */
+export async function checkUpdate(channel: string): Promise<CheckResponse> {
+  const platform = platformOf();
+  if (platform === 'web') {
+    return {kind: 'none', reason: 'unsupported', notes: '热更新只支持 iOS / Android'};
+  }
+  const config = getConfig();
+  const deviceId = await deviceReady();
+  return request<CheckResponse>('/v2/check', {
+    query: {
+      platform,
+      channel,
+      bundleVersion: await installedBundleVersion(),
+      appVersion: config.appVersion,
+      deviceId,
+    },
+  });
+}
+
+export async function reportUpdate(input: {
+  releaseId?: string;
+  status: ReportStatus;
+  deviceId: string;
+  fromVersion: number;
+  toVersion: number;
+  channel: string;
+  error?: string;
+}): Promise<void> {
+  await request('/v2/ota/report', {
+    method: 'POST',
+    body: {
+      releaseId: input.releaseId,
+      status: input.status,
+      deviceId: input.deviceId,
+      fromVersion: input.fromVersion,
+      toVersion: input.toVersion,
+      platform: platformOf(),
+      channel: input.channel,
+      error: input.error || '',
+    },
+  });
+}

package/src/updates/index.ts

@@ -0,0 +1,162 @@
+import type {HotUpdateOptions, LeiaoConfig} from '../core/config';
+import type {LeiaoModule} from '../core/module';
+import {ready as deviceReady} from '../identity';
+import {checkUpdate, reportUpdate} from './client';
+import {installHotUpdate, restartApp, rollbackBundle} from './installer';
+import {installedBundleVersion, native, platformOf} from './native';
+import {getState, onState, resetState, setState} from './state';
+import {openStoreUrl} from './store';
+import type {CheckResponse, UpdateState, UpdateStateListener} from './types';
+
+/**
+ * 更新模块。热更全程静默：start() 后自动检查、下载、安装。
+ * 只有商店整包更新会进入 store-required 状态，交给 UpdatePrompt 或业务方 UI。
+ */
+class UpdatesModule implements LeiaoModule {
+  private options: HotUpdateOptions = {channel: 'production'};
+  private resumeBound = false;
+  private syncing = false;
+
+  configure(config: LeiaoConfig): void {
+    const given = typeof config.hotUpdate === 'object' ? config.hotUpdate : {};
+    this.options = {channel: 'production', ...given};
+  }
+
+  reset() {
+    this.options = {channel: 'production'};
+    this.resumeBound = false;
+    this.syncing = false;
+    resetState();
+  }
+
+  platform() {
+    return platformOf();
+  }
+
+  channel(): string {
+    return this.options.channel || 'production';
+  }
+
+  getInstalledVersion(): Promise<number> {
+    return installedBundleVersion();
+  }
+
+  getState(): UpdateState {
+    return getState();
+  }
+
+  /** 订阅状态，立即回放当前状态，返回取消函数。 */
+  onState(listener: UpdateStateListener): () => void {
+    return onState(listener);
+  }
+
+  /** 只查不装，不改状态机。 */
+  check(): Promise<CheckResponse> {
+    return checkUpdate(this.channel());
+  }
+
+  /** 驱动状态机走一轮：热更静默安装，商店更新置 store-required。 */
+  async sync(): Promise<UpdateState> {
+    if (this.platform() === 'web' || this.syncing) {
+      return getState();
+    }
+    const phase = getState().phase;
+    if (phase === 'downloading' || phase === 'installing' || phase === 'ready') {
+      return getState();
+    }
+    this.syncing = true;
+    try {
+      setState({phase: 'checking'});
+      const info = await checkUpdate(this.channel());
+      if (info.kind === 'store') {
+        setState({phase: 'store-required', info});
+        return getState();
+      }
+      if (info.kind === 'none') {
+        setState({phase: 'up-to-date', reason: info.reason});
+        return getState();
+      }
+      setState({phase: 'downloading', info, progress: 0});
+      try {
+        await installHotUpdate(info, this.channel(), percent => {
+          if (percent >= 90) {
+            setState({phase: 'installing', info});
+          } else {
+            setState({phase: 'downloading', info, progress: percent});
+          }
+        });
+      } catch (error) {
+        setState({phase: 'error', message: error instanceof Error ? error.message : String(error), info});
+        return getState();
+      }
+      const restart = this.options.restart !== false;
+      setState({phase: 'ready', info, restarting: restart});
+      if (restart) {
+        setTimeout(() => restartApp(), 400);
+      }
+      return getState();
+    } catch (error) {
+      setState({phase: 'error', message: error instanceof Error ? error.message : String(error)});
+      return getState();
+    } finally {
+      this.syncing = false;
+    }
+  }
+
+  /** init 后自动调用：启动即同步，回前台再同步。 */
+  start(): void {
+    if (this.platform() === 'web') {
+      return;
+    }
+    this.sync().catch(() => undefined);
+    const rn = native();
+    if (this.resumeBound || !rn?.AppState) {
+      return;
+    }
+    this.resumeBound = true;
+    rn.AppState.addEventListener('change', (state: string) => {
+      if (state === 'active') {
+        this.sync().catch(() => undefined);
+      }
+    });
+  }
+
+  /** 打开商店。不传 url 时用当前 store-required 状态里的地址。 */
+  async openStore(url?: string): Promise<void> {
+    const state = getState();
+    const info = state.phase === 'store-required' ? state.info : null;
+    const target = url || info?.storeUrl || '';
+    await openStoreUrl(target);
+    if (info) {
+      const deviceId = info.deviceId || (await deviceReady());
+      const fromVersion = await installedBundleVersion();
+      await reportUpdate({
+        releaseId: info.releaseId,
+        status: 'opened',
+        deviceId,
+        fromVersion,
+        toVersion: 0,
+        channel: this.channel(),
+      }).catch(() => undefined);
+    }
+  }
+
+  /** 关掉商店更新提示（强制更新时无效）。 */
+  dismiss(): void {
+    const state = getState();
+    if (state.phase === 'store-required' && !state.info.mandatory) {
+      setState({phase: 'idle'});
+    }
+  }
+
+  restart(): void {
+    restartApp();
+  }
+
+  rollback(): Promise<void> {
+    return rollbackBundle();
+  }
+}
+
+export const updates = new UpdatesModule();
+export type {CheckResponse, HotUpdateInfo, NoUpdateInfo, PromptTheme, StoreUpdateInfo, UpdateState, UpdateStateListener} from './types';

package/src/updates/installer.ts

@@ -0,0 +1,130 @@
+import {getConfig} from '../core/config';
+import {ready as deviceReady} from '../identity';
+import {reportUpdate} from './client';
+import {blobUtil, installedBundleVersion, nativeHotUpdate} from './native';
+import type {HotUpdateInfo} from './types';
+
+// React Native 全局提供 XMLHttpRequest，服务端 tsconfig 没有 DOM lib
+declare const XMLHttpRequest: {
+  new (): {
+    open(method: string, url: string, async: boolean): void;
+    responseType: string;
+    timeout: number;
+    status: number;
+    response: unknown;
+    onload: (() => void) | null;
+    ontimeout: (() => void) | null;
+    onerror: (() => void) | null;
+    send(): void;
+  };
+};
+
+function bytesToBase64(bytes: Uint8Array): string {
+  let binary = '';
+  const chunk = 0x8000;
+  for (let i = 0; i < bytes.length; i += chunk) {
+    binary += String.fromCharCode(...bytes.subarray(i, i + chunk));
+  }
+  return btoa(binary);
+}
+
+async function downloadBytes(url: string, timeoutMs: number, attempts = 3): Promise<Uint8Array> {
+  let last: Error | undefined;
+  for (let index = 0; index < attempts; index += 1) {
+    try {
+      return await downloadOnce(url, timeoutMs);
+    } catch (error) {
+      last = error instanceof Error ? error : new Error('下载失败');
+      if (index < attempts - 1) {
+        await new Promise(resolve => setTimeout(resolve, 400 * (index + 1)));
+      }
+    }
+  }
+  throw last || new Error('下载失败');
+}
+
+function downloadOnce(url: string, timeoutMs: number): Promise<Uint8Array> {
+  return new Promise((resolve, reject) => {
+    const xhr = new XMLHttpRequest();
+    xhr.open('GET', url, true);
+    xhr.responseType = 'arraybuffer';
+    xhr.timeout = timeoutMs;
+    xhr.onload = () => {
+      if (xhr.status >= 200 && xhr.status < 300 && xhr.response) {
+        resolve(new Uint8Array(xhr.response as ArrayBuffer));
+        return;
+      }
+      reject(new Error(`下载失败 HTTP ${xhr.status || 0}`));
+    };
+    xhr.ontimeout = () => reject(new Error('下载超时'));
+    xhr.onerror = () => reject(new Error('下载失败'));
+    xhr.send();
+  });
+}
+
+/** 下载 → 校验 → 安装热更包。进度回调 0-100。安装成功后由调用方决定是否重启。 */
+export async function installHotUpdate(
+  info: HotUpdateInfo,
+  channel: string,
+  onProgress: (percent: number) => void,
+): Promise<void> {
+  if (!info.downloadUrl) {
+    throw new Error('没有可下载的热更包');
+  }
+  const config = getConfig();
+  const deviceId = info.deviceId || (await deviceReady());
+  const fromVersion = await installedBundleVersion();
+  let finished = false;
+  try {
+    onProgress(1);
+    const bytes = await downloadBytes(info.downloadUrl, Math.max(config.timeoutMs || 12000, 30000));
+    onProgress(80);
+    await reportUpdate({releaseId: info.releaseId, status: 'downloaded', deviceId, fromVersion, toVersion: info.bundleVersion, channel});
+    const ReactNativeBlobUtil = blobUtil();
+    const dest = `${ReactNativeBlobUtil.fs.dirs.CacheDir}/${Date.now()}_hotupdate.zip`;
+    await ReactNativeBlobUtil.fs.writeFile(dest, bytesToBase64(bytes), 'base64');
+    onProgress(90);
+    if (info.sha256) {
+      const hash = String(await ReactNativeBlobUtil.fs.hash(dest, 'sha256')).toLowerCase();
+      if (hash !== info.sha256.toLowerCase()) {
+        throw new Error('热更包校验失败，未安装');
+      }
+    }
+    const nativeOta = nativeHotUpdate();
+    const ok = await nativeOta.setupBundlePath(dest, undefined, info.bundleVersion, 3, {
+      notes: info.notes,
+      sha256: info.sha256,
+    });
+    if (!ok) {
+      throw new Error('安装热更包失败');
+    }
+    await nativeOta.setCurrentVersion(info.bundleVersion);
+    onProgress(100);
+    await reportUpdate({releaseId: info.releaseId, status: 'applied', deviceId, fromVersion, toVersion: info.bundleVersion, channel});
+    finished = true;
+  } catch (error) {
+    if (!finished) {
+      const message = error instanceof Error ? error.message : String(error);
+      await reportUpdate({
+        releaseId: info.releaseId,
+        status: 'failed',
+        deviceId,
+        fromVersion,
+        toVersion: info.bundleVersion,
+        channel,
+        error: message,
+      }).catch(() => undefined);
+    }
+    throw error;
+  }
+}
+
+export function restartApp() {
+  nativeHotUpdate().resetApp();
+}
+
+export async function rollbackBundle(): Promise<void> {
+  const nativeOta = nativeHotUpdate();
+  await nativeOta.rollbackToPreviousBundle();
+  nativeOta.resetApp();
+}

package/src/updates/native.ts

@@ -0,0 +1,53 @@
+export function native(): {
+  Platform?: {OS: string};
+  AppState?: {addEventListener: Function};
+  Linking?: {canOpenURL?: (href: string) => Promise<boolean>; openURL: (href: string) => Promise<void>};
+} | null {
+  try {
+    return require('react-native');
+  } catch {
+    return null;
+  }
+}
+
+export function nativeHotUpdate() {
+  return require('react-native-ota-hot-update').default;
+}
+
+export function blobUtil() {
+  return require('react-native-blob-util').default;
+}
+
+/** 测试钩子：在没有 React Native 的环境里模拟平台与已装版本。 */
+export const nativeHooks: {
+  platform: (() => 'ios' | 'android' | 'web') | null;
+  installedVersion: (() => Promise<number>) | null;
+} = {
+  platform: null,
+  installedVersion: null,
+};
+
+export function platformOf(): 'ios' | 'android' | 'web' {
+  if (nativeHooks.platform) {
+    return nativeHooks.platform();
+  }
+  const rn = native();
+  if (!rn?.Platform) {
+    return 'web';
+  }
+  return rn.Platform.OS === 'android' ? 'android' : rn.Platform.OS === 'ios' ? 'ios' : 'web';
+}
+
+export async function installedBundleVersion(): Promise<number> {
+  if (nativeHooks.installedVersion) {
+    return nativeHooks.installedVersion();
+  }
+  if (!native()) {
+    return 0;
+  }
+  try {
+    return Number(await nativeHotUpdate().getCurrentVersion()) || 0;
+  } catch {
+    return 0;
+  }
+}