Function waitForStorageStable

packages/w3wallets/src/cache/buildCache.ts:27–76

* Poll chrome.storage.local via a helper page until the key count stops changing. * Waits for at least 1 key to appear, then requires the count to remain the same * for STABLE_CHECKS_REQUIRED consecutive polls before returning.

(
  helperPage: Page,
  helperUrl: string,
)

 * for {@link STABLE_CHECKS_REQUIRED} consecutive polls before returning.
 */
async function waitForStorageStable(
  helperPage: Page,
  helperUrl: string,
): Promise<number | null> {
  const TIMEOUT = STORAGE_STABILIZE_TIMEOUT;
  const POLL_INTERVAL = STORAGE_POLL_INTERVAL;
  const STABLE_CHECKS_REQUIRED = STORAGE_STABLE_CHECKS;
  const start = Date.now();
  let lastKeyCount = -1;
  let stableCount = 0;

  while (Date.now() - start < TIMEOUT) {
    await sleep(POLL_INTERVAL);

    await helperPage.goto(helperUrl);
    await helperPage.waitForFunction(
      () => document.title.startsWith("done:"),
      null,
      { timeout: HELPER_PAGE_TIMEOUT },
    );

    const title = await helperPage.title();
    const keyCount = parseInt(title.split(":")[1]!, 10);

    // Skip until extension has written at least one key
    if (keyCount === 0) continue;

    if (keyCount === lastKeyCount) {
      stableCount++;
    } else {
      stableCount = 1;
      lastKeyCount = keyCount;
    }
    debug(
      `Storage poll: ${keyCount} keys (stable ${stableCount}/${STABLE_CHECKS_REQUIRED})`,
    );

    if (stableCount >= STABLE_CHECKS_REQUIRED) {
      console.log(`  Storage stabilized at ${keyCount} keys`);
      return keyCount;
    }

    console.log(
      `  Waiting for storage to stabilize: ${keyCount} keys (${stableCount}/${STABLE_CHECKS_REQUIRED})`,
    );
  }

  console.log(`  Storage stabilization timed out after ${TIMEOUT / 1000}s`);
  return null;
}

export interface BuildOptions {
  force?: boolean;