steelseries-sonar-sdk 0.1.1 → 0.2.2

package/src/functions/audio/get-audio-data-classic.ts

@@ -1,31 +0,0 @@
-import { AudioChannel } from '@/enums'
-import { convertVolumeToUser } from '@/functions/converters/convert-volume-to-user'
-import type { VolumeInfoClassic } from '@/sonar/models/audio-settings/volume-info-classic'
-import { requestVolumeSettingsClassic } from '@/sonar/requests/volume-settings/request-volume-settings-classic'
-import type { ChannelVolumeClassic } from '@/types/channel-volume-classic'
-import type { ChannelVolumesClassic } from '@/types/channel-volumes-classic'
-
-/**
- * Gets audio data for all channels.
- * @param sonarEndpoint Sonar endpoint URL
- * @returns volume in the range of 0 to 100,
- */
-export async function getAudioDataClassic(sonarEndpoint: string): Promise<ChannelVolumesClassic> {
-	const data = await requestVolumeSettingsClassic(sonarEndpoint)
-	const volumeData: ChannelVolumesClassic = {
-		[AudioChannel.Master]: createResponseVolumeData(data.masters.classic),
-		[AudioChannel.Game]: data.devices.game && createResponseVolumeData(data.devices.game.classic),
-		[AudioChannel.Chat]: data.devices.chatRender && createResponseVolumeData(data.devices.chatRender.classic),
-		[AudioChannel.Media]: data.devices.media && createResponseVolumeData(data.devices.media.classic),
-		[AudioChannel.Aux]: data.devices.aux && createResponseVolumeData(data.devices.aux.classic),
-		[AudioChannel.Mic]: data.devices.chatCapture && createResponseVolumeData(data.devices.chatCapture.classic)
-	}
-	return volumeData
-}
-
-function createResponseVolumeData(volumeData: VolumeInfoClassic): ChannelVolumeClassic {
-	return {
-		volume: convertVolumeToUser(volumeData.volume),
-		isMuted: volumeData.muted
-	}
-}

package/src/functions/audio/get-audio-data-stream.ts

@@ -1,37 +0,0 @@
-import { AudioChannel, StreamerPath } from '@/enums'
-import { convertVolumeToUser } from '@/functions/converters/convert-volume-to-user'
-import type { VolumeInfoStreamer } from '@/sonar/models/audio-settings/volume-info-streamer'
-import { requestVolumeSettingsStreamer } from '@/sonar/requests/volume-settings/request-volume-settings-streamer'
-import type { ChannelVolumeStreamer } from '@/types/channel-volume-streamer'
-import type { ChannelVolumesStreamer } from '@/types/channel-volumes-streamer'
-
-/**
- * Gets audio data for all channels.
- * @param sonarEndpoint Sonar endpoint URL
- * @returns volume in the range of 0 to 100,
- */
-export async function getAudioDataStream(sonarEndpoint: string): Promise<ChannelVolumesStreamer> {
-	const data = await requestVolumeSettingsStreamer(sonarEndpoint)
-	const volumeData: ChannelVolumesStreamer = {
-		[AudioChannel.Master]: createResponseVolumeData(data.masters.stream),
-		[AudioChannel.Game]: data.devices.game && createResponseVolumeData(data.devices.game.stream),
-		[AudioChannel.Chat]: data.devices.chatRender && createResponseVolumeData(data.devices.chatRender.stream),
-		[AudioChannel.Media]: data.devices.media && createResponseVolumeData(data.devices.media.stream),
-		[AudioChannel.Aux]: data.devices.aux && createResponseVolumeData(data.devices.aux.stream),
-		[AudioChannel.Mic]: data.devices.chatCapture && createResponseVolumeData(data.devices.chatCapture.stream)
-	}
-	return volumeData
-}
-
-function createResponseVolumeData(volumeData: VolumeInfoStreamer): ChannelVolumeStreamer {
-	return {
-		[StreamerPath.Streaming]: {
-			volume: convertVolumeToUser(volumeData.streaming.volume),
-			isMuted: volumeData.streaming.muted
-		},
-		[StreamerPath.Monitoring]: {
-			volume: convertVolumeToUser(volumeData.monitoring.volume),
-			isMuted: volumeData.monitoring.muted
-		}
-	}
-}

