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

package/dist/react-native.cjs

@@ -0,0 +1,177 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _hot_updater_protocol = require("@hot-updater/protocol");
+//#region src/setupClientPlugins.ts
+/**
+* Runs client plugins in tests the way the SDK runs them in an app, against
+* an in-memory device and a server the test answers.
+*
+* ```ts
+* import { setupClientPlugin } from "@hot-updater/test-utils/react-native";
+*
+* const runtime = setupClientPlugin(myPlugin());
+* runtime.hooks.onAppReady(launch);
+* await runtime.settled();
+* expect(runtime.requests[0]?.json()).toEqual(expectedEvent);
+* ```
+*
+* It sets plugins up with the plugin host from `@hot-updater/protocol`,
+* the same code the app runs, so they get the same context and rules:
+* unique ids, `setup` once per runtime, storage scoped to the plugin's id
+* with values up to 64 KB, `fetch` relative to `baseURL` with
+* `requestHeaders` and `requestTimeout`, and hooks the SDK never waits for,
+* whose throws and rejections are reported, not raised. It imports neither
+* React Native nor a test runner, so it works under Vitest and Jest.
+*/
+const storageItems = /* @__PURE__ */ new WeakMap();
+/** A new device's empty plugin storage. */
+const createTestStorage = () => {
+	const items = /* @__PURE__ */ new Map();
+	const storage = {
+		get: (pluginId, key) => items.get((0, _hot_updater_protocol.pluginStorageKey)(pluginId, key)) ?? null,
+		set: (pluginId, key, value) => {
+			if (value !== null && typeof value !== "string") throw new TypeError("[HotUpdater] Plugin storage values are strings or null.");
+			const storageKey = (0, _hot_updater_protocol.pluginStorageKey)(pluginId, key);
+			if (value === null) items.delete(storageKey);
+			else items.set(storageKey, value);
+		},
+		entries: (pluginId) => {
+			const prefix = (0, _hot_updater_protocol.pluginStorageKey)(pluginId, "");
+			return Object.fromEntries([...items].filter(([storageKey]) => storageKey.startsWith(prefix)).map(([storageKey, value]) => [storageKey.slice(prefix.length), value]));
+		}
+	};
+	storageItems.set(storage, items);
+	return storage;
+};
+const read = (value) => typeof value === "function" ? value() : value;
+const abortError = (signal) => {
+	const reason = signal?.reason;
+	if (reason instanceof Error && reason.name === "AbortError") return reason;
+	const error = /* @__PURE__ */ new Error("The operation was aborted.");
+	error.name = "AbortError";
+	return error;
+};
+/**
+* Resolves after every pending microtask, on a macrotask that fake timers
+* leave alone.
+*/
+const nextMacrotask = () => new Promise((resolve) => {
+	const Channel = globalThis.MessageChannel;
+	if (Channel === void 0) {
+		setTimeout(resolve, 0);
+		return;
+	}
+	const { port1, port2 } = new Channel();
+	port1.addEventListener("message", () => {
+		port1.close();
+		resolve();
+	}, { once: true });
+	port1.start();
+	port2.postMessage(null);
+});
+/** Sets plugins up as `HotUpdater.init({ plugins })` does, in a new runtime. */
+const setupClientPlugins = (plugins, options = {}) => {
+	const storage = options.storage ?? createTestStorage();
+	const items = storageItems.get(storage);
+	if (items === void 0) throw new TypeError("[HotUpdater] Pass a storage from createTestStorage() or an earlier runtime.");
+	const baseURL = options.baseURL ?? "https://hot-updater.example.com";
+	const respond = options.respond ?? (() => new Response(null, { status: 204 }));
+	const requests = [];
+	const errors = [];
+	const pending = /* @__PURE__ */ new Set();
+	const track = (work) => {
+		const settledWork = work.then(() => void 0, () => void 0).finally(() => {
+			pending.delete(settledWork);
+		});
+		pending.add(settledWork);
+	};
+	const recordRequest = async (url, init) => {
+		const request = new Request(url, init);
+		const body = typeof init.body === "string" ? init.body : init.body === void 0 || init.body === null ? null : await request.text();
+		const base = await (0, _hot_updater_protocol.resolveBaseURL)(baseURL);
+		const headers = {};
+		request.headers.forEach((value, name) => {
+			headers[name] = value;
+		});
+		return {
+			url,
+			path: url.startsWith(`${base}/`) ? url.slice(base.length) : url,
+			method: request.method,
+			headers,
+			body,
+			json: () => {
+				if (body === null) throw new SyntaxError("The request has no body to parse as JSON.");
+				return JSON.parse(body);
+			}
+		};
+	};
+	const answer = (request, signal) => new Promise((resolve, reject) => {
+		const abort = () => reject(abortError(signal));
+		if (signal?.aborted) {
+			abort();
+			return;
+		}
+		signal?.addEventListener("abort", abort, { once: true });
+		Promise.resolve().then(() => respond(request)).then(resolve, reject).finally(() => signal?.removeEventListener("abort", abort));
+	});
+	const host = (0, _hot_updater_protocol.createPluginHost)({
+		fetch: (url, init) => {
+			const response = recordRequest(url, init).then((request) => {
+				requests.push(request);
+				return answer(request, init.signal);
+			});
+			track(response);
+			return response;
+		},
+		platform: options.platform ?? "ios",
+		isDebugBuild: options.isDebugBuild ?? false,
+		sdkVersion: options.sdkVersion ?? "0.0.0-test",
+		getInstallId: () => read(options.installId ?? "00000000-0000-4000-8000-000000000000"),
+		getAppVersion: () => read(options.appVersion === void 0 ? "1.0.0" : options.appVersion),
+		getBundleId: () => read(options.bundleId ?? "00000000-0000-0000-0000-000000000000"),
+		getChannel: () => read(options.channel ?? "production"),
+		getCohort: () => read(options.cohort ?? "1"),
+		getFingerprintHash: () => read(options.fingerprintHash === void 0 ? null : options.fingerprintHash),
+		getStorageItem: (key) => items.get(key) ?? null,
+		setStorageItem: (key, value) => {
+			if (value === null) items.delete(key);
+			else items.set(key, value);
+		},
+		now: () => options.now ? options.now() : Date.now()
+	});
+	host.configurePlugins(plugins, {
+		baseURL,
+		requestHeaders: options.requestHeaders,
+		requestTimeout: options.requestTimeout,
+		onError: (error) => {
+			errors.push(error);
+		}
+	});
+	const call = (name) => (payload) => {
+		for (const settlement of host.dispatchPluginHook(name, payload)) track(settlement);
+	};
+	return {
+		hooks: {
+			onAppReady: call("onAppReady"),
+			onUpdateCheck: call("onUpdateCheck"),
+			onBundleDownloaded: call("onBundleDownloaded"),
+			onUpdateError: call("onUpdateError")
+		},
+		listens: (name) => host.hasPluginHook(name),
+		requests,
+		storage,
+		errors,
+		settled: async () => {
+			for (;;) {
+				await nextMacrotask();
+				if (pending.size === 0) return;
+				await Promise.all(pending);
+			}
+		}
+	};
+};
+/** Sets one plugin up; see `setupClientPlugins`. */
+const setupClientPlugin = (plugin, options) => setupClientPlugins([plugin], options);
+//#endregion
+exports.createTestStorage = createTestStorage;
+exports.setupClientPlugin = setupClientPlugin;
+exports.setupClientPlugins = setupClientPlugins;

