pi-cursor-sdk 0.1.50 → 0.1.52

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 (279) hide show
  1. package/CHANGELOG.md +31 -0
  2. package/README.md +1 -1
  3. package/docs/cursor-live-smoke-checklist.md +4 -4
  4. package/docs/cursor-model-ux-spec.md +5 -5
  5. package/docs/cursor-native-tool-replay.md +2 -2
  6. package/docs/cursor-native-tool-visual-audit.md +1 -1
  7. package/docs/cursor-testing-lessons.md +1 -1
  8. package/package.json +3 -12
  9. package/src/cursor-fallback-models.generated.ts +536 -302
  10. package/src/cursor-provider-errors.ts +29 -0
  11. package/src/cursor-provider-turn-runner.ts +1 -1
  12. package/src/cursor-provider.ts +9 -2
  13. package/src/cursor-session-turn-queue.ts +52 -0
  14. package/src/cursor-tool-manifest.ts +1 -1
  15. package/node_modules/@connectrpc/connect-node/README.md +0 -141
  16. package/node_modules/@connectrpc/connect-node/dist/cjs/compression.d.ts +0 -15
  17. package/node_modules/@connectrpc/connect-node/dist/cjs/compression.js +0 -89
  18. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-node-adapter.d.ts +0 -42
  19. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-node-adapter.js +0 -61
  20. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-transport.d.ts +0 -100
  21. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-transport.js +0 -25
  22. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-transport.d.ts +0 -96
  23. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-transport.js +0 -25
  24. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-web-transport.d.ts +0 -96
  25. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-web-transport.js +0 -25
  26. package/node_modules/@connectrpc/connect-node/dist/cjs/http2-session-manager.d.ts +0 -146
  27. package/node_modules/@connectrpc/connect-node/dist/cjs/http2-session-manager.js +0 -536
  28. package/node_modules/@connectrpc/connect-node/dist/cjs/index.d.ts +0 -15
  29. package/node_modules/@connectrpc/connect-node/dist/cjs/index.js +0 -36
  30. package/node_modules/@connectrpc/connect-node/dist/cjs/node-error.d.ts +0 -45
  31. package/node_modules/@connectrpc/connect-node/dist/cjs/node-error.js +0 -154
  32. package/node_modules/@connectrpc/connect-node/dist/cjs/node-headers-polyfill.d.ts +0 -1
  33. package/node_modules/@connectrpc/connect-node/dist/cjs/node-headers-polyfill.js +0 -29
  34. package/node_modules/@connectrpc/connect-node/dist/cjs/node-transport-options.d.ts +0 -89
  35. package/node_modules/@connectrpc/connect-node/dist/cjs/node-transport-options.js +0 -58
  36. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-client.d.ts +0 -54
  37. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-client.js +0 -326
  38. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-handler.d.ts +0 -41
  39. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-handler.js +0 -234
  40. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-header.d.ts +0 -19
  41. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-header.js +0 -97
  42. package/node_modules/@connectrpc/connect-node/dist/cjs/package.json +0 -1
  43. package/node_modules/@connectrpc/connect-node/dist/esm/compression.d.ts +0 -15
  44. package/node_modules/@connectrpc/connect-node/dist/esm/compression.js +0 -86
  45. package/node_modules/@connectrpc/connect-node/dist/esm/connect-node-adapter.d.ts +0 -42
  46. package/node_modules/@connectrpc/connect-node/dist/esm/connect-node-adapter.js +0 -58
  47. package/node_modules/@connectrpc/connect-node/dist/esm/connect-transport.d.ts +0 -100
  48. package/node_modules/@connectrpc/connect-node/dist/esm/connect-transport.js +0 -22
  49. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-transport.d.ts +0 -96
  50. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-transport.js +0 -22
  51. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-web-transport.d.ts +0 -96
  52. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-web-transport.js +0 -22
  53. package/node_modules/@connectrpc/connect-node/dist/esm/http2-session-manager.d.ts +0 -146
  54. package/node_modules/@connectrpc/connect-node/dist/esm/http2-session-manager.js +0 -532
  55. package/node_modules/@connectrpc/connect-node/dist/esm/index.d.ts +0 -15
  56. package/node_modules/@connectrpc/connect-node/dist/esm/index.js +0 -23
  57. package/node_modules/@connectrpc/connect-node/dist/esm/node-error.d.ts +0 -45
  58. package/node_modules/@connectrpc/connect-node/dist/esm/node-error.js +0 -147
  59. package/node_modules/@connectrpc/connect-node/dist/esm/node-headers-polyfill.d.ts +0 -1
  60. package/node_modules/@connectrpc/connect-node/dist/esm/node-headers-polyfill.js +0 -27
  61. package/node_modules/@connectrpc/connect-node/dist/esm/node-transport-options.d.ts +0 -89
  62. package/node_modules/@connectrpc/connect-node/dist/esm/node-transport-options.js +0 -58
  63. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-client.d.ts +0 -54
  64. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-client.js +0 -324
  65. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-handler.d.ts +0 -41
  66. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-handler.js +0 -230
  67. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-header.d.ts +0 -19
  68. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-header.js +0 -93
  69. package/node_modules/@connectrpc/connect-node/package.json +0 -46
  70. package/node_modules/undici/LICENSE +0 -21
  71. package/node_modules/undici/README.md +0 -741
  72. package/node_modules/undici/docs/docs/api/Agent.md +0 -84
  73. package/node_modules/undici/docs/docs/api/BalancedPool.md +0 -99
  74. package/node_modules/undici/docs/docs/api/CacheStorage.md +0 -30
  75. package/node_modules/undici/docs/docs/api/CacheStore.md +0 -164
  76. package/node_modules/undici/docs/docs/api/Client.md +0 -288
  77. package/node_modules/undici/docs/docs/api/ClientStats.md +0 -27
  78. package/node_modules/undici/docs/docs/api/Connector.md +0 -115
  79. package/node_modules/undici/docs/docs/api/ContentType.md +0 -57
  80. package/node_modules/undici/docs/docs/api/Cookies.md +0 -128
  81. package/node_modules/undici/docs/docs/api/Debug.md +0 -62
  82. package/node_modules/undici/docs/docs/api/DiagnosticsChannel.md +0 -315
  83. package/node_modules/undici/docs/docs/api/Dispatcher.md +0 -1392
  84. package/node_modules/undici/docs/docs/api/EnvHttpProxyAgent.md +0 -159
  85. package/node_modules/undici/docs/docs/api/Errors.md +0 -49
  86. package/node_modules/undici/docs/docs/api/EventSource.md +0 -45
  87. package/node_modules/undici/docs/docs/api/Fetch.md +0 -60
  88. package/node_modules/undici/docs/docs/api/GlobalInstallation.md +0 -139
  89. package/node_modules/undici/docs/docs/api/H2CClient.md +0 -263
  90. package/node_modules/undici/docs/docs/api/MockAgent.md +0 -603
  91. package/node_modules/undici/docs/docs/api/MockCallHistory.md +0 -197
  92. package/node_modules/undici/docs/docs/api/MockCallHistoryLog.md +0 -43
  93. package/node_modules/undici/docs/docs/api/MockClient.md +0 -81
  94. package/node_modules/undici/docs/docs/api/MockErrors.md +0 -12
  95. package/node_modules/undici/docs/docs/api/MockPool.md +0 -555
  96. package/node_modules/undici/docs/docs/api/Pool.md +0 -84
  97. package/node_modules/undici/docs/docs/api/PoolStats.md +0 -35
  98. package/node_modules/undici/docs/docs/api/ProxyAgent.md +0 -229
  99. package/node_modules/undici/docs/docs/api/RedirectHandler.md +0 -93
  100. package/node_modules/undici/docs/docs/api/RetryAgent.md +0 -50
  101. package/node_modules/undici/docs/docs/api/RetryHandler.md +0 -118
  102. package/node_modules/undici/docs/docs/api/RoundRobinPool.md +0 -145
  103. package/node_modules/undici/docs/docs/api/SnapshotAgent.md +0 -616
  104. package/node_modules/undici/docs/docs/api/Socks5ProxyAgent.md +0 -275
  105. package/node_modules/undici/docs/docs/api/Util.md +0 -25
  106. package/node_modules/undici/docs/docs/api/WebSocket.md +0 -141
  107. package/node_modules/undici/docs/docs/api/api-lifecycle.md +0 -91
  108. package/node_modules/undici/docs/docs/best-practices/client-certificate.md +0 -64
  109. package/node_modules/undici/docs/docs/best-practices/crawling.md +0 -58
  110. package/node_modules/undici/docs/docs/best-practices/mocking-request.md +0 -190
  111. package/node_modules/undici/docs/docs/best-practices/proxy.md +0 -127
  112. package/node_modules/undici/docs/docs/best-practices/undici-vs-builtin-fetch.md +0 -224
  113. package/node_modules/undici/docs/docs/best-practices/writing-tests.md +0 -63
  114. package/node_modules/undici/index-fetch.js +0 -65
  115. package/node_modules/undici/index.d.ts +0 -3
  116. package/node_modules/undici/index.js +0 -234
  117. package/node_modules/undici/lib/api/abort-signal.js +0 -59
  118. package/node_modules/undici/lib/api/api-connect.js +0 -110
  119. package/node_modules/undici/lib/api/api-pipeline.js +0 -252
  120. package/node_modules/undici/lib/api/api-request.js +0 -214
  121. package/node_modules/undici/lib/api/api-stream.js +0 -209
  122. package/node_modules/undici/lib/api/api-upgrade.js +0 -111
  123. package/node_modules/undici/lib/api/index.js +0 -7
  124. package/node_modules/undici/lib/api/readable.js +0 -580
  125. package/node_modules/undici/lib/cache/memory-cache-store.js +0 -234
  126. package/node_modules/undici/lib/cache/sqlite-cache-store.js +0 -461
  127. package/node_modules/undici/lib/core/connect.js +0 -153
  128. package/node_modules/undici/lib/core/constants.js +0 -143
  129. package/node_modules/undici/lib/core/diagnostics.js +0 -227
  130. package/node_modules/undici/lib/core/errors.js +0 -477
  131. package/node_modules/undici/lib/core/request.js +0 -453
  132. package/node_modules/undici/lib/core/socks5-client.js +0 -422
  133. package/node_modules/undici/lib/core/socks5-utils.js +0 -212
  134. package/node_modules/undici/lib/core/symbols.js +0 -75
  135. package/node_modules/undici/lib/core/tree.js +0 -160
  136. package/node_modules/undici/lib/core/util.js +0 -992
  137. package/node_modules/undici/lib/dispatcher/agent.js +0 -158
  138. package/node_modules/undici/lib/dispatcher/balanced-pool.js +0 -219
  139. package/node_modules/undici/lib/dispatcher/client-h1.js +0 -1722
  140. package/node_modules/undici/lib/dispatcher/client-h2.js +0 -995
  141. package/node_modules/undici/lib/dispatcher/client.js +0 -664
  142. package/node_modules/undici/lib/dispatcher/dispatcher-base.js +0 -184
  143. package/node_modules/undici/lib/dispatcher/dispatcher.js +0 -48
  144. package/node_modules/undici/lib/dispatcher/env-http-proxy-agent.js +0 -146
  145. package/node_modules/undici/lib/dispatcher/fixed-queue.js +0 -135
  146. package/node_modules/undici/lib/dispatcher/h2c-client.js +0 -51
  147. package/node_modules/undici/lib/dispatcher/pool-base.js +0 -214
  148. package/node_modules/undici/lib/dispatcher/pool.js +0 -118
  149. package/node_modules/undici/lib/dispatcher/proxy-agent.js +0 -319
  150. package/node_modules/undici/lib/dispatcher/retry-agent.js +0 -35
  151. package/node_modules/undici/lib/dispatcher/round-robin-pool.js +0 -137
  152. package/node_modules/undici/lib/dispatcher/socks5-proxy-agent.js +0 -260
  153. package/node_modules/undici/lib/encoding/index.js +0 -33
  154. package/node_modules/undici/lib/global.js +0 -59
  155. package/node_modules/undici/lib/handler/cache-handler.js +0 -578
  156. package/node_modules/undici/lib/handler/cache-revalidation-handler.js +0 -124
  157. package/node_modules/undici/lib/handler/decorator-handler.js +0 -67
  158. package/node_modules/undici/lib/handler/deduplication-handler.js +0 -460
  159. package/node_modules/undici/lib/handler/redirect-handler.js +0 -238
  160. package/node_modules/undici/lib/handler/retry-handler.js +0 -394
  161. package/node_modules/undici/lib/handler/unwrap-handler.js +0 -106
  162. package/node_modules/undici/lib/handler/wrap-handler.js +0 -105
  163. package/node_modules/undici/lib/interceptor/cache.js +0 -495
  164. package/node_modules/undici/lib/interceptor/decompress.js +0 -259
  165. package/node_modules/undici/lib/interceptor/deduplicate.js +0 -117
  166. package/node_modules/undici/lib/interceptor/dns.js +0 -571
  167. package/node_modules/undici/lib/interceptor/dump.js +0 -112
  168. package/node_modules/undici/lib/interceptor/redirect.js +0 -21
  169. package/node_modules/undici/lib/interceptor/response-error.js +0 -95
  170. package/node_modules/undici/lib/interceptor/retry.js +0 -19
  171. package/node_modules/undici/lib/llhttp/.gitkeep +0 -0
  172. package/node_modules/undici/lib/llhttp/constants.d.ts +0 -195
  173. package/node_modules/undici/lib/llhttp/constants.js +0 -531
  174. package/node_modules/undici/lib/llhttp/llhttp-wasm.js +0 -15
  175. package/node_modules/undici/lib/llhttp/llhttp_simd-wasm.js +0 -15
  176. package/node_modules/undici/lib/llhttp/utils.d.ts +0 -2
  177. package/node_modules/undici/lib/llhttp/utils.js +0 -12
  178. package/node_modules/undici/lib/mock/mock-agent.js +0 -232
  179. package/node_modules/undici/lib/mock/mock-call-history.js +0 -248
  180. package/node_modules/undici/lib/mock/mock-client.js +0 -68
  181. package/node_modules/undici/lib/mock/mock-errors.js +0 -29
  182. package/node_modules/undici/lib/mock/mock-interceptor.js +0 -209
  183. package/node_modules/undici/lib/mock/mock-pool.js +0 -68
  184. package/node_modules/undici/lib/mock/mock-symbols.js +0 -32
  185. package/node_modules/undici/lib/mock/mock-utils.js +0 -486
  186. package/node_modules/undici/lib/mock/pending-interceptors-formatter.js +0 -43
  187. package/node_modules/undici/lib/mock/snapshot-agent.js +0 -353
  188. package/node_modules/undici/lib/mock/snapshot-recorder.js +0 -588
  189. package/node_modules/undici/lib/mock/snapshot-utils.js +0 -158
  190. package/node_modules/undici/lib/util/cache.js +0 -414
  191. package/node_modules/undici/lib/util/date.js +0 -653
  192. package/node_modules/undici/lib/util/promise.js +0 -28
  193. package/node_modules/undici/lib/util/runtime-features.js +0 -124
  194. package/node_modules/undici/lib/util/stats.js +0 -32
  195. package/node_modules/undici/lib/util/timers.js +0 -425
  196. package/node_modules/undici/lib/web/cache/cache.js +0 -864
  197. package/node_modules/undici/lib/web/cache/cachestorage.js +0 -152
  198. package/node_modules/undici/lib/web/cache/util.js +0 -45
  199. package/node_modules/undici/lib/web/cookies/constants.js +0 -12
  200. package/node_modules/undici/lib/web/cookies/index.js +0 -199
  201. package/node_modules/undici/lib/web/cookies/parse.js +0 -314
  202. package/node_modules/undici/lib/web/cookies/util.js +0 -282
  203. package/node_modules/undici/lib/web/eventsource/eventsource-stream.js +0 -399
  204. package/node_modules/undici/lib/web/eventsource/eventsource.js +0 -501
  205. package/node_modules/undici/lib/web/eventsource/util.js +0 -29
  206. package/node_modules/undici/lib/web/fetch/LICENSE +0 -21
  207. package/node_modules/undici/lib/web/fetch/body.js +0 -509
  208. package/node_modules/undici/lib/web/fetch/constants.js +0 -131
  209. package/node_modules/undici/lib/web/fetch/data-url.js +0 -596
  210. package/node_modules/undici/lib/web/fetch/formdata-parser.js +0 -586
  211. package/node_modules/undici/lib/web/fetch/formdata.js +0 -259
  212. package/node_modules/undici/lib/web/fetch/global.js +0 -40
  213. package/node_modules/undici/lib/web/fetch/headers.js +0 -719
  214. package/node_modules/undici/lib/web/fetch/index.js +0 -2413
  215. package/node_modules/undici/lib/web/fetch/request.js +0 -1115
  216. package/node_modules/undici/lib/web/fetch/response.js +0 -641
  217. package/node_modules/undici/lib/web/fetch/util.js +0 -1522
  218. package/node_modules/undici/lib/web/infra/index.js +0 -229
  219. package/node_modules/undici/lib/web/subresource-integrity/Readme.md +0 -9
  220. package/node_modules/undici/lib/web/subresource-integrity/subresource-integrity.js +0 -307
  221. package/node_modules/undici/lib/web/webidl/index.js +0 -1006
  222. package/node_modules/undici/lib/web/websocket/connection.js +0 -329
  223. package/node_modules/undici/lib/web/websocket/constants.js +0 -126
  224. package/node_modules/undici/lib/web/websocket/events.js +0 -331
  225. package/node_modules/undici/lib/web/websocket/frame.js +0 -133
  226. package/node_modules/undici/lib/web/websocket/permessage-deflate.js +0 -100
  227. package/node_modules/undici/lib/web/websocket/receiver.js +0 -507
  228. package/node_modules/undici/lib/web/websocket/sender.js +0 -109
  229. package/node_modules/undici/lib/web/websocket/stream/websocketerror.js +0 -104
  230. package/node_modules/undici/lib/web/websocket/stream/websocketstream.js +0 -498
  231. package/node_modules/undici/lib/web/websocket/util.js +0 -347
  232. package/node_modules/undici/lib/web/websocket/websocket.js +0 -758
  233. package/node_modules/undici/package.json +0 -152
  234. package/node_modules/undici/scripts/strip-comments.js +0 -10
  235. package/node_modules/undici/types/README.md +0 -6
  236. package/node_modules/undici/types/agent.d.ts +0 -32
  237. package/node_modules/undici/types/api.d.ts +0 -43
  238. package/node_modules/undici/types/balanced-pool.d.ts +0 -30
  239. package/node_modules/undici/types/cache-interceptor.d.ts +0 -179
  240. package/node_modules/undici/types/cache.d.ts +0 -36
  241. package/node_modules/undici/types/client-stats.d.ts +0 -15
  242. package/node_modules/undici/types/client.d.ts +0 -139
  243. package/node_modules/undici/types/connector.d.ts +0 -36
  244. package/node_modules/undici/types/content-type.d.ts +0 -21
  245. package/node_modules/undici/types/cookies.d.ts +0 -30
  246. package/node_modules/undici/types/diagnostics-channel.d.ts +0 -74
  247. package/node_modules/undici/types/dispatcher.d.ts +0 -275
  248. package/node_modules/undici/types/env-http-proxy-agent.d.ts +0 -22
  249. package/node_modules/undici/types/errors.d.ts +0 -177
  250. package/node_modules/undici/types/eventsource.d.ts +0 -66
  251. package/node_modules/undici/types/fetch.d.ts +0 -231
  252. package/node_modules/undici/types/formdata.d.ts +0 -114
  253. package/node_modules/undici/types/global-dispatcher.d.ts +0 -9
  254. package/node_modules/undici/types/global-origin.d.ts +0 -7
  255. package/node_modules/undici/types/h2c-client.d.ts +0 -73
  256. package/node_modules/undici/types/handlers.d.ts +0 -14
  257. package/node_modules/undici/types/header.d.ts +0 -160
  258. package/node_modules/undici/types/index.d.ts +0 -91
  259. package/node_modules/undici/types/interceptors.d.ts +0 -80
  260. package/node_modules/undici/types/mock-agent.d.ts +0 -68
  261. package/node_modules/undici/types/mock-call-history.d.ts +0 -111
  262. package/node_modules/undici/types/mock-client.d.ts +0 -27
  263. package/node_modules/undici/types/mock-errors.d.ts +0 -12
  264. package/node_modules/undici/types/mock-interceptor.d.ts +0 -94
  265. package/node_modules/undici/types/mock-pool.d.ts +0 -27
  266. package/node_modules/undici/types/patch.d.ts +0 -29
  267. package/node_modules/undici/types/pool-stats.d.ts +0 -19
  268. package/node_modules/undici/types/pool.d.ts +0 -41
  269. package/node_modules/undici/types/proxy-agent.d.ts +0 -29
  270. package/node_modules/undici/types/readable.d.ts +0 -68
  271. package/node_modules/undici/types/retry-agent.d.ts +0 -8
  272. package/node_modules/undici/types/retry-handler.d.ts +0 -125
  273. package/node_modules/undici/types/round-robin-pool.d.ts +0 -41
  274. package/node_modules/undici/types/snapshot-agent.d.ts +0 -109
  275. package/node_modules/undici/types/socks5-proxy-agent.d.ts +0 -25
  276. package/node_modules/undici/types/util.d.ts +0 -18
  277. package/node_modules/undici/types/utility.d.ts +0 -7
  278. package/node_modules/undici/types/webidl.d.ts +0 -347
  279. package/node_modules/undici/types/websocket.d.ts +0 -188