package/src/functions/audio/get-audio-mode.ts

@@ -1,11 +0,0 @@
-import type { AudioMode } from '@/enums'
-import { requestAudioMode } from '@/sonar/requests/mode/request-audio-mode'
-
-/**
- * Gets audio data for all channels.
- * @param sonarEndpoint Sonar endpoint URL
- * @returns classic or streamer mode
- */
-export async function getAudioMode(sonarEndpoint: string): Promise<AudioMode> {
-	return await requestAudioMode(sonarEndpoint)
-}

package/src/functions/audio/set-audio-mode.ts

@@ -1,12 +0,0 @@
-import type { AudioMode } from '@/enums'
-import { changeAudioMode } from '@/sonar/requests/mode/change-audio-mode'
-
-/**
- * Gets audio data for all channels.
- * @param sonarEndpoint Sonar endpoint URL
- * @param audioMode Target audio mode
- * @returns classic or streamer mode
- */
-export async function setAudioMode(sonarEndpoint: string, audioMode: AudioMode): Promise<AudioMode> {
-	return await changeAudioMode(sonarEndpoint, audioMode)
-}

package/src/functions/audio/set-channel-mute-classic.ts

@@ -1,35 +0,0 @@
-import type { AudioChannel } from '@/enums'
-import { SonarRequestException } from '@/exceptions'
-import { convertChannelToApi } from '@/functions/converters/convert-channel-to-api'
-import { convertVolumeToUser } from '@/functions/converters/convert-volume-to-user'
-import { SonarChannel } from '@/sonar/models/audio-settings/enums/sonar-channel'
-import { changeVolumeMuteClassic } from '@/sonar/requests/volume-settings/change-volume-mute-classic'
-import type { ChannelVolumeClassic } from '@/types/channel-volume-classic'
-
-/**
- * Sets audio data for target channel.
- * @param sonarEndpoint Sonar endpoint URL
- * @param isMuted Will mute if true.
- * @param channel Target audio channel
- */
-export async function setChannelMuteClassic(
-	sonarEndpoint: string,
-	isMuted: boolean,
-	channel: AudioChannel
-): Promise<ChannelVolumeClassic> {
-	const sonarChannel = convertChannelToApi(channel)
-	const data = await changeVolumeMuteClassic(sonarEndpoint, isMuted, sonarChannel)
-
-	const device = sonarChannel === SonarChannel.Master ? data.masters.classic : data.devices[sonarChannel]?.classic
-
-	if (!device) {
-		throw new SonarRequestException({ message: `Missing device data in response.` })
-	}
-
-	const result: ChannelVolumeClassic = {
-		volume: convertVolumeToUser(device.volume),
-		isMuted: device.muted
-	}
-
-	return result
-}

package/src/functions/audio/set-channel-mute-streamer.ts

