@hot-updater/test-utils 1.0.0-rc.21 → 1.0.0-rc.22

package/README.md

@@ -122,6 +122,10 @@ case, and the `cleanup` it may return runs after the case. `operations` lists
 what the adapter implements: the suite fails when one of them is missing and
 skips the cases of the others.
 
+With `fetchDownloadUrls: true`, the suite downloads every `http(s)` URL
+`getDownloadUrl` returns and requires the object's bytes, for a spec against a
+real bucket or emulator whose URLs the test can reach.
+
 ## Plugins and servers
 
 - `createPluginTestHarness` runs one server plugin on `createEngine` from

package/dist/index.d.mts

@@ -197,6 +197,12 @@ interface StorageAdapterTestSuiteOptions {
    * it, the suite skips the cases of the operations the adapter lacks.
    */
   readonly operations?: readonly StorageOperation[];
+  /**
+   * Fetches every `http(s)` URL `getDownloadUrl` returns and requires the
+   * object's bytes. Set it when the adapter runs against a bucket or emulator
+   * whose URLs the test can reach.
+   */
+  readonly fetchDownloadUrls?: boolean;
 }
 /**
  * The storage adapter contract that deploy, patch, the Console, the server,

package/dist/index.mjs

@@ -2452,15 +2452,15 @@ const namingCalls = (storage) => {
 const storageCase = (title, operations, run) => ({
 	title,
 	operations,
-	run: async ({ storage, basePath }) => {
+	run: async ({ storage, ...context }) => {
 		assertStorageOperations(storage, [
 			"put",
 			"get",
 			...operations
 		]);
 		await run({
-			storage: namingCalls(storage),
-			basePath
+			...context,
+			storage: namingCalls(storage)
 		});
 	}
 });
@@ -2629,15 +2629,21 @@ const storageAdapterTestCases = [
 		}), "another protocol");
 		await expectObject(storage, storageUri, bytes);
 	}),
-	storageCase("resolves a download URL for a stored object", ["getDownloadUrl"], async ({ storage, basePath }) => {
+	storageCase("resolves a download URL for a stored object", ["getDownloadUrl"], async ({ storage, basePath, fetchDownloadUrls }) => {
 		const objects = objectsOf(storage, basePath);
 		for (const key of ["download/object.txt", ...SPECIAL_KEYS]) {
-			const storageUri = await objects.put(key, encode(key));
+			const bytes = encode(key);
+			const storageUri = await objects.put(key, bytes);
 			const { url } = await storage.getDownloadUrl({ storageUri });
 			const label = `getDownloadUrl("${storageUri}") returned "${url}"`;
 			expect(typeof url, label).toBe("string");
 			if (/^[a-z][a-z\d+.-]*:/i.test(url)) {
 				expect(["http:", "https:"], `${label}; a URL must use http(s)`).toContain(new URL(url).protocol);
+				if (fetchDownloadUrls) {
+					const response = await fetch(url);
+					expect(response.status, `${label}, which answered`).toBe(200);
+					expectBytes(new Uint8Array(await response.arrayBuffer()), bytes, `${label}, whose download`);
+				}
 				continue;
 			}
 			expect(parseStorageDownloadPath(url)?.storageUri, `${label}; a path must be the /storage/ path of the same URI`).toBe(storageUri);
@@ -2724,7 +2730,8 @@ const setupStorageAdapterTestSuite = (options) => {
 					if (declared === void 0 && missing.length > 0) context.skip(`${storage.name} lacks ${missing.join(", ")}`);
 					await testCase.run({
 						storage,
-						basePath
+						basePath,
+						fetchDownloadUrls: options.fetchDownloadUrls
 					});
 				} finally {
 					await cleanup?.();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hot-updater/test-utils",
-  "version": "1.0.0-rc.21",
+  "version": "1.0.0-rc.22",
   "type": "module",
   "description": "Test utilities for Hot Updater packages",
   "sideEffects": false,
@@ -50,10 +50,10 @@
     "mysql2": "*",
     "pg": "*",
     "vitest": "^4.0.0",
-    "@hot-updater/plugin-insights": "^1.0.0-rc.21",
-    "@hot-updater/plugin-core": "^1.0.0-rc.21",
-    "@hot-updater/protocol": "^1.0.0-rc.21",
-    "@hot-updater/server": "^1.0.0-rc.21"
+    "@hot-updater/plugin-insights": "^1.0.0-rc.22",
+    "@hot-updater/plugin-core": "^1.0.0-rc.22",
+    "@hot-updater/server": "^1.0.0-rc.22",
+    "@hot-updater/protocol": "^1.0.0-rc.22"
   },
   "peerDependenciesMeta": {
     "@electric-sql/pglite": {
@@ -83,11 +83,11 @@
     "typescript": "npm:@typescript/typescript6@6.0.2",
     "vitest": "4.1.4",
     "workspace-tools": "^0.41.7",
-    "@hot-updater/protocol": "1.0.0-rc.21",
-    "@hot-updater/plugin-core": "1.0.0-rc.21",
-    "@hot-updater/js": "1.0.0-rc.21",
-    "@hot-updater/server": "1.0.0-rc.21",
-    "@hot-updater/plugin-insights": "1.0.0-rc.21"
+    "@hot-updater/protocol": "1.0.0-rc.22",
+    "@hot-updater/plugin-insights": "1.0.0-rc.22",
+    "@hot-updater/plugin-core": "1.0.0-rc.22",
+    "@hot-updater/server": "1.0.0-rc.22",
+    "@hot-updater/js": "1.0.0-rc.22"
   },
   "inlinedDependencies": {
     "@nodelib/fs.scandir": "2.1.5",