fluxer/packages/config/src/__tests__/EndpointDerivation.test.tsx

/*
 * Copyright (C) 2026 Fluxer Contributors
 *
 * This file is part of Fluxer.
 *
 * Fluxer is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * Fluxer is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with Fluxer. If not, see <https://www.gnu.org/licenses/>.
 */

import {
	buildUrl,
	type DomainConfig,
	deriveDomain,
	deriveEndpointsFromDomain,
} from '@fluxer/config/src/EndpointDerivation';
import {describe, expect, test} from 'vitest';

describe('buildUrl', () => {
	test('omits standard HTTP port (80)', () => {
		expect(buildUrl('http', 'example.com', 80, '/path')).toBe('http://example.com/path');
	});

	test('omits standard HTTPS port (443)', () => {
		expect(buildUrl('https', 'example.com', 443, '/path')).toBe('https://example.com/path');
	});

	test('omits standard WebSocket port (80)', () => {
		expect(buildUrl('ws', 'example.com', 80, '/gateway')).toBe('ws://example.com/gateway');
	});

	test('omits standard secure WebSocket port (443)', () => {
		expect(buildUrl('wss', 'example.com', 443, '/gateway')).toBe('wss://example.com/gateway');
	});

	test('includes non-standard port', () => {
		expect(buildUrl('http', 'localhost', 8088, '/api')).toBe('http://localhost:8088/api');
	});

	test('includes non-standard HTTPS port', () => {
		expect(buildUrl('https', 'example.com', 8443, '/api')).toBe('https://example.com:8443/api');
	});

	test('handles missing port', () => {
		expect(buildUrl('https', 'example.com', undefined, '/api')).toBe('https://example.com/api');
	});

	test('handles missing path', () => {
		expect(buildUrl('https', 'example.com', 443)).toBe('https://example.com');
	});

	test('handles empty path', () => {
		expect(buildUrl('https', 'example.com', 443, '')).toBe('https://example.com');
	});

	test('handles root path', () => {
		expect(buildUrl('https', 'example.com', 443, '/')).toBe('https://example.com/');
	});
});

describe('deriveDomain', () => {
	const baseConfig: DomainConfig = {
		base_domain: 'fluxer.dev',
		public_scheme: 'https',
		internal_scheme: 'http',
	};

	test('uses base domain for api endpoint', () => {
		expect(deriveDomain('api', baseConfig)).toBe('fluxer.dev');
	});

	test('uses base domain for app endpoint', () => {
		expect(deriveDomain('app', baseConfig)).toBe('fluxer.dev');
	});

	test('uses base domain for gateway endpoint', () => {
		expect(deriveDomain('gateway', baseConfig)).toBe('fluxer.dev');
	});

	test('uses base domain for media endpoint', () => {
		expect(deriveDomain('media', baseConfig)).toBe('fluxer.dev');
	});

	test('uses custom static CDN domain when specified', () => {
		const config = {...baseConfig, static_cdn_domain: 'cdn.fluxer.dev'};
		expect(deriveDomain('static_cdn', config)).toBe('cdn.fluxer.dev');
	});

	test('uses base domain for static CDN when custom domain not specified', () => {
		expect(deriveDomain('static_cdn', baseConfig)).toBe('fluxerstatic.com');
	});

	test('uses custom invite domain when specified', () => {
		const config = {...baseConfig, invite_domain: 'fluxer.gg'};
		expect(deriveDomain('invite', config)).toBe('fluxer.gg');
	});

	test('uses base domain for invite when custom domain not specified', () => {
		expect(deriveDomain('invite', baseConfig)).toBe('fluxer.dev');
	});

	test('uses custom gift domain when specified', () => {
		const config = {...baseConfig, gift_domain: 'fluxer.gift'};
		expect(deriveDomain('gift', config)).toBe('fluxer.gift');
	});

	test('uses base domain for gift when custom domain not specified', () => {
		expect(deriveDomain('gift', baseConfig)).toBe('fluxer.dev');
	});
});

