import type { BigIntStats, Stats } from "node:fs";
import { extname } from "node:path";

/** Extensions Windows launches directly through CreateProcess or cmd.exe. */
const windowsLaunchableExtensions = new Set([".bat", ".cmd", ".com", ".exe"]);

/**
 * Whether a host filesystem entry carries the host's executable marking.
 *
 * POSIX hosts mark executability with permission bits. Windows has no execute
 * bit (Node reports file modes from the read-only attribute alone), so it marks
 * launchable files by extension instead.
 */
export const hostExecutableMarking = (
  path: string,
  metadata: Pick<Stats | BigIntStats, "mode" | "isFile">,
  platform: NodeJS.Platform = process.platform,
): boolean =>
  platform === "win32"
    ? metadata.isFile() &&
      windowsLaunchableExtensions.has(extname(path).toLowerCase())
    : typeof metadata.mode === "bigint"
      ? (metadata.mode & 0o111n) !== 0n
      : (metadata.mode & 0o111) !== 0;