Skip to content

A full-featured download manager.

2.8 KB
Raw Blame
import { describe, expect, it } from 'vitest'
import {
  BridgeQueries,
  type ClientIdentity,
  clientKey,
  makeSessionKey,
  PairAppCodes,
  pairRequestKey,
} from './bridge'

describe('clientKey', () => {
  it('is byte-identical to makeSessionKey for the extension kind', () => {
    const identity: ClientIdentity = {
      kind: 'extension',
      browser: 'chromium',
      extensionId: 'abcdefabcdefabcdefabcdefabcdefab',
    }
    expect(clientKey(identity)).toBe(
      makeSessionKey(identity.browser, identity.extensionId)
    )
    expect(clientKey(identity)).toBe(
      'chromium:abcdefabcdefabcdefabcdefabcdefab'
    )
  })

  it('composes browser and extensionId for the firefox kind', () => {
    const identity: ClientIdentity = {
      kind: 'extension',
      browser: 'firefox',
      extensionId: '[email protected]',
    }
    expect(clientKey(identity)).toBe('firefox:[email protected]')
  })

  it('namespaces the cli kind under a cli: prefix', () => {
    const identity: ClientIdentity = { kind: 'cli', id: 'local' }
    expect(clientKey(identity)).toBe('cli:local')
  })

  it('never collides a cli key with an extension key', () => {
    const cli: ClientIdentity = { kind: 'cli', id: 'chromium:abc' }
    const ext: ClientIdentity = {
      kind: 'extension',
      browser: 'chromium',
      extensionId: 'abc',
    }
    // Even an adversarial cli id that mimics the extension key shape is
    // disambiguated by the cli: prefix.
    expect(clientKey(cli)).not.toBe(clientKey(ext))
  })
})

describe('pending-pair-inbox protocol additions', () => {
  it('exposes the ListPendingPairRequests query channel', () => {
    expect(BridgeQueries.ListPendingPairRequests).toBe(
      'bridge:listPendingPairRequests'
    )
  })

  it('exposes the pair appCode constants', () => {
    expect(PairAppCodes.Unavailable).toBe('pair.request.unavailable')
    expect(PairAppCodes.RateLimited).toBe('pair.request.rateLimited')
  })
})

describe('pairRequestKey', () => {
  it('formats a cli key with a cli: prefix followed by the requestId', () => {
    expect(pairRequestKey({ kind: 'cli', requestId: 'abc123' })).toBe(
      'cli:abc123'
    )
  })

  it('formats an extension key as browser:extensionId:pairingNonce, matching PairingDialogController', () => {
    expect(
      pairRequestKey({
        kind: 'extension',
        pairingNonce: 'nonce1',
        extensionId: 'abcdefabcdefabcdefabcdefabcdefab',
        browser: 'chromium',
      })
    ).toBe('chromium:abcdefabcdefabcdefabcdefabcdefab:nonce1')
  })

  it('never collides a cli key with an extension key, even an adversarial one', () => {
    const cli = pairRequestKey({
      kind: 'cli',
      requestId: 'chromium:abc:nonce1',
    })
    const ext = pairRequestKey({
      kind: 'extension',
      pairingNonce: 'nonce1',
      extensionId: 'abc',
      browser: 'chromium',
    })
    expect(cli).not.toBe(ext)
  })
})