package/dist/react-native.d.cts

@@ -0,0 +1,104 @@
+import { AppReadyResult, BundleDownloadedInfo, HotUpdaterBaseURL, HotUpdaterClientPlugin, UpdateCheckResult, UpdateError } from "@hot-updater/protocol";
+//#region src/setupClientPlugins.d.ts
+/** A value the test fixes, or reads each time a plugin asks for it. */
+type TestValue<T> = T | (() => T);
+interface ClientPluginTestOptions {
+  /** The server plugins fetch from. Default: `https://hot-updater.example.com`. */
+  readonly baseURL?: HotUpdaterBaseURL;
+  /** Headers the SDK adds to every plugin request, as `init` and `wrap` take them. */
+  readonly requestHeaders?: Record<string, string>;
+  /** Milliseconds before a plugin request fails with `Request timed out`. Default: 5000. */
+  readonly requestTimeout?: number;
+  /**
+   * Answers each plugin request. Default: `204 No Content`. Throw or reject
+   * to fail the request the way a network error does.
+   */
+  readonly respond?: (request: ClientPluginTestRequest) => Response | Promise<Response>;
+  /** Default: `00000000-0000-4000-8000-000000000000`. */
+  readonly installId?: TestValue<string>;
+  /** Default: `ios`. */
+  readonly platform?: "ios" | "android";
+  /** The native app version. Default: `1.0.0`. */
+  readonly appVersion?: TestValue<string | null>;
+  /** Default: `0.0.0-test`. */
+  readonly sdkVersion?: string;
+  /** Default: false. */
+  readonly isDebugBuild?: boolean;
+  /** The running bundle. Default: `00000000-0000-0000-0000-000000000000`. */
+  readonly bundleId?: TestValue<string>;
+  /** Default: `production`. */
+  readonly channel?: TestValue<string>;
+  /** Default: `1`. */
+  readonly cohort?: TestValue<string>;
+  /** Default: null. */
+  readonly fingerprintHash?: TestValue<string | null>;
+  /** The clock plugins read. Default: `Date.now()`, so fake timers move it. */
+  readonly now?: () => number;
+  /**
+   * The device's plugin storage. Pass an earlier runtime's `storage` to set
+   * the plugins up again on the same device, as a relaunch does.
+   */
+  readonly storage?: ClientPluginTestStorage;
+}
+/** A request a plugin made with `context.fetch`, as the server receives it. */
+interface ClientPluginTestRequest {
+  readonly url: string;
+  /** The URL after `baseURL`, such as `/events`. */
+  readonly path: string;
+  readonly method: string;
+  /** Lowercase header names, `requestHeaders` included. */
+  readonly headers: Readonly<Record<string, string>>;
+  /** The body as text, or null without one. */
+  readonly body: string | null;
+  /** The body parsed as JSON. */
+  json<T = unknown>(): T;
+}
+/** A device's plugin storage, which outlives a runtime as native storage does. */
+interface ClientPluginTestStorage {
+  /** What a plugin stored under `key`, or null. */
+  get(pluginId: string, key: string): string | null;
+  /** Stores a value for a plugin, as an earlier launch would have; `null` removes it. */
+  set(pluginId: string, key: string, value: string | null): void;
+  /** Every key and value a plugin stored. */
+  entries(pluginId: string): Record<string, string>;
+}
+/** The hooks the SDK calls, called the same way. */
+interface ClientPluginTestHooks {
+  onAppReady(result: AppReadyResult): void;
+  onUpdateCheck(result: UpdateCheckResult): void;
+  onBundleDownloaded(info: BundleDownloadedInfo): void;
+  onUpdateError(error: UpdateError): void;
+}
+/** One JavaScript runtime with the plugins set up, as after `HotUpdater.init`. */
+interface ClientPluginTestRuntime {
+  /**
+   * Calls a hook on every plugin that returned it, as the SDK does: without
+   * waiting for it, and with a throw or rejection recorded in `errors`
+   * instead of raised. Await `settled()` for what the hooks started.
+   */
+  readonly hooks: ClientPluginTestHooks;
+  /** Whether any plugin returned this hook from `setup`. */
+  listens(name: keyof ClientPluginTestHooks): boolean;
+  /** The requests plugins made, in order. */
+  readonly requests: readonly ClientPluginTestRequest[];
+  readonly storage: ClientPluginTestStorage;
+  /**
+   * What the SDK reported to `onError`: each `setup` or hook that threw or
+   * rejected, with the plugin's error as `cause`.
+   */
+  readonly errors: readonly Error[];
+  /**
+   * Resolves once the hooks called so far, and the requests they started,
+   * have settled. It does not run timers: with fake timers, advance them to
+   * reach a retry or a delay.
+   */
+  settled(): Promise<void>;
+}
+/** A new device's empty plugin storage. */
+declare const createTestStorage: () => ClientPluginTestStorage;
+/** Sets plugins up as `HotUpdater.init({ plugins })` does, in a new runtime. */
+declare const setupClientPlugins: (plugins: readonly HotUpdaterClientPlugin[], options?: ClientPluginTestOptions) => ClientPluginTestRuntime;
+/** Sets one plugin up; see `setupClientPlugins`. */
+declare const setupClientPlugin: (plugin: HotUpdaterClientPlugin, options?: ClientPluginTestOptions) => ClientPluginTestRuntime;
+//#endregion
+export { ClientPluginTestHooks, ClientPluginTestOptions, ClientPluginTestRequest, ClientPluginTestRuntime, ClientPluginTestStorage, createTestStorage, setupClientPlugin, setupClientPlugins };

