steelseries-sonar-sdk 0.1.1

package/.gitattributes

@@ -0,0 +1,8 @@
+*.ts    text eol=lf
+*.json  text eol=lf
+*.yml  text eol=lf
+*.txt    text eol=lf
+*.md    text eol=lf
+*.http    text eol=lf
+.gitattributes	text eol=lf
+bun.lock	text eol=lf

package/.github/workflows/tests.yml

@@ -0,0 +1,18 @@
+name: Tests
+on: [push, pull_request]
+
+jobs:
+  Test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v2
+      - name: Install Bun
+        run: bun install
+      - name: Run Tests
+        run: bun test --coverage --coverage-reporter=lcov ./tests/unit
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v3
+        with:
+          file: ./coverage/lcov.info
+          token: ${{ secrets.CODECOV_TOKEN }}

package/.vscode/extensions.json

@@ -0,0 +1,8 @@
+{
+	"recommendations": [
+		"biomejs.biome",
+		"streetsidesoftware.code-spell-checker",
+		"humao.rest-client",
+		"gruntfuggly.todo-tree"
+	]
+}

package/.vscode/settings.json

@@ -0,0 +1,33 @@
+{
+	"editor.tabSize": 4,
+	"editor.insertSpaces": false,
+	"editor.detectIndentation": false,
+	"files.eol": "\n",
+	"files.encoding": "utf8",
+	"files.trimTrailingWhitespace": true,
+	"files.insertFinalNewline": true,
+	"editor.formatOnSave": true,
+	"editor.defaultFormatter": "biomejs.biome",
+	"editor.codeActionsOnSave": {
+		"source.fixAll.biome": "explicit",
+		"source.organizeImports.biome": "explicit"
+	},
+	"prettier.enable": false,
+	"typescript.preferences.importModuleSpecifier": "non-relative",
+	"javascript.preferences.importModuleSpecifier": "non-relative",
+	"files.associations": {
+		"*.json": "jsonc"
+	},
+	"search.exclude": {
+		"**/.git": true,
+		"**/node_modules": true,
+		"**/build": true
+	},
+	"files.exclude": {
+		"**/.git": true,
+		"**/.DS_Store": true,
+		"**/node_modules": true,
+		"**/build": true
+	},
+	"cSpell.words": ["CHATMIX", "Redirections", "steelseries", "Torrisi"]
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Harley Bob Marley
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,121 @@
+# Unofficial - SteelSeries Sonar SDK [![Tests](https://github.com/harley-codes/steelseries-sonar-sdk-js/actions/workflows/tests.yml/badge.svg)](https://github.com/harley-codes/steelseries-sonar-sdk-js/actions/workflows/tests.yml) [![Codecov](https://codecov.io/github/harley-codes/steelseries-sonar-sdk-js/graph/badge.svg?token=TBF8WTZ19B)](https://codecov.io/github/harley-codes/steelseries-sonar-sdk-js)
+
+An SDK for interacting with the SteelSeries Sonar software.
+
+## How It Works
+When Sonar is installed via the SteelSeries GG software - it exposes an API on localhost. The port used is unique every time Sonar is started up. This means the lifecycle of the port can change while you computer is running; depending on logout, app-crash, etc. An entry point in the GG software exposes a second endpoint in the users app data, this endpoint does not change and can be used to get the active endpoint for Sonar.
+
+The SDK provides methods for getting the active Sonar endpoint, along with various wrapper functions to simplify the request/response payloads, along with QOL preferences.
+
+## Credit
+Building this SDK would not have been as simple without the work of [wex/sonar-rev](https://github.com/wex/sonar-rev). Their work on reverse engineering how Sonar works was paramount.
+
+## Known Limitation
+Changes made with this SDK are not immediately visible in the SteelSeries GG software. Both the SDK and GG software communicate directly with the Sonar Service API, but the GG UI does not do any polling to auto-refresh when changes are made externally. To see the latest state in GG, you must close and reopen the GG window.
+
+_I don't think this will matter to anybody - but feel obliged to mention it._
+
+## SDK Usage
+
+#### **Initialize**
+Get the GG endpoint, then get the Sonar endpoint. Getting the Sonar endpoint request can optionally be cached to assist with certain types of application environments. When using the cached option, if an attempt to get the Sonar endpoint fails, the cache timeout will be reset.
+
+```typescript
+const appEndpoint = await getAppEndpoint()
+const sonarEndpoint = await getSonarEndpoint(appEndpoint)
+const sonarEndpoint = await getSonarEndpointCached(appEndpoint, 60 = default)
+```
+
+#### **Audio Mode**
+Sonar can be running in either classic or streamer mode. Depending on this factor, you will need to use different methods when setting or retrieving audio.
+```typescript
+const mode = await getAudioMode(sonarEndpoint)
+const mode = await setAudioMode(sonarEndpoint, AudioMode.Classic)
+```
+
+#### **Audio Data - Classic**
+Get the audio data for Sonar when in classic mode.
+```typescript
+// GET
+const audioData = await getAudioDataClassic(sonarEndpoint)
+const auxData = audioData[AudioChannel.Aux]
+// SET
+const auxData = await setChannelVolumeClassic(sonarEndpoint, 75, AudioChannel.Aux)
+const auxData = await setChannelMuteClassic(sonarEndpoint, false, AudioChannel.Aux)
+```
+
+#### **Audio Data - Streamer**
+Get the audio data for Sonar when in streamer mode. Different to classic, the volume data is nested deeper into a division of 'Streaming' and 'Monitoring'.
+```typescript
+// GET
+const audioData = await getAudioDataStream(sonarEndpoint)
+const auxMonitoringData = audioData
+	[AudioChannel.Aux]
+	[StreamerPath.Monitoring]
+// SET
+const auxData = await setChannelVolumeStreamer(
+	sonarEndpoint, 75,
+	AudioChannel.Aux,
+	StreamerPath.Monitoring)
+const auxData = await setChannelMuteStreamer(
+	sonarEndpoint, false,
+	AudioChannel.Aux,
+	StreamerPath.Monitoring)
+```
+
+#### **CHATMIX**
+You can change the balance between game, and chat output volume. This requires that CHATMIX is available. If the CHATMIX is being controlled via a Sonar DAC for example, it is not available to be changed via software and will throw an exception.
+```typescript
+// GET
+const chatmixData = await getChatMixState(sonarEndpoint)
+// SET
+if (chatmixData.state == ChatMixState.Enabled){
+	const chatmixData = await setChatMixState(sonarEndpoint, 75)
+}
+```
+
+#### **Audio Devices**
+You can get all available audio hardware, and set specific channels to use that device. Additionally you can also target all output channels when passing the target channel parameter.
+```typescript
+// GET
+const allDevices = getAudioDevices(sonarEndpoint)
+const outputDevices = getAudioDevices(sonarEndpoint, DeviceFlow.Output)
+// SET
+const updatedChannel = setAudioDevice(
+	sonarEndpoint,
+	DeviceChannel.Output,
+	outputDevices[0].id)
+```
+
+#### **EQ/Config Profiles**
+Configuration make up all the settings when changing options in a specified channel. This can be useful to switch out EQ balances. When setting a profile, you only need an ID as each profile is unique to Channel.
+```typescript
+// GET
+const selectedProfiles = getSelectedProfiles(sonarEndpoint)
+const selectedAuxProfile = currentProfiles.find(x => x.Channel === ProfileChannel.Aux)
+const favoriteAuxProfiles = getChannelProfiles(sonarEndpoint, ProfileChannel.Aux, true)
+// SET
+const selectedAuxProfile = setSelectedProfile(sonarEndpoint, favoriteAuxProfiles[0].id)
+```
+
+#### **Exception Handling**
+Exceptions are broken up into initialization and requests.
+
+`SonarInitializationException` provides a reason to easily determine if it failed to get the config, or if there is an issue with Sonar.
+```typescript
+catch(error){
+	if(error instanceof SonarInitializationException){
+		console.error({
+			error.message,
+			error.reason,
+			error.innerException
+		})
+	}
+	if(error instanceof SonarRequestException){
+		console.error({
+			error.message,
+			error.innerException
+		})
+	}
+}
+```

package/_.todo

@@ -0,0 +1,4 @@
+TODO: Use the sonar.http file to build better exception classes.
+TODO: Seperate ./test from package - give its own config
+TODO: Better error handling when not in classic or streamer mode
+TODO: Improve set stream audio response type

package/biome.json

@@ -0,0 +1,62 @@
+{
+	"$schema": "https://biomejs.dev/schemas/2.3.11/schema.json",
+	"vcs": {
+		"enabled": true,
+		"clientKind": "git",
+		"useIgnoreFile": true,
+		"defaultBranch": "main"
+	},
+	"files": {
+		"ignoreUnknown": false
+	},
+	"formatter": {
+		"enabled": true,
+		"indentStyle": "tab",
+		"lineEnding": "lf",
+		"lineWidth": 120,
+		"bracketSameLine": false
+	},
+	"linter": {
+		"enabled": true,
+		"rules": {
+			"recommended": true,
+			"suspicious": {
+				"useIsArray": "error"
+			},
+			"style": {
+				"useConsistentCurlyBraces": "error",
+				"useNodejsImportProtocol": "error"
+			},
+			"correctness": {
+				"noUnusedImports": "error",
+				"noPrivateImports": "error"
+			}
+		}
+	},
+	"assist": {
+		"enabled": true,
+		"actions": {
+			"source": {
+				"organizeImports": "on",
+				"useSortedProperties": "on",
+				"useSortedAttributes": "on"
+			}
+		}
+	},
+	"javascript": {
+		"formatter": {
+			"quoteStyle": "single",
+			"semicolons": "asNeeded",
+			"trailingCommas": "none",
+			"arrowParentheses": "always",
+			"bracketSameLine": false,
+			"bracketSpacing": true,
+			"expand": "auto"
+		}
+	},
+	"json": {
+		"formatter": {
+			"trailingCommas": "none"
+		}
+	}
+}

package/http/sonar.http

@@ -0,0 +1,104 @@
+### VS Code HTTP request to /chatMix
+@SONAR_ADDRESS=http://127.0.0.1:52335
+
+############
+# CHANNELS #
+############
+
+### -> GET -> Channel Mode
+GET {{SONAR_ADDRESS}}/mode
+
+### -> SET -> Channel Mode - Classic
+PUT {{SONAR_ADDRESS}}/mode/classic
+
+### -> SET -> Channel Mode - Streamer
+PUT {{SONAR_ADDRESS}}/mode/stream
+
+### -> GET -> Volume Settings - Classic
+GET {{SONAR_ADDRESS}}/volumeSettings/classic
+
+### -> GET -> Volume Settings - Streamer
+GET {{SONAR_ADDRESS}}/volumeSettings/streamer
+
+### -> SET -> Volume Level - Classic - Master - 50%
+PUT {{SONAR_ADDRESS}}/volumeSettings/classic/Master/volume/0.5
+
+### -> SET -> Volume Level - Classic - Mute - TRUE
+PUT {{SONAR_ADDRESS}}/volumeSettings/classic/Master/mute/true
+
+### -> SET -> Volume Level - Classic - Mute - FALSE
+PUT {{SONAR_ADDRESS}}/volumeSettings/classic/Master/mute/false
+
+### -> SET -> Volume Level - Streamer - Monitoring - Master - 50%
+PUT {{SONAR_ADDRESS}}/volumeSettings/streamer/monitoring/master/volume/0.5
+
+### -> SET -> Volume Level - Streamer - Streaming - Master - 50%
+PUT {{SONAR_ADDRESS}}/volumeSettings/streamer/streaming/master/volume/0.5
+
+### -> SET -> Mute - Master - true
+PUT {{SONAR_ADDRESS}}/volumeSettings/classic/master/mute/false
+
+### -> SET -> Mute - Streamer - Streaming - true
+PUT {{SONAR_ADDRESS}}/volumeSettings/streamer/streaming/master/isMuted/false
+
+
+###########
+# CHATMIX #
+###########
+
+### -> GET -> ChatMix
+GET {{SONAR_ADDRESS}}/chatMix
+# {
+#   "state": "enabled", "finiteWheel", "differentDeviceSelected", "noDeviceSelected"
+# }
+
+### -> SET -> ChatMix - 70% Game, 30% Chat
+PUT {{SONAR_ADDRESS}}/chatMix?balance=0.3
+
+#############
+# Equalizer #
+#############
+
+### -> GET -> EQ Presets - Active
+GET {{SONAR_ADDRESS}}/configs/selected
+
+### -> GET -> EQ Presets
+GET {{SONAR_ADDRESS}}/configs
+
+### -> GET -> EQ Presets - GAME
+GET {{SONAR_ADDRESS}}/configs?vad=game
+
+### -> SET -> EQ Preset - AUX - Music: Bright
+PUT {{SONAR_ADDRESS}}/configs/c75b5225-041c-430a-abda-dd27bbbe9485/select
+
+############
+# Hardware #
+############
+
+### -> GET -> Audio Devices
+GET {{SONAR_ADDRESS}}/audioDevices
+
+### -> GET -> Audio Devices | Assignable
+GET {{SONAR_ADDRESS}}/audioDevices?removeSteelSeriesVAD=true
+
+### -> GET -> Device - Active
+GET {{SONAR_ADDRESS}}/classicRedirections
+
+### -> SET -> Device - Game - Speakers
+PUT {{SONAR_ADDRESS}}/ClassicRedirections/game/deviceId/{0.0.0.00000000}.{0e5b2eb2-8d10-4e5f-b757-59a3e15def98}
+
+### -> SET -> Device - Game - Headset
+PUT {{SONAR_ADDRESS}}/ClassicRedirections/game/deviceId/{0.0.0.00000000}.{a555a65a-c167-480e-8825-220ccbe42b82}
+
+### -> SET -> Device - Audio Out - Speakers
+PUT {{SONAR_ADDRESS}}/ClassicRedirections/render/deviceId/{0.0.0.00000000}.{0e5b2eb2-8d10-4e5f-b757-59a3e15def98}
+
+### -> SET -> Device - Audio Out - Headset
+PUT {{SONAR_ADDRESS}}/ClassicRedirections/render/deviceId/{0.0.0.00000000}.{a555a65a-c167-480e-8825-220ccbe42b82}
+
+###########
+# Devices #
+###########
+
+### -> GET -> Audio Devices
+GET {{SONAR_ADDRESS}}/volumeSettings/devices/volumes

package/package.json

@@ -0,0 +1,31 @@
+{
+	"name": "steelseries-sonar-sdk",
+	"version": "0.1.1",
+	"description": "An SDK for interacting with the SteelSeries Sonar software.",
+	"author": "Harley Torrisi <mail@harleycodes.com>",
+	"license": "MIT",
+	"type": "module",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/harley-codes/steelseries-sonar-sdk-js"
+	},
+	"module": "./src/index.ts",
+	"devDependencies": {
+		"@biomejs/biome": "2.3.11",
+		"@types/bun": "latest",
+		"globals": "^17.0.0"
+	},
+	"peerDependencies": {
+		"typescript": "^5"
+	},
+	"scripts": {
+		"lint": "biome lint",
+		"lint-fix": "biome check --write",
+		"test-e2e": "bun test ./tests/e2e/**/*.test.ts",
+		"test-e2e-endpoint": "bun test ./tests/e2e/**/*.test.ts -t getSonarEndpoint",
+		"test-unit": "bun test ./tests/unit/**/*.test.ts",
+		"test-all": "bun test-unit && bun test-e2e",
+		"package": "bun build ./src/index.ts --outdir=./dist --target node",
+		"package-minify": "bun build ./src/index.ts --outdir=./dist --minify --target node"
+	}
+}

package/src/consts/fetch-options-put.ts

@@ -0,0 +1,3 @@
+export const FETCH_OPTIONS_PUT = {
+	method: 'PUT'
+} as const

package/src/enums.ts

@@ -0,0 +1,88 @@
+/**
+ * Sonar audio mixing channels.
+ * @property {@link AudioChannel.Master} - Master volume channel.
+ * @property {@link AudioChannel.Game} - Game audio channel.
+ * @property {@link AudioChannel.Chat} - Chat audio channel.
+ * @property {@link AudioChannel.Media} - Media audio channel.
+ * @property {@link AudioChannel.Aux} - Auxiliary audio channel.
+ * @property {@link AudioChannel.Mic} - Microphone audio channel.
+ */
+export enum AudioChannel {
+	Master = 'master',
+	Game = 'game',
+	Chat = 'chat',
+	Media = 'media',
+	Aux = 'aux',
+	Mic = 'mic'
+}
+
+// TODO: Sort this channel duplication nonsense out.
+export enum ProfileChannel {
+	Game = 'game',
+	Chat = 'chat',
+	Media = 'media',
+	Aux = 'aux',
+	Mic = 'mic'
+}
+
+/**
+ * Sonar device channels.
+ * @property {@link DeviceChannel.Output} - All output channels.
+ * @property {@link DeviceChannel.Game} - Game output channel.
+ * @property {@link DeviceChannel.Chat} - Chat output channel.
+ * @property {@link DeviceChannel.Media} - Media output channel.
+ * @property {@link DeviceChannel.Aux} - Auxiliary output channel.
+ * @property {@link DeviceChannel.Mic} - Microphone input channel.
+ */
+export enum DeviceChannel {
+	Output = 'render',
+	Game = 'game',
+	Chat = 'chat',
+	Media = 'media',
+	Aux = 'aux',
+	Mic = 'mic'
+}
+
+/**
+ * Sonar Streamer Mode path.
+ * @property {@link StreamerPath.Streaming} - What the audience will hear.
+ * @property {@link StreamerPath.Monitoring} - What the owner will hear.
+ */
+export enum StreamerPath {
+	Streaming = 'streaming',
+	Monitoring = 'monitoring'
+}
+
+/**
+ * Sonar mixing state.
+ * @property {@link AudioMode.Classic} - Basic mixing.
+ * @property {@link AudioMode.Streamer} - Advanced mixing - has stream/monitor path each channel.
+ */
+export enum AudioMode {
+	Classic = 'classic',
+	Streamer = 'stream'
+}
+
+/**
+ * The state of CHATMIX availability.
+ * @property {@link ChatMixState.Enabled} - CHATMIX is enabled and available.
+ * @property {@link ChatMixState.FiniteWheel} - CHATMIX is available but the user cannot interact with it via software.
+ * @property {@link ChatMixState.DifferentDeviceSelected} - CHATMIX is unavailable because a different output device is selected.
+ * @property {@link ChatMixState.NoDeviceSelected} - CHATMIX is unavailable because no output device is selected.
+ */
+export enum ChatMixState {
+	Enabled = 'enabled',
+	FiniteWheel = 'finiteWheel',
+	DifferentDeviceSelected = 'differentDeviceSelected',
+	NoDeviceSelected = 'noDeviceSelected'
+}
+
+/**
+ * Type of audio device.
+ * @property {@link DeviceFlow.Output} - Device used to render audio (e.g. speakers, headphones).
+ * @property {@link DeviceFlow.Input} - Device used to capture audio (e.g. microphones).
+ */
+export enum DeviceFlow {
+	Output = 'output',
+	Input = 'input'
+}

package/src/exceptions.ts

@@ -0,0 +1,45 @@
+type RequestErrorProps = {
+	message?: string
+	innerException?: Error
+}
+
+export enum InitializeErrorReason {
+	BadConfig = 'Bad Config',
+	OSUnsupported = 'OS Unsupported',
+	NotEnabled = 'Not Enabled',
+	NotRunning = 'Not Running',
+	NotReady = 'Not Ready',
+	NotResponding = 'Not Responding',
+	NotAvailable = 'Not Available'
+}
+
+type InitializeErrorProps = {
+	message?: string
+	innerException?: Error
+	reason: InitializeErrorReason
+}
+
+/** Base exception for all handled Sonar related exception. */
+export abstract class SonarException extends Error {
+	constructor(message: string, cause?: Error) {
+		super(message, { cause })
+		super.name = new.target.name
+	}
+}
+
+/** Thrown when the server responds in an unexpected way. */
+export class SonarRequestException extends SonarException {
+	constructor(error?: RequestErrorProps) {
+		super(error?.message ?? 'There was an issue communicating with the Sonar service.', error?.innerException)
+	}
+}
+
+/** Thrown when the server cannot be determined. */
+export class SonarInitializationException extends SonarException {
+	public reason: InitializeErrorReason
+	constructor(error: InitializeErrorProps) {
+		const message = `${error?.message ?? `There was an issue finding the Sonar service: ${error.reason}.`}${error?.innerException ? ' See inner exception.' : ''}`
+		super(message, error?.innerException)
+		this.reason = error.reason
+	}
+}

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

@@ -0,0 +1,31 @@
+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

@@ -0,0 +1,37 @@
+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

@@ -0,0 +1,11 @@
+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

@@ -0,0 +1,12 @@
+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)
+}