@@ -1,41 +0,0 @@
-import { type AudioChannel, StreamerPath } from '@/enums'
-import { SonarRequestException } from '@/exceptions'
-import { convertChannelToApi } from '@/functions/converters/convert-channel-to-api'
-import { convertVolumeToUser } from '@/functions/converters/convert-volume-to-user'
-import { SonarChannel } from '@/sonar/models/audio-settings/enums/sonar-channel'
-import { StreamingPath } from '@/sonar/models/audio-settings/enums/streaming-path'
-import { changeVolumeMuteStreamer } from '@/sonar/requests/volume-settings/change-volume-mute-streamer'
-import type { ChannelVolumeStreamerPath } from '@/types/channel-volume-streamer-path'
-
-/**
- * Sets audio data for target channel.
- * @param sonarEndpoint Sonar endpoint URL
- * @param isMuted Will mute if true.
- * @param channel Target audio channel
- * @param path Target streamer path
- */
-export async function setChannelMuteStreamer(
-	sonarEndpoint: string,
-	isMuted: boolean,
-	channel: AudioChannel,
-	path: StreamerPath
-): Promise<ChannelVolumeStreamerPath> {
-	const sonarChannel = convertChannelToApi(channel)
-	const streamPath = path === StreamerPath.Streaming ? StreamingPath.Streaming : StreamingPath.Monitoring
-	const data = await changeVolumeMuteStreamer(sonarEndpoint, isMuted, sonarChannel, streamPath)
-
-	const device = sonarChannel === SonarChannel.Master ? data.masters.stream : data.devices[sonarChannel]?.stream
-
-	if (!device) {
-		throw new SonarRequestException({ message: `Missing device data in response.` })
-	}
-
-	const devicePath = path === StreamerPath.Streaming ? device.streaming : device.monitoring
-
-	const result: ChannelVolumeStreamerPath = {
-		volume: convertVolumeToUser(devicePath.volume),
-		isMuted: devicePath.muted
-	}
-
-	return result
-}

package/src/functions/audio/set-channel-volume-classic.ts

@@ -1,37 +0,0 @@
-import type { AudioChannel } from '@/enums'
-import { SonarRequestException } from '@/exceptions'
-import { convertChannelToApi } from '@/functions/converters/convert-channel-to-api'
-import { convertVolumeToApi } from '@/functions/converters/convert-volume-to-api'
-import { convertVolumeToUser } from '@/functions/converters/convert-volume-to-user'
-import { SonarChannel } from '@/sonar/models/audio-settings/enums/sonar-channel'
-import { changeVolumeLevelClassic } from '@/sonar/requests/volume-settings/change-volume-level-classic'
-import type { ChannelVolumeClassic } from '@/types/channel-volume-classic'
-
-/**
- * Sets audio data for target channel.
- * @param sonarEndpoint Sonar endpoint URL
- * @param volumePercent Volume in the range of 0 to 100
- * @param channel Target audio channel
- */
-export async function setChannelVolumeClassic(
-	sonarEndpoint: string,
-	volumePercent: number,
-	channel: AudioChannel
-): Promise<ChannelVolumeClassic> {
-	const sonarChannel = convertChannelToApi(channel)
-	const formattedVolume = convertVolumeToApi(volumePercent)
-	const data = await changeVolumeLevelClassic(sonarEndpoint, formattedVolume, sonarChannel)
-
-	const device = sonarChannel === SonarChannel.Master ? data.masters.classic : data.devices[sonarChannel]?.classic
-
-	if (!device) {
-		throw new SonarRequestException({ message: `Missing device data in response.` })
-	}
-
-	const result: ChannelVolumeClassic = {
-		volume: convertVolumeToUser(device.volume),
-		isMuted: device.muted
-	}
-
-	return result
-}

package/src/functions/audio/set-channel-volume-streamer.ts

@@ -1,43 +0,0 @@
-import { type AudioChannel, StreamerPath } from '@/enums'
-import { SonarRequestException } from '@/exceptions'
-import { convertChannelToApi } from '@/functions/converters/convert-channel-to-api'
-import { convertVolumeToApi } from '@/functions/converters/convert-volume-to-api'
-import { convertVolumeToUser } from '@/functions/converters/convert-volume-to-user'
-import { SonarChannel } from '@/sonar/models/audio-settings/enums/sonar-channel'
-import { StreamingPath } from '@/sonar/models/audio-settings/enums/streaming-path'
-import { changeVolumeLevelStreamer } from '@/sonar/requests/volume-settings/change-volume-level-streamer'
-import type { ChannelVolumeStreamerPath } from '@/types/channel-volume-streamer-path'
-
-/**
- * Sets audio data for target channel.
- * @param sonarEndpoint Sonar endpoint URL
- * @param volumePercent Volume in the range of 0 to 100
- * @param channel Target audio channel
- * @param path Target streamer path
- */
-export async function setChannelVolumeStreamer(
-	sonarEndpoint: string,
-	volumePercent: number,
-	channel: AudioChannel,
-	path: StreamerPath
-): Promise<ChannelVolumeStreamerPath> {
-	const sonarChannel = convertChannelToApi(channel)
-	const formattedVolume = convertVolumeToApi(volumePercent)
-	const streamPath = path === StreamerPath.Streaming ? StreamingPath.Streaming : StreamingPath.Monitoring
-	const data = await changeVolumeLevelStreamer(sonarEndpoint, formattedVolume, sonarChannel, streamPath)
-
-	const device = sonarChannel === SonarChannel.Master ? data.masters.stream : data.devices[sonarChannel]?.stream
-
-	if (!device) {
-		throw new SonarRequestException({ message: `Missing device data in response.` })
-	}
-
-	const devicePath = path === StreamerPath.Streaming ? device.streaming : device.monitoring
-
-	const result: ChannelVolumeStreamerPath = {
-		volume: convertVolumeToUser(devicePath.volume),
-		isMuted: devicePath.muted
-	}
-
-	return result
-}

