@hot-updater/plugin-core 0.31.3 → 0.32.0

package/dist/assetStorageLayout.cjs

@@ -0,0 +1,34 @@
+const require_contentAddressedAssets = require("./contentAddressedAssets.cjs");
+const require_legacyAssetStorageLayout = require("./legacyAssetStorageLayout.cjs");
+//#region src/assetStorageLayout.ts
+const createStorageUriWithRelativePath = ({ baseStorageUri, relativePath }) => {
+	const storageUrl = new URL(baseStorageUri);
+	storageUrl.pathname = `${storageUrl.pathname.replace(/\/+$/, "")}/${relativePath.replace(/\\/g, "/").split("/").filter(Boolean).map((segment) => encodeURIComponent(segment)).join("/")}`;
+	return storageUrl.toString();
+};
+const getAssetStorageLayout = (assetBaseStorageUri) => {
+	const pathname = new URL(assetBaseStorageUri).pathname.replace(/\/+$/, "");
+	return pathname.endsWith("/assets") || pathname === "/assets" ? "content-addressed" : "legacy-files";
+};
+const isContentAddressedAssetBaseStorageUri = (assetBaseStorageUri) => getAssetStorageLayout(assetBaseStorageUri) === "content-addressed";
+const getManifestAssetStoragePath = ({ assetBaseStorageUri, assetPath, fileHash }) => {
+	if (getAssetStorageLayout(assetBaseStorageUri) === "content-addressed") return require_contentAddressedAssets.getContentAddressedAssetStoragePath({
+		assetPath,
+		fileHash
+	});
+	return require_legacyAssetStorageLayout.getLegacyManifestAssetStoragePath({ assetPath });
+};
+const resolveManifestAssetStorageUri = ({ assetBaseStorageUri, assetPath, fileHash }) => createStorageUriWithRelativePath({
+	baseStorageUri: assetBaseStorageUri,
+	relativePath: getManifestAssetStoragePath({
+		assetBaseStorageUri,
+		assetPath,
+		fileHash
+	})
+});
+//#endregion
+exports.createStorageUriWithRelativePath = createStorageUriWithRelativePath;
+exports.getAssetStorageLayout = getAssetStorageLayout;
+exports.getManifestAssetStoragePath = getManifestAssetStoragePath;
+exports.isContentAddressedAssetBaseStorageUri = isContentAddressedAssetBaseStorageUri;
+exports.resolveManifestAssetStorageUri = resolveManifestAssetStorageUri;

package/dist/assetStorageLayout.d.cts

@@ -0,0 +1,31 @@
+//#region src/assetStorageLayout.d.ts
+type AssetStorageLayout = "content-addressed" | "legacy-files";
+declare const createStorageUriWithRelativePath: ({
+  baseStorageUri,
+  relativePath
+}: {
+  baseStorageUri: string;
+  relativePath: string;
+}) => string;
+declare const getAssetStorageLayout: (assetBaseStorageUri: string) => AssetStorageLayout;
+declare const isContentAddressedAssetBaseStorageUri: (assetBaseStorageUri: string) => boolean;
+declare const getManifestAssetStoragePath: ({
+  assetBaseStorageUri,
+  assetPath,
+  fileHash
+}: {
+  assetBaseStorageUri: string;
+  assetPath: string;
+  fileHash: string;
+}) => string;
+declare const resolveManifestAssetStorageUri: ({
+  assetBaseStorageUri,
+  assetPath,
+  fileHash
+}: {
+  assetBaseStorageUri: string;
+  assetPath: string;
+  fileHash: string;
+}) => string;
+//#endregion
+export { AssetStorageLayout, createStorageUriWithRelativePath, getAssetStorageLayout, getManifestAssetStoragePath, isContentAddressedAssetBaseStorageUri, resolveManifestAssetStorageUri };

package/dist/assetStorageLayout.d.mts

