fast-uri 4.1.2 → 4.1.3

package/test/scheme-validation.test.js

@@ -0,0 +1,122 @@
+'use strict'
+
+const test = require('tape')
+const fastURI = require('..')
+
+const MALFORMED_SCHEME_ERROR = 'URI scheme is malformed.'
+
+const malformedSchemes = [
+  '%2f%2fevil.example:/pwn',
+  '%u002f%u002fevil.example:/pwn',
+  '%0d%0aSet-Cookie:%20sid=attacker:/p',
+  'foo%3Abar:value',
+  'foo%2Fbar:value',
+  '1http://example.com/',
+  'foo_bar:value',
+  'éxample:value',
+  'Kttp://example.com/',
+  'ſcheme:value'
+]
+
+test('parse validates the decoded scheme against RFC 3986', (t) => {
+  const validSchemes = [
+    ['a:value', 'a'],
+    ['HTTP://example.com/', 'http'],
+    ['a1+.-:value', 'a1+.-'],
+    ['%4Aavascript:alert(1)', 'javascript'],
+    ['foo%2Bbar:value', 'foo+bar'],
+    ['%u006Aavascript:1', 'javascript'],
+    ['ht%74ps://example.com/', 'https']
+  ]
+
+  for (const [uri, scheme] of validSchemes) {
+    const parsed = fastURI.parse(uri)
+    t.equal(parsed.error, undefined, uri)
+    t.equal(parsed.scheme, scheme, uri + ' scheme')
+  }
+
+  for (const uri of malformedSchemes) {
+    const parsed = fastURI.parse(uri)
+    t.equal(parsed.error, MALFORMED_SCHEME_ERROR, uri)
+  }
+  t.end()
+})
+
+test('decoded schemes select their scheme handlers', (t) => {
+  t.equal(
+    fastURI.normalize('ht%74ps://example.com:443'),
+    'https://example.com/',
+    'HTTP normalization runs after decoding the scheme'
+  )
+
+  const mailto = fastURI.parse('ma%69lto:user@example.org')
+  t.deepEqual(mailto.to, ['user@example.org'], 'mailto parsing runs after decoding the scheme')
+  t.end()
+})
+
+test('normalize preserves schemes that decode to invalid identifiers', (t) => {
+  for (const uri of malformedSchemes) {
+    t.equal(fastURI.normalize(uri), uri, uri)
+  }
+  t.end()
+})
+
+test('scheme normalization cannot introduce authority or control delimiters', (t) => {
+  const authority = '%2f%2fevil.example:/pwn'
+  const crlf = '%0d%0aSet-Cookie:%20sid=attacker:/p'
+
+  t.equal(fastURI.parse(authority).host, undefined, 'original input has no authority')
+  t.equal(fastURI.normalize(authority), authority, 'normalization does not create an authority')
+  t.equal(fastURI.normalize(crlf), crlf, 'normalization does not emit raw CRLF')
+  t.equal(fastURI.normalize(crlf).includes('\r\n'), false, 'normalized output contains no raw CRLF')
+  t.end()
+})
+
+test('equal returns false for malformed decoded schemes', (t) => {
+  for (const uri of malformedSchemes) {
+    t.equal(fastURI.equal(uri, uri, {}), false, uri)
+  }
+  t.end()
+})
+
+test('resolve rejects malformed decoded schemes in either input', (t) => {
+  t.throws(
+    () => fastURI.resolve('%2f%2fevil.example:/base', 'child'),
+    /URI scheme is malformed\./,
+    'malformed base'
+  )
+  t.throws(
+    () => fastURI.resolve('https://allowed.example/app/', '%2f%2fevil.example:/pwn'),
+    /URI scheme is malformed\./,
+    'malformed relative reference'
+  )
+  t.end()
+})
+
+test('serialize validates decoded component schemes', (t) => {
+  t.equal(
+    fastURI.serialize({ scheme: 'foo%2Bbar', path: 'value' }),
+    'foo+bar:value',
+    'valid decoded scheme is serialized'
+  )
+  t.throws(
+    () => fastURI.serialize({ scheme: '//evil.example', path: '/pwn' }),
+    /URI scheme is malformed\./,
+    'raw invalid scheme'
+  )
+  t.throws(
+    () => fastURI.serialize({ scheme: '%2f%2fevil.example', path: '/pwn' }),
+    /URI scheme is malformed\./,
+    'encoded invalid scheme'
+  )
+  t.equal(
+    fastURI.equal(
+      { scheme: '%2f%2fevil.example', path: '/pwn' },
+      { scheme: '%2f%2fevil.example', path: '/pwn' },
+      {}
+    ),
+    false,
+    'equality fails closed for malformed component objects'
+  )
+  t.end()
+})

