@hot-updater/plugin-core 0.31.4 → 0.33.0

package/dist/requestUpdateBundleState.d.mts

@@ -0,0 +1,6 @@
+import { Bundle, HotUpdaterContext } from "./types/index.mjs";
+
+//#region src/requestUpdateBundleState.d.ts
+declare const getRequestUpdateBundleSeeds: <TContext = unknown>(context: HotUpdaterContext<TContext> | undefined) => readonly Bundle[];
+//#endregion
+export { getRequestUpdateBundleSeeds };

package/dist/requestUpdateBundleState.mjs

@@ -0,0 +1,19 @@
+//#region src/requestUpdateBundleState.ts
+const requestUpdateBundleSeeds = /* @__PURE__ */ new WeakMap();
+const isWeakMapKey = (value) => typeof value === "object" && value !== null || typeof value === "function";
+const toBundleSeeds = (seeds) => seeds.filter((seed) => !!seed);
+const seedRequestUpdateBundles = (context, seeds) => {
+	if (!isWeakMapKey(context)) return;
+	const nextSeeds = toBundleSeeds(seeds);
+	if (nextSeeds.length === 0) return;
+	const bundlesById = /* @__PURE__ */ new Map();
+	for (const seed of requestUpdateBundleSeeds.get(context) ?? []) bundlesById.set(seed.id, seed);
+	for (const seed of nextSeeds) bundlesById.set(seed.id, seed);
+	requestUpdateBundleSeeds.set(context, [...bundlesById.values()]);
+};
+const getRequestUpdateBundleSeeds = (context) => {
+	if (!isWeakMapKey(context)) return [];
+	return requestUpdateBundleSeeds.get(context) ?? [];
+};
+//#endregion
+export { getRequestUpdateBundleSeeds, seedRequestUpdateBundles };

package/dist/resolveUpdateInfoFromBundles.cjs

@@ -0,0 +1,14 @@
+require("./_virtual/_rolldown/runtime.cjs");
+const require_requestUpdateBundleState = require("./requestUpdateBundleState.cjs");
+let _hot_updater_core = require("@hot-updater/core");
+let _hot_updater_js = require("@hot-updater/js");
+//#region src/resolveUpdateInfoFromBundles.ts
+const findSeedBundle = (bundles, bundleId) => bundles.find((bundle) => bundle.id === bundleId);
+const resolveUpdateInfoFromBundles = async ({ args, bundles, context }) => {
+	const info = await (0, _hot_updater_js.getUpdateInfo)(bundles, args);
+	if (!info) return null;
+	require_requestUpdateBundleState.seedRequestUpdateBundles(context, [findSeedBundle(bundles, info.id), args.bundleId === _hot_updater_core.NIL_UUID ? null : findSeedBundle(bundles, args.bundleId)]);
+	return info;
+};
+//#endregion
+exports.resolveUpdateInfoFromBundles = resolveUpdateInfoFromBundles;

package/dist/resolveUpdateInfoFromBundles.d.cts

@@ -0,0 +1,16 @@
+import { Bundle as Bundle$1, HotUpdaterContext } from "./types/index.cjs";
+import { GetBundlesArgs, UpdateInfo } from "@hot-updater/core";
+
+//#region src/resolveUpdateInfoFromBundles.d.ts
+interface ResolveUpdateInfoFromBundlesOptions<TContext = unknown> {
+  readonly args: GetBundlesArgs;
+  readonly bundles: Bundle$1[];
+  readonly context?: HotUpdaterContext<TContext>;
+}
+declare const resolveUpdateInfoFromBundles: <TContext = unknown>({
+  args,
+  bundles,
+  context
+}: ResolveUpdateInfoFromBundlesOptions<TContext>) => Promise<UpdateInfo | null>;
+//#endregion
+export { ResolveUpdateInfoFromBundlesOptions, resolveUpdateInfoFromBundles };

package/dist/resolveUpdateInfoFromBundles.d.mts

