appium-ios-remotexpc 0.0.2 → 0.0.4

package/test/unit/apple-tv/utils/buffer-utils.spec.ts

@@ -1,74 +0,0 @@
-import { expect } from 'chai';
-
-import {
-  bigIntToBuffer,
-  bigIntToMinimalBuffer,
-  bufferToBigInt,
-  modPow,
-} from '../../../../src/lib/apple-tv/utils/buffer-utils.js';
-
-describe('buffer-utils', () => {
-  describe('bigIntToBuffer', () => {
-    it('should convert bigint to fixed-length buffer', () => {
-      const result = bigIntToBuffer(255n, 4);
-      expect(result).to.deep.equal(Buffer.from([0x00, 0x00, 0x00, 0xff]));
-    });
-
-    it('should throw error for negative values', () => {
-      expect(() => bigIntToBuffer(-1n, 4)).to.throw(
-        RangeError,
-        'Negative values not supported',
-      );
-    });
-
-    it('should throw error when value is too large', () => {
-      expect(() => bigIntToBuffer(0xffffn, 1)).to.throw(
-        RangeError,
-        'too large to fit',
-      );
-    });
-  });
-
-  describe('bufferToBigInt', () => {
-    it('should convert buffer to bigint', () => {
-      const buffer = Buffer.from([0x01, 0x02, 0x03]);
-      const result = bufferToBigInt(buffer);
-      expect(result).to.equal(0x010203n);
-    });
-  });
-
-  describe('bigIntToMinimalBuffer', () => {
-    it('should convert bigint to minimal buffer', () => {
-      const result = bigIntToMinimalBuffer(255n);
-      expect(result).to.deep.equal(Buffer.from([0xff]));
-    });
-
-    it('should throw error for negative values', () => {
-      expect(() => bigIntToMinimalBuffer(-1n)).to.throw(
-        RangeError,
-        'Negative values not supported',
-      );
-    });
-  });
-
-  describe('modPow', () => {
-    it('should compute modular exponentiation', () => {
-      const result = modPow(2n, 3n, 5n);
-      expect(result).to.equal(3n); // (2^3) % 5 = 8 % 5 = 3
-    });
-
-    it('should throw error for zero modulus', () => {
-      expect(() => modPow(2n, 3n, 0n)).to.throw(
-        RangeError,
-        'Modulus must be non-zero',
-      );
-    });
-
-    it('should throw error for negative exponent', () => {
-      expect(() => modPow(2n, -1n, 5n)).to.throw(
-        RangeError,
-        'Negative exponents not supported',
-      );
-    });
-  });
-});

package/test/unit/apple-tv/utils/uuid-generator.spec.ts

@@ -1,39 +0,0 @@
-import { expect } from 'chai';
-
-import { generateHostId } from '../../../../src/lib/apple-tv/utils/uuid-generator.js';
-
-describe('uuid-generator', () => {
-  describe('generateHostId', () => {
-    it('should generate deterministic UUID from hostname', () => {
-      const hostname = 'example.com';
-      const uuid1 = generateHostId(hostname);
-      const uuid2 = generateHostId(hostname);
-
-      expect(uuid1).to.equal(uuid2);
-      expect(uuid1).to.match(
-        /^[0-9A-F]{8}-[0-9A-F]{4}-3[0-9A-F]{3}-[89AB][0-9A-F]{3}-[0-9A-F]{12}$/,
-      );
-    });
-
-    it('should generate different UUIDs for different hostnames', () => {
-      const uuid1 = generateHostId('example.com');
-      const uuid2 = generateHostId('test.com');
-
-      expect(uuid1).to.not.equal(uuid2);
-    });
-
-    it('should throw error for empty string', () => {
-      expect(() => generateHostId('')).to.throw(
-        TypeError,
-        'Hostname must be a non-empty string',
-      );
-    });
-
-    it('should throw error for non-string input', () => {
-      expect(() => generateHostId(null as any)).to.throw(
-        TypeError,
-        'Hostname must be a non-empty string',
-      );
-    });
-  });
-});

package/test/unit/fixtures/index.ts