package/test/security-normalization.test.js

@@ -37,3 +37,104 @@ test('equal does not treat reserved path escapes as live path syntax', (t) => {
 
   t.end()
 })
+
+test('serialize preserves literal RFC 3986 reserved path characters', (t) => {
+  // GHSA-7mh8-fcmq-x23c: literal reserved path chars must not be rewritten to
+  // percent escapes by the escape()-style safe set.
+  const cases = [
+    'http://example.com/a;b',
+    'http://example.com/a=b',
+    'http://example.com/a&b',
+    'http://example.com/a$b',
+    'http://example.com/a:b',
+    'http://example.com/a@b'
+  ]
+
+  t.plan(cases.length)
+
+  cases.forEach((uri) => {
+    t.equal(fastURI.serialize(fastURI.parse(uri)), uri, uri)
+  })
+  t.end()
+})
+
+test('serialize preserves existing reserved path escapes as data', (t) => {
+  // GHSA-7mh8-fcmq-x23c: an existing %3A escape must stay %3A instead of being
+  // rewritten into a live colon.
+  const cases = [
+    'http://example.com/a%3Ab',
+    'http://example.com/a%3Bb',
+    'http://example.com/a%3D%3D'
+  ]
+
+  t.plan(cases.length)
+
+  cases.forEach((uri) => {
+    t.equal(fastURI.serialize(fastURI.parse(uri)), uri, uri)
+  })
+  t.end()
+})
+
+test('serialize keeps path-noscheme colon escaping', (t) => {
+  // Without a scheme a literal colon would be reparsed as a scheme separator,
+  // so it must stay percent-escaped while an existing %3A is preserved.
+  t.equal(fastURI.serialize({ path: 'foo:bar' }), 'foo%3Abar')
+  t.equal(fastURI.serialize({ path: 'a%3Ab' }), 'a%3Ab')
+  t.end()
+})
+
+test('hostname normalization never decodes an escape more than once', (t) => {
+  const encodedLocalhost = 'http://%256c%256f%2563%2561%256c%2568%256f%2573%2574/'
+  const encodedLoopback = '//127%252e0%252e0%252e1/private'
+  const encodedMetadataAddress = '//169%252E254%252E169%252E254/latest/meta-data/'
+
+  t.equal(fastURI.normalize(encodedLocalhost), encodedLocalhost, 'nested hostname letters remain encoded')
+  t.equal(fastURI.normalize(encodedLoopback), encodedLoopback, 'nested IPv4 dots remain encoded')
+  t.equal(
+    fastURI.resolve('https://safe.example/', encodedLoopback),
+    'https://127%252e0%252e0%252e1/private',
+    'resolve does not turn nested dots into a loopback address'
+  )
+  t.equal(
+    fastURI.resolve('https://allowed.com/api/v1/', encodedMetadataAddress),
+    'https://169%252e254%252e169%252e254/latest/meta-data/',
+    'resolve does not turn nested dots into a metadata address'
+  )
+  t.equal(
+    fastURI.normalize('http://allowed.com%255Cevil.com/'),
+    'http://allowed.com%255Cevil.com/',
+    'normalize does not activate a nested backslash'
+  )
+  t.equal(
+    fastURI.serialize({ scheme: 'http', host: '%256cocalhost', path: '/' }),
+    'http://%256cocalhost/',
+    'component serialization preserves an encoded percent sign'
+  )
+  t.equal(
+    fastURI.equal(encodedLocalhost, 'http://localhost/', {}),
+    false,
+    'nested escapes do not compare equal to their twice-decoded target'
+  )
+  t.end()
+})
+
+test('hostname normalization decodes only current unreserved escapes', (t) => {
+  t.equal(fastURI.normalize('x://%6cocalhost/'), 'x://localhost/', 'a current unreserved escape is decoded')
+  t.equal(fastURI.normalize('x://%256cocalhost/'), 'x://%256cocalhost/', 'an encoded percent is preserved')
+  t.equal(fastURI.normalize('x://host%2540evil/'), 'x://host%2540evil/', 'a nested authority delimiter stays inert')
+  t.equal(fastURI.normalize('x://%2525/'), 'x://%2525/', 'nested encoded percent signs stay encoded')
+  t.end()
+})
+
+test('host conversion failures are not treated as comparable URLs', (t) => {
+  const malformedHost = 'http://trusted.test%2540evil.test/'
+
+  t.equal(fastURI.normalize(malformedHost), malformedHost, 'normalization preserves the failing input')
+  t.equal(fastURI.equal(malformedHost, malformedHost, {}), false, 'equal rejects a failed host conversion')
+  t.throws(
+    () => fastURI.resolve(malformedHost, 'child', { domainHost: true }),
+    /Host's domain name can not be converted to ASCII/,
+    'resolve propagates a host conversion failure'
+  )
+  t.end()
+})

