promote getChrome to a utility

Author: miorel

workspaces/leetcode-zen-mode/src/extension/getChrome.ts

@@ -1,10 +1,9 @@
 import immutableUpdate from "immutability-helper";
 import { useSyncExternalStore } from "react";
 
+import { getChrome } from "@code-chronicles/util/browser-extensions/chrome/getChrome";
 import { getUniqueId } from "@code-chronicles/util/getUniqueId";
 
-import { getChrome } from "./getChrome.ts";
-
 let storage: Record<string, unknown> | null = null;
 
 async function writeChanges(): Promise<void> {

workspaces/leetcode-zen-mode/src/extension/useChromeStorage.ts

@@ -1,6 +1,7 @@
 import { z } from "zod";
 
-import { getChrome } from "./getChrome.ts";
+import { getChrome } from "@code-chronicles/util/browser-extensions/chrome/getChrome";
+
 import { useChromeStorage } from "./useChromeStorage.ts";
 
 export const DIFFICULTIES = ["Easy", "Medium", "Hard"] as const;

workspaces/leetcode-zen-mode/src/extension/usePreferredDifficulty.ts

@@ -34,6 +34,7 @@
     "@code-chronicles/repository-scripts": "workspace:*",
     "@code-chronicles/util": "workspace:*",
     "@jest/globals": "29.7.0",
+    "@types/chrome": "patch:@types/chrome@npm%3A0.0.280#~/.yarn/patches/@types-chrome-npm-0.0.280-34ee4ba05a.patch",
     "@types/node": "22.9.0",
     "eslint": "9.14.0",
     "jest": "29.7.0",

workspaces/util/package.json

@@ -0,0 +1,7 @@
+import type { Chrome } from "chrome";
+
+export function getChrome(): Chrome | undefined {
+  return typeof chrome === "object"
+    ? (chrome as unknown as Chrome | undefined)
+    : undefined;
+}

workspaces/util/src/browser-extensions/chrome/getChrome.ts

@@ -2,5 +2,9 @@ import invariant from "invariant";
 
 export function lastOrThrow<T>(array: readonly T[]): T {
   invariant(array.length > 0, "Expected a non-empty array!");
+
+  // The cast is safe because we checked the size of the array.
+  // Not using `nullthrows` because `T` could be a union that includes
+  // `null` or `undefined`.
   return array.at(-1) as T;
 }

workspaces/util/src/lastOrThrow.ts

@@ -1,5 +1,9 @@
-export function maybeThrow(errors: readonly [unknown, unknown[]]): never;
+import type { NonEmptyArray } from "@code-chronicles/util/NonEmptyArray";
+
+export function maybeThrow(errors: Readonly<NonEmptyArray<unknown>>): never;
+
 export function maybeThrow(errors: readonly unknown[]): void;
+
 export function maybeThrow(errors: readonly unknown[]): void {
   if (errors.length === 0) {
     return;

workspaces/util/src/maybeThrow.ts

@@ -9,7 +9,8 @@ export function popMany<T>(array: T[], count: number): T[] {
   const res: T[] = [];
   while (array.length > 0 && res.length < count) {
     // The cast is safe because we checked the size of the array.
-    // Not using `nullthrows` because `T` could be a union that includes `undefined`.
+    // Not using `nullthrows` because `T` could be a union that includes
+    // `null` or `undefined`.
     res.push(array.pop() as T);
   }