@hot-updater/plugin-core 0.32.0 → 0.33.0

package/dist/createBlobDatabasePlugin.cjs

@@ -4,11 +4,29 @@ const require_createDatabasePlugin = require("./createDatabasePlugin.cjs");
 const require_filterCompatibleAppVersions = require("./filterCompatibleAppVersions.cjs");
 const require_queryBundles = require("./queryBundles.cjs");
 const require_paginateBundles = require("./paginateBundles.cjs");
-let _hot_updater_js = require("@hot-updater/js");
+const require_resolveUpdateInfoFromBundles = require("./resolveUpdateInfoFromBundles.cjs");
 let es_toolkit = require("es-toolkit");
 let semver = require("semver");
 semver = require_runtime.__toESM(semver);
 //#region src/createBlobDatabasePlugin.ts
+const STORAGE_OPERATION_CONCURRENCY = 8;
+async function mapWithConcurrency(items, concurrency, mapper) {
+	const results = [];
+	let nextIndex = 0;
+	const workerCount = Math.min(concurrency, items.length);
+	await Promise.all(Array.from({ length: workerCount }, async () => {
+		while (true) {
+			const index = nextIndex;
+			nextIndex += 1;
+			if (index >= items.length) break;
+			results[index] = await mapper(items[index], index);
+		}
+	}));
+	return results;
+}
+async function forEachWithConcurrency(items, concurrency, mapper) {
+	await mapWithConcurrency(items, concurrency, mapper);
+}
 function removeBundleInternalKeys(bundle) {
 	const { _updateJsonKey, _oldUpdateJsonKey, ...pureBundle } = bundle;
 	return pureBundle;
@@ -57,6 +75,12 @@ const MANAGEMENT_INDEX_PREFIX = "_index";
 const MANAGEMENT_INDEX_VERSION = 1;
 const DEFAULT_MANAGEMENT_INDEX_PAGE_SIZE = 128;
 const ALL_SCOPE_CACHE_KEY = "*|*";
+function summarizeManagementIndexArtifacts(artifacts) {
+	return {
+		pagesWritten: artifacts.pages.size,
+		scopesWritten: artifacts.scopes.length
+	};
+}
 function resolveManagementIndexPageSize(config) {
 	const pageSize = config.managementIndexPageSize ?? DEFAULT_MANAGEMENT_INDEX_PAGE_SIZE;
 	if (!Number.isInteger(pageSize) || pageSize < 1) throw new Error("managementIndexPageSize must be a positive integer.");
@@ -188,11 +212,18 @@ function buildManagementIndexArtifacts(allBundles, pageSize) {
 const createBlobDatabasePlugin = ({ name, factory }) => {
 	return (config, hooks) => {
 		const managementIndexPageSize = resolveManagementIndexPageSize(config);
-		const { listObjects, loadObject, uploadObject, deleteObject, invalidatePaths, apiBasePath } = factory(config);
+		const { listObjects, loadObject, uploadObject, deleteObject, shouldSkipLoadObjectError, invalidatePaths, apiBasePath } = factory(config);
 		const bundlesMap = /* @__PURE__ */ new Map();
 		const pendingBundlesMap = /* @__PURE__ */ new Map();
 		const managementRootCache = /* @__PURE__ */ new Map();
-		const PLATFORMS = ["ios", "android"];
+		const loadOptionalObject = async (key) => {
+			try {
+				return await loadObject(key);
+			} catch (error) {
+				if (shouldSkipLoadObjectError?.(error, key)) return null;
+				throw error;
+			}
+		};
 		const getAllManagementArtifact = (artifacts) => {
 			const allArtifact = artifacts.scopes.find((scope) => scope.cacheKey === ALL_SCOPE_CACHE_KEY);
 			if (!allArtifact) throw new Error("all-bundles management index artifact not found");
@@ -209,7 +240,7 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 		};
 		const loadStoredManagementRoot = async (scope) => {
 			const cacheKey = getManagementScopeCacheKey(scope);
-			const storedRoot = await loadObject(getManagementRootKey(scope));
+			const storedRoot = await loadOptionalObject(getManagementRootKey(scope));
 			if (storedRoot) {
 				managementRootCache.set(cacheKey, storedRoot);
 				return storedRoot;
@@ -219,7 +250,7 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 		};
 		const loadManagementPage = async (descriptor, pageCache) => {
 			if (pageCache?.has(descriptor.key)) return pageCache.get(descriptor.key) ?? null;
-			const page = await loadObject(descriptor.key);
+			const page = await loadOptionalObject(descriptor.key);
 			pageCache?.set(descriptor.key, page);
 			return page;
 		};
@@ -242,13 +273,13 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 			return allBundles;
 		};
 		const persistManagementIndexArtifacts = async (nextArtifacts, previousArtifacts) => {
-			for (const [key, page] of nextArtifacts.pages.entries()) await uploadObject(key, page);
-			for (const scope of nextArtifacts.scopes) await uploadObject(scope.rootKey, scope.root);
+			await forEachWithConcurrency(Array.from(nextArtifacts.pages.entries()), STORAGE_OPERATION_CONCURRENCY, ([key, page]) => uploadObject(key, page));
+			await forEachWithConcurrency(nextArtifacts.scopes, STORAGE_OPERATION_CONCURRENCY, (scope) => uploadObject(scope.rootKey, scope.root));
 			if (!previousArtifacts) return;
 			const nextPageKeys = new Set(nextArtifacts.pages.keys());
 			const nextRootKeys = new Set(nextArtifacts.scopes.map((scope) => scope.rootKey));
-			for (const [key] of previousArtifacts.pages.entries()) if (!nextPageKeys.has(key)) await deleteObject(key).catch(() => {});
-			for (const scope of previousArtifacts.scopes) if (!nextRootKeys.has(scope.rootKey)) await deleteObject(scope.rootKey).catch(() => {});
+			await forEachWithConcurrency(Array.from(previousArtifacts.pages.keys()).filter((key) => !nextPageKeys.has(key)), STORAGE_OPERATION_CONCURRENCY, (key) => deleteObject(key).catch(() => {}));
+			await forEachWithConcurrency(previousArtifacts.scopes.filter((scope) => !nextRootKeys.has(scope.rootKey)), STORAGE_OPERATION_CONCURRENCY, (scope) => deleteObject(scope.rootKey).catch(() => {}));
 		};
 		const ensureAllManagementRoot = async () => {
 			const storedAllRoot = await loadStoredManagementRoot({});
@@ -281,6 +312,26 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 		const loadCurrentBundlesForIndexRebuild = async () => {
 			return loadAllBundlesForManagementFallback();
 		};
+		const loadBundlesFromCanonicalManifests = async () => {
+			return sortManagedBundles((await reloadBundles()).map((bundle) => removeBundleInternalKeys(bundle)));
+		};
+		const loadStoredBundlesForIndexRebuild = loadBundlesFromCanonicalManifests;
+		const loadCanonicalBundlesForIndexRepair = loadBundlesFromCanonicalManifests;
+		const compareBundleIndex = ({ canonicalBundles, indexedBundles, rootMissing }) => {
+			const canonicalIds = new Set(canonicalBundles.map((bundle) => bundle.id));
+			const indexedIds = new Set(indexedBundles?.map((bundle) => bundle.id) ?? []);
+			const missingBundleIds = Array.from(canonicalIds).filter((id) => !indexedIds.has(id)).sort((left, right) => right.localeCompare(left));
+			const extraBundleIds = Array.from(indexedIds).filter((id) => !canonicalIds.has(id)).sort((left, right) => right.localeCompare(left));
+			return {
+				status: missingBundleIds.length === 0 && extraBundleIds.length === 0 && !rootMissing ? "ok" : rootMissing ? "missing" : "stale",
+				canonicalBundles: canonicalBundles.length,
+				indexedBundles: indexedBundles?.length ?? 0,
+				missingBundles: missingBundleIds.length,
+				extraBundles: extraBundleIds.length,
+				missingBundleIds: missingBundleIds.slice(0, 20),
+				extraBundleIds: extraBundleIds.slice(0, 20)
+			};
+		};
 		const findPageIndexContainingId = (pages, id) => {
 			return pages.findIndex((page) => id.localeCompare(page.firstId) <= 0 && id.localeCompare(page.lastId) >= 0);
 		};
@@ -456,16 +507,15 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 		};
 		async function reloadBundles() {
 			bundlesMap.clear();
-			const filePromises = (await listObjects("")).filter((key) => /^[^/]+\/(?:ios|android)\/[^/]+\/update\.json$/.test(key)).map(async (key) => {
-				return (await loadObject(key) ?? []).map((bundle) => ({
+			const allBundles = (await mapWithConcurrency((await listObjects("")).filter((key) => /^[^/]+\/(?:ios|android)\/[^/]+\/update\.json$/.test(key)), STORAGE_OPERATION_CONCURRENCY, async (key) => {
+				return (await loadOptionalObject(key) ?? []).map((bundle) => ({
 					...bundle,
 					_updateJsonKey: key
 				}));
-			});
-			const allBundles = (await Promise.all(filePromises)).flat();
+			})).flat();
 			for (const bundle of allBundles) bundlesMap.set(bundle.id, bundle);
 			for (const [id, bundle] of pendingBundlesMap.entries()) bundlesMap.set(id, bundle);
-			return (0, es_toolkit.orderBy)(allBundles, [(v) => v.id], ["desc"]);
+			return (0, es_toolkit.orderBy)(Array.from(bundlesMap.values()), [(v) => v.id], ["desc"]);
 		}
 		/**
 		* Updates target-app-versions.json for each channel on the given platform.
@@ -491,35 +541,44 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 				const updateKeys = keysByChannel[channel];
 				const targetKey = `${channel}/${platform}/target-app-versions.json`;
 				const currentVersions = updateKeys.map((key) => key.split("/")[2]);
-				const oldTargetVersions = await loadObject(targetKey) ?? [];
+				const oldTargetVersions = await loadOptionalObject(targetKey) ?? [];
 				const newTargetVersions = oldTargetVersions.filter((v) => currentVersions.includes(v));
 				for (const v of currentVersions) if (!newTargetVersions.includes(v)) newTargetVersions.push(v);
 				if (JSON.stringify(oldTargetVersions) !== JSON.stringify(newTargetVersions)) await uploadObject(targetKey, newTargetVersions);
 			}
 		}
-		const getAppVersionUpdateInfo = async ({ appVersion, bundleId, channel = "production", cohort, minBundleId, platform }) => {
-			const matchingVersions = require_filterCompatibleAppVersions.filterCompatibleAppVersions(await loadObject(`${channel}/${platform}/target-app-versions.json`) ?? [], appVersion);
-			return (0, _hot_updater_js.getUpdateInfo)((await Promise.allSettled(matchingVersions.map(async (targetAppVersion) => {
-				return await loadObject(`${channel}/${platform}/${normalizeTargetAppVersion(targetAppVersion) ?? targetAppVersion}/update.json`) ?? [];
-			}))).filter((entry) => entry.status === "fulfilled").flatMap((entry) => entry.value), {
-				_updateStrategy: "appVersion",
-				appVersion,
-				bundleId,
-				channel,
-				cohort,
-				minBundleId,
-				platform
+		const getAppVersionUpdateInfo = async ({ appVersion, bundleId, channel = "production", cohort, minBundleId, platform }, context) => {
+			const bundles = (await mapWithConcurrency(require_filterCompatibleAppVersions.filterCompatibleAppVersions(await loadOptionalObject(`${channel}/${platform}/target-app-versions.json`) ?? [], appVersion), STORAGE_OPERATION_CONCURRENCY, async (targetAppVersion) => {
+				return await loadOptionalObject(`${channel}/${platform}/${normalizeTargetAppVersion(targetAppVersion) ?? targetAppVersion}/update.json`) ?? [];
+			})).flat();
+			return require_resolveUpdateInfoFromBundles.resolveUpdateInfoFromBundles({
+				args: {
+					_updateStrategy: "appVersion",
+					appVersion,
+					bundleId,
+					channel,
+					cohort,
+					minBundleId,
+					platform
+				},
+				bundles,
+				context
 			});
 		};
-		const getFingerprintUpdateInfo = async ({ bundleId, channel = "production", cohort, fingerprintHash, minBundleId, platform }) => {
-			return (0, _hot_updater_js.getUpdateInfo)(await loadObject(`${channel}/${platform}/${fingerprintHash}/update.json`) ?? [], {
-				_updateStrategy: "fingerprint",
-				bundleId,
-				channel,
-				cohort,
-				fingerprintHash,
-				minBundleId,
-				platform
+		const getFingerprintUpdateInfo = async ({ bundleId, channel = "production", cohort, fingerprintHash, minBundleId, platform }, context) => {
+			const bundles = await loadOptionalObject(`${channel}/${platform}/${fingerprintHash}/update.json`) ?? [];
+			return require_resolveUpdateInfoFromBundles.resolveUpdateInfoFromBundles({
+				args: {
+					_updateStrategy: "fingerprint",
+					bundleId,
+					channel,
+					cohort,
+					fingerprintHash,
+					minBundleId,
+					platform
+				},
+				bundles,
+				context
 			});
 		};
 		const addAppVersionInvalidationPaths = (pathsToInvalidate, { platform, channel, targetAppVersion }) => {
@@ -541,7 +600,35 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 				targetAppVersion
 			});
 		};
-		return require_createDatabasePlugin.createDatabasePlugin({
+		const bundleIndexDiagnostics = {
+			async check() {
+				const canonicalBundles = await loadCanonicalBundlesForIndexRepair();
+				const allRoot = await loadStoredManagementRoot({});
+				return compareBundleIndex({
+					canonicalBundles,
+					indexedBundles: allRoot ? await loadAllBundlesFromRoot(allRoot) : null,
+					rootMissing: !allRoot
+				});
+			},
+			async repair() {
+				const canonicalBundles = await loadCanonicalBundlesForIndexRepair();
+				const previousRoot = await loadStoredManagementRoot({});
+				const previousBundles = previousRoot ? await loadAllBundlesFromRoot(previousRoot) : null;
+				const previousArtifacts = previousRoot && previousBundles ? buildManagementIndexArtifacts(previousBundles, previousRoot.pageSize) : void 0;
+				const nextArtifacts = buildManagementIndexArtifacts(canonicalBundles, managementIndexPageSize);
+				const indexedObjectKeys = await listObjects(`${MANAGEMENT_INDEX_PREFIX}/`);
+				const nextObjectKeys = new Set([...nextArtifacts.pages.keys(), ...nextArtifacts.scopes.map((scope) => scope.rootKey)]);
+				await persistManagementIndexArtifacts(nextArtifacts, previousArtifacts);
+				await forEachWithConcurrency(indexedObjectKeys.filter((key) => !nextObjectKeys.has(key)), STORAGE_OPERATION_CONCURRENCY, (key) => deleteObject(key).catch(() => {}));
+				replaceManagementRootCache(nextArtifacts);
+				return {
+					scannedBundles: canonicalBundles.length,
+					indexedBundles: canonicalBundles.length,
+					...summarizeManagementIndexArtifacts(nextArtifacts)
+				};
+			}
+		};
+		const createPlugin = require_createDatabasePlugin.createDatabasePlugin({
 			name,
 			factory: () => ({
 				supportsCursorPagination: true,
@@ -565,9 +652,9 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 					if (!matchedBundle) return null;
 					return removeBundleInternalKeys(matchedBundle);
 				},
-				async getUpdateInfo(args) {
-					if (args._updateStrategy === "appVersion") return getAppVersionUpdateInfo(args);
-					return getFingerprintUpdateInfo(args);
+				async getUpdateInfo(args, context) {
+					if (args._updateStrategy === "appVersion") return getAppVersionUpdateInfo(args, context);
+					return getFingerprintUpdateInfo(args, context);
 				},
 				async getBundles(options) {
 					const { where, limit, offset, orderBy, cursor } = options;
@@ -600,11 +687,8 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 					const changedBundlesByKey = {};
 					const removalsByKey = {};
 					const pathsToInvalidate = /* @__PURE__ */ new Set();
-					let isTargetAppVersionChanged = false;
-					let isChannelChanged = false;
+					const targetVersionPlatforms = /* @__PURE__ */ new Set();
 					for (const { operation, data } of changedSets) {
-						if (data.targetAppVersion !== void 0) isTargetAppVersionChanged = true;
-						if (operation === "update" && data.channel !== void 0) isChannelChanged = true;
 						if (operation === "insert") {
 							const target = resolveStorageTarget(data);
 							const key = `${data.channel}/${data.platform}/${target}/update.json`;
@@ -616,6 +700,7 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 							pendingBundlesMap.set(data.id, bundleWithKey);
 							changedBundlesByKey[key] = changedBundlesByKey[key] || [];
 							changedBundlesByKey[key].push(removeBundleInternalKeys(bundleWithKey));
+							if (data.targetAppVersion !== void 0) targetVersionPlatforms.add(data.platform);
 							addLookupInvalidationPaths(pathsToInvalidate, data);
 							continue;
 						}
@@ -628,6 +713,7 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 							const key = bundle._updateJsonKey;
 							removalsByKey[key] = removalsByKey[key] || [];
 							removalsByKey[key].push(bundle.id);
+							if (bundle.targetAppVersion !== void 0) targetVersionPlatforms.add(bundle.platform);
 							addLookupInvalidationPaths(pathsToInvalidate, bundle);
 							continue;
 						}
@@ -659,6 +745,10 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 										channel: nextChannel
 									});
 								}
+								if (bundle.targetAppVersion !== void 0 || updatedBundle.targetAppVersion !== void 0) {
+									targetVersionPlatforms.add(bundle.platform);
+									targetVersionPlatforms.add(updatedBundle.platform);
+								}
 								addLookupInvalidationPaths(pathsToInvalidate, updatedBundle);
 								if (bundle.targetAppVersion && bundle.targetAppVersion !== updatedBundle.targetAppVersion) addLookupInvalidationPaths(pathsToInvalidate, bundle);
 								continue;
@@ -672,14 +762,14 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 							if (bundle.targetAppVersion && bundle.targetAppVersion !== updatedBundle.targetAppVersion) addLookupInvalidationPaths(pathsToInvalidate, bundle);
 						}
 					}
-					for (const oldKey of Object.keys(removalsByKey)) await (async () => {
-						const updatedBundles = (await loadObject(oldKey) ?? []).filter((b) => !removalsByKey[oldKey].includes(b.id));
+					await forEachWithConcurrency(Object.keys(removalsByKey), STORAGE_OPERATION_CONCURRENCY, async (oldKey) => {
+						const updatedBundles = (await loadOptionalObject(oldKey) ?? []).filter((b) => !removalsByKey[oldKey].includes(b.id));
 						updatedBundles.sort((a, b) => b.id.localeCompare(a.id));
 						if (updatedBundles.length === 0) await deleteObject(oldKey);
 						else await uploadObject(oldKey, updatedBundles);
-					})();
-					for (const key of Object.keys(changedBundlesByKey)) await (async () => {
-						const currentBundles = await loadObject(key) ?? [];
+					});
+					await forEachWithConcurrency(Object.keys(changedBundlesByKey), STORAGE_OPERATION_CONCURRENCY, async (key) => {
+						const currentBundles = await loadOptionalObject(key) ?? [];
 						const pureBundles = changedBundlesByKey[key].map((bundle) => bundle);
 						for (const changedBundle of pureBundles) {
 							const index = currentBundles.findIndex((b) => b.id === changedBundle.id);
@@ -688,10 +778,11 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 						}
 						currentBundles.sort((a, b) => b.id.localeCompare(a.id));
 						await uploadObject(key, currentBundles);
-					})();
-					if (isTargetAppVersionChanged || isChannelChanged) for (const platform of PLATFORMS) await updateTargetVersionsForPlatform(platform);
-					const currentIndexBundles = await loadCurrentBundlesForIndexRebuild();
-					const nextIndexMap = new Map(currentIndexBundles.map((bundle) => [bundle.id, bundle]));
+					});
+					if (targetVersionPlatforms.size > 0) await Promise.all(Array.from(targetVersionPlatforms).map((platform) => updateTargetVersionsForPlatform(platform)));
+					const previousIndexBundles = await loadCurrentBundlesForIndexRebuild();
+					const storedIndexBundles = await loadStoredBundlesForIndexRebuild();
+					const nextIndexMap = new Map(storedIndexBundles.map((bundle) => [bundle.id, bundle]));
 					for (const { operation, data } of changedSets) {
 						if (operation === "delete") {
 							nextIndexMap.delete(data.id);
@@ -700,7 +791,7 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 						nextIndexMap.set(data.id, data);
 					}
 					const nextIndexBundles = sortManagedBundles(Array.from(nextIndexMap.values()));
-					const previousArtifacts = buildManagementIndexArtifacts(currentIndexBundles, managementIndexPageSize);
+					const previousArtifacts = buildManagementIndexArtifacts(previousIndexBundles, managementIndexPageSize);
 					const nextArtifacts = buildManagementIndexArtifacts(nextIndexBundles, managementIndexPageSize);
 					await persistManagementIndexArtifacts(nextArtifacts, previousArtifacts);
 					replaceManagementRootCache(nextArtifacts);
@@ -711,6 +802,15 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 				}
 			})
 		})({}, hooks);
