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

package/src/notifyAppReadyInsights.ts

@@ -1,293 +0,0 @@
-import { Platform } from "react-native";
-
-import type { HotUpdaterError } from "./error";
-import type { InsightsEventParams, HotUpdaterHttpClient } from "./httpClient";
-import {
-  getActiveUpdateState,
-  getAppVersion,
-  getBundleId,
-  getChannel,
-  getCohort,
-  getFingerprintHash,
-  getInstallId,
-  getPersistedUserIdentity,
-  type NotifyAppReadyInsightsEvent,
-  type NotifyAppReadyResult,
-  readNotifyAppReady,
-} from "./native";
-
-export type NotifyAppReadyOptions = {
-  insights?: boolean;
-  client: HotUpdaterHttpClient;
-  requestHeaders?: Record<string, string>;
-  requestTimeout?: number;
-  reportUnchanged?: boolean;
-  onNotifyAppReady?: (result: NotifyAppReadyResult) => void;
-  onError?: (error: HotUpdaterError | Error | unknown) => void;
-};
-
-type RequestAnimationFrame = (callback: (timestamp: number) => void) => number;
-
-let didAttemptAutomaticInsights = false;
-let didDownload = false;
-let readinessPromise: Promise<NotifyAppReadyResult | undefined> | undefined;
-
-const waitForNextFrame = () =>
-  new Promise<void>((resolve) => {
-    const requestAnimationFrame = (
-      globalThis as typeof globalThis & {
-        requestAnimationFrame?: RequestAnimationFrame;
-      }
-    )?.requestAnimationFrame;
-
-    if (requestAnimationFrame) {
-      requestAnimationFrame(() => resolve());
-      return;
-    }
-
-    void Promise.resolve().then(resolve);
-  });
-
-const assertNever = (value: never): never => {
-  throw new Error(`[HotUpdater] Unexpected notifyAppReady status: ${value}`);
-};
-
-const buildNotifyAppReadyInsightsParams = (
-  nativeResult: NotifyAppReadyResult,
-  insightsEvent: NotifyAppReadyInsightsEvent | null,
-  options: Pick<NotifyAppReadyOptions, "requestHeaders" | "requestTimeout">,
-): InsightsEventParams => {
-  const appVersion = getAppVersion();
-
-  if (!appVersion) {
-    throw new Error(
-      "[HotUpdater] Automatic insights requires a non-null native app version.",
-    );
-  }
-
-  const { userId, username } = getPersistedUserIdentity();
-  const installId = getInstallId();
-
-  if (!installId) {
-    throw new Error(
-      "[HotUpdater] Automatic insights requires a non-null native install id.",
-    );
-  }
-
-  const platform: "ios" | "android" =
-    Platform.OS === "android" ? "android" : "ios";
-
-  const commonParams = {
-    appVersion,
-    channel: getChannel(),
-    cohort: getCohort(),
-    fingerprintHash: getFingerprintHash(),
-    fromReleaseId: insightsEvent?.fromReleaseId ?? null,
-    installId,
-    platform,
-    requestHeaders: options.requestHeaders,
-    requestTimeout: options.requestTimeout,
-    toReleaseId: insightsEvent?.toReleaseId ?? null,
-    ...(userId != null ? { userId } : {}),
-    ...(username != null ? { username } : {}),
-  };
-
-  switch (nativeResult.status) {
-    case "UNCHANGED": {
-      const bundleId = getBundleId();
-
-      if (!bundleId) {
-        throw new Error(
-          "[HotUpdater] Automatic insights requires a non-null current bundle id.",
-        );
-      }
-
-      const state = getActiveUpdateState();
-      const runningSelection = [
-        state.activeSelection,
-        state.stableSelection,
-      ].find(
-        (selection) =>
-          selection?.bundleId === bundleId &&
-          selection.channel === commonParams.channel,
-      );
-
-      return {
-        ...commonParams,
-        fromBundleId: null,
-        toBundleId: bundleId,
-        toReleaseId: runningSelection?.releaseId ?? null,
-        type: "UNCHANGED",
-        updateStrategy: null,
-      };
-    }
-    case "UPDATE_APPLIED":
-    case "RECOVERED":
-      if (!insightsEvent) {
-        throw new Error(
-          "[HotUpdater] Native launch report is missing persisted metadata required for automatic insights.",
-        );
-      }
-
-      switch (insightsEvent.type) {
-        case "UPDATE_APPLIED":
-          return {
-            ...commonParams,
-            fromBundleId: insightsEvent.fromBundleId,
-            toBundleId: insightsEvent.toBundleId,
-            type: "UPDATE_APPLIED",
-            updateStrategy: insightsEvent.updateStrategy,
-          };
-        case "RECOVERED":
-          return {
-            ...commonParams,
-            fromBundleId: insightsEvent.fromBundleId,
-            toBundleId: insightsEvent.toBundleId,
-            type: "RECOVERED",
-            updateStrategy: insightsEvent.updateStrategy,
-          };
-        default:
-          return assertNever(insightsEvent.type);
-      }
-    default:
-      return assertNever(nativeResult);
-  }
-};
-
-let lastInsightsReport = Promise.resolve();
-const sendInsights = (
-  options: Pick<NotifyAppReadyOptions, "client">,
-  params: InsightsEventParams,
-): Promise<void> => {
-  lastInsightsReport = lastInsightsReport
-    .catch(() => {})
-    .then(async () => {
-      const session = await options.client.createSession();
-      await session.sendInsightsEvent(params);
-    });
-  return lastInsightsReport;
-};
-
-const maybeSendAutomaticInsights = async (
-  options: NotifyAppReadyOptions,
-  nativeResult: NotifyAppReadyResult,
-  insightsEvent: NotifyAppReadyInsightsEvent | null,
-): Promise<void> => {
-  if (
-    !options.insights ||
-    didAttemptAutomaticInsights ||
-    (nativeResult.status === "UNCHANGED" &&
-      (options.reportUnchanged === false || didDownload))
-  ) {
-    return;
-  }
-
-  didAttemptAutomaticInsights = true;
-
-  if (nativeResult.status !== "UNCHANGED" && !insightsEvent) {
-    throw new Error(
-      "[HotUpdater] Native launch report is missing persisted metadata required for automatic insights.",
-    );
-  }
-
-  await sendInsights(
-    options,
-    buildNotifyAppReadyInsightsParams(nativeResult, insightsEvent, options),
-  );
-};
-
-const notifyAppReady = async (
-  options: NotifyAppReadyOptions,
-): Promise<NotifyAppReadyResult | undefined> => {
-  try {
-    let nativeReadResult: ReturnType<typeof readNotifyAppReady>;
-    do {
-      await waitForNextFrame();
-      nativeReadResult = readNotifyAppReady();
-    } while (nativeReadResult.pending);
-
-    const { insightsEvent, result: nativeResult } = nativeReadResult;
-
-    try {
-      await maybeSendAutomaticInsights(options, nativeResult, insightsEvent);
-    } catch (error) {
-      const warning = error instanceof Error ? error : new Error(String(error));
-      console.warn(
-        "[HotUpdater] Automatic notifyAppReady insights failed:",
-        warning,
-      );
-    }
-
-    options.onNotifyAppReady?.(nativeResult);
-    return nativeResult;
-  } catch (error) {
-    const normalizedError =
-      error instanceof Error ? error : new Error(String(error));
-    options.onError?.(error);
-    console.warn("[HotUpdater] Failed to notify app ready:", normalizedError);
-    return undefined;
-  }
-};
-
-export const handleNotifyAppReady = (
-  options: NotifyAppReadyOptions,
-): Promise<NotifyAppReadyResult | undefined> => {
-  readinessPromise = notifyAppReady(options);
-  return readinessPromise;
-};
-
-/** Called after an automatic update check finds no download or transition. */
-export const reportNoChange = async (
-  options: NotifyAppReadyOptions,
-): Promise<void> => {
-  try {
-    await maybeSendAutomaticInsights(options, { status: "UNCHANGED" }, null);
-  } catch (error) {
-    console.warn("[HotUpdater] Automatic no-change insights failed:", error);
-  }
-};
-
-let lastDownloadedSelection: string | undefined;
-
-/** Report only after the manifest update has been verified and staged successfully. */
-export const reportBundleDownloaded = async (
-  options: Pick<
-    NotifyAppReadyOptions,
-    "insights" | "client" | "requestHeaders" | "requestTimeout"
-  >,
-  transition: {
-    readonly fromBundleId: string;
-    readonly fromReleaseId: string | null;
-    readonly toBundleId: string;
-    readonly toReleaseId: string | null;
-    readonly channel: string;
-    readonly updateStrategy: "fingerprint" | "appVersion";
-  },
-): Promise<void> => {
-  if (!options.insights || transition.fromBundleId === transition.toBundleId)
-    return;
-  const key = JSON.stringify([
-    transition.channel,
-    transition.toReleaseId,
-    transition.toBundleId,
-  ]);
-  if (lastDownloadedSelection === key) return;
-  lastDownloadedSelection = key;
-  // A later init/mount in this JS runtime must not overwrite pending apply with UNCHANGED.
-  didDownload = true;
-  try {
-    await readinessPromise;
-    const common = buildNotifyAppReadyInsightsParams(
-      { status: "UNCHANGED" },
-      null,
-      options,
-    );
-    await sendInsights(options, {
-      ...common,
-      ...transition,
-      type: "UPDATE_DOWNLOADED",
-    });
-  } catch (error) {
-    console.warn("[HotUpdater] Download insights failed:", error);
-  }
-};