@@ -0,0 +1,31 @@
+//#region src/assetStorageLayout.d.ts
+type AssetStorageLayout = "content-addressed" | "legacy-files";
+declare const createStorageUriWithRelativePath: ({
+  baseStorageUri,
+  relativePath
+}: {
+  baseStorageUri: string;
+  relativePath: string;
+}) => string;
+declare const getAssetStorageLayout: (assetBaseStorageUri: string) => AssetStorageLayout;
+declare const isContentAddressedAssetBaseStorageUri: (assetBaseStorageUri: string) => boolean;
+declare const getManifestAssetStoragePath: ({
+  assetBaseStorageUri,
+  assetPath,
+  fileHash
+}: {
+  assetBaseStorageUri: string;
+  assetPath: string;
+  fileHash: string;
+}) => string;
+declare const resolveManifestAssetStorageUri: ({
+  assetBaseStorageUri,
+  assetPath,
+  fileHash
+}: {
+  assetBaseStorageUri: string;
+  assetPath: string;
+  fileHash: string;
+}) => string;
+//#endregion
+export { AssetStorageLayout, createStorageUriWithRelativePath, getAssetStorageLayout, getManifestAssetStoragePath, isContentAddressedAssetBaseStorageUri, resolveManifestAssetStorageUri };

package/dist/assetStorageLayout.mjs

@@ -0,0 +1,30 @@
+import { getContentAddressedAssetStoragePath } from "./contentAddressedAssets.mjs";
+import { getLegacyManifestAssetStoragePath } from "./legacyAssetStorageLayout.mjs";
+//#region src/assetStorageLayout.ts
+const createStorageUriWithRelativePath = ({ baseStorageUri, relativePath }) => {
+	const storageUrl = new URL(baseStorageUri);
+	storageUrl.pathname = `${storageUrl.pathname.replace(/\/+$/, "")}/${relativePath.replace(/\\/g, "/").split("/").filter(Boolean).map((segment) => encodeURIComponent(segment)).join("/")}`;
+	return storageUrl.toString();
+};
+const getAssetStorageLayout = (assetBaseStorageUri) => {
+	const pathname = new URL(assetBaseStorageUri).pathname.replace(/\/+$/, "");
+	return pathname.endsWith("/assets") || pathname === "/assets" ? "content-addressed" : "legacy-files";
+};
+const isContentAddressedAssetBaseStorageUri = (assetBaseStorageUri) => getAssetStorageLayout(assetBaseStorageUri) === "content-addressed";
+const getManifestAssetStoragePath = ({ assetBaseStorageUri, assetPath, fileHash }) => {
+	if (getAssetStorageLayout(assetBaseStorageUri) === "content-addressed") return getContentAddressedAssetStoragePath({
+		assetPath,
+		fileHash
+	});
+	return getLegacyManifestAssetStoragePath({ assetPath });
+};
+const resolveManifestAssetStorageUri = ({ assetBaseStorageUri, assetPath, fileHash }) => createStorageUriWithRelativePath({
+	baseStorageUri: assetBaseStorageUri,
+	relativePath: getManifestAssetStoragePath({
+		assetBaseStorageUri,
+		assetPath,
+		fileHash
+	})
+});
+//#endregion
+export { createStorageUriWithRelativePath, getAssetStorageLayout, getManifestAssetStoragePath, isContentAddressedAssetBaseStorageUri, resolveManifestAssetStorageUri };

package/dist/compressionFormat.cjs

@@ -1,8 +1,8 @@
 const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
 let node_path = require("node:path");
-node_path = require_runtime.__toESM(node_path, 1);
+node_path = require_runtime.__toESM(node_path);
 let mime = require("mime");