package/src/functions/chatmix/get-chat-mix-state.ts

@@ -1,20 +0,0 @@
-import { ChatMixState } from '@/enums'
-import { convertChatMixBalanceToUser } from '@/functions/converters/convert-chat-mix-balance-to-user'
-import { requestChatMixState } from '@/sonar/requests/chatmix/request-chat-mix-state'
-import type { ChatMixData } from '@/types/chat-mix-data'
-
-/**
- * Gets CHATMIX state and data.
- * @param sonarEndpoint Sonar endpoint URL
- * @returns balance as 0 - 100,
- */
-export async function getChatMixState(sonarEndpoint: string): Promise<ChatMixData> {
-	const data = await requestChatMixState(sonarEndpoint)
-
-	const chatMixData: ChatMixData = {
-		chatBalance: convertChatMixBalanceToUser(data.balance),
-		state: data.state,
-		isEnabled: data.state === ChatMixState.Enabled
-	}
-	return chatMixData
-}

package/src/functions/chatmix/set-chat-mix-balance.ts

@@ -1,22 +0,0 @@
-import { ChatMixState } from '@/enums'
-import { convertChatMixBalanceToApi } from '@/functions/converters/convert-chat-mix-balance-to-api'
-import { convertChatMixBalanceToUser } from '@/functions/converters/convert-chat-mix-balance-to-user'
-import { changeChatMixBalance } from '@/sonar/requests/chatmix/change-chat-mix-balance'
-import type { ChatMixData } from '@/types/chat-mix-data'
-
-/**
- * Set CHATMIX balance between audio(0%) and chat(100%).
- * @param sonarEndpoint Sonar endpoint URL
- * @param chatBalance Balance as 0 - 100,
- */
-export async function setChatMixBalance(sonarEndpoint: string, chatBalance: number): Promise<ChatMixData> {
-	const balance = convertChatMixBalanceToApi(chatBalance)
-	const data = await changeChatMixBalance(sonarEndpoint, balance)
-
-	const chatMixData: ChatMixData = {
-		chatBalance: convertChatMixBalanceToUser(data.balance),
-		state: data.state,
-		isEnabled: data.state === ChatMixState.Enabled
-	}
-	return chatMixData
-}

package/src/functions/converters/convert-channel-to-api.ts

@@ -1,19 +0,0 @@
-import { AudioChannel } from '@/enums'
-import { SonarChannel } from '@/sonar/models/audio-settings/enums/sonar-channel'
-
-export function convertChannelToApi(channel: AudioChannel): SonarChannel {
-	switch (channel) {
-		case AudioChannel.Master:
-			return SonarChannel.Master
-		case AudioChannel.Game:
-			return SonarChannel.ChatRender
-		case AudioChannel.Media:
-			return SonarChannel.Media
-		case AudioChannel.Aux:
-			return SonarChannel.Aux
-		case AudioChannel.Mic:
-			return SonarChannel.ChatCapture
-		default:
-			throw new Error(`Unsupported AudioChannel: ${channel}`)
-	}
-}