package/dist/react-native.d.mts

@@ -0,0 +1,104 @@
+import { AppReadyResult, BundleDownloadedInfo, HotUpdaterBaseURL, HotUpdaterClientPlugin, UpdateCheckResult, UpdateError } from "@hot-updater/protocol";
+//#region src/setupClientPlugins.d.ts
+/** A value the test fixes, or reads each time a plugin asks for it. */
+type TestValue<T> = T | (() => T);
+interface ClientPluginTestOptions {
+  /** The server plugins fetch from. Default: `https://hot-updater.example.com`. */
+  readonly baseURL?: HotUpdaterBaseURL;
+  /** Headers the SDK adds to every plugin request, as `init` and `wrap` take them. */
+  readonly requestHeaders?: Record<string, string>;
+  /** Milliseconds before a plugin request fails with `Request timed out`. Default: 5000. */
+  readonly requestTimeout?: number;
+  /**
+   * Answers each plugin request. Default: `204 No Content`. Throw or reject
+   * to fail the request the way a network error does.
+   */
+  readonly respond?: (request: ClientPluginTestRequest) => Response | Promise<Response>;
+  /** Default: `00000000-0000-4000-8000-000000000000`. */
+  readonly installId?: TestValue<string>;
+  /** Default: `ios`. */
+  readonly platform?: "ios" | "android";
+  /** The native app version. Default: `1.0.0`. */
+  readonly appVersion?: TestValue<string | null>;
+  /** Default: `0.0.0-test`. */
+  readonly sdkVersion?: string;
+  /** Default: false. */
+  readonly isDebugBuild?: boolean;
+  /** The running bundle. Default: `00000000-0000-0000-0000-000000000000`. */
+  readonly bundleId?: TestValue<string>;
+  /** Default: `production`. */
+  readonly channel?: TestValue<string>;
+  /** Default: `1`. */
+  readonly cohort?: TestValue<string>;
+  /** Default: null. */
+  readonly fingerprintHash?: TestValue<string | null>;
+  /** The clock plugins read. Default: `Date.now()`, so fake timers move it. */
+  readonly now?: () => number;
+  /**
+   * The device's plugin storage. Pass an earlier runtime's `storage` to set
+   * the plugins up again on the same device, as a relaunch does.
+   */
+  readonly storage?: ClientPluginTestStorage;
+}
+/** A request a plugin made with `context.fetch`, as the server receives it. */
+interface ClientPluginTestRequest {
+  readonly url: string;
+  /** The URL after `baseURL`, such as `/events`. */
+  readonly path: string;
+  readonly method: string;
+  /** Lowercase header names, `requestHeaders` included. */
+  readonly headers: Readonly<Record<string, string>>;
+  /** The body as text, or null without one. */
+  readonly body: string | null;
+  /** The body parsed as JSON. */
+  json<T = unknown>(): T;
+}
+/** A device's plugin storage, which outlives a runtime as native storage does. */
+interface ClientPluginTestStorage {
+  /** What a plugin stored under `key`, or null. */
+  get(pluginId: string, key: string): string | null;
+  /** Stores a value for a plugin, as an earlier launch would have; `null` removes it. */
+  set(pluginId: string, key: string, value: string | null): void;
+  /** Every key and value a plugin stored. */
+  entries(pluginId: string): Record<string, string>;
+}
+/** The hooks the SDK calls, called the same way. */
+interface ClientPluginTestHooks {
+  onAppReady(result: AppReadyResult): void;
+  onUpdateCheck(result: UpdateCheckResult): void;
+  onBundleDownloaded(info: BundleDownloadedInfo): void;
+  onUpdateError(error: UpdateError): void;
+}
+/** One JavaScript runtime with the plugins set up, as after `HotUpdater.init`. */
+interface ClientPluginTestRuntime {
+  /**
+   * Calls a hook on every plugin that returned it, as the SDK does: without
+   * waiting for it, and with a throw or rejection recorded in `errors`
+   * instead of raised. Await `settled()` for what the hooks started.
+   */
+  readonly hooks: ClientPluginTestHooks;
+  /** Whether any plugin returned this hook from `setup`. */
+  listens(name: keyof ClientPluginTestHooks): boolean;
+  /** The requests plugins made, in order. */
+  readonly requests: readonly ClientPluginTestRequest[];
+  readonly storage: ClientPluginTestStorage;
+  /**
+   * What the SDK reported to `onError`: each `setup` or hook that threw or
+   * rejected, with the plugin's error as `cause`.
+   */
+  readonly errors: readonly Error[];
+  /**
+   * Resolves once the hooks called so far, and the requests they started,
+   * have settled. It does not run timers: with fake timers, advance them to
+   * reach a retry or a delay.
+   */
+  settled(): Promise<void>;
+}
+/** A new device's empty plugin storage. */
+declare const createTestStorage: () => ClientPluginTestStorage;
+/** Sets plugins up as `HotUpdater.init({ plugins })` does, in a new runtime. */
+declare const setupClientPlugins: (plugins: readonly HotUpdaterClientPlugin[], options?: ClientPluginTestOptions) => ClientPluginTestRuntime;
+/** Sets one plugin up; see `setupClientPlugins`. */
+declare const setupClientPlugin: (plugin: HotUpdaterClientPlugin, options?: ClientPluginTestOptions) => ClientPluginTestRuntime;
+//#endregion
+export { ClientPluginTestHooks, ClientPluginTestOptions, ClientPluginTestRequest, ClientPluginTestRuntime, ClientPluginTestStorage, createTestStorage, setupClientPlugin, setupClientPlugins };

