A free and open source instant messaging and VoIP chat app built for friends, groups, and communities.
// SPDX-License-Identifier: AGPL-3.0-or-later
import {parseReportedClientApp, parseReportedClientOs} from '@app/api/utils/SessionClientIdentity';
import {describe, expect, it} from 'vitest';
describe('reported session operating system', () => {
it.each([
{json: '{"os":"android"}', expected: 'android'},
{json: '{"os":"ios"}', expected: 'ios'},
{json: '{"os":"macos"}', expected: 'macos'},
{json: '{"os":"windows"}', expected: 'windows'},
{json: '{"os":"linux"}', expected: 'linux'},
{json: '{"os":"Android"}', expected: null},
{json: '{"os":"unknown"}', expected: null},
{json: '{"os":"__proto__"}', expected: null},
{json: '{"os":"constructor"}', expected: null},
{json: '{"os":null}', expected: null},
{json: '{"os":1}', expected: null},
{json: '{"__proto__":{"os":"linux"}}', expected: null},
{json: '{}', expected: null},
{json: '[{"os":"linux"}]', expected: null},
{json: '"linux"', expected: null},
{json: 'null', expected: null},
{json: '{"os":', expected: null},
])('decodes $json as $expected', ({json, expected}) => {
expect(parseReportedClientOs(Buffer.from(json).toString('base64'))).toBe(expected);
});
it.each([
{header: null, expected: null},
{header: '', expected: null},
{header: ' \t ', expected: null},
{header: '!@#$', expected: null},
{header: '/w==', expected: null},
{header: ' eyJvcyI6ImxpbnV4In0= \n', expected: 'linux'},
])('handles header $header', ({header, expected}) => {
expect(parseReportedClientOs(header)).toBe(expected);
});
it.each([
{padding: 4076, expected: 'linux'},
{padding: 4077, expected: null},
])('bounds a valid padded header with $padding internal spaces', ({padding, expected}) => {
const header = `e${' '.repeat(padding)}yJvcyI6ImxpbnV4In0=`;
expect(parseReportedClientOs(header)).toBe(expected);
});
});
describe('reported native app build', () => {
const encode = (value: unknown) => Buffer.from(JSON.stringify(value)).toString('base64');
it.each([
{
properties: {
client_platform: 'ios',
client_version: '2026.10.100',
release_channel: 'beta',
build_number: 412,
beta_number: 14,
},
expected: {platform: 'ios', version: '2026.10.100', releaseChannel: 'beta', buildNumber: 412, betaNumber: 14},
},
{
properties: {client_platform: 'android', release_channel: 'stable', build_number: 90, beta_number: 3},
expected: {platform: 'android', version: null, releaseChannel: 'stable', buildNumber: 90, betaNumber: null},
},
{
properties: {
client_platform: 'iOS',
client_version: '2026.10.100-beta',
release_channel: 'nightly',
build_number: 1.5,
},
expected: null,
},
{
properties: {client_platform: 'ios', build_number: -1, client_version: 'x'.repeat(40)},
expected: {platform: 'ios', version: null, releaseChannel: null, buildNumber: null, betaNumber: null},
},
{properties: {build_number: 2 ** 31}, expected: null},
{properties: {build_number: '412'}, expected: null},
{properties: [], expected: null},
])('reads $properties', ({properties, expected}) => {
expect(parseReportedClientApp(encode(properties))).toEqual(expected);
});
});