@hot-updater/plugin-core 0.35.12 → 0.36.1

package/dist/assetStorageLayout.cjs

@@ -1,6 +1,8 @@
 const require_contentAddressedAssets = require("./contentAddressedAssets.cjs");
 const require_legacyAssetStorageLayout = require("./legacyAssetStorageLayout.cjs");
 //#region src/assetStorageLayout.ts
+const isBrotliManifestAssetPath = (assetPath) => /(^|\/)index\.[^/]+\.bundle$/.test(assetPath.replace(/\\/g, "/"));
+const getManifestAssetDownloadPath = (assetPath) => isBrotliManifestAssetPath(assetPath) ? `${assetPath}.br` : assetPath;
 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("/")}`;
@@ -29,6 +31,8 @@ const resolveManifestAssetStorageUri = ({ assetBaseStorageUri, assetPath, fileHa
 //#endregion
 exports.createStorageUriWithRelativePath = createStorageUriWithRelativePath;
 exports.getAssetStorageLayout = getAssetStorageLayout;
+exports.getManifestAssetDownloadPath = getManifestAssetDownloadPath;
 exports.getManifestAssetStoragePath = getManifestAssetStoragePath;
+exports.isBrotliManifestAssetPath = isBrotliManifestAssetPath;
 exports.isContentAddressedAssetBaseStorageUri = isContentAddressedAssetBaseStorageUri;
 exports.resolveManifestAssetStorageUri = resolveManifestAssetStorageUri;

package/dist/assetStorageLayout.d.cts

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

package/dist/assetStorageLayout.d.mts

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

package/dist/assetStorageLayout.mjs

@@ -1,6 +1,8 @@
 import { getContentAddressedAssetStoragePath } from "./contentAddressedAssets.mjs";
 import { getLegacyManifestAssetStoragePath } from "./legacyAssetStorageLayout.mjs";
 //#region src/assetStorageLayout.ts
+const isBrotliManifestAssetPath = (assetPath) => /(^|\/)index\.[^/]+\.bundle$/.test(assetPath.replace(/\\/g, "/"));
+const getManifestAssetDownloadPath = (assetPath) => isBrotliManifestAssetPath(assetPath) ? `${assetPath}.br` : assetPath;
 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("/")}`;
@@ -27,4 +29,4 @@ const resolveManifestAssetStorageUri = ({ assetBaseStorageUri, assetPath, fileHa
 	})
 });
 //#endregion
-export { createStorageUriWithRelativePath, getAssetStorageLayout, getManifestAssetStoragePath, isContentAddressedAssetBaseStorageUri, resolveManifestAssetStorageUri };
+export { createStorageUriWithRelativePath, getAssetStorageLayout, getManifestAssetDownloadPath, getManifestAssetStoragePath, isBrotliManifestAssetPath, isContentAddressedAssetBaseStorageUri, resolveManifestAssetStorageUri };

package/dist/bundleStorageLayout.cjs

@@ -0,0 +1,22 @@
+//#region src/bundleStorageLayout.ts
+const BUNDLE_STORAGE_PREFIX = "bundles";
+const createBundleStorageKey = (bundleId, ...relativePaths) => [
+	BUNDLE_STORAGE_PREFIX,
+	bundleId,
+	...relativePaths
+].filter(Boolean).join("/");
+const createStorageRootUriWithPath = (storageUri, bundleId, relativePath) => {
+	const storageUrl = new URL(storageUri);
+	const segments = storageUrl.pathname.split("/").filter(Boolean);
+	const bundleIndex = segments.lastIndexOf(bundleId);
+	if (bundleIndex < 0) throw new Error(`Storage URI does not contain bundle id: ${bundleId}`);
+	const rootSegments = segments.slice(0, bundleIndex);
+	if (rootSegments.at(-1) === "bundles") rootSegments.pop();
+	const relativeSegments = relativePath.split("/").filter(Boolean).map((segment) => encodeURIComponent(segment));
+	storageUrl.pathname = `/${[...rootSegments, ...relativeSegments].join("/")}`;
+	return storageUrl.toString();
+};
+//#endregion
+exports.BUNDLE_STORAGE_PREFIX = BUNDLE_STORAGE_PREFIX;
+exports.createBundleStorageKey = createBundleStorageKey;
+exports.createStorageRootUriWithPath = createStorageRootUriWithPath;

package/dist/bundleStorageLayout.d.cts

