@hot-updater/supabase 0.30.12 → 0.31.1

package/dist/supabaseEdgeFunctionStorage-BZC0Z0XP.cjs

@@ -0,0 +1,292 @@
+require("./index.cjs");
+let _hot_updater_core = require("@hot-updater/core");
+let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
+let _supabase_supabase_js = require("@supabase/supabase-js");
+//#region src/supabaseDatabase.ts
+const normalizeMetadata = (value) => {
+	if (!value) return {};
+	if (typeof value === "string") try {
+		return normalizeMetadata(JSON.parse(value));
+	} catch {
+		return {};
+	}
+	if (typeof value === "object" && !Array.isArray(value)) return value;
+	return {};
+};
+const BUNDLE_SELECT_COLUMNS = "id, channel, enabled, platform, should_force_update, file_hash, git_commit_hash, message, fingerprint_hash, target_app_version, storage_uri, metadata, manifest_storage_uri, manifest_file_hash, asset_base_storage_uri, rollout_cohort_count, target_cohorts";
+const createSupabaseError = (error) => {
+	if (error instanceof Error) return error;
+	if (error && typeof error === "object") {
+		const properties = {};
+		let target = error;
+		while (target && target !== Object.prototype) {
+			for (const key of Object.getOwnPropertyNames(target)) properties[key] = error[key];
+			target = Object.getPrototypeOf(target);
+		}
+		return new Error(JSON.stringify({
+			name: error.constructor.name,
+			...properties
+		}));
+	}
+	try {
+		return new Error(JSON.stringify(error));
+	} catch {
+		return new Error(String(error));
+	}
+};
+const buildBundlePatchId = (bundleId, baseBundleId) => `${bundleId}:${baseBundleId}`;
+const mapRowToBundle = (row, patchRows = []) => {
+	const rawMetadata = normalizeMetadata(row.metadata);
+	const patches = patchRows.slice().sort((left, right) => left.order_index - right.order_index || left.base_bundle_id.localeCompare(right.base_bundle_id)).map((patch) => ({
+		baseBundleId: patch.base_bundle_id,
+		baseFileHash: patch.base_file_hash,
+		patchFileHash: patch.patch_file_hash,
+		patchStorageUri: patch.patch_storage_uri
+	}));
+	const primaryPatch = patches[0] ?? null;
+	return {
+		channel: row.channel,
+		enabled: Boolean(row.enabled),
+		shouldForceUpdate: Boolean(row.should_force_update),
+		fileHash: row.file_hash,
+		gitCommitHash: row.git_commit_hash,
+		id: row.id,
+		message: row.message,
+		platform: row.platform,
+		targetAppVersion: row.target_app_version,
+		fingerprintHash: row.fingerprint_hash,
+		storageUri: row.storage_uri,
+		metadata: (0, _hot_updater_core.stripBundleArtifactMetadata)(rawMetadata),
+		manifestStorageUri: row.manifest_storage_uri ?? null,
+		manifestFileHash: row.manifest_file_hash ?? null,
+		assetBaseStorageUri: row.asset_base_storage_uri ?? null,
+		patches,
+		patchBaseBundleId: primaryPatch?.baseBundleId ?? null,
+		patchBaseFileHash: primaryPatch?.baseFileHash ?? null,
+		patchFileHash: primaryPatch?.patchFileHash ?? null,
+		patchStorageUri: primaryPatch?.patchStorageUri ?? null,
+		rolloutCohortCount: row.rollout_cohort_count ?? _hot_updater_core.DEFAULT_ROLLOUT_COHORT_COUNT,
+		targetCohorts: row.target_cohorts ?? null
+	};
+};
+const bundleToRow = (bundle) => ({
+	id: bundle.id,
+	channel: bundle.channel,
+	enabled: bundle.enabled,
+	should_force_update: bundle.shouldForceUpdate,
+	file_hash: bundle.fileHash,
+	git_commit_hash: bundle.gitCommitHash,
+	message: bundle.message,
+	platform: bundle.platform,
+	target_app_version: bundle.targetAppVersion,
+	fingerprint_hash: bundle.fingerprintHash,
+	storage_uri: bundle.storageUri,
+	metadata: (0, _hot_updater_core.stripBundleArtifactMetadata)(bundle.metadata) ?? {},
+	manifest_storage_uri: (0, _hot_updater_core.getManifestStorageUri)(bundle),
+	manifest_file_hash: (0, _hot_updater_core.getManifestFileHash)(bundle),
+	asset_base_storage_uri: (0, _hot_updater_core.getAssetBaseStorageUri)(bundle),
+	rollout_cohort_count: bundle.rolloutCohortCount ?? _hot_updater_core.DEFAULT_ROLLOUT_COHORT_COUNT,
+	target_cohorts: bundle.targetCohorts ?? null
+});
+const bundleToPatchRows = (bundle) => (0, _hot_updater_core.getBundlePatches)(bundle).map((patch, index) => ({
+	id: buildBundlePatchId(bundle.id, patch.baseBundleId),
+	bundle_id: bundle.id,
+	base_bundle_id: patch.baseBundleId,
+	base_file_hash: patch.baseFileHash,
+	patch_file_hash: patch.patchFileHash,
+	patch_storage_uri: patch.patchStorageUri,
+	order_index: index
+}));
+const supabaseDatabase = (0, _hot_updater_plugin_core.createDatabasePlugin)({
+	name: "supabaseDatabase",
+	factory: (config) => {
+		const supabase = (0, _supabase_supabase_js.createClient)(config.supabaseUrl, config.supabaseAnonKey);
+		const fetchPatchMap = async (bundleIds) => {
+			const patchMap = /* @__PURE__ */ new Map();
+			if (bundleIds.length === 0) return patchMap;
+			const { data, error } = await supabase.from("bundle_patches").select("*").in("bundle_id", bundleIds).order("order_index", { ascending: true });
+			if (error) throw createSupabaseError(error);
+			for (const row of data ?? []) {
+				const current = patchMap.get(row.bundle_id) ?? [];
+				current.push(row);
+				patchMap.set(row.bundle_id, current);
+			}
+			return patchMap;
+		};
+		const mapRowsToBundles = async (rows) => {
+			const patchMap = await fetchPatchMap(rows.map((row) => row.id));
+			return rows.map((row) => mapRowToBundle(row, patchMap.get(row.id)));
+		};
+		return {
+			getUpdateInfo: (0, _hot_updater_plugin_core.createDatabasePluginGetUpdateInfo)({
+				async listTargetAppVersions({ platform, channel, minBundleId }) {
+					const { data, error } = await supabase.from("bundles").select("target_app_version").eq("platform", platform).eq("channel", channel).eq("enabled", true).gte("id", minBundleId).not("target_app_version", "is", null);
+					if (error) throw createSupabaseError(error);
+					return Array.from(new Set((data ?? []).map((row) => row.target_app_version).filter((version) => Boolean(version))));
+				},
+				async getBundlesByTargetAppVersions({ platform, channel, minBundleId }, targetAppVersions) {
+					const { data, error } = await supabase.from("bundles").select(BUNDLE_SELECT_COLUMNS).eq("platform", platform).eq("channel", channel).eq("enabled", true).gte("id", minBundleId).in("target_app_version", targetAppVersions);
+					if (error) throw createSupabaseError(error);
+					return mapRowsToBundles(data ?? []);
+				},
+				async getBundlesByFingerprint({ platform, channel, minBundleId, fingerprintHash }) {
+					const { data, error } = await supabase.from("bundles").select(BUNDLE_SELECT_COLUMNS).eq("platform", platform).eq("channel", channel).eq("enabled", true).gte("id", minBundleId).eq("fingerprint_hash", fingerprintHash);
+					if (error) throw createSupabaseError(error);
+					return mapRowsToBundles(data ?? []);
+				}
+			}),
+			async getBundleById(bundleId) {
+				const [{ data, error }, patchMap] = await Promise.all([supabase.from("bundles").select(BUNDLE_SELECT_COLUMNS).eq("id", bundleId).single(), fetchPatchMap([bundleId])]);
+				if (!data || error) return null;
+				return mapRowToBundle(data, patchMap.get(bundleId) ?? []);
+			},
+			async getBundles(options) {
+				const { where, limit, orderBy } = options ?? {};
+				const offset = (options && "offset" in options ? options.offset : void 0) ?? 0;
+				if (where?.targetAppVersionIn && where.targetAppVersionIn.length === 0 || where?.id?.in && where.id.in.length === 0) return {
+					data: [],
+					pagination: (0, _hot_updater_plugin_core.calculatePagination)(0, {
+						limit,
+						offset
+					})
+				};
+				let countQuery = supabase.from("bundles").select("*", {
+					count: "exact",
+					head: true
+				});
+				if (where?.channel) countQuery = countQuery.eq("channel", where.channel);
+				if (where?.platform) countQuery = countQuery.eq("platform", where.platform);
+				if (where?.enabled !== void 0) countQuery = countQuery.eq("enabled", where.enabled);
+				if (where?.fingerprintHash !== void 0) countQuery = where.fingerprintHash === null ? countQuery.is("fingerprint_hash", null) : countQuery.eq("fingerprint_hash", where.fingerprintHash);
+				if (where?.targetAppVersion !== void 0) countQuery = where.targetAppVersion === null ? countQuery.is("target_app_version", null) : countQuery.eq("target_app_version", where.targetAppVersion);
+				if (where?.targetAppVersionIn) countQuery = countQuery.in("target_app_version", where.targetAppVersionIn);
+				if (where?.targetAppVersionNotNull) countQuery = countQuery.not("target_app_version", "is", null);
+				if (where?.id?.eq) countQuery = countQuery.eq("id", where.id.eq);
+				if (where?.id?.gt) countQuery = countQuery.gt("id", where.id.gt);
+				if (where?.id?.gte) countQuery = countQuery.gte("id", where.id.gte);
+				if (where?.id?.lt) countQuery = countQuery.lt("id", where.id.lt);
+				if (where?.id?.lte) countQuery = countQuery.lte("id", where.id.lte);
+				if (where?.id?.in) countQuery = countQuery.in("id", where.id.in);
+				const { count: total = 0 } = await countQuery;
+				let query = supabase.from("bundles").select(BUNDLE_SELECT_COLUMNS).order("id", { ascending: orderBy?.direction === "asc" });
+				if (where?.channel) query = query.eq("channel", where.channel);
+				if (where?.platform) query = query.eq("platform", where.platform);
+				if (where?.enabled !== void 0) query = query.eq("enabled", where.enabled);
+				if (where?.fingerprintHash !== void 0) query = where.fingerprintHash === null ? query.is("fingerprint_hash", null) : query.eq("fingerprint_hash", where.fingerprintHash);
+				if (where?.targetAppVersion !== void 0) query = where.targetAppVersion === null ? query.is("target_app_version", null) : query.eq("target_app_version", where.targetAppVersion);
+				if (where?.targetAppVersionIn) query = query.in("target_app_version", where.targetAppVersionIn);
+				if (where?.targetAppVersionNotNull) query = query.not("target_app_version", "is", null);
+				if (where?.id?.eq) query = query.eq("id", where.id.eq);
+				if (where?.id?.gt) query = query.gt("id", where.id.gt);
+				if (where?.id?.gte) query = query.gte("id", where.id.gte);
+				if (where?.id?.lt) query = query.lt("id", where.id.lt);
+				if (where?.id?.lte) query = query.lte("id", where.id.lte);
+				if (where?.id?.in) query = query.in("id", where.id.in);
+				if (limit) query = query.limit(limit);
+				if (offset) query = query.range(offset, offset + (limit || 20) - 1);
+				const { data } = await query;
+				const patchMap = await fetchPatchMap((data ?? []).map((bundle) => bundle.id));
+				return {
+					data: (data ?? []).map((bundle) => mapRowToBundle(bundle, patchMap.get(bundle.id) ?? [])),
+					pagination: (0, _hot_updater_plugin_core.calculatePagination)(total ?? 0, {
+						limit,
+						offset
+					})
+				};
+			},
+			async getChannels() {
+				const { data, error } = await supabase.rpc("get_channels");
+				if (error) throw error;
+				return data.map((bundle) => bundle.channel);
+			},
+			async commitBundle({ changedSets }) {
+				if (changedSets.length === 0) return;
+				for (const op of changedSets) if (op.operation === "delete") {
+					const { error: patchDeleteError } = await supabase.from("bundle_patches").delete().eq("bundle_id", op.data.id);
+					if (patchDeleteError) throw new Error(`Failed to delete bundle patches: ${patchDeleteError.message}`);
+					const { error: basePatchDeleteError } = await supabase.from("bundle_patches").delete().eq("base_bundle_id", op.data.id);
+					if (basePatchDeleteError) throw new Error(`Failed to delete base bundle patches: ${basePatchDeleteError.message}`);
+					const { error } = await supabase.from("bundles").delete().eq("id", op.data.id);
+					if (error) throw new Error(`Failed to delete bundle: ${error.message}`);
+				} else if (op.operation === "insert" || op.operation === "update") {
+					const bundle = op.data;
+					const patchRows = bundleToPatchRows(bundle);
+					const { error } = await supabase.from("bundles").upsert(bundleToRow(bundle), { onConflict: "id" });
+					if (error) throw error;
+					const { error: patchDeleteError } = await supabase.from("bundle_patches").delete().eq("bundle_id", bundle.id);
+					if (patchDeleteError) throw patchDeleteError;
+					if (patchRows.length > 0) {
+						const { error: patchInsertError } = await supabase.from("bundle_patches").upsert(patchRows, { onConflict: "id" });
+						if (patchInsertError) throw patchInsertError;
+					}
+				}
+			}
+		};
+	}
+});
+//#endregion
+//#region src/supabaseEdgeFunctionDatabase.ts
+const supabaseEdgeFunctionDatabase = (config, hooks) => {
+	return supabaseDatabase({
+		supabaseUrl: config.supabaseUrl,
+		supabaseAnonKey: config.supabaseServiceRoleKey
+	}, hooks);
+};
+//#endregion
+//#region src/supabaseEdgeFunctionStorage.ts
+const parseSupabaseStorageUri = (storageUri) => {
+	const storageUrl = new URL(storageUri);
+	if (storageUrl.protocol !== "supabase-storage:") throw new Error("Invalid Supabase storage URI protocol");
+	const bucketName = storageUrl.host;
+	const key = storageUrl.pathname.replace(/^\/+/, "");
+	if (!bucketName || !key) throw new Error("Invalid Supabase storage URI");
+	return {
+		bucketName,
+		key
+	};
+};
+const supabaseEdgeFunctionStorage = (0, _hot_updater_plugin_core.createRuntimeStoragePlugin)({
+	name: "supabaseEdgeFunctionStorage",
+	supportedProtocol: "supabase-storage",
+	factory: (config) => {
+		const supabase = (0, _supabase_supabase_js.createClient)(config.supabaseUrl, config.supabaseServiceRoleKey);
+		return {
+			async readText(storageUri) {
+				const { bucketName, key } = parseSupabaseStorageUri(storageUri);
+				const { data, error } = await supabase.storage.from(bucketName).download(key);
+				if (error) {
+					if (error.message?.includes("not found")) return null;
+					throw new Error(`Failed to read storage text: ${error.message}`);
+				}
+				if (!data) return null;
+				return data.text();
+			},
+			async getDownloadUrl(storageUri) {
+				const { bucketName, key } = parseSupabaseStorageUri(storageUri);
+				const { data, error } = await supabase.storage.from(bucketName).createSignedUrl(key, config.signedUrlExpiresIn ?? 3600);
+				if (error) throw new Error(`Failed to generate download URL: ${error.message}`);
+				if (!data?.signedUrl) throw new Error("Failed to generate download URL");
+				return { fileUrl: data.signedUrl };
+			}
+		};
+	}
+});
+//#endregion
+Object.defineProperty(exports, "supabaseDatabase", {
+	enumerable: true,
+	get: function() {
+		return supabaseDatabase;
+	}
+});
+Object.defineProperty(exports, "supabaseEdgeFunctionDatabase", {
+	enumerable: true,
+	get: function() {
+		return supabaseEdgeFunctionDatabase;
+	}
+});
+Object.defineProperty(exports, "supabaseEdgeFunctionStorage", {
+	enumerable: true,
+	get: function() {
+		return supabaseEdgeFunctionStorage;
+	}
+});

