node-datachannel 0.4.3 → 0.5.0-dev

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (408) hide show
  1. package/.github/workflows/build-linux.yml +10 -10
  2. package/.github/workflows/build-mac-m1.yml +5 -5
  3. package/.github/workflows/build-mac-x64.yml +5 -5
  4. package/.github/workflows/build-win.yml +11 -8
  5. package/.github/workflows/lint.yml +1 -1
  6. package/.github/workflows/npm-publish-manual.yml +1 -1
  7. package/{.prettierrc.js → .prettierrc.cjs} +1 -0
  8. package/BULDING.md +7 -3
  9. package/CMakeLists.txt +12 -22
  10. package/README.md +37 -33
  11. package/cmake/toolchain/arm64.cmake +1 -1
  12. package/examples/build/Dockerfile +30 -0
  13. package/examples/build/README.md +24 -0
  14. package/examples/client-server/README.md +22 -0
  15. package/examples/client-server/client-benchmark.js +11 -6
  16. package/examples/client-server/client-periodic.js +5 -6
  17. package/examples/client-server/client.js +4 -5
  18. package/examples/client-server/package-lock.json +311 -260
  19. package/examples/client-server/package.json +15 -14
  20. package/examples/client-server/signaling-server.js +1 -2
  21. package/examples/electron-demo/README.md +58 -0
  22. package/examples/electron-demo/forge.config.js +49 -0
  23. package/examples/electron-demo/package-lock.json +16287 -0
  24. package/examples/electron-demo/package.json +43 -0
  25. package/examples/electron-demo/src/index.css +7 -0
  26. package/examples/electron-demo/src/index.html +29 -0
  27. package/examples/electron-demo/src/main.js +53 -0
  28. package/examples/electron-demo/src/node-datachannel.js +123 -0
  29. package/examples/electron-demo/src/preload.js +28 -0
  30. package/examples/electron-demo/src/renderer.js +58 -0
  31. package/examples/electron-demo/webpack.main.config.js +11 -0
  32. package/examples/electron-demo/webpack.renderer.config.js +13 -0
  33. package/examples/electron-demo/webpack.rules.js +35 -0
  34. package/examples/media/README.md +3 -3
  35. package/examples/media/media.js +3 -4
  36. package/examples/simple-peer-usage/main.js +28 -0
  37. package/examples/simple-peer-usage/package-lock.json +317 -0
  38. package/examples/simple-peer-usage/package.json +16 -0
  39. package/lib/datachannel-stream.js +3 -4
  40. package/lib/index.d.ts +7 -4
  41. package/lib/index.js +6 -3
  42. package/node_modules/base64-js/package.json +19 -50
  43. package/node_modules/buffer/package.json +20 -54
  44. package/node_modules/chownr/package.json +16 -53
  45. package/node_modules/decompress-response/package.json +54 -89
  46. package/node_modules/deep-extend/package.json +32 -65
  47. package/node_modules/detect-libc/README.md +4 -1
  48. package/node_modules/detect-libc/index.d.ts +3 -0
  49. package/node_modules/detect-libc/lib/detect-libc.js +105 -4
  50. package/node_modules/detect-libc/lib/filesystem.js +41 -0
  51. package/node_modules/detect-libc/lib/process.js +3 -0
  52. package/node_modules/detect-libc/package.json +25 -60
  53. package/node_modules/end-of-stream/package.json +17 -49
  54. package/node_modules/expand-template/package.json +17 -51
  55. package/node_modules/fs-constants/package.json +11 -42
  56. package/node_modules/github-from-package/package.json +28 -60
  57. package/node_modules/ieee754/package.json +19 -54
  58. package/node_modules/inherits/package.json +12 -61
  59. package/node_modules/ini/package.json +19 -55
  60. package/node_modules/mimic-response/package.json +40 -75
  61. package/node_modules/minimist/.eslintrc +29 -0
  62. package/node_modules/minimist/.github/FUNDING.yml +12 -0
  63. package/node_modules/minimist/.nycrc +14 -0
  64. package/node_modules/minimist/CHANGELOG.md +298 -0
  65. package/node_modules/minimist/{readme.markdown → README.md} +34 -11
  66. package/node_modules/minimist/example/parse.js +2 -0
  67. package/node_modules/minimist/index.js +256 -242
  68. package/node_modules/minimist/package.json +73 -77
  69. package/node_modules/minimist/test/all_bool.js +26 -24
  70. package/node_modules/minimist/test/bool.js +146 -147
  71. package/node_modules/minimist/test/dash.js +33 -21
  72. package/node_modules/minimist/test/default_bool.js +26 -24
  73. package/node_modules/minimist/test/dotted.js +13 -11
  74. package/node_modules/minimist/test/kv_short.js +26 -10
  75. package/node_modules/minimist/test/long.js +28 -26
  76. package/node_modules/minimist/test/num.js +30 -28
  77. package/node_modules/minimist/test/parse.js +169 -157
  78. package/node_modules/minimist/test/parse_modified.js +7 -5
  79. package/node_modules/minimist/test/proto.js +41 -37
  80. package/node_modules/minimist/test/short.js +57 -55
  81. package/node_modules/minimist/test/stop_early.js +10 -8
  82. package/node_modules/minimist/test/unknown.js +83 -81
  83. package/node_modules/minimist/test/whitespace.js +6 -4
  84. package/node_modules/mkdirp-classic/package.json +11 -43
  85. package/node_modules/napi-build-utils/package.json +26 -57
  86. package/node_modules/node-abi/README.md +5 -3
  87. package/node_modules/node-abi/abi_registry.json +98 -8
  88. package/node_modules/node-abi/package.json +26 -57
  89. package/node_modules/once/package.json +14 -55
  90. package/node_modules/prebuild-install/CHANGELOG.md +18 -0
  91. package/node_modules/prebuild-install/README.md +6 -2
  92. package/node_modules/prebuild-install/log.js +26 -18
  93. package/node_modules/prebuild-install/package.json +36 -98
  94. package/node_modules/prebuild-install/rc.js +5 -1
  95. package/node_modules/prebuild-install/util.js +1 -1
  96. package/node_modules/pump/package.json +10 -49
  97. package/node_modules/rc/node_modules/strip-json-comments/package.json +42 -0
  98. package/node_modules/rc/package.json +18 -59
  99. package/node_modules/safe-buffer/index.js +3 -0
  100. package/node_modules/safe-buffer/package.json +20 -39
  101. package/node_modules/{node-abi/node_modules/semver → semver}/README.md +70 -1
  102. package/node_modules/{node-abi/node_modules/semver → semver}/bin/semver.js +16 -2
  103. package/node_modules/{node-abi/node_modules/semver → semver}/classes/comparator.js +39 -34
  104. package/node_modules/{node-abi/node_modules/semver → semver}/classes/range.js +48 -28
  105. package/node_modules/{node-abi/node_modules/semver → semver}/classes/semver.js +32 -17
  106. package/node_modules/{node-abi/node_modules/semver → semver}/functions/coerce.js +1 -1
  107. package/node_modules/semver/functions/diff.js +65 -0
  108. package/node_modules/{node-abi/node_modules/semver → semver}/functions/inc.js +3 -2
  109. package/node_modules/semver/functions/parse.js +16 -0
  110. package/node_modules/semver/index.js +89 -0
  111. package/node_modules/{node-abi/node_modules/semver → semver}/internal/constants.js +20 -2
  112. package/node_modules/semver/internal/parse-options.js +15 -0
  113. package/node_modules/{node-abi/node_modules/semver → semver}/internal/re.js +34 -4
  114. package/node_modules/semver/node_modules/lru-cache/package.json +34 -0
  115. package/node_modules/semver/node_modules/yallist/package.json +29 -0
  116. package/node_modules/semver/package.json +87 -0
  117. package/node_modules/{node-abi/node_modules/semver → semver}/ranges/intersects.js +1 -1
  118. package/node_modules/{node-abi/node_modules/semver → semver}/ranges/subset.js +6 -3
  119. package/node_modules/simple-concat/package.json +17 -45
  120. package/node_modules/simple-get/package.json +17 -45
  121. package/node_modules/{tar-stream → tar-fs}/node_modules/bl/package.json +20 -51
  122. package/node_modules/{tar-stream → tar-fs}/node_modules/readable-stream/README.md +1 -1
  123. package/node_modules/{tar-stream → tar-fs}/node_modules/readable-stream/lib/_stream_duplex.js +12 -25
  124. package/node_modules/{tar-stream → tar-fs}/node_modules/readable-stream/lib/_stream_passthrough.js +2 -4
  125. package/node_modules/{tar-stream → tar-fs}/node_modules/readable-stream/lib/_stream_readable.js +176 -273
  126. package/node_modules/{tar-stream → tar-fs}/node_modules/readable-stream/lib/_stream_transform.js +26 -37
  127. package/node_modules/{tar-stream → tar-fs}/node_modules/readable-stream/lib/_stream_writable.js +118 -174
  128. package/node_modules/{tar-stream → tar-fs}/node_modules/readable-stream/lib/internal/streams/async_iterator.js +10 -37
  129. package/node_modules/{tar-stream → tar-fs}/node_modules/readable-stream/lib/internal/streams/buffer_list.js +20 -47
  130. package/node_modules/{tar-stream → tar-fs}/node_modules/readable-stream/lib/internal/streams/destroy.js +8 -17
  131. package/node_modules/{tar-stream → tar-fs}/node_modules/readable-stream/lib/internal/streams/end-of-stream.js +1 -19
  132. package/node_modules/{tar-stream → tar-fs}/node_modules/readable-stream/lib/internal/streams/from.js +12 -24
  133. package/node_modules/{tar-stream → tar-fs}/node_modules/readable-stream/lib/internal/streams/pipeline.js +5 -16
  134. package/node_modules/{tar-stream → tar-fs}/node_modules/readable-stream/lib/internal/streams/state.js +2 -7
  135. package/node_modules/{tar-stream → tar-fs}/node_modules/readable-stream/package.json +27 -60
  136. package/node_modules/tar-fs/node_modules/string_decoder/package.json +34 -0
  137. package/node_modules/{tar-stream → tar-fs/node_modules/tar-stream}/extract.js +1 -1
  138. package/node_modules/{tar-stream → tar-fs/node_modules/tar-stream}/headers.js +4 -2
  139. package/node_modules/{tar-stream → tar-fs/node_modules/tar-stream}/package.json +22 -59
  140. package/node_modules/tar-fs/package.json +21 -51
  141. package/node_modules/tunnel-agent/package.json +12 -49
  142. package/node_modules/util-deprecate/package.json +14 -49
  143. package/node_modules/wrappy/package.json +16 -49
  144. package/package.json +85 -68
  145. package/polyfill/Events.d.ts +9 -0
  146. package/polyfill/Events.js +27 -0
  147. package/polyfill/README.md +41 -0
  148. package/polyfill/RTCCertificate.d.ts +7 -0
  149. package/polyfill/RTCCertificate.js +17 -0
  150. package/polyfill/RTCDataChannel.d.ts +35 -0
  151. package/polyfill/RTCDataChannel.js +175 -0
  152. package/polyfill/RTCDtlsTransport.d.ts +10 -0
  153. package/polyfill/RTCDtlsTransport.js +29 -0
  154. package/polyfill/RTCIceCandidate.d.ts +20 -0
  155. package/polyfill/RTCIceCandidate.js +126 -0
  156. package/polyfill/RTCIceTransport.d.ts +18 -0
  157. package/polyfill/RTCIceTransport.js +55 -0
  158. package/polyfill/RTCPeerConnection.d.ts +50 -0
  159. package/polyfill/RTCPeerConnection.js +348 -0
  160. package/polyfill/RTCSctpTransport.d.ts +10 -0
  161. package/polyfill/RTCSctpTransport.js +34 -0
  162. package/polyfill/RTCSessionDescription.d.ts +7 -0
  163. package/polyfill/RTCSessionDescription.js +37 -0
  164. package/polyfill/index.d.ts +14 -0
  165. package/polyfill/index.js +14 -0
  166. package/src/data-channel-wrapper.cpp +47 -6
  167. package/src/main.cpp +5 -5
  168. package/src/peer-connection-wrapper.cpp +141 -9
  169. package/src/peer-connection-wrapper.h +4 -0
  170. package/src/rtc-wrapper.cpp +14 -9
  171. package/src/thread-safe-callback.cpp +4 -10
  172. package/src/thread-safe-callback.h +3 -12
  173. package/test/connectivity.js +9 -4
  174. package/test/polyfill-connectivity.js +89 -0
  175. package/test/test.js +3 -3
  176. package/test/wpt.js +50 -0
  177. package/examples/README.md +0 -21
  178. package/node_modules/ansi-regex/index.js +0 -4
  179. package/node_modules/ansi-regex/package.json +0 -111
  180. package/node_modules/ansi-regex/readme.md +0 -39
  181. package/node_modules/aproba/LICENSE +0 -14
  182. package/node_modules/aproba/README.md +0 -94
  183. package/node_modules/aproba/index.js +0 -105
  184. package/node_modules/aproba/package.json +0 -65
  185. package/node_modules/code-point-at/index.js +0 -32
  186. package/node_modules/code-point-at/license +0 -21
  187. package/node_modules/code-point-at/package.json +0 -73
  188. package/node_modules/code-point-at/readme.md +0 -32
  189. package/node_modules/console-control-strings/LICENSE +0 -13
  190. package/node_modules/console-control-strings/README.md +0 -145
  191. package/node_modules/console-control-strings/README.md~ +0 -140
  192. package/node_modules/console-control-strings/index.js +0 -125
  193. package/node_modules/console-control-strings/package.json +0 -64
  194. package/node_modules/core-util-is/LICENSE +0 -19
  195. package/node_modules/core-util-is/README.md +0 -3
  196. package/node_modules/core-util-is/float.patch +0 -604
  197. package/node_modules/core-util-is/lib/util.js +0 -107
  198. package/node_modules/core-util-is/package.json +0 -70
  199. package/node_modules/core-util-is/test.js +0 -68
  200. package/node_modules/delegates/.npmignore +0 -1
  201. package/node_modules/delegates/History.md +0 -22
  202. package/node_modules/delegates/License +0 -20
  203. package/node_modules/delegates/Makefile +0 -8
  204. package/node_modules/delegates/Readme.md +0 -94
  205. package/node_modules/delegates/index.js +0 -121
  206. package/node_modules/delegates/package.json +0 -53
  207. package/node_modules/delegates/test/index.js +0 -94
  208. package/node_modules/has-unicode/LICENSE +0 -14
  209. package/node_modules/has-unicode/README.md +0 -43
  210. package/node_modules/has-unicode/index.js +0 -16
  211. package/node_modules/has-unicode/package.json +0 -62
  212. package/node_modules/is-fullwidth-code-point/index.js +0 -46
  213. package/node_modules/is-fullwidth-code-point/license +0 -21
  214. package/node_modules/is-fullwidth-code-point/package.json +0 -80
  215. package/node_modules/is-fullwidth-code-point/readme.md +0 -39
  216. package/node_modules/isarray/.npmignore +0 -1
  217. package/node_modules/isarray/.travis.yml +0 -4
  218. package/node_modules/isarray/Makefile +0 -6
  219. package/node_modules/isarray/README.md +0 -60
  220. package/node_modules/isarray/component.json +0 -19
  221. package/node_modules/isarray/index.js +0 -5
  222. package/node_modules/isarray/package.json +0 -77
  223. package/node_modules/isarray/test.js +0 -20
  224. package/node_modules/lru-cache/node_modules/yallist/package.json +0 -65
  225. package/node_modules/lru-cache/package.json +0 -73
  226. package/node_modules/minimist/.travis.yml +0 -8
  227. package/node_modules/node-abi/.circleci/config.yml +0 -63
  228. package/node_modules/node-abi/.github/workflows/update-abi.yml +0 -41
  229. package/node_modules/node-abi/.releaserc.json +0 -9
  230. package/node_modules/node-abi/CODE_OF_CONDUCT.md +0 -73
  231. package/node_modules/node-abi/CONTRIBUTING.md +0 -53
  232. package/node_modules/node-abi/node_modules/semver/functions/diff.js +0 -23
  233. package/node_modules/node-abi/node_modules/semver/functions/parse.js +0 -33
  234. package/node_modules/node-abi/node_modules/semver/index.js +0 -48
  235. package/node_modules/node-abi/node_modules/semver/internal/parse-options.js +0 -11
  236. package/node_modules/node-abi/node_modules/semver/package.json +0 -109
  237. package/node_modules/node-abi/scripts/update-abi-registry.js +0 -119
  238. package/node_modules/node-abi/test/index.js +0 -166
  239. package/node_modules/npmlog/CHANGELOG.md +0 -49
  240. package/node_modules/npmlog/LICENSE +0 -15
  241. package/node_modules/npmlog/README.md +0 -216
  242. package/node_modules/npmlog/log.js +0 -309
  243. package/node_modules/npmlog/node_modules/are-we-there-yet/CHANGES.md +0 -37
  244. package/node_modules/npmlog/node_modules/are-we-there-yet/LICENSE +0 -5
  245. package/node_modules/npmlog/node_modules/are-we-there-yet/README.md +0 -195
  246. package/node_modules/npmlog/node_modules/are-we-there-yet/index.js +0 -4
  247. package/node_modules/npmlog/node_modules/are-we-there-yet/package.json +0 -66
  248. package/node_modules/npmlog/node_modules/are-we-there-yet/tracker-base.js +0 -11
  249. package/node_modules/npmlog/node_modules/are-we-there-yet/tracker-group.js +0 -107
  250. package/node_modules/npmlog/node_modules/are-we-there-yet/tracker-stream.js +0 -36
  251. package/node_modules/npmlog/node_modules/are-we-there-yet/tracker.js +0 -30
  252. package/node_modules/npmlog/node_modules/gauge/CHANGELOG.md +0 -160
  253. package/node_modules/npmlog/node_modules/gauge/LICENSE +0 -13
  254. package/node_modules/npmlog/node_modules/gauge/README.md +0 -399
  255. package/node_modules/npmlog/node_modules/gauge/base-theme.js +0 -14
  256. package/node_modules/npmlog/node_modules/gauge/error.js +0 -24
  257. package/node_modules/npmlog/node_modules/gauge/has-color.js +0 -12
  258. package/node_modules/npmlog/node_modules/gauge/index.js +0 -233
  259. package/node_modules/npmlog/node_modules/gauge/package.json +0 -94
  260. package/node_modules/npmlog/node_modules/gauge/plumbing.js +0 -48
  261. package/node_modules/npmlog/node_modules/gauge/process.js +0 -3
  262. package/node_modules/npmlog/node_modules/gauge/progress-bar.js +0 -35
  263. package/node_modules/npmlog/node_modules/gauge/render-template.js +0 -181
  264. package/node_modules/npmlog/node_modules/gauge/set-immediate.js +0 -7
  265. package/node_modules/npmlog/node_modules/gauge/set-interval.js +0 -3
  266. package/node_modules/npmlog/node_modules/gauge/spin.js +0 -5
  267. package/node_modules/npmlog/node_modules/gauge/template-item.js +0 -73
  268. package/node_modules/npmlog/node_modules/gauge/theme-set.js +0 -115
  269. package/node_modules/npmlog/node_modules/gauge/themes.js +0 -54
  270. package/node_modules/npmlog/node_modules/gauge/wide-truncate.js +0 -25
  271. package/node_modules/npmlog/package.json +0 -78
  272. package/node_modules/number-is-nan/index.js +0 -4
  273. package/node_modules/number-is-nan/license +0 -21
  274. package/node_modules/number-is-nan/package.json +0 -70
  275. package/node_modules/number-is-nan/readme.md +0 -28
  276. package/node_modules/object-assign/index.js +0 -90
  277. package/node_modules/object-assign/license +0 -21
  278. package/node_modules/object-assign/package.json +0 -77
  279. package/node_modules/object-assign/readme.md +0 -61
  280. package/node_modules/process-nextick-args/index.js +0 -45
  281. package/node_modules/process-nextick-args/license.md +0 -19
  282. package/node_modules/process-nextick-args/package.json +0 -53
  283. package/node_modules/process-nextick-args/readme.md +0 -18
  284. package/node_modules/readable-stream/.travis.yml +0 -34
  285. package/node_modules/readable-stream/README.md +0 -58
  286. package/node_modules/readable-stream/doc/wg-meetings/2015-01-30.md +0 -60
  287. package/node_modules/readable-stream/duplex-browser.js +0 -1
  288. package/node_modules/readable-stream/duplex.js +0 -1
  289. package/node_modules/readable-stream/lib/_stream_duplex.js +0 -131
  290. package/node_modules/readable-stream/lib/_stream_passthrough.js +0 -47
  291. package/node_modules/readable-stream/lib/_stream_readable.js +0 -1019
  292. package/node_modules/readable-stream/lib/_stream_transform.js +0 -214
  293. package/node_modules/readable-stream/lib/_stream_writable.js +0 -687
  294. package/node_modules/readable-stream/lib/internal/streams/BufferList.js +0 -79
  295. package/node_modules/readable-stream/lib/internal/streams/destroy.js +0 -74
  296. package/node_modules/readable-stream/package.json +0 -87
  297. package/node_modules/readable-stream/passthrough.js +0 -1
  298. package/node_modules/readable-stream/readable-browser.js +0 -7
  299. package/node_modules/readable-stream/readable.js +0 -19
  300. package/node_modules/readable-stream/transform.js +0 -1
  301. package/node_modules/readable-stream/writable-browser.js +0 -1
  302. package/node_modules/readable-stream/writable.js +0 -8
  303. package/node_modules/set-blocking/CHANGELOG.md +0 -26
  304. package/node_modules/set-blocking/LICENSE.txt +0 -14
  305. package/node_modules/set-blocking/README.md +0 -31
  306. package/node_modules/set-blocking/index.js +0 -7
  307. package/node_modules/set-blocking/package.json +0 -73
  308. package/node_modules/signal-exit/CHANGELOG.md +0 -35
  309. package/node_modules/signal-exit/LICENSE.txt +0 -16
  310. package/node_modules/signal-exit/README.md +0 -39
  311. package/node_modules/signal-exit/index.js +0 -163
  312. package/node_modules/signal-exit/package.json +0 -71
  313. package/node_modules/signal-exit/signals.js +0 -53
  314. package/node_modules/string-width/index.js +0 -37
  315. package/node_modules/string-width/license +0 -21
  316. package/node_modules/string-width/package.json +0 -95
  317. package/node_modules/string-width/readme.md +0 -42
  318. package/node_modules/string_decoder/.travis.yml +0 -50
  319. package/node_modules/string_decoder/package.json +0 -64
  320. package/node_modules/strip-ansi/index.js +0 -6
  321. package/node_modules/strip-ansi/license +0 -21
  322. package/node_modules/strip-ansi/package.json +0 -107
  323. package/node_modules/strip-ansi/readme.md +0 -33
  324. package/node_modules/strip-json-comments/license +0 -21
  325. package/node_modules/strip-json-comments/package.json +0 -77
  326. package/node_modules/tar-stream/node_modules/readable-stream/CONTRIBUTING.md +0 -38
  327. package/node_modules/tar-stream/node_modules/readable-stream/GOVERNANCE.md +0 -136
  328. package/node_modules/tar-stream/node_modules/readable-stream/LICENSE +0 -47
  329. package/node_modules/tar-stream/node_modules/readable-stream/lib/internal/streams/stream-browser.js +0 -1
  330. package/node_modules/tar-stream/node_modules/readable-stream/lib/internal/streams/stream.js +0 -1
  331. package/node_modules/wide-align/LICENSE +0 -14
  332. package/node_modules/wide-align/README.md +0 -47
  333. package/node_modules/wide-align/align.js +0 -65
  334. package/node_modules/wide-align/package.json +0 -69
  335. /package/{.eslintrc.js → .eslintrc.cjs} +0 -0
  336. /package/node_modules/{strip-json-comments → rc/node_modules/strip-json-comments}/index.js +0 -0
  337. /package/node_modules/{ansi-regex → rc/node_modules/strip-json-comments}/license +0 -0
  338. /package/node_modules/{strip-json-comments → rc/node_modules/strip-json-comments}/readme.md +0 -0
  339. /package/node_modules/{lru-cache → semver}/LICENSE +0 -0
  340. /package/node_modules/{node-abi/node_modules/semver → semver}/classes/index.js +0 -0
  341. /package/node_modules/{node-abi/node_modules/semver → semver}/functions/clean.js +0 -0
  342. /package/node_modules/{node-abi/node_modules/semver → semver}/functions/cmp.js +0 -0
  343. /package/node_modules/{node-abi/node_modules/semver → semver}/functions/compare-build.js +0 -0
  344. /package/node_modules/{node-abi/node_modules/semver → semver}/functions/compare-loose.js +0 -0
  345. /package/node_modules/{node-abi/node_modules/semver → semver}/functions/compare.js +0 -0
  346. /package/node_modules/{node-abi/node_modules/semver → semver}/functions/eq.js +0 -0
  347. /package/node_modules/{node-abi/node_modules/semver → semver}/functions/gt.js +0 -0
  348. /package/node_modules/{node-abi/node_modules/semver → semver}/functions/gte.js +0 -0
  349. /package/node_modules/{node-abi/node_modules/semver → semver}/functions/lt.js +0 -0
  350. /package/node_modules/{node-abi/node_modules/semver → semver}/functions/lte.js +0 -0
  351. /package/node_modules/{node-abi/node_modules/semver → semver}/functions/major.js +0 -0
  352. /package/node_modules/{node-abi/node_modules/semver → semver}/functions/minor.js +0 -0
  353. /package/node_modules/{node-abi/node_modules/semver → semver}/functions/neq.js +0 -0
  354. /package/node_modules/{node-abi/node_modules/semver → semver}/functions/patch.js +0 -0
  355. /package/node_modules/{node-abi/node_modules/semver → semver}/functions/prerelease.js +0 -0
  356. /package/node_modules/{node-abi/node_modules/semver → semver}/functions/rcompare.js +0 -0
  357. /package/node_modules/{node-abi/node_modules/semver → semver}/functions/rsort.js +0 -0
  358. /package/node_modules/{node-abi/node_modules/semver → semver}/functions/satisfies.js +0 -0
  359. /package/node_modules/{node-abi/node_modules/semver → semver}/functions/sort.js +0 -0
  360. /package/node_modules/{node-abi/node_modules/semver → semver}/functions/valid.js +0 -0
  361. /package/node_modules/{node-abi/node_modules/semver → semver}/internal/debug.js +0 -0
  362. /package/node_modules/{node-abi/node_modules/semver → semver}/internal/identifiers.js +0 -0
  363. /package/node_modules/{lru-cache/node_modules/yallist → semver/node_modules/lru-cache}/LICENSE +0 -0
  364. /package/node_modules/{lru-cache → semver/node_modules/lru-cache}/README.md +0 -0
  365. /package/node_modules/{lru-cache → semver/node_modules/lru-cache}/index.js +0 -0
  366. /package/node_modules/{node-abi/node_modules/semver → semver/node_modules/yallist}/LICENSE +0 -0
  367. /package/node_modules/{lru-cache → semver}/node_modules/yallist/README.md +0 -0
  368. /package/node_modules/{lru-cache → semver}/node_modules/yallist/iterator.js +0 -0
  369. /package/node_modules/{lru-cache → semver}/node_modules/yallist/yallist.js +0 -0
  370. /package/node_modules/{node-abi/node_modules/semver → semver}/preload.js +0 -0
  371. /package/node_modules/{node-abi/node_modules/semver → semver}/range.bnf +0 -0
  372. /package/node_modules/{node-abi/node_modules/semver → semver}/ranges/gtr.js +0 -0
  373. /package/node_modules/{node-abi/node_modules/semver → semver}/ranges/ltr.js +0 -0
  374. /package/node_modules/{node-abi/node_modules/semver → semver}/ranges/max-satisfying.js +0 -0
  375. /package/node_modules/{node-abi/node_modules/semver → semver}/ranges/min-satisfying.js +0 -0
  376. /package/node_modules/{node-abi/node_modules/semver → semver}/ranges/min-version.js +0 -0
  377. /package/node_modules/{node-abi/node_modules/semver → semver}/ranges/outside.js +0 -0
  378. /package/node_modules/{node-abi/node_modules/semver → semver}/ranges/simplify.js +0 -0
  379. /package/node_modules/{node-abi/node_modules/semver → semver}/ranges/to-comparators.js +0 -0
  380. /package/node_modules/{node-abi/node_modules/semver → semver}/ranges/valid.js +0 -0
  381. /package/node_modules/{tar-stream → tar-fs}/node_modules/bl/.travis.yml +0 -0
  382. /package/node_modules/{tar-stream → tar-fs}/node_modules/bl/BufferList.js +0 -0
  383. /package/node_modules/{tar-stream → tar-fs}/node_modules/bl/LICENSE.md +0 -0
  384. /package/node_modules/{tar-stream → tar-fs}/node_modules/bl/README.md +0 -0
  385. /package/node_modules/{tar-stream → tar-fs}/node_modules/bl/bl.js +0 -0
  386. /package/node_modules/{tar-stream → tar-fs}/node_modules/bl/test/convert.js +0 -0
  387. /package/node_modules/{tar-stream → tar-fs}/node_modules/bl/test/indexOf.js +0 -0
  388. /package/node_modules/{tar-stream → tar-fs}/node_modules/bl/test/isBufferList.js +0 -0
  389. /package/node_modules/{tar-stream → tar-fs}/node_modules/bl/test/test.js +0 -0
  390. /package/node_modules/{readable-stream → tar-fs/node_modules/readable-stream}/CONTRIBUTING.md +0 -0
  391. /package/node_modules/{readable-stream → tar-fs/node_modules/readable-stream}/GOVERNANCE.md +0 -0
  392. /package/node_modules/{readable-stream → tar-fs/node_modules/readable-stream}/LICENSE +0 -0
  393. /package/node_modules/{tar-stream → tar-fs}/node_modules/readable-stream/errors-browser.js +0 -0
  394. /package/node_modules/{tar-stream → tar-fs}/node_modules/readable-stream/errors.js +0 -0
  395. /package/node_modules/{tar-stream → tar-fs}/node_modules/readable-stream/experimentalWarning.js +0 -0
  396. /package/node_modules/{tar-stream → tar-fs}/node_modules/readable-stream/lib/internal/streams/from-browser.js +0 -0
  397. /package/node_modules/{readable-stream → tar-fs/node_modules/readable-stream}/lib/internal/streams/stream-browser.js +0 -0
  398. /package/node_modules/{readable-stream → tar-fs/node_modules/readable-stream}/lib/internal/streams/stream.js +0 -0
  399. /package/node_modules/{tar-stream → tar-fs}/node_modules/readable-stream/readable-browser.js +0 -0
  400. /package/node_modules/{tar-stream → tar-fs}/node_modules/readable-stream/readable.js +0 -0
  401. /package/node_modules/{string_decoder → tar-fs/node_modules/string_decoder}/LICENSE +0 -0
  402. /package/node_modules/{string_decoder → tar-fs/node_modules/string_decoder}/README.md +0 -0
  403. /package/node_modules/{string_decoder → tar-fs/node_modules/string_decoder}/lib/string_decoder.js +0 -0
  404. /package/node_modules/{tar-stream → tar-fs/node_modules/tar-stream}/LICENSE +0 -0
  405. /package/node_modules/{tar-stream → tar-fs/node_modules/tar-stream}/README.md +0 -0
  406. /package/node_modules/{tar-stream → tar-fs/node_modules/tar-stream}/index.js +0 -0
  407. /package/node_modules/{tar-stream → tar-fs/node_modules/tar-stream}/pack.js +0 -0
  408. /package/node_modules/{tar-stream → tar-fs/node_modules/tar-stream}/sandbox.js +0 -0