package/src/functions/converters/convert-chat-mix-balance-to-api.ts

@@ -1,6 +0,0 @@
-/** convert [0 to 100] to [-1 to 1] */
-export function convertChatMixBalanceToApi(balance: number): number {
-	let result = (balance / 100) * 2 - 1
-	result = Math.min(Math.max(result, -1), 1)
-	return result
-}

package/src/functions/converters/convert-chat-mix-balance-to-user.ts

@@ -1,7 +0,0 @@
-/** convert [-1 to 1] to [0 to 100] */
-export function convertChatMixBalanceToUser(balance: number): number {
-	let result = ((balance + 1) / 2) * 100
-	result = Math.floor(result)
-	result = Math.min(Math.max(result, 0), 100)
-	return result
-}

package/src/functions/converters/convert-profile-channel-to-api.ts

@@ -1,19 +0,0 @@
-import { ProfileChannel } from '@/enums'
-import { VirtualAudioDevice } from '@/sonar/models/config/enums/VirtualAudioDevice'
-
-export function convertProfileChannelToApi(channel: ProfileChannel): VirtualAudioDevice {
-	switch (channel) {
-		case ProfileChannel.Game:
-			return VirtualAudioDevice.Game
-		case ProfileChannel.Chat:
-			return VirtualAudioDevice.ChatRender
-		case ProfileChannel.Media:
-			return VirtualAudioDevice.Media
-		case ProfileChannel.Aux:
-			return VirtualAudioDevice.Aux
-		case ProfileChannel.Mic:
-			return VirtualAudioDevice.ChatCapture
-		default:
-			throw new Error(`Unsupported ProfileChannel: ${channel}`)
-	}
-}

package/src/functions/converters/convert-profile-channel-to-user.ts

@@ -1,19 +0,0 @@
-import { ProfileChannel } from '@/enums'
-import { VirtualAudioDevice } from '@/sonar/models/config/enums/VirtualAudioDevice'
-
-export function convertProfileChannelToUser(channel: VirtualAudioDevice): ProfileChannel {
-	switch (channel) {
-		case VirtualAudioDevice.Game:
-			return ProfileChannel.Game
-		case VirtualAudioDevice.ChatRender:
-			return ProfileChannel.Chat
-		case VirtualAudioDevice.Media:
-			return ProfileChannel.Media
-		case VirtualAudioDevice.Aux:
-			return ProfileChannel.Aux
-		case VirtualAudioDevice.ChatCapture:
-			return ProfileChannel.Mic
-		default:
-			throw new Error(`Unsupported ProfileChannel: ${channel}`)
-	}
-}

package/src/functions/converters/convert-volume-to-api.ts

@@ -1,5 +0,0 @@
-export function convertVolumeToApi(value: number): number {
-	let result = value / 100
-	result = Math.min(Math.max(result, 0), 1)
-	return result
-}

package/src/functions/converters/convert-volume-to-user.ts

@@ -1,6 +0,0 @@
-export function convertVolumeToUser(value: number): number {
-	let result = value * 100
-	result = Math.min(Math.max(result, 0), 100)
-	result = Math.floor(result)
-	return result
-}

package/src/functions/devices/get-audio-devices.ts

