{
  "schemaVersion": 1,
  "packageName": "@gaozh1024/hot-updater",
  "version": "0.2.0",
  "role": "feature-package",
  "summary": "OTA hot update helper package for business apps, built around manifest fetch, update orchestration, provider hooks, and release helpers.",
  "entrypoints": [
    {
      "path": ".",
      "kind": "runtime",
      "recommended": true
    },
    {
      "path": "./package.json",
      "kind": "runtime",
      "recommended": false
    }
  ],
  "installation": {
    "packageManagerCommand": "pnpm add @gaozh1024/hot-updater",
    "projectTypes": [
      "react-native"
    ],
    "peerDependencies": {
      "@gaozh1024/rn-kit": ">=0.4.20",
      "@hot-updater/react-native": ">=0.28 <0.31",
      "react": ">=19.1.0 <20",
      "react-native": ">=0.81 <0.84"
    }
  },
  "recommendedUsage": {
    "minimumSetup": [
      "Configure a manifestBaseURL and a manifest hosting strategy.",
      "For Android, verify the underlying plugin patched MainApplication.kt, or patch it manually when the app template is not matched.",
      "For iOS, verify AppDelegate.swift uses HotUpdater.bundleURL() on release builds when the underlying plugin expects it."
    ],
    "canonicalTemplate": "templates/expo-starter"
  },
  "stableApis": [
    "createOssHotUpdater",
    "createHotUpdaterContext",
    "HotUpdaterProvider",
    "useHotUpdaterContext",
    "startLaunchUpdateCheck",
    "checkForUpdates"
  ],
  "compatibilityNotes": [
    "This package is built on top of @hot-updater/react-native and related tooling.",
    "Current compatibility guidance targets React Native >=0.81 <0.84 and @hot-updater/react-native >=0.28 <0.31.",
    "The framework layer handles update orchestration, but business projects still own startup UX and product decisions.",
    "iOS native wiring may be mostly handled by the underlying plugin, but the resulting AppDelegate.swift should still be verified.",
    "A disabled manifest release (`release.disabled: true`) is treated as no update and can be used to pause a bad OTA."
  ],
  "antiPatterns": [
    "Treating this package as responsible for OSS upload, CDN refresh, analytics, or business-page routing.",
    "Blocking the entire app startup on optional update checks or slow manifest fetches.",
    "Skipping verification of required Android native entry changes and assuming downloaded bundles will apply correctly."
  ],
  "canonicalExamples": [
    {
      "name": "hot-updater-provider",
      "path": "packages/hot-updater/src/provider.tsx"
    },
    {
      "name": "hot-updater-runtime",
      "path": "packages/hot-updater/src/runtime.ts"
    },
    {
      "name": "manifest-spec",
      "path": "packages/hot-updater/docs/manifest-spec.md"
    }
  ],
  "docs": [
    "README.md",
    "AI_USAGE.md",
    "docs/integration.md",
    "docs/manifest-spec.md"
  ]
}