+		return () => {
+			const plugin = createPlugin();
+			Object.defineProperty(plugin, "diagnostics", {
+				configurable: true,
+				enumerable: true,
+				value: { bundleIndex: bundleIndexDiagnostics }
+			});
+			return plugin;
+		};
 	};
 };
 //#endregion

package/dist/createBlobDatabasePlugin.d.cts

@@ -9,6 +9,7 @@ interface BlobOperations {
   loadObject: <T>(key: string) => Promise<T | null>;
   uploadObject: <T>(key: string, data: T) => Promise<void>;
   deleteObject: (key: string) => Promise<void>;
+  shouldSkipLoadObjectError?: (error: unknown, key: string) => boolean;
   invalidatePaths: (paths: string[]) => Promise<void>;
   apiBasePath: string;
 }

package/dist/createBlobDatabasePlugin.d.mts

@@ -9,6 +9,7 @@ interface BlobOperations {
   loadObject: <T>(key: string) => Promise<T | null>;
   uploadObject: <T>(key: string, data: T) => Promise<void>;
   deleteObject: (key: string) => Promise<void>;
+  shouldSkipLoadObjectError?: (error: unknown, key: string) => boolean;
   invalidatePaths: (paths: string[]) => Promise<void>;
   apiBasePath: string;
 }