@@ -1,40 +0,0 @@
-import { DeviceFlow } from '@/enums'
-import { SonarRequestException } from '@/exceptions'
-import { DeviceDataFlow } from '@/sonar/models/audio-settings/enums/device-data-flow'
-import { requestAudioDevices } from '@/sonar/requests/audio-devices/request-audio-devices'
-import type { AudioDevice } from '@/types/audio-device'
-
-export async function getAudioDevices(sonarEndpoint: string, deviceType?: DeviceFlow): Promise<AudioDevice[]> {
-	let deviceDataFlow: DeviceDataFlow
-	switch (deviceType) {
-		case DeviceFlow.Input:
-			deviceDataFlow = DeviceDataFlow.Capture
-			break
-		case DeviceFlow.Output:
-			deviceDataFlow = DeviceDataFlow.Render
-			break
-		case undefined:
-			deviceDataFlow = DeviceDataFlow.All
-			break
-	}
-	const data = await requestAudioDevices(sonarEndpoint, { deviceDataFlow, removeSteelSeriesVAD: true })
-
-	const audioDevices: AudioDevice[] = data.map((device) => ({
-		id: device.id,
-		name: device.friendlyName,
-		type: getDeviceTypeFromDataFlow(device.dataFlow)
-	}))
-
-	return audioDevices
-}
-
-function getDeviceTypeFromDataFlow(dataFlow: DeviceDataFlow): DeviceFlow {
-	switch (dataFlow) {
-		case DeviceDataFlow.Capture:
-			return DeviceFlow.Input
-		case DeviceDataFlow.Render:
-			return DeviceFlow.Output
-		default:
-			throw new SonarRequestException({ message: `Unknown device data flow: ${dataFlow}` })
-	}
-}

package/src/functions/devices/set-audio-device.ts

@@ -1,19 +0,0 @@
-import type { DeviceChannel } from '@/enums'
-import { changeAudioDevice } from '@/sonar/requests/audio-devices/change-audio-device'
-import type { ChangedDevice } from '@/types/changed-device'
-
-export async function setAudioDevice(
-	sonarEndpoint: string,
-	deviceChannel: DeviceChannel,
-	deviceId: string
-): Promise<ChangedDevice[]> {
-	const data = await changeAudioDevice(sonarEndpoint, deviceChannel, deviceId)
-
-	const result: ChangedDevice[] = data.map((x) => ({
-		deviceId: x.deviceId,
-		deviceChannel: x.id,
-		isRunning: x.isRunning
-	}))
-
-	return result
-}

package/src/functions/endpoint/get-app-endpoint.ts

@@ -1,73 +0,0 @@
-import { promises as fsAsync } from 'node:fs'
-import { platform as getPlatform } from 'node:os'
-import { join as joinPath } from 'node:path'
-import { InitializeErrorReason, SonarInitializationException } from '@/exceptions'
-
-const WINDOWS_PATHS = ['SteelSeries', 'SteelSeries Engine 3', 'coreProps.json']
-
-type CoreProps = {
-	ggEncryptedAddress: string
-}
-
-/**
- * Retrieves the SteelSeries GG application's encrypted address from the coreProps.json file.
- *
- * @returns A promise that resolves to the GG application's secure address string (e.g., "https://..."),
- *          as found in the ggEncryptedAddress property of coreProps.json.
- *
- * @throws {SonarInitializationException} If the GG server cannot be determined.
- *
- * @remarks
- * - Only supports Windows OS; throws on other platforms.
- * - Locates coreProps.json in the ProgramData directory under SteelSeries folders.
- * - Reads and parses the file, returning the encrypted address as a secure URL.
- */
-export async function getAppEndpoint(): Promise<string> {
-	const appDataPath = getPath()
-	const fileContents = await getContents(appDataPath)
-	const data = parseContents(fileContents)
-
-	if (data.ggEncryptedAddress) {
-		return `https://${data.ggEncryptedAddress}`
-	}
-
-	throw new SonarInitializationException({
-		reason: InitializeErrorReason.BadConfig
-	})
-}
-
-function getPath(): string {
-	const os = getPlatform()
-	switch (os) {
-		case 'win32': {
-			const programData = process.env.ProgramData ?? 'C:\\ProgramData'
-			return joinPath(programData, ...WINDOWS_PATHS)
-		}
-		default:
-			throw new SonarInitializationException({
-				reason: InitializeErrorReason.OSUnsupported
-			})
-	}
-}
-
-async function getContents(path: string): Promise<string> {
-	try {
-		return await fsAsync.readFile(path, 'utf8')
-	} catch (error) {
-		throw new SonarInitializationException({
-			reason: InitializeErrorReason.BadConfig,
-			innerException: error as Error
-		})
-	}
-}
-
-function parseContents(contents: string): CoreProps {
-	try {
-		return JSON.parse(contents) as CoreProps
-	} catch (error) {
-		throw new SonarInitializationException({
-			reason: InitializeErrorReason.BadConfig,
-			innerException: error as Error
-		})
-	}
-}

