sfml.js 0.0.1 → 1.0.0-rc.1

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 (696) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +24 -16
  3. package/binding.gyp +95 -183
  4. package/dist/audio/effect-processor.d.ts +22 -0
  5. package/dist/audio/effect-processor.js +28 -0
  6. package/dist/audio/input-sound-file.d.ts +52 -0
  7. package/dist/audio/input-sound-file.js +167 -0
  8. package/dist/audio/listener.d.ts +28 -0
  9. package/dist/audio/listener.js +86 -0
  10. package/dist/audio/music.d.ts +60 -0
  11. package/dist/audio/music.js +192 -0
  12. package/dist/audio/output-sound-file.d.ts +15 -0
  13. package/dist/audio/output-sound-file.js +70 -0
  14. package/dist/audio/playback-device.d.ts +35 -0
  15. package/dist/audio/playback-device.js +71 -0
  16. package/dist/audio/sound-buffer-recorder.d.ts +34 -0
  17. package/dist/audio/sound-buffer-recorder.js +62 -0
  18. package/dist/audio/sound-buffer.d.ts +45 -0
  19. package/dist/audio/sound-buffer.js +152 -0
  20. package/dist/audio/sound-file-factory.d.ts +27 -0
  21. package/dist/audio/sound-file-factory.js +152 -0
  22. package/dist/audio/sound-file-reader.d.ts +60 -0
  23. package/dist/audio/sound-file-reader.js +61 -0
  24. package/dist/audio/sound-file-writer.d.ts +17 -0
  25. package/dist/audio/sound-file-writer.js +9 -0
  26. package/dist/audio/sound-recorder.d.ts +60 -0
  27. package/dist/audio/sound-recorder.js +162 -0
  28. package/dist/audio/sound-source.d.ts +108 -0
  29. package/dist/audio/sound-source.js +161 -0
  30. package/dist/audio/sound-stream.d.ts +28 -0
  31. package/dist/audio/sound-stream.js +47 -0
  32. package/dist/audio/sound.d.ts +14 -0
  33. package/dist/audio/sound.js +39 -0
  34. package/dist/audio/value.d.ts +116 -0
  35. package/dist/audio/value.js +157 -0
  36. package/dist/audio/worker.d.ts +88 -0
  37. package/dist/audio/worker.js +2 -0
  38. package/dist/graphics/blend-mode.d.ts +82 -0
  39. package/dist/graphics/blend-mode.js +98 -0
  40. package/dist/graphics/boolean-vector.d.ts +48 -0
  41. package/dist/graphics/boolean-vector.js +116 -0
  42. package/dist/graphics/circle-shape.d.ts +27 -0
  43. package/dist/graphics/circle-shape.js +41 -0
  44. package/dist/graphics/color.d.ts +93 -0
  45. package/dist/graphics/color.js +146 -0
  46. package/dist/graphics/convex-shape.d.ts +18 -0
  47. package/dist/graphics/convex-shape.js +33 -0
  48. package/dist/graphics/drawable.d.ts +9 -0
  49. package/dist/graphics/drawable.js +15 -0
  50. package/dist/graphics/font.d.ts +70 -0
  51. package/dist/graphics/font.js +221 -0
  52. package/dist/graphics/glsl-matrix.d.ts +25 -0
  53. package/dist/graphics/glsl-matrix.js +69 -0
  54. package/dist/graphics/glsl.d.ts +57 -0
  55. package/dist/graphics/glsl.js +112 -0
  56. package/dist/graphics/glyph.d.ts +44 -0
  57. package/dist/graphics/glyph.js +74 -0
  58. package/dist/graphics/image.d.ts +57 -0
  59. package/dist/graphics/image.js +181 -0
  60. package/dist/graphics/primitive-type.d.ts +16 -0
  61. package/dist/graphics/primitive-type.js +25 -0
  62. package/dist/graphics/rect.d.ts +67 -0
  63. package/dist/graphics/rect.js +164 -0
  64. package/dist/graphics/rectangle-shape.d.ts +18 -0
  65. package/dist/graphics/rectangle-shape.js +34 -0
  66. package/dist/graphics/render-states.d.ts +60 -0
  67. package/dist/graphics/render-states.js +74 -0
  68. package/dist/graphics/render-target.d.ts +99 -0
  69. package/dist/graphics/render-target.js +341 -0
  70. package/dist/graphics/render-texture.d.ts +46 -0
  71. package/dist/graphics/render-texture.js +120 -0
  72. package/dist/graphics/render-window.d.ts +49 -0
  73. package/dist/graphics/render-window.js +106 -0
  74. package/dist/graphics/shader.d.ts +63 -0
  75. package/dist/graphics/shader.js +215 -0
  76. package/dist/graphics/shape.d.ts +77 -0
  77. package/dist/graphics/shape.js +180 -0
  78. package/dist/graphics/sprite.d.ts +44 -0
  79. package/dist/graphics/sprite.js +116 -0
  80. package/dist/graphics/stencil-mode.d.ts +69 -0
  81. package/dist/graphics/stencil-mode.js +72 -0
  82. package/dist/graphics/swap.d.ts +6 -0
  83. package/dist/graphics/swap.js +16 -0
  84. package/dist/graphics/text.d.ts +238 -0
  85. package/dist/graphics/text.js +354 -0
  86. package/dist/graphics/texture.d.ts +78 -0
  87. package/dist/graphics/texture.js +274 -0
  88. package/dist/graphics/transform.d.ts +50 -0
  89. package/dist/graphics/transform.js +195 -0
  90. package/dist/graphics/transformable.d.ts +13 -0
  91. package/dist/graphics/transformable.js +27 -0
  92. package/dist/graphics/vertex-array.d.ts +54 -0
  93. package/dist/graphics/vertex-array.js +176 -0
  94. package/dist/graphics/vertex-buffer.d.ts +69 -0
  95. package/dist/graphics/vertex-buffer.js +167 -0
  96. package/dist/graphics/vertex.d.ts +42 -0
  97. package/dist/graphics/vertex.js +98 -0
  98. package/dist/graphics/view.d.ts +54 -0
  99. package/dist/graphics/view.js +209 -0
  100. package/dist/index.d.ts +116 -0
  101. package/dist/index.js +251 -0
  102. package/dist/internal/audio-codec-registry.d.ts +13 -0
  103. package/dist/internal/audio-codec-registry.js +64 -0
  104. package/dist/internal/audio-input-stream.d.ts +13 -0
  105. package/dist/internal/audio-input-stream.js +44 -0
  106. package/dist/internal/audio-music-pump.d.ts +63 -0
  107. package/dist/internal/audio-music-pump.js +193 -0
  108. package/dist/internal/audio-native.d.ts +145 -0
  109. package/dist/internal/audio-native.js +24 -0
  110. package/dist/internal/audio-recorder-session.d.ts +77 -0
  111. package/dist/internal/audio-recorder-session.js +182 -0
  112. package/dist/internal/audio-worker-session.d.ts +18 -0
  113. package/dist/internal/audio-worker-session.js +82 -0
  114. package/dist/internal/audio-worker.d.ts +1 -0
  115. package/dist/internal/audio-worker.js +134 -0
  116. package/dist/internal/glsl-value.d.ts +26 -0
  117. package/dist/internal/glsl-value.js +44 -0
  118. package/dist/internal/graphics-state.d.ts +45 -0
  119. package/dist/internal/graphics-state.js +123 -0
  120. package/dist/internal/input-stream.d.ts +4 -0
  121. package/dist/internal/input-stream.js +25 -0
  122. package/dist/internal/lazy-value.d.ts +17 -0
  123. package/dist/internal/lazy-value.js +43 -0
  124. package/dist/internal/native.d.ts +317 -0
  125. package/dist/internal/native.js +8 -0
  126. package/dist/internal/numeric-properties.d.ts +2 -0
  127. package/dist/internal/numeric-properties.js +39 -0
  128. package/dist/internal/render-states.d.ts +4 -0
  129. package/dist/internal/render-states.js +44 -0
  130. package/dist/internal/scalar.d.ts +44 -0
  131. package/dist/internal/scalar.js +95 -0
  132. package/dist/internal/shaped-glyph.d.ts +32 -0
  133. package/dist/internal/shaped-glyph.js +51 -0
  134. package/dist/internal/struct-view.d.ts +11 -0
  135. package/dist/internal/struct-view.js +39 -0
  136. package/dist/internal/text-indices.d.ts +7 -0
  137. package/dist/internal/text-indices.js +22 -0
  138. package/dist/internal/transformable.d.ts +53 -0
  139. package/dist/internal/transformable.js +121 -0
  140. package/dist/internal/value-storage.d.ts +26 -0
  141. package/dist/internal/value-storage.js +21 -0
  142. package/dist/network/common.d.ts +18 -0
  143. package/dist/network/common.js +73 -0
  144. package/dist/network/dns.d.ts +35 -0
  145. package/dist/network/dns.js +93 -0
  146. package/dist/network/ftp.d.ts +81 -0
  147. package/dist/network/ftp.js +233 -0
  148. package/dist/network/gen/constants.d.ts +252 -0
  149. package/dist/network/gen/constants.js +260 -0
  150. package/dist/network/http.d.ts +150 -0
  151. package/dist/network/http.js +424 -0
  152. package/dist/network/ip-address.d.ts +57 -0
  153. package/dist/network/ip-address.js +161 -0
  154. package/dist/network/packet.d.ts +78 -0
  155. package/dist/network/packet.js +238 -0
  156. package/dist/network/sftp.d.ts +220 -0
  157. package/dist/network/sftp.js +557 -0
  158. package/dist/network/socket-selector.d.ts +38 -0
  159. package/dist/network/socket-selector.js +125 -0
  160. package/dist/network/socket.d.ts +89 -0
  161. package/dist/network/socket.js +225 -0
  162. package/dist/network/tcp-listener.d.ts +36 -0
  163. package/dist/network/tcp-listener.js +126 -0
  164. package/dist/network/tcp-socket.d.ts +108 -0
  165. package/dist/network/tcp-socket.js +362 -0
  166. package/dist/network/tls-material.d.ts +6 -0
  167. package/dist/network/tls-material.js +36 -0
  168. package/dist/network/udp-socket.d.ts +60 -0
  169. package/dist/network/udp-socket.js +197 -0
  170. package/dist/system/angle.d.ts +27 -0
  171. package/dist/system/angle.js +72 -0
  172. package/dist/system/clock.d.ts +22 -0
  173. package/dist/system/clock.js +56 -0
  174. package/dist/system/err.d.ts +6 -0
  175. package/dist/system/err.js +49 -0
  176. package/dist/system/error.d.ts +5 -0
  177. package/dist/system/error.js +12 -0
  178. package/dist/system/file-input-stream.d.ts +21 -0
  179. package/dist/system/file-input-stream.js +101 -0
  180. package/dist/system/input-stream.d.ts +30 -0
  181. package/dist/system/input-stream.js +54 -0
  182. package/dist/system/operators.d.ts +164 -0
  183. package/dist/system/operators.js +402 -0
  184. package/dist/system/sleep.d.ts +4 -0
  185. package/dist/system/sleep.js +23 -0
  186. package/dist/system/suspend-aware-clock.d.ts +7 -0
  187. package/dist/system/suspend-aware-clock.js +14 -0
  188. package/dist/system/time.d.ts +31 -0
  189. package/dist/system/time.js +134 -0
  190. package/dist/system/timeout-with-predicate.d.ts +19 -0
  191. package/dist/system/timeout-with-predicate.js +35 -0
  192. package/dist/system/unicode.d.ts +18 -0
  193. package/dist/system/unicode.js +31 -0
  194. package/dist/system/vector2.d.ts +98 -0
  195. package/dist/system/vector2.js +225 -0
  196. package/dist/system/vector3.d.ts +83 -0
  197. package/dist/system/vector3.js +178 -0
  198. package/dist/system/version.d.ts +15 -0
  199. package/dist/system/version.js +18 -0
  200. package/dist/window/clipboard.d.ts +4 -0
  201. package/dist/window/clipboard.js +16 -0
  202. package/dist/window/context-settings.d.ts +29 -0
  203. package/dist/window/context-settings.js +59 -0
  204. package/dist/window/context.d.ts +27 -0
  205. package/dist/window/context.js +77 -0
  206. package/dist/window/cursor.d.ts +20 -0
  207. package/dist/window/cursor.js +56 -0
  208. package/dist/window/event.d.ts +176 -0
  209. package/dist/window/event.js +57 -0
  210. package/dist/window/gen/constants.d.ts +637 -0
  211. package/dist/window/gen/constants.js +651 -0
  212. package/dist/window/joystick.d.ts +25 -0
  213. package/dist/window/joystick.js +44 -0
  214. package/dist/window/keyboard.d.ts +14 -0
  215. package/dist/window/keyboard.js +37 -0
  216. package/dist/window/mouse.d.ts +10 -0
  217. package/dist/window/mouse.js +36 -0
  218. package/dist/window/sensor.d.ts +9 -0
  219. package/dist/window/sensor.js +23 -0
  220. package/dist/window/touch.d.ts +12 -0
  221. package/dist/window/touch.js +29 -0
  222. package/dist/window/video-mode.d.ts +26 -0
  223. package/dist/window/video-mode.js +69 -0
  224. package/dist/window/vulkan.d.ts +9 -0
  225. package/dist/window/vulkan.js +22 -0
  226. package/dist/window/window.d.ts +103 -0
  227. package/dist/window/window.js +227 -0
  228. package/docs/api.md +1113 -0
  229. package/docs/audio.md +212 -0
  230. package/docs/development.md +77 -0
  231. package/docs/network.md +169 -0
  232. package/native/addon.cc +129 -0
  233. package/native/audio-binding.cc +543 -0
  234. package/native/audio-codec-binding.cc +246 -0
  235. package/native/audio-device-binding.cc +160 -0
  236. package/native/audio-file-binding.cc +192 -0
  237. package/native/audio-recorder-binding.cc +237 -0
  238. package/native/audio-recorder.h +39 -0
  239. package/native/audio-state.h +220 -0
  240. package/native/audio-stream-binding.cc +284 -0
  241. package/native/audio-stream.h +28 -0
  242. package/native/audio-worker-binding.cc +447 -0
  243. package/native/audio-worker.h +121 -0
  244. package/native/batch-drawable.cc +189 -0
  245. package/native/batch-drawable.h +57 -0
  246. package/native/context-binding.cc +180 -0
  247. package/native/context-settings.h +74 -0
  248. package/native/deferred-delete.cc +49 -0
  249. package/native/deferred-delete.h +84 -0
  250. package/native/error-stream-binding.cc +270 -0
  251. package/native/exception-boundary.h +97 -0
  252. package/native/font-binding.cc +210 -0
  253. package/native/font-state.h +27 -0
  254. package/native/graphics-binding.cc +338 -0
  255. package/native/graphics-state.h +253 -0
  256. package/native/image-binding.cc +258 -0
  257. package/native/image-state.h +93 -0
  258. package/native/input-binding.cc +246 -0
  259. package/native/numeric-fields.h +96 -0
  260. package/native/render-window-binding.cc +103 -0
  261. package/native/render-window-state.h +22 -0
  262. package/native/shader-binding.cc +292 -0
  263. package/native/shape-binding.cc +283 -0
  264. package/native/shape-state.h +68 -0
  265. package/native/shaped-glyph-storage.h +45 -0
  266. package/native/shared-handle.h +69 -0
  267. package/native/stream-binding.cc +286 -0
  268. package/native/system-binding.cc +91 -0
  269. package/native/text-binding.cc +205 -0
  270. package/native/text-state.h +101 -0
  271. package/native/texture-binding.cc +330 -0
  272. package/native/texture-resource.h +52 -0
  273. package/native/time-value.h +28 -0
  274. package/native/transformable-binding.cc +23 -0
  275. package/native/transformable-state.h +44 -0
  276. package/native/value-binding.h +200 -0
  277. package/native/value-layout.h +116 -0
  278. package/native/values-binding.cc +27 -0
  279. package/native/vertex-binding.cc +50 -0
  280. package/native/vertex-buffer-binding.cc +232 -0
  281. package/native/vertex-storage.h +20 -0
  282. package/native/view-data.h +24 -0
  283. package/native/window-binding.cc +388 -0
  284. package/native/window-event.h +92 -0
  285. package/native/window-owner.h +81 -0
  286. package/package.json +77 -35
  287. package/src/audio/effect-processor.ts +41 -0
  288. package/src/audio/input-sound-file.ts +173 -0
  289. package/src/audio/listener.ts +74 -0
  290. package/src/audio/music.ts +191 -0
  291. package/src/audio/output-sound-file.ts +64 -0
  292. package/src/audio/playback-device.ts +59 -0
  293. package/src/audio/sound-buffer-recorder.ts +61 -0
  294. package/src/audio/sound-buffer.ts +170 -0
  295. package/src/audio/sound-file-factory.ts +162 -0
  296. package/src/audio/sound-file-reader.ts +93 -0
  297. package/src/audio/sound-file-writer.ts +19 -0
  298. package/src/audio/sound-recorder.ts +180 -0
  299. package/src/audio/sound-source.ts +168 -0
  300. package/src/audio/sound-stream.ts +60 -0
  301. package/src/audio/sound.ts +36 -0
  302. package/src/audio/value.ts +165 -0
  303. package/src/audio/worker.ts +90 -0
  304. package/src/graphics/blend-mode.ts +125 -0
  305. package/src/graphics/boolean-vector.ts +139 -0
  306. package/src/graphics/circle-shape.ts +56 -0
  307. package/src/graphics/color.ts +189 -0
  308. package/src/graphics/convex-shape.ts +38 -0
  309. package/src/graphics/drawable.ts +19 -0
  310. package/src/graphics/font.ts +248 -0
  311. package/src/graphics/glsl-matrix.ts +73 -0
  312. package/src/graphics/glsl.ts +121 -0
  313. package/src/graphics/glyph.ts +97 -0
  314. package/src/graphics/image.ts +231 -0
  315. package/src/graphics/primitive-type.ts +21 -0
  316. package/src/graphics/rect.ts +214 -0
  317. package/src/graphics/rectangle-shape.ts +39 -0
  318. package/src/graphics/render-states.ts +110 -0
  319. package/src/graphics/render-target.ts +431 -0
  320. package/src/graphics/render-texture.ts +150 -0
  321. package/src/graphics/render-window.ts +155 -0
  322. package/src/graphics/shader.ts +224 -0
  323. package/src/graphics/shape.ts +231 -0
  324. package/src/graphics/sprite.ts +143 -0
  325. package/src/graphics/stencil-mode.ts +97 -0
  326. package/src/graphics/swap.ts +17 -0
  327. package/src/graphics/text.ts +423 -0
  328. package/src/graphics/texture.ts +352 -0
  329. package/src/graphics/transform.ts +242 -0
  330. package/src/graphics/transformable.ts +26 -0
  331. package/src/graphics/vertex-array.ts +201 -0
  332. package/src/graphics/vertex-buffer.ts +209 -0
  333. package/src/graphics/vertex.ts +142 -0
  334. package/src/graphics/view.ts +237 -0
  335. package/src/index.ts +147 -0
  336. package/src/internal/audio-codec-registry.ts +68 -0
  337. package/src/internal/audio-input-stream.ts +42 -0
  338. package/src/internal/audio-music-pump.ts +199 -0
  339. package/src/internal/audio-native.ts +176 -0
  340. package/src/internal/audio-recorder-session.ts +234 -0
  341. package/src/internal/audio-worker-session.ts +89 -0
  342. package/src/internal/audio-worker.ts +146 -0
  343. package/src/internal/glsl-value.ts +54 -0
  344. package/src/internal/graphics-state.ts +131 -0
  345. package/src/internal/input-stream.ts +30 -0
  346. package/src/internal/lazy-value.ts +62 -0
  347. package/src/internal/native.ts +581 -0
  348. package/src/internal/numeric-properties.ts +37 -0
  349. package/src/internal/render-states.ts +42 -0
  350. package/src/internal/scalar.ts +109 -0
  351. package/src/internal/shaped-glyph.ts +68 -0
  352. package/src/internal/struct-view.ts +49 -0
  353. package/src/internal/text-indices.ts +19 -0
  354. package/src/internal/transformable.ts +189 -0
  355. package/src/internal/value-storage.ts +33 -0
  356. package/src/network/common.ts +53 -0
  357. package/src/network/dns.ts +102 -0
  358. package/src/network/ftp.ts +202 -0
  359. package/src/network/gen/constants.ts +253 -0
  360. package/src/network/http.ts +372 -0
  361. package/src/network/ip-address.ts +158 -0
  362. package/src/network/packet.ts +217 -0
  363. package/src/network/sftp.ts +574 -0
  364. package/src/network/socket-selector.ts +112 -0
  365. package/src/network/socket.ts +203 -0
  366. package/src/network/tcp-listener.ts +115 -0
  367. package/src/network/tcp-socket.ts +370 -0
  368. package/src/network/tls-material.ts +30 -0
  369. package/src/network/udp-socket.ts +176 -0
  370. package/src/system/angle.ts +82 -0
  371. package/src/system/clock.ts +61 -0
  372. package/src/system/err.ts +46 -0
  373. package/src/system/error.ts +8 -0
  374. package/src/system/file-input-stream.ts +100 -0
  375. package/src/system/input-stream.ts +66 -0
  376. package/src/system/operators.ts +554 -0
  377. package/src/system/sleep.ts +20 -0
  378. package/src/system/suspend-aware-clock.ts +12 -0
  379. package/src/system/time.ts +149 -0
  380. package/src/system/timeout-with-predicate.ts +53 -0
  381. package/src/system/unicode.ts +28 -0
  382. package/src/system/vector2.ts +345 -0
  383. package/src/system/vector3.ts +267 -0
  384. package/src/system/version.ts +30 -0
  385. package/src/window/clipboard.ts +12 -0
  386. package/src/window/context-settings.ts +78 -0
  387. package/src/window/context.ts +92 -0
  388. package/src/window/cursor.ts +78 -0
  389. package/src/window/event.ts +227 -0
  390. package/src/window/gen/constants.ts +655 -0
  391. package/src/window/joystick.ts +52 -0
  392. package/src/window/keyboard.ts +42 -0
  393. package/src/window/mouse.ts +37 -0
  394. package/src/window/sensor.ts +20 -0
  395. package/src/window/touch.ts +27 -0
  396. package/src/window/video-mode.ts +85 -0
  397. package/src/window/vulkan.ts +19 -0
  398. package/src/window/window.ts +311 -0
  399. package/test/native/audio-probes.cc +181 -0
  400. package/test/native/deferred-delete-probes.cc +62 -0
  401. package/test/native/drawable-probes.cc +168 -0
  402. package/test/native/exception-probes.cc +83 -0
  403. package/test/native/image-probes.cc +105 -0
  404. package/test/native/matrix-probes.cc +67 -0
  405. package/test/native/network-oracle.cc +32 -0
  406. package/test/native/render-texture-probes.cc +193 -0
  407. package/test/native/shader-probes.cc +69 -0
  408. package/test/native/shape-probes.cc +160 -0
  409. package/test/native/sprite-probes.cc +146 -0
  410. package/test/native/system-probes.cc +109 -0
  411. package/test/native/text-probes.cc +211 -0
  412. package/test/native/texture-probes.cc +200 -0
  413. package/test/native/time-probes.cc +143 -0
  414. package/test/native/transform-probes.cc +92 -0
  415. package/test/native/transformable-probes.cc +152 -0
  416. package/test/native/value-oracle.h +88 -0
  417. package/test/native/value-probes.cc +379 -0
  418. package/test/native/vertex-array-probes.cc +82 -0
  419. package/test/native/vertex-buffer-probes.cc +87 -0
  420. package/test/native/view-probes.cc +150 -0
  421. package/test/native/window-probes.cc +172 -0
  422. package/test/tsconfig.json +8 -0
  423. package/tools/configure-lsp.cjs +23 -0
  424. package/tools/generate-network-constants.cjs +47 -0
  425. package/tools/generate-window-constants.cjs +164 -0
  426. package/tools/lib_downloader.cjs +92 -0
  427. package/tools/lib_downloader_urls.cjs +23 -0
  428. package/tsconfig.json +11 -4
  429. package/index.d.ts +0 -1
  430. package/lib/clock.d.ts +0 -8
  431. package/lib/clock.js +0 -5
  432. package/lib/color.d.ts +0 -11
  433. package/lib/color.js +0 -98
  434. package/lib/common.js +0 -47
  435. package/lib/drawable/circle_shape.d.ts +0 -5
  436. package/lib/drawable/circle_shape.js +0 -26
  437. package/lib/drawable/convex_shape.d.ts +0 -5
  438. package/lib/drawable/convex_shape.js +0 -35
  439. package/lib/drawable/drawable.d.ts +0 -6
  440. package/lib/drawable/drawable.js +0 -18
  441. package/lib/drawable/plugin_package.d.ts +0 -31
  442. package/lib/drawable/plugin_package.js +0 -102
  443. package/lib/drawable/rectangle_shape.d.ts +0 -9
  444. package/lib/drawable/rectangle_shape.js +0 -28
  445. package/lib/drawable/shape.d.ts +0 -14
  446. package/lib/drawable/shape.js +0 -30
  447. package/lib/drawable/sprite.d.ts +0 -17
  448. package/lib/drawable/sprite.js +0 -53
  449. package/lib/drawable/text.d.ts +0 -26
  450. package/lib/drawable/text.js +0 -88
  451. package/lib/drawable/transformable.d.ts +0 -28
  452. package/lib/drawable/transformable.js +0 -113
  453. package/lib/drawable/vertex_array.d.ts +0 -40
  454. package/lib/drawable/vertex_array.js +0 -128
  455. package/lib/font.d.ts +0 -24
  456. package/lib/font.js +0 -137
  457. package/lib/image.d.ts +0 -26
  458. package/lib/image.js +0 -147
  459. package/lib/joystick.d.ts +0 -21
  460. package/lib/joystick.js +0 -72
  461. package/lib/keyboard.d.ts +0 -113
  462. package/lib/keyboard.js +0 -17
  463. package/lib/mouse.d.ts +0 -6
  464. package/lib/mouse.js +0 -39
  465. package/lib/poll_event.d.ts +0 -138
  466. package/lib/rect.d.ts +0 -18
  467. package/lib/rect.js +0 -119
  468. package/lib/render_window.d.ts +0 -67
  469. package/lib/render_window.js +0 -197
  470. package/lib/sensor.d.ts +0 -12
  471. package/lib/sensor.js +0 -34
  472. package/lib/sfml.d.ts +0 -32
  473. package/lib/sfml.js +0 -36
  474. package/lib/sound/base.d.ts +0 -33
  475. package/lib/sound/base.js +0 -109
  476. package/lib/sound/music.d.ts +0 -15
  477. package/lib/sound/music.js +0 -65
  478. package/lib/sound/sound.d.ts +0 -16
  479. package/lib/sound/sound.js +0 -55
  480. package/lib/sound/sound_buffer.d.ts +0 -14
  481. package/lib/sound/sound_buffer.js +0 -78
  482. package/lib/texture.d.ts +0 -21
  483. package/lib/texture.js +0 -127
  484. package/lib/time.d.ts +0 -13
  485. package/lib/time.js +0 -41
  486. package/lib/touch.d.ts +0 -7
  487. package/lib/touch.js +0 -34
  488. package/lib/vector2.d.ts +0 -49
  489. package/lib/vector2.js +0 -141
  490. package/lib/vector3.d.ts +0 -47
  491. package/lib/vector3.js +0 -154
  492. package/lib/vertex.d.ts +0 -14
  493. package/lib/vertex.js +0 -177
  494. package/lib/video_mode.d.ts +0 -12
  495. package/lib/video_mode.js +0 -99
  496. package/src/base_class_with_loading.h +0 -21
  497. package/src/clock.cc +0 -71
  498. package/src/clock.h +0 -30
  499. package/src/color.cc +0 -189
  500. package/src/color.h +0 -49
  501. package/src/drawable/circle_shape.cc +0 -78
  502. package/src/drawable/circle_shape.h +0 -28
  503. package/src/drawable/convex_shape.cc +0 -57
  504. package/src/drawable/convex_shape.h +0 -29
  505. package/src/drawable/drawable-inl.h +0 -29
  506. package/src/drawable/drawable.cc +0 -41
  507. package/src/drawable/drawable.h +0 -49
  508. package/src/drawable/package_plugin-inl.h +0 -191
  509. package/src/drawable/package_plugin.h +0 -60
  510. package/src/drawable/rectangle_shape.cc +0 -69
  511. package/src/drawable/rectangle_shape.h +0 -29
  512. package/src/drawable/shape.cc +0 -67
  513. package/src/drawable/shape.h +0 -39
  514. package/src/drawable/sprite.cc +0 -122
  515. package/src/drawable/sprite.h +0 -45
  516. package/src/drawable/text.cc +0 -133
  517. package/src/drawable/text.h +0 -54
  518. package/src/drawable/vertex_array.cc +0 -248
  519. package/src/drawable/vertex_array.h +0 -46
  520. package/src/font.cc +0 -214
  521. package/src/font.h +0 -44
  522. package/src/gen/.gitkeep +0 -0
  523. package/src/gen/joystick_axis.cc +0 -30
  524. package/src/gen/keycode.cc +0 -226
  525. package/src/gen/mouse_button.cc +0 -30
  526. package/src/gen/sensor_type.cc +0 -26
  527. package/src/image.cc +0 -379
  528. package/src/image.h +0 -72
  529. package/src/joystick.cc +0 -132
  530. package/src/joystick.h +0 -32
  531. package/src/keyboard.cc +0 -65
  532. package/src/keyboard.h +0 -27
  533. package/src/mouse.cc +0 -95
  534. package/src/mouse.h +0 -30
  535. package/src/plugins/transformable_plugin-inl.h +0 -121
  536. package/src/plugins/transformable_plugin.h +0 -42
  537. package/src/poll_event.cc +0 -326
  538. package/src/poll_event.h +0 -18
  539. package/src/rect-inl.h +0 -154
  540. package/src/rect.cc +0 -28
  541. package/src/rect.h +0 -105
  542. package/src/render_window.cc +0 -413
  543. package/src/render_window.h +0 -111
  544. package/src/render_window_async_display.cc +0 -49
  545. package/src/render_window_async_draw.cc +0 -56
  546. package/src/resizable_buffer.h +0 -104
  547. package/src/sensor.cc +0 -82
  548. package/src/sensor.h +0 -28
  549. package/src/sfml.cc +0 -85
  550. package/src/sound/music.cc +0 -113
  551. package/src/sound/music.h +0 -35
  552. package/src/sound/sound.cc +0 -116
  553. package/src/sound/sound.h +0 -41
  554. package/src/sound/sound_buffer.cc +0 -226
  555. package/src/sound/sound_buffer.h +0 -46
  556. package/src/sound/sound_source.cc +0 -124
  557. package/src/sound/sound_source.h +0 -80
  558. package/src/texture.cc +0 -246
  559. package/src/texture.h +0 -47
  560. package/src/time.cc +0 -177
  561. package/src/time.h +0 -42
  562. package/src/touch.cc +0 -54
  563. package/src/touch.h +0 -23
  564. package/src/utils-inl.h +0 -48
  565. package/src/utils.h +0 -21
  566. package/src/vector2-inl.h +0 -198
  567. package/src/vector2.cc +0 -36
  568. package/src/vector2.h +0 -133
  569. package/src/vector3-inl.h +0 -200
  570. package/src/vector3.cc +0 -36
  571. package/src/vector3.h +0 -134
  572. package/src/vertex.cc +0 -238
  573. package/src/vertex.h +0 -114
  574. package/src/video_mode.cc +0 -184
  575. package/src/video_mode.h +0 -38
  576. package/src/workers/load_from_file_worker.h +0 -79
  577. package/src/workers/save_to_file_worker.h +0 -79
  578. package/third_party/sfml/include/SFML/Audio/AlResource.hpp +0 -70
  579. package/third_party/sfml/include/SFML/Audio/Export.hpp +0 -48
  580. package/third_party/sfml/include/SFML/Audio/InputSoundFile.hpp +0 -268
  581. package/third_party/sfml/include/SFML/Audio/Listener.hpp +0 -234
  582. package/third_party/sfml/include/SFML/Audio/Music.hpp +0 -337
  583. package/third_party/sfml/include/SFML/Audio/OutputSoundFile.hpp +0 -133
  584. package/third_party/sfml/include/SFML/Audio/Sound.hpp +0 -264
  585. package/third_party/sfml/include/SFML/Audio/SoundBuffer.hpp +0 -352
  586. package/third_party/sfml/include/SFML/Audio/SoundBufferRecorder.hpp +0 -144
  587. package/third_party/sfml/include/SFML/Audio/SoundFileFactory.hpp +0 -197
  588. package/third_party/sfml/include/SFML/Audio/SoundFileFactory.inl +0 -100
  589. package/third_party/sfml/include/SFML/Audio/SoundFileReader.hpp +0 -165
  590. package/third_party/sfml/include/SFML/Audio/SoundFileWriter.hpp +0 -125
  591. package/third_party/sfml/include/SFML/Audio/SoundRecorder.hpp +0 -410
  592. package/third_party/sfml/include/SFML/Audio/SoundSource.hpp +0 -332
  593. package/third_party/sfml/include/SFML/Audio/SoundStream.hpp +0 -420
  594. package/third_party/sfml/include/SFML/Audio.hpp +0 -56
  595. package/third_party/sfml/include/SFML/Config.hpp +0 -248
  596. package/third_party/sfml/include/SFML/GpuPreference.hpp +0 -74
  597. package/third_party/sfml/include/SFML/Graphics/BlendMode.hpp +0 -219
  598. package/third_party/sfml/include/SFML/Graphics/CircleShape.hpp +0 -154
  599. package/third_party/sfml/include/SFML/Graphics/Color.hpp +0 -275
  600. package/third_party/sfml/include/SFML/Graphics/ConvexShape.hpp +0 -153
  601. package/third_party/sfml/include/SFML/Graphics/Drawable.hpp +0 -126
  602. package/third_party/sfml/include/SFML/Graphics/Export.hpp +0 -48
  603. package/third_party/sfml/include/SFML/Graphics/Font.hpp +0 -496
  604. package/third_party/sfml/include/SFML/Graphics/Glsl.hpp +0 -227
  605. package/third_party/sfml/include/SFML/Graphics/Glsl.inl +0 -155
  606. package/third_party/sfml/include/SFML/Graphics/Glyph.hpp +0 -81
  607. package/third_party/sfml/include/SFML/Graphics/Image.hpp +0 -346
  608. package/third_party/sfml/include/SFML/Graphics/PrimitiveType.hpp +0 -58
  609. package/third_party/sfml/include/SFML/Graphics/Rect.hpp +0 -274
  610. package/third_party/sfml/include/SFML/Graphics/Rect.inl +0 -171
  611. package/third_party/sfml/include/SFML/Graphics/RectangleShape.hpp +0 -132
  612. package/third_party/sfml/include/SFML/Graphics/RenderStates.hpp +0 -174
  613. package/third_party/sfml/include/SFML/Graphics/RenderTarget.hpp +0 -518
  614. package/third_party/sfml/include/SFML/Graphics/RenderTexture.hpp +0 -334
  615. package/third_party/sfml/include/SFML/Graphics/RenderWindow.hpp +0 -302
  616. package/third_party/sfml/include/SFML/Graphics/Shader.hpp +0 -875
  617. package/third_party/sfml/include/SFML/Graphics/Shape.hpp +0 -355
  618. package/third_party/sfml/include/SFML/Graphics/Sprite.hpp +0 -279
  619. package/third_party/sfml/include/SFML/Graphics/Text.hpp +0 -513
  620. package/third_party/sfml/include/SFML/Graphics/Texture.hpp +0 -733
  621. package/third_party/sfml/include/SFML/Graphics/Transform.hpp +0 -497
  622. package/third_party/sfml/include/SFML/Graphics/Transformable.hpp +0 -429
  623. package/third_party/sfml/include/SFML/Graphics/Vertex.hpp +0 -148
  624. package/third_party/sfml/include/SFML/Graphics/VertexArray.hpp +0 -223
  625. package/third_party/sfml/include/SFML/Graphics/VertexBuffer.hpp +0 -408
  626. package/third_party/sfml/include/SFML/Graphics/View.hpp +0 -343
  627. package/third_party/sfml/include/SFML/Graphics.hpp +0 -68
  628. package/third_party/sfml/include/SFML/Main.hpp +0 -43
  629. package/third_party/sfml/include/SFML/Network/Export.hpp +0 -48
  630. package/third_party/sfml/include/SFML/Network/Ftp.hpp +0 -616
  631. package/third_party/sfml/include/SFML/Network/Http.hpp +0 -482
  632. package/third_party/sfml/include/SFML/Network/IpAddress.hpp +0 -328
  633. package/third_party/sfml/include/SFML/Network/Packet.hpp +0 -545
  634. package/third_party/sfml/include/SFML/Network/Socket.hpp +0 -219
  635. package/third_party/sfml/include/SFML/Network/SocketHandle.hpp +0 -57
  636. package/third_party/sfml/include/SFML/Network/SocketSelector.hpp +0 -263
  637. package/third_party/sfml/include/SFML/Network/TcpListener.hpp +0 -170
  638. package/third_party/sfml/include/SFML/Network/TcpSocket.hpp +0 -316
  639. package/third_party/sfml/include/SFML/Network/UdpSocket.hpp +0 -292
  640. package/third_party/sfml/include/SFML/Network.hpp +0 -53
  641. package/third_party/sfml/include/SFML/OpenGL.hpp +0 -78
  642. package/third_party/sfml/include/SFML/System/Clock.hpp +0 -117
  643. package/third_party/sfml/include/SFML/System/Err.hpp +0 -80
  644. package/third_party/sfml/include/SFML/System/Export.hpp +0 -48
  645. package/third_party/sfml/include/SFML/System/FileInputStream.hpp +0 -169
  646. package/third_party/sfml/include/SFML/System/InputStream.hpp +0 -152
  647. package/third_party/sfml/include/SFML/System/Lock.hpp +0 -139
  648. package/third_party/sfml/include/SFML/System/MemoryInputStream.hpp +0 -148
  649. package/third_party/sfml/include/SFML/System/Mutex.hpp +0 -148
  650. package/third_party/sfml/include/SFML/System/NativeActivity.hpp +0 -62
  651. package/third_party/sfml/include/SFML/System/NonCopyable.hpp +0 -129
  652. package/third_party/sfml/include/SFML/System/Sleep.hpp +0 -52
  653. package/third_party/sfml/include/SFML/System/String.hpp +0 -669
  654. package/third_party/sfml/include/SFML/System/String.inl +0 -53
  655. package/third_party/sfml/include/SFML/System/Thread.hpp +0 -282
  656. package/third_party/sfml/include/SFML/System/Thread.inl +0 -90
  657. package/third_party/sfml/include/SFML/System/ThreadLocal.hpp +0 -103
  658. package/third_party/sfml/include/SFML/System/ThreadLocalPtr.hpp +0 -158
  659. package/third_party/sfml/include/SFML/System/ThreadLocalPtr.inl +0 -77
  660. package/third_party/sfml/include/SFML/System/Time.hpp +0 -488
  661. package/third_party/sfml/include/SFML/System/Utf.hpp +0 -763
  662. package/third_party/sfml/include/SFML/System/Utf.inl +0 -752
  663. package/third_party/sfml/include/SFML/System/Vector2.hpp +0 -301
  664. package/third_party/sfml/include/SFML/System/Vector2.inl +0 -161
  665. package/third_party/sfml/include/SFML/System/Vector3.hpp +0 -302
  666. package/third_party/sfml/include/SFML/System/Vector3.inl +0 -168
  667. package/third_party/sfml/include/SFML/System.hpp +0 -60
  668. package/third_party/sfml/include/SFML/Window/Clipboard.hpp +0 -119
  669. package/third_party/sfml/include/SFML/Window/Context.hpp +0 -195
  670. package/third_party/sfml/include/SFML/Window/ContextSettings.hpp +0 -149
  671. package/third_party/sfml/include/SFML/Window/Cursor.hpp +0 -241
  672. package/third_party/sfml/include/SFML/Window/Event.hpp +0 -285
  673. package/third_party/sfml/include/SFML/Window/Export.hpp +0 -48
  674. package/third_party/sfml/include/SFML/Window/GlResource.hpp +0 -109
  675. package/third_party/sfml/include/SFML/Window/Joystick.hpp +0 -227
  676. package/third_party/sfml/include/SFML/Window/Keyboard.hpp +0 -491
  677. package/third_party/sfml/include/SFML/Window/Mouse.hpp +0 -180
  678. package/third_party/sfml/include/SFML/Window/Sensor.hpp +0 -150
  679. package/third_party/sfml/include/SFML/Window/Touch.hpp +0 -137
  680. package/third_party/sfml/include/SFML/Window/VideoMode.hpp +0 -228
  681. package/third_party/sfml/include/SFML/Window/Vulkan.hpp +0 -115
  682. package/third_party/sfml/include/SFML/Window/Window.hpp +0 -354
  683. package/third_party/sfml/include/SFML/Window/WindowBase.hpp +0 -518
  684. package/third_party/sfml/include/SFML/Window/WindowHandle.hpp +0 -101
  685. package/third_party/sfml/include/SFML/Window/WindowStyle.hpp +0 -53
  686. package/third_party/sfml/include/SFML/Window.hpp +0 -58
  687. package/tools/clang_format.js +0 -9
  688. package/tools/copier/linux.js +0 -21
  689. package/tools/copier/macos.js +0 -34
  690. package/tools/copier/windows.js +0 -33
  691. package/tools/joystick_axis.js +0 -63
  692. package/tools/keycode.js +0 -92
  693. package/tools/lib_downloader.js +0 -107
  694. package/tools/lib_downloader_urls.js +0 -59
  695. package/tools/mouse_button.js +0 -92
  696. package/tools/sensor_type.js +0 -63