package/dist/createBlobDatabasePlugin.mjs

@@ -3,10 +3,28 @@ import { createDatabasePlugin } from "./createDatabasePlugin.mjs";
 import { filterCompatibleAppVersions } from "./filterCompatibleAppVersions.mjs";
 import { bundleMatchesQueryWhere, sortBundles } from "./queryBundles.mjs";
 import { paginateBundles } from "./paginateBundles.mjs";
-import { getUpdateInfo } from "@hot-updater/js";
+import { resolveUpdateInfoFromBundles } from "./resolveUpdateInfoFromBundles.mjs";
 import { orderBy } from "es-toolkit";
 import semver from "semver";
 //#region src/createBlobDatabasePlugin.ts
+const STORAGE_OPERATION_CONCURRENCY = 8;
+async function mapWithConcurrency(items, concurrency, mapper) {
+	const results = [];
+	let nextIndex = 0;
+	const workerCount = Math.min(concurrency, items.length);
+	await Promise.all(Array.from({ length: workerCount }, async () => {
+		while (true) {
+			const index = nextIndex;
+			nextIndex += 1;
+			if (index >= items.length) break;
+			results[index] = await mapper(items[index], index);
+		}
+	}));
+	return results;
+}
+async function forEachWithConcurrency(items, concurrency, mapper) {
+	await mapWithConcurrency(items, concurrency, mapper);
+}
 function removeBundleInternalKeys(bundle) {
 	const { _updateJsonKey, _oldUpdateJsonKey, ...pureBundle } = bundle;
 	return pureBundle;
@@ -55,6 +73,12 @@ const MANAGEMENT_INDEX_PREFIX = "_index";
 const MANAGEMENT_INDEX_VERSION = 1;
 const DEFAULT_MANAGEMENT_INDEX_PAGE_SIZE = 128;
 const ALL_SCOPE_CACHE_KEY = "*|*";
+function summarizeManagementIndexArtifacts(artifacts) {
+	return {
+		pagesWritten: artifacts.pages.size,
+		scopesWritten: artifacts.scopes.length
+	};
+}
 function resolveManagementIndexPageSize(config) {
 	const pageSize = config.managementIndexPageSize ?? DEFAULT_MANAGEMENT_INDEX_PAGE_SIZE;
 	if (!Number.isInteger(pageSize) || pageSize < 1) throw new Error("managementIndexPageSize must be a positive integer.");
@@ -186,11 +210,18 @@ function buildManagementIndexArtifacts(allBundles, pageSize) {
 const createBlobDatabasePlugin = ({ name, factory }) => {
 	return (config, hooks) => {
 		const managementIndexPageSize = resolveManagementIndexPageSize(config);
-		const { listObjects, loadObject, uploadObject, deleteObject, invalidatePaths, apiBasePath } = factory(config);
+		const { listObjects, loadObject, uploadObject, deleteObject, shouldSkipLoadObjectError, invalidatePaths, apiBasePath } = factory(config);
 		const bundlesMap = /* @__PURE__ */ new Map();
 		const pendingBundlesMap = /* @__PURE__ */ new Map();
 		const managementRootCache = /* @__PURE__ */ new Map();
-		const PLATFORMS = ["ios", "android"];
+		const loadOptionalObject = async (key) => {
+			try {
+				return await loadObject(key);
+			} catch (error) {
+				if (shouldSkipLoadObjectError?.(error, key)) return null;
+				throw error;
+			}
+		};
 		const getAllManagementArtifact = (artifacts) => {
 			const allArtifact = artifacts.scopes.find((scope) => scope.cacheKey === ALL_SCOPE_CACHE_KEY);
 			if (!allArtifact) throw new Error("all-bundles management index artifact not found");
@@ -207,7 +238,7 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 		};
 		const loadStoredManagementRoot = async (scope) => {
 			const cacheKey = getManagementScopeCacheKey(scope);
-			const storedRoot = await loadObject(getManagementRootKey(scope));
+			const storedRoot = await loadOptionalObject(getManagementRootKey(scope));
 			if (storedRoot) {
 				managementRootCache.set(cacheKey, storedRoot);
 				return storedRoot;
@@ -217,7 +248,7 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 		};
 		const loadManagementPage = async (descriptor, pageCache) => {
 			if (pageCache?.has(descriptor.key)) return pageCache.get(descriptor.key) ?? null;
-			const page = await loadObject(descriptor.key);
+			const page = await loadOptionalObject(descriptor.key);
 			pageCache?.set(descriptor.key, page);
 			return page;
 		};
@@ -240,13 +271,13 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 			return allBundles;
 		};
 		const persistManagementIndexArtifacts = async (nextArtifacts, previousArtifacts) => {
-			for (const [key, page] of nextArtifacts.pages.entries()) await uploadObject(key, page);
-			for (const scope of nextArtifacts.scopes) await uploadObject(scope.rootKey, scope.root);
+			await forEachWithConcurrency(Array.from(nextArtifacts.pages.entries()), STORAGE_OPERATION_CONCURRENCY, ([key, page]) => uploadObject(key, page));
+			await forEachWithConcurrency(nextArtifacts.scopes, STORAGE_OPERATION_CONCURRENCY, (scope) => uploadObject(scope.rootKey, scope.root));
 			if (!previousArtifacts) return;
 			const nextPageKeys = new Set(nextArtifacts.pages.keys());
 			const nextRootKeys = new Set(nextArtifacts.scopes.map((scope) => scope.rootKey));
-			for (const [key] of previousArtifacts.pages.entries()) if (!nextPageKeys.has(key)) await deleteObject(key).catch(() => {});
-			for (const scope of previousArtifacts.scopes) if (!nextRootKeys.has(scope.rootKey)) await deleteObject(scope.rootKey).catch(() => {});
+			await forEachWithConcurrency(Array.from(previousArtifacts.pages.keys()).filter((key) => !nextPageKeys.has(key)), STORAGE_OPERATION_CONCURRENCY, (key) => deleteObject(key).catch(() => {}));
+			await forEachWithConcurrency(previousArtifacts.scopes.filter((scope) => !nextRootKeys.has(scope.rootKey)), STORAGE_OPERATION_CONCURRENCY, (scope) => deleteObject(scope.rootKey).catch(() => {}));
 		};
 		const ensureAllManagementRoot = async () => {
 			const storedAllRoot = await loadStoredManagementRoot({});
@@ -279,6 +310,26 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 		const loadCurrentBundlesForIndexRebuild = async () => {
 			return loadAllBundlesForManagementFallback();
 		};
+		const loadBundlesFromCanonicalManifests = async () => {
+			return sortManagedBundles((await reloadBundles()).map((bundle) => removeBundleInternalKeys(bundle)));
+		};
+		const loadStoredBundlesForIndexRebuild = loadBundlesFromCanonicalManifests;
+		const loadCanonicalBundlesForIndexRepair = loadBundlesFromCanonicalManifests;
+		const compareBundleIndex = ({ canonicalBundles, indexedBundles, rootMissing }) => {
+			const canonicalIds = new Set(canonicalBundles.map((bundle) => bundle.id));
+			const indexedIds = new Set(indexedBundles?.map((bundle) => bundle.id) ?? []);
+			const missingBundleIds = Array.from(canonicalIds).filter((id) => !indexedIds.has(id)).sort((left, right) => right.localeCompare(left));
+			const extraBundleIds = Array.from(indexedIds).filter((id) => !canonicalIds.has(id)).sort((left, right) => right.localeCompare(left));
+			return {
+				status: missingBundleIds.length === 0 && extraBundleIds.length === 0 && !rootMissing ? "ok" : rootMissing ? "missing" : "stale",
+				canonicalBundles: canonicalBundles.length,
+				indexedBundles: indexedBundles?.length ?? 0,
+				missingBundles: missingBundleIds.length,
+				extraBundles: extraBundleIds.length,
+				missingBundleIds: missingBundleIds.slice(0, 20),
+				extraBundleIds: extraBundleIds.slice(0, 20)
+			};
+		};
 		const findPageIndexContainingId = (pages, id) => {
 			return pages.findIndex((page) => id.localeCompare(page.firstId) <= 0 && id.localeCompare(page.lastId) >= 0);
 		};
@@ -454,16 +505,15 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 		};
 		async function reloadBundles() {
 			bundlesMap.clear();
-			const filePromises = (await listObjects("")).filter((key) => /^[^/]+\/(?:ios|android)\/[^/]+\/update\.json$/.test(key)).map(async (key) => {
-				return (await loadObject(key) ?? []).map((bundle) => ({
+			const allBundles = (await mapWithConcurrency((await listObjects("")).filter((key) => /^[^/]+\/(?:ios|android)\/[^/]+\/update\.json$/.test(key)), STORAGE_OPERATION_CONCURRENCY, async (key) => {
+				return (await loadOptionalObject(key) ?? []).map((bundle) => ({
 					...bundle,
 					_updateJsonKey: key
 				}));
-			});
-			const allBundles = (await Promise.all(filePromises)).flat();
+			})).flat();
 			for (const bundle of allBundles) bundlesMap.set(bundle.id, bundle);
 			for (const [id, bundle] of pendingBundlesMap.entries()) bundlesMap.set(id, bundle);
-			return orderBy(allBundles, [(v) => v.id], ["desc"]);
+			return orderBy(Array.from(bundlesMap.values()), [(v) => v.id], ["desc"]);
 		}
 		/**
 		* Updates target-app-versions.json for each channel on the given platform.
@@ -489,35 +539,44 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 				const updateKeys = keysByChannel[channel];
 				const targetKey = `${channel}/${platform}/target-app-versions.json`;
 				const currentVersions = updateKeys.map((key) => key.split("/")[2]);
-				const oldTargetVersions = await loadObject(targetKey) ?? [];
+				const oldTargetVersions = await loadOptionalObject(targetKey) ?? [];
 				const newTargetVersions = oldTargetVersions.filter((v) => currentVersions.includes(v));
 				for (const v of currentVersions) if (!newTargetVersions.includes(v)) newTargetVersions.push(v);
 				if (JSON.stringify(oldTargetVersions) !== JSON.stringify(newTargetVersions)) await uploadObject(targetKey, newTargetVersions);
 			}
 		}
-		const getAppVersionUpdateInfo = async ({ appVersion, bundleId, channel = "production", cohort, minBundleId, platform }) => {
-			const matchingVersions = filterCompatibleAppVersions(await loadObject(`${channel}/${platform}/target-app-versions.json`) ?? [], appVersion);
-			return getUpdateInfo((await Promise.allSettled(matchingVersions.map(async (targetAppVersion) => {
-				return await loadObject(`${channel}/${platform}/${normalizeTargetAppVersion(targetAppVersion) ?? targetAppVersion}/update.json`) ?? [];
-			}))).filter((entry) => entry.status === "fulfilled").flatMap((entry) => entry.value), {
-				_updateStrategy: "appVersion",
-				appVersion,
-				bundleId,
-				channel,
-				cohort,
-				minBundleId,
-				platform
+		const getAppVersionUpdateInfo = async ({ appVersion, bundleId, channel = "production", cohort, minBundleId, platform }, context) => {
+			const bundles = (await mapWithConcurrency(filterCompatibleAppVersions(await loadOptionalObject(`${channel}/${platform}/target-app-versions.json`) ?? [], appVersion), STORAGE_OPERATION_CONCURRENCY, async (targetAppVersion) => {
+				return await loadOptionalObject(`${channel}/${platform}/${normalizeTargetAppVersion(targetAppVersion) ?? targetAppVersion}/update.json`) ?? [];
+			})).flat();
+			return resolveUpdateInfoFromBundles({
+				args: {
+					_updateStrategy: "appVersion",
+					appVersion,
+					bundleId,
+					channel,
+					cohort,
+					minBundleId,
+					platform
+				},
+				bundles,
+				context
 			});
 		};
-		const getFingerprintUpdateInfo = async ({ bundleId, channel = "production", cohort, fingerprintHash, minBundleId, platform }) => {
-			return getUpdateInfo(await loadObject(`${channel}/${platform}/${fingerprintHash}/update.json`) ?? [], {
-				_updateStrategy: "fingerprint",
-				bundleId,
-				channel,
-				cohort,
-				fingerprintHash,
-				minBundleId,
-				platform
+		const getFingerprintUpdateInfo = async ({ bundleId, channel = "production", cohort, fingerprintHash, minBundleId, platform }, context) => {
+			const bundles = await loadOptionalObject(`${channel}/${platform}/${fingerprintHash}/update.json`) ?? [];
+			return resolveUpdateInfoFromBundles({
+				args: {
+					_updateStrategy: "fingerprint",
+					bundleId,
+					channel,
+					cohort,
+					fingerprintHash,
+					minBundleId,
+					platform
+				},
+				bundles,
+				context
 			});
 		};
 		const addAppVersionInvalidationPaths = (pathsToInvalidate, { platform, channel, targetAppVersion }) => {
@@ -539,7 +598,35 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 				targetAppVersion
 			});
 		};
-		return createDatabasePlugin({
+		const bundleIndexDiagnostics = {
+			async check() {
+				const canonicalBundles = await loadCanonicalBundlesForIndexRepair();
+				const allRoot = await loadStoredManagementRoot({});
+				return compareBundleIndex({
+					canonicalBundles,
+					indexedBundles: allRoot ? await loadAllBundlesFromRoot(allRoot) : null,
+					rootMissing: !allRoot
+				});
+			},
+			async repair() {
+				const canonicalBundles = await loadCanonicalBundlesForIndexRepair();
+				const previousRoot = await loadStoredManagementRoot({});
+				const previousBundles = previousRoot ? await loadAllBundlesFromRoot(previousRoot) : null;
+				const previousArtifacts = previousRoot && previousBundles ? buildManagementIndexArtifacts(previousBundles, previousRoot.pageSize) : void 0;
+				const nextArtifacts = buildManagementIndexArtifacts(canonicalBundles, managementIndexPageSize);
+				const indexedObjectKeys = await listObjects(`${MANAGEMENT_INDEX_PREFIX}/`);
+				const nextObjectKeys = new Set([...nextArtifacts.pages.keys(), ...nextArtifacts.scopes.map((scope) => scope.rootKey)]);
+				await persistManagementIndexArtifacts(nextArtifacts, previousArtifacts);
+				await forEachWithConcurrency(indexedObjectKeys.filter((key) => !nextObjectKeys.has(key)), STORAGE_OPERATION_CONCURRENCY, (key) => deleteObject(key).catch(() => {}));
+				replaceManagementRootCache(nextArtifacts);
+				return {
+					scannedBundles: canonicalBundles.length,
+					indexedBundles: canonicalBundles.length,
+					...summarizeManagementIndexArtifacts(nextArtifacts)
+				};
+			}
+		};
+		const createPlugin = createDatabasePlugin({
 			name,
 			factory: () => ({
 				supportsCursorPagination: true,
@@ -563,9 +650,9 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 					if (!matchedBundle) return null;
 					return removeBundleInternalKeys(matchedBundle);
 				},
-				async getUpdateInfo(args) {
-					if (args._updateStrategy === "appVersion") return getAppVersionUpdateInfo(args);
-					return getFingerprintUpdateInfo(args);
+				async getUpdateInfo(args, context) {
+					if (args._updateStrategy === "appVersion") return getAppVersionUpdateInfo(args, context);
+					return getFingerprintUpdateInfo(args, context);
 				},
 				async getBundles(options) {
 					const { where, limit, offset, orderBy, cursor } = options;
@@ -598,11 +685,8 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 					const changedBundlesByKey = {};
 					const removalsByKey = {};
 					const pathsToInvalidate = /* @__PURE__ */ new Set();
-					let isTargetAppVersionChanged = false;
-					let isChannelChanged = false;
+					const targetVersionPlatforms = /* @__PURE__ */ new Set();
 					for (const { operation, data } of changedSets) {
-						if (data.targetAppVersion !== void 0) isTargetAppVersionChanged = true;
-						if (operation === "update" && data.channel !== void 0) isChannelChanged = true;
 						if (operation === "insert") {
 							const target = resolveStorageTarget(data);
 							const key = `${data.channel}/${data.platform}/${target}/update.json`;
@@ -614,6 +698,7 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 							pendingBundlesMap.set(data.id, bundleWithKey);
 							changedBundlesByKey[key] = changedBundlesByKey[key] || [];
 							changedBundlesByKey[key].push(removeBundleInternalKeys(bundleWithKey));
+							if (data.targetAppVersion !== void 0) targetVersionPlatforms.add(data.platform);
 							addLookupInvalidationPaths(pathsToInvalidate, data);
 							continue;
 						}
@@ -626,6 +711,7 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 							const key = bundle._updateJsonKey;
 							removalsByKey[key] = removalsByKey[key] || [];
 							removalsByKey[key].push(bundle.id);
+							if (bundle.targetAppVersion !== void 0) targetVersionPlatforms.add(bundle.platform);
 							addLookupInvalidationPaths(pathsToInvalidate, bundle);
 							continue;
 						}
@@ -657,6 +743,10 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 										channel: nextChannel
 									});
 								}
+								if (bundle.targetAppVersion !== void 0 || updatedBundle.targetAppVersion !== void 0) {
+									targetVersionPlatforms.add(bundle.platform);
+									targetVersionPlatforms.add(updatedBundle.platform);
+								}
 								addLookupInvalidationPaths(pathsToInvalidate, updatedBundle);
 								if (bundle.targetAppVersion && bundle.targetAppVersion !== updatedBundle.targetAppVersion) addLookupInvalidationPaths(pathsToInvalidate, bundle);
 								continue;
@@ -670,14 +760,14 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 							if (bundle.targetAppVersion && bundle.targetAppVersion !== updatedBundle.targetAppVersion) addLookupInvalidationPaths(pathsToInvalidate, bundle);
 						}
 					}
-					for (const oldKey of Object.keys(removalsByKey)) await (async () => {
-						const updatedBundles = (await loadObject(oldKey) ?? []).filter((b) => !removalsByKey[oldKey].includes(b.id));
+					await forEachWithConcurrency(Object.keys(removalsByKey), STORAGE_OPERATION_CONCURRENCY, async (oldKey) => {
+						const updatedBundles = (await loadOptionalObject(oldKey) ?? []).filter((b) => !removalsByKey[oldKey].includes(b.id));
 						updatedBundles.sort((a, b) => b.id.localeCompare(a.id));
 						if (updatedBundles.length === 0) await deleteObject(oldKey);
 						else await uploadObject(oldKey, updatedBundles);
-					})();
-					for (const key of Object.keys(changedBundlesByKey)) await (async () => {
-						const currentBundles = await loadObject(key) ?? [];
+					});
+					await forEachWithConcurrency(Object.keys(changedBundlesByKey), STORAGE_OPERATION_CONCURRENCY, async (key) => {
+						const currentBundles = await loadOptionalObject(key) ?? [];
 						const pureBundles = changedBundlesByKey[key].map((bundle) => bundle);
 						for (const changedBundle of pureBundles) {
 							const index = currentBundles.findIndex((b) => b.id === changedBundle.id);
@@ -686,10 +776,11 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 						}
 						currentBundles.sort((a, b) => b.id.localeCompare(a.id));
 						await uploadObject(key, currentBundles);
-					})();
-					if (isTargetAppVersionChanged || isChannelChanged) for (const platform of PLATFORMS) await updateTargetVersionsForPlatform(platform);
-					const currentIndexBundles = await loadCurrentBundlesForIndexRebuild();
-					const nextIndexMap = new Map(currentIndexBundles.map((bundle) => [bundle.id, bundle]));
+					});
+					if (targetVersionPlatforms.size > 0) await Promise.all(Array.from(targetVersionPlatforms).map((platform) => updateTargetVersionsForPlatform(platform)));
+					const previousIndexBundles = await loadCurrentBundlesForIndexRebuild();
+					const storedIndexBundles = await loadStoredBundlesForIndexRebuild();
+					const nextIndexMap = new Map(storedIndexBundles.map((bundle) => [bundle.id, bundle]));
 					for (const { operation, data } of changedSets) {
 						if (operation === "delete") {
 							nextIndexMap.delete(data.id);
@@ -698,7 +789,7 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 						nextIndexMap.set(data.id, data);
 					}
 					const nextIndexBundles = sortManagedBundles(Array.from(nextIndexMap.values()));
-					const previousArtifacts = buildManagementIndexArtifacts(currentIndexBundles, managementIndexPageSize);
+					const previousArtifacts = buildManagementIndexArtifacts(previousIndexBundles, managementIndexPageSize);
 					const nextArtifacts = buildManagementIndexArtifacts(nextIndexBundles, managementIndexPageSize);
 					await persistManagementIndexArtifacts(nextArtifacts, previousArtifacts);
 					replaceManagementRootCache(nextArtifacts);
@@ -709,6 +800,15 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 				}
 			})
 		})({}, hooks);