package/src/uuidv7.spec.ts

@@ -1,25 +0,0 @@
-import { isUUIDv7 } from "@hot-updater/core";
-import { afterEach, describe, expect, it, vi } from "vitest";
-
-import { createUUIDv7 } from "./uuidv7";
-
-describe("createUUIDv7", () => {
-  afterEach(() => {
-    vi.useRealTimers();
-    vi.unstubAllGlobals();
-  });
-
-  it.each([
-    { label: "Web Crypto", crypto: globalThis.crypto },
-    { label: "no Web Crypto, as in React Native", crypto: undefined },
-  ])("leads with the 48-bit millisecond time using $label", ({ crypto }) => {
-    vi.useFakeTimers({ now: 0x0192_3456_789a });
-    vi.stubGlobal("crypto", crypto);
-
-    const id = createUUIDv7();
-
-    expect(isUUIDv7(id)).toBe(true);
-    expect(id.startsWith("01923456-789a-7")).toBe(true);
-    expect(createUUIDv7()).not.toBe(id);
-  });
-});

package/src/uuidv7.ts

@@ -1,38 +0,0 @@
-type RandomValuesSource = {
-  readonly getRandomValues?: (array: Uint8Array) => Uint8Array;
-};
-
-/**
- * Creates an RFC 9562 UUIDv7: a 48-bit millisecond timestamp, then random bits.
- *
- * `createUUIDv7` from `@hot-updater/plugin-core` calls `crypto.getRandomValues`
- * unconditionally, but React Native has no Web Crypto unless the app installs a
- * polyfill. An Insights event ID only has to tell one event from another so a
- * retried POST is counted once, so `Math.random` is enough without one.
- */
-export const createUUIDv7 = (): string => {
-  const bytes = new Uint8Array(16);
-  const { crypto } = globalThis as { crypto?: RandomValuesSource };
-  if (typeof crypto?.getRandomValues === "function") {
-    crypto.getRandomValues(bytes);
-  } else {
-    for (let index = 0; index < bytes.length; index += 1) {
-      bytes[index] = Math.floor(Math.random() * 256);
-    }
-  }
-
-  // Division, not bit shifts: shifts truncate to 32 bits, and a millisecond
-  // timestamp already needs 41.
-  let timestamp = Date.now();
-  for (let index = 5; index >= 0; index -= 1) {
-    bytes[index] = timestamp % 256;
-    timestamp = Math.floor(timestamp / 256);
-  }
-  bytes[6] = 0x70 | (bytes[6]! & 0x0f);
-  bytes[8] = 0x80 | (bytes[8]! & 0x3f);
-
-  const hex = Array.from(bytes, (byte) =>
-    byte.toString(16).padStart(2, "0"),
-  ).join("");
-  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
-};