@@ -0,0 +1,203 @@
1
+ import { EventEmitter } from 'node:events';
2
+ import { Socket as TcpHandle, Server } from 'node:net';
3
+ import { Socket as UdpHandle, createSocket } from 'node:dgram';
4
+ import { IpAddressType } from './ip-address';
5
+ import { uint, waitFor } from './common';
6
+
7
+ /** 套接字使用的传输协议,对应 sf::Socket::Type。 */
8
+ export enum SocketType {
9
+ /** TCP 字节流协议。 */
10
+ Tcp,
11
+ /** UDP 数据报协议。 */
12
+ Udp,
13
+ }
14
+
15
+ /** 套接字操作结果;阻塞模式通过 Promise 等待,不阻塞 Node 事件循环。 */
16
+ export enum SocketStatus {
17
+ /** 操作完成。 */
18
+ Done,
19
+ /** 暂无数据或发送空间,稍后重试。 */
20
+ NotReady,
21
+ /** 仅发送了部分数据,需继续发送剩余部分。 */
22
+ Partial,
23
+ /** 连接已断开。 */
24
+ Disconnected,
25
+ /** 操作出错,可通过 getLastError 获取底层错误。 */
26
+ Error,
27
+ }
28
+ /** Node TCP、UDP 或监听传输对象,不接受操作系统裸文件描述符。 */
29
+ export type SocketHandle = TcpHandle | Server | UdpHandle;
30
+ export const socketEvents: unique symbol = Symbol('Socket.events');
31
+ export const socketReady: unique symbol = Symbol('Socket.ready');
32
+ export const socketAlive: unique symbol = Symbol('Socket.alive');
33
+
34
+ /** 绑定失败可能清空 Node 的延迟关闭队列,错误派发结束后再释放旧句柄。 */
35
+ function closeDatagram(handle: UdpHandle): void {
36
+ let retry: () => void;
37
+ const cleanup = () => {
38
+ handle.off('error', retry);
39
+ handle.off('close', cleanup);
40
+ };
41
+ const close = () => {
42
+ try { handle.close(); } catch { cleanup(); }
43
+ };
44
+ retry = () => { queueMicrotask(close); };
45
+ handle.on('error', retry);
46
+ handle.once('close', cleanup);
47
+ close();
48
+ }
49
+
50
+ /** Node 网络传输的公共基类;默认使用异步等待的阻塞语义。 */
51
+ export abstract class Socket {
52
+ /** 套接字操作状态枚举。 */
53
+ static readonly Status = SocketStatus;
54
+ /** 套接字传输协议枚举。 */
55
+ static readonly Type = SocketType;
56
+ /** 绑定端口时由系统自动分配可用端口。 */
57
+ static readonly AnyPort = 0;
58
+ readonly [socketEvents] = new EventEmitter();
59
+ protected blocking = true;
60
+ protected epoch = 0;
61
+ protected failure?: Error;
62
+ /** 当前独占的 Node 传输,关闭或重建时由 Node 释放。 */
63
+ protected transport?: SocketHandle;
64
+ /** 移除当前传输的事件监听。 */
65
+ protected detach?: () => void;
66
+ /** 初始化套接字公共状态,默认启用阻塞语义。 */
67
+ protected constructor(private readonly type = SocketType.Tcp) {
68
+ uint(type, 1);
69
+ this[socketEvents].setMaxListeners(0);
70
+ }
71
+ /** 设置是否异步等待可读/可写;false 时按当前队列状态返回 NotReady 或 Partial。 */
72
+ setBlocking(blocking: boolean): void {
73
+ if (typeof blocking !== 'boolean') throw new TypeError('Expected a boolean');
74
+ this.blocking = blocking;
75
+ this.changed();
76
+ }
77
+ /** 返回是否使用异步等待的阻塞语义。 */
78
+ isBlocking(): boolean { return this.blocking; }
79
+ /** 返回最近的底层错误;未记录错误时为 undefined。 */
80
+ getLastError(): Error | undefined { return this.failure; }
81
+ protected changed(): void { this[socketEvents].emit('change'); }
82
+ protected async awaitReady(check: () => boolean, generation: number):
83
+ Promise<boolean> {
84
+ if (!check() && this.blocking && this.epoch === generation) {
85
+ await waitFor(this[socketEvents], () => check() || !this.blocking ||
86
+ this.epoch !== generation);
87
+ }
88
+ return this.epoch === generation && check();
89
+ }
90
+ /** 供 Selector 读取子类可覆盖的就绪条件。 */
91
+ [socketReady](mask: number): number { return this.getReadiness(mask); }
92
+ /** 供 Selector 查询子类可覆盖的存活状态。 */
93
+ [socketAlive](): boolean { return this.isAlive(); }
94
+ /** 供子类访问底层 Node 传输对象;未创建时为 undefined。 */
95
+ protected getNativeHandle(): SocketHandle | undefined { return this.transport; }
96
+ /** 分配指定地址族的传输,不隐式连接或绑定端口。 */
97
+ protected create(addressType?: IpAddressType): void;
98
+ /** 接管 Node 传输并关闭旧传输;不接管裸文件描述符。 */
99
+ protected create(handle: SocketHandle): void;
100
+ protected create(value: IpAddressType | SocketHandle = IpAddressType.IpV4):
101
+ void {
102
+ const handle = typeof value === 'number'
103
+ ? this.allocateHandle(uint(value, 1)) : value;
104
+ this.validateHandle(handle);
105
+ if (handle === this.transport) return;
106
+ this.close();
107
+ this.failure = undefined;
108
+ this.transport = handle;
109
+ this.onCreate();
110
+ this.changed();
111
+ }
112
+ /** 关闭当前传输并唤醒旧代际的等待;重复调用安全,阻塞标志不变。 */
113
+ protected close(): void {
114
+ const handle = this.transport;
115
+ this.epoch++;
116
+ this.detach?.();
117
+ this.detach = undefined;
118
+ this.transport = undefined;
119
+ this.onClose();
120
+ if (handle instanceof UdpHandle) closeDatagram(handle);
121
+ else if (handle) {
122
+ // 销毁期间可能产生迟到的错误;不再保留捕获当前实例的监听闭包。
123
+ const ignore = () => {};
124
+ handle.on('error', ignore);
125
+ handle.once('close', () => handle.off('error', ignore));
126
+ if (handle instanceof TcpHandle) handle.destroy();
127
+ else {
128
+ try { handle.close(); } catch { handle.off('error', ignore); }
129
+ }
130
+ }
131
+ this.changed();
132
+ }
133
+ /** 按协议分配未连接传输;监听器可覆盖为 Node Server。 */
134
+ protected allocateHandle(addressType: IpAddressType): SocketHandle {
135
+ return this.type === SocketType.Tcp ? new TcpHandle()
136
+ : createSocket(addressType === IpAddressType.IpV4 ? 'udp4' : 'udp6');
137
+ }
138
+ /** 接管前验证传输类型,避免关闭旧连接后才发现类型错误。 */
139
+ protected validateHandle(handle: SocketHandle): void {
140
+ if (this.type === SocketType.Udp ? !(handle instanceof UdpHandle)
141
+ : !(handle instanceof TcpHandle || handle instanceof Server)) {
142
+ throw new TypeError('Expected a matching Node socket transport');
143
+ }
144
+ }
145
+ /** 安装默认 TCP/UDP/Server 状态监听;子类可覆盖以管理自己的收发队列。 */
146
+ protected onCreate(): void {
147
+ const handle = this.transport!;
148
+ const generation = this.epoch;
149
+ const current = () => this.epoch === generation && this.transport === handle;
150
+ const notify = () => { if (current()) this.changed(); };
151
+ const error = (error: Error) => {
152
+ if (!current()) return;
153
+ this.failure = error; this.changed();
154
+ };
155
+ const events = [ 'readable', 'drain', 'connect', 'end', 'close', 'listening' ];
156
+ for (const event of events) handle.on(event, notify);
157
+ handle.on('error', error);
158
+ this.detach = () => {
159
+ for (const event of events) handle.off(event, notify);
160
+ handle.off('error', error);
161
+ };
162
+ }
163
+ /** 关闭时清理子类状态,调用时旧传输已解除关联。 */
164
+ protected onClose(): void {}
165
+ /** 默认查询 Node 传输是否存活;子类可覆盖,不需要导入内部 symbol。 */
166
+ protected isAlive(): boolean {
167
+ const handle = this.transport;
168
+ if (handle instanceof TcpHandle) return !handle.destroyed;
169
+ if (handle instanceof Server) return handle.listening;
170
+ if (handle instanceof UdpHandle) {
171
+ try { handle.address(); return true; } catch { return false; }
172
+ }
173
+ return false;
174
+ }
175
+ /**
176
+ * 默认 TCP 按可读字节和写入背压就绪,已绑定 UDP 可发送。
177
+ * UDP 数据报和 Server 连接队列由子类通过此钩子和 changed() 通知 Selector。
178
+ */
179
+ protected getReadiness(mask: number): number {
180
+ const handle = this.transport;
181
+ let ready = 0;
182
+ if (handle instanceof TcpHandle) {
183
+ if (handle.readableLength || handle.readableEnded || handle.destroyed) {
184
+ ready += 1;
185
+ }
186
+ if (handle.remoteAddress && !handle.connecting && !handle.destroyed &&
187
+ handle.writable && !handle.writableNeedDrain) ready += 2;
188
+ } else if (handle instanceof UdpHandle && this.isAlive()) ready = 2;
189
+ // eslint-disable-next-line no-bitwise
190
+ return ready & mask;
191
+ }
192
+ /** 等待写操作或代际取消;关闭时不依赖底层写回调是否会触发。 */
193
+ protected async awaitWrite(completion: Promise<SocketStatus>,
194
+ generation: number): Promise<SocketStatus> {
195
+ const cancel = new AbortController();
196
+ const closed = waitFor(this[socketEvents],
197
+ () => this.epoch !== generation, 0, cancel.signal)
198
+ .then(() => SocketStatus.Disconnected);
199
+ try { return await Promise.race([ completion, closed ]); } finally {
200
+ cancel.abort();
201
+ }
202
+ }
203
+ }
@@ -0,0 +1,115 @@
1
+ import { createServer, Server, type Socket as NetSocket } from 'node:net';
2
+ import { Socket, SocketStatus as Status,
3
+ socketEvents, SocketType, type SocketHandle } from './socket';
4
+ import { IpAddress } from './ip-address';
5
+ import { TcpSocket, adoptTcp } from './tcp-socket';
6
+ import { SerialQueue, uint, waitFor } from './common';
7
+
8
+ /** 监听 TCP 连接并通过 accept 将连接交给 TcpSocket。 */
9
+ export class TcpListener extends Socket {
10
+ /** 与基类生命周期共用的 Node 监听传输。 */
11
+ declare protected transport?: Server;
12
+ private pending: NetSocket[] = [];
13
+ private listening = false;
14
+ private readonly accepts = new SerialQueue();
15
+ /** 创建尚未监听的 TCP 监听器。 */
16
+ constructor() { super(SocketType.Tcp); }
17
+ /** 返回监听端口;未监听时为 0。 */
18
+ getLocalPort(): number {
19
+ const address = this.transport?.address();
20
+ return address && typeof address !== 'string' ? address.port : 0;
21
+ }
22
+ /** 异步绑定并监听,port 为 0 时自动分配端口;默认绑定所有 IPv4 接口。 */
23
+ async listen(port: number, address: IpAddress = IpAddress.Any):
24
+ Promise<Status> {
25
+ uint(port, 65535);
26
+ if (!(address instanceof IpAddress)) throw new TypeError('Expected IpAddress');
27
+ this.create(address.getType());
28
+ const generation = this.epoch;
29
+ const server = this.transport!;
30
+ const ready = waitFor(this[socketEvents], () => this.listening ||
31
+ !!this.failure || generation !== this.epoch);
32
+ server.listen({ host: address.toString(), port, ipv6Only: address.isV6() });
33
+ await ready;
34
+ return generation !== this.epoch ? Status.Disconnected
35
+ : this.listening ? Status.Done : Status.Error;
36
+ }
37
+ /** 监听器分配 Server,不创建客户端传输或隐式监听端口。 */
38
+ protected allocateHandle(): Server {
39
+ return createServer({ pauseOnConnect: true });
40
+ }
41
+ /** 监听器仅接管 Node Server。 */
42
+ protected validateHandle(handle: SocketHandle): void {
43
+ if (!(handle instanceof Server)) throw new TypeError('Expected Node Server');
44
+ }
45
+ /** 安装接受队列及监听状态,支持接管已经监听的 Server。 */
46
+ protected onCreate(): void {
47
+ const server = this.transport!;
48
+ const generation = this.epoch;
49
+ const current = () => server === this.transport && generation === this.epoch;
50
+ this.listening = server.listening;
51
+ const connection = (socket: NetSocket) => {
52
+ if (!current() || this.pending.length >= 128) {
53
+ socket.destroy();
54
+ return;
55
+ }
56
+ socket.on('error', () => {});
57
+ this.pending.push(socket);
58
+ this.changed();
59
+ };
60
+ const error = (error: Error) => {
61
+ if (!current()) return;
62
+ this.failure = error;
63
+ this.listening = false;
64
+ this.changed();
65
+ };
66
+ const listening = () => {
67
+ if (!current()) return;
68
+ this.listening = true; this.changed();
69
+ };
70
+ const closed = () => {
71
+ if (!current()) return;
72
+ this.listening = false; this.changed();
73
+ };
74
+ server.on('connection', connection)
75
+ .on('error', error)
76
+ .on('listening', listening)
77
+ .on('close', closed);
78
+ this.detach = () => {
79
+ server.off('connection', connection)
80
+ .off('error', error)
81
+ .off('listening', listening)
82
+ .off('close', closed);
83
+ };
84
+ }
85
+ /** 停止监听并关闭尚未 accept 的连接。 */
86
+ close(): void { super.close(); }
87
+ /** 清空旧代际中尚未接受的连接。 */
88
+ protected onClose(): void {
89
+ this.listening = false;
90
+ for (const socket of this.pending) socket.destroy();
91
+ this.pending = [];
92
+ }
93
+ /** 将下一个连接交给 socket;阻塞模式异步等待,非阻塞模式无连接时返回 NotReady。 */
94
+ accept(socket: TcpSocket): Promise<Status> {
95
+ if (!(socket instanceof TcpSocket)) throw new TypeError('Expected TcpSocket');
96
+ const generation = this.epoch;
97
+ return this.accepts.run(async () => {
98
+ await this.awaitReady(() => this.pending.length > 0 || !this.listening,
99
+ generation);
100
+ if (generation !== this.epoch || !this.listening) return Status.Error;
101
+ const accepted = this.pending.shift();
102
+ if (!accepted) return Status.NotReady;
103
+ socket[adoptTcp](accepted);
104
+ return Status.Done;
105
+ });
106
+ }
107
+ /** 返回监听状态,允许派生类扩展。 */
108
+ protected isAlive(): boolean { return this.listening; }
109
+ /** 接受队列非空时报告接收就绪。 */
110
+ protected getReadiness(mask: number): number {
111
+ // eslint-disable-next-line no-bitwise
112
+ return this.pending.length ? mask & 1 : 0;
113
+ }
114
+ protected getNativeHandle(): Server | undefined { return this.transport; }
115
+ }
@@ -0,0 +1,370 @@
1
+ import { Socket as NetSocket } from 'node:net';
2
+ import { TLSSocket, connect as tlsConnect, createSecureContext } from 'node:tls';
3
+ import { Time } from '../system/time';
4
+ import { IpAddress } from './ip-address';
5
+ import { Packet, packetReceive, packetSend } from './packet';
6
+ import { Socket, SocketStatus as Status,
7
+ socketEvents, SocketType, type SocketHandle } from './socket';
8
+ import { SerialQueue, bytes, millisecondsOf, uint, waitFor,
9
+ type NetworkTime } from './common';
10
+ import { tlsCertificate, tlsPrivateKey } from './tls-material';
11
+
12
+ /** TLS 升级的当前状态。 */
13
+ export enum TlsStatus {
14
+ /** 未建立 TLS 连接。 */
15
+ NotConnected,
16
+ /** 握手已开始但尚未完成。 */
17
+ HandshakeStarted,
18
+ /** 握手完成,可以传输加密数据。 */
19
+ HandshakeComplete,
20
+ /** 握手失败。 */
21
+ Error,
22
+ }
23
+ /** 原始 TCP 字节读取结果。 */
24
+ export interface SocketTransfer {
25
+ /** 操作结果状态。 */
26
+ status: Status;
27
+ /** 实际写入目标缓冲区的字节数。 */
28
+ received: number;
29
+ }
30
+ /** 原始 TCP 字节发送结果。 */
31
+ export interface SocketSendResult {
32
+ /** 操作结果状态。 */
33
+ status: Status;
34
+ /** 已交给 Node 传输层的字节数,不代表对端已接收。 */
35
+ sent: number;
36
+ }
37
+ export const adoptTcp: unique symbol = Symbol('TcpSocket.adopt');
38
+
39
+ /** 支持原始字节、SFML Packet 分帧和 TLS 升级的 TCP 套接字。 */
40
+ export class TcpSocket extends Socket {
41
+ /** TLS 握手状态枚举。 */
42
+ static readonly TlsStatus = TlsStatus;
43
+ /** 底层 TCP 或 TLS 套接字。 */
44
+ declare protected transport?: NetSocket;
45
+ /** TCP 连接是否已建立。 */
46
+ private connected = false;
47
+ /** 对端是否已关闭发送。 */
48
+ private ended = true;
49
+ /** TLS 握手当前状态。 */
50
+ private tlsStatus = TlsStatus.NotConnected;
51
+ /** 接收操作串行队列,保证分帧完整性。 */
52
+ private readonly reads = new SerialQueue();
53
+ /** 发送操作串行队列。 */
54
+ private readonly writes = new SerialQueue();
55
+ /** Packet 分帧的 4 字节长度前缀缓冲区。 */
56
+ private prefix = Buffer.alloc(4);
57
+ /** 已累积的前缀字节数。 */
58
+ private prefixSize = 0;
59
+ /** 解析出的包体长度。 */
60
+ private packetSize?: number;
61
+ /** 已累积的包体分片。 */
62
+ private packetChunks: Buffer[] = [];
63
+ /** 已累积的包体字节数。 */
64
+ private packetBytes = 0;
65
+ /** 进行中的 Packet 发送快照及其位置。 */
66
+ private outgoing?: { packet: Packet; data: Buffer; position: number };
67
+
68
+ /** 创建未连接的 TCP 套接字,默认使用异步阻塞语义。 */
69
+ constructor() { super(SocketType.Tcp); }
70
+ /** 返回本地端口,尚未分配时为 0。 */
71
+ getLocalPort(): number { return this.transport?.localPort ?? 0; }
72
+ /** 返回对端地址,未连接时为 undefined。 */
73
+ getRemoteAddress(): IpAddress | undefined {
74
+ const address = this.connected ? this.transport?.remoteAddress : undefined;
75
+ return address ? IpAddress.fromString(address) : undefined;
76
+ }
77
+ /** 返回对端端口,未连接时为 0。 */
78
+ getRemotePort(): number {
79
+ return this.connected ? this.transport?.remotePort ?? 0 : 0;
80
+ }
81
+ /** 发起 TCP 连接;默认等待完成,非阻塞模式返回 NotReady,Time.Zero 不设超时。 */
82
+ async connect(address: IpAddress, port: number,
83
+ timeout: NetworkTime = Time.Zero): Promise<Status> {
84
+ if (!(address instanceof IpAddress)) throw new TypeError('Expected IpAddress');
85
+ uint(port, 65535);
86
+ const milliseconds = millisecondsOf(timeout);
87
+ this.create(address.getType());
88
+ const generation = this.epoch;
89
+ const socket = this.transport!;
90
+ let timer: NodeJS.Timeout | undefined;
91
+ const done = waitFor(this[socketEvents], () => this.connected || this.ended ||
92
+ this.epoch !== generation).then(() => {
93
+ if (timer) clearTimeout(timer);
94
+ return this.epoch !== generation ? Status.Disconnected
95
+ : this.connected ? Status.Done : Status.Error;
96
+ });
97
+ if (milliseconds) {
98
+ timer = setTimeout(() => {
99
+ if (this.epoch !== generation) return;
100
+ this.failure = new Error('Connection timed out');
101
+ socket.destroy(this.failure);
102
+ }, milliseconds);
103
+ }
104
+ socket.connect({ host: address.toString(), port,
105
+ family: address.isV4() ? 4 : 6 });
106
+ return this.blocking ? done : Status.NotReady;
107
+ }
108
+ /** 立即关闭连接并清除未完成的收发包状态。 */
109
+ disconnect(): void { this.close(); }
110
+ /** 接管前拒绝 UDP 或监听传输。 */
111
+ protected validateHandle(handle: SocketHandle): void {
112
+ if (!(handle instanceof NetSocket)) throw new TypeError('Expected Node TCP');
113
+ }
114
+ /** 将受保护 create 分配或接管的句柄接入 TCP 收发和就绪状态。 */
115
+ protected onCreate(): void {
116
+ const socket = this.transport!;
117
+ this.connected = !socket.connecting && !!socket.remoteAddress;
118
+ this.attach(socket);
119
+ }
120
+ /** 重建时清理帧解析、TLS 和发送快照,旧等待由基类代际机制取消。 */
121
+ protected onClose(): void {
122
+ this.connected = false;
123
+ this.ended = true;
124
+ this.tlsStatus = TlsStatus.NotConnected;
125
+ this.resetPacket();
126
+ this.outgoing = undefined;
127
+ }
128
+ /** 监听器通过同一生命周期接管已接受的连接。 */
129
+ [adoptTcp](socket: NetSocket): void {
130
+ this.create(socket);
131
+ }
132
+ /** 将空闲连接升级为 TLS 客户端;默认验证,CA 字节支持 PEM 或 DER。 */
133
+ async setupTlsClient(hostname: string,
134
+ verifyOrCa: boolean | string | Uint8Array = true): Promise<TlsStatus> {
135
+ if (typeof hostname !== 'string') throw new TypeError('Expected hostname');
136
+ return this.setupTls(() => tlsConnect({
137
+ socket: this.transport, servername: hostname,
138
+ rejectUnauthorized: verifyOrCa !== false,
139
+ ca: typeof verifyOrCa === 'boolean' ? undefined : tlsCertificate(verifyOrCa),
140
+ }), 'secureConnect');
141
+ }
142
+ /** 使用 PEM/DER 证书与私钥升级 TLS 服务端;口令字节保留原始内容及子视图。 */
143
+ async setupTlsServer(certificate: string | Uint8Array,
144
+ key: string | Uint8Array, password: string | Uint8Array = ''):
145
+ Promise<TlsStatus> {
146
+ return this.setupTls(() => new TLSSocket(this.transport!, {
147
+ isServer: true,
148
+ secureContext: createSecureContext({
149
+ cert: tlsCertificate(certificate),
150
+ key: tlsPrivateKey(key, password),
151
+ }),
152
+ }), 'secure');
153
+ }
154
+ /** 返回握手协商的加密套件名;TLS 未完成时为 undefined。 */
155
+ getCurrentCiphersuiteName(): string | undefined {
156
+ return this.tlsStatus === TlsStatus.HandshakeComplete &&
157
+ this.transport instanceof TLSSocket
158
+ ? this.transport.getCipher()?.standardName ??
159
+ this.transport.getCipher()?.name : undefined;
160
+ }
161
+ /** 发送调用时的包快照,自动加网络序 u32 长度头;Partial 时用同一 Packet 继续。 */
162
+ send(packet: Packet): Promise<Status>;
163
+ /** 发送调用时的字节快照;Partial 时按 sent 偏移重试剩余字节。 */
164
+ send(data: Uint8Array): Promise<SocketSendResult>;
165
+ send(data: Packet | Uint8Array): Promise<Status | SocketSendResult> {
166
+ const generation = this.epoch;
167
+ // Snapshot at call time, including for nonblocking writes accepted by Node.
168
+ const snapshot = data instanceof Packet
169
+ ? this.outgoing?.packet === data ? undefined : Buffer.from(data[packetSend]())
170
+ : Buffer.from(bytes(data));
171
+ return this.writes.run(async () => {
172
+ const packet = data instanceof Packet ? data : undefined;
173
+ const result = (status: Status, sent = 0) =>
174
+ (packet ? status : { status, sent });
175
+ if (generation !== this.epoch || !this.connected) {
176
+ return result(this.failure ? Status.Error : Status.Disconnected);
177
+ }
178
+ if (this.tlsStatus === TlsStatus.HandshakeStarted) {
179
+ return result(Status.NotReady);
180
+ }
181
+ if (this.outgoing && this.outgoing.packet !== packet) {
182
+ return result(Status.NotReady);
183
+ }
184
+ if (packet && !this.outgoing) {
185
+ const body = snapshot!;
186
+ uint(body.length);
187
+ const wire = Buffer.allocUnsafe(body.length + 4);
188
+ wire.writeUInt32BE(body.length);
189
+ body.copy(wire, 4);
190
+ this.outgoing = { packet, data: wire, position: 0 };
191
+ }
192
+ const input = this.outgoing
193
+ ? this.outgoing.data.subarray(this.outgoing.position) : snapshot!;
194
+ const socket = this.transport!;
195
+ if (!input.length) return result(Status.Done);
196
+ const room = this.blocking ? input.length
197
+ : Math.max(0, socket.writableHighWaterMark - socket.writableLength);
198
+ const count = Math.min(input.length, room);
199
+ if (!count) return result(Status.NotReady);
200
+ const completion = new Promise<Status>(resolve => {
201
+ socket.write(input.subarray(0, count), error =>
202
+ resolve(error ? Status.Error : Status.Done));
203
+ });
204
+ if (this.outgoing) {
205
+ this.outgoing.position += count;
206
+ if (this.outgoing.position === this.outgoing.data.length) {
207
+ this.outgoing = undefined;
208
+ }
209
+ }
210
+ const status = this.blocking
211
+ ? await this.awaitWrite(completion, generation) : Status.Done;
212
+ if (generation !== this.epoch) return result(Status.Disconnected, count);
213
+ return result(status === Status.Done && count < input.length
214
+ ? Status.Partial : status, count);
215
+ });
216
+ }
217
+ /** 接收完整长度前缀包后替换 packet;非阻塞模式保留未完整的分帧,最多接收 64 MiB。 */
218
+ receive(packet: Packet): Promise<Status>;
219
+ /** 接收至 data 并返回实际字节数;完成前勿修改目标缓冲区。 */
220
+ receive(data: Uint8Array): Promise<SocketTransfer>;
221
+ receive(destination: Packet | Uint8Array): Promise<Status | SocketTransfer> {
222
+ const output = destination instanceof Packet ? undefined : bytes(destination);
223
+ const generation = this.epoch;
224
+ return this.reads.run(async () => {
225
+ if (destination instanceof Packet) {
226
+ for (;;) {
227
+ const header = this.packetSize === undefined;
228
+ const needed = header ? 4 - this.prefixSize
229
+ : this.packetSize! - this.packetBytes;
230
+ if (!needed && !header) {
231
+ const payload = Buffer.concat(this.packetChunks, this.packetBytes);
232
+ this.resetPacket();
233
+ destination[packetReceive](payload);
234
+ return Status.Done;
235
+ }
236
+ const chunk = await this.readChunk(needed, generation);
237
+ if (typeof chunk === 'number') return chunk;
238
+ if (header) {
239
+ chunk.copy(this.prefix, this.prefixSize);
240
+ this.prefixSize += chunk.length;
241
+ if (this.prefixSize === 4) {
242
+ this.packetSize = this.prefix.readUInt32BE();
243
+ if (this.packetSize > 64 * 1024 * 1024) {
244
+ this.failure = new Error('Packet exceeds 64 MiB receive limit');
245
+ this.disconnect();
246
+ return Status.Error;
247
+ }
248
+ }
249
+ } else {
250
+ this.packetChunks.push(chunk);
251
+ this.packetBytes += chunk.length;
252
+ }
253
+ }
254
+ }
255
+ if (this.prefixSize || this.packetSize !== undefined) {
256
+ throw new Error('Finish receiving the pending Packet first');
257
+ }
258
+ if (!output!.length) return { status: Status.Error, received: 0 };
259
+ const chunk = await this.readChunk(output!.length, generation);
260
+ if (typeof chunk === 'number') return { status: chunk, received: 0 };
261
+ chunk.copy(output!);
262
+ return { status: Status.Done, received: chunk.length };
263
+ });
264
+ }
265
+ /** 返回 TCP 传输存活状态,允许派生类扩展。 */
266
+ protected isAlive(): boolean { return !!this.transport && !this.ended; }
267
+ /** 返回接收、发送及 TLS 握手对应的就绪位。 */
268
+ protected getReadiness(mask: number): number {
269
+ const socket = this.transport;
270
+ const receive = socket && (socket.readableLength > 0 || this.ended) ? 1 : 0;
271
+ const send = this.connected && socket && !socket.destroyed &&
272
+ !socket.writableNeedDrain && this.tlsStatus !== TlsStatus.HandshakeStarted
273
+ ? 2 : 0;
274
+ // eslint-disable-next-line no-bitwise
275
+ return (receive | send) & mask;
276
+ }
277
+ protected getNativeHandle(): NetSocket | undefined { return this.transport; }
278
+ /** 重置 Packet 分帧累积状态。 */
279
+ private resetPacket(): void {
280
+ this.prefixSize = 0;
281
+ this.packetSize = undefined;
282
+ this.packetChunks = [];
283
+ this.packetBytes = 0;
284
+ }
285
+ /** 异步读取最多 max 字节,含代际校验。 */
286
+ private async readChunk(max: number, generation: number):
287
+ Promise<Buffer | Status> {
288
+ const available = () => this.ended ||
289
+ (this.transport?.readableLength ?? 0) > 0;
290
+ await this.awaitReady(available, generation);
291
+ if (generation !== this.epoch) return Status.Disconnected;
292
+ const socket = this.transport;
293
+ const count = Math.min(max, socket?.readableLength ?? 0);
294
+ if (count) return socket!.read(count) as Buffer;
295
+ if (this.ended) return this.failure ? Status.Error : Status.Disconnected;
296
+ return Status.NotReady;
297
+ }
298
+ /** 绑定套接字事件监听并设置 TCP_NODELAY。 */
299
+ private attach(socket: NetSocket): void {
300
+ this.detach?.();
301
+ this.transport = socket;
302
+ this.ended = socket.destroyed || socket.readableEnded;
303
+ socket.setNoDelay(true);
304
+ const generation = this.epoch;
305
+ const current = () => socket === this.transport && generation === this.epoch;
306
+ const readable = () => { if (current()) this.changed(); };
307
+ const connected = () => {
308
+ if (!current()) return;
309
+ this.connected = true; this.changed();
310
+ };
311
+ const ended = () => {
312
+ if (!current()) return;
313
+ this.connected = false; this.ended = true; this.changed();
314
+ };
315
+ const error = (error: Error) => {
316
+ if (!current()) return;
317
+ this.failure = error; ended();
318
+ };
319
+ socket.on('readable', readable)
320
+ .on('drain', readable)
321
+ .on('connect', connected)
322
+ .on('end', ended)
323
+ .on('close', ended)
324
+ .on('error', error);
325
+ this.detach = () => {
326
+ socket.off('readable', readable)
327
+ .off('drain', readable)
328
+ .off('connect', connected)
329
+ .off('end', ended)
330
+ .off('close', ended)
331
+ .off('error', error);
332
+ };
333
+ }
334
+ /** 将空闲连接升级为 TLS 并等待握手完成。 */
335
+ private async setupTls(create: () => TLSSocket, event: string):
336
+ Promise<TlsStatus> {
337
+ if (!this.connected) return TlsStatus.NotConnected;
338
+ const generation = this.epoch;
339
+ if (this.tlsStatus === TlsStatus.NotConnected) {
340
+ if (this.transport!.readableLength || this.transport!.writableLength) {
341
+ throw new Error('TLS upgrade requires an empty plaintext queue');
342
+ }
343
+ try {
344
+ this.detach?.();
345
+ const socket = create();
346
+ this.attach(socket);
347
+ this.tlsStatus = TlsStatus.HandshakeStarted;
348
+ const secure = () => {
349
+ if (socket !== this.transport || generation !== this.epoch) return;
350
+ this.tlsStatus = TlsStatus.HandshakeComplete;
351
+ this.changed();
352
+ };
353
+ socket.once(event, secure);
354
+ const detach = this.detach;
355
+ this.detach = () => { detach?.(); socket.off(event, secure); };
356
+ } catch (error) {
357
+ this.failure = error as Error;
358
+ this.disconnect();
359
+ return TlsStatus.Error;
360
+ }
361
+ }
362
+ if (this.blocking && this.tlsStatus === TlsStatus.HandshakeStarted) {
363
+ await waitFor(this[socketEvents], () => this.ended ||
364
+ this.tlsStatus !== TlsStatus.HandshakeStarted ||
365
+ generation !== this.epoch);
366
+ }
367
+ return this.ended || generation !== this.epoch ? TlsStatus.Error
368
+ : this.tlsStatus;
369
+ }
370
+ }