@hot-updater/firebase 0.30.12 → 0.31.0

package/dist/firebase/functions/index.cjs

@@ -34,6 +34,35 @@ fs_promises = __toESM$1(fs_promises);
 let path = require("path");
 path = __toESM$1(path);
 //#region ../../packages/core/dist/index.mjs
+const stripBundleArtifactMetadata = (metadata) => metadata;
+const getManifestStorageUri = (bundle) => bundle.manifestStorageUri ?? null;
+const getManifestFileHash = (bundle) => bundle.manifestFileHash ?? null;
+const getAssetBaseStorageUri = (bundle) => bundle.assetBaseStorageUri ?? null;
+const isBundlePatchArtifact = (value) => {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+	const candidate = value;
+	return typeof candidate.baseBundleId === "string" && typeof candidate.baseFileHash === "string" && typeof candidate.patchFileHash === "string" && typeof candidate.patchStorageUri === "string";
+};
+const readBundlePatchArray = (patches) => {
+	if (!Array.isArray(patches)) return [];
+	return patches.filter(isBundlePatchArtifact);
+};
+const getBundlePatches = (bundle) => {
+	const patches = readBundlePatchArray(bundle.patches);
+	const seenBaseBundleIds = /* @__PURE__ */ new Set();
+	return patches.filter((patch) => {
+		if (seenBaseBundleIds.has(patch.baseBundleId)) return false;
+		seenBaseBundleIds.add(patch.baseBundleId);
+		return true;
+	});
+};
+const getPrimaryPatch = (bundle) => {
+	return getBundlePatches(bundle)[0] ?? null;
+};
+const getPatchBaseBundleId = (bundle) => bundle.patchBaseBundleId ?? getPrimaryPatch(bundle)?.baseBundleId ?? null;
+const getPatchBaseFileHash = (bundle) => bundle.patchBaseFileHash ?? getPrimaryPatch(bundle)?.baseFileHash ?? null;
+const getPatchFileHash = (bundle) => bundle.patchFileHash ?? getPrimaryPatch(bundle)?.patchFileHash ?? null;
+const getPatchStorageUri = (bundle) => bundle.patchStorageUri ?? getPrimaryPatch(bundle)?.patchStorageUri ?? null;
 const NUMERIC_COHORT_SIZE = 1e3;
 const DEFAULT_ROLLOUT_COHORT_COUNT = NUMERIC_COHORT_SIZE;
 function parseNumericCohortValue(cohort) {
@@ -1551,7 +1580,7 @@ function mergeWith(target, source, merge) {
 }
 //#endregion
 //#region ../plugin-core/dist/createDatabasePlugin.mjs
-const REPLACE_ON_UPDATE_KEYS = ["targetCohorts"];
+const REPLACE_ON_UPDATE_KEYS = ["patches", "targetCohorts"];
 const DEFAULT_DESC_ORDER = {
 	field: "id",
 	direction: "desc"
@@ -4556,56 +4585,109 @@ const createStorageKeyBuilder = (basePath) => (...args) => {
 };
 //#endregion
 //#region ../plugin-core/dist/createStoragePlugin.mjs
+const wrapNodeProfile = (node, hooks) => ({
+	...node,
+	async upload(key, filePath) {
+		const result = await node.upload(key, filePath);
+		await hooks?.onStorageUploaded?.();
+		return result;
+	}
+});
+const createProfiledStoragePlugin = ({ createProfiles, name, profileShape, supportedProtocol }, hooks) => {
+	let cachedProfiles = null;
+	let cachedNodeProfile;
+	let cachedRuntimeProfile;
+	const getProfiles = () => {
+		cachedProfiles ??= createProfiles();
+		return cachedProfiles;
+	};
+	const getNodeProfile = () => {
+		const node = getProfiles().node;
+		if (!node) return;
+		cachedNodeProfile ??= wrapNodeProfile(node, hooks);
+		return cachedNodeProfile;
+	};
+	const requireNodeProfile = () => {
+		const node = getNodeProfile();
+		if (!node) throw new Error(`${name} does not implement the node storage profile for protocol "${supportedProtocol}".`);
+		return node;
+	};
+	const getRuntimeProfile = () => {
+		const runtime = getProfiles().runtime;
+		if (!runtime) return;
+		cachedRuntimeProfile ??= runtime;
+		return cachedRuntimeProfile;
+	};
+	const requireRuntimeProfile = () => {
+		const runtime = getRuntimeProfile();
+		if (!runtime) throw new Error(`${name} does not implement the runtime storage profile for protocol "${supportedProtocol}".`);
+		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 upload(key, filePath) {
+			return requireNodeProfile().upload(key, filePath);
+		}
+	};
+	else if (profileShape?.node !== false) Object.defineProperty(profiles, "node", {
+		enumerable: true,
+		get: getNodeProfile
+	});
+	if (profileShape?.runtime) profiles.runtime = {
+		async getDownloadUrl(storageUri, context) {
+			return requireRuntimeProfile().getDownloadUrl(storageUri, context);
+		},
+		async readText(storageUri, context) {
+			return requireRuntimeProfile().readText(storageUri, context);
+		}
+	};
+	else if (profileShape?.runtime !== false) Object.defineProperty(profiles, "runtime", {
+		enumerable: true,
+		get: getRuntimeProfile
+	});
+	return {
+		name,
+		supportedProtocol,
+		profiles
+	};
+};
 /**
-* Creates a storage plugin with lazy initialization and automatic hook execution.
-*
-* This factory function abstracts the double currying pattern used by all storage plugins,
-* ensuring consistent lazy initialization behavior across different storage providers.
-* Hooks are automatically executed at appropriate times without requiring manual invocation.
-*
-* @param options - Configuration options for the storage plugin
-* @returns A double-curried function that lazily initializes the storage plugin
-*
-* @example
-* ```typescript
-* export const s3Storage = createStoragePlugin<S3StorageConfig>({
-*   name: "s3Storage",
-*   supportedProtocol: "s3",
-*   factory: (config) => {
-*     const client = new S3Client(config);
-*     return {
-*       async upload(key, filePath) { ... },
-*       async delete(storageUri) { ... },
-*       async getDownloadUrl(storageUri, context) { ... }
-*     };
-*   }
-* });
-* ```
+* Creates an update-check runtime storage plugin.
 */
-const createStoragePlugin = (options) => {
+const createRuntimeStoragePlugin = (options) => {
 	return (config, hooks) => {
-		return () => {
-			let cachedMethods = null;
-			const getMethods = () => {
-				if (!cachedMethods) cachedMethods = options.factory(config);
-				return cachedMethods;
-			};
-			return {
-				name: options.name,
-				supportedProtocol: options.supportedProtocol,
-				async upload(key, filePath) {
-					const result = await getMethods().upload(key, filePath);
-					await hooks?.onStorageUploaded?.();
-					return result;
-				},
-				async delete(storageUri) {
-					return getMethods().delete(storageUri);
-				},
-				async getDownloadUrl(storageUri, context) {
-					return getMethods().getDownloadUrl(storageUri, context);
-				}
-			};
-		};
+		return () => createProfiledStoragePlugin({
+			createProfiles: () => ({ runtime: options.factory(config) }),
+			name: options.name,
+			profileShape: {
+				node: false,
+				runtime: true
+			},
+			supportedProtocol: options.supportedProtocol
+		}, hooks);
+	};
+};
+/**
+* Creates a storage plugin that can be used by both Node tooling and update
+* check runtimes.
+*/
+const createUniversalStoragePlugin = (options) => {
+	return (config, hooks) => {
+		return () => createProfiledStoragePlugin({
+			createProfiles: () => options.factory(config),
+			name: options.name,
+			profileShape: {
+				node: true,
+				runtime: true
+			},
+			supportedProtocol: options.supportedProtocol
+		}, hooks);
 	};
 };
 //#endregion
@@ -4688,22 +4770,42 @@ const chunkValues = (values, size) => {
 	for (let index = 0; index < values.length; index += size) chunks.push(values.slice(index, index + size));
 	return chunks;
 };
-const convertToBundle = (firestoreData) => ({
-	channel: firestoreData.channel,
-	enabled: Boolean(firestoreData.enabled),
-	shouldForceUpdate: Boolean(firestoreData.should_force_update),
-	fileHash: firestoreData.file_hash,
-	gitCommitHash: firestoreData.git_commit_hash,
-	id: firestoreData.id,
-	message: firestoreData.message,
-	platform: firestoreData.platform,
-	targetAppVersion: firestoreData.target_app_version,
-	storageUri: firestoreData.storage_uri,
-	fingerprintHash: firestoreData.fingerprint_hash,
-	metadata: firestoreData?.metadata ?? {},
-	rolloutCohortCount: firestoreData.rollout_cohort_count ?? 1e3,
-	targetCohorts: firestoreData.target_cohorts ?? null
-});
+const convertToBundle = (firestoreData) => {
+	const rawMetadata = firestoreData.metadata;
+	const storedPatches = firestoreData.patches;
+	const patches = storedPatches && Array.isArray(storedPatches) ? storedPatches : getBundlePatches({
+		metadata: rawMetadata,
+		patchBaseBundleId: firestoreData.patch_base_bundle_id ?? null,
+		patchBaseFileHash: firestoreData.patch_base_file_hash ?? null,
+		patchFileHash: firestoreData.patch_file_hash ?? null,
+		patchStorageUri: firestoreData.patch_storage_uri ?? null
+	});
+	const primaryPatch = patches[0] ?? null;
+	return {
+		channel: firestoreData.channel,
+		enabled: Boolean(firestoreData.enabled),
+		shouldForceUpdate: Boolean(firestoreData.should_force_update),
+		fileHash: firestoreData.file_hash,
+		gitCommitHash: firestoreData.git_commit_hash,
+		id: firestoreData.id,
+		message: firestoreData.message,
+		platform: firestoreData.platform,
+		targetAppVersion: firestoreData.target_app_version,
+		storageUri: firestoreData.storage_uri,
+		fingerprintHash: firestoreData.fingerprint_hash,
+		metadata: stripBundleArtifactMetadata(rawMetadata),
+		manifestStorageUri: firestoreData.manifest_storage_uri ?? null,
+		manifestFileHash: firestoreData.manifest_file_hash ?? null,
+		assetBaseStorageUri: firestoreData.asset_base_storage_uri ?? null,
+		patches,
+		patchBaseBundleId: primaryPatch?.baseBundleId ?? firestoreData.patch_base_bundle_id ?? null,
+		patchBaseFileHash: primaryPatch?.baseFileHash ?? firestoreData.patch_base_file_hash ?? null,
+		patchFileHash: primaryPatch?.patchFileHash ?? firestoreData.patch_file_hash ?? null,
+		patchStorageUri: primaryPatch?.patchStorageUri ?? firestoreData.patch_storage_uri ?? null,
+		rolloutCohortCount: firestoreData.rollout_cohort_count ?? 1e3,
+		targetCohorts: firestoreData.target_cohorts ?? null
+	};
+};
 const firebaseDatabase = createDatabasePlugin({
 	name: "firebaseDatabase",
 	factory: (config) => {
@@ -4795,7 +4897,15 @@ const firebaseDatabase = createDatabasePlugin({
 								target_app_version: data.targetAppVersion,
 								storage_uri: data.storageUri,
 								fingerprint_hash: data.fingerprintHash,
-								metadata: data.metadata ?? {},
+								metadata: stripBundleArtifactMetadata(data.metadata) ?? {},
+								manifest_storage_uri: getManifestStorageUri(data),
+								manifest_file_hash: getManifestFileHash(data),
+								asset_base_storage_uri: getAssetBaseStorageUri(data),
+								patches: data.patches ?? null,
+								patch_base_bundle_id: getPatchBaseBundleId(data),
+								patch_base_file_hash: getPatchBaseFileHash(data),
+								patch_file_hash: getPatchFileHash(data),
+								patch_storage_uri: getPatchStorageUri(data),
 								rollout_cohort_count: data.rolloutCohortCount ?? 1e3,
 								target_cohorts: data.targetCohorts ?? null
 							};
@@ -4831,7 +4941,15 @@ const firebaseDatabase = createDatabasePlugin({
 								target_app_version: data.targetAppVersion || null,
 								storage_uri: data.storageUri,
 								fingerprint_hash: data.fingerprintHash,
-								metadata: data.metadata ?? {},
+								metadata: stripBundleArtifactMetadata(data.metadata) ?? {},
+								manifest_storage_uri: getManifestStorageUri(data),
+								manifest_file_hash: getManifestFileHash(data),
+								asset_base_storage_uri: getAssetBaseStorageUri(data),
+								patches: data.patches ?? null,
+								patch_base_bundle_id: getPatchBaseBundleId(data),
+								patch_base_file_hash: getPatchBaseFileHash(data),
+								patch_file_hash: getPatchFileHash(data),
+								patch_storage_uri: getPatchStorageUri(data),
 								rollout_cohort_count: data.rolloutCohortCount ?? 1e3,
 								target_cohorts: data.targetCohorts ?? null
 							}, { merge: true });
@@ -4857,7 +4975,7 @@ const firebaseDatabase = createDatabasePlugin({
 });
 //#endregion
 //#region src/firebaseStorage.ts
-const firebaseStorage = createStoragePlugin({
+const firebaseStorage = createUniversalStoragePlugin({
 	name: "firebaseStorage",
 	supportedProtocol: "gs",
 	factory: (config) => {
@@ -4870,44 +4988,65 @@ const firebaseStorage = createStoragePlugin({
 		const bucket = app.storage().bucket(config.storageBucket);
 		const getStorageKey = createStorageKeyBuilder(config.basePath);
 		return {
-			async delete(storageUri) {
-				const { bucket: bucketName, key } = parseStorageUri(storageUri, "gs");
-				if (bucketName !== config.storageBucket) throw new Error(`Bucket name mismatch: expected "${config.storageBucket}", but found "${bucketName}".`);
-				try {
-					const [files] = await bucket.getFiles({ prefix: key });
-					await Promise.all(files.map((file) => file.delete()));
-				} catch (e) {
-					console.error("Error listing or deleting files:", e);
-					throw new Error("Bundle Not Found");
+			node: {
+				async delete(storageUri) {
+					const { bucket: bucketName, key } = parseStorageUri(storageUri, "gs");
+					if (bucketName !== config.storageBucket) throw new Error(`Bucket name mismatch: expected "${config.storageBucket}", but found "${bucketName}".`);
+					try {
+						const [files] = await bucket.getFiles({ prefix: key });
+						await Promise.all(files.map((file) => file.delete()));
+					} catch (e) {
+						console.error("Error listing or deleting files:", e);
+						throw new Error("Bundle Not Found");
+					}
+				},
+				async upload(key, filePath) {
+					try {
+						const fileContent = await fs_promises.default.readFile(filePath);
+						const contentType = getContentType(filePath);
+						const storageKey = getStorageKey(key, path.default.basename(filePath));
+						await bucket.file(storageKey).save(fileContent, { metadata: {
+							contentType,
+							cacheControl: "public, max-age=31536000, immutable"
+						} });
+						return { storageUri: `gs://${config.storageBucket}/${storageKey}` };
+					} catch (error) {
+						console.error("Error uploading bundle:", error);
+						if (error instanceof Error) throw new Error(`Failed to upload bundle: ${error.message}`);
+						throw error;
+					}
+				},
+				async downloadFile(storageUri, filePath) {
+					const { bucket: bucketName, key } = parseStorageUri(storageUri, "gs");
+					if (bucketName !== config.storageBucket) throw new Error(`Bucket name mismatch: expected "${config.storageBucket}", but found "${bucketName}".`);
+					await fs_promises.default.mkdir(path.default.dirname(filePath), { recursive: true });
+					await bucket.file(key).download({ destination: filePath });
 				}
 			},
-			async upload(key, filePath) {
-				try {
-					const fileContent = await fs_promises.default.readFile(filePath);
-					const contentType = getContentType(filePath);
-					const storageKey = getStorageKey(key, path.default.basename(filePath));
-					await bucket.file(storageKey).save(fileContent, { metadata: {
-						contentType,
-						cacheControl: "public, max-age=31536000, immutable"
-					} });
-					return { storageUri: `gs://${config.storageBucket}/${storageKey}` };
-				} catch (error) {
-					console.error("Error uploading bundle:", error);
-					if (error instanceof Error) throw new Error(`Failed to upload bundle: ${error.message}`);
-					throw error;
+			runtime: {
+				async readText(storageUri) {
+					const { bucket: bucketName, key } = parseStorageUri(storageUri, "gs");
+					if (bucketName !== config.storageBucket) throw new Error(`Bucket name mismatch: expected "${config.storageBucket}", but found "${bucketName}".`);
+					try {
+						const [contents] = await bucket.file(key).download();
+						return contents.toString("utf8");
+					} catch (error) {
+						if (typeof error === "object" && error !== null && "code" in error && error.code === 404) return null;
+						throw error;
+					}
+				},
+				async getDownloadUrl(storageUri) {
+					const u = new URL(storageUri);
+					if (u.protocol.replace(":", "") !== "gs") throw new Error("Invalid Firebase storage URI protocol");
+					const key = u.pathname.slice(1);
+					if (!key) throw new Error("Invalid Firebase storage URI: missing key");
+					const [signedUrl] = await bucket.file(key).getSignedUrl({
+						action: "read",
+						expires: Date.now() + 3600 * 1e3
+					});
+					if (!signedUrl) throw new Error("Failed to generate download URL");
+					return { fileUrl: signedUrl };
 				}
-			},
-			async getDownloadUrl(storageUri) {
-				const u = new URL(storageUri);
-				if (u.protocol.replace(":", "") !== "gs") throw new Error("Invalid Firebase storage URI protocol");
-				const key = u.pathname.slice(1);
-				if (!key) throw new Error("Invalid Firebase storage URI: missing key");
-				const [signedUrl] = await bucket.file(key).getSignedUrl({
-					action: "read",
-					expires: Date.now() + 3600 * 1e3
-				});
-				if (!signedUrl) throw new Error("Failed to generate download URL");
-				return { fileUrl: signedUrl };
 			}
 		};
 	}
@@ -4917,34 +5056,31 @@ const firebaseStorage = createStoragePlugin({
 const trimTrailingSlash = (value) => {
 	return value.endsWith("/") ? value.slice(0, -1) : value;
 };
-const firebaseFunctionsStorage = (config, hooks) => {
-	const fallbackStorageFactory = config.storageBucket ? firebaseStorage({
-		...config,
-		storageBucket: config.storageBucket
-	}, hooks) : null;
-	return () => {
-		const fallbackStorage = fallbackStorageFactory?.() ?? null;
+const createFirebaseFunctionsStorage = createRuntimeStoragePlugin({
+	name: "firebaseFunctionsStorage",
+	supportedProtocol: "gs",
+	factory: (config) => {
+		const fallbackStorage = firebaseStorage({
+			...config,
+			storageBucket: config.storageBucket
+		})();
 		return {
-			name: "firebaseFunctionsStorage",
-			supportedProtocol: "gs",
-			async upload(key, filePath) {
-				if (!fallbackStorage) throw new Error("firebaseFunctionsStorage requires storageBucket to support upload().");
-				return fallbackStorage.upload(key, filePath);
-			},
-			async delete(storageUri) {
-				if (!fallbackStorage) throw new Error("firebaseFunctionsStorage requires storageBucket to support delete().");
-				return fallbackStorage.delete(storageUri);
+			async readText(storageUri, context) {
+				return fallbackStorage.profiles.runtime.readText(storageUri, context);
 			},
 			async getDownloadUrl(storageUri, context) {
 				if (config.cdnUrl) {
 					const storageUrl = new URL(storageUri);
 					if (storageUrl.protocol === "gs:") return { fileUrl: `${trimTrailingSlash(config.cdnUrl)}/${storageUrl.pathname.replace(/^\/+/, "")}` };
 				}
-				if (!fallbackStorage) throw new Error("firebaseFunctionsStorage requires storageBucket or cdnUrl to resolve download URLs.");
-				return fallbackStorage.getDownloadUrl(storageUri, context);
+				return fallbackStorage.profiles.runtime.getDownloadUrl(storageUri, context);
 			}
 		};
-	};
+	}
+});
+const firebaseFunctionsStorage = (config, hooks) => {
+	if (!config.storageBucket) throw new Error("firebaseFunctionsStorage requires storageBucket for the runtime storage profile.");
+	return createFirebaseFunctionsStorage(config, hooks);
 };
 //#endregion
 //#region firebase/functions/index.ts
@@ -4953,7 +5089,7 @@ if (!firebase_admin.default.apps.length) firebase_admin.default.initializeApp();
 const adminOptions = firebase_admin.default.app().options;
 const storageBucket = adminOptions.storageBucket;
 const cdnUrl = process.env.HOT_UPDATER_CDN_URL;
-if (!storageBucket && !cdnUrl) throw new Error("Firebase runtime requires storageBucket or HOT_UPDATER_CDN_URL to resolve bundle URLs.");
+if (!storageBucket) throw new Error("Firebase runtime requires storageBucket to read bundle manifests.");
 const hotUpdater = (0, _hot_updater_server_runtime.createHotUpdater)({
 	database: firebaseDatabase(adminOptions),
 	storages: [firebaseFunctionsStorage({

package/dist/iac/index.cjs

@@ -6689,7 +6689,6 @@ function App() {
 export default HotUpdater.wrap({
   baseURL: "%%source%%",
   updateStrategy: "appVersion", // or "fingerprint"
-  updateMode: "auto",
 })(App);`;
 const REGIONS = [
 	{

package/dist/iac/index.mjs

@@ -6684,7 +6684,6 @@ function App() {
 export default HotUpdater.wrap({
   baseURL: "%%source%%",
   updateStrategy: "appVersion", // or "fingerprint"
-  updateMode: "auto",
 })(App);`;
 const REGIONS = [
 	{

package/dist/index.cjs

@@ -76,22 +76,42 @@ const chunkValues = (values, size) => {
 	for (let index = 0; index < values.length; index += size) chunks.push(values.slice(index, index + size));
 	return chunks;
 };
-const convertToBundle = (firestoreData) => ({
-	channel: firestoreData.channel,
-	enabled: Boolean(firestoreData.enabled),
-	shouldForceUpdate: Boolean(firestoreData.should_force_update),
-	fileHash: firestoreData.file_hash,
-	gitCommitHash: firestoreData.git_commit_hash,
-	id: firestoreData.id,
-	message: firestoreData.message,
-	platform: firestoreData.platform,
-	targetAppVersion: firestoreData.target_app_version,
-	storageUri: firestoreData.storage_uri,
-	fingerprintHash: firestoreData.fingerprint_hash,
-	metadata: firestoreData?.metadata ?? {},
-	rolloutCohortCount: firestoreData.rollout_cohort_count ?? _hot_updater_core.DEFAULT_ROLLOUT_COHORT_COUNT,
-	targetCohorts: firestoreData.target_cohorts ?? null
-});
+const convertToBundle = (firestoreData) => {
+	const rawMetadata = firestoreData.metadata;
+	const storedPatches = firestoreData.patches;
+	const patches = storedPatches && Array.isArray(storedPatches) ? storedPatches : (0, _hot_updater_core.getBundlePatches)({
+		metadata: rawMetadata,
+		patchBaseBundleId: firestoreData.patch_base_bundle_id ?? null,
+		patchBaseFileHash: firestoreData.patch_base_file_hash ?? null,
+		patchFileHash: firestoreData.patch_file_hash ?? null,
+		patchStorageUri: firestoreData.patch_storage_uri ?? null
+	});
+	const primaryPatch = patches[0] ?? null;
+	return {
+		channel: firestoreData.channel,
+		enabled: Boolean(firestoreData.enabled),
+		shouldForceUpdate: Boolean(firestoreData.should_force_update),
+		fileHash: firestoreData.file_hash,
+		gitCommitHash: firestoreData.git_commit_hash,
+		id: firestoreData.id,
+		message: firestoreData.message,
+		platform: firestoreData.platform,
+		targetAppVersion: firestoreData.target_app_version,
+		storageUri: firestoreData.storage_uri,
+		fingerprintHash: firestoreData.fingerprint_hash,
+		metadata: (0, _hot_updater_core.stripBundleArtifactMetadata)(rawMetadata),
+		manifestStorageUri: firestoreData.manifest_storage_uri ?? null,
+		manifestFileHash: firestoreData.manifest_file_hash ?? null,
+		assetBaseStorageUri: firestoreData.asset_base_storage_uri ?? null,
+		patches,
+		patchBaseBundleId: primaryPatch?.baseBundleId ?? firestoreData.patch_base_bundle_id ?? null,
+		patchBaseFileHash: primaryPatch?.baseFileHash ?? firestoreData.patch_base_file_hash ?? null,
+		patchFileHash: primaryPatch?.patchFileHash ?? firestoreData.patch_file_hash ?? null,
+		patchStorageUri: primaryPatch?.patchStorageUri ?? firestoreData.patch_storage_uri ?? null,
+		rolloutCohortCount: firestoreData.rollout_cohort_count ?? _hot_updater_core.DEFAULT_ROLLOUT_COHORT_COUNT,
+		targetCohorts: firestoreData.target_cohorts ?? null
+	};
+};
 const firebaseDatabase = (0, _hot_updater_plugin_core.createDatabasePlugin)({
 	name: "firebaseDatabase",
 	factory: (config) => {
@@ -183,7 +203,15 @@ const firebaseDatabase = (0, _hot_updater_plugin_core.createDatabasePlugin)({
 								target_app_version: data.targetAppVersion,
 								storage_uri: data.storageUri,
 								fingerprint_hash: data.fingerprintHash,
-								metadata: data.metadata ?? {},
+								metadata: (0, _hot_updater_core.stripBundleArtifactMetadata)(data.metadata) ?? {},
+								manifest_storage_uri: (0, _hot_updater_core.getManifestStorageUri)(data),
+								manifest_file_hash: (0, _hot_updater_core.getManifestFileHash)(data),
+								asset_base_storage_uri: (0, _hot_updater_core.getAssetBaseStorageUri)(data),
+								patches: data.patches ?? null,
+								patch_base_bundle_id: (0, _hot_updater_core.getPatchBaseBundleId)(data),
+								patch_base_file_hash: (0, _hot_updater_core.getPatchBaseFileHash)(data),
+								patch_file_hash: (0, _hot_updater_core.getPatchFileHash)(data),
+								patch_storage_uri: (0, _hot_updater_core.getPatchStorageUri)(data),
 								rollout_cohort_count: data.rolloutCohortCount ?? _hot_updater_core.DEFAULT_ROLLOUT_COHORT_COUNT,
 								target_cohorts: data.targetCohorts ?? null
 							};
@@ -219,7 +247,15 @@ const firebaseDatabase = (0, _hot_updater_plugin_core.createDatabasePlugin)({
 								target_app_version: data.targetAppVersion || null,
 								storage_uri: data.storageUri,
 								fingerprint_hash: data.fingerprintHash,
-								metadata: data.metadata ?? {},
+								metadata: (0, _hot_updater_core.stripBundleArtifactMetadata)(data.metadata) ?? {},
+								manifest_storage_uri: (0, _hot_updater_core.getManifestStorageUri)(data),
+								manifest_file_hash: (0, _hot_updater_core.getManifestFileHash)(data),
+								asset_base_storage_uri: (0, _hot_updater_core.getAssetBaseStorageUri)(data),
+								patches: data.patches ?? null,
+								patch_base_bundle_id: (0, _hot_updater_core.getPatchBaseBundleId)(data),
+								patch_base_file_hash: (0, _hot_updater_core.getPatchBaseFileHash)(data),
+								patch_file_hash: (0, _hot_updater_core.getPatchFileHash)(data),
+								patch_storage_uri: (0, _hot_updater_core.getPatchStorageUri)(data),
 								rollout_cohort_count: data.rolloutCohortCount ?? _hot_updater_core.DEFAULT_ROLLOUT_COHORT_COUNT,
 								target_cohorts: data.targetCohorts ?? null
 							}, { merge: true });
@@ -245,7 +281,7 @@ const firebaseDatabase = (0, _hot_updater_plugin_core.createDatabasePlugin)({
 });
 //#endregion
 //#region src/firebaseStorage.ts
-const firebaseStorage = (0, _hot_updater_plugin_core.createStoragePlugin)({
+const firebaseStorage = (0, _hot_updater_plugin_core.createUniversalStoragePlugin)({
 	name: "firebaseStorage",
 	supportedProtocol: "gs",
 	factory: (config) => {
@@ -258,44 +294,65 @@ const firebaseStorage = (0, _hot_updater_plugin_core.createStoragePlugin)({
 		const bucket = app.storage().bucket(config.storageBucket);
 		const getStorageKey = (0, _hot_updater_plugin_core.createStorageKeyBuilder)(config.basePath);
 		return {
-			async delete(storageUri) {
-				const { bucket: bucketName, key } = (0, _hot_updater_plugin_core.parseStorageUri)(storageUri, "gs");
-				if (bucketName !== config.storageBucket) throw new Error(`Bucket name mismatch: expected "${config.storageBucket}", but found "${bucketName}".`);
-				try {
-					const [files] = await bucket.getFiles({ prefix: key });
-					await Promise.all(files.map((file) => file.delete()));
-				} catch (e) {
-					console.error("Error listing or deleting files:", e);
-					throw new Error("Bundle Not Found");
+			node: {
+				async delete(storageUri) {
+					const { bucket: bucketName, key } = (0, _hot_updater_plugin_core.parseStorageUri)(storageUri, "gs");
+					if (bucketName !== config.storageBucket) throw new Error(`Bucket name mismatch: expected "${config.storageBucket}", but found "${bucketName}".`);
+					try {
+						const [files] = await bucket.getFiles({ prefix: key });
+						await Promise.all(files.map((file) => file.delete()));
+					} catch (e) {
+						console.error("Error listing or deleting files:", e);
+						throw new Error("Bundle Not Found");
+					}
+				},
+				async upload(key, filePath) {
+					try {
+						const fileContent = await fs_promises.default.readFile(filePath);
+						const contentType = (0, _hot_updater_plugin_core.getContentType)(filePath);
+						const storageKey = getStorageKey(key, path.default.basename(filePath));
+						await bucket.file(storageKey).save(fileContent, { metadata: {
+							contentType,
+							cacheControl: "public, max-age=31536000, immutable"
+						} });
+						return { storageUri: `gs://${config.storageBucket}/${storageKey}` };
+					} catch (error) {
+						console.error("Error uploading bundle:", error);
+						if (error instanceof Error) throw new Error(`Failed to upload bundle: ${error.message}`);
+						throw error;
+					}
+				},
+				async downloadFile(storageUri, filePath) {
+					const { bucket: bucketName, key } = (0, _hot_updater_plugin_core.parseStorageUri)(storageUri, "gs");
+					if (bucketName !== config.storageBucket) throw new Error(`Bucket name mismatch: expected "${config.storageBucket}", but found "${bucketName}".`);
+					await fs_promises.default.mkdir(path.default.dirname(filePath), { recursive: true });
+					await bucket.file(key).download({ destination: filePath });
 				}
 			},
-			async upload(key, filePath) {
-				try {
-					const fileContent = await fs_promises.default.readFile(filePath);
-					const contentType = (0, _hot_updater_plugin_core.getContentType)(filePath);
-					const storageKey = getStorageKey(key, path.default.basename(filePath));
-					await bucket.file(storageKey).save(fileContent, { metadata: {
-						contentType,
-						cacheControl: "public, max-age=31536000, immutable"
-					} });
-					return { storageUri: `gs://${config.storageBucket}/${storageKey}` };
-				} catch (error) {
-					console.error("Error uploading bundle:", error);
-					if (error instanceof Error) throw new Error(`Failed to upload bundle: ${error.message}`);
-					throw error;
+			runtime: {
+				async readText(storageUri) {
+					const { bucket: bucketName, key } = (0, _hot_updater_plugin_core.parseStorageUri)(storageUri, "gs");
+					if (bucketName !== config.storageBucket) throw new Error(`Bucket name mismatch: expected "${config.storageBucket}", but found "${bucketName}".`);
+					try {
+						const [contents] = await bucket.file(key).download();
+						return contents.toString("utf8");
+					} catch (error) {
+						if (typeof error === "object" && error !== null && "code" in error && error.code === 404) return null;
+						throw error;
+					}
+				},
+				async getDownloadUrl(storageUri) {
+					const u = new URL(storageUri);
+					if (u.protocol.replace(":", "") !== "gs") throw new Error("Invalid Firebase storage URI protocol");
+					const key = u.pathname.slice(1);
+					if (!key) throw new Error("Invalid Firebase storage URI: missing key");
+					const [signedUrl] = await bucket.file(key).getSignedUrl({
+						action: "read",
+						expires: Date.now() + 3600 * 1e3
+					});
+					if (!signedUrl) throw new Error("Failed to generate download URL");
+					return { fileUrl: signedUrl };
 				}
-			},
-			async getDownloadUrl(storageUri) {
-				const u = new URL(storageUri);
-				if (u.protocol.replace(":", "") !== "gs") throw new Error("Invalid Firebase storage URI protocol");
-				const key = u.pathname.slice(1);
-				if (!key) throw new Error("Invalid Firebase storage URI: missing key");
-				const [signedUrl] = await bucket.file(key).getSignedUrl({
-					action: "read",
-					expires: Date.now() + 3600 * 1e3
-				});
-				if (!signedUrl) throw new Error("Failed to generate download URL");
-				return { fileUrl: signedUrl };
 			}
 		};
 	}

package/dist/index.d.cts

@@ -12,6 +12,6 @@ interface FirebaseStorageConfig extends admin.AppOptions {
    */
   basePath?: string;
 }
-declare const firebaseStorage: (config: FirebaseStorageConfig, hooks?: _$_hot_updater_plugin_core0.StoragePluginHooks) => () => _$_hot_updater_plugin_core0.StoragePlugin<unknown>;
+declare const firebaseStorage: (config: FirebaseStorageConfig, hooks?: _$_hot_updater_plugin_core0.StoragePluginHooks) => () => _$_hot_updater_plugin_core0.UniversalStoragePlugin<unknown>;
 //#endregion
 export { FirebaseStorageConfig, firebaseDatabase, firebaseStorage };

package/dist/index.d.mts

@@ -12,6 +12,6 @@ interface FirebaseStorageConfig extends admin.AppOptions {
    */
   basePath?: string;
 }
-declare const firebaseStorage: (config: FirebaseStorageConfig, hooks?: _$_hot_updater_plugin_core0.StoragePluginHooks) => () => _$_hot_updater_plugin_core0.StoragePlugin<unknown>;
+declare const firebaseStorage: (config: FirebaseStorageConfig, hooks?: _$_hot_updater_plugin_core0.StoragePluginHooks) => () => _$_hot_updater_plugin_core0.UniversalStoragePlugin<unknown>;
 //#endregion
 export { FirebaseStorageConfig, firebaseDatabase, firebaseStorage };

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { DEFAULT_ROLLOUT_COHORT_COUNT } from "@hot-updater/core";
-import { calculatePagination, createDatabasePlugin, createDatabasePluginGetUpdateInfo, createStorageKeyBuilder, createStoragePlugin, getContentType, parseStorageUri } from "@hot-updater/plugin-core";
+import { DEFAULT_ROLLOUT_COHORT_COUNT, getAssetBaseStorageUri, getBundlePatches, getManifestFileHash, getManifestStorageUri, getPatchBaseBundleId, getPatchBaseFileHash, getPatchFileHash, getPatchStorageUri, stripBundleArtifactMetadata } from "@hot-updater/core";
+import { calculatePagination, createDatabasePlugin, createDatabasePluginGetUpdateInfo, createStorageKeyBuilder, createUniversalStoragePlugin, getContentType, parseStorageUri } from "@hot-updater/plugin-core";
 import admin from "firebase-admin";
 import fs from "fs/promises";
 import path from "path";
@@ -50,22 +50,42 @@ const chunkValues = (values, size) => {
 	for (let index = 0; index < values.length; index += size) chunks.push(values.slice(index, index + size));
 	return chunks;
 };
-const convertToBundle = (firestoreData) => ({
-	channel: firestoreData.channel,
-	enabled: Boolean(firestoreData.enabled),
-	shouldForceUpdate: Boolean(firestoreData.should_force_update),
-	fileHash: firestoreData.file_hash,
-	gitCommitHash: firestoreData.git_commit_hash,
-	id: firestoreData.id,
-	message: firestoreData.message,
-	platform: firestoreData.platform,
-	targetAppVersion: firestoreData.target_app_version,
-	storageUri: firestoreData.storage_uri,
-	fingerprintHash: firestoreData.fingerprint_hash,
-	metadata: firestoreData?.metadata ?? {},
-	rolloutCohortCount: firestoreData.rollout_cohort_count ?? DEFAULT_ROLLOUT_COHORT_COUNT,
-	targetCohorts: firestoreData.target_cohorts ?? null
-});
+const convertToBundle = (firestoreData) => {
+	const rawMetadata = firestoreData.metadata;
+	const storedPatches = firestoreData.patches;
+	const patches = storedPatches && Array.isArray(storedPatches) ? storedPatches : getBundlePatches({
+		metadata: rawMetadata,
+		patchBaseBundleId: firestoreData.patch_base_bundle_id ?? null,
+		patchBaseFileHash: firestoreData.patch_base_file_hash ?? null,
+		patchFileHash: firestoreData.patch_file_hash ?? null,
+		patchStorageUri: firestoreData.patch_storage_uri ?? null
+	});
+	const primaryPatch = patches[0] ?? null;
+	return {
+		channel: firestoreData.channel,
+		enabled: Boolean(firestoreData.enabled),
+		shouldForceUpdate: Boolean(firestoreData.should_force_update),
+		fileHash: firestoreData.file_hash,
+		gitCommitHash: firestoreData.git_commit_hash,
+		id: firestoreData.id,
+		message: firestoreData.message,
+		platform: firestoreData.platform,
+		targetAppVersion: firestoreData.target_app_version,
+		storageUri: firestoreData.storage_uri,
+		fingerprintHash: firestoreData.fingerprint_hash,
+		metadata: stripBundleArtifactMetadata(rawMetadata),
+		manifestStorageUri: firestoreData.manifest_storage_uri ?? null,
+		manifestFileHash: firestoreData.manifest_file_hash ?? null,
+		assetBaseStorageUri: firestoreData.asset_base_storage_uri ?? null,
+		patches,
+		patchBaseBundleId: primaryPatch?.baseBundleId ?? firestoreData.patch_base_bundle_id ?? null,
+		patchBaseFileHash: primaryPatch?.baseFileHash ?? firestoreData.patch_base_file_hash ?? null,
+		patchFileHash: primaryPatch?.patchFileHash ?? firestoreData.patch_file_hash ?? null,
+		patchStorageUri: primaryPatch?.patchStorageUri ?? firestoreData.patch_storage_uri ?? null,
+		rolloutCohortCount: firestoreData.rollout_cohort_count ?? DEFAULT_ROLLOUT_COHORT_COUNT,
+		targetCohorts: firestoreData.target_cohorts ?? null
+	};
+};
 const firebaseDatabase = createDatabasePlugin({
 	name: "firebaseDatabase",
 	factory: (config) => {
@@ -157,7 +177,15 @@ const firebaseDatabase = createDatabasePlugin({
 								target_app_version: data.targetAppVersion,
 								storage_uri: data.storageUri,
 								fingerprint_hash: data.fingerprintHash,
-								metadata: data.metadata ?? {},
+								metadata: stripBundleArtifactMetadata(data.metadata) ?? {},
+								manifest_storage_uri: getManifestStorageUri(data),
+								manifest_file_hash: getManifestFileHash(data),
+								asset_base_storage_uri: getAssetBaseStorageUri(data),
+								patches: data.patches ?? null,
+								patch_base_bundle_id: getPatchBaseBundleId(data),
+								patch_base_file_hash: getPatchBaseFileHash(data),
+								patch_file_hash: getPatchFileHash(data),
+								patch_storage_uri: getPatchStorageUri(data),
 								rollout_cohort_count: data.rolloutCohortCount ?? DEFAULT_ROLLOUT_COHORT_COUNT,
 								target_cohorts: data.targetCohorts ?? null
 							};
@@ -193,7 +221,15 @@ const firebaseDatabase = createDatabasePlugin({
 								target_app_version: data.targetAppVersion || null,
 								storage_uri: data.storageUri,
 								fingerprint_hash: data.fingerprintHash,
-								metadata: data.metadata ?? {},
+								metadata: stripBundleArtifactMetadata(data.metadata) ?? {},
+								manifest_storage_uri: getManifestStorageUri(data),
+								manifest_file_hash: getManifestFileHash(data),
+								asset_base_storage_uri: getAssetBaseStorageUri(data),
+								patches: data.patches ?? null,
+								patch_base_bundle_id: getPatchBaseBundleId(data),
+								patch_base_file_hash: getPatchBaseFileHash(data),
+								patch_file_hash: getPatchFileHash(data),
+								patch_storage_uri: getPatchStorageUri(data),
 								rollout_cohort_count: data.rolloutCohortCount ?? DEFAULT_ROLLOUT_COHORT_COUNT,
 								target_cohorts: data.targetCohorts ?? null
 							}, { merge: true });
@@ -219,7 +255,7 @@ const firebaseDatabase = createDatabasePlugin({
 });
 //#endregion
 //#region src/firebaseStorage.ts
-const firebaseStorage = createStoragePlugin({
+const firebaseStorage = createUniversalStoragePlugin({
 	name: "firebaseStorage",
 	supportedProtocol: "gs",
 	factory: (config) => {
@@ -232,44 +268,65 @@ const firebaseStorage = createStoragePlugin({
 		const bucket = app.storage().bucket(config.storageBucket);
 		const getStorageKey = createStorageKeyBuilder(config.basePath);
 		return {
-			async delete(storageUri) {
-				const { bucket: bucketName, key } = parseStorageUri(storageUri, "gs");
-				if (bucketName !== config.storageBucket) throw new Error(`Bucket name mismatch: expected "${config.storageBucket}", but found "${bucketName}".`);
-				try {
-					const [files] = await bucket.getFiles({ prefix: key });
-					await Promise.all(files.map((file) => file.delete()));
-				} catch (e) {
-					console.error("Error listing or deleting files:", e);
-					throw new Error("Bundle Not Found");
+			node: {
+				async delete(storageUri) {
+					const { bucket: bucketName, key } = parseStorageUri(storageUri, "gs");
+					if (bucketName !== config.storageBucket) throw new Error(`Bucket name mismatch: expected "${config.storageBucket}", but found "${bucketName}".`);
+					try {
+						const [files] = await bucket.getFiles({ prefix: key });
+						await Promise.all(files.map((file) => file.delete()));
+					} catch (e) {
+						console.error("Error listing or deleting files:", e);
+						throw new Error("Bundle Not Found");
+					}
+				},
+				async upload(key, filePath) {
+					try {
+						const fileContent = await fs.readFile(filePath);
+						const contentType = getContentType(filePath);
+						const storageKey = getStorageKey(key, path.basename(filePath));
+						await bucket.file(storageKey).save(fileContent, { metadata: {
+							contentType,
+							cacheControl: "public, max-age=31536000, immutable"
+						} });
+						return { storageUri: `gs://${config.storageBucket}/${storageKey}` };
+					} catch (error) {
+						console.error("Error uploading bundle:", error);
+						if (error instanceof Error) throw new Error(`Failed to upload bundle: ${error.message}`);
+						throw error;
+					}
+				},
+				async downloadFile(storageUri, filePath) {
+					const { bucket: bucketName, key } = parseStorageUri(storageUri, "gs");
+					if (bucketName !== config.storageBucket) throw new Error(`Bucket name mismatch: expected "${config.storageBucket}", but found "${bucketName}".`);
+					await fs.mkdir(path.dirname(filePath), { recursive: true });
+					await bucket.file(key).download({ destination: filePath });
 				}
 			},
-			async upload(key, filePath) {
-				try {
-					const fileContent = await fs.readFile(filePath);
-					const contentType = getContentType(filePath);
-					const storageKey = getStorageKey(key, path.basename(filePath));
-					await bucket.file(storageKey).save(fileContent, { metadata: {
-						contentType,
-						cacheControl: "public, max-age=31536000, immutable"
-					} });
-					return { storageUri: `gs://${config.storageBucket}/${storageKey}` };
-				} catch (error) {
-					console.error("Error uploading bundle:", error);
-					if (error instanceof Error) throw new Error(`Failed to upload bundle: ${error.message}`);
-					throw error;
+			runtime: {
+				async readText(storageUri) {
+					const { bucket: bucketName, key } = parseStorageUri(storageUri, "gs");
+					if (bucketName !== config.storageBucket) throw new Error(`Bucket name mismatch: expected "${config.storageBucket}", but found "${bucketName}".`);
+					try {
+						const [contents] = await bucket.file(key).download();
+						return contents.toString("utf8");
+					} catch (error) {
+						if (typeof error === "object" && error !== null && "code" in error && error.code === 404) return null;
+						throw error;
+					}
+				},
+				async getDownloadUrl(storageUri) {
+					const u = new URL(storageUri);
+					if (u.protocol.replace(":", "") !== "gs") throw new Error("Invalid Firebase storage URI protocol");
+					const key = u.pathname.slice(1);
+					if (!key) throw new Error("Invalid Firebase storage URI: missing key");
+					const [signedUrl] = await bucket.file(key).getSignedUrl({
+						action: "read",
+						expires: Date.now() + 3600 * 1e3
+					});
+					if (!signedUrl) throw new Error("Failed to generate download URL");
+					return { fileUrl: signedUrl };
 				}
-			},
-			async getDownloadUrl(storageUri) {
-				const u = new URL(storageUri);
-				if (u.protocol.replace(":", "") !== "gs") throw new Error("Invalid Firebase storage URI protocol");
-				const key = u.pathname.slice(1);
-				if (!key) throw new Error("Invalid Firebase storage URI: missing key");
-				const [signedUrl] = await bucket.file(key).getSignedUrl({
-					action: "read",
-					expires: Date.now() + 3600 * 1e3
-				});
-				if (!signedUrl) throw new Error("Failed to generate download URL");
-				return { fileUrl: signedUrl };
 			}
 		};
 	}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hot-updater/firebase",
   "type": "module",
-  "version": "0.30.12",
+  "version": "0.31.0",
   "description": "React Native OTA solution for self-hosted",
   "main": "dist/index.cjs",
   "types": "dist/index.d.cts",
@@ -36,10 +36,10 @@
   "dependencies": {
     "firebase": "^11.3.1",
     "hono": "4.12.9",
-    "@hot-updater/core": "0.30.12",
-    "@hot-updater/cli-tools": "0.30.12",
-    "@hot-updater/plugin-core": "0.30.12",
-    "@hot-updater/server": "0.30.12"
+    "@hot-updater/cli-tools": "0.31.0",
+    "@hot-updater/server": "0.31.0",
+    "@hot-updater/core": "0.31.0",
+    "@hot-updater/plugin-core": "0.31.0"
   },
   "publishConfig": {
     "access": "public"
@@ -54,9 +54,9 @@
     "firebase-tools": "^13.32.0",
     "fkill": "^9.0.0",
     "mime": "^4.0.4",
-    "@hot-updater/js": "0.30.12",
-    "@hot-updater/test-utils": "0.30.12",
-    "@hot-updater/mock": "0.30.12"
+    "@hot-updater/js": "0.31.0",
+    "@hot-updater/mock": "0.31.0",
+    "@hot-updater/test-utils": "0.31.0"
   },
   "peerDependencies": {
     "firebase-admin": "*",