-mime = require_runtime.__toESM(mime, 1);
+mime = require_runtime.__toESM(mime);
 //#region src/compressionFormat.ts
 /**
 * Compression formats registry

package/dist/contentAddressedAssets.cjs

@@ -0,0 +1,7 @@
+//#region src/contentAddressedAssets.ts
+const getContentAddressedAssetStoragePath = ({ assetPath, fileHash }) => {
+	const extension = assetPath.endsWith(".br") ? ".br" : assetPath.includes(".") ? `.${assetPath.split(".").pop()}` : "";
+	return `sha256/${fileHash.slice(0, 2)}/${fileHash}${extension}`;
+};
+//#endregion
+exports.getContentAddressedAssetStoragePath = getContentAddressedAssetStoragePath;

package/dist/contentAddressedAssets.d.cts

@@ -0,0 +1,10 @@
+//#region src/contentAddressedAssets.d.ts
+declare const getContentAddressedAssetStoragePath: ({
+  assetPath,
+  fileHash
+}: {
+  assetPath: string;
+  fileHash: string;
+}) => string;
+//#endregion
+export { getContentAddressedAssetStoragePath };

package/dist/contentAddressedAssets.d.mts

@@ -0,0 +1,10 @@
+//#region src/contentAddressedAssets.d.ts
+declare const getContentAddressedAssetStoragePath: ({
+  assetPath,
+  fileHash
+}: {
+  assetPath: string;
+  fileHash: string;
+}) => string;
+//#endregion
+export { getContentAddressedAssetStoragePath };

package/dist/contentAddressedAssets.mjs

@@ -0,0 +1,7 @@
+//#region src/contentAddressedAssets.ts
+const getContentAddressedAssetStoragePath = ({ assetPath, fileHash }) => {
+	const extension = assetPath.endsWith(".br") ? ".br" : assetPath.includes(".") ? `.${assetPath.split(".").pop()}` : "";
+	return `sha256/${fileHash.slice(0, 2)}/${fileHash}${extension}`;
+};
+//#endregion
+export { getContentAddressedAssetStoragePath };

package/dist/createBlobDatabasePlugin.cjs

@@ -7,7 +7,7 @@ const require_paginateBundles = require("./paginateBundles.cjs");
 let _hot_updater_js = require("@hot-updater/js");
 let es_toolkit = require("es-toolkit");
 let semver = require("semver");
-semver = require_runtime.__toESM(semver, 1);
+semver = require_runtime.__toESM(semver);
 //#region src/createBlobDatabasePlugin.ts
 function removeBundleInternalKeys(bundle) {
 	const { _updateJsonKey, _oldUpdateJsonKey, ...pureBundle } = bundle;

package/dist/createStoragePlugin.cjs

@@ -45,6 +45,9 @@ const createProfiledStoragePlugin = ({ createProfiles, name, profileShape, suppo
 		async downloadFile(storageUri, filePath) {
 			return requireNodeProfile().downloadFile(storageUri, filePath);
 		},
+		async exists(storageUri) {
+			return requireNodeProfile().exists(storageUri);
+		},
 		async upload(key, filePath) {
 			return requireNodeProfile().upload(key, filePath);
 		}

package/dist/createStoragePlugin.mjs

@@ -45,6 +45,9 @@ const createProfiledStoragePlugin = ({ createProfiles, name, profileShape, suppo
 		async downloadFile(storageUri, filePath) {
 			return requireNodeProfile().downloadFile(storageUri, filePath);
 		},
+		async exists(storageUri) {
+			return requireNodeProfile().exists(storageUri);
+		},
 		async upload(key, filePath) {
 			return requireNodeProfile().upload(key, filePath);
 		}

package/dist/index.cjs

@@ -1,6 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_calculatePagination = require("./calculatePagination.cjs");
 const require_compressionFormat = require("./compressionFormat.cjs");
+const require_contentAddressedAssets = require("./contentAddressedAssets.cjs");
+const require_assetStorageLayout = require("./assetStorageLayout.cjs");
 const require_createDatabasePlugin = require("./createDatabasePlugin.cjs");
 const require_semverSatisfies = require("./semverSatisfies.cjs");
 const require_filterCompatibleAppVersions = require("./filterCompatibleAppVersions.cjs");
@@ -26,6 +28,7 @@ exports.createDatabasePluginGetUpdateInfo = require_createDatabasePluginGetUpdat
 exports.createNodeStoragePlugin = require_createStoragePlugin.createNodeStoragePlugin;
 exports.createRuntimeStoragePlugin = require_createStoragePlugin.createRuntimeStoragePlugin;
 exports.createStorageKeyBuilder = require_createStorageKeyBuilder.createStorageKeyBuilder;
+exports.createStorageUriWithRelativePath = require_assetStorageLayout.createStorageUriWithRelativePath;
 exports.createUUIDv7 = require_uuidv7.createUUIDv7;
 exports.createUUIDv7WithSameTimestamp = require_uuidv7.createUUIDv7WithSameTimestamp;
 exports.createUniversalStoragePlugin = require_createStoragePlugin.createUniversalStoragePlugin;
@@ -33,12 +36,17 @@ exports.detectCompressionFormat = require_compressionFormat.detectCompressionFor
 exports.extractTimestampFromUUIDv7 = require_uuidv7.extractTimestampFromUUIDv7;
 exports.filterCompatibleAppVersions = require_filterCompatibleAppVersions.filterCompatibleAppVersions;
 exports.generateMinBundleId = require_generateMinBundleId.generateMinBundleId;
+exports.getAssetStorageLayout = require_assetStorageLayout.getAssetStorageLayout;
 exports.getCompressionMimeType = require_compressionFormat.getCompressionMimeType;
+exports.getContentAddressedAssetStoragePath = require_contentAddressedAssets.getContentAddressedAssetStoragePath;
 exports.getContentType = require_compressionFormat.getContentType;
+exports.getManifestAssetStoragePath = require_assetStorageLayout.getManifestAssetStoragePath;
+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.semverSatisfies = require_semverSatisfies.semverSatisfies;
 exports.sortBundles = require_queryBundles.sortBundles;
 exports.supportedIosPlatforms = require_index.supportedIosPlatforms;

package/dist/index.d.cts

@@ -2,6 +2,8 @@ import { BuiltIns, HasMultipleCallSignatures, Primitive, RequiredDeep } from "./
 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 { PaginationOptions, calculatePagination } from "./calculatePagination.cjs";
 import { CompressionFormat, CompressionFormatInfo, detectCompressionFormat, getCompressionMimeType, getContentType } from "./compressionFormat.cjs";
+import { AssetStorageLayout, createStorageUriWithRelativePath, getAssetStorageLayout, getManifestAssetStoragePath, isContentAddressedAssetBaseStorageUri, resolveManifestAssetStorageUri } from "./assetStorageLayout.cjs";
+import { getContentAddressedAssetStoragePath } from "./contentAddressedAssets.cjs";
 import { BlobDatabasePluginConfig, BlobOperations, createBlobDatabasePlugin } from "./createBlobDatabasePlugin.cjs";
 import { AbstractDatabasePlugin, CreateDatabasePluginOptions, createDatabasePlugin } from "./createDatabasePlugin.cjs";
 import { CreateDatabasePluginGetUpdateInfoOptions, createDatabasePluginGetUpdateInfo } from "./createDatabasePluginGetUpdateInfo.cjs";
@@ -15,4 +17,4 @@ import { bundleIdMatchesFilter, bundleMatchesQueryWhere, sortBundles } from "./q
 import { semverSatisfies } from "./semverSatisfies.cjs";
 import { assertNodeStoragePlugin, assertRuntimeStoragePlugin, isNodeStoragePlugin, isRuntimeStoragePlugin } from "./storageProfile.cjs";
 import { createUUIDv7, createUUIDv7WithSameTimestamp, extractTimestampFromUUIDv7 } from "./uuidv7.cjs";
-export { AbstractDatabasePlugin, type AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BlobDatabasePluginConfig, BlobOperations, BuildPlugin, BuildPluginConfig, BuiltIns, type Bundle, CompressionFormat, CompressionFormatInfo, ConfigInput, CreateDatabasePluginGetUpdateInfoOptions, CreateDatabasePluginOptions, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, type FingerprintGetBundlesArgs, type GetBundlesArgs, HasMultipleCallSignatures, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, NodeStoragePlugin, NodeStorageProfile, Paginated, PaginatedResult, PaginationInfo, PaginationOptions, ParsedStorageUri, type Platform, PlatformConfig, Primitive, RequestEnvContext, RequiredDeep, RuntimeStoragePlugin, RuntimeStorageProfile, SigningConfig, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, type UpdateInfo, assertNodeStoragePlugin, assertRuntimeStoragePlugin, bundleIdMatchesFilter, bundleMatchesQueryWhere, calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createDatabasePluginGetUpdateInfo, createNodeStoragePlugin, createRuntimeStoragePlugin, createStorageKeyBuilder, createUUIDv7, createUUIDv7WithSameTimestamp, createUniversalStoragePlugin, detectCompressionFormat, extractTimestampFromUUIDv7, filterCompatibleAppVersions, generateMinBundleId, getCompressionMimeType, getContentType, isNodeStoragePlugin, isRuntimeStoragePlugin, paginateBundles, parseStorageUri, semverSatisfies, sortBundles, supportedIosPlatforms };
+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 };

package/dist/index.d.mts

@@ -2,6 +2,8 @@ import { BuiltIns, HasMultipleCallSignatures, Primitive, RequiredDeep } from "./
 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 { PaginationOptions, calculatePagination } from "./calculatePagination.mjs";
 import { CompressionFormat, CompressionFormatInfo, detectCompressionFormat, getCompressionMimeType, getContentType } from "./compressionFormat.mjs";
+import { AssetStorageLayout, createStorageUriWithRelativePath, getAssetStorageLayout, getManifestAssetStoragePath, isContentAddressedAssetBaseStorageUri, resolveManifestAssetStorageUri } from "./assetStorageLayout.mjs";
+import { getContentAddressedAssetStoragePath } from "./contentAddressedAssets.mjs";
 import { BlobDatabasePluginConfig, BlobOperations, createBlobDatabasePlugin } from "./createBlobDatabasePlugin.mjs";
 import { AbstractDatabasePlugin, CreateDatabasePluginOptions, createDatabasePlugin } from "./createDatabasePlugin.mjs";
 import { CreateDatabasePluginGetUpdateInfoOptions, createDatabasePluginGetUpdateInfo } from "./createDatabasePluginGetUpdateInfo.mjs";
@@ -15,4 +17,4 @@ import { bundleIdMatchesFilter, bundleMatchesQueryWhere, sortBundles } from "./q
 import { semverSatisfies } from "./semverSatisfies.mjs";
 import { assertNodeStoragePlugin, assertRuntimeStoragePlugin, isNodeStoragePlugin, isRuntimeStoragePlugin } from "./storageProfile.mjs";
 import { createUUIDv7, createUUIDv7WithSameTimestamp, extractTimestampFromUUIDv7 } from "./uuidv7.mjs";
-export { AbstractDatabasePlugin, type AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BlobDatabasePluginConfig, BlobOperations, BuildPlugin, BuildPluginConfig, BuiltIns, type Bundle, CompressionFormat, CompressionFormatInfo, ConfigInput, CreateDatabasePluginGetUpdateInfoOptions, CreateDatabasePluginOptions, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, type FingerprintGetBundlesArgs, type GetBundlesArgs, HasMultipleCallSignatures, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, NodeStoragePlugin, NodeStorageProfile, Paginated, PaginatedResult, PaginationInfo, PaginationOptions, ParsedStorageUri, type Platform, PlatformConfig, Primitive, RequestEnvContext, RequiredDeep, RuntimeStoragePlugin, RuntimeStorageProfile, SigningConfig, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, type UpdateInfo, assertNodeStoragePlugin, assertRuntimeStoragePlugin, bundleIdMatchesFilter, bundleMatchesQueryWhere, calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createDatabasePluginGetUpdateInfo, createNodeStoragePlugin, createRuntimeStoragePlugin, createStorageKeyBuilder, createUUIDv7, createUUIDv7WithSameTimestamp, createUniversalStoragePlugin, detectCompressionFormat, extractTimestampFromUUIDv7, filterCompatibleAppVersions, generateMinBundleId, getCompressionMimeType, getContentType, isNodeStoragePlugin, isRuntimeStoragePlugin, paginateBundles, parseStorageUri, semverSatisfies, sortBundles, supportedIosPlatforms };
+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 };

package/dist/index.mjs

@@ -1,5 +1,7 @@
 import { calculatePagination } from "./calculatePagination.mjs";
 import { detectCompressionFormat, getCompressionMimeType, getContentType } from "./compressionFormat.mjs";
+import { getContentAddressedAssetStoragePath } from "./contentAddressedAssets.mjs";
+import { createStorageUriWithRelativePath, getAssetStorageLayout, getManifestAssetStoragePath, isContentAddressedAssetBaseStorageUri, resolveManifestAssetStorageUri } from "./assetStorageLayout.mjs";
 import { createDatabasePlugin } from "./createDatabasePlugin.mjs";
 import { semverSatisfies } from "./semverSatisfies.mjs";
 import { filterCompatibleAppVersions } from "./filterCompatibleAppVersions.mjs";
@@ -14,4 +16,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, createUUIDv7, createUUIDv7WithSameTimestamp, createUniversalStoragePlugin, detectCompressionFormat, extractTimestampFromUUIDv7, filterCompatibleAppVersions, generateMinBundleId, getCompressionMimeType, getContentType, isNodeStoragePlugin, isRuntimeStoragePlugin, paginateBundles, parseStorageUri, 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, isContentAddressedAssetBaseStorageUri, isNodeStoragePlugin, isRuntimeStoragePlugin, paginateBundles, parseStorageUri, resolveManifestAssetStorageUri, semverSatisfies, sortBundles, supportedIosPlatforms };

package/dist/legacyAssetStorageLayout.cjs

@@ -0,0 +1,12 @@
+//#region src/legacyAssetStorageLayout.ts
+/**
+* @internal
+*
+* Legacy manifest assets were stored below each bundle's `/files` directory
+* using their manifest-relative path. Keep all old-layout path decisions here
+* so support can be removed by deleting this module and the entrypoint branch
+* that imports it.
+*/
+const getLegacyManifestAssetStoragePath = ({ assetPath }) => assetPath;
+//#endregion
+exports.getLegacyManifestAssetStoragePath = getLegacyManifestAssetStoragePath;