@@ -0,0 +1,16 @@
+import { Bundle as Bundle$1, HotUpdaterContext } from "./types/index.mjs";
+import { GetBundlesArgs, UpdateInfo } from "@hot-updater/core";
+
+//#region src/resolveUpdateInfoFromBundles.d.ts
+interface ResolveUpdateInfoFromBundlesOptions<TContext = unknown> {
+  readonly args: GetBundlesArgs;
+  readonly bundles: Bundle$1[];
+  readonly context?: HotUpdaterContext<TContext>;
+}
+declare const resolveUpdateInfoFromBundles: <TContext = unknown>({
+  args,
+  bundles,
+  context
+}: ResolveUpdateInfoFromBundlesOptions<TContext>) => Promise<UpdateInfo | null>;
+//#endregion
+export { ResolveUpdateInfoFromBundlesOptions, resolveUpdateInfoFromBundles };

package/dist/resolveUpdateInfoFromBundles.mjs

@@ -0,0 +1,13 @@
+import { seedRequestUpdateBundles } from "./requestUpdateBundleState.mjs";
+import { NIL_UUID } from "@hot-updater/core";
+import { getUpdateInfo } from "@hot-updater/js";
+//#region src/resolveUpdateInfoFromBundles.ts
+const findSeedBundle = (bundles, bundleId) => bundles.find((bundle) => bundle.id === bundleId);
+const resolveUpdateInfoFromBundles = async ({ args, bundles, context }) => {
+	const info = await getUpdateInfo(bundles, args);
+	if (!info) return null;
+	seedRequestUpdateBundles(context, [findSeedBundle(bundles, info.id), args.bundleId === NIL_UUID ? null : findSeedBundle(bundles, args.bundleId)]);
+	return info;
+};
+//#endregion
+export { resolveUpdateInfoFromBundles };

package/dist/semverSatisfies.cjs

@@ -1,6 +1,6 @@
 const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
 let semver = require("semver");
