import fs from 'node:fs' export interface ClientRelease { version: string; revision: string; sha256: string } export interface DownloadableRelease extends ClientRelease { tarball: string } const VERSION = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/ export function parseClientRelease(value: unknown): ClientRelease { const r = value as ClientRelease if (!r || !VERSION.test(r.version) || !/^[a-f0-9]{40}$/.test(r.revision) || !/^[a-f0-9]{64}$/.test(r.sha256)) throw new Error('invalid client release metadata') return { version: r.version, revision: r.revision, sha256: r.sha256 } } export function newerVersion(candidate: string, installed: string): boolean { if (!VERSION.test(candidate) || !VERSION.test(installed)) return false const a = candidate.split('.').map(Number), b = installed.split('.').map(Number) for (let i = 0; i < 3; i++) { if (a[i] !== b[i]) return a[i] > b[i] } return false } /** Also safe inside a single-quoted shell/PowerShell template. No credentials or fragments. */ export function releaseUrl(raw: string): string { if (typeof raw !== 'string' || !/^https?:\/\/[^\s"'`$\\<>]+$/.test(raw)) throw new Error('unsafe client release URL') const url = new URL(raw) if (url.username || url.password || url.hash) throw new Error('unsafe client release URL') if (url.protocol !== 'https:' && !['localhost', '127.0.0.1', '[::1]'].includes(url.hostname)) throw new Error('client releases require HTTPS (except localhost)') return raw.replace(/\/$/, '') } export function publishedClientRelease(): DownloadableRelease | undefined { try { const release = parseClientRelease(JSON.parse(fs.readFileSync(new URL('../client-release.json', import.meta.url), 'utf8'))) const source = releaseUrl(process.env.LANGUID_SOURCE_URL ?? 'https://tangled.org/cameron.stream/languid') const tarball = releaseUrl(process.env.LANGUID_SOURCE_TARBALL ?? `${source}/archive/${release.revision}`) return { ...release, tarball } } catch { return undefined } } export function renderClientInstaller(template: string, service: string, release: DownloadableRelease): string { const checked = parseClientRelease(release) const values = { SERVICE: releaseUrl(service), TARBALL: releaseUrl(release.tarball), VERSION: checked.version, REVISION: checked.revision, SHA256: checked.sha256 } return template.replace(/@(SERVICE|TARBALL|VERSION|REVISION|SHA256)@/g, (_, key: keyof typeof values) => values[key]) }