package/dist/legacyAssetStorageLayout.mjs

@@ -0,0 +1,12 @@
+//#region src/legacyAssetStorageLayout.ts
+/**
+* @internal
+*
+* Legacy manifest assets were stored below each bundle's `/files` directory
+* using their manifest-relative path. Keep all old-layout path decisions here
+* so support can be removed by deleting this module and the entrypoint branch
+* that imports it.
+*/
+const getLegacyManifestAssetStoragePath = ({ assetPath }) => assetPath;
+//#endregion
+export { getLegacyManifestAssetStoragePath };

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

@@ -232,9 +232,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 +283,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 +379,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.

package/dist/types/index.d.mts

@@ -232,9 +232,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 +283,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 +379,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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hot-updater/plugin-core",
-  "version": "0.31.3",
+  "version": "0.32.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.3",
-    "@hot-updater/js": "0.31.3"
+    "@hot-updater/core": "0.32.0",
+    "@hot-updater/js": "0.32.0"
   },
   "devDependencies": {
     "@types/node": "^20",
     "@types/semver": "^7.5.8",
     "typescript": "6.0.2",
-    "@hot-updater/test-utils": "0.31.3"
+    "@hot-updater/test-utils": "0.32.0"
   },
   "scripts": {
     "build": "tsdown",