@diffenderfer-games/hub 2.0.0-next.0 → 2.0.0-next.10

package/src/core/types.ts

@@ -1,134 +1,134 @@
-/**
- * The core client's public types, under the v1 client's names. Each one is
- * the contract's shape (so the contract stays the one source of truth),
- * widened where the offline cache can only know less than the hub (a local
- * user has no role) or made generic over a game's own JSON (`Save<MySave>`).
- */
-import type { Board, GameInfo as ContractGameInfo, Json, Metrics, SessionUser, SortDir } from '@diffenderfer-games/hub-contract';
-import type { GamePayload } from './game-data';
-import type { EndpointReply } from './rest/endpoint-types';
-
-export type { GamePayload } from './game-data';
-
-export type { Board, GameLeaderboards, GameRecords, Inventory, Json, LeaderboardEntry, Metrics, SortDir, Stats } from '@diffenderfer-games/hub-contract';
-
-/** The signed-in player. Offline (a locally stored user) only `id`, `username` and `guest` are known. */
-export type User = Pick<SessionUser, 'id' | 'username'> & Partial<Omit<SessionUser, 'id' | 'username'>>;
-
-/** One game the player has a profile in. */
-export interface ProfileSummary {
-  /** The game's slug. */
-  readonly game: string;
-  /** The player's display name there, or `null`. */
-  readonly displayName: string | null;
-}
-
-/** What `hub.me()` answers: the current user (or `null`) and their game profiles. */
-export interface MeResponse {
-  /** The signed-in player, or `null`. */
-  readonly user: User | null;
-  /** The games the player has a profile in. */
-  readonly profiles: ProfileSummary[];
-}
-
-/** A player's profile in one game, with the game's own data typed as `TData`. */
-export interface Profile<TData = Json> {
-  /** The game's slug. */
-  readonly game: string;
-  /** Shown to other players; `null` when never set. */
-  readonly displayName: string | null;
-  /** The game's own profile data. */
-  readonly data: TData;
-  /** Epoch ms. */
-  readonly updatedAt: number;
-}
-
-/** A save slot's metadata (no payload). */
-export interface SaveMeta {
-  /** The slot key. */
-  readonly slot: string;
-  /** The slot's label, or `null`. */
-  readonly label: string | null;
-  /** Epoch ms. */
-  readonly updatedAt: number;
-}
-
-/** A save slot with its payload typed as `TData`. */
-export interface Save<TData = Json> extends SaveMeta {
-  /** The stored JSON. */
-  readonly data: TData;
-}
-
-/** Options for `hub.submitScore()`, with the score's metadata typed as `TMeta`. */
-export interface SubmitScoreOptions<TMeta extends GamePayload = Json> {
-  /** The board's title; only used when the board key is first created. */
-  readonly title?: string;
-  /** The sort direction; only used on board creation. Default `desc`. */
-  readonly sort?: SortDir;
-  /** Any JSON stored with the entry (a character, a run seed). */
-  readonly meta?: TMeta;
-}
-
-/** What `hub.submitScore()` answers: the board, the player's best and rank (offline: rank 1). */
-export interface SubmitScoreResult {
-  /** The board. */
-  readonly board: Board;
-  /** The player's best score, or `null` when it did not count (a zero on a board that hides zeros). */
-  readonly best: number | null;
-  /** The player's rank, or `null`. */
-  readonly rank: number | null;
-}
-
-/** One board's ranked entries (`hub.getLeaderboard()`). */
-export type LeaderboardResult = EndpointReply<'getLeaderboard'>;
-
-/** A board with its top entries. */
-export type BoardWithTop = EndpointReply<'listTopOfEveryLeaderboard'>['games'][number]['boards'][number];
-
-/** One game's play counts, with its slug (`hub.analytics()`). */
-export type GameAnalytics = EndpointReply<'getGameAnalytics'>;
-
-/** Catalog-wide play counts with a per-game breakdown (`hub.globalAnalytics()`). */
-export interface GlobalAnalytics {
-  /** Across every game. */
-  readonly global: Metrics;
-  /** Per game. */
-  readonly games: (Metrics & { readonly slug: string; readonly title: string })[];
-}
-
-/** A listed game (`hub.listGames()`). */
-export type GameInfo = ContractGameInfo;
-
-/** What `GET /me/snapshot` answers; `hub.prefetchAll()` warms the offline cache for every game from it. */
-export type SnapshotResponse = EndpointReply<'getMyOfflineSnapshot'>;
-
-/** A player's holdings in one game, as the inventory calls answer. */
-export type InventorySnapshot = EndpointReply<'getMyInventory'>;
-
-/** The connection and sync status `hub.onStatus()` reports. */
-export interface HubStatus {
-  /** The hub is reachable. */
-  readonly online: boolean;
-  /** Calls are being served from the offline cache. */
-  readonly offline: boolean;
-  /** Queued writes plus buffered events waiting to sync. */
-  readonly pending: number;
-}
-
-/** How a client created with `createHub()` / `new Hub()` behaves. */
-export interface HubOptions {
-  /** The game's slug. Default: `window.__HUB__.slug`, then the first URL path segment. */
-  readonly slug?: string;
-  /** The API base. Default: `window.__HUB__.apiBase`, then `/_api`. */
-  readonly apiBase?: string;
-  /** A custom fetch (tests, non-browser code). Default: the global fetch. */
-  readonly fetch?: typeof fetch;
-  /**
-   * What to do when the hub can't be reached:
-   * - `auto` (default): try the network; on a connection failure fall back to
-   *   the offline cache in `localStorage`, and sync when the hub is back;
-   * - `always`: never touch the network (develop a game without a hub);
-   * - `never`: never fall back; every call throws when the hub is unreachable.
-   */
-  readonly offline?: 'auto' | 'always' | 'never';
-}
+/**
+ * The core client's public types, under the v1 client's names. Each one is
+ * the contract's shape (so the contract stays the one source of truth),
+ * widened where the offline cache can only know less than the hub (a local
+ * user has no role) or made generic over a game's own JSON (`Save<MySave>`).
+ */
+import type { Board, GameInfo as ContractGameInfo, Json, Metrics, SessionUser, SortDir } from '@diffenderfer-games/hub-contract';
+import type { GamePayload } from './game-data';
+import type { EndpointReply } from './rest/endpoint-types';
+
+export type { GamePayload } from './game-data';
+
+export type { Board, GameLeaderboards, GameRecords, Inventory, Json, LeaderboardEntry, Metrics, SortDir, Stats } from '@diffenderfer-games/hub-contract';
+
+/** The signed-in player. Offline (a locally stored user) only `id`, `username` and `guest` are known. */
+export type User = Pick<SessionUser, 'id' | 'username'> & Partial<Omit<SessionUser, 'id' | 'username'>>;
+
+/** One game the player has a profile in. */
+export interface ProfileSummary {
+  /** The game's slug. */
+  readonly game: string;
+  /** The player's display name there, or `null`. */
+  readonly displayName: string | null;
+}
+
+/** What `hub.me()` answers: the current user (or `null`) and their game profiles. */
+export interface MeResponse {
+  /** The signed-in player, or `null`. */
+  readonly user: User | null;
+  /** The games the player has a profile in. */
+  readonly profiles: ProfileSummary[];
+}
+
+/** A player's profile in one game, with the game's own data typed as `TData`. */
+export interface Profile<TData = Json> {
+  /** The game's slug. */
+  readonly game: string;
+  /** Shown to other players; `null` when never set. */
+  readonly displayName: string | null;
+  /** The game's own profile data. */
+  readonly data: TData;
+  /** Epoch ms. */
+  readonly updatedAt: number;
+}
+
+/** A save slot's metadata (no payload). */
+export interface SaveMeta {
+  /** The slot key. */
+  readonly slot: string;
+  /** The slot's label, or `null`. */
+  readonly label: string | null;
+  /** Epoch ms. */
+  readonly updatedAt: number;
+}
+
+/** A save slot with its payload typed as `TData`. */
+export interface Save<TData = Json> extends SaveMeta {
+  /** The stored JSON. */
+  readonly data: TData;
+}
+
+/** Options for `hub.submitScore()`, with the score's metadata typed as `TMeta`. */
+export interface SubmitScoreOptions<TMeta extends GamePayload = Json> {
+  /** The board's title; only used when the board key is first created. */
+  readonly title?: string;
+  /** The sort direction; only used on board creation. Default `desc`. */
+  readonly sort?: SortDir;
+  /** Any JSON stored with the entry (a character, a run seed). */
+  readonly meta?: TMeta;
+}
+
+/** What `hub.submitScore()` answers: the board, the player's best and rank (offline: rank 1). */
+export interface SubmitScoreResult {
+  /** The board. */
+  readonly board: Board;
+  /** The player's best score, or `null` when it did not count (a zero on a board that hides zeros). */
+  readonly best: number | null;
+  /** The player's rank, or `null`. */
+  readonly rank: number | null;
+}
+
+/** One board's ranked entries (`hub.getLeaderboard()`). */
+export type LeaderboardResult = EndpointReply<'getLeaderboard'>;
+
+/** A board with its top entries. */
+export type BoardWithTop = EndpointReply<'listTopOfEveryLeaderboard'>['games'][number]['boards'][number];
+
+/** One game's play counts, with its slug (`hub.analytics()`). */
+export type GameAnalytics = EndpointReply<'getGameAnalytics'>;
+
+/** Catalog-wide play counts with a per-game breakdown (`hub.globalAnalytics()`). */
+export interface GlobalAnalytics {
+  /** Across every game. */
+  readonly global: Metrics;
+  /** Per game. */
+  readonly games: (Metrics & { readonly slug: string; readonly title: string })[];
+}
+
+/** A listed game (`hub.listGames()`). */
+export type GameInfo = ContractGameInfo;
+
+/** What `GET /me/snapshot` answers; `hub.prefetchAll()` warms the offline cache for every game from it. */
+export type SnapshotResponse = EndpointReply<'getMyOfflineSnapshot'>;
+
+/** A player's holdings in one game, as the inventory calls answer. */
+export type InventorySnapshot = EndpointReply<'getMyInventory'>;
+
+/** The connection and sync status `hub.onStatus()` reports. */
+export interface HubStatus {
+  /** The hub is reachable. */
+  readonly online: boolean;
+  /** Calls are being served from the offline cache. */
+  readonly offline: boolean;
+  /** Queued writes plus buffered events waiting to sync. */
+  readonly pending: number;
+}
+
+/** How a client created with `createHub()` / `new Hub()` behaves. */
+export interface HubOptions {
+  /** The game's slug. Default: `window.__HUB__.slug`, then the first URL path segment. */
+  readonly slug?: string;
+  /** The API base. Default: `window.__HUB__.apiBase`, then `/_api`. */
+  readonly apiBase?: string;
+  /** A custom fetch (tests, non-browser code). Default: the global fetch. */
+  readonly fetch?: typeof fetch;
+  /**
+   * What to do when the hub can't be reached:
+   * - `auto` (default): try the network; on a connection failure fall back to
+   *   the offline cache in `localStorage`, and sync when the hub is back;
+   * - `always`: never touch the network (develop a game without a hub);
+   * - `never`: never fall back; every call throws when the hub is unreachable.
+   */
+  readonly offline?: 'auto' | 'always' | 'never';
+}