package/dist/react-native.mjs

@@ -0,0 +1,174 @@
+import { createPluginHost, pluginStorageKey, resolveBaseURL } from "@hot-updater/protocol";
+//#region src/setupClientPlugins.ts
+/**
+* Runs client plugins in tests the way the SDK runs them in an app, against
+* an in-memory device and a server the test answers.
+*
+* ```ts
+* import { setupClientPlugin } from "@hot-updater/test-utils/react-native";
+*
+* const runtime = setupClientPlugin(myPlugin());
+* runtime.hooks.onAppReady(launch);
+* await runtime.settled();
+* expect(runtime.requests[0]?.json()).toEqual(expectedEvent);
+* ```
+*
+* It sets plugins up with the plugin host from `@hot-updater/protocol`,
+* the same code the app runs, so they get the same context and rules:
+* unique ids, `setup` once per runtime, storage scoped to the plugin's id
+* with values up to 64 KB, `fetch` relative to `baseURL` with
+* `requestHeaders` and `requestTimeout`, and hooks the SDK never waits for,
+* whose throws and rejections are reported, not raised. It imports neither
+* React Native nor a test runner, so it works under Vitest and Jest.
+*/
+const storageItems = /* @__PURE__ */ new WeakMap();
+/** A new device's empty plugin storage. */
+const createTestStorage = () => {
+	const items = /* @__PURE__ */ new Map();
+	const storage = {
+		get: (pluginId, key) => items.get(pluginStorageKey(pluginId, key)) ?? null,
+		set: (pluginId, key, value) => {
+			if (value !== null && typeof value !== "string") throw new TypeError("[HotUpdater] Plugin storage values are strings or null.");
+			const storageKey = pluginStorageKey(pluginId, key);
+			if (value === null) items.delete(storageKey);
+			else items.set(storageKey, value);
+		},
+		entries: (pluginId) => {
+			const prefix = pluginStorageKey(pluginId, "");
+			return Object.fromEntries([...items].filter(([storageKey]) => storageKey.startsWith(prefix)).map(([storageKey, value]) => [storageKey.slice(prefix.length), value]));
+		}
+	};
+	storageItems.set(storage, items);
+	return storage;
+};
+const read = (value) => typeof value === "function" ? value() : value;
+const abortError = (signal) => {
+	const reason = signal?.reason;
+	if (reason instanceof Error && reason.name === "AbortError") return reason;
+	const error = /* @__PURE__ */ new Error("The operation was aborted.");
+	error.name = "AbortError";
+	return error;
+};
+/**
+* Resolves after every pending microtask, on a macrotask that fake timers
+* leave alone.
+*/
+const nextMacrotask = () => new Promise((resolve) => {
+	const Channel = globalThis.MessageChannel;
+	if (Channel === void 0) {
+		setTimeout(resolve, 0);
+		return;
+	}
+	const { port1, port2 } = new Channel();
+	port1.addEventListener("message", () => {
+		port1.close();
+		resolve();
+	}, { once: true });
+	port1.start();
+	port2.postMessage(null);
+});
+/** Sets plugins up as `HotUpdater.init({ plugins })` does, in a new runtime. */
+const setupClientPlugins = (plugins, options = {}) => {
+	const storage = options.storage ?? createTestStorage();
+	const items = storageItems.get(storage);
+	if (items === void 0) throw new TypeError("[HotUpdater] Pass a storage from createTestStorage() or an earlier runtime.");
+	const baseURL = options.baseURL ?? "https://hot-updater.example.com";
+	const respond = options.respond ?? (() => new Response(null, { status: 204 }));
+	const requests = [];
+	const errors = [];
+	const pending = /* @__PURE__ */ new Set();
+	const track = (work) => {
+		const settledWork = work.then(() => void 0, () => void 0).finally(() => {
+			pending.delete(settledWork);
+		});
+		pending.add(settledWork);
+	};
+	const recordRequest = async (url, init) => {
+		const request = new Request(url, init);
+		const body = typeof init.body === "string" ? init.body : init.body === void 0 || init.body === null ? null : await request.text();
+		const base = await resolveBaseURL(baseURL);
+		const headers = {};
+		request.headers.forEach((value, name) => {
+			headers[name] = value;
+		});
+		return {
+			url,
+			path: url.startsWith(`${base}/`) ? url.slice(base.length) : url,
+			method: request.method,
+			headers,
+			body,
+			json: () => {
+				if (body === null) throw new SyntaxError("The request has no body to parse as JSON.");
+				return JSON.parse(body);
+			}
+		};
+	};
+	const answer = (request, signal) => new Promise((resolve, reject) => {
+		const abort = () => reject(abortError(signal));
+		if (signal?.aborted) {
+			abort();
+			return;
+		}
+		signal?.addEventListener("abort", abort, { once: true });
+		Promise.resolve().then(() => respond(request)).then(resolve, reject).finally(() => signal?.removeEventListener("abort", abort));
+	});
+	const host = createPluginHost({
+		fetch: (url, init) => {
+			const response = recordRequest(url, init).then((request) => {
+				requests.push(request);
+				return answer(request, init.signal);
+			});
+			track(response);
+			return response;
+		},
+		platform: options.platform ?? "ios",
+		isDebugBuild: options.isDebugBuild ?? false,
+		sdkVersion: options.sdkVersion ?? "0.0.0-test",
+		getInstallId: () => read(options.installId ?? "00000000-0000-4000-8000-000000000000"),
+		getAppVersion: () => read(options.appVersion === void 0 ? "1.0.0" : options.appVersion),
+		getBundleId: () => read(options.bundleId ?? "00000000-0000-0000-0000-000000000000"),
+		getChannel: () => read(options.channel ?? "production"),
+		getCohort: () => read(options.cohort ?? "1"),
+		getFingerprintHash: () => read(options.fingerprintHash === void 0 ? null : options.fingerprintHash),
+		getStorageItem: (key) => items.get(key) ?? null,
+		setStorageItem: (key, value) => {
+			if (value === null) items.delete(key);
+			else items.set(key, value);
+		},
+		now: () => options.now ? options.now() : Date.now()
+	});
+	host.configurePlugins(plugins, {
+		baseURL,
+		requestHeaders: options.requestHeaders,
+		requestTimeout: options.requestTimeout,
+		onError: (error) => {
+			errors.push(error);
+		}
+	});
+	const call = (name) => (payload) => {
+		for (const settlement of host.dispatchPluginHook(name, payload)) track(settlement);
+	};
+	return {
+		hooks: {
+			onAppReady: call("onAppReady"),
+			onUpdateCheck: call("onUpdateCheck"),
+			onBundleDownloaded: call("onBundleDownloaded"),
+			onUpdateError: call("onUpdateError")
+		},
+		listens: (name) => host.hasPluginHook(name),
+		requests,
+		storage,
+		errors,
+		settled: async () => {
+			for (;;) {
+				await nextMacrotask();
+				if (pending.size === 0) return;
+				await Promise.all(pending);
+			}
+		}
+	};
+};
+/** Sets one plugin up; see `setupClientPlugins`. */
+const setupClientPlugin = (plugin, options) => setupClientPlugins([plugin], options);
+//#endregion
+export { createTestStorage, setupClientPlugin, setupClientPlugins };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hot-updater/test-utils",
-  "version": "1.0.0-rc.16",
+  "version": "1.0.0-rc.21",
   "type": "module",
   "description": "Test utilities for Hot Updater packages",
   "sideEffects": false,