@@ -0,0 +1,6 @@
+//#region src/bundleStorageLayout.d.ts
+declare const BUNDLE_STORAGE_PREFIX = "bundles";
+declare const createBundleStorageKey: (bundleId: string, ...relativePaths: string[]) => string;
+declare const createStorageRootUriWithPath: (storageUri: string, bundleId: string, relativePath: string) => string;
+//#endregion
+export { BUNDLE_STORAGE_PREFIX, createBundleStorageKey, createStorageRootUriWithPath };

package/dist/bundleStorageLayout.d.mts

@@ -0,0 +1,6 @@
+//#region src/bundleStorageLayout.d.ts
+declare const BUNDLE_STORAGE_PREFIX = "bundles";
+declare const createBundleStorageKey: (bundleId: string, ...relativePaths: string[]) => string;
+declare const createStorageRootUriWithPath: (storageUri: string, bundleId: string, relativePath: string) => string;
+//#endregion
+export { BUNDLE_STORAGE_PREFIX, createBundleStorageKey, createStorageRootUriWithPath };

package/dist/bundleStorageLayout.mjs

@@ -0,0 +1,20 @@
+//#region src/bundleStorageLayout.ts
+const BUNDLE_STORAGE_PREFIX = "bundles";
+const createBundleStorageKey = (bundleId, ...relativePaths) => [
+	BUNDLE_STORAGE_PREFIX,
+	bundleId,
+	...relativePaths
+].filter(Boolean).join("/");
+const createStorageRootUriWithPath = (storageUri, bundleId, relativePath) => {
+	const storageUrl = new URL(storageUri);
+	const segments = storageUrl.pathname.split("/").filter(Boolean);
+	const bundleIndex = segments.lastIndexOf(bundleId);
+	if (bundleIndex < 0) throw new Error(`Storage URI does not contain bundle id: ${bundleId}`);
+	const rootSegments = segments.slice(0, bundleIndex);
+	if (rootSegments.at(-1) === "bundles") rootSegments.pop();
+	const relativeSegments = relativePath.split("/").filter(Boolean).map((segment) => encodeURIComponent(segment));
+	storageUrl.pathname = `/${[...rootSegments, ...relativeSegments].join("/")}`;
+	return storageUrl.toString();
+};
+//#endregion
+export { BUNDLE_STORAGE_PREFIX, createBundleStorageKey, createStorageRootUriWithPath };

package/dist/contentAddressedAssets.cjs

@@ -1,7 +1,9 @@
 //#region src/contentAddressedAssets.ts
+const CONTENT_ADDRESSED_ASSET_PREFIX = "assets";
 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.CONTENT_ADDRESSED_ASSET_PREFIX = CONTENT_ADDRESSED_ASSET_PREFIX;
 exports.getContentAddressedAssetStoragePath = getContentAddressedAssetStoragePath;

package/dist/contentAddressedAssets.d.cts

@@ -1,4 +1,5 @@
 //#region src/contentAddressedAssets.d.ts