@@ -1,1006 +0,0 @@
1
- 'use strict'
2
-
3
- const assert = require('node:assert')
4
- const { types, inspect } = require('node:util')
5
- const { runtimeFeatures } = require('../../util/runtime-features')
6
-
7
- const UNDEFINED = 1
8
- const BOOLEAN = 2
9
- const STRING = 3
10
- const SYMBOL = 4
11
- const NUMBER = 5
12
- const BIGINT = 6
13
- const NULL = 7
14
- const OBJECT = 8 // function and object
15
-
16
- const FunctionPrototypeSymbolHasInstance = Function.call.bind(Function.prototype[Symbol.hasInstance])
17
-
18
- /** @type {import('../../../types/webidl').Webidl} */
19
- const webidl = {
20
- converters: {},
21
- util: {},
22
- errors: {},
23
- is: {}
24
- }
25
-
26
- /**
27
- * @description Instantiate an error.
28
- *
29
- * @param {Object} opts
30
- * @param {string} opts.header
31
- * @param {string} opts.message
32
- * @returns {TypeError}
33
- */
34
- webidl.errors.exception = function (message) {
35
- return new TypeError(`${message.header}: ${message.message}`)
36
- }
37
-
38
- /**
39
- * @description Instantiate an error when conversion from one type to another has failed.
40
- *
41
- * @param {Object} opts
42
- * @param {string} opts.prefix
43
- * @param {string} opts.argument
44
- * @param {string[]} opts.types
45
- * @returns {TypeError}
46
- */
47
- webidl.errors.conversionFailed = function (opts) {
48
- const plural = opts.types.length === 1 ? '' : ' one of'
49
- const message =
50
- `${opts.argument} could not be converted to` +
51
- `${plural}: ${opts.types.join(', ')}.`
52
-
53
- return webidl.errors.exception({
54
- header: opts.prefix,
55
- message
56
- })
57
- }
58
-
59
- /**
60
- * @description Instantiate an error when an invalid argument is provided
61
- *
62
- * @param {Object} context
63
- * @param {string} context.prefix
64
- * @param {string} context.value
65
- * @param {string} context.type
66
- * @returns {TypeError}
67
- */
68
- webidl.errors.invalidArgument = function (context) {
69
- return webidl.errors.exception({
70
- header: context.prefix,
71
- message: `"${context.value}" is an invalid ${context.type}.`
72
- })
73
- }
74
-
75
- // https://webidl.spec.whatwg.org/#implements
76
- webidl.brandCheck = function (V, I) {
77
- if (!FunctionPrototypeSymbolHasInstance(I, V)) {
78
- const err = new TypeError('Illegal invocation')
79
- err.code = 'ERR_INVALID_THIS' // node compat.
80
- throw err
81
- }
82
- }
83
-
84
- webidl.brandCheckMultiple = function (List) {
85
- const prototypes = List.map((c) => webidl.util.MakeTypeAssertion(c))
86
-
87
- return (V) => {
88
- if (prototypes.every(typeCheck => !typeCheck(V))) {
89
- const err = new TypeError('Illegal invocation')
90
- err.code = 'ERR_INVALID_THIS' // node compat.
91
- throw err
92
- }
93
- }
94
- }
95
-
96
- webidl.argumentLengthCheck = function ({ length }, min, ctx) {
97
- if (length < min) {
98
- throw webidl.errors.exception({
99
- message: `${min} argument${min !== 1 ? 's' : ''} required, ` +
100
- `but${length ? ' only' : ''} ${length} found.`,
101
- header: ctx
102
- })
103
- }
104
- }
105
-
106
- webidl.illegalConstructor = function () {
107
- throw webidl.errors.exception({
108
- header: 'TypeError',
109
- message: 'Illegal constructor'
110
- })
111
- }
112
-
113
- webidl.util.MakeTypeAssertion = function (I) {
114
- return (O) => FunctionPrototypeSymbolHasInstance(I, O)
115
- }
116
-
117
- // https://tc39.es/ecma262/#sec-ecmascript-data-types-and-values
118
- webidl.util.Type = function (V) {
119
- switch (typeof V) {
120
- case 'undefined': return UNDEFINED
121
- case 'boolean': return BOOLEAN
122
- case 'string': return STRING
123
- case 'symbol': return SYMBOL
124
- case 'number': return NUMBER
125
- case 'bigint': return BIGINT
126
- case 'function':
127
- case 'object': {
128
- if (V === null) {
129
- return NULL
130
- }
131
-
132
- return OBJECT
133
- }
134
- }
135
- }
136
-
137
- webidl.util.Types = {
138
- UNDEFINED,
139
- BOOLEAN,
140
- STRING,
141
- SYMBOL,
142
- NUMBER,
143
- BIGINT,
144
- NULL,
145
- OBJECT
146
- }
147
-
148
- webidl.util.TypeValueToString = function (o) {
149
- switch (webidl.util.Type(o)) {
150
- case UNDEFINED: return 'Undefined'
151
- case BOOLEAN: return 'Boolean'
152
- case STRING: return 'String'
153
- case SYMBOL: return 'Symbol'
154
- case NUMBER: return 'Number'
155
- case BIGINT: return 'BigInt'
156
- case NULL: return 'Null'
157
- case OBJECT: return 'Object'
158
- }
159
- }
160
-
161
- webidl.util.markAsUncloneable = runtimeFeatures.has('markAsUncloneable')
162
- ? require('node:worker_threads').markAsUncloneable
163
- : () => {}
164
-
165
- // https://webidl.spec.whatwg.org/#abstract-opdef-converttoint
166
- webidl.util.ConvertToInt = function (V, bitLength, signedness, flags) {
167
- let upperBound
168
- let lowerBound
169
-
170
- // 1. If bitLength is 64, then:
171
- if (bitLength === 64) {
172
- // 1. Let upperBound be 2^53 − 1.
173
- upperBound = Math.pow(2, 53) - 1
174
-
175
- // 2. If signedness is "unsigned", then let lowerBound be 0.
176
- if (signedness === 'unsigned') {
177
- lowerBound = 0
178
- } else {
179
- // 3. Otherwise let lowerBound be −2^53 + 1.
180
- lowerBound = Math.pow(-2, 53) + 1
181
- }
182
- } else if (signedness === 'unsigned') {
183
- // 2. Otherwise, if signedness is "unsigned", then:
184
-
185
- // 1. Let lowerBound be 0.
186
- lowerBound = 0
187
-
188
- // 2. Let upperBound be 2^bitLength − 1.
189
- upperBound = Math.pow(2, bitLength) - 1
190
- } else {
191
- // 3. Otherwise:
192
-
193
- // 1. Let lowerBound be -2^(bitLength − 1).
194
- lowerBound = -Math.pow(2, bitLength - 1)
195
-
196
- // 2. Let upperBound be 2^(bitLength − 1) − 1.
197
- upperBound = Math.pow(2, bitLength - 1) - 1
198
- }
199
-
200
- // 4. Let x be ? ToNumber(V).
201
- let x = Number(V)
202
-
203
- // 5. If x is −0, then set x to +0.
204
- if (x === 0) {
205
- x = 0
206
- }
207
-
208
- // 6. If the conversion is to an IDL type associated
209
- // with the [EnforceRange] extended attribute, then:
210
- if (webidl.util.HasFlag(flags, webidl.attributes.EnforceRange)) {
211
- // 1. If x is NaN, +∞, or −∞, then throw a TypeError.
212
- if (
213
- Number.isNaN(x) ||
214
- x === Number.POSITIVE_INFINITY ||
215
- x === Number.NEGATIVE_INFINITY
216
- ) {
217
- throw webidl.errors.exception({
218
- header: 'Integer conversion',
219
- message: `Could not convert ${webidl.util.Stringify(V)} to an integer.`
220
- })
221
- }
222
-
223
- // 2. Set x to IntegerPart(x).
224
- x = webidl.util.IntegerPart(x)
225
-
226
- // 3. If x < lowerBound or x > upperBound, then
227
- // throw a TypeError.
228
- if (x < lowerBound || x > upperBound) {
229
- throw webidl.errors.exception({
230
- header: 'Integer conversion',
231
- message: `Value must be between ${lowerBound}-${upperBound}, got ${x}.`
232
- })
233
- }
234
-
235
- // 4. Return x.
236
- return x
237
- }
238
-
239
- // 7. If x is not NaN and the conversion is to an IDL
240
- // type associated with the [Clamp] extended
241
- // attribute, then:
242
- if (!Number.isNaN(x) && webidl.util.HasFlag(flags, webidl.attributes.Clamp)) {
243
- // 1. Set x to min(max(x, lowerBound), upperBound).
244
- x = Math.min(Math.max(x, lowerBound), upperBound)
245
-
246
- // 2. Round x to the nearest integer, choosing the
247
- // even integer if it lies halfway between two,
248
- // and choosing +0 rather than −0.
249
- if (Math.floor(x) % 2 === 0) {
250
- x = Math.floor(x)
251
- } else {
252
- x = Math.ceil(x)
253
- }
254
-
255
- // 3. Return x.
256
- return x
257
- }
258
-
259
- // 8. If x is NaN, +0, +∞, or −∞, then return +0.
260
- if (
261
- Number.isNaN(x) ||
262
- (x === 0 && Object.is(0, x)) ||
263
- x === Number.POSITIVE_INFINITY ||
264
- x === Number.NEGATIVE_INFINITY
265
- ) {
266
- return 0
267
- }
268
-
269
- // 9. Set x to IntegerPart(x).
270
- x = webidl.util.IntegerPart(x)
271
-
272
- // 10. Set x to x modulo 2^bitLength.
273
- x = x % Math.pow(2, bitLength)
274
-
275
- // 11. If signedness is "signed" and x ≥ 2^(bitLength − 1),
276
- // then return x − 2^bitLength.
277
- if (signedness === 'signed' && x >= Math.pow(2, bitLength - 1)) {
278
- return x - Math.pow(2, bitLength)
279
- }
280
-
281
- // 12. Otherwise, return x.
282
- return x
283
- }
284
-
285
- // https://webidl.spec.whatwg.org/#abstract-opdef-integerpart
286
- webidl.util.IntegerPart = function (n) {
287
- // 1. Let r be floor(abs(n)).
288
- const r = Math.floor(Math.abs(n))
289
-
290
- // 2. If n < 0, then return -1 × r.
291
- if (n < 0) {
292
- return -1 * r
293
- }
294
-
295
- // 3. Otherwise, return r.
296
- return r
297
- }
298
-
299
- webidl.util.Stringify = function (V) {
300
- const type = webidl.util.Type(V)
301
-
302
- switch (type) {
303
- case SYMBOL:
304
- return `Symbol(${V.description})`
305
- case OBJECT:
306
- return inspect(V)
307
- case STRING:
308
- return `"${V}"`
309
- case BIGINT:
310
- return `${V}n`
311
- default:
312
- return `${V}`
313
- }
314
- }
315
-
316
- webidl.util.IsResizableArrayBuffer = function (V) {
317
- if (types.isArrayBuffer(V)) {
318
- return V.resizable
319
- }
320
-
321
- if (types.isSharedArrayBuffer(V)) {
322
- return V.growable
323
- }
324
-
325
- throw webidl.errors.exception({
326
- header: 'IsResizableArrayBuffer',
327
- message: `"${webidl.util.Stringify(V)}" is not an array buffer.`
328
- })
329
- }
330
-
331
- webidl.util.HasFlag = function (flags, attributes) {
332
- return typeof flags === 'number' && (flags & attributes) === attributes
333
- }
334
-
335
- // https://webidl.spec.whatwg.org/#es-sequence
336
- webidl.sequenceConverter = function (converter) {
337
- return (V, prefix, argument, Iterable) => {
338
- // 1. If Type(V) is not Object, throw a TypeError.
339
- if (webidl.util.Type(V) !== OBJECT) {
340
- throw webidl.errors.exception({
341
- header: prefix,
342
- message: `${argument} (${webidl.util.Stringify(V)}) is not iterable.`
343
- })
344
- }
345
-
346
- // 2. Let method be ? GetMethod(V, @@iterator).
347
- /** @type {Generator} */
348
- const method = typeof Iterable === 'function' ? Iterable() : V?.[Symbol.iterator]?.()
349
- const seq = []
350
- let index = 0
351
-
352
- // 3. If method is undefined, throw a TypeError.
353
- if (
354
- method === undefined ||
355
- typeof method.next !== 'function'
356
- ) {
357
- throw webidl.errors.exception({
358
- header: prefix,
359
- message: `${argument} is not iterable.`
360
- })
361
- }
362
-
363
- // https://webidl.spec.whatwg.org/#create-sequence-from-iterable
364
- while (true) {
365
- const { done, value } = method.next()
366
-
367
- if (done) {
368
- break
369
- }
370
-
371
- seq.push(converter(value, prefix, `${argument}[${index++}]`))
372
- }
373
-
374
- return seq
375
- }
376
- }
377
-
378
- // https://webidl.spec.whatwg.org/#es-to-record
379
- webidl.recordConverter = function (keyConverter, valueConverter) {
380
- return (O, prefix, argument) => {
381
- // 1. If Type(O) is not Object, throw a TypeError.
382
- if (webidl.util.Type(O) !== OBJECT) {
383
- throw webidl.errors.exception({
384
- header: prefix,
385
- message: `${argument} ("${webidl.util.TypeValueToString(O)}") is not an Object.`
386
- })
387
- }
388
-
389
- // 2. Let result be a new empty instance of record<K, V>.
390
- const result = {}
391
-
392
- if (!types.isProxy(O)) {
393
- // 1. Let desc be ? O.[[GetOwnProperty]](key).
394
- const keys = [...Object.getOwnPropertyNames(O), ...Object.getOwnPropertySymbols(O)]
395
-
396
- for (const key of keys) {
397
- const keyName = webidl.util.Stringify(key)
398
-
399
- // 1. Let typedKey be key converted to an IDL value of type K.
400
- const typedKey = keyConverter(key, prefix, `Key ${keyName} in ${argument}`)
401
-
402
- // 2. Let value be ? Get(O, key).
403
- // 3. Let typedValue be value converted to an IDL value of type V.
404
- const typedValue = valueConverter(O[key], prefix, `${argument}[${keyName}]`)
405
-
406
- // 4. Set result[typedKey] to typedValue.
407
- result[typedKey] = typedValue
408
- }
409
-
410
- // 5. Return result.
411
- return result
412
- }
413
-
414
- // 3. Let keys be ? O.[[OwnPropertyKeys]]().
415
- const keys = Reflect.ownKeys(O)
416
-
417
- // 4. For each key of keys.
418
- for (const key of keys) {
419
- // 1. Let desc be ? O.[[GetOwnProperty]](key).
420
- const desc = Reflect.getOwnPropertyDescriptor(O, key)
421
-
422
- // 2. If desc is not undefined and desc.[[Enumerable]] is true:
423
- if (desc?.enumerable) {
424
- // 1. Let typedKey be key converted to an IDL value of type K.
425
- const typedKey = keyConverter(key, prefix, argument)
426
-
427
- // 2. Let value be ? Get(O, key).
428
- // 3. Let typedValue be value converted to an IDL value of type V.
429
- const typedValue = valueConverter(O[key], prefix, argument)
430
-
431
- // 4. Set result[typedKey] to typedValue.
432
- result[typedKey] = typedValue
433
- }
434
- }
435
-
436
- // 5. Return result.
437
- return result
438
- }
439
- }
440
-
441
- webidl.interfaceConverter = function (TypeCheck, name) {
442
- return (V, prefix, argument) => {
443
- if (!TypeCheck(V)) {
444
- throw webidl.errors.exception({
445
- header: prefix,
446
- message: `Expected ${argument} ("${webidl.util.Stringify(V)}") to be an instance of ${name}.`
447
- })
448
- }
449
-
450
- return V
451
- }
452
- }
453
-
454
- webidl.dictionaryConverter = function (converters) {
455
- // "For each dictionary member member declared on dictionary, in lexicographical order:"
456
- converters.sort((a, b) => (a.key > b.key) - (a.key < b.key))
457
-
458
- return (dictionary, prefix, argument) => {
459
- const dict = {}
460
-
461
- if (dictionary != null && webidl.util.Type(dictionary) !== OBJECT) {
462
- throw webidl.errors.exception({
463
- header: prefix,
464
- message: `Expected ${dictionary} to be one of: Null, Undefined, Object.`
465
- })
466
- }
467
-
468
- for (const options of converters) {
469
- const { key, defaultValue, required, converter } = options
470
-
471
- if (required === true) {
472
- if (dictionary == null || !Object.hasOwn(dictionary, key)) {
473
- throw webidl.errors.exception({
474
- header: prefix,
475
- message: `Missing required key "${key}".`
476
- })
477
- }
478
- }
479
-
480
- let value = dictionary?.[key]
481
- const hasDefault = defaultValue !== undefined
482
-
483
- // Only use defaultValue if value is undefined and
484
- // a defaultValue options was provided.
485
- if (hasDefault && value === undefined) {
486
- value = defaultValue()
487
- }
488
-
489
- // A key can be optional and have no default value.
490
- // When this happens, do not perform a conversion,
491
- // and do not assign the key a value.
492
- if (required || hasDefault || value !== undefined) {
493
- value = converter(value, prefix, `${argument}.${key}`)
494
-
495
- if (
496
- options.allowedValues &&
497
- !options.allowedValues.includes(value)
498
- ) {
499
- throw webidl.errors.exception({
500
- header: prefix,
501
- message: `${value} is not an accepted type. Expected one of ${options.allowedValues.join(', ')}.`
502
- })
503
- }
504
-
505
- dict[key] = value
506
- }
507
- }
508
-
509
- return dict
510
- }
511
- }
512
-
513
- webidl.nullableConverter = function (converter) {
514
- return (V, prefix, argument) => {
515
- if (V === null) {
516
- return V
517
- }
518
-
519
- return converter(V, prefix, argument)
520
- }
521
- }
522
-
523
- /**
524
- * @param {*} value
525
- * @returns {boolean}
526
- */
527
- webidl.is.USVString = function (value) {
528
- return (
529
- typeof value === 'string' &&
530
- value.isWellFormed()
531
- )
532
- }
533
-
534
- webidl.is.ReadableStream = webidl.util.MakeTypeAssertion(ReadableStream)
535
- webidl.is.Blob = webidl.util.MakeTypeAssertion(Blob)
536
- webidl.is.URLSearchParams = webidl.util.MakeTypeAssertion(URLSearchParams)
537
- webidl.is.File = webidl.util.MakeTypeAssertion(File)
538
- webidl.is.URL = webidl.util.MakeTypeAssertion(URL)
539
- webidl.is.AbortSignal = webidl.util.MakeTypeAssertion(AbortSignal)
540
- webidl.is.MessagePort = webidl.util.MakeTypeAssertion(MessagePort)
541
-
542
- webidl.is.BufferSource = function (V) {
543
- return types.isArrayBuffer(V) || (
544
- ArrayBuffer.isView(V) &&
545
- types.isArrayBuffer(V.buffer)
546
- )
547
- }
548
-
549
- // https://webidl.spec.whatwg.org/#dfn-get-buffer-source-copy
550
- webidl.util.getCopyOfBytesHeldByBufferSource = function (bufferSource) {
551
- // 1. Let jsBufferSource be the result of converting bufferSource to a JavaScript value.
552
- const jsBufferSource = bufferSource
553
-
554
- // 2. Let jsArrayBuffer be jsBufferSource.
555
- let jsArrayBuffer = jsBufferSource
556
-
557
- // 3. Let offset be 0.
558
- let offset = 0
559
-
560
- // 4. Let length be 0.
561
- let length = 0
562
-
563
- // 5. If jsBufferSource has a [[ViewedArrayBuffer]] internal slot, then:
564
- if (types.isTypedArray(jsBufferSource) || types.isDataView(jsBufferSource)) {
565
- // 5.1. Set jsArrayBuffer to jsBufferSource.[[ViewedArrayBuffer]].
566
- jsArrayBuffer = jsBufferSource.buffer
567
-
568
- // 5.2. Set offset to jsBufferSource.[[ByteOffset]].
569
- offset = jsBufferSource.byteOffset
570
-
571
- // 5.3. Set length to jsBufferSource.[[ByteLength]].
572
- length = jsBufferSource.byteLength
573
- } else {
574
- // 6. Otherwise:
575
-
576
- // 6.1. Assert: jsBufferSource is an ArrayBuffer or SharedArrayBuffer object.
577
- assert(types.isAnyArrayBuffer(jsBufferSource))
578
-
579
- // 6.2. Set length to jsBufferSource.[[ArrayBufferByteLength]].
580
- length = jsBufferSource.byteLength
581
- }
582
-
583
- // 7. If IsDetachedBuffer(jsArrayBuffer) is true, then return the empty byte sequence.
584
- if (jsArrayBuffer.detached) {
585
- return new Uint8Array(0)
586
- }
587
-
588
- // 8. Let bytes be a new byte sequence of length equal to length.
589
- const bytes = new Uint8Array(length)
590
-
591
- // 9. For i in the range offset to offset + length − 1, inclusive,
592
- // set bytes[i − offset] to GetValueFromBuffer(jsArrayBuffer, i, Uint8, true, Unordered).
593
- const view = new Uint8Array(jsArrayBuffer, offset, length)
594
- bytes.set(view)
595
-
596
- // 10. Return bytes.
597
- return bytes
598
- }
599
-
600
- // https://webidl.spec.whatwg.org/#es-DOMString
601
- webidl.converters.DOMString = function (V, prefix, argument, flags) {
602
- // 1. If V is null and the conversion is to an IDL type
603
- // associated with the [LegacyNullToEmptyString]
604
- // extended attribute, then return the DOMString value
605
- // that represents the empty string.
606
- if (V === null && webidl.util.HasFlag(flags, webidl.attributes.LegacyNullToEmptyString)) {
607
- return ''
608
- }
609
-
610
- // 2. Let x be ? ToString(V).
611
- if (typeof V === 'symbol') {
612
- throw webidl.errors.exception({
613
- header: prefix,
614
- message: `${argument} is a symbol, which cannot be converted to a DOMString.`
615
- })
616
- }
617
-
618
- // 3. Return the IDL DOMString value that represents the
619
- // same sequence of code units as the one the
620
- // ECMAScript String value x represents.
621
- return String(V)
622
- }
623
-
624
- // https://webidl.spec.whatwg.org/#es-ByteString
625
- webidl.converters.ByteString = function (V, prefix, argument) {
626
- // 1. Let x be ? ToString(V).
627
- if (typeof V === 'symbol') {
628
- throw webidl.errors.exception({
629
- header: prefix,
630
- message: `${argument} is a symbol, which cannot be converted to a ByteString.`
631
- })
632
- }
633
-
634
- const x = String(V)
635
-
636
- // 2. If the value of any element of x is greater than
637
- // 255, then throw a TypeError.
638
- for (let index = 0; index < x.length; index++) {
639
- if (x.charCodeAt(index) > 255) {
640
- throw new TypeError(
641
- 'Cannot convert argument to a ByteString because the character at ' +
642
- `index ${index} has a value of ${x.charCodeAt(index)} which is greater than 255.`
643
- )
644
- }
645
- }
646
-
647
- // 3. Return an IDL ByteString value whose length is the
648
- // length of x, and where the value of each element is
649
- // the value of the corresponding element of x.
650
- return x
651
- }
652
-
653
- /**
654
- * @param {unknown} value
655
- * @returns {string}
656
- * @see https://webidl.spec.whatwg.org/#es-USVString
657
- */
658
- webidl.converters.USVString = function (value) {
659
- // TODO: rewrite this so we can control the errors thrown
660
- if (typeof value === 'string') {
661
- return value.toWellFormed()
662
- }
663
- return `${value}`.toWellFormed()
664
- }
665
-
666
- // https://webidl.spec.whatwg.org/#es-boolean
667
- webidl.converters.boolean = function (V) {
668
- // 1. Let x be the result of computing ToBoolean(V).
669
- // https://262.ecma-international.org/10.0/index.html#table-10
670
- const x = Boolean(V)
671
-
672
- // 2. Return the IDL boolean value that is the one that represents
673
- // the same truth value as the ECMAScript Boolean value x.
674
- return x
675
- }
676
-
677
- // https://webidl.spec.whatwg.org/#es-any
678
- webidl.converters.any = function (V) {
679
- return V
680
- }
681
-
682
- // https://webidl.spec.whatwg.org/#es-long-long
683
- webidl.converters['long long'] = function (V, prefix, argument) {
684
- // 1. Let x be ? ConvertToInt(V, 64, "signed").
685
- const x = webidl.util.ConvertToInt(V, 64, 'signed', 0, prefix, argument)
686
-
687
- // 2. Return the IDL long long value that represents
688
- // the same numeric value as x.
689
- return x
690
- }
691
-
692
- // https://webidl.spec.whatwg.org/#es-unsigned-long-long
693
- webidl.converters['unsigned long long'] = function (V, prefix, argument) {
694
- // 1. Let x be ? ConvertToInt(V, 64, "unsigned").
695
- const x = webidl.util.ConvertToInt(V, 64, 'unsigned', 0, prefix, argument)
696
-
697
- // 2. Return the IDL unsigned long long value that
698
- // represents the same numeric value as x.
699
- return x
700
- }
701
-
702
- // https://webidl.spec.whatwg.org/#es-unsigned-long
703
- webidl.converters['unsigned long'] = function (V, prefix, argument) {
704
- // 1. Let x be ? ConvertToInt(V, 32, "unsigned").
705
- const x = webidl.util.ConvertToInt(V, 32, 'unsigned', 0, prefix, argument)
706
-
707
- // 2. Return the IDL unsigned long value that
708
- // represents the same numeric value as x.
709
- return x
710
- }
711
-
712
- // https://webidl.spec.whatwg.org/#es-unsigned-short
713
- webidl.converters['unsigned short'] = function (V, prefix, argument, flags) {
714
- // 1. Let x be ? ConvertToInt(V, 16, "unsigned").
715
- const x = webidl.util.ConvertToInt(V, 16, 'unsigned', flags, prefix, argument)
716
-
717
- // 2. Return the IDL unsigned short value that represents
718
- // the same numeric value as x.
719
- return x
720
- }
721
-
722
- // https://webidl.spec.whatwg.org/#idl-ArrayBuffer
723
- webidl.converters.ArrayBuffer = function (V, prefix, argument, flags) {
724
- // 1. If V is not an Object, or V does not have an
725
- // [[ArrayBufferData]] internal slot, then throw a
726
- // TypeError.
727
- // 2. If IsSharedArrayBuffer(V) is true, then throw a
728
- // TypeError.
729
- // see: https://tc39.es/ecma262/#sec-properties-of-the-arraybuffer-instances
730
- if (
731
- webidl.util.Type(V) !== OBJECT ||
732
- !types.isArrayBuffer(V)
733
- ) {
734
- throw webidl.errors.conversionFailed({
735
- prefix,
736
- argument: `${argument} ("${webidl.util.Stringify(V)}")`,
737
- types: ['ArrayBuffer']
738
- })
739
- }
740
-
741
- // 3. If the conversion is not to an IDL type associated
742
- // with the [AllowResizable] extended attribute, and
743
- // IsResizableArrayBuffer(V) is true, then throw a
744
- // TypeError.
745
- if (!webidl.util.HasFlag(flags, webidl.attributes.AllowResizable) && webidl.util.IsResizableArrayBuffer(V)) {
746
- throw webidl.errors.exception({
747
- header: prefix,
748
- message: `${argument} cannot be a resizable ArrayBuffer.`
749
- })
750
- }
751
-
752
- // 4. Return the IDL ArrayBuffer value that is a
753
- // reference to the same object as V.
754
- return V
755
- }
756
-
757
- // https://webidl.spec.whatwg.org/#idl-SharedArrayBuffer
758
- webidl.converters.SharedArrayBuffer = function (V, prefix, argument, flags) {
759
- // 1. If V is not an Object, or V does not have an
760
- // [[ArrayBufferData]] internal slot, then throw a
761
- // TypeError.
762
- // 2. If IsSharedArrayBuffer(V) is false, then throw a
763
- // TypeError.
764
- // see: https://tc39.es/ecma262/#sec-properties-of-the-sharedarraybuffer-instances
765
- if (
766
- webidl.util.Type(V) !== OBJECT ||
767
- !types.isSharedArrayBuffer(V)
768
- ) {
769
- throw webidl.errors.conversionFailed({
770
- prefix,
771
- argument: `${argument} ("${webidl.util.Stringify(V)}")`,
772
- types: ['SharedArrayBuffer']
773
- })
774
- }
775
-
776
- // 3. If the conversion is not to an IDL type associated
777
- // with the [AllowResizable] extended attribute, and
778
- // IsResizableArrayBuffer(V) is true, then throw a
779
- // TypeError.
780
- if (!webidl.util.HasFlag(flags, webidl.attributes.AllowResizable) && webidl.util.IsResizableArrayBuffer(V)) {
781
- throw webidl.errors.exception({
782
- header: prefix,
783
- message: `${argument} cannot be a resizable SharedArrayBuffer.`
784
- })
785
- }
786
-
787
- // 4. Return the IDL SharedArrayBuffer value that is a
788
- // reference to the same object as V.
789
- return V
790
- }
791
-
792
- // https://webidl.spec.whatwg.org/#dfn-typed-array-type
793
- webidl.converters.TypedArray = function (V, T, prefix, argument, flags) {
794
- // 1. Let T be the IDL type V is being converted to.
795
-
796
- // 2. If Type(V) is not Object, or V does not have a
797
- // [[TypedArrayName]] internal slot with a value
798
- // equal to T’s name, then throw a TypeError.
799
- if (
800
- webidl.util.Type(V) !== OBJECT ||
801
- !types.isTypedArray(V) ||
802
- V.constructor.name !== T.name
803
- ) {
804
- throw webidl.errors.conversionFailed({
805
- prefix,
806
- argument: `${argument} ("${webidl.util.Stringify(V)}")`,
807
- types: [T.name]
808
- })
809
- }
810
-
811
- // 3. If the conversion is not to an IDL type associated
812
- // with the [AllowShared] extended attribute, and
813
- // IsSharedArrayBuffer(V.[[ViewedArrayBuffer]]) is
814
- // true, then throw a TypeError.
815
- if (!webidl.util.HasFlag(flags, webidl.attributes.AllowShared) && types.isSharedArrayBuffer(V.buffer)) {
816
- throw webidl.errors.exception({
817
- header: prefix,
818
- message: `${argument} cannot be a view on a shared array buffer.`
819
- })
820
- }
821
-
822
- // 4. If the conversion is not to an IDL type associated
823
- // with the [AllowResizable] extended attribute, and
824
- // IsResizableArrayBuffer(V.[[ViewedArrayBuffer]]) is
825
- // true, then throw a TypeError.
826
- if (!webidl.util.HasFlag(flags, webidl.attributes.AllowResizable) && webidl.util.IsResizableArrayBuffer(V.buffer)) {
827
- throw webidl.errors.exception({
828
- header: prefix,
829
- message: `${argument} cannot be a view on a resizable array buffer.`
830
- })
831
- }
832
-
833
- // 5. Return the IDL value of type T that is a reference
834
- // to the same object as V.
835
- return V
836
- }
837
-
838
- // https://webidl.spec.whatwg.org/#idl-DataView
839
- webidl.converters.DataView = function (V, prefix, argument, flags) {
840
- // 1. If Type(V) is not Object, or V does not have a
841
- // [[DataView]] internal slot, then throw a TypeError.
842
- if (webidl.util.Type(V) !== OBJECT || !types.isDataView(V)) {
843
- throw webidl.errors.conversionFailed({
844
- prefix,
845
- argument: `${argument} ("${webidl.util.Stringify(V)}")`,
846
- types: ['DataView']
847
- })
848
- }
849
-
850
- // 2. If the conversion is not to an IDL type associated
851
- // with the [AllowShared] extended attribute, and
852
- // IsSharedArrayBuffer(V.[[ViewedArrayBuffer]]) is true,
853
- // then throw a TypeError.
854
- if (!webidl.util.HasFlag(flags, webidl.attributes.AllowShared) && types.isSharedArrayBuffer(V.buffer)) {
855
- throw webidl.errors.exception({
856
- header: prefix,
857
- message: `${argument} cannot be a view on a shared array buffer.`
858
- })
859
- }
860
-
861
- // 3. If the conversion is not to an IDL type associated
862
- // with the [AllowResizable] extended attribute, and
863
- // IsResizableArrayBuffer(V.[[ViewedArrayBuffer]]) is
864
- // true, then throw a TypeError.
865
- if (!webidl.util.HasFlag(flags, webidl.attributes.AllowResizable) && webidl.util.IsResizableArrayBuffer(V.buffer)) {
866
- throw webidl.errors.exception({
867
- header: prefix,
868
- message: `${argument} cannot be a view on a resizable array buffer.`
869
- })
870
- }
871
-
872
- // 4. Return the IDL DataView value that is a reference
873
- // to the same object as V.
874
- return V
875
- }
876
-
877
- // https://webidl.spec.whatwg.org/#ArrayBufferView
878
- webidl.converters.ArrayBufferView = function (V, prefix, argument, flags) {
879
- if (
880
- webidl.util.Type(V) !== OBJECT ||
881
- !types.isArrayBufferView(V)
882
- ) {
883
- throw webidl.errors.conversionFailed({
884
- prefix,
885
- argument: `${argument} ("${webidl.util.Stringify(V)}")`,
886
- types: ['ArrayBufferView']
887
- })
888
- }
889
-
890
- if (!webidl.util.HasFlag(flags, webidl.attributes.AllowShared) && types.isSharedArrayBuffer(V.buffer)) {
891
- throw webidl.errors.exception({
892
- header: prefix,
893
- message: `${argument} cannot be a view on a shared array buffer.`
894
- })
895
- }
896
-
897
- if (!webidl.util.HasFlag(flags, webidl.attributes.AllowResizable) && webidl.util.IsResizableArrayBuffer(V.buffer)) {
898
- throw webidl.errors.exception({
899
- header: prefix,
900
- message: `${argument} cannot be a view on a resizable array buffer.`
901
- })
902
- }
903
-
904
- return V
905
- }
906
-
907
- // https://webidl.spec.whatwg.org/#BufferSource
908
- webidl.converters.BufferSource = function (V, prefix, argument, flags) {
909
- if (types.isArrayBuffer(V)) {
910
- return webidl.converters.ArrayBuffer(V, prefix, argument, flags)
911
- }
912
-
913
- if (types.isArrayBufferView(V)) {
914
- flags &= ~webidl.attributes.AllowShared
915
-
916
- return webidl.converters.ArrayBufferView(V, prefix, argument, flags)
917
- }
918
-
919
- // Make this explicit for easier debugging
920
- if (types.isSharedArrayBuffer(V)) {
921
- throw webidl.errors.exception({
922
- header: prefix,
923
- message: `${argument} cannot be a SharedArrayBuffer.`
924
- })
925
- }
926
-
927
- throw webidl.errors.conversionFailed({
928
- prefix,
929
- argument: `${argument} ("${webidl.util.Stringify(V)}")`,
930
- types: ['ArrayBuffer', 'ArrayBufferView']
931
- })
932
- }
933
-
934
- // https://webidl.spec.whatwg.org/#AllowSharedBufferSource
935
- webidl.converters.AllowSharedBufferSource = function (V, prefix, argument, flags) {
936
- if (types.isArrayBuffer(V)) {
937
- return webidl.converters.ArrayBuffer(V, prefix, argument, flags)
938
- }
939
-
940
- if (types.isSharedArrayBuffer(V)) {
941
- return webidl.converters.SharedArrayBuffer(V, prefix, argument, flags)
942
- }
943
-
944
- if (types.isArrayBufferView(V)) {
945
- flags |= webidl.attributes.AllowShared
946
- return webidl.converters.ArrayBufferView(V, prefix, argument, flags)
947
- }
948
-
949
- throw webidl.errors.conversionFailed({
950
- prefix,
951
- argument: `${argument} ("${webidl.util.Stringify(V)}")`,
952
- types: ['ArrayBuffer', 'SharedArrayBuffer', 'ArrayBufferView']
953
- })
954
- }
955
-
956
- webidl.converters['sequence<ByteString>'] = webidl.sequenceConverter(
957
- webidl.converters.ByteString
958
- )
959
-
960
- webidl.converters['sequence<sequence<ByteString>>'] = webidl.sequenceConverter(
961
- webidl.converters['sequence<ByteString>']
962
- )
963
-
964
- webidl.converters['record<ByteString, ByteString>'] = webidl.recordConverter(
965
- webidl.converters.ByteString,
966
- webidl.converters.ByteString
967
- )
968
-
969
- webidl.converters.Blob = webidl.interfaceConverter(webidl.is.Blob, 'Blob')
970
-
971
- webidl.converters.AbortSignal = webidl.interfaceConverter(
972
- webidl.is.AbortSignal,
973
- 'AbortSignal'
974
- )
975
-
976
- /**
977
- * [LegacyTreatNonObjectAsNull]
978
- * callback EventHandlerNonNull = any (Event event);
979
- * typedef EventHandlerNonNull? EventHandler;
980
- * @param {*} V
981
- */
982
- webidl.converters.EventHandlerNonNull = function (V) {
983
- if (webidl.util.Type(V) !== OBJECT) {
984
- return null
985
- }
986
-
987
- // [I]f the value is not an object, it will be converted to null, and if the value is not callable,
988
- // it will be converted to a callback function value that does nothing when called.
989
- if (typeof V === 'function') {
990
- return V
991
- }
992
-
993
- return () => {}
994
- }
995
-
996
- webidl.attributes = {
997
- Clamp: 1 << 0,
998
- EnforceRange: 1 << 1,
999
- AllowShared: 1 << 2,
1000
- AllowResizable: 1 << 3,
1001
- LegacyNullToEmptyString: 1 << 4
1002
- }
1003
-
1004
- module.exports = {
1005
- webidl
1006
- }