@hot-updater/react-native 1.0.0-rc.15 → 1.0.0-rc.17

package/lib/module/plugins/insights/sender.js

@@ -0,0 +1,123 @@
+"use strict";
+
+/** A `POST /events` body. */
+
+/** Details beside an event's fields, by event type. */
+
+/** How the server answered one event. */
+
+/** Attempts per Insights event, the first one included. */
+const INSIGHTS_MAX_ATTEMPTS = 3;
+/** Wait before the second attempt; it doubles for each later attempt. */
+const INSIGHTS_RETRY_BASE_DELAY_MS = 1000;
+/** Longest wait between attempts, a server's `Retry-After` included. */
+const INSIGHTS_RETRY_MAX_DELAY_MS = 30000;
+/**
+ * Reads `Retry-After` as delay-seconds, the form a server under load sends;
+ * an HTTP-date falls back to the backoff.
+ */
+const parseRetryAfterMs = value => {
+  const seconds = value?.trim();
+  return seconds && /^\d+$/.test(seconds) ? Number(seconds) * 1000 : null;
+};
+const getRetryDelayMs = (failedAttempt, retryAfterMs) => Math.min(retryAfterMs ??
+// Jitter spreads the retries of installations that failed together.
+INSIGHTS_RETRY_BASE_DELAY_MS * 2 ** (failedAttempt - 1) * (0.5 + Math.random()), INSIGHTS_RETRY_MAX_DELAY_MS);
+const wait = ms => new Promise(resolve => {
+  setTimeout(resolve, ms);
+});
+
+/** Makes one POST, with the context's timeout, and settles with its outcome. */
+const postInsightsEvent = async (fetch, event) => {
+  try {
+    const response = await fetch("events", {
+      body: JSON.stringify(event),
+      headers: {
+        "Content-Type": "application/json"
+      },
+      method: "POST"
+    });
+    if (response.status === 204) return "delivered";
+    if (response.status === 404) return "disabled";
+    if (response.status === 400 && event.type === "UPDATE_FAILED") {
+      return "refused";
+    }
+    return {
+      error: new Error(`Expected HTTP 204 from /events, received ${response.status}`),
+      retryable: response.status === 429 || response.status >= 500,
+      retryAfterMs: parseRetryAfterMs(response.headers.get("Retry-After"))
+    };
+  } catch (error) {
+    // fetch rejects only when no response arrived (a timeout or a network
+    // error), so a later attempt may still get through.
+    return {
+      error: error instanceof Error ? error : new Error(String(error)),
+      retryable: true,
+      retryAfterMs: null
+    };
+  }
+};
+/**
+ * Sends Insights events one at a time and retries each in the background.
+ *
+ * The server keeps an installation's latest report by arrival, so a later
+ * event waits behind an earlier one's retries; otherwise a retried
+ * UPDATE_APPLIED could land after the UPDATE_DOWNLOADED that followed it.
+ * Callers wait only for first attempts, so a report never waits out a
+ * backoff: once an event backs off, every waiting caller is released, and a
+ * failure after that only warns. The gate sees each event before each
+ * attempt, after every earlier event settled, so it decides with what the
+ * server already answered.
+ */
+export const createInsightsEventSender = (fetch, gate) => {
+  let queue = Promise.resolve();
+  let retrying = false;
+  const waiting = new Set();
+  return event => new Promise((resolve, reject) => {
+    let released = false;
+    const release = () => {
+      released = true;
+      waiting.delete(release);
+      resolve();
+    };
+    if (retrying) release();else waiting.add(release);
+    queue = queue.then(async () => {
+      try {
+        for (let attempt = 1;; attempt += 1) {
+          if (!gate.admit(event)) {
+            release();
+            break;
+          }
+          const outcome = await postInsightsEvent(fetch, event);
+          if (typeof outcome === "string") {
+            gate.settle(event, outcome);
+            release();
+            break;
+          }
+          if (!outcome.retryable || attempt === INSIGHTS_MAX_ATTEMPTS) {
+            gate.settle(event, "failed");
+            waiting.delete(release);
+            if (released) {
+              console.warn(`[HotUpdater] Insights ${event.type} event was not delivered:`, outcome.error);
+            } else {
+              reject(outcome.error);
+            }
+            break;
+          }
+          retrying = true;
+          for (const releaseWaiting of waiting) releaseWaiting();
+          await wait(getRetryDelayMs(attempt, outcome.retryAfterMs));
+        }
+      } catch (error) {
+        // A failed request settles in postInsightsEvent, so only a bug gets
+        // here. A rejected queue would leave every later event, and a
+        // caller waiting on one, pending forever.
+        waiting.delete(release);
+        if (!released) reject(error);
+      } finally {
+        retrying = false;
+      }
+    });
+  });
+};
+//# sourceMappingURL=sender.js.map