+		return () => {
+			const plugin = createPlugin();
+			Object.defineProperty(plugin, "diagnostics", {
+				configurable: true,
+				enumerable: true,
+				value: { bundleIndex: bundleIndexDiagnostics }
+			});
+			return plugin;
+		};
 	};
 };
 //#endregion

package/dist/createDatabasePluginGetUpdateInfo.cjs

@@ -1,6 +1,6 @@
 require("./_virtual/_rolldown/runtime.cjs");
 const require_filterCompatibleAppVersions = require("./filterCompatibleAppVersions.cjs");
-let _hot_updater_js = require("@hot-updater/js");
+const require_resolveUpdateInfoFromBundles = require("./resolveUpdateInfoFromBundles.cjs");
 let _hot_updater_core = require("@hot-updater/core");
 //#region src/createDatabasePluginGetUpdateInfo.ts
 const normalizeAppVersionArgs = (args) => ({
@@ -18,10 +18,18 @@ const createDatabasePluginGetUpdateInfo = ({ getBundlesByFingerprint, getBundles
 		if (args._updateStrategy === "appVersion") {
 			const normalizedArgs = normalizeAppVersionArgs(args);
 			const compatibleAppVersions = require_filterCompatibleAppVersions.filterCompatibleAppVersions(await listTargetAppVersions(normalizedArgs, context), normalizedArgs.appVersion);
-			return (0, _hot_updater_js.getUpdateInfo)(compatibleAppVersions.length > 0 ? await getBundlesByTargetAppVersions(normalizedArgs, compatibleAppVersions, context) : [], normalizedArgs);
+			return require_resolveUpdateInfoFromBundles.resolveUpdateInfoFromBundles({
+				args: normalizedArgs,
+				bundles: compatibleAppVersions.length > 0 ? await getBundlesByTargetAppVersions(normalizedArgs, compatibleAppVersions, context) : [],
+				context
+			});
 		}
 		const normalizedArgs = normalizeFingerprintArgs(args);
-		return (0, _hot_updater_js.getUpdateInfo)(await getBundlesByFingerprint(normalizedArgs, context), normalizedArgs);
+		return require_resolveUpdateInfoFromBundles.resolveUpdateInfoFromBundles({
+			args: normalizedArgs,
+			bundles: await getBundlesByFingerprint(normalizedArgs, context),
+			context
+		});
 	};
 };
 //#endregion

package/dist/createDatabasePluginGetUpdateInfo.mjs

@@ -1,5 +1,5 @@
 import { filterCompatibleAppVersions } from "./filterCompatibleAppVersions.mjs";
-import { getUpdateInfo } from "@hot-updater/js";
+import { resolveUpdateInfoFromBundles } from "./resolveUpdateInfoFromBundles.mjs";
 import { NIL_UUID } from "@hot-updater/core";
 //#region src/createDatabasePluginGetUpdateInfo.ts
 const normalizeAppVersionArgs = (args) => ({
@@ -17,10 +17,18 @@ const createDatabasePluginGetUpdateInfo = ({ getBundlesByFingerprint, getBundles
 		if (args._updateStrategy === "appVersion") {
 			const normalizedArgs = normalizeAppVersionArgs(args);
 			const compatibleAppVersions = filterCompatibleAppVersions(await listTargetAppVersions(normalizedArgs, context), normalizedArgs.appVersion);
-			return getUpdateInfo(compatibleAppVersions.length > 0 ? await getBundlesByTargetAppVersions(normalizedArgs, compatibleAppVersions, context) : [], normalizedArgs);
+			return resolveUpdateInfoFromBundles({
+				args: normalizedArgs,
+				bundles: compatibleAppVersions.length > 0 ? await getBundlesByTargetAppVersions(normalizedArgs, compatibleAppVersions, context) : [],
+				context
+			});
 		}
 		const normalizedArgs = normalizeFingerprintArgs(args);
-		return getUpdateInfo(await getBundlesByFingerprint(normalizedArgs, context), normalizedArgs);
+		return resolveUpdateInfoFromBundles({
+			args: normalizedArgs,
+			bundles: await getBundlesByFingerprint(normalizedArgs, context),
+			context
+		});
 	};
 };
 //#endregion

package/dist/index.cjs

@@ -8,6 +8,8 @@ const require_semverSatisfies = require("./semverSatisfies.cjs");
 const require_filterCompatibleAppVersions = require("./filterCompatibleAppVersions.cjs");
 const require_queryBundles = require("./queryBundles.cjs");
 const require_paginateBundles = require("./paginateBundles.cjs");
+const require_requestUpdateBundleState = require("./requestUpdateBundleState.cjs");
+const require_resolveUpdateInfoFromBundles = require("./resolveUpdateInfoFromBundles.cjs");
 const require_createBlobDatabasePlugin = require("./createBlobDatabasePlugin.cjs");
 const require_createDatabasePluginGetUpdateInfo = require("./createDatabasePluginGetUpdateInfo.cjs");
 const require_createStorageKeyBuilder = require("./createStorageKeyBuilder.cjs");
@@ -41,12 +43,14 @@ exports.getCompressionMimeType = require_compressionFormat.getCompressionMimeTyp
 exports.getContentAddressedAssetStoragePath = require_contentAddressedAssets.getContentAddressedAssetStoragePath;
 exports.getContentType = require_compressionFormat.getContentType;
 exports.getManifestAssetStoragePath = require_assetStorageLayout.getManifestAssetStoragePath;
+exports.getRequestUpdateBundleSeeds = require_requestUpdateBundleState.getRequestUpdateBundleSeeds;
 exports.isContentAddressedAssetBaseStorageUri = require_assetStorageLayout.isContentAddressedAssetBaseStorageUri;
 exports.isNodeStoragePlugin = require_storageProfile.isNodeStoragePlugin;
 exports.isRuntimeStoragePlugin = require_storageProfile.isRuntimeStoragePlugin;
 exports.paginateBundles = require_paginateBundles.paginateBundles;
 exports.parseStorageUri = require_parseStorageUri.parseStorageUri;
 exports.resolveManifestAssetStorageUri = require_assetStorageLayout.resolveManifestAssetStorageUri;
+exports.resolveUpdateInfoFromBundles = require_resolveUpdateInfoFromBundles.resolveUpdateInfoFromBundles;
 exports.semverSatisfies = require_semverSatisfies.semverSatisfies;
 exports.sortBundles = require_queryBundles.sortBundles;
 exports.supportedIosPlatforms = require_index.supportedIosPlatforms;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { BuiltIns, HasMultipleCallSignatures, Primitive, RequiredDeep } from "./types/utils.cjs";
-import { AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, Bundle, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintGetBundlesArgs, GetBundlesArgs, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, NodeStoragePlugin, NodeStorageProfile, Paginated, PaginatedResult, PaginationInfo, Platform, PlatformConfig, RequestEnvContext, RuntimeStoragePlugin, RuntimeStorageProfile, SigningConfig, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, UpdateInfo, supportedIosPlatforms } from "./types/index.cjs";
+import { AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, Bundle, BundleIndexDiagnostics, BundleIndexHealth, BundleIndexRepairResult, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabaseDiagnostics, DatabasePlugin, DatabasePluginHooks, FingerprintGetBundlesArgs, GetBundlesArgs, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, NodeStoragePlugin, NodeStorageProfile, Paginated, PaginatedResult, PaginationInfo, Platform, PlatformConfig, RequestEnvContext, RuntimeStoragePlugin, RuntimeStorageProfile, SigningConfig, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, UpdateInfo, supportedIosPlatforms } from "./types/index.cjs";
 import { PaginationOptions, calculatePagination } from "./calculatePagination.cjs";
 import { CompressionFormat, CompressionFormatInfo, detectCompressionFormat, getCompressionMimeType, getContentType } from "./compressionFormat.cjs";
 import { AssetStorageLayout, createStorageUriWithRelativePath, getAssetStorageLayout, getManifestAssetStoragePath, isContentAddressedAssetBaseStorageUri, resolveManifestAssetStorageUri } from "./assetStorageLayout.cjs";
@@ -14,7 +14,9 @@ import { generateMinBundleId } from "./generateMinBundleId.cjs";
 import { ParsedStorageUri, parseStorageUri } from "./parseStorageUri.cjs";
 import { paginateBundles } from "./paginateBundles.cjs";
 import { bundleIdMatchesFilter, bundleMatchesQueryWhere, sortBundles } from "./queryBundles.cjs";
+import { getRequestUpdateBundleSeeds } from "./requestUpdateBundleState.cjs";
+import { ResolveUpdateInfoFromBundlesOptions, resolveUpdateInfoFromBundles } from "./resolveUpdateInfoFromBundles.cjs";
 import { semverSatisfies } from "./semverSatisfies.cjs";
 import { assertNodeStoragePlugin, assertRuntimeStoragePlugin, isNodeStoragePlugin, isRuntimeStoragePlugin } from "./storageProfile.cjs";
 import { createUUIDv7, createUUIDv7WithSameTimestamp, extractTimestampFromUUIDv7 } from "./uuidv7.cjs";
-export { AbstractDatabasePlugin, AppVersionGetBundlesArgs, ApplePlatform, AssetStorageLayout, BasePluginArgs, BlobDatabasePluginConfig, BlobOperations, BuildPlugin, BuildPluginConfig, BuiltIns, Bundle, CompressionFormat, CompressionFormatInfo, ConfigInput, CreateDatabasePluginGetUpdateInfoOptions, CreateDatabasePluginOptions, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintGetBundlesArgs, GetBundlesArgs, HasMultipleCallSignatures, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, NodeStoragePlugin, NodeStorageProfile, Paginated, PaginatedResult, PaginationInfo, PaginationOptions, ParsedStorageUri, Platform, PlatformConfig, Primitive, RequestEnvContext, RequiredDeep, RuntimeStoragePlugin, RuntimeStorageProfile, SigningConfig, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, UpdateInfo, assertNodeStoragePlugin, assertRuntimeStoragePlugin, bundleIdMatchesFilter, bundleMatchesQueryWhere, calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createDatabasePluginGetUpdateInfo, createNodeStoragePlugin, createRuntimeStoragePlugin, createStorageKeyBuilder, createStorageUriWithRelativePath, createUUIDv7, createUUIDv7WithSameTimestamp, createUniversalStoragePlugin, detectCompressionFormat, extractTimestampFromUUIDv7, filterCompatibleAppVersions, generateMinBundleId, getAssetStorageLayout, getCompressionMimeType, getContentAddressedAssetStoragePath, getContentType, getManifestAssetStoragePath, isContentAddressedAssetBaseStorageUri, isNodeStoragePlugin, isRuntimeStoragePlugin, paginateBundles, parseStorageUri, resolveManifestAssetStorageUri, semverSatisfies, sortBundles, supportedIosPlatforms };
+export { AbstractDatabasePlugin, AppVersionGetBundlesArgs, ApplePlatform, AssetStorageLayout, BasePluginArgs, BlobDatabasePluginConfig, BlobOperations, BuildPlugin, BuildPluginConfig, BuiltIns, Bundle, BundleIndexDiagnostics, BundleIndexHealth, BundleIndexRepairResult, CompressionFormat, CompressionFormatInfo, ConfigInput, CreateDatabasePluginGetUpdateInfoOptions, CreateDatabasePluginOptions, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabaseDiagnostics, DatabasePlugin, DatabasePluginHooks, FingerprintGetBundlesArgs, GetBundlesArgs, HasMultipleCallSignatures, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, NodeStoragePlugin, NodeStorageProfile, Paginated, PaginatedResult, PaginationInfo, PaginationOptions, ParsedStorageUri, Platform, PlatformConfig, Primitive, RequestEnvContext, RequiredDeep, ResolveUpdateInfoFromBundlesOptions, RuntimeStoragePlugin, RuntimeStorageProfile, SigningConfig, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, UpdateInfo, assertNodeStoragePlugin, assertRuntimeStoragePlugin, bundleIdMatchesFilter, bundleMatchesQueryWhere, calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createDatabasePluginGetUpdateInfo, createNodeStoragePlugin, createRuntimeStoragePlugin, createStorageKeyBuilder, createStorageUriWithRelativePath, createUUIDv7, createUUIDv7WithSameTimestamp, createUniversalStoragePlugin, detectCompressionFormat, extractTimestampFromUUIDv7, filterCompatibleAppVersions, generateMinBundleId, getAssetStorageLayout, getCompressionMimeType, getContentAddressedAssetStoragePath, getContentType, getManifestAssetStoragePath, getRequestUpdateBundleSeeds, isContentAddressedAssetBaseStorageUri, isNodeStoragePlugin, isRuntimeStoragePlugin, paginateBundles, parseStorageUri, resolveManifestAssetStorageUri, resolveUpdateInfoFromBundles, semverSatisfies, sortBundles, supportedIosPlatforms };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { BuiltIns, HasMultipleCallSignatures, Primitive, RequiredDeep } from "./types/utils.mjs";
-import { AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, Bundle, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintGetBundlesArgs, GetBundlesArgs, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, NodeStoragePlugin, NodeStorageProfile, Paginated, PaginatedResult, PaginationInfo, Platform, PlatformConfig, RequestEnvContext, RuntimeStoragePlugin, RuntimeStorageProfile, SigningConfig, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, UpdateInfo, supportedIosPlatforms } from "./types/index.mjs";
+import { AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, Bundle, BundleIndexDiagnostics, BundleIndexHealth, BundleIndexRepairResult, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabaseDiagnostics, DatabasePlugin, DatabasePluginHooks, FingerprintGetBundlesArgs, GetBundlesArgs, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, NodeStoragePlugin, NodeStorageProfile, Paginated, PaginatedResult, PaginationInfo, Platform, PlatformConfig, RequestEnvContext, RuntimeStoragePlugin, RuntimeStorageProfile, SigningConfig, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, UpdateInfo, supportedIosPlatforms } from "./types/index.mjs";
 import { PaginationOptions, calculatePagination } from "./calculatePagination.mjs";
 import { CompressionFormat, CompressionFormatInfo, detectCompressionFormat, getCompressionMimeType, getContentType } from "./compressionFormat.mjs";
 import { AssetStorageLayout, createStorageUriWithRelativePath, getAssetStorageLayout, getManifestAssetStoragePath, isContentAddressedAssetBaseStorageUri, resolveManifestAssetStorageUri } from "./assetStorageLayout.mjs";
@@ -14,7 +14,9 @@ import { generateMinBundleId } from "./generateMinBundleId.mjs";
 import { ParsedStorageUri, parseStorageUri } from "./parseStorageUri.mjs";
 import { paginateBundles } from "./paginateBundles.mjs";
 import { bundleIdMatchesFilter, bundleMatchesQueryWhere, sortBundles } from "./queryBundles.mjs";
+import { getRequestUpdateBundleSeeds } from "./requestUpdateBundleState.mjs";
+import { ResolveUpdateInfoFromBundlesOptions, resolveUpdateInfoFromBundles } from "./resolveUpdateInfoFromBundles.mjs";
 import { semverSatisfies } from "./semverSatisfies.mjs";
 import { assertNodeStoragePlugin, assertRuntimeStoragePlugin, isNodeStoragePlugin, isRuntimeStoragePlugin } from "./storageProfile.mjs";
 import { createUUIDv7, createUUIDv7WithSameTimestamp, extractTimestampFromUUIDv7 } from "./uuidv7.mjs";
-export { AbstractDatabasePlugin, AppVersionGetBundlesArgs, ApplePlatform, AssetStorageLayout, BasePluginArgs, BlobDatabasePluginConfig, BlobOperations, BuildPlugin, BuildPluginConfig, BuiltIns, Bundle, CompressionFormat, CompressionFormatInfo, ConfigInput, CreateDatabasePluginGetUpdateInfoOptions, CreateDatabasePluginOptions, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintGetBundlesArgs, GetBundlesArgs, HasMultipleCallSignatures, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, NodeStoragePlugin, NodeStorageProfile, Paginated, PaginatedResult, PaginationInfo, PaginationOptions, ParsedStorageUri, Platform, PlatformConfig, Primitive, RequestEnvContext, RequiredDeep, RuntimeStoragePlugin, RuntimeStorageProfile, SigningConfig, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, UpdateInfo, assertNodeStoragePlugin, assertRuntimeStoragePlugin, bundleIdMatchesFilter, bundleMatchesQueryWhere, calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createDatabasePluginGetUpdateInfo, createNodeStoragePlugin, createRuntimeStoragePlugin, createStorageKeyBuilder, createStorageUriWithRelativePath, createUUIDv7, createUUIDv7WithSameTimestamp, createUniversalStoragePlugin, detectCompressionFormat, extractTimestampFromUUIDv7, filterCompatibleAppVersions, generateMinBundleId, getAssetStorageLayout, getCompressionMimeType, getContentAddressedAssetStoragePath, getContentType, getManifestAssetStoragePath, isContentAddressedAssetBaseStorageUri, isNodeStoragePlugin, isRuntimeStoragePlugin, paginateBundles, parseStorageUri, resolveManifestAssetStorageUri, semverSatisfies, sortBundles, supportedIosPlatforms };
+export { AbstractDatabasePlugin, AppVersionGetBundlesArgs, ApplePlatform, AssetStorageLayout, BasePluginArgs, BlobDatabasePluginConfig, BlobOperations, BuildPlugin, BuildPluginConfig, BuiltIns, Bundle, BundleIndexDiagnostics, BundleIndexHealth, BundleIndexRepairResult, CompressionFormat, CompressionFormatInfo, ConfigInput, CreateDatabasePluginGetUpdateInfoOptions, CreateDatabasePluginOptions, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabaseDiagnostics, DatabasePlugin, DatabasePluginHooks, FingerprintGetBundlesArgs, GetBundlesArgs, HasMultipleCallSignatures, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, NodeStoragePlugin, NodeStorageProfile, Paginated, PaginatedResult, PaginationInfo, PaginationOptions, ParsedStorageUri, Platform, PlatformConfig, Primitive, RequestEnvContext, RequiredDeep, ResolveUpdateInfoFromBundlesOptions, RuntimeStoragePlugin, RuntimeStorageProfile, SigningConfig, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, UpdateInfo, assertNodeStoragePlugin, assertRuntimeStoragePlugin, bundleIdMatchesFilter, bundleMatchesQueryWhere, calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createDatabasePluginGetUpdateInfo, createNodeStoragePlugin, createRuntimeStoragePlugin, createStorageKeyBuilder, createStorageUriWithRelativePath, createUUIDv7, createUUIDv7WithSameTimestamp, createUniversalStoragePlugin, detectCompressionFormat, extractTimestampFromUUIDv7, filterCompatibleAppVersions, generateMinBundleId, getAssetStorageLayout, getCompressionMimeType, getContentAddressedAssetStoragePath, getContentType, getManifestAssetStoragePath, getRequestUpdateBundleSeeds, isContentAddressedAssetBaseStorageUri, isNodeStoragePlugin, isRuntimeStoragePlugin, paginateBundles, parseStorageUri, resolveManifestAssetStorageUri, resolveUpdateInfoFromBundles, semverSatisfies, sortBundles, supportedIosPlatforms };

package/dist/index.mjs

@@ -7,6 +7,8 @@ import { semverSatisfies } from "./semverSatisfies.mjs";
 import { filterCompatibleAppVersions } from "./filterCompatibleAppVersions.mjs";
 import { bundleIdMatchesFilter, bundleMatchesQueryWhere, sortBundles } from "./queryBundles.mjs";
 import { paginateBundles } from "./paginateBundles.mjs";
+import { getRequestUpdateBundleSeeds } from "./requestUpdateBundleState.mjs";
+import { resolveUpdateInfoFromBundles } from "./resolveUpdateInfoFromBundles.mjs";
 import { createBlobDatabasePlugin } from "./createBlobDatabasePlugin.mjs";
 import { createDatabasePluginGetUpdateInfo } from "./createDatabasePluginGetUpdateInfo.mjs";
 import { createStorageKeyBuilder } from "./createStorageKeyBuilder.mjs";
@@ -16,4 +18,4 @@ import { parseStorageUri } from "./parseStorageUri.mjs";
 import { assertNodeStoragePlugin, assertRuntimeStoragePlugin, isNodeStoragePlugin, isRuntimeStoragePlugin } from "./storageProfile.mjs";
 import { supportedIosPlatforms } from "./types/index.mjs";
 import { createUUIDv7, createUUIDv7WithSameTimestamp, extractTimestampFromUUIDv7 } from "./uuidv7.mjs";
-export { assertNodeStoragePlugin, assertRuntimeStoragePlugin, bundleIdMatchesFilter, bundleMatchesQueryWhere, calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createDatabasePluginGetUpdateInfo, createNodeStoragePlugin, createRuntimeStoragePlugin, createStorageKeyBuilder, createStorageUriWithRelativePath, createUUIDv7, createUUIDv7WithSameTimestamp, createUniversalStoragePlugin, detectCompressionFormat, extractTimestampFromUUIDv7, filterCompatibleAppVersions, generateMinBundleId, getAssetStorageLayout, getCompressionMimeType, getContentAddressedAssetStoragePath, getContentType, getManifestAssetStoragePath, isContentAddressedAssetBaseStorageUri, isNodeStoragePlugin, isRuntimeStoragePlugin, paginateBundles, parseStorageUri, resolveManifestAssetStorageUri, semverSatisfies, sortBundles, supportedIosPlatforms };
+export { assertNodeStoragePlugin, assertRuntimeStoragePlugin, bundleIdMatchesFilter, bundleMatchesQueryWhere, calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createDatabasePluginGetUpdateInfo, createNodeStoragePlugin, createRuntimeStoragePlugin, createStorageKeyBuilder, createStorageUriWithRelativePath, createUUIDv7, createUUIDv7WithSameTimestamp, createUniversalStoragePlugin, detectCompressionFormat, extractTimestampFromUUIDv7, filterCompatibleAppVersions, generateMinBundleId, getAssetStorageLayout, getCompressionMimeType, getContentAddressedAssetStoragePath, getContentType, getManifestAssetStoragePath, getRequestUpdateBundleSeeds, isContentAddressedAssetBaseStorageUri, isNodeStoragePlugin, isRuntimeStoragePlugin, paginateBundles, parseStorageUri, resolveManifestAssetStorageUri, resolveUpdateInfoFromBundles, semverSatisfies, sortBundles, supportedIosPlatforms };

package/dist/requestUpdateBundleState.cjs

@@ -0,0 +1,20 @@
+//#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
+exports.getRequestUpdateBundleSeeds = getRequestUpdateBundleSeeds;
+exports.seedRequestUpdateBundles = seedRequestUpdateBundles;

package/dist/requestUpdateBundleState.d.cts

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

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/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>;
@@ -504,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>;
@@ -504,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.32.0",
+  "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.32.0",
-    "@hot-updater/js": "0.32.0"
+    "@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.32.0"
+    "@hot-updater/test-utils": "0.33.0"
   },
   "scripts": {
     "build": "tsdown",