package/src/core/version/client-version.gen.ts

@@ -1,3 +1,3 @@
-// Generated by tools/hub-client/generate.ts. Do not edit; run `npm run gen:hub-client` in next/.
+// Generated by tools/hub-client/generate.ts. Do not edit; run `npm run gen:hub-client`.
 /** This client's package version, sent as `x-hub-client` on REST calls and `client` in `hello`. */
-export const HUB_CLIENT_VERSION = '2.0.0-next.0';
+export const HUB_CLIENT_VERSION = '2.0.0-next.10';

package/src/core/version/hub-version.ts

@@ -1,62 +1,62 @@
-/**
- * The hub's `GET /_api/version`, read at most once per page and API base
- * (plan §4.3.3), and what it says about this client. Nothing reads it on
- * load: it costs a request only when a game (or `hub-doctor`) asks.
- */
-import type { HubVersion } from '@diffenderfer-games/hub-contract';
-import { HubError, UNSUPPORTED_BY_HUB } from '../errors';
-import type { RestClient } from '../rest/rest-client';
-import { HUB_CLIENT_VERSION } from './client-version.gen';
-import { satisfiesRange } from './semver';
-
-/** How a hub regards a client version. */
-export type ClientSupport =
-  /** In `supported` and not `deprecated`. */
-  | 'supported'
-  /** Still supported, but `deprecated`: update soon. */
-  | 'deprecated'
-  /** Outside `supported`: update now. */
-  | 'unsupported'
-  /** The hub predates versioning (the old hub): nothing to compare. */
-  | 'unknown';
-
-/** How `version` fares against a hub's answer (`null`: a hub from before versioning). */
-export function clientSupport(hubVersion: HubVersion | null, version: string = HUB_CLIENT_VERSION): ClientSupport {
-  if (hubVersion === null) {
-    return 'unknown';
-  }
-  if (!satisfiesRange(version, hubVersion.supported)) {
-    return 'unsupported';
-  }
-  return satisfiesRange(version, hubVersion.deprecated) ? 'deprecated' : 'supported';
-}
-
-const versionsByApiBase = new Map<string, Promise<HubVersion | null>>();
-
-/**
- * The hub's version, fetched once per page and API base. Resolves `null` for
- * a hub from before versioning (it has no `/version` route); a failed
- * request is not cached, so a later call tries again.
- */
-export function readHubVersion(rest: RestClient): Promise<HubVersion | null> {
-  const cached = versionsByApiBase.get(rest.apiBase);
-  if (cached !== undefined) {
-    return cached;
-  }
-  const pending = fetchHubVersion(rest);
-  versionsByApiBase.set(rest.apiBase, pending);
-  return pending;
-}
-
-/** One `GET /version`; `null` when the hub has no such route. */
-async function fetchHubVersion(rest: RestClient): Promise<HubVersion | null> {
-  try {
-    return await rest.call('getHubVersion');
-  } catch (failure) {
-    if (failure instanceof HubError && failure.code === UNSUPPORTED_BY_HUB) {
-      return null;
-    }
-    versionsByApiBase.delete(rest.apiBase);
-    throw failure;
-  }
-}
+/**
+ * The hub's `GET /_api/version`, read at most once per page and API base
+ * (plan §4.3.3), and what it says about this client. Nothing reads it on
+ * load: it costs a request only when a game (or `hub-doctor`) asks.
+ */
+import type { HubVersion } from '@diffenderfer-games/hub-contract';
+import { HubError, UNSUPPORTED_BY_HUB } from '../errors';
+import type { RestClient } from '../rest/rest-client';
+import { HUB_CLIENT_VERSION } from './client-version.gen';
+import { satisfiesRange } from './semver';
+
+/** How a hub regards a client version. */
+export type ClientSupport =
+  /** In `supported` and not `deprecated`. */
+  | 'supported'
+  /** Still supported, but `deprecated`: update soon. */
+  | 'deprecated'
+  /** Outside `supported`: update now. */
+  | 'unsupported'
+  /** The hub predates versioning (the old hub): nothing to compare. */
+  | 'unknown';
+
+/** How `version` fares against a hub's answer (`null`: a hub from before versioning). */
+export function clientSupport(hubVersion: HubVersion | null, version: string = HUB_CLIENT_VERSION): ClientSupport {
+  if (hubVersion === null) {
+    return 'unknown';
+  }
+  if (!satisfiesRange(version, hubVersion.supported)) {
+    return 'unsupported';
+  }
+  return satisfiesRange(version, hubVersion.deprecated) ? 'deprecated' : 'supported';
+}
+
+const versionsByApiBase = new Map<string, Promise<HubVersion | null>>();
+
+/**
+ * The hub's version, fetched once per page and API base. Resolves `null` for
+ * a hub from before versioning (it has no `/version` route); a failed
+ * request is not cached, so a later call tries again.
+ */
+export function readHubVersion(rest: RestClient): Promise<HubVersion | null> {
+  const cached = versionsByApiBase.get(rest.apiBase);
+  if (cached !== undefined) {
+    return cached;
+  }
+  const pending = fetchHubVersion(rest);
+  versionsByApiBase.set(rest.apiBase, pending);
+  return pending;
+}
+
+/** One `GET /version`; `null` when the hub has no such route. */
+async function fetchHubVersion(rest: RestClient): Promise<HubVersion | null> {
+  try {
+    return await rest.call('getHubVersion');
+  } catch (failure) {
+    if (failure instanceof HubError && failure.code === UNSUPPORTED_BY_HUB) {
+      return null;
+    }
+    versionsByApiBase.delete(rest.apiBase);
+    throw failure;
+  }
+}