@@ -1,88 +0,0 @@
-import { fs, logger } from '@appium/support';
-import { Server, Socket, createConnection, createServer } from 'node:net';
-import { resolve } from 'node:path';
-
-const log = logger.getLogger('fixtures');
-
-export const UDID = '63c3d055c4f83e960e5980fa68be0fbf7d4ba74c';
-
-let fixtureContents: Record<string, Buffer> | null = null;
-
-export const fixtures = {
-  DEVICE_LIST: 'deviceList',
-  DEVICE_LIST_2: 'deviceList2',
-  DEVICE_CONNECT: 'deviceConnect',
-  USBMUX_TO_LOCKDOWN: 'usbmuxToLockdown',
-  LOCKDOWN_GET_VALUE_OS_VERSION: 'lockdownGetValueOsVersion',
-  LOCKDOWN_GET_VALUE_TIME: 'lockdownGetValueTime',
-  LOCKDOWN_QUERY_TYPE: 'lockdownQueryType',
-  SYSLOG_MESSAGES: 'syslogMessage',
-  SYSLOG_SPLIT_MESSAGE_1: 'syslogSplitMessage1',
-  SYSLOG_SPLIT_MESSAGE_2: 'syslogSplitMessage2',
-  WEBINSPECTOR_MESSAGES: 'webinspector',
-  WEBINSPECTOR_PARTIAL_MESSAGES: 'webinspectorPartialMessages',
-  INSTALLATION_PROXY_LIST_MESSAGE: 'installationProxyListMessage',
-  INSTALLATION_PROXY_INSTALL_MESSAGE: 'installationProxyInstallMessage',
-  AFC_SUCCESS_RESPONSE: 'afcSuccessResponse',
-  AFC_LIST_DIR_RESPONSE: 'afcListDirResponse',
-  AFC_FILE_INFO_RESPONSE: 'afcFileInfoResponse',
-  INSTRUMENTS_LAUNCH_APP: 'instrumentsLaunchApp',
-  INSTRUMENTS_FPS: 'instrumentsFps',
-};
-
-function getFixturePath(file: string): string {
-  return resolve(__dirname, file);
-}
-
-async function initFixtures(): Promise<void> {
-  if (fixtureContents) {
-    return;
-  }
-
-  fixtureContents = {
-    [fixtures.DEVICE_LIST]: await fs.readFile(
-      getFixturePath('usbmuxlistdevicemessage.bin'),
-    ),
-    [fixtures.DEVICE_CONNECT]: await fs.readFile(
-      getFixturePath('usbmuxconnectmessage.bin'),
-    ),
-  };
-}
-
-interface ServerFixtureResult {
-  server: Server;
-  socket: Socket;
-}
-
-export async function getServerWithFixtures(
-  ...args: string[]
-): Promise<ServerFixtureResult> {
-  await initFixtures();
-
-  if (!fixtureContents) {
-    throw new Error('Fixtures not initialized');
-  }
-  const fixturesToUse = args.map((key) => fixtureContents![key]);
-
-  const server = createServer();
-  server.listen();
-  const address = server.address();
-  if (!address || typeof address === 'string') {
-    throw new Error('Invalid server address');
-  }
-  const socket = createConnection(address.port);
-  server.on('connection', function (socket) {
-    let i = 0;
-    socket.on('data', function () {
-      if (i < fixturesToUse.length) {
-        log.debug(`Writing to socket. Message #${i}`);
-        socket.write(fixturesToUse[i++]);
-        log.debug(`Wrote to socket. Message #${i}`);
-      }
-    });
-  });
-  return {
-    server,
-    socket,
-  };
-}

package/test/unit/plist/error-handling.spec.ts

