@devries-cameron20 / t3code Mirror · read-only
Fork 0

The best way to control Claude Code, Codex and more from any computer or phone

Mirrored from https://github.com/Camo67/t3code.git

Synced Nov 21, 03:37 UTC

main
ts 165 lines 6.33 KB
Raw
1 import * as Option from "effect/Option";
2 import * as Schema from "effect/Schema";
3
4 import { compareSemverVersions } from "./semver.ts";
5
6 const CLI_RELEASE_REPOSITORY = "pingdotgg/t3code";
7 export const CLI_RELEASES_PAGE_URL = `https://github.com/${CLI_RELEASE_REPOSITORY}/releases`;
8 export const CLI_RELEASE_CHECKSUMS_FILE = "SHA256SUMS";
9 export const CLI_RELEASE_BASE_URL_ENV = "T3CODE_RELEASE_BASE_URL";
10
11 // Keep archive keys aligned with the Linux matrix, Windows ARM64 build, and cli_archive rows in release.yml,
12 // and with the SSH runner's host check in packages/ssh/src/tunnel.ts.
13 // Node single-executables do not support darwin-x64 and segfault at startup.
14 const CLI_ARCHIVE_PLATFORM_KEYS = [
15 "darwin-arm64",
16 "linux-arm64",
17 "linux-x64",
18 "win32-arm64",
19 "win32-x64",
20 ] as const;
21 export type CliArchivePlatformKey = (typeof CLI_ARCHIVE_PLATFORM_KEYS)[number];
22
23 export function cliArchivePlatformKey(
24 platform: NodeJS.Platform,
25 arch: string,
26 ): CliArchivePlatformKey | undefined {
27 const key = `${platform}-${arch}`;
28 return CLI_ARCHIVE_PLATFORM_KEYS.find((candidate) => candidate === key);
29 }
30
31 /** Use System32 bsdtar on Windows; Git-for-Windows GNU tar cannot open zip archives. */
32 export function cliArchiveTarCommand(
33 platform: NodeJS.Platform,
34 env: Readonly<Record<string, string | undefined>>,
35 ): string {
36 if (platform !== "win32") return "tar";
37 const systemRoot = env["SystemRoot"] ?? env["windir"] ?? "C:\\Windows";
38 return `${systemRoot}\\System32\\tar.exe`;
39 }
40
41 export function cliArchiveFileName(version: string, platformKey: CliArchivePlatformKey): string {
42 return `t3-${version}-${platformKey}.${platformKey.startsWith("win32") ? "zip" : "tar.gz"}`;
43 }
44
45 const CLI_RELEASE_DEFAULT_BASE_URL = `https://github.com/${CLI_RELEASE_REPOSITORY}/releases/download`;
46
47 export function cliReleaseDownloadBaseUrl(
48 version: string,
49 baseUrl: string | undefined = CLI_RELEASE_DEFAULT_BASE_URL,
50 ): string {
51 return `${(baseUrl?.trim() || CLI_RELEASE_DEFAULT_BASE_URL).replace(/\/+$/, "")}/v${version}`;
52 }
53
54 /** `segments` added to `baseUrl`'s path, keeping its query, such as a signed mirror URL's token. */
55 export function releaseAssetUrl(baseUrl: string, ...segments: ReadonlyArray<string>): string {
56 const url = new URL(baseUrl);
57 url.pathname = [url.pathname.replace(/\/+$/, ""), ...segments.map(encodeURIComponent)].join("/");
58 return url.toString();
59 }
60
61 /** A file of release `version`, from `baseUrl` laid out as GitHub's release downloads. */
62 export function cliReleaseAssetUrl(
63 version: string,
64 fileName: string,
65 baseUrl: string | undefined = CLI_RELEASE_DEFAULT_BASE_URL,
66 ): string {
67 return releaseAssetUrl(baseUrl?.trim() || CLI_RELEASE_DEFAULT_BASE_URL, `v${version}`, fileName);
68 }
69
70 export function parseChecksums(text: string): ReadonlyMap<string, string> {
71 const checksums = new Map<string, string>();
72 for (const line of text.split(/\r?\n/)) {
73 const match = /^([0-9a-fA-F]{64})\s+\*?(\S.*)$/.exec(line.trim());
74 if (match?.[1] !== undefined && match[2] !== undefined) {
75 checksums.set(match[2], match[1].toLowerCase());
76 }
77 }
78 return checksums;
79 }
80
81 export type CliReleaseChannel = "stable" | "nightly" | "preview";
82 export const CLI_RELEASE_CHANNELS: ReadonlyArray<CliReleaseChannel> = [
83 "stable",
84 "nightly",
85 "preview",
86 ];
87
88 export function cliReleaseChannelOf(version: string): CliReleaseChannel {
89 const channel = /^[^-+]+-(nightly|preview)\.\d{8}\.\d+$/.exec(version)?.[1];
90 return channel === "nightly" || channel === "preview" ? channel : "stable";
91 }
92
93 /** Whether updating between these versions crosses Stable and Nightly. Preview builds cross nothing.
94 * Hosts refuse a crossing outside a track switch, which checks the database first. */
95 export function crossesReleaseTrack(fromVersion: string, toVersion: string): boolean {
96 const from = cliReleaseChannelOf(fromVersion);
97 const to = cliReleaseChannelOf(toVersion);
98 return from !== to && from !== "preview" && to !== "preview";
99 }
100
101 /** The desktop update track a build belongs to. Preview builds have no feed and read as Stable. */
102 export function desktopUpdateChannelOf(version: string): "latest" | "nightly" {
103 return cliReleaseChannelOf(version) === "nightly" ? "nightly" : "latest";
104 }
105
106 /**
107 * The update feed file a desktop app on this platform reads, which an update mirror publishes at
108 * its root beside the release's CLI archives.
109 */
110 export function updateFeedFileName(
111 channel: "latest" | "nightly",
112 platform: NodeJS.Platform,
113 arch: string,
114 ): string {
115 if (platform === "darwin") return `${channel}-mac.yml`;
116 if (platform === "linux")
117 return arch === "arm64" ? `${channel}-linux-arm64.yml` : `${channel}-linux.yml`;
118 return `${channel}.yml`;
119 }
120
121 /** Whether a track switch may install `found` after its database check cleared `checked`: any build
122 * on the switch's track at least as new, since later releases only add migrations. */
123 export function acceptsTrackSwitchRelease(
124 found: string,
125 channel: "latest" | "nightly",
126 checked: string,
127 ): boolean {
128 return (
129 cliReleaseChannelOf(found) === (channel === "nightly" ? "nightly" : "stable") &&
130 compareSemverVersions(found, checked) >= 0
131 );
132 }
133
134 /** Page until the channel matches; nightlies can push preview/stable releases past the first page. */
135 export function cliReleaseIndexPageUrl(page: number): string {
136 return `https://api.github.com/repos/${CLI_RELEASE_REPOSITORY}/releases?per_page=100&page=${page}`;
137 }
138
139 /** Draft assets are not downloadable. */
140 export function newestCliReleaseVersion(
141 releases: ReadonlyArray<{
142 readonly tag_name: string;
143 readonly draft?: boolean | undefined;
144 }>,
145 channel: CliReleaseChannel,
146 ): string | undefined {
147 for (const release of releases) {
148 if (release.draft) continue;
149 const version = /^v(\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)$/.exec(release.tag_name)?.[1];
150 if (version === undefined) continue;
151 if (cliReleaseChannelOf(version) === channel) return version;
152 }
153 return undefined;
154 }
155
156 const NpmReleaseMigrationManifest = Schema.Struct({
157 t3code: Schema.Struct({ databaseMigration: Schema.Int }),
158 });
159 const decodeNpmReleaseMigrationManifest = Schema.decodeUnknownOption(NpmReleaseMigrationManifest);
160
161 /** Highest database migration a release's server knows, from its npm `t3` manifest. */
162 export function npmReleaseDatabaseMigration(manifest: unknown): number | undefined {
163 return Option.getOrUndefined(decodeNpmReleaseMigrationManifest(manifest))?.t3code
164 .databaseMigration;
165 }