package/src/functions/endpoint/get-sonar-endpoint-cached.ts

@@ -1,28 +0,0 @@
-import { getSonarEndpoint } from '@/functions/endpoint/get-sonar-endpoint'
-
-const cache = {
-	appAddress: null as string | null,
-	sonarAddress: null as string | null,
-	timestamp: 0
-}
-
-export async function getSonarEndpointCached(appAddress: string, seconds: number = 60): Promise<string> {
-	const now = Date.now()
-
-	if (cache.appAddress === appAddress && cache.sonarAddress && now - cache.timestamp < seconds * 1000) {
-		return cache.sonarAddress
-	}
-
-	try {
-		const sonarAddress = await getSonarEndpoint(appAddress)
-		cache.appAddress = appAddress
-		cache.sonarAddress = sonarAddress
-		cache.timestamp = now
-		return sonarAddress
-	} catch (error) {
-		cache.appAddress = null
-		cache.sonarAddress = null
-		cache.timestamp = 0
-		throw error
-	}
-}

package/src/functions/endpoint/get-sonar-endpoint.ts

@@ -1,88 +0,0 @@
-import { InitializeErrorReason, SonarInitializationException } from '@/exceptions'
-
-type SubAppsResponse = {
-	subApps: {
-		sonar?: {
-			isEnabled: boolean
-			isReady: boolean
-			isRunning: boolean
-			metadata: {
-				webServerAddress: string
-			}
-		}
-	}
-}
-
-/**
- * Retrieves the Sonar web server address from an application server's /subApps endpoint.
- *
- * @param appEndpoint - The base URL of the application server (e.g. "https://localhost:1234").
- * @returns A promise that resolves to the Sonar web server address.
- *
- * @throws {SonarInitializationException} If the sonar server cannot be determined.
- *
- * @remarks
- * - Performs a GET request to `${appAddress}/subApps`.
- * - The response body is expected to conform to the SubAppsResponse shape and contain `subApps.sonar`.
- * - Uses a fetch TLS option that disables certificate verification (rejectUnauthorized: false).
- */
-export async function getSonarEndpoint(appEndpoint: string): Promise<string> {
-	let response: Response
-
-	try {
-		response = await fetch(`${appEndpoint}/subApps`, {
-			tls: {
-				rejectUnauthorized: false
-			}
-		})
-	} catch (error) {
-		throw new SonarInitializationException({
-			reason: InitializeErrorReason.NotResponding,
-			innerException: error as Error
-		})
-	}
-
-	if (!response.ok) {
-		throw new SonarInitializationException({
-			reason: InitializeErrorReason.NotResponding
-		})
-	}
-
-	const result: SubAppsResponse = (await response.json()) as SubAppsResponse
-
-	const sonar = result?.subApps?.sonar
-
-	if (!sonar) {
-		throw new SonarInitializationException({
-			reason: InitializeErrorReason.NotAvailable
-		})
-	}
-
-	if (!sonar.isEnabled) {
-		throw new SonarInitializationException({
-			reason: InitializeErrorReason.NotEnabled
-		})
-	}
-
-	if (!sonar.isRunning) {
-		throw new SonarInitializationException({
-			reason: InitializeErrorReason.NotRunning
-		})
-	}
-
-	if (!sonar.isReady) {
-		throw new SonarInitializationException({
-			reason: InitializeErrorReason.NotReady
-		})
-	}
-
-	const sonarAddress = sonar.metadata?.webServerAddress
-
-	if (!sonarAddress) {
-		throw new SonarInitializationException({
-			reason: InitializeErrorReason.NotAvailable
-		})
-	}
-
-	return sonarAddress
-}