headplane/docs/app/lib/releases.ts

import { useEffect, useState } from "react";

export const docsBuild = __HEADPLANE_DOCS__;

export const stableOrigin = "https://headplane.net";
export const betaOrigin = "https://beta.headplane.net";

export interface Release {
  version: string;
  path: string;
}

let releaseList: Promise<Release[]> | undefined;

// Production lists every published release in versions.json, so archived and
// beta builds also learn about releases made after them.
export function useReleases() {
  const [releases, setReleases] = useState<Release[]>([]);

  useEffect(() => {
    releaseList ??= fetch(`${stableOrigin}/versions.json`)
      .then((response) => (response.ok ? response.json() : []))
      .catch(() => []);

    let isActive = true;
    void releaseList.then((list) => {
      if (isActive && Array.isArray(list)) {
        setReleases(list);
      }
    });

    return () => {
      isActive = false;
    };
  }, []);

  return releases;
}

// The same page on another site. `pathname` is the app path, without a base.
export function pageOn(origin: string, base: string, pathname: string) {
  return `${origin}${base}${pathname.replace(/^\//, "")}`;
}