Project Dir

1#!/usr/bin/env node
2
3import { homedir } from "node:os";
4import { join, resolve } from "node:path";
5import { realpathSync } from "node:fs";
6import { pathToFileURL } from "node:url";
7
8function safeSegment(value) {
9  const normalized = value
10    .normalize("NFKD")
11    .toLowerCase()
12    .replace(/[^a-z0-9]+/g, "-")
13    .replace(/^-+|-+$/g, "");
14  if (!normalized || normalized === "." || normalized === "..") {
15    throw new Error("Invalid GitHub PR reference: owner/repository is empty after sanitization");
16  }
17  return normalized;
18}
19
20export function parsePrReference(raw) {
21  const input = String(raw ?? "").trim();
22  let match = input.match(/^https?:\/\/github\.com\/([^/]+)\/([^/]+)\/pull\/(\d+)(?:[/?#].*)
23  if (!match) match = input.match(/^([A-Za-z0-9_.-]+)\/([A-Za-z0-9_.-]+)#(\d+)$/);
24  if (!match) {
25    throw new Error(`Invalid GitHub PR reference: ${JSON.stringify(input)}`);
26  }
27  const number = Number(match[3]);
28  if (!Number.isSafeInteger(number) || number <= 0) {
29    throw new Error(`Invalid GitHub PR reference: ${JSON.stringify(input)}`);
30  }
31  return { owner: safeSegment(match[1]), repo: safeSegment(match[2]), number };
32}
33
34export function resolvePrToVideoProjectDir({
35  pr,
36  explicitDir,
37  cwd = process.cwd(),
38  env = process.env,
39}) {
40  if (explicitDir?.trim()) return resolve(cwd, explicitDir.trim());
41  const ref = parsePrReference(pr);
42  const cacheRoot = env.XDG_CACHE_HOME?.trim()
43    ? resolve(env.XDG_CACHE_HOME)
44    : join(env.HOME?.trim() ? resolve(env.HOME) : homedir(), ".cache");
45  return join(
46    cacheRoot,
47    "hyperframes",
48    "pr-to-video",
49    ref.owner,
50    ref.repo,
51    `${ref.repo}-pr-${ref.number}`,
52  );
53}
54
55function flag(argv, name) {
56  const index = argv.indexOf(`--${name}`);
57  return index >= 0 ? argv[index + 1] : undefined;
58}
59
60function main() {
61  const argv = process.argv.slice(2);
62  const pr = flag(argv, "pr");
63  if (!pr) {
64    console.error('usage: node project-dir.mjs --pr "<github PR>" [--project-dir <path>]');
65    process.exit(2);
66  }
67  try {
68    console.log(
69      resolvePrToVideoProjectDir({
70        pr,
71        explicitDir: flag(argv, "project-dir") ?? process.env.PR_TO_VIDEO_PROJECT_DIR,
72      }),
73    );
74  } catch (error) {
75    console.error(`✗ project-dir: ${error.message}`);
76    process.exit(1);
77  }
78}
79
80// realpath both sides: on macOS /tmp → /private/tmp, and node resolves the main
81// module's symlinks in import.meta.url while argv[1] keeps the invoked spelling —
82// a raw compare silently skips main() when invoked through any symlinked path.
83function isMainModule() {
84  if (!process.argv[1]) return false;
85  try {
86    return pathToFileURL(realpathSync(process.argv[1])).href === import.meta.url;
87  } catch {
88    return false;
89  }
90}
91
92if (isMainModule()) main();