-semver = require_runtime.__toESM(semver, 1);
+semver = require_runtime.__toESM(semver);
 //#region src/semverSatisfies.ts
 const semverSatisfies = (targetAppVersion, currentVersion) => {
 	const currentCoerce = semver.default.coerce(currentVersion);

package/dist/types/index.d.cts

@@ -69,6 +69,28 @@ interface DatabaseBundleQueryOptions {
   cursor?: DatabaseBundleCursor;
   orderBy?: DatabaseBundleQueryOrder;
 }
+interface BundleIndexHealth {
+  status: "ok" | "missing" | "stale";
+  canonicalBundles: number;
+  indexedBundles: number;
+  missingBundles: number;
+  extraBundles: number;
+  missingBundleIds: string[];
+  extraBundleIds: string[];
+}
+interface BundleIndexRepairResult {
+  scannedBundles: number;
+  indexedBundles: number;
+  pagesWritten: number;
+  scopesWritten: number;
+}
+interface BundleIndexDiagnostics<TContext = unknown> {
+  check: (context?: HotUpdaterContext<TContext>) => Promise<BundleIndexHealth>;
+  repair?: (context?: HotUpdaterContext<TContext>) => Promise<BundleIndexRepairResult>;
+}
+interface DatabaseDiagnostics<TContext = unknown> {
+  bundleIndex?: BundleIndexDiagnostics<TContext>;
+}
 interface BuildPluginConfig {
   outDir?: string;
 }
@@ -80,6 +102,7 @@ interface DatabasePlugin<TContext = unknown> {
   updateBundle: (targetBundleId: string, newBundle: Partial<Bundle>, context?: HotUpdaterContext<TContext>) => Promise<void>;
   appendBundle: (insertBundle: Bundle, context?: HotUpdaterContext<TContext>) => Promise<void>;
   commitBundle: (context?: HotUpdaterContext<TContext>) => Promise<void>;
+  diagnostics?: DatabaseDiagnostics<TContext>;
   onUnmount?: () => Promise<void>;
   name: string;
   deleteBundle: (deleteBundle: Bundle, context?: HotUpdaterContext<TContext>) => Promise<void>;
@@ -232,9 +255,19 @@ interface PlatformConfig {
    * Android platform configuration.
    */
   android?: {
+    /**
+     * Android manifest paths.
+     *
+     * @default all AndroidManifest.xml files in the android directory
+     * @example ["android/app/src/main/AndroidManifest.xml"]
+     */
+    androidManifestPaths?: string[];
     /**
      * Android string resource paths.
      *
+     * @deprecated Android Hot Updater config is stored in AndroidManifest.xml.
+     * This remains supported as a legacy read fallback.
+     *
      * @default all strings.xml files in the android directory
      * @example ["android/app/src/main/res/values/strings.xml"]
      */
@@ -273,6 +306,12 @@ interface NodeStorageProfile {
   upload: (key: string, filePath: string) => Promise<{
     storageUri: string;
   }>;
+  /**
+   * Returns true when the object can be safely reused by deploy without
+   * uploading it again. Providers may validate more than physical existence
+   * when runtime access needs an additional readiness check.
+   */
+  exists: (storageUri: string) => Promise<boolean>;
   delete: (storageUri: string) => Promise<void>;
   downloadFile: (storageUri: string, filePath: string) => Promise<void>;
 }
@@ -363,6 +402,13 @@ type SigningConfig = {
   privateKeyPath: string;
 };
 type ConfigInput = {
+  /**
+   * @hidden
+   * Local cache directory used by Hot Updater CLI. Set to `null` to disable.
+   *
+   * @default "node_modules/.hot-updater"
+   */
+  cacheDir?: string | null;
   /**
    * The channel used when building the native app.
    * Used to replace __HOT_UPDATER_CHANNEL at build time.
@@ -481,4 +527,4 @@ interface NativeBuildOptions {
   scheme?: string;
 }
 //#endregion
-export { type AppVersionGetBundlesArgs$1 as AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, type Bundle$1 as Bundle, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, type FingerprintGetBundlesArgs$1 as FingerprintGetBundlesArgs, type GetBundlesArgs$1 as GetBundlesArgs, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, NodeStoragePlugin, NodeStorageProfile, Paginated, PaginatedResult, PaginationInfo, type Platform$1 as Platform, PlatformConfig, RequestEnvContext, RuntimeStoragePlugin, RuntimeStorageProfile, SigningConfig, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, type UpdateInfo$1 as UpdateInfo, supportedIosPlatforms };
+export { type AppVersionGetBundlesArgs$1 as AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, type Bundle$1 as Bundle, BundleIndexDiagnostics, BundleIndexHealth, BundleIndexRepairResult, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabaseDiagnostics, DatabasePlugin, DatabasePluginHooks, type FingerprintGetBundlesArgs$1 as FingerprintGetBundlesArgs, type GetBundlesArgs$1 as GetBundlesArgs, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, NodeStoragePlugin, NodeStorageProfile, Paginated, PaginatedResult, PaginationInfo, type Platform$1 as Platform, PlatformConfig, RequestEnvContext, RuntimeStoragePlugin, RuntimeStorageProfile, SigningConfig, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, type UpdateInfo$1 as UpdateInfo, supportedIosPlatforms };

package/dist/types/index.d.mts

@@ -69,6 +69,28 @@ interface DatabaseBundleQueryOptions {
   cursor?: DatabaseBundleCursor;
   orderBy?: DatabaseBundleQueryOrder;
 }
+interface BundleIndexHealth {
+  status: "ok" | "missing" | "stale";
+  canonicalBundles: number;
+  indexedBundles: number;
+  missingBundles: number;
+  extraBundles: number;
+  missingBundleIds: string[];
+  extraBundleIds: string[];
+}
+interface BundleIndexRepairResult {
+  scannedBundles: number;
+  indexedBundles: number;
+  pagesWritten: number;
+  scopesWritten: number;
+}
+interface BundleIndexDiagnostics<TContext = unknown> {
+  check: (context?: HotUpdaterContext<TContext>) => Promise<BundleIndexHealth>;
+  repair?: (context?: HotUpdaterContext<TContext>) => Promise<BundleIndexRepairResult>;
+}
+interface DatabaseDiagnostics<TContext = unknown> {
+  bundleIndex?: BundleIndexDiagnostics<TContext>;
+}
 interface BuildPluginConfig {
   outDir?: string;
 }
@@ -80,6 +102,7 @@ interface DatabasePlugin<TContext = unknown> {
   updateBundle: (targetBundleId: string, newBundle: Partial<Bundle>, context?: HotUpdaterContext<TContext>) => Promise<void>;
   appendBundle: (insertBundle: Bundle, context?: HotUpdaterContext<TContext>) => Promise<void>;
   commitBundle: (context?: HotUpdaterContext<TContext>) => Promise<void>;
+  diagnostics?: DatabaseDiagnostics<TContext>;
   onUnmount?: () => Promise<void>;
   name: string;
   deleteBundle: (deleteBundle: Bundle, context?: HotUpdaterContext<TContext>) => Promise<void>;
@@ -232,9 +255,19 @@ interface PlatformConfig {
    * Android platform configuration.
    */
   android?: {
+    /**
+     * Android manifest paths.
+     *
+     * @default all AndroidManifest.xml files in the android directory
+     * @example ["android/app/src/main/AndroidManifest.xml"]
+     */
+    androidManifestPaths?: string[];
     /**
      * Android string resource paths.
      *
+     * @deprecated Android Hot Updater config is stored in AndroidManifest.xml.
+     * This remains supported as a legacy read fallback.
+     *
      * @default all strings.xml files in the android directory
      * @example ["android/app/src/main/res/values/strings.xml"]
      */
@@ -273,6 +306,12 @@ interface NodeStorageProfile {
   upload: (key: string, filePath: string) => Promise<{
     storageUri: string;
   }>;
+  /**
+   * Returns true when the object can be safely reused by deploy without
+   * uploading it again. Providers may validate more than physical existence
+   * when runtime access needs an additional readiness check.
+   */
+  exists: (storageUri: string) => Promise<boolean>;
   delete: (storageUri: string) => Promise<void>;
   downloadFile: (storageUri: string, filePath: string) => Promise<void>;
 }
@@ -363,6 +402,13 @@ type SigningConfig = {
   privateKeyPath: string;
 };
 type ConfigInput = {
+  /**
+   * @hidden
+   * Local cache directory used by Hot Updater CLI. Set to `null` to disable.
+   *
+   * @default "node_modules/.hot-updater"
+   */
+  cacheDir?: string | null;
   /**
    * The channel used when building the native app.
    * Used to replace __HOT_UPDATER_CHANNEL at build time.
@@ -481,4 +527,4 @@ interface NativeBuildOptions {
   scheme?: string;
 }
 //#endregion
-export { type AppVersionGetBundlesArgs$1 as AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, type Bundle$1 as Bundle, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, type FingerprintGetBundlesArgs$1 as FingerprintGetBundlesArgs, type GetBundlesArgs$1 as GetBundlesArgs, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, NodeStoragePlugin, NodeStorageProfile, Paginated, PaginatedResult, PaginationInfo, type Platform$1 as Platform, PlatformConfig, RequestEnvContext, RuntimeStoragePlugin, RuntimeStorageProfile, SigningConfig, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, type UpdateInfo$1 as UpdateInfo, supportedIosPlatforms };
+export { type AppVersionGetBundlesArgs$1 as AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, type Bundle$1 as Bundle, BundleIndexDiagnostics, BundleIndexHealth, BundleIndexRepairResult, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabaseDiagnostics, DatabasePlugin, DatabasePluginHooks, type FingerprintGetBundlesArgs$1 as FingerprintGetBundlesArgs, type GetBundlesArgs$1 as GetBundlesArgs, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, NodeStoragePlugin, NodeStorageProfile, Paginated, PaginatedResult, PaginationInfo, type Platform$1 as Platform, PlatformConfig, RequestEnvContext, RuntimeStoragePlugin, RuntimeStorageProfile, SigningConfig, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, type UpdateInfo$1 as UpdateInfo, supportedIosPlatforms };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hot-updater/plugin-core",
-  "version": "0.31.4",
+  "version": "0.33.0",
   "type": "module",
   "description": "React Native OTA solution for self-hosted",
   "sideEffects": false,
@@ -42,14 +42,14 @@
     "es-toolkit": "^1.32.0",
     "mime": "^4.0.4",
     "semver": "^7.7.2",
-    "@hot-updater/core": "0.31.4",
-    "@hot-updater/js": "0.31.4"
+    "@hot-updater/js": "0.33.0",
+    "@hot-updater/core": "0.33.0"
   },
   "devDependencies": {
     "@types/node": "^20",
     "@types/semver": "^7.5.8",
     "typescript": "6.0.2",
-    "@hot-updater/test-utils": "0.31.4"
+    "@hot-updater/test-utils": "0.33.0"
   },
   "scripts": {
     "build": "tsdown",