Open History to see the last commit
1import { SourceControlSignInError, type SourceControlProviderKind } from "@t3tools/contracts";
2import {
3 defineSourceControlDriver,
4 withOwnServices,
5 type SourceControlSignIn,
6} from "@t3tools/source-control-core/server/driver";
7import * as Effect from "effect/Effect";
8import * as Layer from "effect/Layer";
9import { HttpClient } from "effect/http";
10
11import { definition } from "../shared/definition.ts";
12
13import * as GitHubAppAccess from "./GitHubAppAccess.ts";
14import * as GitHubAppSignIn from "./GitHubAppSignIn.ts";
15import * as GitHubMediaFetch from "./gitHubMediaFetch.ts";
16import * as GitHubPullRequestApi from "./GitHubPullRequestApi.ts";
17import * as GitHubPullRequestProvider from "./GitHubPullRequestProvider.ts";
18import * as GitHubRest from "./GitHubRest.ts";
19import * as GitHubHttpClient from "./GitHubHttpClient.ts";
20import * as GitHubSourceControlProvider from "./GitHubSourceControlProvider.ts";
21
22// `GitHubRest.layerWithDependencies` carries the quota reserve every GitHub reader shares, so it
23// must be built once; the driver is.
24const services = GitHubPullRequestApi.layer.pipe(
25 Layer.provideMerge(GitHubAppAccess.layer),
26 Layer.provideMerge(GitHubRest.layerWithDependencies),
27 Layer.provideMerge(GitHubHttpClient.layer),
28);
29
30const makeSignIn = Effect.gen(function* () {
31 const appSignIn = yield* GitHubAppSignIn.GitHubAppSignIn;
32 const appAccess = yield* GitHubAppAccess.GitHubAppAccess;
33 const kind: SourceControlProviderKind = definition.kind;
34 return {
35 start: appSignIn.start,
36 wait: (host) =>
37 appSignIn.wait(host).pipe(
38 Effect.andThen(
39 appAccess.viewer(host).pipe(
40 Effect.mapError(
41 (cause) =>
42 new SourceControlSignInError({
43 provider: kind,
44 host,
45 reason: "failed",
46 detail: "Signed in, but GitHub would not say which account it belongs to.",
47 cause,
48 }),
49 ),
50 ),
51 ),
52 Effect.map((account) => ({ account })),
53 ),
54 cancel: appSignIn.cancel,
55 access: appAccess.reach,
56 } satisfies SourceControlSignIn;
57});
58
59const starredPath = (repository: string) => {
60 const segments = repository.split("/");
61 // "." and ".." survive encoding and would normalize the URL out of user/starred.
62 return segments.length === 2 && segments.every((segment) => !["", ".", ".."].includes(segment))
63 ? `user/starred/${segments.map(encodeURIComponent).join("/")}`
64 : undefined;
65};
66
67// Only 204 means starred. Tokens without star access, a missing login, and 404 all read as false.
68export const makeIsRepositoryStarred = Effect.gen(function* () {
69 const api = yield* GitHubRest.GitHubRest;
70 return Effect.fn("GitHubDriver.isRepositoryStarred")(
71 function* (host: string, repository: string) {
72 const path = starredPath(repository);
73 if (path === undefined) return false;
74 const response = yield* api.rest({
75 host,
76 operation: "isRepositoryStarred",
77 path,
78 allowReserve: false,
79 });
80 return response.status === 204;
81 },
82 Effect.orElseSucceed(() => false),
83 );
84});
85
86// False on any failure, such as a token or app sign-in without permission to star.
87export const makeStarRepository = Effect.gen(function* () {
88 const api = yield* GitHubRest.GitHubRest;
89 return Effect.fn("GitHubDriver.starRepository")(
90 function* (host: string, repository: string) {
91 const path = starredPath(repository);
92 if (path === undefined) return false;
93 const response = yield* api.rest({ host, operation: "starRepository", method: "PUT", path });
94 return response.status === 204;
95 },
96 Effect.orElseSucceed(() => false),
97 );
98});
99
100const makeInstance = Effect.gen(function* () {
101 const mediaHttpClient = yield* HttpClient.HttpClient;
102 return yield* withOwnServices(
103 Effect.all({
104 sourceControl: GitHubSourceControlProvider.make,
105 discovery: GitHubSourceControlProvider.makeDiscovery,
106 pullRequests: GitHubPullRequestProvider.make,
107 fetchMedia: GitHubMediaFetch.make.pipe(
108 Effect.provideService(HttpClient.HttpClient, mediaHttpClient),
109 ),
110 signIn: makeSignIn,
111 isRepositoryStarred: makeIsRepositoryStarred,
112 starRepository: makeStarRepository,
113 }),
114 services,
115 );
116});
117
118export const driver = defineSourceControlDriver({
119 kind: definition.kind,
120 definition,
121 make: makeInstance,
122});