package/test/security.test.js

@@ -125,11 +125,13 @@ test('serialize escapes authority delimiters in host field', (t) => {
 })
 
 test('normalize does not double-decode %2540 into a live @', (t) => {
-  const result = fastURI.normalize('http://trusted.com%2540evil.com/')
+  const input = 'http://trusted.com%2540evil.com/'
+  const result = fastURI.normalize(input)
   const parsed = fastURI.parse(result)
 
-  t.plan(1)
-  t.notEqual(parsed.host, 'trusted.com@evil.com', 'http://trusted.com%2540evil.com/')
+  t.plan(2)
+  t.equal(result, input, 'the encoded percent sign is preserved')
+  t.notEqual(parsed.host, 'trusted.com@evil.com', input)
 })
 
 test('parse canonicalises IDN / Unicode hosts to their ASCII form', (t) => {
@@ -160,6 +162,76 @@ test('parse canonicalises IDN / Unicode hosts to their ASCII form', (t) => {
   })
 })
 
+test('resolve canonicalises the host using the final resolved scheme', (t) => {
+  const cases = [
+    {
+      base: 'http://trusted.example/base',
+      relative: '//127\u30020\u30020\u30021/private',
+      expected: 'http://127.0.0.1/private',
+      expectedHost: '127.0.0.1',
+      description: 'scheme-relative loopback host'
+    },
+    {
+      base: 'https://ex\u00ADample.com/base',
+      relative: 'child',
+      expected: 'https://example.com/child',
+      expectedHost: 'example.com',
+      description: 'host inherited from the base'
+    },
+    {
+      base: 'http://trusted.example/base',
+      relative: 'http://ex\u200Bample.com/',
+      expected: 'http://example.com/',
+      expectedHost: 'example.com',
+      description: 'absolute relative reference'
+    }
+  ]
+
+  t.plan(cases.length * 2)
+
+  cases.forEach(({ base, relative, expected, expectedHost, description }) => {
+    const resolved = fastURI.resolve(base, relative)
+    t.equal(resolved, expected, description)
+    t.equal(fastURI.parse(resolved).host, expectedHost, `${description} reparses consistently`)
+  })
+})
+
+test('resolve applies domain canonicalisation only when the effective scheme opts in', (t) => {
+  const host = 'ex\u00ADample.com'
+
+  t.plan(2)
+  t.equal(
+    fastURI.resolve('uri://trusted.example/', `//${host}/`),
+    `uri://${host}/`,
+    'an unsupported scheme preserves the host'
+  )
+  t.equal(
+    fastURI.resolve('http://trusted.example/', `//${host}/`, { unicodeSupport: true }),
+    `http://${host}/`,
+    'unicodeSupport preserves the Unicode host'
+  )
+})
+
+test('resolve throws when the final scheme cannot canonicalise the host', (t) => {
+  const invalidHost = '\u200D.example'
+  const cases = [
+    ['http://trusted.example/', `//${invalidHost}/`],
+    [`https://${invalidHost}/base`, 'child'],
+    ['http://trusted.example/', `http://${invalidHost}/`],
+    ['http://trusted.example/', `//${invalidHost}%2Etest/`]
+  ]
+
+  t.plan(cases.length)
+
+  cases.forEach(([base, relative]) => {
+    t.throws(
+      () => fastURI.resolve(base, relative),
+      /Host's domain name can not be converted to ASCII/,
+      `${base} + ${relative}`
+    )
+  })
+})
+
 test('parse rejects a literal backslash in the authority as malformed (RFC 3986)', (t) => {
   // Regression for the host-confusion bypass: a literal "\" is invalid RFC 3986
   // syntax and must be flagged malformed, not silently rewritten. Otherwise "\"

package/test/serialize.test.js

@@ -149,3 +149,147 @@ test('URN NID Override', (t) => {
   t.equal(fastURI.serialize(components, { nid: 'uuid' }), 'urn:foo:f81d4fae-7dec-11d0-a765-00a0c91e6bf6')
   t.end()
 })
+
+test('Mailto serialization preserves delimiters, escapes, and input state', (t) => {
+  const valueComponent = {
+    scheme: 'mailto',
+    to: ['user@example.org'],
+    headers: { x: 'a&b' }
+  }
+  const valueURI = fastURI.serialize(valueComponent)
+  t.equal(valueURI, 'mailto:user@example.org?x=a%26b', 'ampersand in header value is encoded')
+  // spread: `headers` has a null prototype, which t.deepEqual compares strictly
+  t.deepEqual({ ...fastURI.parse(valueURI).headers }, { x: 'a&b' }, 'header value round-trips')
+
+  const nameComponent = {
+    scheme: 'mailto',
+    to: ['user@example.org'],
+    headers: { 'x&y': 'z' }
+  }
+  const nameURI = fastURI.serialize(nameComponent)
+  t.equal(nameURI, 'mailto:user@example.org?x%26y=z', 'ampersand in header name is encoded')
+  t.deepEqual({ ...fastURI.parse(nameURI).headers }, { 'x&y': 'z' }, 'header name round-trips')
+
+  t.equal(
+    fastURI.serialize({ scheme: 'mailto', to: ['user@example.org'], subject: 'a%2fb' }),
+    'mailto:user@example.org?subject=a%2Fb',
+    'valid percent escape is preserved and uppercased'
+  )
+  t.equal(
+    fastURI.serialize({ scheme: 'mailto', to: ['user@example.org'], subject: 'a%GGb' }),
+    'mailto:user@example.org?subject=a%25GGb',
+    'malformed percent escape is encoded'
+  )
+
+  const immutableComponent = {
+    scheme: 'mailto',
+    to: ['café@EXAMPLE.ORG'],
+    subject: 'hello',
+    headers: { cc: 'other@example.org' }
+  }
+  const expected = JSON.parse(JSON.stringify(immutableComponent))
+  fastURI.serialize(immutableComponent)
+  t.deepEqual(immutableComponent, expected, 'recipient and header containers are not mutated')
+  t.end()
+})
+
+test('Mailto serialization does not let recipient data inject URI structure', (t) => {
+  // A recipient domain must never reach the output with a delimiter intact:
+  // "?" would inject header fields and "#" a fragment.
+  const cases = [
+    ['user@example.org?subject=Injected', 'mailto:user@example.org%3Fsubject%3Dinjected'],
+    ['user@example.org#frag', 'mailto:user@example.org%23frag'],
+    // domain literals accept the full RFC 5321 dcontent range, which includes "?"
+    ['user@[x?subject=Injected]', 'mailto:user@[x%3Fsubject%3Dinjected]'],
+    // "," is the recipient delimiter, so it must be encoded inside an address
+    ['a,b@example.org', 'mailto:a%2Cb@example.org']
+  ]
+
+  for (const [recipient, expected] of cases) {
+    const uri = fastURI.serialize({ scheme: 'mailto', to: [recipient] })
+    t.equal(uri, expected, 'encodes delimiters in ' + recipient)
+    const reparsed = fastURI.parse(uri)
+    t.deepEqual(reparsed.to, [recipient.toLowerCase()], 'round-trips ' + recipient)
+    t.equal(reparsed.subject, undefined, 'no subject injected by ' + recipient)
+    t.equal(reparsed.headers, undefined, 'no headers injected by ' + recipient)
+    t.equal(reparsed.fragment, undefined, 'no fragment injected by ' + recipient)
+  }
+
+  t.equal(
+    fastURI.serialize({ scheme: 'mailto', to: ['a@x.test', 'b@y.test'] }),
+    'mailto:a@x.test,b@y.test',
+    'the joining comma between recipients stays literal'
+  )
+  t.equal(
+    fastURI.serialize({ scheme: 'mailto', to: ['user@[IPv6:2001:db8::1]'] }),
+    'mailto:user@[ipv6:2001:db8::1]',
+    'a valid domain literal keeps its delimiters'
+  )
+  t.equal(
+    fastURI.serialize({ scheme: 'mailto', to: ['user@納豆.example.org'] }),
+    'mailto:user@xn--99zt52a.example.org',
+    'Unicode domain is still converted to ASCII'
+  )
+  t.equal(
+    fastURI.serialize({ scheme: 'mailto', to: ['user@納豆.example.org'] }, { unicodeSupport: true }),
+    'mailto:user@納豆.example.org',
+    'Unicode domain is still preserved when requested'
+  )
+  t.end()
+})
+
+test('Mailto encoding is consistent across the fast/slow path boundary', (t) => {
+  // The encoder returns the input untouched when every character is allowed,
+  // and only then falls back to the per-character loop. Both branches must
+  // agree on what needs escaping.
+  const base = { scheme: 'mailto', to: ['user@example.org'] }
+
+  t.equal(
+    fastURI.serialize({ ...base, headers: { 'In-Reply-To': 'plain-value' } }),
+    'mailto:user@example.org?In-Reply-To=plain-value',
+    'fully allowed name and value are emitted verbatim'
+  )
+  t.equal(
+    fastURI.serialize({ ...base, headers: { 'x y': '<a>&b c' } }),
+    'mailto:user@example.org?x%20y=%3Ca%3E%26b%20c',
+    'disallowed characters are escaped in both name and value'
+  )
+  t.equal(
+    fastURI.serialize({ ...base, body: 'send current-issue\r\nsend index' }),
+    'mailto:user@example.org?body=send%20current-issue%0D%0Asend%20index',
+    'space and CRLF are escaped in a body'
+  )
+  t.equal(
+    fastURI.serialize({ ...base, subject: 'a%2fb%GGc' }),
+    'mailto:user@example.org?subject=a%2Fb%25GGc',
+    'valid escapes are uppercased and invalid ones escaped in one pass'
+  )
+  t.equal(
+    fastURI.serialize({ scheme: 'mailto', to: ['a.b-c_d~e!f@example.org'] }),
+    'mailto:a.b-c_d~e!f@example.org',
+    'an entirely allowed local part takes the fast path unchanged'
+  )
+  t.end()
+})
+
+test('Mailto serialization ignores a caller-supplied path', (t) => {
+  // `to` is the only recipient source. A raw path has not been through this
+  // handler's encoder, and the handler sets `skipEscape`, so emitting it would
+  // put unescaped data (including CR/LF) straight into the URI.
+  t.equal(
+    fastURI.serialize({ scheme: 'mailto', path: 'a@b.test\r\nBcc: evil@evil.test' }),
+    'mailto:',
+    'a path containing CRLF is dropped, not emitted raw'
+  )
+  t.equal(
+    fastURI.serialize({ scheme: 'mailto', path: 'user@example.org?subject=Injected' }),
+    'mailto:',
+    'a path containing header fields is dropped'
+  )
+  t.equal(
+    fastURI.serialize({ scheme: 'mailto', to: ['a@b.test'], path: 'ignored?x=1' }),
+    'mailto:a@b.test',
+    'a path is ignored when recipients are present'
+  )
+  t.end()
+})

package/test/uri-js-compatibility.test.js

@@ -13,9 +13,6 @@ test('uri-js compatibility Parse', (t) => {
     if (value === '//10.10.000.10') {
       return t.skip('Skipping //10.10.000.10 as it is not a valid URI per URI spec: https://datatracker.ietf.org/doc/html/rfc5954#section-4.1')
     }
-    if (value.slice(0, 6) === 'mailto') {
-      return t.skip('Skipping mailto schema test as it is not supported by fastifyURI')
-    }
     t.same(JSON.parse(JSON.stringify(fastURI.parse(value))), expected, 'Compatibility parse: ' + value)
   })
   t.end()

package/test/uri-js.test.js

@@ -692,7 +692,7 @@ if (fastURI.SCHEMES.mailto) {
 
     components = fastURI.parse('mailto:list@example.org?In-Reply-To=%3C3469A91.D10AF4C@example.com%3E')
     t.deepEqual(components.to, ['list@example.org'], 'to')
-    t.deepEqual(components.headers, { 'In-Reply-To': '<3469A91.D10AF4C@example.com>' }, 'headers')
+    t.deepEqual({ ...components.headers }, { 'In-Reply-To': '<3469A91.D10AF4C@example.com>' }, 'headers')
 
     components = fastURI.parse('mailto:majordomo@example.com?body=subscribe%20bamboo-l')
     t.deepEqual(components.to, ['majordomo@example.com'], 'to')
@@ -701,7 +701,7 @@ if (fastURI.SCHEMES.mailto) {
     components = fastURI.parse('mailto:joe@example.com?cc=bob@example.com&body=hello')
     t.deepEqual(components.to, ['joe@example.com'], 'to')
     t.equal(components.body, 'hello', 'body')
-    t.deepEqual(components.headers, { cc: 'bob@example.com' }, 'headers')
+    t.deepEqual({ ...components.headers }, { cc: 'bob@example.com' }, 'headers')
 
     components = fastURI.parse('mailto:joe@example.com?cc=bob@example.com?body=hello')
     if (fastURI.VALIDATE_SUPPORT) t.ok(components.error, 'invalid header fields')
@@ -711,7 +711,7 @@ if (fastURI.SCHEMES.mailto) {
 
     components = fastURI.parse('mailto:unlikely%3Faddress@example.com?blat=foop')
     t.deepEqual(components.to, ['unlikely?address@example.com'], 'to unlikely?address@example.com')
-    t.deepEqual(components.headers, { blat: 'foop' }, 'headers')
+    t.deepEqual({ ...components.headers }, { blat: 'foop' }, 'headers')
 
     components = fastURI.parse('mailto:Mike%26family@example.org')
     t.deepEqual(components.to, ['Mike&family@example.org'], 'to Mike&family@example.org')

package/test/urn-full-input.test.js

@@ -0,0 +1,29 @@
+'use strict'
+
+const test = require('tape')
+const fastURI = require('..')
+
+test('URN parsing validates the complete scheme-specific input', (t) => {
+  const embedded = fastURI.parse('urn:x|foo:bar')
+  t.equal(embedded.error, 'URN can not be parsed.', 'does not search for a later nid:nss substring')
+  t.equal(embedded.nid, undefined, 'does not adopt the later nid')
+  t.equal(embedded.nss, undefined, 'does not adopt the later nss')
+
+  const trailing = fastURI.parse('urn:foo:bar|ignored')
+  t.equal(trailing.error, 'URN can not be parsed.', 'rejects trailing input outside the RFC 2141 NSS grammar')
+  t.equal(trailing.nid, undefined, 'does not return an nid from a partial match')
+  t.equal(trailing.nss, undefined, 'does not return a truncated nss')
+
+  t.end()
+})
+
+test('URN parsing preserves the complete RFC 2141 NSS', (t) => {
+  const parsed = fastURI.parse('urn:foo:allowed/evil')
+  t.equal(parsed.error, undefined, 'accepts slash in an RFC 2141 NSS')
+  t.equal(parsed.nid, 'foo', 'parses the nid')
+  t.equal(parsed.nss, 'allowed/evil', 'preserves the complete NSS')
+  t.equal(fastURI.normalize('urn:foo:allowed/evil'), 'urn:foo:allowed/evil', 'normalization retains slash data')
+  t.equal(fastURI.equal('urn:foo:allowed/evil', 'urn:foo:allowed'), false, 'distinct NSS values do not compare equal')
+
+  t.end()
+})

package/test/websocket-query-preservation.test.js

@@ -0,0 +1,24 @@
+'use strict'
+
+const test = require('tape')
+const fastURI = require('..')
+
+test('WebSocket queries preserve additional question marks', (t) => {
+  for (const scheme of ['ws', 'wss']) {
+    const uri = `${scheme}://example.com/chat?a?b`
+    const truncatedURI = `${scheme}://example.com/chat?a`
+    const parsed = fastURI.parse(uri)
+
+    t.equal(parsed.resourceName, '/chat?a?b', `${scheme} parse preserves the resource name`)
+    t.equal(fastURI.serialize(parsed), uri, `${scheme} parsed components round-trip`)
+    t.equal(
+      fastURI.serialize({ scheme, host: 'example.com', resourceName: '/chat?a?b' }),
+      uri,
+      `${scheme} resource name serializes without truncation`
+    )
+    t.equal(fastURI.normalize(uri), uri, `${scheme} normalization preserves the full query`)
+    t.equal(fastURI.equal(uri, truncatedURI), false, `${scheme} equality distinguishes the full query`)
+  }
+
+  t.end()
+})

package/types/index.d.ts

@@ -16,6 +16,10 @@ declare namespace fastUri {
     secure?: boolean;
     uuid?: string;
     error?: string;
+    to?: string[];
+    subject?: string;
+    body?: string;
+    headers?: { [hfname: string]: string };
   }
   export interface Options {
     scheme?: string;

package/types/index.tst.ts

@@ -13,3 +13,19 @@ const parsed2 = uri.parse('foo', {
 })
 
 expect(parsed2).type.toBe<URIComponent>()
+
+const mailtoComponent: URIComponent = {
+  scheme: 'mailto',
+  to: ['user@example.org'],
+  subject: 'Hello',
+  body: 'Message',
+  headers: { cc: 'other@example.org' }
+}
+
+expect(uri.serialize(mailtoComponent, { unicodeSupport: true })).type.toBe<string>()
+
+const parsedMailto = uri.parse('mailto:user@example.org')
+expect(parsedMailto.to).type.toBe<string[] | undefined>()
+expect(parsedMailto.subject).type.toBe<string | undefined>()
+expect(parsedMailto.body).type.toBe<string | undefined>()
+expect(parsedMailto.headers).type.toBe<{ [hfname: string]: string } | undefined>()