@o/native-hot-update 0.16.19

package/src/helpers.ts

@@ -0,0 +1,23 @@
+import { HotUpdater } from '@hot-updater/react-native'
+
+const INITIAL_OTA_ID = '00000000-0000-0000-0000-000000000000'
+
+/**
+ * Get the currently applied OTA bundle ID.
+ * Returns null if running native build (no OTA applied).
+ */
+export function getAppliedOta(): string | null {
+  const id = HotUpdater.getBundleId()
+  if (id === INITIAL_OTA_ID) return null
+  if (id === HotUpdater.getMinBundleId()) return null
+  return id
+}
+
+/**
+ * Get a short version of the OTA ID (last 12 characters).
+ * Returns null if running native build.
+ */
+export function getShortOtaId(): string | null {
+  const fullId = getAppliedOta()
+  return fullId ? fullId.slice(-12) : null
+}

package/src/index.ts

@@ -0,0 +1,6 @@
+// Re-export HotUpdater for app usage
+export { HotUpdater, useHotUpdaterStore } from '@hot-updater/react-native'
+
+// Package exports
+export { createHotUpdater } from './createHotUpdater'
+export type * from './types'

package/src/mmkv.ts

@@ -0,0 +1,20 @@
+import type { HotUpdateStorage } from './types'
+import type { MMKV } from 'react-native-mmkv'
+
+/**
+ * Create a storage adapter for MMKV.
+ *
+ * @example
+ * import { MMKV } from 'react-native-mmkv'
+ * import { createMMKVStorage } from '@o/native-hot-update/mmkv'
+ *
+ * const mmkv = new MMKV({ id: 'hot-updater' })
+ * const storage = createMMKVStorage(mmkv)
+ */
+export function createMMKVStorage(mmkv: MMKV): HotUpdateStorage {
+  return {
+    get: (key: string) => mmkv.getString(key),
+    set: (key: string, value: string) => mmkv.set(key, value),
+    delete: (key: string) => mmkv.delete(key),
+  }
+}

package/src/types.ts

@@ -0,0 +1,66 @@
+/** Simple key-value storage interface */
+export interface HotUpdateStorage {
+  get(key: string): string | undefined
+  set(key: string, value: string): void
+  delete(key: string): void
+}
+
+export interface HotUpdaterConfig {
+  /** Storage for persisting update state */
+  storage: HotUpdateStorage
+  /** Update strategy (default: 'appVersion') */
+  updateStrategy?: 'appVersion' | 'fingerprint'
+}
+
+export interface UpdateInfo {
+  id: string
+  isCriticalUpdate: boolean
+  fileUrl: string | null
+  message: string | null
+}
+
+export interface HotUpdaterInstance {
+  /** React hook for automatic update checking */
+  useOtaUpdater: (options?: {
+    enabled?: boolean
+    onUpdateDownloaded?: (info: UpdateInfo) => void
+    onError?: (error: unknown) => void
+  }) => {
+    userClearedForAccess: boolean
+    progress: number
+    isUpdatePending: boolean
+  }
+
+  /** Manually check for updates (for dev/testing) */
+  checkForUpdate: (options?: {
+    channel?: string
+    isPreRelease?: boolean
+  }) => Promise<UpdateInfo | null>
+
+  /** Get currently applied OTA bundle ID (null if native) */
+  getAppliedOta: () => string | null
+
+  /** Get short version of OTA ID */
+  getShortOtaId: () => string | null
+
+  /** Check if update is pending (will apply on restart) */
+  getIsUpdatePending: () => boolean
+
+  /** Reload the app to apply update */
+  reload: () => void
+
+  /** Get current bundle ID */
+  getBundleId: () => string
+
+  /** Get minimum bundle ID (native build time) */
+  getMinBundleId: () => string
+
+  /** Get current channel */
+  getChannel: () => string
+
+  /** Clear crash history to allow retrying failed bundles */
+  clearCrashHistory: () => boolean
+
+  /** Get list of crashed bundle IDs */
+  getCrashHistory: () => string[]
+}