package/dist/{supabaseEdgeFunctionStorage-CSPi2UB8.d.cts → supabaseEdgeFunctionStorage-CU396KO3.d.cts}

@@ -1,5 +1,5 @@
 import * as _$_hot_updater_plugin_core0 from "@hot-updater/plugin-core";
-import { DatabasePluginHooks, StoragePlugin } from "@hot-updater/plugin-core";
+import { DatabasePluginHooks } from "@hot-updater/plugin-core";
 
 //#region src/supabaseEdgeFunctionDatabase.d.ts
 interface SupabaseEdgeFunctionDatabaseConfig {
@@ -14,6 +14,6 @@ interface SupabaseEdgeFunctionStorageConfig {
   supabaseServiceRoleKey: string;
   signedUrlExpiresIn?: number;
 }
-declare const supabaseEdgeFunctionStorage: (config: SupabaseEdgeFunctionStorageConfig) => () => StoragePlugin;
+declare const supabaseEdgeFunctionStorage: (config: SupabaseEdgeFunctionStorageConfig, hooks?: _$_hot_updater_plugin_core0.StoragePluginHooks) => () => _$_hot_updater_plugin_core0.RuntimeStoragePlugin<unknown>;
 //#endregion
 export { supabaseEdgeFunctionDatabase as i, supabaseEdgeFunctionStorage as n, SupabaseEdgeFunctionDatabaseConfig as r, SupabaseEdgeFunctionStorageConfig as t };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hot-updater/supabase",
   "type": "module",
-  "version": "0.30.12",
+  "version": "0.31.1",
   "description": "React Native OTA solution for self-hosted",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -47,10 +47,10 @@
     "@supabase/supabase-js": "2.76.1",
     "hono": "4.12.9",
     "uuidv7": "^1.0.2",
-    "@hot-updater/core": "0.30.12",
-    "@hot-updater/plugin-core": "0.30.12",
-    "@hot-updater/cli-tools": "0.30.12",
-    "@hot-updater/server": "0.30.12"
+    "@hot-updater/core": "0.31.1",
+    "@hot-updater/cli-tools": "0.31.1",
+    "@hot-updater/server": "0.31.1",
+    "@hot-updater/plugin-core": "0.31.1"
   },
   "devDependencies": {
     "@electric-sql/pglite": "0.2.17",
@@ -60,10 +60,10 @@
     "execa": "9.5.2",
     "@types/node": "^20",
     "mime": "^4.0.4",
-    "@hot-updater/js": "0.30.12",
-    "@hot-updater/mock": "0.30.12",
-    "@hot-updater/postgres": "0.30.12",
-    "@hot-updater/test-utils": "0.30.12"
+    "@hot-updater/js": "0.31.1",
+    "@hot-updater/mock": "0.31.1",
+    "@hot-updater/test-utils": "0.31.1",
+    "@hot-updater/postgres": "0.31.1"
   },
   "scripts": {
     "build": "tsdown",

package/supabase/edge-functions/runtime.docker.integration.spec.ts

@@ -16,7 +16,10 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 import { transformEnv } from "@hot-updater/cli-tools";
 import { type Bundle, type GetBundlesArgs, NIL_UUID } from "@hot-updater/core";
 import { createHotUpdater } from "@hot-updater/server/runtime";
-import { setupGetUpdateInfoTestSuite } from "@hot-updater/test-utils";
+import {
+  setupBsdiffManifestUpdateInfoTestSuite,
+  setupGetUpdateInfoTestSuite,
+} from "@hot-updater/test-utils";
 import { createClient } from "@supabase/supabase-js";
 import { afterAll, beforeAll, beforeEach, describe, expect, it } from "vitest";
 
@@ -26,6 +29,7 @@ import {
   runCheckedCommand,
   spawnRuntime,
   stopRuntime,
+  formatRuntimeLogs,
   waitForHttpOk,
 } from "../../../../packages/test-utils/src/runtimeProcess";
 import { supabaseDatabase } from "../../src/supabaseDatabase";
@@ -211,7 +215,8 @@ describe.sequential("supabase edge runtime acceptance", () => {
       );
     }
 
-    await waitForUrlOk(`${gatewayBaseUrl}/storage/v1/status`);
+    await waitForRestApiReady(gatewayBaseUrl, 180_000);
+    await waitForUrlOk(`${gatewayBaseUrl}/storage/v1/status`, 180_000);
 
     supabaseAdmin = createClient(gatewayBaseUrl, SERVICE_ROLE_KEY);
     await ensureBucketExists(supabaseAdmin);
@@ -242,10 +247,12 @@ describe.sequential("supabase edge runtime acceptance", () => {
         "--rm",
         "--network",
         `${composeProjectName}_default`,
+        "--add-host",
+        "host.docker.internal:host-gateway",
         "-p",
         `127.0.0.1:${edgePort}:8000`,
         "-e",
-        `SUPABASE_URL=http://gateway:8000`,
+        `SUPABASE_URL=http://host.docker.internal:${gatewayPort}`,
         "-e",
         `SUPABASE_SERVICE_ROLE_KEY=${SERVICE_ROLE_KEY}`,
         "-e",
@@ -280,7 +287,7 @@ describe.sequential("supabase edge runtime acceptance", () => {
       logs: edgeRuntime.logs,
       timeoutMs: 90_000,
     });
-  }, 180_000);
+  }, 300_000);
 
   beforeEach(async () => {
     if (!supabaseAdmin) {
@@ -328,24 +335,153 @@ describe.sequential("supabase edge runtime acceptance", () => {
     }
   }, 60_000);
 
-  const getUpdateInfo = async (bundles: Bundle[], args: GetBundlesArgs) => {
-    if (!supabaseAdmin) {
-      throw new Error("Supabase admin client was not initialized.");
-    }
-
+  const seedRuntimeBundles = async (bundles: Bundle[]) => {
     for (const bundle of bundles.map(toRuntimeBundle)) {
-      await uploadBundleObject(supabaseAdmin, bundle.id);
       await seedHotUpdater.insertBundle(bundle);
     }
+  };
 
+  const requestUpdateInfo = async (args: GetBundlesArgs) => {
     const response = await fetch(
       `http://127.0.0.1:${edgePort}${FUNCTION_BASE_PATH}${createCanonicalPath(args)}`,
     );
 
+    if (!response.ok) {
+      throw new Error(
+        [
+          `Edge runtime returned ${response.status} ${response.statusText}`,
+          await response.text(),
+          edgeRuntime ? formatRuntimeLogs(edgeRuntime.logs) : "",
+        ].join("\n\n"),
+      );
+    }
+
     return (await response.json()) as any;
   };
 
-  setupGetUpdateInfoTestSuite({ getUpdateInfo });
+  const getUpdateInfo = async (bundles: Bundle[], args: GetBundlesArgs) => {
+    if (!supabaseAdmin) {
+      throw new Error("Supabase admin client was not initialized.");
+    }
+
+    for (const bundle of bundles) {
+      await uploadBundleObject(supabaseAdmin, bundle.id);
+    }
+    await seedRuntimeBundles(bundles);
+    return requestUpdateInfo(args);
+  };
+
+  setupGetUpdateInfoTestSuite({
+    getUpdateInfo,
+    manifestArtifacts: {
+      prepareArtifacts: async (fixture) => {
+        await Promise.all([
+          uploadStorageObject(
+            supabaseAdmin,
+            `${fixture.currentBundleId}/manifest.json`,
+            JSON.stringify(fixture.currentManifest),
+            "application/json",
+          ),
+          uploadStorageObject(
+            supabaseAdmin,
+            `${fixture.nextBundleId}/manifest.json`,
+            JSON.stringify(fixture.nextManifest),
+            "application/json",
+          ),
+          uploadStorageObject(
+            supabaseAdmin,
+            `${fixture.nextBundleId}/files/${fixture.changedAssetPath}.br`,
+            "next-bundle-bytes",
+            "application/javascript",
+          ),
+        ]);
+
+        return {
+          currentArtifacts: {
+            assetBaseStorageUri: `supabase-storage://${BUCKET_NAME}/${fixture.currentBundleId}/files`,
+            manifestFileHash: "sig:manifest-current",
+            manifestStorageUri: `supabase-storage://${BUCKET_NAME}/${fixture.currentBundleId}/manifest.json`,
+          },
+          nextArtifacts: {
+            assetBaseStorageUri: `supabase-storage://${BUCKET_NAME}/${fixture.nextBundleId}/files`,
+            manifestFileHash: "sig:manifest-next",
+            manifestStorageUri: `supabase-storage://${BUCKET_NAME}/${fixture.nextBundleId}/manifest.json`,
+          },
+        };
+      },
+      expectFileUrl: (fileUrl, fixture) => {
+        expect(fileUrl).toContain(
+          `/storage/v1/object/sign/${BUCKET_NAME}/${fixture.nextBundleId}/files/${fixture.changedAssetPath}.br`,
+        );
+      },
+      expectManifestUrl: (manifestUrl, fixture) => {
+        expect(manifestUrl).toContain(
+          `/storage/v1/object/sign/${BUCKET_NAME}/${fixture.nextBundleId}/manifest.json`,
+        );
+      },
+    },
+  });
+
+  setupBsdiffManifestUpdateInfoTestSuite({
+    seedBundles: seedRuntimeBundles,
+    getUpdateInfo: requestUpdateInfo,
+    prepareArtifacts: async (fixture) => {
+      await Promise.all([
+        uploadStorageObject(
+          supabaseAdmin,
+          `${fixture.currentBundleId}/manifest.json`,
+          JSON.stringify(fixture.currentManifest),
+          "application/json",
+        ),
+        uploadStorageObject(
+          supabaseAdmin,
+          `${fixture.nextBundleId}/manifest.json`,
+          JSON.stringify(fixture.nextManifest),
+          "application/json",
+        ),
+        uploadStorageObject(
+          supabaseAdmin,
+          `${fixture.nextBundleId}/files/${fixture.assetPath}`,
+          "next-bundle-bytes",
+          "application/javascript",
+        ),
+        uploadStorageObject(
+          supabaseAdmin,
+          fixture.patchPath,
+          "patch-bytes",
+          "application/octet-stream",
+        ),
+        uploadBundleObject(supabaseAdmin, fixture.currentBundleId),
+        uploadBundleObject(supabaseAdmin, fixture.nextBundleId),
+      ]);
+
+      return {
+        currentArtifacts: {
+          assetBaseStorageUri: `supabase-storage://${BUCKET_NAME}/${fixture.currentBundleId}/files`,
+          manifestFileHash: "sig:manifest-current",
+          manifestStorageUri: `supabase-storage://${BUCKET_NAME}/${fixture.currentBundleId}/manifest.json`,
+        },
+        nextArtifacts: {
+          assetBaseStorageUri: `supabase-storage://${BUCKET_NAME}/${fixture.nextBundleId}/files`,
+          manifestFileHash: "sig:manifest-next",
+          manifestStorageUri: `supabase-storage://${BUCKET_NAME}/${fixture.nextBundleId}/manifest.json`,
+          patches: [
+            {
+              baseBundleId: fixture.currentBundleId,
+              baseFileHash: "hash-old-bundle",
+              patchFileHash: "hash-bsdiff",
+              patchStorageUri: `supabase-storage://${BUCKET_NAME}/${fixture.patchPath}`,
+            },
+          ],
+        },
+      };
+    },
+    expectPatchUrl: (patchUrl, fixture) => {
+      expect(patchUrl).toContain(
+        `/storage/v1/object/sign/${BUCKET_NAME}/${fixture.patchPath}`,
+      );
+    },
+  });
 
   it("serves canonical routes from the edge function entrypoint", async () => {
     const bundle = toRuntimeBundle({
@@ -451,6 +587,36 @@ const waitForUrlOk = async (url: string, timeoutMs = 90_000) => {
   throw new Error(`Timed out waiting for ${url}: ${lastError}`);
 };
 
+const waitForRestApiReady = async (baseUrl: string, timeoutMs = 90_000) => {
+  const deadline = Date.now() + timeoutMs;
+  let lastError = "no response";
+
+  while (Date.now() < deadline) {
+    try {
+      const response = await fetch(
+        `${baseUrl}/rest/v1/bundles?select=id&limit=1`,
+        {
+          headers: {
+            apikey: SERVICE_ROLE_KEY,
+            Authorization: `Bearer ${SERVICE_ROLE_KEY}`,
+          },
+        },
+      );
+      if (response.ok) {
+        return;
+      }
+
+      lastError = `${response.status} ${response.statusText}: ${await response.text()}`;
+    } catch (error) {
+      lastError = error instanceof Error ? error.message : String(error);
+    }
+
+    await sleep(500);
+  }
+
+  throw new Error(`Timed out waiting for PostgREST: ${lastError}`);
+};
+
 const sleep = async (ms: number) => {
   await new Promise((resolve) => setTimeout(resolve, ms));
 };
@@ -479,11 +645,25 @@ const ensureBucketExists = async (
 const uploadBundleObject = async (
   supabaseAdmin: ReturnType<typeof createClient>,
   bundleId: string,
+) => {
+  await uploadStorageObject(
+    supabaseAdmin,
+    `${bundleId}/bundle.zip`,
+    Buffer.from("zip"),
+    "application/zip",
+  );
+};
+
+const uploadStorageObject = async (
+  supabaseAdmin: ReturnType<typeof createClient>,
+  key: string,
+  body: string | Buffer,
+  contentType: string,
 ) => {
   const { error } = await supabaseAdmin.storage
     .from(BUCKET_NAME)
-    .upload(`${bundleId}/bundle.zip`, Buffer.from("zip"), {
-      contentType: "application/zip",
+    .upload(key, body, {
+      contentType,
       cacheControl: "31536000",
       upsert: true,
     });
@@ -664,7 +844,7 @@ services:
       rest:
         condition: service_started
     ports:
-      - "127.0.0.1:${gatewayPort}:8000"
+      - "0.0.0.0:${gatewayPort}:8000"
     volumes:
       - ${path.join(runtimeRoot, "nginx.conf")}:/etc/nginx/nginx.conf:ro
 

package/supabase/migrations/20260422000000_hot-updater_0.31.0.sql

@@ -0,0 +1,20 @@
+-- HotUpdater.bundle_artifact_columns
+
+ALTER TABLE bundles ADD COLUMN IF NOT EXISTS manifest_storage_uri text;
+ALTER TABLE bundles ADD COLUMN IF NOT EXISTS manifest_file_hash text;
+ALTER TABLE bundles ADD COLUMN IF NOT EXISTS asset_base_storage_uri text;
+
+CREATE TABLE IF NOT EXISTS bundle_patches (
+    id text PRIMARY KEY,
+    bundle_id uuid NOT NULL REFERENCES bundles(id) ON DELETE CASCADE,
+    base_bundle_id uuid NOT NULL REFERENCES bundles(id) ON DELETE CASCADE,
+    base_file_hash text NOT NULL,
+    patch_file_hash text NOT NULL,
+    patch_storage_uri text NOT NULL,
+    order_index integer NOT NULL DEFAULT 0
+);
+
+CREATE INDEX IF NOT EXISTS bundle_patches_bundle_id_idx
+    ON bundle_patches(bundle_id);
+CREATE INDEX IF NOT EXISTS bundle_patches_base_bundle_id_idx
+    ON bundle_patches(base_bundle_id);