@milpa/comal 0.0.0-stage → 0.1.0

package/node_modules/fast-uri/README.md

@@ -0,0 +1,152 @@
+# fast-uri
+
+[![NPM version](https://img.shields.io/npm/v/fast-uri.svg?style=flat)](https://www.npmjs.com/package/fast-uri)
+[![CI](https://github.com/fastify/fast-uri/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/fastify/fast-uri/actions/workflows/ci.yml)
+[![neostandard javascript style](https://img.shields.io/badge/code_style-neostandard-brightgreen?style=flat)](https://github.com/neostandard/neostandard)
+
+Dependency-free RFC 3986 URI toolbox.
+
+## Usage
+
+## Options
+
+All of the above functions can accept an additional options argument that is an object that can contain one or more of the following properties:
+
+Malformed authorities and out-of-range ports are reported through the parsed component's `error` field. `normalize()` leaves malformed string inputs unchanged, and `equal()` returns `false` when either string input is malformed.
+
+*	`scheme` (string)
+	Indicates the scheme that the URI should be treated as, overriding the URI's normal scheme parsing behavior.
+
+*	`reference` (string)
+	If set to `"suffix"`, it indicates that the URI is in the suffix format and the parser will use the option's `scheme` property to determine the URI's scheme.
+
+*	`tolerant` (boolean, false)
+	If set to `true`, the parser will relax URI resolving rules.
+
+*	`absolutePath` (boolean, false)
+	If set to `true`, the serializer will not resolve a relative `path` component.
+
+*	`unicodeSupport` (boolean, false)
+	If set to `true`, the parser will unescape non-ASCII characters in the parsed output as per [RFC 3987](http://www.ietf.org/rfc/rfc3987.txt).
+
+*	`domainHost` (boolean, false)
+	If set to `true`, the library will treat the `host` component as a domain name, and convert IDNs (International Domain Names) as per [RFC 5891](http://www.ietf.org/rfc/rfc5891.txt).
+
+### Parse
+
+```js
+const uri = require('fast-uri')
+uri.parse('uri://user:pass@example.com:123/one/two.three?q1=a1&q2=a2#body')
+// Output
+{
+  scheme: "uri",
+  userinfo: "user:pass",
+  host: "example.com",
+  port: 123,
+  path: "/one/two.three",
+  query: "q1=a1&q2=a2",
+  fragment: "body"
+}
+```
+
+### Serialize
+
+```js
+const uri = require('fast-uri')
+uri.serialize({scheme: "http", host: "example.com", fragment: "footer"})
+// Output
+"http://example.com/#footer"
+
+```
+
+### Resolve
+
+```js
+const uri = require('fast-uri')
+uri.resolve("uri://a/b/c/d?q", "../../g")
+// Output
+"uri://a/g"
+```
+
+### Normalize
+
+```js
+const uri = require('fast-uri')
+uri.normalize('http://example.com/a%2Fb')
+// Output
+"http://example.com/a%2Fb"
+```
+
+Reserved path escapes such as `%2F` and `%2E` are preserved as path data during normalization and comparison.
+
+### Equal
+
+```js
+const uri = require('fast-uri')
+uri.equal("example://a/b/c/%7Bfoo%7D", "eXAMPLE://a/./b/../b/%63/%7bfoo%7d")
+// Output
+true
+```
+
+## Scheme supports
+
+fast-uri supports inserting custom [scheme](http://en.wikipedia.org/wiki/URI_scheme)-dependent processing rules. Currently, fast-uri has built-in support for the following schemes:
+
+*	http \[[RFC 2616](http://www.ietf.org/rfc/rfc2616.txt)\]
+*	https \[[RFC 2818](http://www.ietf.org/rfc/rfc2818.txt)\]
+*	ws \[[RFC 6455](http://www.ietf.org/rfc/rfc6455.txt)\]
+*	wss \[[RFC 6455](http://www.ietf.org/rfc/rfc6455.txt)\]
+*	urn \[[RFC 2141](http://www.ietf.org/rfc/rfc2141.txt)\]
+*	urn:uuid \[[RFC 4122](http://www.ietf.org/rfc/rfc4122.txt)\]
+
+
+## Benchmarks
+
+```
+fast-uri benchmark
+┌─────────┬──────────────────────────────────────────┬──────────────────┬──────────────────┬────────────────────────┬────────────────────────┬─────────┐
+│ (index) │ Task name                                │ Latency avg (ns) │ Latency med (ns) │ Throughput avg (ops/s) │ Throughput med (ops/s) │ Samples │
+├─────────┼──────────────────────────────────────────┼──────────────────┼──────────────────┼────────────────────────┼────────────────────────┼─────────┤
+│ 0       │ 'fast-uri: parse domain'                 │ '951.31 ± 0.75%' │ '875.00 ± 11.00' │ '1122538 ± 0.01%'      │ '1142857 ± 14550'      │ 1051187 │
+│ 1       │ 'fast-uri: parse IPv4'                   │ '443.44 ± 0.22%' │ '406.00 ± 3.00'  │ '2422762 ± 0.01%'      │ '2463054 ± 18335'      │ 2255105 │
+│ 2       │ 'fast-uri: parse IPv6'                   │ '1241.6 ± 1.74%' │ '1131.0 ± 30.00' │ '875177 ± 0.02%'       │ '884173 ± 24092'       │ 805399  │
+│ 3       │ 'fast-uri: parse URN'                    │ '689.19 ± 4.29%' │ '618.00 ± 9.00'  │ '1598373 ± 0.01%'      │ '1618123 ± 23913'      │ 1450972 │
+│ 4       │ 'fast-uri: parse URN uuid'               │ '1025.4 ± 2.02%' │ '921.00 ± 19.00' │ '1072419 ± 0.02%'      │ '1085776 ± 22871'      │ 975236  │
+│ 5       │ 'fast-uri: serialize uri'                │ '1028.5 ± 0.53%' │ '933.00 ± 43.00' │ '1063310 ± 0.02%'      │ '1071811 ± 50523'      │ 972249  │
+│ 6       │ 'fast-uri: serialize long uri with dots' │ '1805.1 ± 0.52%' │ '1627.0 ± 17.00' │ '602620 ± 0.02%'       │ '614628 ± 6490'        │ 553997  │
+│ 7       │ 'fast-uri: serialize IPv6'               │ '2569.4 ± 2.69%' │ '2302.0 ± 21.00' │ '426080 ± 0.03%'       │ '434405 ± 3999'        │ 389194  │
+│ 8       │ 'fast-uri: serialize ws'                 │ '979.39 ± 0.43%' │ '882.00 ± 8.00'  │ '1111665 ± 0.02%'      │ '1133787 ± 10378'      │ 1021045 │
+│ 9       │ 'fast-uri: resolve'                      │ '2208.2 ± 1.08%' │ '1980.0 ± 24.00' │ '495001 ± 0.03%'       │ '505051 ± 6049'        │ 452848  │
+└─────────┴──────────────────────────────────────────┴──────────────────┴──────────────────┴────────────────────────┴────────────────────────┴─────────┘
+uri-js benchmark
+┌─────────┬───────────────────────────────────────┬──────────────────┬──────────────────┬────────────────────────┬────────────────────────┬─────────┐
+│ (index) │ Task name                             │ Latency avg (ns) │ Latency med (ns) │ Throughput avg (ops/s) │ Throughput med (ops/s) │ Samples │
+├─────────┼───────────────────────────────────────┼──────────────────┼──────────────────┼────────────────────────┼────────────────────────┼─────────┤
+│ 0       │ 'urijs: parse domain'                 │ '3618.3 ± 0.43%' │ '3314.0 ± 33.00' │ '294875 ± 0.04%'       │ '301750 ± 2975'        │ 276375  │
+│ 1       │ 'urijs: parse IPv4'                   │ '4024.1 ± 0.41%' │ '3751.0 ± 25.00' │ '261981 ± 0.04%'       │ '266596 ± 1789'        │ 248506  │
+│ 2       │ 'urijs: parse IPv6'                   │ '5417.2 ± 0.46%' │ '4968.0 ± 43.00' │ '196023 ± 0.05%'       │ '201288 ± 1727'        │ 184598  │
+│ 3       │ 'urijs: parse URN'                    │ '1324.2 ± 0.23%' │ '1229.0 ± 17.00' │ '801535 ± 0.02%'       │ '813670 ± 11413'       │ 755185  │
+│ 4       │ 'urijs: parse URN uuid'               │ '1822.0 ± 3.08%' │ '1655.0 ± 15.00' │ '594433 ± 0.02%'       │ '604230 ± 5427'        │ 548843  │
+│ 5       │ 'urijs: serialize uri'                │ '4196.8 ± 0.36%' │ '3908.0 ± 27.00' │ '251146 ± 0.04%'       │ '255885 ± 1756'        │ 238276  │
+│ 6       │ 'urijs: serialize long uri with dots' │ '8331.0 ± 1.30%' │ '7658.0 ± 72.00' │ '126440 ± 0.07%'       │ '130582 ± 1239'        │ 120034  │
+│ 7       │ 'urijs: serialize IPv6'               │ '5685.5 ± 0.30%' │ '5366.0 ± 33.00' │ '182632 ± 0.05%'       │ '186359 ± 1153'        │ 175886  │
+│ 8       │ 'urijs: serialize ws'                 │ '4159.3 ± 0.20%' │ '3899.0 ± 28.00' │ '250459 ± 0.04%'       │ '256476 ± 1855'        │ 240423  │
+│ 9       │ 'urijs: resolve'                      │ '6729.9 ± 0.39%' │ '6261.0 ± 37.00' │ '156361 ± 0.06%'       │ '159719 ± 949'         │ 148591  │
+└─────────┴───────────────────────────────────────┴──────────────────┴──────────────────┴────────────────────────┴────────────────────────┴─────────┘
+WHATWG URL benchmark
+┌─────────┬────────────────────────────┬──────────────────┬──────────────────┬────────────────────────┬────────────────────────┬─────────┐
+│ (index) │ Task name                  │ Latency avg (ns) │ Latency med (ns) │ Throughput avg (ops/s) │ Throughput med (ops/s) │ Samples │
+├─────────┼────────────────────────────┼──────────────────┼──────────────────┼────────────────────────┼────────────────────────┼─────────┤
+│ 0       │ 'WHATWG URL: parse domain' │ '475.22 ± 0.20%' │ '444.00 ± 5.00'  │ '2217599 ± 0.01%'      │ '2252252 ± 25652'      │ 2104289 │
+│ 1       │ 'WHATWG URL: parse URN'    │ '384.78 ± 0.85%' │ '350.00 ± 5.00'  │ '2809071 ± 0.01%'      │ '2857143 ± 41408'      │ 2598885 │
+└─────────┴────────────────────────────┴──────────────────┴──────────────────┴────────────────────────┴────────────────────────┴─────────┘
+```
+
+## TODO
+
+- [ ] Support MailTo
+- [ ] Be 100% iso compatible with uri-js
+
+## License
+
+Licensed under [BSD-3-Clause](./LICENSE).

package/node_modules/fast-uri/benchmark/benchmark.mjs

@@ -0,0 +1,159 @@
+import { Bench } from 'tinybench'
+import { fastUri } from '../index.js'
+import { parse as uriJsParse, serialize as uriJsSerialize, resolve as uriJsResolve, equal as uriJsEqual } from 'uri-js'
+
+const base = 'uri://a/b/c/d;p?q'
+
+const domain = 'https://example.com/foo#bar$fiz'
+const ipv4 = '//10.10.10.10'
+const ipv6 = '//[2001:db8::7]'
+const urn = 'urn:foo:a123,456'
+const urnuuid = 'urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6'
+
+const urnuuidComponent = {
+  scheme: 'urn',
+  nid: 'uuid',
+  uuid: 'f81d4fae-7dec-11d0-a765-00a0c91e6bf6'
+}
+
+const {
+  parse: fastUriParse,
+  serialize: fastUriSerialize,
+  resolve: fastUriResolve,
+  equal: fastUriEqual,
+} = fastUri
+
+// Initialization as there is a lot to parse at first
+// eg: regexes
+fastUriParse(domain)
+uriJsParse(domain)
+
+const benchFastUri = new Bench({ name: 'fast-uri benchmark' })
+const benchUriJs = new Bench({ name: 'uri-js benchmark' })
+const benchWHATWG = new Bench({ name: 'WHATWG URL benchmark' })
+
+benchFastUri.add('fast-uri: parse domain', function () {
+  fastUriParse(domain)
+})
+benchUriJs.add('urijs: parse domain', function () {
+  uriJsParse(domain)
+})
+benchWHATWG.add('WHATWG URL: parse domain', function () {
+  // eslint-disable-next-line
+  new URL(domain)
+})
+benchFastUri.add('fast-uri: parse IPv4', function () {
+  fastUriParse(ipv4)
+})
+benchUriJs.add('urijs: parse IPv4', function () {
+  uriJsParse(ipv4)
+})
+benchFastUri.add('fast-uri: parse IPv6', function () {
+  fastUriParse(ipv6)
+})
+benchUriJs.add('urijs: parse IPv6', function () {
+  uriJsParse(ipv6)
+})
+benchFastUri.add('fast-uri: parse URN', function () {
+  fastUriParse(urn)
+})
+benchUriJs.add('urijs: parse URN', function () {
+  uriJsParse(urn)
+})
+benchWHATWG.add('WHATWG URL: parse URN', function () {
+  // eslint-disable-next-line
+  new URL(urn)
+})
+benchFastUri.add('fast-uri: parse URN uuid', function () {
+  fastUriParse(urnuuid)
+})
+benchUriJs.add('urijs: parse URN uuid', function () {
+  uriJsParse(urnuuid)
+})
+benchFastUri.add('fast-uri: serialize URN uuid', function () {
+  fastUriSerialize(urnuuidComponent)
+})
+benchUriJs.add('uri-js: serialize URN uuid', function () {
+  uriJsSerialize(urnuuidComponent)
+})
+benchFastUri.add('fast-uri: serialize uri', function () {
+  fastUriSerialize({
+    scheme: 'uri',
+    userinfo: 'foo:bar',
+    host: 'example.com',
+    port: 1,
+    path: 'path',
+    query: 'query',
+    fragment: 'fragment'
+  })
+})
+benchUriJs.add('urijs: serialize uri', function () {
+  uriJsSerialize({
+    scheme: 'uri',
+    userinfo: 'foo:bar',
+    host: 'example.com',
+    port: 1,
+    path: 'path',
+    query: 'query',
+    fragment: 'fragment'
+  })
+})
+benchFastUri.add('fast-uri: serialize long uri with dots', function () {
+  fastUriSerialize({
+    scheme: 'uri',
+    userinfo: 'foo:bar',
+    host: 'example.com',
+    port: 1,
+    path: './a/./b/c/../.././d/../e/f/.././/',
+    query: 'query',
+    fragment: 'fragment'
+  })
+})
+benchUriJs.add('urijs: serialize long uri with dots', function () {
+  uriJsSerialize({
+    scheme: 'uri',
+    userinfo: 'foo:bar',
+    host: 'example.com',
+    port: 1,
+    path: './a/./b/c/../.././d/../e/f/.././/',
+    query: 'query',
+    fragment: 'fragment'
+  })
+})
+benchFastUri.add('fast-uri: serialize IPv6', function () {
+  fastUriSerialize({ host: '2606:2800:220:1:248:1893:25c8:1946' })
+})
+benchUriJs.add('urijs: serialize IPv6', function () {
+  uriJsSerialize({ host: '2606:2800:220:1:248:1893:25c8:1946' })
+})
+benchFastUri.add('fast-uri: serialize ws', function () {
+  fastUriSerialize({ scheme: 'ws', host: 'example.com', resourceName: '/foo?bar', secure: true })
+})
+benchUriJs.add('urijs: serialize ws', function () {
+  uriJsSerialize({ scheme: 'ws', host: 'example.com', resourceName: '/foo?bar', secure: true })
+})
+benchFastUri.add('fast-uri: resolve', function () {
+  fastUriResolve(base, '../../../g')
+})
+benchUriJs.add('urijs: resolve', function () {
+  uriJsResolve(base, '../../../g')
+})
+
+benchFastUri.add('fast-uri: equal', function () {
+  fastUriEqual('example://a/b/c/%7Bfoo%7D', 'eXAMPLE://a/./b/../b/%63/%7bfoo%7d')
+})
+benchUriJs.add('urijs: equal', function () {
+  uriJsEqual('example://a/b/c/%7Bfoo%7D', 'eXAMPLE://a/./b/../b/%63/%7bfoo%7d')
+})
+
+await benchFastUri.run()
+console.log(benchFastUri.name)
+console.table(benchFastUri.table())
+
+await benchUriJs.run()
+console.log(benchUriJs.name)
+console.table(benchUriJs.table())
+
+await benchWHATWG.run()
+console.log(benchWHATWG.name)
+console.table(benchWHATWG.table())

package/node_modules/fast-uri/benchmark/equal.mjs

@@ -0,0 +1,51 @@
+import { Bench } from 'tinybench'
+import { fastUri } from '../index.js'
+
+const {
+  equal: fastUriEqual,
+  parse: fastUriParse,
+} = fastUri
+
+const stringA = 'example://a/b/c/%7Bfoo%7D'
+const stringB = 'eXAMPLE://a/./b/../b/%63/%7bfoo%7d'
+
+const componentA = fastUriParse(stringA)
+const componentB = fastUriParse(stringB)
+
+const benchFastUri = new Bench({ name: 'fast-uri equal' })
+
+benchFastUri.add('equal string with string', function () {
+  fastUriEqual(stringA, stringA)
+})
+
+benchFastUri.add('equal component with component', function () {
+  fastUriEqual(componentA, componentA)
+})
+
+benchFastUri.add('equal component with string', function () {
+  fastUriEqual(componentA, stringA)
+})
+
+benchFastUri.add('equal string with component', function () {
+  fastUriEqual(stringA, componentA)
+})
+
+benchFastUri.add('not equal string with string', function () {
+  fastUriEqual(stringA, stringB)
+})
+
+benchFastUri.add('not equal component with component', function () {
+  fastUriEqual(componentA, componentB)
+})
+
+benchFastUri.add('not equal component with string', function () {
+  fastUriEqual(componentA, stringB)
+})
+
+benchFastUri.add('not equal string with component', function () {
+  fastUriEqual(stringA, componentB)
+})
+
+await benchFastUri.run()
+console.log(benchFastUri.name)
+console.table(benchFastUri.table())

package/node_modules/fast-uri/benchmark/non-simple-domain.mjs

@@ -0,0 +1,22 @@
+import { Bench } from 'tinybench'
+import { nonSimpleDomain } from '../lib/utils.js'
+
+const benchNonSimpleDomain = new Bench({ name: 'nonSimpleDomain' })
+
+const exampleCom = 'example.com'
+const exaumlmpleCom = 'exämple.com'
+const longDomain = 'abc'.repeat(100) + '.com'
+
+console.assert(nonSimpleDomain(exampleCom) === false, 'example.com should be a simple domain')
+console.assert(nonSimpleDomain(exaumlmpleCom) === true, 'exämple.com should not be a simple domain')
+console.assert(nonSimpleDomain(longDomain) === false, `${longDomain} should be a simple domain?`)
+
+benchNonSimpleDomain.add('nonSimpleDomain', function () {
+  nonSimpleDomain(exampleCom)
+  nonSimpleDomain(exaumlmpleCom)
+  nonSimpleDomain(longDomain)
+})
+
+await benchNonSimpleDomain.run()
+console.log(benchNonSimpleDomain.name)
+console.table(benchNonSimpleDomain.table())

package/node_modules/fast-uri/benchmark/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "benchmark",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "private": true,
+  "scripts": {
+    "bench": "node benchmark.mjs"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "tinybench": "^5.0.0",
+    "uri-js": "^4.4.1"
+  }
+}

package/node_modules/fast-uri/benchmark/string-array-to-hex-stripped.mjs

@@ -0,0 +1,24 @@
+import { Bench } from 'tinybench'
+import { stringArrayToHexStripped } from '../lib/utils.js'
+
+const benchStringArrayToHexStripped = new Bench({ name: 'stringArrayToHexStripped' })
+
+const case1 = ['0', '0', '0', '0']
+const case2 = ['0', '0', '0', '1']
+const case3 = ['0', '0', '1', '0']
+const case4 = ['0', '1', '0', '0']
+const case5 = ['1', '0', '0', '0']
+const case6 = ['1', '0', '0', '1']
+
+benchStringArrayToHexStripped.add('stringArrayToHexStripped', function () {
+  stringArrayToHexStripped(case1)
+  stringArrayToHexStripped(case2)
+  stringArrayToHexStripped(case3)
+  stringArrayToHexStripped(case4)
+  stringArrayToHexStripped(case5)
+  stringArrayToHexStripped(case6)
+})
+
+await benchStringArrayToHexStripped.run()
+console.log(benchStringArrayToHexStripped.name)
+console.table(benchStringArrayToHexStripped.table())

package/node_modules/fast-uri/benchmark/ws-is-secure.mjs

@@ -0,0 +1,65 @@
+import { Bench } from 'tinybench'
+import { wsIsSecure } from '../lib/schemes.js'
+
+const benchWsIsSecure = new Bench({ name: 'wsIsSecure' })
+
+const wsComponentAttributeSecureTrue = {
+  scheme: 'ws',
+  secure: true,
+}
+
+const wsComponentAttributeSecureFalse = {
+  scheme: 'ws',
+  secure: false,
+}
+
+const wssComponent = {
+  scheme: 'wss',
+}
+
+const wssComponentMixedCase = {
+  scheme: 'Wss',
+}
+
+const wssComponentUpperCase = {
+  scheme: 'WSS',
+}
+
+const httpComponent = {
+  scheme: 'http',
+}
+
+console.assert(wsIsSecure(wsComponentAttributeSecureTrue) === true, 'wsComponentAttributeSecureTrue should be secure')
+console.assert(wsIsSecure(wsComponentAttributeSecureFalse) === false, 'wsComponentAttributeSecureFalse should not be secure')
+console.assert(wsIsSecure(wssComponent) === true, 'wssComponent should be secure')
+console.assert(wsIsSecure(wssComponentMixedCase) === true, 'wssComponentMixedCase should be secure')
+console.assert(wsIsSecure(wssComponentUpperCase) === true, 'wssComponentUpperCase should be secure')
+console.assert(wsIsSecure(httpComponent) === false, 'httpComponent should not be secure')
+
+benchWsIsSecure.add(JSON.stringify(wsComponentAttributeSecureFalse), function () {
+  wsIsSecure(wsComponentAttributeSecureFalse)
+})
+
+benchWsIsSecure.add(JSON.stringify(wsComponentAttributeSecureTrue), function () {
+  wsIsSecure(wsComponentAttributeSecureTrue)
+})
+
+benchWsIsSecure.add(JSON.stringify(wssComponent), function () {
+  wsIsSecure(wssComponent)
+})
+
+benchWsIsSecure.add(JSON.stringify(wssComponentMixedCase), function () {
+  wsIsSecure(wssComponentMixedCase)
+})
+
+benchWsIsSecure.add(JSON.stringify(wssComponentUpperCase), function () {
+  wsIsSecure(wssComponentUpperCase)
+})
+
+benchWsIsSecure.add(JSON.stringify(httpComponent), function () {
+  wsIsSecure(httpComponent)
+})
+
+await benchWsIsSecure.run()
+console.log(benchWsIsSecure.name)
+console.table(benchWsIsSecure.table())

package/node_modules/fast-uri/eslint.config.js

@@ -0,0 +1,6 @@
+'use strict'
+
+module.exports = require('neostandard')({
+  ignores: require('neostandard').resolveIgnoresFromGitignore(),
+  ts: true
+})