@@ -22,6 +22,16 @@
         "default": "./dist/node.cjs"
       }
     },
+    "./react-native": {
+      "import": {
+        "types": "./dist/react-native.d.mts",
+        "default": "./dist/react-native.mjs"
+      },
+      "require": {
+        "types": "./dist/react-native.d.cts",
+        "default": "./dist/react-native.cjs"
+      }
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -35,21 +45,49 @@
   },
   "author": "gronxb <gron1gh1@gmail.com> (https://github.com/gronxb)",
   "peerDependencies": {
+    "@electric-sql/pglite": "*",
     "execa": "*",
+    "mysql2": "*",
+    "pg": "*",
     "vitest": "^4.0.0",
-    "@hot-updater/core": "^1.0.0-rc.15",
-    "@hot-updater/plugin-core": "^1.0.0-rc.16"
+    "@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"
+  },
+  "peerDependenciesMeta": {
+    "@electric-sql/pglite": {
+      "optional": true
+    },
+    "@hot-updater/plugin-insights": {
+      "optional": true
+    },
+    "@hot-updater/server": {
+      "optional": true
+    },
+    "mysql2": {
+      "optional": true
+    },
+    "pg": {
+      "optional": true
+    }
   },
   "devDependencies": {
+    "@electric-sql/pglite": "0.4.1",
     "@types/node": "^20",
+    "@types/pg": "^8.11.10",
     "execa": "9.5.2",
     "@typescript/native": "npm:typescript@7.0.2",
+    "mysql2": "3.19.1",
+    "pg": "8.13.1",
     "typescript": "npm:@typescript/typescript6@6.0.2",
     "vitest": "4.1.4",
     "workspace-tools": "^0.41.7",
-    "@hot-updater/core": "1.0.0-rc.15",
-    "@hot-updater/plugin-core": "1.0.0-rc.16",
-    "@hot-updater/js": "1.0.0-rc.14"
+    "@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"
   },
   "inlinedDependencies": {
     "@nodelib/fs.scandir": "2.1.5",