Skip to content

A free and open source instant messaging and VoIP chat app built for friends, groups, and communities.

TypeScript fluxerfluxerapp
4.9 KB
Raw Blame
// SPDX-License-Identifier: AGPL-3.0-or-later

export interface DomainConfig {
	base_domain: string;
	public_scheme: 'http' | 'https';
	public_port?: number;
	static_cdn_domain?: string;
	invite_domain?: string;
	gift_domain?: string;
}

type PublicOriginScheme = 'http' | 'https';

interface PublicOrigin {
	public_scheme: PublicOriginScheme;
	base_domain: string;
	public_port: number;
}

export interface DerivedEndpoints {
	api: string;
	api_client: string;
	app: string;
	gateway: string;
	media: string;
	static_cdn: string;
	admin: string;
	marketing: string;
	invite: string;
	gift: string;
}

function isStandardPort(scheme: string, port: number): boolean {
	return (
		(scheme === 'http' && port === 80) ||
		(scheme === 'https' && port === 443) ||
		(scheme === 'ws' && port === 80) ||
		(scheme === 'wss' && port === 443)
	);
}

function canonicalizeDomain(value: string): string {
	const trimmed = value.trim().toLowerCase();
	return trimmed.endsWith('.') ? trimmed.slice(0, -1) : trimmed;
}

function defaultPortForScheme(scheme: PublicOriginScheme): number {
	return scheme === 'https' ? 443 : 80;
}

export function parseWebOrigin(origin: string): URL | null {
	const trimmed = origin.trim();
	const authority = /^https?:\/\/([^/?#\\\s]+)\/?$/i.exec(trimmed)?.[1];
	if (!authority || /\p{Cc}/u.test(origin) || authority.includes('@') || authority.endsWith(':')) {
		return null;
	}
	const parsed = URL.parse(trimmed);
	if (!parsed || parsed.port === '0' || (parsed.protocol !== 'http:' && parsed.protocol !== 'https:')) {
		return null;
	}
	return parsed;
}

export function parsePublicOrigin(origin: string): PublicOrigin | null {
	const parsed = parseWebOrigin(origin);
	if (!parsed) {
		return null;
	}
	const scheme = parsed.protocol === 'https:' ? 'https' : 'http';
	const base_domain = canonicalizeDomain(parsed.hostname);
	if (base_domain.length === 0) {
		return null;
	}
	return {
		public_scheme: scheme,
		base_domain,
		public_port: parsed.port.length === 0 ? defaultPortForScheme(scheme) : Number.parseInt(parsed.port, 10),
	};
}

export function buildUrl(scheme: string, domain: string, port?: number, path?: string): string {
	const portPart = port && !isStandardPort(scheme, port) ? `:${port}` : '';
	const pathPart = path || '';
	return `${scheme}://${domain}${portPart}${pathPart}`;
}

export function normalizePublicEndpoint(url: string, baseDomain: string, publicPort?: number): string {
	const domain = canonicalizeDomain(baseDomain);
	if (domain.length === 0 || !publicPort) {
		return url;
	}
	let parsed: URL;
	try {
		parsed = new URL(url);
	} catch {
		return url;
	}
	if (canonicalizeDomain(parsed.hostname) !== domain) {
		return url;
	}
	if (isStandardPort(parsed.protocol.slice(0, -1), publicPort)) {
		return url;
	}
	const schemeEnd = url.indexOf('://');
	if (schemeEnd === -1 || url.startsWith('/', schemeEnd + 3)) {
		return url;
	}
	const authorityStart = schemeEnd + 3;
	const relativeEnd = url.slice(authorityStart).search(/[/\\?#]/);
	const authorityEnd = relativeEnd === -1 ? url.length : authorityStart + relativeEnd;
	const host = url.slice(authorityStart, authorityEnd).split('@').pop() ?? '';
	if (host.slice(host.lastIndexOf(']') + 1).includes(':')) {
		return url;
	}
	return `${url.slice(0, authorityEnd)}:${publicPort}${url.slice(authorityEnd)}`;
}

function deriveDomain(
	endpointType:
		| 'api'
		| 'api_client'
		| 'app'
		| 'gateway'
		| 'media'
		| 'static_cdn'
		| 'admin'
		| 'marketing'
		| 'invite'
		| 'gift',
	config: DomainConfig,
): string {
	switch (endpointType) {
		case 'static_cdn':
			return config.static_cdn_domain || config.base_domain;
		case 'invite':
			return config.invite_domain || config.base_domain;
		case 'gift':
			return config.gift_domain || config.base_domain;
		default:
			return config.base_domain;
	}
}

export function deriveEndpointsFromDomain(config: DomainConfig): DerivedEndpoints {
	const {public_scheme, public_port} = config;
	const gatewayScheme = public_scheme === 'https' ? 'wss' : 'ws';
	return {
		api: buildUrl(public_scheme, deriveDomain('api', config), public_port, '/api'),
		api_client: buildUrl(public_scheme, deriveDomain('api_client', config), public_port, '/api'),
		app: buildUrl(public_scheme, deriveDomain('app', config), public_port),
		gateway: buildUrl(gatewayScheme, deriveDomain('gateway', config), public_port, '/gateway'),
		media: buildUrl(public_scheme, deriveDomain('media', config), public_port, '/media'),
		static_cdn: config.static_cdn_domain
			? buildUrl('https', deriveDomain('static_cdn', config), undefined)
			: buildUrl(public_scheme, deriveDomain('static_cdn', config), public_port),
		admin: buildUrl(public_scheme, deriveDomain('admin', config), public_port, '/admin'),
		marketing: buildUrl(public_scheme, deriveDomain('marketing', config), public_port, '/marketing'),
		invite: buildUrl(public_scheme, deriveDomain('invite', config), public_port, '/invite'),
		gift: buildUrl(public_scheme, deriveDomain('gift', config), public_port, '/gift'),
	};
}