package/lib/module/plugins/insights/sender.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["INSIGHTS_MAX_ATTEMPTS","INSIGHTS_RETRY_BASE_DELAY_MS","INSIGHTS_RETRY_MAX_DELAY_MS","parseRetryAfterMs","value","seconds","trim","test","Number","getRetryDelayMs","failedAttempt","retryAfterMs","Math","min","random","wait","ms","Promise","resolve","setTimeout","postInsightsEvent","fetch","event","response","body","JSON","stringify","headers","method","status","type","error","Error","retryable","get","String","createInsightsEventSender","gate","queue","retrying","waiting","Set","reject","released","release","delete","add","then","attempt","admit","outcome","settle","console","warn","releaseWaiting"],"sourceRoot":"../../../../src","sources":["plugins/insights/sender.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/plugins/insights/sender.spec.js

@@ -0,0 +1,265 @@
+"use strict";
+
+import { isUUIDv7 } from "@hot-updater/core";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { createUUIDv7 } from "./eventId.js";
+import { createInsightsEventSender } from "./sender.js";
+const unchangedEvent = () => ({
+  appVersion: "1.0.0",
+  channel: "production",
+  cohort: "123",
+  eventId: createUUIDv7(),
+  fingerprintHash: null,
+  fromBundleId: null,
+  fromReleaseId: null,
+  installId: "install-id",
+  platform: "ios",
+  sdkVersion: "test-sdk-version",
+  toBundleId: "bundle-id",
+  toReleaseId: null,
+  type: "UNCHANGED",
+  updateStrategy: null
+});
+const downloadedEvent = () => ({
+  ...unchangedEvent(),
+  fromBundleId: "bundle-id",
+  toBundleId: "next-bundle-id",
+  type: "UPDATE_DOWNLOADED",
+  updateStrategy: "appVersion"
+});
+
+/** Answers each POST /events with the next response, then 204. */
+const stubEventsEndpoint = (...responses) => {
+  const fetchMock = vi.fn(async (_path, _init) => {
+    const next = responses.shift() ?? 204;
+    if (next instanceof Error) throw next;
+    return typeof next === "number" ? new Response(null, {
+      status: next
+    }) : next;
+  });
+  const sentEvents = () => fetchMock.mock.calls.map(([, init]) => JSON.parse(String(init?.body)));
+  return {
+    fetchMock,
+    sentEvents
+  };
+};
+const openGate = () => ({
+  admit: () => true,
+  settle: vi.fn()
+});
+describe("Insights event delivery", () => {
+  beforeEach(() => {
+    vi.useFakeTimers();
+    // No jitter: the first retry waits exactly 1 s and the second 2 s.
+    vi.spyOn(Math, "random").mockReturnValue(0.5);
+  });
+  afterEach(() => {
+    vi.useRealTimers();
+    vi.restoreAllMocks();
+  });
+  it("posts to events and retries a 503 in the background under the same UUIDv7 eventId", async () => {
+    const {
+      fetchMock,
+      sentEvents
+    } = stubEventsEndpoint(503, 204);
+    const gate = openGate();
+    const send = createInsightsEventSender(fetchMock, gate);
+
+    // Settles after the failed first attempt, without waiting for the retry.
+    await send(unchangedEvent());
+    expect(fetchMock).toHaveBeenCalledOnce();
+    expect(fetchMock.mock.calls[0]?.[0]).toBe("events");
+    expect(fetchMock.mock.calls[0]?.[1]?.method).toBe("POST");
+    await vi.advanceTimersByTimeAsync(1_000);
+    expect(fetchMock).toHaveBeenCalledTimes(2);
+    const [first, second] = sentEvents();
+    expect(isUUIDv7(first?.eventId)).toBe(true);
+    expect(second?.eventId).toBe(first?.eventId);
+    expect(gate.settle).toHaveBeenCalledExactlyOnceWith(expect.objectContaining({
+      type: "UNCHANGED"
+    }), "delivered");
+  });
+  it("waits for a 429's Retry-After before the next attempt", async () => {
+    const {
+      fetchMock
+    } = stubEventsEndpoint(new Response(null, {
+      headers: {
+        "Retry-After": "7"
+      },
+      status: 429
+    }));
+    const send = createInsightsEventSender(fetchMock, openGate());
+    await send(unchangedEvent());
+    await vi.advanceTimersByTimeAsync(6_999);
+    expect(fetchMock).toHaveBeenCalledOnce();
+    await vi.advanceTimersByTimeAsync(1);
+    expect(fetchMock).toHaveBeenCalledTimes(2);
+  });
+  it("caps a server's Retry-After at 30 seconds", async () => {
+    const {
+      fetchMock
+    } = stubEventsEndpoint(new Response(null, {
+      headers: {
+        "Retry-After": "3600"
+      },
+      status: 503
+    }));
+    const send = createInsightsEventSender(fetchMock, openGate());
+    await send(unchangedEvent());
+    await vi.advanceTimersByTimeAsync(29_999);
+    expect(fetchMock).toHaveBeenCalledOnce();
+    await vi.advanceTimersByTimeAsync(1);
+    expect(fetchMock).toHaveBeenCalledTimes(2);
+  });
+  it("does not retry a 400", async () => {
+    const {
+      fetchMock
+    } = stubEventsEndpoint(400);
+    const gate = openGate();
+    const send = createInsightsEventSender(fetchMock, gate);
+    await expect(send(unchangedEvent())).rejects.toThrow("Expected HTTP 204 from /events, received 400");
+    await vi.runAllTimersAsync();
+    expect(fetchMock).toHaveBeenCalledOnce();
+    expect(gate.settle).toHaveBeenCalledWith(expect.objectContaining({
+      type: "UNCHANGED"
+    }), "failed");
+  });
+  it("settles an UPDATE_FAILED event an older server refuses with 400, without retrying", async () => {
+    const {
+      fetchMock
+    } = stubEventsEndpoint(400);
+    const gate = openGate();
+    const send = createInsightsEventSender(fetchMock, gate);
+    await send({
+      ...unchangedEvent(),
+      type: "UPDATE_FAILED"
+    });
+    await vi.runAllTimersAsync();
+    expect(fetchMock).toHaveBeenCalledOnce();
+    expect(gate.settle).toHaveBeenCalledWith(expect.objectContaining({
+      type: "UPDATE_FAILED"
+    }), "refused");
+  });
+  it("settles a 404, from a server without Insights, as Insights off without retrying", async () => {
+    const {
+      fetchMock
+    } = stubEventsEndpoint(404);
+    const gate = openGate();
+    const send = createInsightsEventSender(fetchMock, gate);
+    await send(unchangedEvent());
+    await vi.runAllTimersAsync();
+    expect(fetchMock).toHaveBeenCalledOnce();
+    expect(gate.settle).toHaveBeenCalledWith(expect.objectContaining({
+      type: "UNCHANGED"
+    }), "disabled");
+  });
+  it("skips an event the gate does not admit", async () => {
+    const {
+      fetchMock
+    } = stubEventsEndpoint();
+    const gate = {
+      admit: vi.fn(() => false),
+      settle: vi.fn()
+    };
+    const send = createInsightsEventSender(fetchMock, gate);
+    await send(unchangedEvent());
+    expect(fetchMock).not.toHaveBeenCalled();
+    expect(gate.settle).not.toHaveBeenCalled();
+  });
+  it("asks the gate before every attempt, after earlier events settled", async () => {
+    const {
+      fetchMock
+    } = stubEventsEndpoint(503, 204);
+    const order = [];
+    const gate = {
+      admit: event => {
+        order.push(`admit ${event.type}`);
+        return true;
+      },
+      settle: (event, delivery) => {
+        order.push(`${delivery} ${event.type}`);
+      }
+    };
+    const send = createInsightsEventSender(fetchMock, gate);
+    await send(unchangedEvent());
+    await send(downloadedEvent());
+    await vi.runAllTimersAsync();
+    expect(order).toEqual(["admit UNCHANGED", "admit UNCHANGED", "delivered UNCHANGED", "admit UPDATE_DOWNLOADED", "delivered UPDATE_DOWNLOADED"]);
+  });
+  it("drops an event the gate stops admitting during its backoff", async () => {
+    const warn = vi.spyOn(console, "warn").mockImplementation(() => {});
+    const {
+      fetchMock,
+      sentEvents
+    } = stubEventsEndpoint(503);
+    let wanted = true;
+    const gate = {
+      admit: vi.fn(() => wanted),
+      settle: vi.fn()
+    };
+    const send = createInsightsEventSender(fetchMock, gate);
+    await send({
+      ...unchangedEvent(),
+      type: "UPDATE_FAILED"
+    });
+    wanted = false;
+    await vi.runAllTimersAsync();
+    wanted = true;
+    await send(downloadedEvent());
+    expect(sentEvents().map(({
+      type
+    }) => type)).toEqual(["UPDATE_FAILED", "UPDATE_DOWNLOADED"]);
+    expect(gate.settle).toHaveBeenCalledExactlyOnceWith(expect.objectContaining({
+      type: "UPDATE_DOWNLOADED"
+    }), "delivered");
+    expect(warn).not.toHaveBeenCalled();
+  });
+  it("stops after three attempts and warns once", async () => {
+    const warn = vi.spyOn(console, "warn").mockImplementation(() => {});
+    const {
+      fetchMock
+    } = stubEventsEndpoint(500, new Error("network unavailable"), 503);
+    const send = createInsightsEventSender(fetchMock, openGate());
+    await send(unchangedEvent());
+    await vi.runAllTimersAsync();
+    expect(fetchMock).toHaveBeenCalledTimes(3);
+    expect(warn).toHaveBeenCalledExactlyOnceWith("[HotUpdater] Insights UNCHANGED event was not delivered:", expect.objectContaining({
+      message: "Expected HTTP 204 from /events, received 503"
+    }));
+  });
+  it("sends a later event after an earlier event's retries without holding its caller", async () => {
+    const {
+      fetchMock,
+      sentEvents
+    } = stubEventsEndpoint(503);
+    const send = createInsightsEventSender(fetchMock, openGate());
+    await send(unchangedEvent());
+    await send(downloadedEvent());
+    expect(fetchMock).toHaveBeenCalledOnce();
+    await vi.runAllTimersAsync();
+    const [first, retry, later] = sentEvents();
+    expect([first?.type, retry?.type, later?.type]).toEqual(["UNCHANGED", "UNCHANGED", "UPDATE_DOWNLOADED"]);
+    expect(retry?.eventId).toBe(first?.eventId);
+    expect(later?.eventId).not.toBe(first?.eventId);
+  });
+  it("keeps sending events after one fails outside its requests", async () => {
+    vi.spyOn(console, "warn").mockImplementation(() => {
+      throw new Error("console unavailable");
+    });
+    const {
+      fetchMock,
+      sentEvents
+    } = stubEventsEndpoint(500, 500, 500);
+    const send = createInsightsEventSender(fetchMock, openGate());
+    await send(unchangedEvent());
+    await vi.runAllTimersAsync();
+    expect(fetchMock).toHaveBeenCalledTimes(3);
+
+    // A queue left rejected would never send this event or settle its caller.
+    await send(downloadedEvent());
+    expect(sentEvents().map(({
+      type
+    }) => type)).toEqual(["UNCHANGED", "UNCHANGED", "UNCHANGED", "UPDATE_DOWNLOADED"]);
+  });
+});
+//# sourceMappingURL=sender.spec.js.map

package/lib/module/plugins/insights/sender.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isUUIDv7","afterEach","beforeEach","describe","expect","it","vi","createUUIDv7","createInsightsEventSender","unchangedEvent","appVersion","channel","cohort","eventId","fingerprintHash","fromBundleId","fromReleaseId","installId","platform","sdkVersion","toBundleId","toReleaseId","type","updateStrategy","downloadedEvent","stubEventsEndpoint","responses","fetchMock","fn","_path","_init","next","shift","Error","Response","status","sentEvents","mock","calls","map","init","JSON","parse","String","body","openGate","admit","settle","useFakeTimers","spyOn","Math","mockReturnValue","useRealTimers","restoreAllMocks","gate","send","toHaveBeenCalledOnce","toBe","method","advanceTimersByTimeAsync","toHaveBeenCalledTimes","first","second","toHaveBeenCalledExactlyOnceWith","objectContaining","headers","rejects","toThrow","runAllTimersAsync","toHaveBeenCalledWith","not","toHaveBeenCalled","order","event","push","delivery","toEqual","warn","console","mockImplementation","wanted","message","retry","later"],"sourceRoot":"../../../../src","sources":["plugins/insights/sender.spec.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/plugins/insights/state.js

@@ -0,0 +1,139 @@
+"use strict";
+
+const DAY_MS = 24 * 60 * 60 * 1000;
+/** A day's failure keys kept, so a failing app cannot grow its storage. */
+const MAX_FAILURE_KEYS = 32;
+
+/** The UTC day of a time, as `YYYY-MM-DD`. */
+export const utcDay = time => new Date(time).toISOString().slice(0, 10);
+
+/** The start of a time's UTC day, in milliseconds. */
+export const utcDayStart = time => Math.floor(time / DAY_MS) * DAY_MS;
+
+/** What a report says runs: the fields the server compares to skip a same-day launch. */
+
+const sameReport = (left, right) => left.day === right.day && left.channel === right.channel && left.appVersion === right.appVersion && left.bundleId === right.bundleId && left.releaseId === right.releaseId && left.userId === right.userId;
+const isRecord = value => typeof value === "object" && value !== null && !Array.isArray(value);
+const isNullableString = value => value === null || typeof value === "string";
+const parseReport = value => {
+  if (value === null) return null;
+  try {
+    const report = JSON.parse(value);
+    if (isRecord(report) && typeof report.day === "string" && typeof report.channel === "string" && typeof report.appVersion === "string" && typeof report.bundleId === "string" && isNullableString(report.releaseId) && isNullableString(report.userId)) {
+      return {
+        day: report.day,
+        channel: report.channel,
+        appVersion: report.appVersion,
+        bundleId: report.bundleId,
+        releaseId: report.releaseId,
+        userId: report.userId
+      };
+    }
+  } catch {
+    // An unreadable value counts as none.
+  }
+  return null;
+};
+const parseFailures = value => {
+  if (value === null) return null;
+  try {
+    const failures = JSON.parse(value);
+    if (isRecord(failures) && typeof failures.day === "string" && Array.isArray(failures.keys) && failures.keys.every(key => typeof key === "string")) {
+      return {
+        day: failures.day,
+        keys: failures.keys
+      };
+    }
+  } catch {
+    // An unreadable value counts as none.
+  }
+  return null;
+};
+
+/**
+ * The Insights plugin's memory across launches, in its plugin storage. Every
+ * read tolerates a missing or unreadable value, and a storage failure only
+ * costs a report that would otherwise have been skipped.
+ */
+export const createInsightsState = storage => {
+  /** The server said Insights is off during this runtime. */
+  let pausedThisRuntime = false;
+  const read = key => {
+    try {
+      return storage.get(key);
+    } catch {
+      return null;
+    }
+  };
+  const write = (key, value) => {
+    try {
+      storage.set(key, value);
+    } catch {
+      // Losing the state costs a report, never an update.
+    }
+  };
+  return {
+    /**
+     * Whether reporting pauses: the server answered that Insights is off
+     * during this runtime or in the 24 hours before `now`. A pause that
+     * starts after `now`, from a clock that went back, has ended.
+     */
+    isPaused(now) {
+      if (pausedThisRuntime) return true;
+      const pausedAt = Number(read("pausedAt"));
+      return Number.isFinite(pausedAt) && pausedAt > 0 && pausedAt <= now && now < pausedAt + DAY_MS;
+    },
+    pause(now) {
+      pausedThisRuntime = true;
+      write("pausedAt", String(now));
+    },
+    /** The server stored a report, so Insights is on. */
+    resume() {
+      if (read("pausedAt") !== null) write("pausedAt", null);
+    },
+    /** Whether a launch report repeats what the installation reported that day. */
+    repeatsReport(report) {
+      const last = parseReport(read("report"));
+      return last !== null && sameReport(last, report);
+    },
+    /** Records a delivered report that says what runs. */
+    recordReport(report) {
+      write("report", JSON.stringify(report));
+    },
+    /**
+     * Forgets the last report after a delivered download or failure, so the
+     * next launch reports again, as the server records it after one.
+     */
+    forgetReport() {
+      if (read("report") !== null) write("report", null);
+    },
+    /** Whether a failure was already reported, or refused, that day. */
+    hasFailure(day, key) {
+      const failures = parseFailures(read("failures"));
+      return failures?.day === day && failures.keys.includes(key);
+    },
+    recordFailure(day, key) {
+      const failures = parseFailures(read("failures"));
+      const keys = failures?.day === day ? failures.keys : [];
+      if (keys.includes(key)) return;
+      write("failures", JSON.stringify({
+        day,
+        keys: [...keys, key].slice(-MAX_FAILURE_KEYS)
+      }));
+    },
+    readUserId() {
+      try {
+        const user = JSON.parse(read("user") ?? "null");
+        return isRecord(user) && typeof user.userId === "string" ? user.userId : null;
+      } catch {
+        return null;
+      }
+    },
+    writeUserId(userId) {
+      write("user", userId === null ? null : JSON.stringify({
+        userId
+      }));
+    }
+  };
+};
+//# sourceMappingURL=state.js.map

package/lib/module/plugins/insights/state.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DAY_MS","MAX_FAILURE_KEYS","utcDay","time","Date","toISOString","slice","utcDayStart","Math","floor","sameReport","left","right","day","channel","appVersion","bundleId","releaseId","userId","isRecord","value","Array","isArray","isNullableString","parseReport","report","JSON","parse","parseFailures","failures","keys","every","key","createInsightsState","storage","pausedThisRuntime","read","get","write","set","isPaused","now","pausedAt","Number","isFinite","pause","String","resume","repeatsReport","last","recordReport","stringify","forgetReport","hasFailure","includes","recordFailure","readUserId","user","writeUserId"],"sourceRoot":"../../../../src","sources":["plugins/insights/state.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/releaseCatalogCache.js

@@ -1,6 +1,7 @@
 "use strict";
 
 import { MAX_TARGET_COHORTS_PER_RELEASE, MAX_COMPILED_CATALOG_BYTES, MAX_DISTINCT_TARGET_COHORTS_PER_SCOPE, NUMERIC_COHORT_SIZE, isUUIDv7, parseReleaseCatalogScopeKey } from "@hot-updater/core";
+import { InvalidUpdateResponseError, UpdateHttpError } from "./updateError.js";
 const CACHE_FORMAT_VERSION = "1";
 const MAX_ETAG_BYTES = 1024;
 export const MAX_RELEASE_CATALOG_WIRE_BYTES = MAX_COMPILED_CATALOG_BYTES * 2 + 4 * 1024;
@@ -128,14 +129,19 @@ const readValidatedCache = async (partition, expectedScope) => {
   return cached;
 };
 const consumeSuccessfulResponse = async (response, input, partition) => {
+  // The server marks the 404 of a scope that has no catalog yet: no update,
+  // not a failure. Any other 404 is a wrong baseURL or route.
+  if (response.status === 404 && response.headers.get("x-hot-updater-catalog")?.trim().toLowerCase() === "none") {
+    return null;
+  }
   if (response.status !== 200) {
-    throw new Error(response.statusText);
+    throw new UpdateHttpError(response.status, response.statusText);
   }
   const body = await response.text();
   const catalog = parseValidatedCatalog(body, input.expectedScope);
   if (catalog === null) {
     await removeNativeReleaseCatalogCache(partition);
-    throw new Error("Received an invalid Release catalog");
+    throw new InvalidUpdateResponseError("Received an invalid Release catalog");
   }
   const etag = response.headers.get("etag");
   if (isValidETag(etag)) {
@@ -157,6 +163,11 @@ const consumeSuccessfulResponse = async (response, input, partition) => {
   }
   return catalog;
 };
+
+/**
+ * Fetches a scope's catalog, or null when the server answers that the scope
+ * has none (a 404 with `x-hot-updater-catalog: none`).
+ */
 export const fetchReleaseCatalogWithCache = async input => {
   const partition = createReleaseCatalogCachePartition(input);
   const cached = await readValidatedCache(partition, input.expectedScope);