+declare const CONTENT_ADDRESSED_ASSET_PREFIX = "assets";
 declare const getContentAddressedAssetStoragePath: ({
   assetPath,
   fileHash
@@ -7,4 +8,4 @@ declare const getContentAddressedAssetStoragePath: ({
   fileHash: string;
 }) => string;
 //#endregion
-export { getContentAddressedAssetStoragePath };
+export { CONTENT_ADDRESSED_ASSET_PREFIX, getContentAddressedAssetStoragePath };

package/dist/contentAddressedAssets.d.mts

@@ -1,4 +1,5 @@
 //#region src/contentAddressedAssets.d.ts
+declare const CONTENT_ADDRESSED_ASSET_PREFIX = "assets";
 declare const getContentAddressedAssetStoragePath: ({
   assetPath,
   fileHash
@@ -7,4 +8,4 @@ declare const getContentAddressedAssetStoragePath: ({
   fileHash: string;
 }) => string;
 //#endregion
-export { getContentAddressedAssetStoragePath };
+export { CONTENT_ADDRESSED_ASSET_PREFIX, getContentAddressedAssetStoragePath };

package/dist/contentAddressedAssets.mjs

@@ -1,7 +1,8 @@
 //#region src/contentAddressedAssets.ts
+const CONTENT_ADDRESSED_ASSET_PREFIX = "assets";
 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 };
+export { CONTENT_ADDRESSED_ASSET_PREFIX, getContentAddressedAssetStoragePath };

package/dist/createBlobDatabasePlugin.cjs

@@ -93,10 +93,17 @@ function addTargetVersionRemoval(mutations, bundle) {
 	getTargetVersionMutation(mutations, bundle).removals.add(targetAppVersion);
 }
 function getManagementListPrefixes(where) {
+	if (where?.channel && where.platform && typeof where.targetAppVersion === "string") {
+		const targetAppVersion = normalizeTargetAppVersion(where.targetAppVersion);
+		if (targetAppVersion) return [`${where.channel}/${where.platform}/${targetAppVersion}/`];
+	}
 	if (where?.channel && where.platform) return [`${where.channel}/${where.platform}/`];
 	if (where?.channel) return [`${where.channel}/`];
 	return [""];
 }
+function getChannelFromUpdateJsonKey(key) {
+	return key.match(/^([^/]+)\/(?:ios|android)\/[^/]+\/update\.json$/)?.[1] ?? null;
+}
 const DEFAULT_DESC_ORDER = {
 	field: "id",
 	direction: "desc"
@@ -113,7 +120,7 @@ function sortManagedBundles(bundles, orderBy = DEFAULT_DESC_ORDER) {
 */
 const createBlobDatabasePlugin = ({ name, factory }) => {
 	return (config, hooks) => {
-		const { listObjects, loadObject, uploadObject, deleteObject, shouldSkipLoadObjectError, invalidatePaths, apiBasePath } = factory(config);
+		const { listObjects, loadObject, uploadObject, deleteObject, shouldSkipLoadObjectError, validateChannel, invalidatePaths, apiBasePath } = factory(config);
 		const bundlesMap = /* @__PURE__ */ new Map();
 		const pendingBundlesMap = /* @__PURE__ */ new Map();
 		const locallyDeletedBundleIds = /* @__PURE__ */ new Set();
@@ -249,10 +256,12 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 					});
 				},
 				async getChannels() {
-					return [...new Set((await loadAllBundlesForManagementFallback()).map((bundle) => bundle.channel))].sort();
+					const channels = (await listObjects("")).map(getChannelFromUpdateJsonKey).filter((channel) => channel !== null);
+					return [...new Set(channels)].sort();
 				},
 				async commitBundle({ changedSets }) {
 					if (changedSets.length === 0) return;
+					for (const { operation, data } of changedSets) if (operation === "insert" || operation === "update" && data.channel !== void 0) validateChannel?.(data.channel);
 					const changedBundlesByKey = {};
 					const removalsByKey = {};
 					const targetVersionRemovalsByKey = {};

package/dist/createBlobDatabasePlugin.d.cts

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

package/dist/createBlobDatabasePlugin.d.mts

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

package/dist/createBlobDatabasePlugin.mjs

@@ -92,10 +92,17 @@ function addTargetVersionRemoval(mutations, bundle) {
 	getTargetVersionMutation(mutations, bundle).removals.add(targetAppVersion);
 }
 function getManagementListPrefixes(where) {
+	if (where?.channel && where.platform && typeof where.targetAppVersion === "string") {
+		const targetAppVersion = normalizeTargetAppVersion(where.targetAppVersion);
+		if (targetAppVersion) return [`${where.channel}/${where.platform}/${targetAppVersion}/`];
+	}
 	if (where?.channel && where.platform) return [`${where.channel}/${where.platform}/`];
 	if (where?.channel) return [`${where.channel}/`];
 	return [""];
 }
+function getChannelFromUpdateJsonKey(key) {
+	return key.match(/^([^/]+)\/(?:ios|android)\/[^/]+\/update\.json$/)?.[1] ?? null;
+}
 const DEFAULT_DESC_ORDER = {
 	field: "id",
 	direction: "desc"
@@ -112,7 +119,7 @@ function sortManagedBundles(bundles, orderBy = DEFAULT_DESC_ORDER) {
 */
 const createBlobDatabasePlugin = ({ name, factory }) => {
 	return (config, hooks) => {
-		const { listObjects, loadObject, uploadObject, deleteObject, shouldSkipLoadObjectError, invalidatePaths, apiBasePath } = factory(config);
+		const { listObjects, loadObject, uploadObject, deleteObject, shouldSkipLoadObjectError, validateChannel, invalidatePaths, apiBasePath } = factory(config);
 		const bundlesMap = /* @__PURE__ */ new Map();
 		const pendingBundlesMap = /* @__PURE__ */ new Map();
 		const locallyDeletedBundleIds = /* @__PURE__ */ new Set();
@@ -248,10 +255,12 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 					});
 				},
 				async getChannels() {
-					return [...new Set((await loadAllBundlesForManagementFallback()).map((bundle) => bundle.channel))].sort();
+					const channels = (await listObjects("")).map(getChannelFromUpdateJsonKey).filter((channel) => channel !== null);
+					return [...new Set(channels)].sort();
 				},
 				async commitBundle({ changedSets }) {
 					if (changedSets.length === 0) return;
+					for (const { operation, data } of changedSets) if (operation === "insert" || operation === "update" && data.channel !== void 0) validateChannel?.(data.channel);
 					const changedBundlesByKey = {};
 					const removalsByKey = {};
 					const targetVersionRemovalsByKey = {};

package/dist/createStoragePlugin.cjs

@@ -38,21 +38,39 @@ const createProfiledStoragePlugin = ({ createProfiles, name, profileShape, suppo
 		return runtime;
 	};
 	const profiles = {};
-	if (profileShape?.node) profiles.node = {
-		async delete(storageUri) {
-			return requireNodeProfile().delete(storageUri);
-		},
-		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);
-		}
-	};
-	else if (profileShape?.node !== false) Object.defineProperty(profiles, "node", {
+	if (profileShape?.node) {
+		const nodeProfile = {
+			async delete(storageUri) {
+				return requireNodeProfile().delete(storageUri);
+			},
+			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);
+			}
+		};
+		Object.defineProperties(nodeProfile, {
+			deleteObjects: {
+				enumerable: true,
+				get: () => {
+					const deleteObjects = requireNodeProfile().deleteObjects;
+					return deleteObjects ? (keys) => deleteObjects(keys) : void 0;
+				}
+			},
+			listObjects: {
+				enumerable: true,
+				get: () => {
+					const listObjects = requireNodeProfile().listObjects;
+					return listObjects ? (prefix) => listObjects(prefix) : void 0;
+				}
+			}
+		});
+		profiles.node = nodeProfile;
+	} else if (profileShape?.node !== false) Object.defineProperty(profiles, "node", {
 		enumerable: true,
 		get: getNodeProfile
 	});

package/dist/createStoragePlugin.mjs

@@ -38,21 +38,39 @@ const createProfiledStoragePlugin = ({ createProfiles, name, profileShape, suppo
 		return runtime;
 	};
 	const profiles = {};
-	if (profileShape?.node) profiles.node = {
-		async delete(storageUri) {
-			return requireNodeProfile().delete(storageUri);
-		},
-		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);
-		}
-	};
-	else if (profileShape?.node !== false) Object.defineProperty(profiles, "node", {
+	if (profileShape?.node) {
+		const nodeProfile = {
+			async delete(storageUri) {
+				return requireNodeProfile().delete(storageUri);
+			},
+			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);
+			}
+		};
+		Object.defineProperties(nodeProfile, {
+			deleteObjects: {
+				enumerable: true,
+				get: () => {
+					const deleteObjects = requireNodeProfile().deleteObjects;
+					return deleteObjects ? (keys) => deleteObjects(keys) : void 0;
+				}
+			},
+			listObjects: {
+				enumerable: true,
+				get: () => {
+					const listObjects = requireNodeProfile().listObjects;
+					return listObjects ? (prefix) => listObjects(prefix) : void 0;
+				}
+			}
+		});
+		profiles.node = nodeProfile;
+	} else if (profileShape?.node !== false) Object.defineProperty(profiles, "node", {
 		enumerable: true,
 		get: getNodeProfile
 	});

package/dist/index.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_calculatePagination = require("./calculatePagination.cjs");
+const require_bundleStorageLayout = require("./bundleStorageLayout.cjs");
 const require_compressionFormat = require("./compressionFormat.cjs");
 const require_contentAddressedAssets = require("./contentAddressedAssets.cjs");
 const require_assetStorageLayout = require("./assetStorageLayout.cjs");
@@ -18,17 +19,21 @@ const require_parseStorageUri = require("./parseStorageUri.cjs");
 const require_storageProfile = require("./storageProfile.cjs");
 const require_index = require("./types/index.cjs");
 const require_uuidv7 = require("./uuidv7.cjs");
+exports.BUNDLE_STORAGE_PREFIX = require_bundleStorageLayout.BUNDLE_STORAGE_PREFIX;
+exports.CONTENT_ADDRESSED_ASSET_PREFIX = require_contentAddressedAssets.CONTENT_ADDRESSED_ASSET_PREFIX;
 exports.assertNodeStoragePlugin = require_storageProfile.assertNodeStoragePlugin;
 exports.assertRuntimeStoragePlugin = require_storageProfile.assertRuntimeStoragePlugin;
 exports.bundleIdMatchesFilter = require_queryBundles.bundleIdMatchesFilter;
 exports.bundleMatchesQueryWhere = require_queryBundles.bundleMatchesQueryWhere;
 exports.calculatePagination = require_calculatePagination.calculatePagination;
 exports.createBlobDatabasePlugin = require_createBlobDatabasePlugin.createBlobDatabasePlugin;
+exports.createBundleStorageKey = require_bundleStorageLayout.createBundleStorageKey;
 exports.createDatabasePlugin = require_createDatabasePlugin.createDatabasePlugin;
 exports.createNodeStoragePlugin = require_createStoragePlugin.createNodeStoragePlugin;
 exports.createRequestUpdateBundleResolver = require_requestUpdateBundleState.createRequestUpdateBundleResolver;
 exports.createRuntimeStoragePlugin = require_createStoragePlugin.createRuntimeStoragePlugin;
 exports.createStorageKeyBuilder = require_createStorageKeyBuilder.createStorageKeyBuilder;
+exports.createStorageRootUriWithPath = require_bundleStorageLayout.createStorageRootUriWithPath;
 exports.createStorageUriWithRelativePath = require_assetStorageLayout.createStorageUriWithRelativePath;
 exports.createUUIDv7 = require_uuidv7.createUUIDv7;
 exports.createUUIDv7WithSameTimestamp = require_uuidv7.createUUIDv7WithSameTimestamp;
@@ -41,8 +46,10 @@ exports.getAssetStorageLayout = require_assetStorageLayout.getAssetStorageLayout
 exports.getCompressionMimeType = require_compressionFormat.getCompressionMimeType;
 exports.getContentAddressedAssetStoragePath = require_contentAddressedAssets.getContentAddressedAssetStoragePath;
 exports.getContentType = require_compressionFormat.getContentType;
+exports.getManifestAssetDownloadPath = require_assetStorageLayout.getManifestAssetDownloadPath;
 exports.getManifestAssetStoragePath = require_assetStorageLayout.getManifestAssetStoragePath;
 exports.getRequestUpdateBundleSeeds = require_requestUpdateBundleState.getRequestUpdateBundleSeeds;
+exports.isBrotliManifestAssetPath = require_assetStorageLayout.isBrotliManifestAssetPath;
 exports.isContentAddressedAssetBaseStorageUri = require_assetStorageLayout.isContentAddressedAssetBaseStorageUri;
 exports.isNodeStoragePlugin = require_storageProfile.isNodeStoragePlugin;
 exports.isRuntimeStoragePlugin = require_storageProfile.isRuntimeStoragePlugin;

package/dist/index.d.cts

@@ -1,9 +1,10 @@
 import { BuiltIns, HasMultipleCallSignatures, Primitive, RequiredDeep } from "./types/utils.cjs";
-import { AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, Bundle, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintExtraSources, 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, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintExtraSources, FingerprintGetBundlesArgs, GetBundlesArgs, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, NodeStoragePlugin, NodeStorageProfile, Paginated, PaginatedResult, PaginationInfo, Platform, PlatformConfig, RequestEnvContext, RuntimeStoragePlugin, RuntimeStorageProfile, SigningConfig, StorageObject, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, UpdateInfo, supportedIosPlatforms } from "./types/index.cjs";
 import { PaginationOptions, calculatePagination } from "./calculatePagination.cjs";
+import { BUNDLE_STORAGE_PREFIX, createBundleStorageKey, createStorageRootUriWithPath } from "./bundleStorageLayout.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 { AssetStorageLayout, createStorageUriWithRelativePath, getAssetStorageLayout, getManifestAssetDownloadPath, getManifestAssetStoragePath, isBrotliManifestAssetPath, isContentAddressedAssetBaseStorageUri, resolveManifestAssetStorageUri } from "./assetStorageLayout.cjs";
+import { CONTENT_ADDRESSED_ASSET_PREFIX, getContentAddressedAssetStoragePath } from "./contentAddressedAssets.cjs";
 import { BlobOperations, createBlobDatabasePlugin } from "./createBlobDatabasePlugin.cjs";
 import { AbstractDatabasePlugin, CreateDatabasePluginOptions, createDatabasePlugin } from "./createDatabasePlugin.cjs";
 import { createStorageKeyBuilder } from "./createStorageKeyBuilder.cjs";
@@ -18,4 +19,4 @@ import { ResolveUpdateInfoFromBundlesOptions, resolveUpdateInfoFromBundles } fro
 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, BlobOperations, BuildPlugin, BuildPluginConfig, BuiltIns, Bundle, CompressionFormat, CompressionFormatInfo, ConfigInput, CreateDatabasePluginOptions, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintExtraSources, 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, createNodeStoragePlugin, createRequestUpdateBundleResolver, 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 };
+export { AbstractDatabasePlugin, AppVersionGetBundlesArgs, ApplePlatform, AssetStorageLayout, BUNDLE_STORAGE_PREFIX, BasePluginArgs, BlobOperations, BuildPlugin, BuildPluginConfig, BuiltIns, Bundle, CONTENT_ADDRESSED_ASSET_PREFIX, CompressionFormat, CompressionFormatInfo, ConfigInput, CreateDatabasePluginOptions, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintExtraSources, 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, StorageObject, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, UpdateInfo, assertNodeStoragePlugin, assertRuntimeStoragePlugin, bundleIdMatchesFilter, bundleMatchesQueryWhere, calculatePagination, createBlobDatabasePlugin, createBundleStorageKey, createDatabasePlugin, createNodeStoragePlugin, createRequestUpdateBundleResolver, createRuntimeStoragePlugin, createStorageKeyBuilder, createStorageRootUriWithPath, createStorageUriWithRelativePath, createUUIDv7, createUUIDv7WithSameTimestamp, createUniversalStoragePlugin, detectCompressionFormat, extractTimestampFromUUIDv7, filterCompatibleAppVersions, generateMinBundleId, getAssetStorageLayout, getCompressionMimeType, getContentAddressedAssetStoragePath, getContentType, getManifestAssetDownloadPath, getManifestAssetStoragePath, getRequestUpdateBundleSeeds, isBrotliManifestAssetPath, isContentAddressedAssetBaseStorageUri, isNodeStoragePlugin, isRuntimeStoragePlugin, paginateBundles, parseStorageUri, resolveManifestAssetStorageUri, resolveUpdateInfoFromBundles, semverSatisfies, sortBundles, supportedIosPlatforms };

package/dist/index.d.mts

@@ -1,9 +1,10 @@
 import { BuiltIns, HasMultipleCallSignatures, Primitive, RequiredDeep } from "./types/utils.mjs";
-import { AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, Bundle, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintExtraSources, 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, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintExtraSources, FingerprintGetBundlesArgs, GetBundlesArgs, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, NodeStoragePlugin, NodeStorageProfile, Paginated, PaginatedResult, PaginationInfo, Platform, PlatformConfig, RequestEnvContext, RuntimeStoragePlugin, RuntimeStorageProfile, SigningConfig, StorageObject, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, UpdateInfo, supportedIosPlatforms } from "./types/index.mjs";
 import { PaginationOptions, calculatePagination } from "./calculatePagination.mjs";
+import { BUNDLE_STORAGE_PREFIX, createBundleStorageKey, createStorageRootUriWithPath } from "./bundleStorageLayout.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 { AssetStorageLayout, createStorageUriWithRelativePath, getAssetStorageLayout, getManifestAssetDownloadPath, getManifestAssetStoragePath, isBrotliManifestAssetPath, isContentAddressedAssetBaseStorageUri, resolveManifestAssetStorageUri } from "./assetStorageLayout.mjs";
+import { CONTENT_ADDRESSED_ASSET_PREFIX, getContentAddressedAssetStoragePath } from "./contentAddressedAssets.mjs";
 import { BlobOperations, createBlobDatabasePlugin } from "./createBlobDatabasePlugin.mjs";
 import { AbstractDatabasePlugin, CreateDatabasePluginOptions, createDatabasePlugin } from "./createDatabasePlugin.mjs";
 import { createStorageKeyBuilder } from "./createStorageKeyBuilder.mjs";
@@ -18,4 +19,4 @@ import { ResolveUpdateInfoFromBundlesOptions, resolveUpdateInfoFromBundles } fro
 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, BlobOperations, BuildPlugin, BuildPluginConfig, BuiltIns, Bundle, CompressionFormat, CompressionFormatInfo, ConfigInput, CreateDatabasePluginOptions, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintExtraSources, 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, createNodeStoragePlugin, createRequestUpdateBundleResolver, 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 };
+export { AbstractDatabasePlugin, AppVersionGetBundlesArgs, ApplePlatform, AssetStorageLayout, BUNDLE_STORAGE_PREFIX, BasePluginArgs, BlobOperations, BuildPlugin, BuildPluginConfig, BuiltIns, Bundle, CONTENT_ADDRESSED_ASSET_PREFIX, CompressionFormat, CompressionFormatInfo, ConfigInput, CreateDatabasePluginOptions, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintExtraSources, 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, StorageObject, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, UpdateInfo, assertNodeStoragePlugin, assertRuntimeStoragePlugin, bundleIdMatchesFilter, bundleMatchesQueryWhere, calculatePagination, createBlobDatabasePlugin, createBundleStorageKey, createDatabasePlugin, createNodeStoragePlugin, createRequestUpdateBundleResolver, createRuntimeStoragePlugin, createStorageKeyBuilder, createStorageRootUriWithPath, createStorageUriWithRelativePath, createUUIDv7, createUUIDv7WithSameTimestamp, createUniversalStoragePlugin, detectCompressionFormat, extractTimestampFromUUIDv7, filterCompatibleAppVersions, generateMinBundleId, getAssetStorageLayout, getCompressionMimeType, getContentAddressedAssetStoragePath, getContentType, getManifestAssetDownloadPath, getManifestAssetStoragePath, getRequestUpdateBundleSeeds, isBrotliManifestAssetPath, isContentAddressedAssetBaseStorageUri, isNodeStoragePlugin, isRuntimeStoragePlugin, paginateBundles, parseStorageUri, resolveManifestAssetStorageUri, resolveUpdateInfoFromBundles, semverSatisfies, sortBundles, supportedIosPlatforms };

package/dist/index.mjs

@@ -1,7 +1,8 @@
 import { calculatePagination } from "./calculatePagination.mjs";
+import { BUNDLE_STORAGE_PREFIX, createBundleStorageKey, createStorageRootUriWithPath } from "./bundleStorageLayout.mjs";
 import { detectCompressionFormat, getCompressionMimeType, getContentType } from "./compressionFormat.mjs";
-import { getContentAddressedAssetStoragePath } from "./contentAddressedAssets.mjs";
-import { createStorageUriWithRelativePath, getAssetStorageLayout, getManifestAssetStoragePath, isContentAddressedAssetBaseStorageUri, resolveManifestAssetStorageUri } from "./assetStorageLayout.mjs";
+import { CONTENT_ADDRESSED_ASSET_PREFIX, getContentAddressedAssetStoragePath } from "./contentAddressedAssets.mjs";
+import { createStorageUriWithRelativePath, getAssetStorageLayout, getManifestAssetDownloadPath, getManifestAssetStoragePath, isBrotliManifestAssetPath, isContentAddressedAssetBaseStorageUri, resolveManifestAssetStorageUri } from "./assetStorageLayout.mjs";
 import { bundleIdMatchesFilter, bundleMatchesQueryWhere, sortBundles } from "./queryBundles.mjs";
 import { createDatabasePlugin } from "./createDatabasePlugin.mjs";
 import { semverSatisfies } from "./semverSatisfies.mjs";
@@ -17,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, createNodeStoragePlugin, createRequestUpdateBundleResolver, 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 };
+export { BUNDLE_STORAGE_PREFIX, CONTENT_ADDRESSED_ASSET_PREFIX, assertNodeStoragePlugin, assertRuntimeStoragePlugin, bundleIdMatchesFilter, bundleMatchesQueryWhere, calculatePagination, createBlobDatabasePlugin, createBundleStorageKey, createDatabasePlugin, createNodeStoragePlugin, createRequestUpdateBundleResolver, createRuntimeStoragePlugin, createStorageKeyBuilder, createStorageRootUriWithPath, createStorageUriWithRelativePath, createUUIDv7, createUUIDv7WithSameTimestamp, createUniversalStoragePlugin, detectCompressionFormat, extractTimestampFromUUIDv7, filterCompatibleAppVersions, generateMinBundleId, getAssetStorageLayout, getCompressionMimeType, getContentAddressedAssetStoragePath, getContentType, getManifestAssetDownloadPath, getManifestAssetStoragePath, getRequestUpdateBundleSeeds, isBrotliManifestAssetPath, isContentAddressedAssetBaseStorageUri, isNodeStoragePlugin, isRuntimeStoragePlugin, paginateBundles, parseStorageUri, resolveManifestAssetStorageUri, resolveUpdateInfoFromBundles, semverSatisfies, sortBundles, supportedIosPlatforms };

package/dist/types/index.d.cts

@@ -279,6 +279,13 @@ interface RequestEnvContext<TEnv = unknown> {
 }
 type HotUpdaterContext<TContext = unknown> = TContext;
 type StorageResolveContext<TContext = unknown> = HotUpdaterContext<TContext>;
+interface StorageObject {
+  /** Object key relative to the storage plugin's configured base path. */
+  key: string;
+  storageUri: string;
+  size: number;
+  lastModifiedAt?: Date;
+}
 interface NodeStorageProfile {
   upload: (key: string, filePath: string) => Promise<{
     storageUri: string;
@@ -291,6 +298,13 @@ interface NodeStorageProfile {
   exists: (storageUri: string) => Promise<boolean>;
   delete: (storageUri: string) => Promise<void>;
   downloadFile: (storageUri: string, filePath: string) => Promise<void>;
+  /**
+   * Optional management capabilities used by storage garbage collection.
+   * Object keys are relative to the configured storage base path.
+   * `deleteObjects` must delete only the exact keys it receives.
+   */
+  listObjects?: (prefix?: string) => Promise<StorageObject[]>;
+  deleteObjects?: (keys: readonly string[]) => Promise<void>;
 }
 interface RuntimeStorageProfile<TContext = unknown> {
   getDownloadUrl: (storageUri: string, context?: StorageResolveContext<TContext>) => Promise<{
@@ -521,4 +535,4 @@ interface NativeBuildOptions {
   scheme?: string;
 }
 //#endregion
-export { type AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, type Bundle$1 as Bundle, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintExtraSources, type 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, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, type Bundle$1 as Bundle, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintExtraSources, type 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, StorageObject, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, type UpdateInfo$1 as UpdateInfo, supportedIosPlatforms };

package/dist/types/index.d.mts

@@ -279,6 +279,13 @@ interface RequestEnvContext<TEnv = unknown> {
 }
 type HotUpdaterContext<TContext = unknown> = TContext;
 type StorageResolveContext<TContext = unknown> = HotUpdaterContext<TContext>;
+interface StorageObject {
+  /** Object key relative to the storage plugin's configured base path. */
+  key: string;
+  storageUri: string;
+  size: number;
+  lastModifiedAt?: Date;
+}
 interface NodeStorageProfile {
   upload: (key: string, filePath: string) => Promise<{
     storageUri: string;
@@ -291,6 +298,13 @@ interface NodeStorageProfile {
   exists: (storageUri: string) => Promise<boolean>;
   delete: (storageUri: string) => Promise<void>;
   downloadFile: (storageUri: string, filePath: string) => Promise<void>;
+  /**
+   * Optional management capabilities used by storage garbage collection.
+   * Object keys are relative to the configured storage base path.
+   * `deleteObjects` must delete only the exact keys it receives.
+   */
+  listObjects?: (prefix?: string) => Promise<StorageObject[]>;
+  deleteObjects?: (keys: readonly string[]) => Promise<void>;
 }
 interface RuntimeStorageProfile<TContext = unknown> {
   getDownloadUrl: (storageUri: string, context?: StorageResolveContext<TContext>) => Promise<{
@@ -521,4 +535,4 @@ interface NativeBuildOptions {
   scheme?: string;
 }
 //#endregion
-export { type AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, type Bundle$1 as Bundle, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintExtraSources, type 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, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, type Bundle$1 as Bundle, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintExtraSources, type 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, StorageObject, 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.35.12",
+  "version": "0.36.1",
   "type": "module",
   "description": "React Native OTA solution for self-hosted",
   "sideEffects": false,
@@ -45,14 +45,14 @@
     "es-toolkit": "^1.32.0",
     "mime": "^4.0.4",
     "verkit": "0.3.2",
-    "@hot-updater/js": "0.35.12",
-    "@hot-updater/core": "0.35.12"
+    "@hot-updater/core": "0.36.1",
+    "@hot-updater/js": "0.36.1"
   },
   "devDependencies": {
     "@types/node": "^20",
     "@typescript/native": "npm:typescript@7.0.2",
     "typescript": "npm:@typescript/typescript6@6.0.2",
-    "@hot-updater/test-utils": "0.35.12"
+    "@hot-updater/test-utils": "0.36.1"
   },
   "scripts": {
     "build": "tsdown",