@@ -1,101 +0,0 @@
-import { expect } from 'chai';
-
-import { parsePlist as parseXmlPlist } from '../../../src/lib/plist/plist-parser.js';
-import { parsePlist as unifiedParsePlist } from '../../../src/lib/plist/unified-plist-parser.js';
-import type { PlistDictionary } from '../../../src/lib/types.js';
-
-describe('XML Error Handling', function () {
-  describe('Unicode Replacement Character Handling', function () {
-    it('should handle Unicode replacement characters at the beginning', function () {
-      const xml =
-        '�<?xml version="1.0" encoding="UTF-8"?><plist><dict><key>test</key><string>value</string></dict></plist>';
-      const result = parseXmlPlist(xml) as PlistDictionary;
-      expect(result).to.have.property('test', 'value');
-    });
-
-    it('should handle Unicode replacement characters at the end', function () {
-      const xml =
-        '<?xml version="1.0" encoding="UTF-8"?><plist><dict><key>test</key><string>value</string></dict></plist>�';
-      const result = parseXmlPlist(xml) as PlistDictionary;
-      expect(result).to.have.property('test', 'value');
-    });
-
-    it('should handle Unicode replacement characters between tags', function () {
-      const xml =
-        '<?xml version="1.0" encoding="UTF-8"?><plist>�<dict><key>test</key><string>value</string></dict></plist>';
-      const result = parseXmlPlist(xml) as PlistDictionary;
-      expect(result).to.have.property('test', 'value');
-    });
-  });
-
-  describe('Extra Content Handling', function () {
-    it('should handle extra content at the end of the document', function () {
-      const xml =
-        '<?xml version="1.0" encoding="UTF-8"?><plist><dict><key>test</key><string>value</string></dict></plist>extra content';
-
-      const result = parseXmlPlist(xml) as PlistDictionary;
-      expect(result).to.have.property('test', 'value');
-    });
-
-    it('should handle extra content before the XML declaration', function () {
-      const xml =
-        'extra content<?xml version="1.0" encoding="UTF-8"?><plist><dict><key>test</key><string>value</string></dict></plist>';
-      const result = parseXmlPlist(xml) as PlistDictionary;
-      expect(result).to.have.property('test', 'value');
-    });
-  });
-
-  describe('Unclosed Tags Handling', function () {
-    it('should handle unclosed plist tag', function () {
-      const xml =
-        '<?xml version="1.0" encoding="UTF-8"?><plist><dict><key>test</key><string>value</string></dict>';
-
-      try {
-        parseXmlPlist(xml);
-        expect.fail('Should have thrown an error for unclosed plist tag');
-      } catch (error) {
-        expect(error).to.exist;
-      }
-    });
-
-    it('should handle unclosed dict tag', function () {
-      const xml =
-        '<?xml version="1.0" encoding="UTF-8"?><plist><dict><key>test</key><string>value</string></plist>';
-
-      try {
-        parseXmlPlist(xml);
-        expect.fail('Should have thrown an error for unclosed dict tag');
-      } catch (error) {
-        expect(error).to.exist;
-      }
-    });
-  });
-
-  describe('Combined Error Scenarios', function () {
-    it('should handle both Unicode replacement characters and extra content', function () {
-      const xml =
-        '�<?xml version="1.0" encoding="UTF-8"?><plist><dict><key>test</key><string>value</string></dict></plist>extra content';
-
-      const result = parseXmlPlist(xml) as PlistDictionary;
-      expect(result).to.have.property('test', 'value');
-    });
-
-    it('should handle multiple Unicode replacement characters', function () {
-      const xml =
-        '�<?xml version="1.0" encoding="UTF-8"?>�<plist><dict><key>test</key><string>value</string></dict></plist>�';
-
-      const result = parseXmlPlist(xml) as PlistDictionary;
-      expect(result).to.have.property('test', 'value');
-    });
-  });
-
-  describe('Unified Parser Error Handling', function () {
-    it('should handle errors in the unified parser for XML content', function () {
-      const xml =
-        '�<?xml version="1.0" encoding="UTF-8"?><plist><dict><key>test</key><string>value</string></dict></plist>extra content';
-
-      const result = unifiedParsePlist(xml) as PlistDictionary;
-      expect(result).to.have.property('test', 'value');
-    });
-  });
-});

package/test/unit/plist/fixtures/sample.xml.plist

@@ -1,38 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-    <key>stringValue</key>
-    <string>Hello, World!</string>
-    <key>integerValue</key>
-    <integer>42</integer>
-    <key>realValue</key>
-    <real>3.14159</real>
-    <key>booleanTrue</key>
-    <true/>
-    <key>booleanFalse</key>
-    <false/>
-    <key>dateValue</key>
-    <date>2023-01-01T12:00:00Z</date>
-    <key>dataValue</key>
-    <data>SGVsbG8sIFdvcmxkIQ==</data>
-    <key>arrayValue</key>
-    <array>
-        <string>Item 1</string>
-        <string>Item 2</string>
-        <integer>3</integer>
-    </array>
-    <key>dictValue</key>
-    <dict>
-        <key>nestedKey</key>
-        <string>Nested Value</string>
-        <key>nestedArray</key>
-        <array>
-            <integer>1</integer>
-            <integer>2</integer>
-        </array>
-    </dict>
-    <key>specialChars</key>
-    <string>&lt;Hello &amp; World&gt;</string>
-</dict>
-</plist>

package/test/unit/plist/plist-parser.spec.ts