package/src/core/version/semver.ts

@@ -1,97 +1,97 @@
-/**
- * Just enough semver for version ranges the hub sends (`>=2.0.0-0 <3.0.0`,
- * `<2.2.0`): comparators separated by spaces must all hold, `||` separates
- * alternatives. Versions compare in plain semver order, prereleases included
- * (`2.0.0-next.1 < 2.0.0`); unlike npm, a prerelease is not excluded from a
- * range of another release line, which is why the hub writes `-0` floors.
- */
-
-/** A parsed `major.minor.patch[-prerelease]` version. */
-export interface ParsedVersion {
-  /** `[major, minor, patch]`. */
-  readonly release: readonly [number, number, number];
-  /** The dot-separated prerelease identifiers (empty for a release). */
-  readonly prerelease: readonly string[];
-}
-
-const VERSION_PATTERN = /^v?(\d+)(?:\.(\d+))?(?:\.(\d+))?(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/;
-
-/** Parse a version (`2`, `2.1`, `2.1.0`, `2.1.0-next.3`); `undefined` when it is not one. */
-export function parseVersion(text: string): ParsedVersion | undefined {
-  const match = VERSION_PATTERN.exec(text.trim());
-  if (match === null) {
-    return undefined;
-  }
-  const [, major = '0', minor = '0', patch = '0', prerelease] = match;
-  return { release: [Number(major), Number(minor), Number(patch)], prerelease: prerelease === undefined ? [] : prerelease.split('.') };
-}
-
-/** Compare two prerelease identifiers: numbers by value and before words, words as text. */
-function compareIdentifiers(first: string, second: string): number {
-  const isFirstNumeric = /^\d+$/.test(first);
-  const isSecondNumeric = /^\d+$/.test(second);
-  if (isFirstNumeric && isSecondNumeric) {
-    return Number(first) - Number(second);
-  }
-  if (isFirstNumeric !== isSecondNumeric) {
-    return isFirstNumeric ? -1 : 1;
-  }
-  return first < second ? -1 : first > second ? 1 : 0;
-}
-
-/** Negative when `first` is older, positive when newer, 0 when equal. */
-export function compareVersions(first: ParsedVersion, second: ParsedVersion): number {
-  for (let i = 0; i < 3; i += 1) {
-    const difference = (first.release[i] ?? 0) - (second.release[i] ?? 0);
-    if (difference !== 0) {
-      return difference;
-    }
-  }
-  if (first.prerelease.length === 0 || second.prerelease.length === 0) {
-    return second.prerelease.length - first.prerelease.length;
-  }
-  const length = Math.max(first.prerelease.length, second.prerelease.length);
-  for (let i = 0; i < length; i += 1) {
-    const firstIdentifier = first.prerelease[i];
-    const secondIdentifier = second.prerelease[i];
-    if (firstIdentifier === undefined || secondIdentifier === undefined) {
-      return firstIdentifier === undefined ? -1 : 1;
-    }
-    const difference = compareIdentifiers(firstIdentifier, secondIdentifier);
-    if (difference !== 0) {
-      return difference;
-    }
-  }
-  return 0;
-}
-
-const COMPARATOR_PATTERN = /^(>=|<=|>|<|=)?\s*(.+)$/;
-
-/** Whether `version` meets one comparator (`>=2.0.0`); a malformed comparator never holds. */
-function meetsComparator(version: ParsedVersion, comparator: string): boolean {
-  const match = COMPARATOR_PATTERN.exec(comparator);
-  const bound = match?.[2] === undefined ? undefined : parseVersion(match[2]);
-  if (match === null || bound === undefined) {
-    return false;
-  }
-  const order = compareVersions(version, bound);
-  switch (match[1]) {
-    case '>=': return order >= 0;
-    case '<=': return order <= 0;
-    case '>': return order > 0;
-    case '<': return order < 0;
-    default: return order === 0;
-  }
-}
-
-/** Whether `versionText` is in `range`; a malformed version or empty range never is. */
-export function satisfiesRange(versionText: string, range: string): boolean {
-  const version = parseVersion(versionText);
-  if (version === undefined) {
-    return false;
-  }
-  return range.split('||').some((alternative) => {
-    const comparators = alternative.trim().split(/\s+/).filter((comparator) => comparator !== '');
-    return comparators.length > 0 && comparators.every((comparator) => meetsComparator(version, comparator));
-  });
-}
+/**
+ * Just enough semver for version ranges the hub sends (`>=2.0.0-0 <3.0.0`,
+ * `<2.2.0`): comparators separated by spaces must all hold, `||` separates
+ * alternatives. Versions compare in plain semver order, prereleases included
+ * (`2.0.0-next.1 < 2.0.0`); unlike npm, a prerelease is not excluded from a
+ * range of another release line, which is why the hub writes `-0` floors.
+ */
+
+/** A parsed `major.minor.patch[-prerelease]` version. */
+export interface ParsedVersion {
+  /** `[major, minor, patch]`. */
+  readonly release: readonly [number, number, number];
+  /** The dot-separated prerelease identifiers (empty for a release). */
+  readonly prerelease: readonly string[];
+}
+
+const VERSION_PATTERN = /^v?(\d+)(?:\.(\d+))?(?:\.(\d+))?(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/;
+
+/** Parse a version (`2`, `2.1`, `2.1.0`, `2.1.0-next.3`); `undefined` when it is not one. */
+export function parseVersion(text: string): ParsedVersion | undefined {
+  const match = VERSION_PATTERN.exec(text.trim());
+  if (match === null) {
+    return undefined;
+  }
+  const [, major = '0', minor = '0', patch = '0', prerelease] = match;
+  return { release: [Number(major), Number(minor), Number(patch)], prerelease: prerelease === undefined ? [] : prerelease.split('.') };
+}
+
+/** Compare two prerelease identifiers: numbers by value and before words, words as text. */
+function compareIdentifiers(first: string, second: string): number {
+  const isFirstNumeric = /^\d+$/.test(first);
+  const isSecondNumeric = /^\d+$/.test(second);
+  if (isFirstNumeric && isSecondNumeric) {
+    return Number(first) - Number(second);
+  }
+  if (isFirstNumeric !== isSecondNumeric) {
+    return isFirstNumeric ? -1 : 1;
+  }
+  return first < second ? -1 : first > second ? 1 : 0;
+}
+
+/** Negative when `first` is older, positive when newer, 0 when equal. */
+export function compareVersions(first: ParsedVersion, second: ParsedVersion): number {
+  for (let i = 0; i < 3; i += 1) {
+    const difference = (first.release[i] ?? 0) - (second.release[i] ?? 0);
+    if (difference !== 0) {
+      return difference;
+    }
+  }
+  if (first.prerelease.length === 0 || second.prerelease.length === 0) {
+    return second.prerelease.length - first.prerelease.length;
+  }
+  const length = Math.max(first.prerelease.length, second.prerelease.length);
+  for (let i = 0; i < length; i += 1) {
+    const firstIdentifier = first.prerelease[i];
+    const secondIdentifier = second.prerelease[i];
+    if (firstIdentifier === undefined || secondIdentifier === undefined) {
+      return firstIdentifier === undefined ? -1 : 1;
+    }
+    const difference = compareIdentifiers(firstIdentifier, secondIdentifier);
+    if (difference !== 0) {
+      return difference;
+    }
+  }
+  return 0;
+}
+
+const COMPARATOR_PATTERN = /^(>=|<=|>|<|=)?\s*(.+)$/;
+
+/** Whether `version` meets one comparator (`>=2.0.0`); a malformed comparator never holds. */
+function meetsComparator(version: ParsedVersion, comparator: string): boolean {
+  const match = COMPARATOR_PATTERN.exec(comparator);
+  const bound = match?.[2] === undefined ? undefined : parseVersion(match[2]);
+  if (match === null || bound === undefined) {
+    return false;
+  }
+  const order = compareVersions(version, bound);
+  switch (match[1]) {
+    case '>=': return order >= 0;
+    case '<=': return order <= 0;
+    case '>': return order > 0;
+    case '<': return order < 0;
+    default: return order === 0;
+  }
+}
+
+/** Whether `versionText` is in `range`; a malformed version or empty range never is. */
+export function satisfiesRange(versionText: string, range: string): boolean {
+  const version = parseVersion(versionText);
+  if (version === undefined) {
+    return false;
+  }
+  return range.split('||').some((alternative) => {
+    const comparators = alternative.trim().split(/\s+/).filter((comparator) => comparator !== '');
+    return comparators.length > 0 && comparators.every((comparator) => meetsComparator(version, comparator));
+  });
+}