leiao 1.0.0

package/src/updates/state.ts

@@ -0,0 +1,37 @@
+import type {UpdateState, UpdateStateListener} from './types';
+
+let current: UpdateState = {phase: 'idle'};
+const listeners = new Set<UpdateStateListener>();
+
+export function getState(): UpdateState {
+  return current;
+}
+
+export function setState(next: UpdateState) {
+  current = next;
+  for (const listener of listeners) {
+    try {
+      listener(current);
+    } catch {
+      // 订阅方异常不影响状态机
+    }
+  }
+}
+
+/** 订阅状态变化，立即回放一次当前状态。返回取消函数。 */
+export function onState(listener: UpdateStateListener): () => void {
+  listeners.add(listener);
+  try {
+    listener(current);
+  } catch {
+    // 同上
+  }
+  return () => {
+    listeners.delete(listener);
+  };
+}
+
+export function resetState() {
+  current = {phase: 'idle'};
+  listeners.clear();
+}

package/src/updates/store.ts

@@ -0,0 +1,43 @@
+import {native, platformOf} from './native';
+
+/** 打开商店：优先原生商店 scheme，回落 https。 */
+export async function openStoreUrl(url: string): Promise<void> {
+  const target = String(url || '').trim();
+  if (!target) {
+    throw new Error('没有商店地址');
+  }
+  const Linking = native()?.Linking;
+  if (!Linking) {
+    throw new Error('当前环境不能打开商店');
+  }
+  const candidates: string[] = [];
+  const platform = platformOf();
+  if (platform === 'ios') {
+    const storeId = target.match(/id(\d+)/)?.[1] || (/^\d+$/.test(target) ? target : '');
+    if (storeId) {
+      candidates.push(`itms-apps://itunes.apple.com/app/id${storeId}`);
+      candidates.push(`https://apps.apple.com/app/id${storeId}`);
+    }
+  }
+  if (platform === 'android') {
+    const pkg = target.match(/[?&]id=([^&]+)/)?.[1] || '';
+    if (pkg) {
+      candidates.push(`market://details?id=${pkg}`);
+    }
+  }
+  if (!candidates.includes(target)) {
+    candidates.push(target);
+  }
+  for (const href of candidates) {
+    try {
+      const ok = Linking.canOpenURL ? await Linking.canOpenURL(href) : true;
+      if (ok) {
+        await Linking.openURL(href);
+        return;
+      }
+    } catch {
+      // 试下一个地址
+    }
+  }
+  await Linking.openURL(candidates[0] || target);
+}

package/src/updates/types.ts

@@ -0,0 +1,61 @@
+export type PromptTheme = 'dialog' | 'sheet' | 'banner';
+
+/** /v2/check 的判别联合响应：要么没更新，要么热更，要么去商店。 */
+export type HotUpdateInfo = {
+  kind: 'hot';
+  releaseId: string;
+  bundleVersion: number;
+  appVersion: string;
+  downloadUrl: string;
+  sha256: string;
+  size: number;
+  mandatory: boolean;
+  notes: string;
+  downgrade: boolean;
+  gray: boolean;
+  publishedAt?: string;
+  deviceId?: string;
+  userId?: string;
+  eventId?: string;
+};
+
+export type StoreUpdateInfo = {
+  kind: 'store';
+  releaseId: string;
+  appVersion: string;
+  storeUrl: string;
+  mandatory: boolean;
+  notes: string;
+  promptTheme: PromptTheme;
+  publishedAt?: string;
+  deviceId?: string;
+  userId?: string;
+  eventId?: string;
+};
+
+export type NoUpdateInfo = {
+  kind: 'none';
+  reason: string;
+  notes?: string;
+  deviceId?: string;
+  userId?: string;
+  eventId?: string;
+};
+
+export type CheckResponse = HotUpdateInfo | StoreUpdateInfo | NoUpdateInfo;
+
+/**
+ * 更新状态机。热更全程静默：checking → downloading → installing → ready。
+ * store-required 是唯一需要 UI 介入的状态。
+ */
+export type UpdateState =
+  | {phase: 'idle'}
+  | {phase: 'checking'}
+  | {phase: 'up-to-date'; reason: string}
+  | {phase: 'downloading'; info: HotUpdateInfo; progress: number}
+  | {phase: 'installing'; info: HotUpdateInfo}
+  | {phase: 'ready'; info: HotUpdateInfo; restarting: boolean}
+  | {phase: 'store-required'; info: StoreUpdateInfo}
+  | {phase: 'error'; message: string; info?: HotUpdateInfo};
+
+export type UpdateStateListener = (state: UpdateState) => void;