describe('deriveEndpointsFromDomain', () => {
	describe('development environment (localhost)', () => {
		const devConfig: DomainConfig = {
			base_domain: 'localhost',
			public_scheme: 'http',
			internal_scheme: 'http',
			public_port: 8088,
			internal_port: 8088,
		};

		const endpoints = deriveEndpointsFromDomain(devConfig);

		test('derives api endpoint with port', () => {
			expect(endpoints.api).toBe('http://localhost:8088/api');
		});

		test('derives api client endpoint with port', () => {
			expect(endpoints.api_client).toBe('http://localhost:8088/api');
		});

		test('derives app endpoint with port', () => {
			expect(endpoints.app).toBe('http://localhost:8088');
		});

		test('derives gateway endpoint with ws scheme', () => {
			expect(endpoints.gateway).toBe('ws://localhost:8088/gateway');
		});

		test('derives media endpoint with port', () => {
			expect(endpoints.media).toBe('http://localhost:8088/media');
		});

		test('derives static CDN endpoint via CDN host', () => {
			expect(endpoints.static_cdn).toBe('https://fluxerstatic.com');
		});

		test('derives admin endpoint with port', () => {
			expect(endpoints.admin).toBe('http://localhost:8088/admin');
		});

		test('derives marketing endpoint with port', () => {
			expect(endpoints.marketing).toBe('http://localhost:8088/marketing');
		});

		test('derives invite endpoint with port', () => {
			expect(endpoints.invite).toBe('http://localhost:8088/invite');
		});

		test('derives gift endpoint with port', () => {
			expect(endpoints.gift).toBe('http://localhost:8088/gift');
		});
	});

	describe('production environment (standard HTTPS port)', () => {
		const prodConfig: DomainConfig = {
			base_domain: 'fluxer.app',
			public_scheme: 'https',
			internal_scheme: 'http',
			public_port: 443,
			internal_port: 8080,
		};

		const endpoints = deriveEndpointsFromDomain(prodConfig);

		test('derives api endpoint without port', () => {
			expect(endpoints.api).toBe('https://fluxer.app/api');
		});

		test('derives api client endpoint without port', () => {
			expect(endpoints.api_client).toBe('https://fluxer.app/api');
		});

		test('derives app endpoint without port', () => {
			expect(endpoints.app).toBe('https://fluxer.app');
		});

		test('derives gateway endpoint with wss scheme without port', () => {
			expect(endpoints.gateway).toBe('wss://fluxer.app/gateway');
		});

		test('derives media endpoint without port', () => {
			expect(endpoints.media).toBe('https://fluxer.app/media');
		});

		test('derives static CDN endpoint without port', () => {
			expect(endpoints.static_cdn).toBe('https://fluxerstatic.com');
		});

		test('derives admin endpoint without port', () => {
			expect(endpoints.admin).toBe('https://fluxer.app/admin');
		});

		test('derives marketing endpoint without port', () => {
			expect(endpoints.marketing).toBe('https://fluxer.app/marketing');
		});

		test('derives invite endpoint without port', () => {
			expect(endpoints.invite).toBe('https://fluxer.app/invite');
		});

		test('derives gift endpoint without port', () => {
			expect(endpoints.gift).toBe('https://fluxer.app/gift');
		});
	});

	describe('staging environment (custom port)', () => {
		const stagingConfig: DomainConfig = {
			base_domain: 'staging.fluxer.dev',
			public_scheme: 'https',
			internal_scheme: 'http',
			public_port: 8443,
			internal_port: 8080,
		};

		const endpoints = deriveEndpointsFromDomain(stagingConfig);

		test('derives api endpoint with custom port', () => {
			expect(endpoints.api).toBe('https://staging.fluxer.dev:8443/api');
		});

		test('derives api client endpoint with custom port', () => {
			expect(endpoints.api_client).toBe('https://staging.fluxer.dev:8443/api');
		});

		test('derives app endpoint with custom port', () => {
			expect(endpoints.app).toBe('https://staging.fluxer.dev:8443');
		});

		test('derives gateway endpoint with wss and custom port', () => {
			expect(endpoints.gateway).toBe('wss://staging.fluxer.dev:8443/gateway');
		});
	});

	describe('custom CDN domain', () => {
		const staticCdnConfig: DomainConfig = {
			base_domain: 'fluxer.app',
			public_scheme: 'https',
			internal_scheme: 'http',
			public_port: 443,
			static_cdn_domain: 'cdn.fluxer.app',
		};

		const endpoints = deriveEndpointsFromDomain(staticCdnConfig);

		test('uses custom CDN domain', () => {
			expect(endpoints.static_cdn).toBe('https://cdn.fluxer.app');
		});

		test('other endpoints use base domain', () => {
			expect(endpoints.api).toBe('https://fluxer.app/api');
			expect(endpoints.app).toBe('https://fluxer.app');
		});
	});

	describe('custom invite and gift domains', () => {
		const customConfig: DomainConfig = {
			base_domain: 'fluxer.app',
			public_scheme: 'https',
			internal_scheme: 'http',
			public_port: 443,
			invite_domain: 'fluxer.gg',
			gift_domain: 'fluxer.gift',
		};

		const endpoints = deriveEndpointsFromDomain(customConfig);

		test('uses custom invite domain', () => {
			expect(endpoints.invite).toBe('https://fluxer.gg/invite');
		});

		test('uses custom gift domain', () => {
			expect(endpoints.gift).toBe('https://fluxer.gift/gift');
		});

		test('other endpoints use base domain', () => {
			expect(endpoints.api).toBe('https://fluxer.app/api');
			expect(endpoints.app).toBe('https://fluxer.app');
		});
	});

	describe('WebSocket scheme derivation', () => {
		test('derives ws from http', () => {
			const config: DomainConfig = {
				base_domain: 'localhost',
				public_scheme: 'http',
				internal_scheme: 'http',
				public_port: 8088,
			};
			const endpoints = deriveEndpointsFromDomain(config);
			expect(endpoints.gateway).toBe('ws://localhost:8088/gateway');
		});

		test('derives wss from https', () => {
			const config: DomainConfig = {
				base_domain: 'fluxer.app',
				public_scheme: 'https',
				internal_scheme: 'http',
				public_port: 443,
			};
			const endpoints = deriveEndpointsFromDomain(config);
			expect(endpoints.gateway).toBe('wss://fluxer.app/gateway');
		});
	});

	describe('canary environment', () => {
		const canaryConfig: DomainConfig = {
			base_domain: 'canary.fluxer.app',
			public_scheme: 'https',
			internal_scheme: 'http',
			public_port: 443,
			static_cdn_domain: 'cdn-canary.fluxer.app',
		};

		const endpoints = deriveEndpointsFromDomain(canaryConfig);

		test('derives api endpoint for canary', () => {
			expect(endpoints.api).toBe('https://canary.fluxer.app/api');
		});

		test('derives app endpoint for canary', () => {
			expect(endpoints.app).toBe('https://canary.fluxer.app');
		});

		test('derives gateway endpoint for canary', () => {
			expect(endpoints.gateway).toBe('wss://canary.fluxer.app/gateway');
		});

		test('uses custom CDN domain for canary', () => {
			expect(endpoints.static_cdn).toBe('https://cdn-canary.fluxer.app');
		});
	});

	describe('edge cases', () => {
		test('handles standard HTTP port (80)', () => {
			const config: DomainConfig = {
				base_domain: 'example.com',
				public_scheme: 'http',
				internal_scheme: 'http',
				public_port: 80,
			};
			const endpoints = deriveEndpointsFromDomain(config);
			expect(endpoints.api).toBe('http://example.com/api');
			expect(endpoints.gateway).toBe('ws://example.com/gateway');
		});

		test('handles ports when undefined', () => {
			const config: DomainConfig = {
				base_domain: 'example.com',
				public_scheme: 'https',
				internal_scheme: 'http',
			};
			const endpoints = deriveEndpointsFromDomain(config);
			expect(endpoints.api).toBe('https://example.com/api');
			expect(endpoints.app).toBe('https://example.com');
		});

		test('handles IPv4 addresses', () => {
			const config: DomainConfig = {
				base_domain: '127.0.0.1',
				public_scheme: 'http',
				internal_scheme: 'http',
				public_port: 8088,
			};
			const endpoints = deriveEndpointsFromDomain(config);
			expect(endpoints.api).toBe('http://127.0.0.1:8088/api');
		});
	});
});