Skip to content
Source
Sign inSign up
Open History to see the last commit

pullRequestLinkInput.ts

122 lines3.8 KB

1import type { RepositoryIdentity } from "@t3tools/contracts";
2import { canonicalizeGitCafePullRequestUrl } from "@t3tools/source-control-definitions/registry";
3​
4import { sourceControlClients, type ChangeRequestTerminology } from "./sourceControlClients.ts";
5​
6const PULL_REQUEST_NUMBER_PATTERN = /^#?(\d+)$/;
7​
8export function parsePullRequestReference(input: string): string | null {
9 const trimmed = input.trim();
10 if (trimmed.length === 0) {
11 return null;
12 }
13​
14 const normalizedInput =
15 sourceControlClients.definitions
16 .map((definition) => definition.checkoutCommandArgument(trimmed))
17 .find((argument) => argument !== null) ?? trimmed;
18 if (normalizedInput.length === 0) {
19 return null;
20 }
21​
22 if (
23 sourceControlClients.definitions.some((definition) =>
24 definition.isChangeRequestReference(normalizedInput),
25 )
26 ) {
27 return normalizedInput;
28 }
29​
30 const numberMatch = PULL_REQUEST_NUMBER_PATTERN.exec(normalizedInput);
31 if (numberMatch?.[1]) {
32 return numberMatch[1];
33 }
34​
35 return null;
37​
38/** The thread project's repository, so a bare number resolves to one of its pull requests. */
39export function pullRequestLinkProject(identity: RepositoryIdentity | null | undefined) {
40 if (!identity) return null;
41 const repository =
42 identity.displayName ??
43 (identity.owner && identity.name ? `${identity.owner}/${identity.name}` : null);
44 if (repository === null) return null;
45 const definition = sourceControlClients.get(identity.provider ?? "unknown");
46 const host = sourceControlClients.changeRequestHost(identity, definition.kind);
47 return {
48 host,
49 repository,
50 terminology: definition.changeRequest,
51 webUrl: (number: number) =>
52 definition.changeRequestUrl({
53 host,
54 repository,
55 number,
56 remoteUrl: identity.locator.remoteUrl,
57 webUrl: identity.webUrl,
58 }),
59 };
61​
62interface ResolvedLink {
63 readonly host: string;
64 readonly repository: string;
65 readonly number: number;
66 readonly url: string;
68​
69export function resolveLinkPullRequestInput(input: {
70 readonly reference: string;
71 readonly project: {
72 readonly host: string;
73 readonly repository: string;
74 readonly terminology: ChangeRequestTerminology;
75 readonly webUrl: (number: number) => string | null;
76 } | null;
77 readonly hasProject: (reference: ResolvedLink) => boolean;
78}): { link: ResolvedLink } | { error: string } | null {
79 const parsed =
80 sourceControlClients.parseChangeRequestUrl(input.reference.trim()) !== null
81 ? input.reference.trim()
82 : parsePullRequestReference(input.reference);
83 if (parsed === null) return null;
84 const url = sourceControlClients.parseChangeRequestUrl(parsed)?.link;
85 if (url !== undefined) {
86 if (!input.hasProject({ ...url, url: parsed })) {
87 return { error: `No project in this environment can read ${url.host}/${url.repository}.` };
88 }
89 return {
90 link: {
91 host: url.host,
92 repository: url.repository,
93 number: url.number,
94 url: canonicalizeGitCafePullRequestUrl(parsed),
95 },
96 };
97 }
98 const number = Number(parsed);
99 if (!Number.isSafeInteger(number) || number < 1) return null;
100 if (input.project === null) {
101 return {
102 error:
103 "Paste the full pull request URL; this thread has no repository to resolve the number against.",
104 };
105 }
106 const webUrl = input.project.webUrl(number);
107 const webReference =
108 webUrl === null ? undefined : sourceControlClients.parseChangeRequestUrl(webUrl)?.link;
109 if (webUrl === null || webReference === undefined) {
110 return {
111 error: `Paste a full URL; this project's host has no known ${input.project.terminology.singular} URL.`,
112 };
113 }
114 return {
115 link: {
116 host: webReference.host,
117 repository: webReference.repository,
118 number: webReference.number,
119 url: webUrl,
120 },
121 };