@@ -1,5 +1,4 @@
1
- // eslint-disable-next-line @typescript-eslint/no-var-requires
2
- const nodeDataChannel = require('../lib/index');
1
+ import nodeDataChannel from '../lib/index.js';
3
2
 
4
3
  nodeDataChannel.initLogger('Debug');
5
4
  nodeDataChannel.preload();
@@ -32,6 +31,9 @@ let peer1 = new nodeDataChannel.PeerConnection('Peer1', { iceServers: ['stun:stu
32
31
  peer1.onStateChange((state) => {
33
32
  console.log('Peer1 State:', state);
34
33
  });
34
+ peer1.onIceStateChange((state) => {
35
+ console.log('Peer1 IceState:', state);
36
+ });
35
37
  peer1.onGatheringStateChange((state) => {
36
38
  console.log('Peer1 GatheringState:', state);
37
39
  });
@@ -50,6 +52,9 @@ let peer2 = new nodeDataChannel.PeerConnection('Peer2', { iceServers: ['stun:stu
50
52
  peer2.onStateChange((state) => {
51
53
  console.log('Peer2 State:', state);
52
54
  });
55
+ peer2.onIceStateChange((state) => {
56
+ console.log('Peer2 IceState:', state);
57
+ });
53
58
  peer2.onGatheringStateChange((state) => {
54
59
  console.log('Peer2 GatheringState:', state);
55
60
  });
@@ -95,8 +100,8 @@ dc1.onClosed(() => {
95
100
  });
96
101
 
97
102
  setTimeout(() => {
98
- dc1.close();
99
- dc2.close();
103
+ if (dc1) dc1.close();
104
+ if (dc2) dc2.close();
100
105
  peer1.close();
101
106
  peer2.close();
102
107
  nodeDataChannel.cleanup();
@@ -0,0 +1,89 @@
1
+ import polyfill from '../polyfill/index.js';
2
+ import nodeDataChannel from '../lib/index.js';
3
+
4
+ nodeDataChannel.initLogger('Info');
5
+
6
+ let dc1 = null;
7
+ let dc2 = null;
8
+
9
+ let peer1 = new polyfill.RTCPeerConnection({
10
+ peerIdentity: 'peer1',
11
+ iceServers: [{ urls: ['stun:stun.l.google.com:19302'] }],
12
+ });
13
+
14
+ // Set Callbacks
15
+ peer1.onconnectionstatechange = () => {
16
+ console.log('Peer1 State:', peer1.connectionState);
17
+ };
18
+ peer1.oniceconnectionstatechange = () => {
19
+ console.log('Peer1 IceState:', peer1.iceConnectionState);
20
+ };
21
+ peer1.onicegatheringstatechange = () => {
22
+ console.log('Peer1 GatheringState:', peer1.iceGatheringState);
23
+ };
24
+ peer1.onicecandidate = (e) => {
25
+ console.log('Peer1 Candidate:', e.candidate.candidate);
26
+ peer2.addIceCandidate(e.candidate);
27
+ };
28
+
29
+ let peer2 = new polyfill.RTCPeerConnection({
30
+ peerIdentity: 'peer2',
31
+ iceServers: [{ urls: ['stun:stun.l.google.com:19302'] }],
32
+ });
33
+
34
+ // Set Callbacks
35
+ peer2.onconnectionstatechange = () => {
36
+ console.log('Peer2 State:', peer2.connectionState);
37
+ };
38
+ peer2.oniceconnectionstatechange = () => {
39
+ console.log('Peer2 IceState:', peer2.iceConnectionState);
40
+ };
41
+ peer2.onicegatheringstatechange = () => {
42
+ console.log('Peer2 GatheringState:', peer2.iceGatheringState);
43
+ };
44
+ peer2.onicecandidate = (e) => {
45
+ console.log('Peer2 Candidate:', e.candidate.candidate);
46
+ peer1.addIceCandidate(e.candidate);
47
+ };
48
+ peer2.ondatachannel = (dce) => {
49
+ console.log('Peer2 Got DataChannel: ', dce.channel.label);
50
+ dc2 = dce.channel;
51
+ dc2.onmessage = (msg) => {
52
+ console.log('Peer2 Received Msg:', msg.data.toString());
53
+ };
54
+ dc2.send('Hello From Peer2');
55
+ dc2.onclose = () => {
56
+ console.log('dc2 closed');
57
+ };
58
+ };
59
+
60
+ dc1 = peer1.createDataChannel('test');
61
+ dc1.onopen = () => {
62
+ dc1.send('Hello from Peer1');
63
+ };
64
+ dc1.onmessage = (msg) => {
65
+ console.log('Peer1 Received Msg:', msg.data.toString());
66
+ };
67
+ dc1.onclose = () => {
68
+ console.log('dc1 closed');
69
+ };
70
+
71
+ peer1
72
+ .createOffer({})
73
+ .then((desc) => {
74
+ peer2.setRemoteDescription(desc);
75
+ })
76
+ .catch((err) => console.error(err));
77
+
78
+ peer2
79
+ .createAnswer({})
80
+ .then((answerDesc) => {
81
+ peer1.setRemoteDescription(answerDesc);
82
+ })
83
+ .catch((err) => console.error("Couldn't create answer", err));
84
+
85
+ setTimeout(() => {
86
+ peer1.close();
87
+ peer2.close();
88
+ nodeDataChannel.cleanup();
89
+ }, 5 * 1000);
package/test/test.js CHANGED
@@ -1,5 +1,5 @@
1
- // eslint-disable-next-line @typescript-eslint/no-var-requires
2
- const nodeDataChannel = require('../lib/index');
1
+ import { jest } from '@jest/globals';
2
+ import nodeDataChannel, { DataChannelStream } from '../lib/index.js';
3
3
 
4
4
  describe('Module Definition', () => {
5
5
  test('Module Defined', () => {
@@ -154,7 +154,7 @@ describe('DataChannel streams', () => {
154
154
  let clientPeer = new nodeDataChannel.PeerConnection('Client', { iceServers: [] });
155
155
  let echoPeer = new nodeDataChannel.PeerConnection('Client', { iceServers: [] });
156
156
 
157
- const echoStream = new nodeDataChannel.DataChannelStream(echoPeer.createDataChannel('echo-channel'));
157
+ const echoStream = new DataChannelStream(echoPeer.createDataChannel('echo-channel'));
158
158
  echoStream.pipe(echoStream); // Echo all received data back to the client
159
159
 
160
160
  await waitForGathering(echoPeer);
package/test/wpt.js ADDED
@@ -0,0 +1,50 @@
1
+ // RUn WPT manually before calling this script
2
+ // Example: ./wpt serve
3
+ // Example: node test/wpt.js
4
+
5
+ import { JSDOM } from 'jsdom';
6
+ import nodeDataChannel from '../lib/index.js';
7
+
8
+ const WPT_SERVER_URL = 'http://web-platform.test:8000';
9
+ const WPT_TEST_PATH_LIST = ['/webrtc/RTCPeerConnection-addIceCandidate.html', '/webrtc/RTCDataChannel-send.html'];
10
+
11
+ // call runTest for each test path
12
+ for (let i = 0; i < WPT_TEST_PATH_LIST.length; i++) {
13
+ let result = await runTest(`${WPT_SERVER_URL}${WPT_TEST_PATH_LIST[i]}`);
14
+ console.log(result);
15
+
16
+ // sleep for 1 second
17
+ await new Promise((resolve) => setTimeout(resolve, 1000));
18
+ }
19
+
20
+ function runTest(filePath) {
21
+ // return new promise
22
+ return new Promise((resolve, reject) => {
23
+ JSDOM.fromURL(filePath, {
24
+ runScripts: 'dangerously',
25
+ resources: 'usable',
26
+ }).then((dom) => {
27
+ const { window } = dom;
28
+
29
+ // Assign the data channel polyfill to the window object
30
+ Object.assign(window, nodeDataChannel);
31
+
32
+ const returnObject = [];
33
+ window.addEventListener('load', () => {
34
+ window.add_result_callback((test) => {
35
+ // Meaning of status
36
+ // 0: PASS (test passed)
37
+ // 1: FAIL (test failed)
38
+ // 2: TIMEOUT (test timed out)
39
+ // 3: PRECONDITION_FAILED (test skipped)
40
+ returnObject.push({ name: test.name, message: test.message, status: test.status });
41
+ });
42
+
43
+ window.add_completion_callback(() => {
44
+ window.close();
45
+ return resolve(returnObject);
46
+ });
47
+ });
48
+ });
49
+ });
50
+ }
@@ -1,21 +0,0 @@
1
- # Examples
2
-
3
- # client-server
4
- * You can use client-server example project to test WebRTC Data Channels with WebSocket signaling.
5
- * It uses same logic of [libdatachannel/examples/client](https://github.com/paullouisageneau/libdatachannel/tree/master/examples) project.
6
- * Contains an equivalent implementation for a node.js signaling server
7
-
8
- ## How to Use?
9
- * Prepare Project
10
- * cd examples/client-server
11
- * npm i
12
- * Start ws signaling server;
13
- * node signaling-server.js
14
- * Start answerer (On a new Console);
15
- * node client.js
16
- * Note local ID
17
- * Start Offerer (On a new Console);
18
- * node client.js
19
- * Enter answerer ID
20
-
21
- > You can also use [libdatachannel/examples/client](https://github.com/paullouisageneau/libdatachannel/tree/master/examples) project's client & signaling server
@@ -1,4 +0,0 @@
1
- 'use strict';
2
- module.exports = function () {
3
- return /[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-PRZcf-nqry=><]/g;
4
- };
@@ -1,111 +0,0 @@
1
- {
2
- "_args": [
3
- [
4
- "ansi-regex@2.1.1",
5
- "/home/runner/work/node-datachannel/node-datachannel"
6
- ]
7
- ],
8
- "_from": "ansi-regex@2.1.1",
9
- "_id": "ansi-regex@2.1.1",
10
- "_inBundle": false,
11
- "_integrity": "sha1-w7M6te42DYbg5ijwRorn7yfWVN8=",
12
- "_location": "/ansi-regex",
13
- "_phantomChildren": {},
14
- "_requested": {
15
- "type": "version",
16
- "registry": true,
17
- "raw": "ansi-regex@2.1.1",
18
- "name": "ansi-regex",
19
- "escapedName": "ansi-regex",
20
- "rawSpec": "2.1.1",
21
- "saveSpec": null,
22
- "fetchSpec": "2.1.1"
23
- },
24
- "_requiredBy": [
25
- "/strip-ansi"
26
- ],
27
- "_resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-2.1.1.tgz",
28
- "_spec": "2.1.1",
29
- "_where": "/home/runner/work/node-datachannel/node-datachannel",
30
- "author": {
31
- "name": "Sindre Sorhus",
32
- "email": "sindresorhus@gmail.com",
33
- "url": "sindresorhus.com"
34
- },
35
- "bugs": {
36
- "url": "https://github.com/chalk/ansi-regex/issues"
37
- },
38
- "description": "Regular expression for matching ANSI escape codes",
39
- "devDependencies": {
40
- "ava": "0.17.0",
41
- "xo": "0.16.0"
42
- },
43
- "engines": {
44
- "node": ">=0.10.0"
45
- },
46
- "files": [
47
- "index.js"
48
- ],
49
- "homepage": "https://github.com/chalk/ansi-regex#readme",
50
- "keywords": [
51
- "ansi",
52
- "styles",
53
- "color",
54
- "colour",
55
- "colors",
56
- "terminal",
57
- "console",
58
- "cli",
59
- "string",
60
- "tty",
61
- "escape",
62
- "formatting",
63
- "rgb",
64
- "256",
65
- "shell",
66
- "xterm",
67
- "command-line",
68
- "text",
69
- "regex",
70
- "regexp",
71
- "re",
72
- "match",
73
- "test",
74
- "find",
75
- "pattern"
76
- ],
77
- "license": "MIT",
78
- "maintainers": [
79
- {
80
- "name": "Sindre Sorhus",
81
- "email": "sindresorhus@gmail.com",
82
- "url": "sindresorhus.com"
83
- },
84
- {
85
- "name": "Joshua Appelman",
86
- "email": "jappelman@xebia.com",
87
- "url": "jbnicolai.com"
88
- },
89
- {
90
- "name": "JD Ballard",
91
- "email": "i.am.qix@gmail.com",
92
- "url": "github.com/qix-"
93
- }
94
- ],
95
- "name": "ansi-regex",
96
- "repository": {
97
- "type": "git",
98
- "url": "git+https://github.com/chalk/ansi-regex.git"
99
- },
100
- "scripts": {
101
- "test": "xo && ava --verbose",
102
- "view-supported": "node fixtures/view-codes.js"
103
- },
104
- "version": "2.1.1",
105
- "xo": {
106
- "rules": {
107
- "guard-for-in": 0,
108
- "no-loop-func": 0
109
- }
110
- }
111
- }
@@ -1,39 +0,0 @@
1
- # ansi-regex [![Build Status](https://travis-ci.org/chalk/ansi-regex.svg?branch=master)](https://travis-ci.org/chalk/ansi-regex)
2
-
3
- > Regular expression for matching [ANSI escape codes](http://en.wikipedia.org/wiki/ANSI_escape_code)
4
-
5
-
6
- ## Install
7
-
8
- ```
9
- $ npm install --save ansi-regex
10
- ```
11
-
12
-
13
- ## Usage
14
-
15
- ```js
16
- const ansiRegex = require('ansi-regex');
17
-
18
- ansiRegex().test('\u001b[4mcake\u001b[0m');
19
- //=> true
20
-
21
- ansiRegex().test('cake');
22
- //=> false
23
-
24
- '\u001b[4mcake\u001b[0m'.match(ansiRegex());
25
- //=> ['\u001b[4m', '\u001b[0m']
26
- ```
27
-
28
- ## FAQ
29
-
30
- ### Why do you test for codes not in the ECMA 48 standard?
31
-
32
- Some of the codes we run as a test are codes that we acquired finding various lists of non-standard or manufacturer specific codes. If I recall correctly, we test for both standard and non-standard codes, as most of them follow the same or similar format and can be safely matched in strings without the risk of removing actual string content. There are a few non-standard control codes that do not follow the traditional format (i.e. they end in numbers) thus forcing us to exclude them from the test because we cannot reliably match them.
33
-
34
- On the historical side, those ECMA standards were established in the early 90's whereas the VT100, for example, was designed in the mid/late 70's. At that point in time, control codes were still pretty ungoverned and engineers used them for a multitude of things, namely to activate hardware ports that may have been proprietary. Somewhere else you see a similar 'anarchy' of codes is in the x86 architecture for processors; there are a ton of "interrupts" that can mean different things on certain brands of processors, most of which have been phased out.
35
-
36
-
37
- ## License
38
-
39
- MIT © [Sindre Sorhus](http://sindresorhus.com)
@@ -1,14 +0,0 @@
1
- Copyright (c) 2015, Rebecca Turner <me@re-becca.org>
2
-
3
- Permission to use, copy, modify, and/or distribute this software for any
4
- purpose with or without fee is hereby granted, provided that the above
5
- copyright notice and this permission notice appear in all copies.
6
-
7
- THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
8
- WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
9
- MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
10
- ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
11
- WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
12
- ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
13
- OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
14
-
@@ -1,94 +0,0 @@
1
- aproba
2
- ======
3
-
4
- A ridiculously light-weight function argument validator
5
-
6
- ```
7
- var validate = require("aproba")
8
-
9
- function myfunc(a, b, c) {
10
- // `a` must be a string, `b` a number, `c` a function
11
- validate('SNF', arguments) // [a,b,c] is also valid
12
- }
13
-
14
- myfunc('test', 23, function () {}) // ok
15
- myfunc(123, 23, function () {}) // type error
16
- myfunc('test', 23) // missing arg error
17
- myfunc('test', 23, function () {}, true) // too many args error
18
-
19
- ```
20
-
21
- Valid types are:
22
-
23
- | type | description
24
- | :--: | :----------
25
- | * | matches any type
26
- | A | `Array.isArray` OR an `arguments` object
27
- | S | typeof == string
28
- | N | typeof == number
29
- | F | typeof == function
30
- | O | typeof == object and not type A and not type E
31
- | B | typeof == boolean
32
- | E | `instanceof Error` OR `null` **(special: see below)**
33
- | Z | == `null`
34
-
35
- Validation failures throw one of three exception types, distinguished by a
36
- `code` property of `EMISSINGARG`, `EINVALIDTYPE` or `ETOOMANYARGS`.
37
-
38
- If you pass in an invalid type then it will throw with a code of
39
- `EUNKNOWNTYPE`.
40
-
41
- If an **error** argument is found and is not null then the remaining
42
- arguments are optional. That is, if you say `ESO` then that's like using a
43
- non-magical `E` in: `E|ESO|ZSO`.
44
-
45
- ### But I have optional arguments?!
46
-
47
- You can provide more than one signature by separating them with pipes `|`.
48
- If any signature matches the arguments then they'll be considered valid.
49
-
50
- So for example, say you wanted to write a signature for
51
- `fs.createWriteStream`. The docs for it describe it thusly:
52
-
53
- ```
54
- fs.createWriteStream(path[, options])
55
- ```
56
-
57
- This would be a signature of `SO|S`. That is, a string and and object, or
58
- just a string.
59
-
60
- Now, if you read the full `fs` docs, you'll see that actually path can ALSO
61
- be a buffer. And options can be a string, that is:
62
- ```
63
- path <String> | <Buffer>
64
- options <String> | <Object>
65
- ```
66
-
67
- To reproduce this you have to fully enumerate all of the possible
68
- combinations and that implies a signature of `SO|SS|OO|OS|S|O`. The
69
- awkwardness is a feature: It reminds you of the complexity you're adding to
70
- your API when you do this sort of thing.
71
-
72
-
73
- ### Browser support
74
-
75
- This has no dependencies and should work in browsers, though you'll have
76
- noisier stack traces.
77
-
78
- ### Why this exists
79
-
80
- I wanted a very simple argument validator. It needed to do two things:
81
-
82
- 1. Be more concise and easier to use than assertions
83
-
84
- 2. Not encourage an infinite bikeshed of DSLs
85
-
86
- This is why types are specified by a single character and there's no such
87
- thing as an optional argument.
88
-
89
- This is not intended to validate user data. This is specifically about
90
- asserting the interface of your functions.
91
-
92
- If you need greater validation, I encourage you to write them by hand or
93
- look elsewhere.
94
-
@@ -1,105 +0,0 @@
1
- 'use strict'
2
-
3
- function isArguments (thingy) {
4
- return thingy != null && typeof thingy === 'object' && thingy.hasOwnProperty('callee')
5
- }
6
-
7
- var types = {
8
- '*': {label: 'any', check: function () { return true }},
9
- A: {label: 'array', check: function (thingy) { return Array.isArray(thingy) || isArguments(thingy) }},
10
- S: {label: 'string', check: function (thingy) { return typeof thingy === 'string' }},
11
- N: {label: 'number', check: function (thingy) { return typeof thingy === 'number' }},
12
- F: {label: 'function', check: function (thingy) { return typeof thingy === 'function' }},
13
- O: {label: 'object', check: function (thingy) { return typeof thingy === 'object' && thingy != null && !types.A.check(thingy) && !types.E.check(thingy) }},
14
- B: {label: 'boolean', check: function (thingy) { return typeof thingy === 'boolean' }},
15
- E: {label: 'error', check: function (thingy) { return thingy instanceof Error }},
16
- Z: {label: 'null', check: function (thingy) { return thingy == null }}
17
- }
18
-
19
- function addSchema (schema, arity) {
20
- var group = arity[schema.length] = arity[schema.length] || []
21
- if (group.indexOf(schema) === -1) group.push(schema)
22
- }
23
-
24
- var validate = module.exports = function (rawSchemas, args) {
25
- if (arguments.length !== 2) throw wrongNumberOfArgs(['SA'], arguments.length)
26
- if (!rawSchemas) throw missingRequiredArg(0, 'rawSchemas')
27
- if (!args) throw missingRequiredArg(1, 'args')
28
- if (!types.S.check(rawSchemas)) throw invalidType(0, ['string'], rawSchemas)
29
- if (!types.A.check(args)) throw invalidType(1, ['array'], args)
30
- var schemas = rawSchemas.split('|')
31
- var arity = {}
32
-
33
- schemas.forEach(function (schema) {
34
- for (var ii = 0; ii < schema.length; ++ii) {
35
- var type = schema[ii]
36
- if (!types[type]) throw unknownType(ii, type)
37
- }
38
- if (/E.*E/.test(schema)) throw moreThanOneError(schema)
39
- addSchema(schema, arity)
40
- if (/E/.test(schema)) {
41
- addSchema(schema.replace(/E.*$/, 'E'), arity)
42
- addSchema(schema.replace(/E/, 'Z'), arity)
43
- if (schema.length === 1) addSchema('', arity)
44
- }
45
- })
46
- var matching = arity[args.length]
47
- if (!matching) {
48
- throw wrongNumberOfArgs(Object.keys(arity), args.length)
49
- }
50
- for (var ii = 0; ii < args.length; ++ii) {
51
- var newMatching = matching.filter(function (schema) {
52
- var type = schema[ii]
53
- var typeCheck = types[type].check
54
- return typeCheck(args[ii])
55
- })
56
- if (!newMatching.length) {
57
- var labels = matching.map(function (schema) {
58
- return types[schema[ii]].label
59
- }).filter(function (schema) { return schema != null })
60
- throw invalidType(ii, labels, args[ii])
61
- }
62
- matching = newMatching
63
- }
64
- }
65
-
66
- function missingRequiredArg (num) {
67
- return newException('EMISSINGARG', 'Missing required argument #' + (num + 1))
68
- }
69
-
70
- function unknownType (num, type) {
71
- return newException('EUNKNOWNTYPE', 'Unknown type ' + type + ' in argument #' + (num + 1))
72
- }
73
-
74
- function invalidType (num, expectedTypes, value) {
75
- var valueType
76
- Object.keys(types).forEach(function (typeCode) {
77
- if (types[typeCode].check(value)) valueType = types[typeCode].label
78
- })
79
- return newException('EINVALIDTYPE', 'Argument #' + (num + 1) + ': Expected ' +
80
- englishList(expectedTypes) + ' but got ' + valueType)
81
- }
82
-
83
- function englishList (list) {
84
- return list.join(', ').replace(/, ([^,]+)$/, ' or $1')
85
- }
86
-
87
- function wrongNumberOfArgs (expected, got) {
88
- var english = englishList(expected)
89
- var args = expected.every(function (ex) { return ex.length === 1 })
90
- ? 'argument'
91
- : 'arguments'
92
- return newException('EWRONGARGCOUNT', 'Expected ' + english + ' ' + args + ' but got ' + got)
93
- }
94
-
95
- function moreThanOneError (schema) {
96
- return newException('ETOOMANYERRORTYPES',
97
- 'Only one error type per argument signature is allowed, more than one found in "' + schema + '"')
98
- }
99
-
100
- function newException (code, msg) {
101
- var e = new Error(msg)
102
- e.code = code
103
- if (Error.captureStackTrace) Error.captureStackTrace(e, validate)
104
- return e
105
- }
@@ -1,65 +0,0 @@
1
- {
2
- "_args": [
3
- [
4
- "aproba@1.2.0",
5
- "/home/runner/work/node-datachannel/node-datachannel"
6
- ]
7
- ],
8
- "_from": "aproba@1.2.0",
9
- "_id": "aproba@1.2.0",
10
- "_inBundle": false,
11
- "_integrity": "sha512-Y9J6ZjXtoYh8RnXVCMOU/ttDmk1aBjunq9vO0ta5x85WDQiQfUF9sIPBITdbiiIVcBo03Hi3jMxigBtsddlXRw==",
12
- "_location": "/aproba",
13
- "_phantomChildren": {},
14
- "_requested": {
15
- "type": "version",
16
- "registry": true,
17
- "raw": "aproba@1.2.0",
18
- "name": "aproba",
19
- "escapedName": "aproba",
20
- "rawSpec": "1.2.0",
21
- "saveSpec": null,
22
- "fetchSpec": "1.2.0"
23
- },
24
- "_requiredBy": [
25
- "/npmlog/gauge"
26
- ],
27
- "_resolved": "https://registry.npmjs.org/aproba/-/aproba-1.2.0.tgz",
28
- "_spec": "1.2.0",
29
- "_where": "/home/runner/work/node-datachannel/node-datachannel",
30
- "author": {
31
- "name": "Rebecca Turner",
32
- "email": "me@re-becca.org"
33
- },
34
- "bugs": {
35
- "url": "https://github.com/iarna/aproba/issues"
36
- },
37
- "dependencies": {},
38
- "description": "A ridiculously light-weight argument validator (now browser friendly)",
39
- "devDependencies": {
40
- "standard": "^10.0.3",
41
- "tap": "^10.0.2"
42
- },
43
- "directories": {
44
- "test": "test"
45
- },
46
- "files": [
47
- "index.js"
48
- ],
49
- "homepage": "https://github.com/iarna/aproba",
50
- "keywords": [
51
- "argument",
52
- "validate"
53
- ],
54
- "license": "ISC",
55
- "main": "index.js",
56
- "name": "aproba",
57
- "repository": {
58
- "type": "git",
59
- "url": "git+https://github.com/iarna/aproba.git"
60
- },
61
- "scripts": {
62
- "test": "standard && tap -j3 test/*.js"
63
- },
64
- "version": "1.2.0"
65
- }
@@ -1,32 +0,0 @@
1
- /* eslint-disable babel/new-cap, xo/throw-new-error */
2
- 'use strict';
3
- module.exports = function (str, pos) {
4
- if (str === null || str === undefined) {
5
- throw TypeError();
6
- }
7
-
8
- str = String(str);
9
-
10
- var size = str.length;
11
- var i = pos ? Number(pos) : 0;
12
-
13
- if (Number.isNaN(i)) {
14
- i = 0;
15
- }
16
-
17
- if (i < 0 || i >= size) {
18
- return undefined;
19
- }
20
-
21
- var first = str.charCodeAt(i);
22
-
23
- if (first >= 0xD800 && first <= 0xDBFF && size > i + 1) {
24
- var second = str.charCodeAt(i + 1);
25
-
26
- if (second >= 0xDC00 && second <= 0xDFFF) {
27
- return ((first - 0xD800) * 0x400) + second - 0xDC00 + 0x10000;
28
- }
29
- }
30
-
31
- return first;
32
- };