@@ -1,283 +0,0 @@
-import { expect } from 'chai';
-
-import { parsePlist as parseXmlPlist } from '../../../src/lib/plist/plist-parser.js';
-import {
-  findFirstReplacementCharacter,
-  fixMultipleXmlDeclarations,
-  hasUnicodeReplacementCharacter,
-  isValidXml,
-  trimBeforeXmlDeclaration,
-} from '../../../src/lib/plist/utils.js';
-import type {
-  PlistArray,
-  PlistDictionary,
-  PlistValue,
-} from '../../../src/lib/types.js';
-
-describe('Plist Parser', function () {
-  describe('XML Cleaning Logic', function () {
-    it('should detect Unicode replacement characters', function () {
-      const validXml =
-        '<?xml version="1.0" encoding="UTF-8"?><plist><dict><key>test</key><string>value</string></dict></plist>';
-      const invalidXml =
-        '<?xml version="1.0" encoding="UTF-8"?><plist><dict><key>test</key><string>val�ue</string></dict></plist>';
-
-      expect(hasUnicodeReplacementCharacter(validXml)).to.be.false;
-      expect(hasUnicodeReplacementCharacter(invalidXml)).to.be.true;
-    });
-
-    it('should find the position of the first replacement character', function () {
-      const xml =
-        '<?xml version="1.0" encoding="UTF-8"?><plist><dict><key>test</key><string>val�ue</string></dict></plist>';
-      const position = findFirstReplacementCharacter(xml);
-
-      expect(position).to.equal(xml.indexOf('�'));
-      expect(position).to.be.greaterThan(0);
-    });
-
-    it('should handle the case where there is no tag before the replacement character', function () {
-      const xml =
-        '�<?xml version="1.0" encoding="UTF-8"?><plist><dict><key>test</key><string>value</string></dict></plist>';
-
-      const result = parseXmlPlist(xml);
-
-      expect(result).to.have.property('test', 'value');
-    });
-
-    it('should handle the case where there is no tag after the replacement character', function () {
-      const xml =
-        '<?xml version="1.0" encoding="UTF-8"?><plist><dict><key>test</key><string>value</string></dict></plist>�';
-
-      const result = parseXmlPlist(xml);
-
-      expect(result).to.have.property('test', 'value');
-    });
-  });
-
-  describe('XML Preprocessing Functions', function () {
-    it('should trim content before XML declaration', function () {
-      const xml =
-        'garbage data<?xml version="1.0" encoding="UTF-8"?><plist></plist>';
-      const trimmed = trimBeforeXmlDeclaration(xml);
-
-      expect(trimmed).to.equal(
-        '<?xml version="1.0" encoding="UTF-8"?><plist></plist>',
-      );
-    });
-
-    it('should fix multiple XML declarations', function () {
-      const xml =
-        '<?xml version="1.0" encoding="UTF-8"?><some-tag><?xml version="1.1"?><plist></plist>';
-      const fixed = fixMultipleXmlDeclarations(xml);
-
-      expect(fixed).to.include('<?xml version="1.0" encoding="UTF-8"?>');
-      expect(fixed).to.include('<some-tag>');
-      expect(fixed).to.include('<plist></plist>');
-      expect(fixed).not.to.include('<?xml version="1.1"?>');
-    });
-
-    it('should validate XML content', function () {
-      expect(isValidXml('<?xml version="1.0"?><plist></plist>')).to.be.true;
-      expect(isValidXml('')).to.be.false;
-      expect(isValidXml('  ')).to.be.false;
-      expect(isValidXml('not xml')).to.be.false;
-    });
-  });
-
-  describe('Error Handling', function () {
-    it('should handle completely invalid XML', function () {
-      try {
-        parseXmlPlist('not xml at all');
-        expect.fail('Should have thrown an error for invalid XML');
-      } catch (error) {
-        expect(error).to.exist;
-      }
-    });
-
-    it('should handle XML without a plist element', function () {
-      try {
-        parseXmlPlist('<?xml version="1.0"?><not-a-plist></not-a-plist>');
-        expect.fail('Should have thrown an error for missing plist element');
-      } catch (error) {
-        expect(error).to.exist;
-      }
-    });
-
-    it('should handle XML with malformed tags', function () {
-      try {
-        parseXmlPlist(
-          '<?xml version="1.0"?><plist><dict><key>test</key><string>value</string></dict>',
-        );
-        expect.fail('Should have thrown an error for malformed tags');
-      } catch (error) {
-        expect(error).to.exist;
-      }
-    });
-  });
-
-  describe('Complex XML Structures', function () {
-    it('should parse nested dictionaries correctly', function () {
-      const xml = `
-        <?xml version="1.0" encoding="UTF-8"?>
-        <plist version="1.0">
-        <dict>
-          <key>level1</key>
-          <dict>
-            <key>level2</key>
-            <dict>
-              <key>level3</key>
-              <string>deep value</string>
-            </dict>
-          </dict>
-        </dict>
-        </plist>
-      `;
-
-      const result = parseXmlPlist(xml);
-      expect(result).to.have.property('level1');
-
-      // Type assertions for nested properties
-      const level1 = result.level1 as PlistDictionary;
-      expect(level1).to.have.property('level2');
-
-      const level2 = level1.level2 as PlistDictionary;
-      expect(level2).to.have.property('level3', 'deep value');
-    });
-
-    it('should parse mixed arrays and dictionaries', function () {
-      const xml = `
-        <?xml version="1.0" encoding="UTF-8"?>
-        <plist version="1.0">
-        <dict>
-          <key>mixedArray</key>
-          <array>
-            <string>text</string>
-            <integer>123</integer>
-            <dict>
-              <key>nestedKey</key>
-              <string>nestedValue</string>
-            </dict>
-          </array>
-        </dict>
-        </plist>
-      `;
-
-      const result = parseXmlPlist(xml);
-      expect(result).to.have.property('mixedArray').that.is.an('array');
-
-      // Type assertion for array
-      const mixedArray = result.mixedArray as PlistArray;
-      expect(mixedArray).to.have.lengthOf(3);
-      expect(mixedArray[0]).to.equal('text');
-      expect(mixedArray[1]).to.equal(123);
-
-      // Type assertion for nested object in array
-      const nestedObj = mixedArray[2] as PlistDictionary;
-      expect(nestedObj).to.have.property('nestedKey', 'nestedValue');
-    });
-
-    it('should handle XML with comments', function () {
-      const xml = `
-        <?xml version="1.0" encoding="UTF-8"?>
-        <plist version="1.0">
-        <dict>
-          <!-- This is a comment -->
-          <key>commentedKey</key>
-          <string>value</string>
-        </dict>
-        </plist>
-      `;
-
-      const result = parseXmlPlist(xml);
-      expect(result).to.have.property('commentedKey', 'value');
-    });
-
-    it('should handle XML with CDATA sections', function () {
-      const xml = `
-        <?xml version="1.0" encoding="UTF-8"?>
-        <plist version="1.0">
-        <dict>
-          <key>cdataKey</key>
-          <string><![CDATA[<html>This is HTML content</html>]]></string>
-        </dict>
-        </plist>
-      `;
-
-      const result = parseXmlPlist(xml);
-      expect(result).to.have.property(
-        'cdataKey',
-        '<html>This is HTML content</html>',
-      );
-    });
-  });
-
-  describe('Special Data Types', function () {
-    it('should parse date values correctly', function () {
-      const xml = `
-        <?xml version="1.0" encoding="UTF-8"?>
-        <plist version="1.0">
-        <dict>
-          <key>dateKey</key>
-          <date>2023-05-21T12:34:56Z</date>
-        </dict>
-        </plist>
-      `;
-
-      const result = parseXmlPlist(xml);
-      expect(result).to.have.property('dateKey');
-
-      // Type assertion for date
-      const dateValue = result.dateKey as Date;
-      expect(dateValue).to.be.instanceOf(Date);
-      expect(dateValue.toISOString()).to.equal('2023-05-21T12:34:56.000Z');
-    });
-
-    it('should parse data values correctly', function () {
-      const xml = `
-        <?xml version="1.0" encoding="UTF-8"?>
-        <plist version="1.0">
-        <dict>
-          <key>dataKey</key>
-          <data>SGVsbG8gV29ybGQ=</data>
-        </dict>
-        </plist>
-      `;
-
-      const result = parseXmlPlist(xml);
-      expect(result).to.have.property('dataKey');
-
-      // Type assertion for buffer
-      const dataValue = result.dataKey as Buffer;
-      expect(Buffer.isBuffer(dataValue)).to.be.true;
-      expect(dataValue.toString()).to.equal('Hello World');
-    });
-
-    it('should handle empty elements correctly', function () {
-      const xml = `
-        <?xml version="1.0" encoding="UTF-8"?>
-        <plist version="1.0">
-        <dict>
-          <key>emptyString</key>
-          <string></string>
-          <key>emptyArray</key>
-          <array></array>
-          <key>emptyDict</key>
-          <dict></dict>
-        </dict>
-        </plist>
-      `;
-
-      const result = parseXmlPlist(xml);
-      expect(result).to.have.property('emptyString', '');
-      expect(result)
-        .to.have.property('emptyArray')
-        .that.is.an('array')
-        .with.lengthOf(0);
-      expect(result).to.have.property('emptyDict').that.is.an('object');
-
-      // Type assertion for empty dictionary
-      const emptyDict = result.emptyDict as PlistDictionary;
-      expect(Object.keys(emptyDict)).to.have.lengthOf(0);
-    });
-  });
-});