sfml.js 0.0.1 → 1.0.0-rc.2
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.
- package/LICENSE +1 -1
- package/README.ja.md +173 -0
- package/README.ko.md +173 -0
- package/README.md +129 -20
- package/README.zh-CN.md +173 -0
- package/assets/branding/sfml-js-symbol-pentagon.svg +24 -0
- package/assets/branding/sfml-js-wordmark-dark.svg +20 -0
- package/assets/branding/sfml-js-wordmark.svg +19 -0
- package/assets/breakout.png +0 -0
- package/binding.gyp +95 -183
- package/dist/audio/effect-processor.d.ts +67 -0
- package/dist/audio/effect-processor.js +58 -0
- package/dist/audio/input-sound-file.d.ts +138 -0
- package/dist/audio/input-sound-file.js +253 -0
- package/dist/audio/listener.d.ts +90 -0
- package/dist/audio/listener.js +148 -0
- package/dist/audio/music.d.ts +210 -0
- package/dist/audio/music.js +353 -0
- package/dist/audio/output-sound-file.d.ts +47 -0
- package/dist/audio/output-sound-file.js +102 -0
- package/dist/audio/playback-device.d.ts +121 -0
- package/dist/audio/playback-device.js +152 -0
- package/dist/audio/sound-buffer-recorder.d.ts +114 -0
- package/dist/audio/sound-buffer-recorder.js +142 -0
- package/dist/audio/sound-buffer.d.ts +150 -0
- package/dist/audio/sound-buffer.js +237 -0
- package/dist/audio/sound-file-factory.d.ts +100 -0
- package/dist/audio/sound-file-factory.js +225 -0
- package/dist/audio/sound-file-reader.d.ts +191 -0
- package/dist/audio/sound-file-reader.js +132 -0
- package/dist/audio/sound-file-writer.d.ts +59 -0
- package/dist/audio/sound-file-writer.js +20 -0
- package/dist/audio/sound-recorder.d.ts +184 -0
- package/dist/audio/sound-recorder.js +286 -0
- package/dist/audio/sound-source.d.ts +336 -0
- package/dist/audio/sound-source.js +389 -0
- package/dist/audio/sound-stream.d.ts +76 -0
- package/dist/audio/sound-stream.js +83 -0
- package/dist/audio/sound.d.ts +41 -0
- package/dist/audio/sound.js +66 -0
- package/dist/audio/value.d.ts +359 -0
- package/dist/audio/value.js +353 -0
- package/dist/audio/worker.d.ts +306 -0
- package/dist/audio/worker.js +2 -0
- package/dist/graphics/blend-mode.d.ts +248 -0
- package/dist/graphics/blend-mode.js +234 -0
- package/dist/graphics/boolean-vector.d.ts +134 -0
- package/dist/graphics/boolean-vector.js +202 -0
- package/dist/graphics/circle-shape.d.ts +84 -0
- package/dist/graphics/circle-shape.js +72 -0
- package/dist/graphics/color.d.ts +278 -0
- package/dist/graphics/color.js +291 -0
- package/dist/graphics/convex-shape.d.ts +56 -0
- package/dist/graphics/convex-shape.js +59 -0
- package/dist/graphics/drawable.d.ts +22 -0
- package/dist/graphics/drawable.js +20 -0
- package/dist/graphics/font.d.ts +199 -0
- package/dist/graphics/font.js +319 -0
- package/dist/graphics/glsl-matrix.d.ts +62 -0
- package/dist/graphics/glsl-matrix.js +106 -0
- package/dist/graphics/glsl.d.ts +165 -0
- package/dist/graphics/glsl.js +215 -0
- package/dist/graphics/glyph.d.ts +133 -0
- package/dist/graphics/glyph.js +138 -0
- package/dist/graphics/image.d.ts +192 -0
- package/dist/graphics/image.js +285 -0
- package/dist/graphics/primitive-type.d.ts +51 -0
- package/dist/graphics/primitive-type.js +60 -0
- package/dist/graphics/rect.d.ts +203 -0
- package/dist/graphics/rect.js +249 -0
- package/dist/graphics/rectangle-shape.d.ts +55 -0
- package/dist/graphics/rectangle-shape.js +60 -0
- package/dist/graphics/render-states.d.ts +188 -0
- package/dist/graphics/render-states.js +115 -0
- package/dist/graphics/render-target.d.ts +222 -0
- package/dist/graphics/render-target.js +434 -0
- package/dist/graphics/render-texture.d.ts +130 -0
- package/dist/graphics/render-texture.js +187 -0
- package/dist/graphics/render-window.d.ts +138 -0
- package/dist/graphics/render-window.js +154 -0
- package/dist/graphics/shader.d.ts +192 -0
- package/dist/graphics/shader.js +321 -0
- package/dist/graphics/shape.d.ts +189 -0
- package/dist/graphics/shape.js +277 -0
- package/dist/graphics/sprite.d.ts +104 -0
- package/dist/graphics/sprite.js +164 -0
- package/dist/graphics/stencil-mode.d.ts +230 -0
- package/dist/graphics/stencil-mode.js +173 -0
- package/dist/graphics/swap.d.ts +17 -0
- package/dist/graphics/swap.js +16 -0
- package/dist/graphics/text.d.ts +759 -0
- package/dist/graphics/text.js +724 -0
- package/dist/graphics/texture.d.ts +255 -0
- package/dist/graphics/texture.js +390 -0
- package/dist/graphics/transform.d.ts +129 -0
- package/dist/graphics/transform.js +274 -0
- package/dist/graphics/transformable.d.ts +24 -0
- package/dist/graphics/transformable.js +38 -0
- package/dist/graphics/vertex-array.d.ts +123 -0
- package/dist/graphics/vertex-array.js +234 -0
- package/dist/graphics/vertex-buffer.d.ts +205 -0
- package/dist/graphics/vertex-buffer.js +256 -0
- package/dist/graphics/vertex.d.ts +111 -0
- package/dist/graphics/vertex.js +134 -0
- package/dist/graphics/view.d.ts +172 -0
- package/dist/graphics/view.js +296 -0
- package/dist/index.d.ts +116 -0
- package/dist/index.js +251 -0
- package/dist/internal/audio-codec-registry.d.ts +13 -0
- package/dist/internal/audio-codec-registry.js +64 -0
- package/dist/internal/audio-input-stream.d.ts +13 -0
- package/dist/internal/audio-input-stream.js +44 -0
- package/dist/internal/audio-music-pump.d.ts +63 -0
- package/dist/internal/audio-music-pump.js +193 -0
- package/dist/internal/audio-native.d.ts +145 -0
- package/dist/internal/audio-native.js +24 -0
- package/dist/internal/audio-recorder-session.d.ts +77 -0
- package/dist/internal/audio-recorder-session.js +182 -0
- package/dist/internal/audio-worker-session.d.ts +18 -0
- package/dist/internal/audio-worker-session.js +82 -0
- package/dist/internal/audio-worker.d.ts +1 -0
- package/dist/internal/audio-worker.js +134 -0
- package/dist/internal/glsl-value.d.ts +51 -0
- package/dist/internal/glsl-value.js +69 -0
- package/dist/internal/graphics-state.d.ts +45 -0
- package/dist/internal/graphics-state.js +123 -0
- package/dist/internal/input-stream.d.ts +4 -0
- package/dist/internal/input-stream.js +25 -0
- package/dist/internal/lazy-value.d.ts +17 -0
- package/dist/internal/lazy-value.js +43 -0
- package/dist/internal/native.d.ts +317 -0
- package/dist/internal/native.js +8 -0
- package/dist/internal/numeric-properties.d.ts +2 -0
- package/dist/internal/numeric-properties.js +39 -0
- package/dist/internal/render-states.d.ts +4 -0
- package/dist/internal/render-states.js +44 -0
- package/dist/internal/scalar.d.ts +52 -0
- package/dist/internal/scalar.js +95 -0
- package/dist/internal/shaped-glyph.d.ts +32 -0
- package/dist/internal/shaped-glyph.js +51 -0
- package/dist/internal/struct-view.d.ts +11 -0
- package/dist/internal/struct-view.js +39 -0
- package/dist/internal/text-indices.d.ts +7 -0
- package/dist/internal/text-indices.js +22 -0
- package/dist/internal/transformable.d.ts +124 -0
- package/dist/internal/transformable.js +121 -0
- package/dist/internal/value-storage.d.ts +33 -0
- package/dist/internal/value-storage.js +21 -0
- package/dist/network/common.d.ts +23 -0
- package/dist/network/common.js +78 -0
- package/dist/network/dns.d.ts +124 -0
- package/dist/network/dns.js +142 -0
- package/dist/network/ftp.d.ts +265 -0
- package/dist/network/ftp.js +417 -0
- package/dist/network/gen/constants.d.ts +878 -0
- package/dist/network/gen/constants.js +886 -0
- package/dist/network/http.d.ts +458 -0
- package/dist/network/http.js +732 -0
- package/dist/network/ip-address.d.ts +210 -0
- package/dist/network/ip-address.js +301 -0
- package/dist/network/packet.d.ts +249 -0
- package/dist/network/packet.js +326 -0
- package/dist/network/sftp.d.ts +661 -0
- package/dist/network/sftp.js +826 -0
- package/dist/network/socket-selector.d.ts +132 -0
- package/dist/network/socket-selector.js +214 -0
- package/dist/network/socket.d.ts +301 -0
- package/dist/network/socket.js +402 -0
- package/dist/network/tcp-listener.d.ts +114 -0
- package/dist/network/tcp-listener.js +199 -0
- package/dist/network/tcp-socket.d.ts +307 -0
- package/dist/network/tcp-socket.js +493 -0
- package/dist/network/tls-material.d.ts +22 -0
- package/dist/network/tls-material.js +52 -0
- package/dist/network/udp-socket.d.ts +178 -0
- package/dist/network/udp-socket.js +285 -0
- package/dist/system/angle.d.ts +77 -0
- package/dist/system/angle.js +122 -0
- package/dist/system/clock.d.ts +65 -0
- package/dist/system/clock.js +99 -0
- package/dist/system/err.d.ts +18 -0
- package/dist/system/err.js +61 -0
- package/dist/system/error.d.ts +15 -0
- package/dist/system/error.js +22 -0
- package/dist/system/file-input-stream.d.ts +68 -0
- package/dist/system/file-input-stream.js +148 -0
- package/dist/system/input-stream.d.ts +114 -0
- package/dist/system/input-stream.js +106 -0
- package/dist/system/operators.d.ts +291 -0
- package/dist/system/operators.js +505 -0
- package/dist/system/sleep.d.ts +9 -0
- package/dist/system/sleep.js +28 -0
- package/dist/system/suspend-aware-clock.d.ts +22 -0
- package/dist/system/suspend-aware-clock.js +29 -0
- package/dist/system/time.d.ts +100 -0
- package/dist/system/time.js +188 -0
- package/dist/system/timeout-with-predicate.d.ts +60 -0
- package/dist/system/timeout-with-predicate.js +52 -0
- package/dist/system/unicode.d.ts +54 -0
- package/dist/system/unicode.js +67 -0
- package/dist/system/vector2.d.ts +302 -0
- package/dist/system/vector2.js +314 -0
- package/dist/system/vector3.d.ts +249 -0
- package/dist/system/vector3.js +266 -0
- package/dist/system/version.d.ts +51 -0
- package/dist/system/version.js +24 -0
- package/dist/window/clipboard.d.ts +14 -0
- package/dist/window/clipboard.js +26 -0
- package/dist/window/context-settings.d.ts +94 -0
- package/dist/window/context-settings.js +84 -0
- package/dist/window/context.d.ts +87 -0
- package/dist/window/context.js +122 -0
- package/dist/window/cursor.d.ts +58 -0
- package/dist/window/cursor.js +80 -0
- package/dist/window/event.d.ts +529 -0
- package/dist/window/event.js +87 -0
- package/dist/window/gen/constants.d.ts +2213 -0
- package/dist/window/gen/constants.js +2227 -0
- package/dist/window/joystick.d.ts +81 -0
- package/dist/window/joystick.js +80 -0
- package/dist/window/keyboard.d.ts +50 -0
- package/dist/window/keyboard.js +59 -0
- package/dist/window/mouse.d.ts +31 -0
- package/dist/window/mouse.js +57 -0
- package/dist/window/sensor.d.ts +26 -0
- package/dist/window/sensor.js +40 -0
- package/dist/window/touch.d.ts +27 -0
- package/dist/window/touch.js +44 -0
- package/dist/window/video-mode.d.ts +77 -0
- package/dist/window/video-mode.js +99 -0
- package/dist/window/vulkan.d.ts +32 -0
- package/dist/window/vulkan.js +45 -0
- package/dist/window/window.d.ts +355 -0
- package/dist/window/window.js +434 -0
- package/docs/README.ja.md +30 -0
- package/docs/README.ko.md +30 -0
- package/docs/README.md +30 -0
- package/docs/README.zh-CN.md +30 -0
- package/docs/api.ja.md +84 -0
- package/docs/api.ko.md +84 -0
- package/docs/api.md +81 -0
- package/docs/api.zh-CN.md +81 -0
- package/docs/audio.ja.md +249 -0
- package/docs/audio.ko.md +251 -0
- package/docs/audio.md +252 -0
- package/docs/audio.zh-CN.md +252 -0
- package/docs/concepts.ja.md +130 -0
- package/docs/concepts.ko.md +130 -0
- package/docs/concepts.md +131 -0
- package/docs/concepts.zh-CN.md +131 -0
- package/docs/development.ja.md +148 -0
- package/docs/development.ko.md +148 -0
- package/docs/development.md +150 -0
- package/docs/development.zh-CN.md +150 -0
- package/docs/getting-started.ja.md +154 -0
- package/docs/getting-started.ko.md +154 -0
- package/docs/getting-started.md +156 -0
- package/docs/getting-started.zh-CN.md +156 -0
- package/docs/graphics.ja.md +256 -0
- package/docs/graphics.ko.md +254 -0
- package/docs/graphics.md +255 -0
- package/docs/graphics.zh-CN.md +257 -0
- package/docs/network.ja.md +214 -0
- package/docs/network.ko.md +216 -0
- package/docs/network.md +218 -0
- package/docs/network.zh-CN.md +218 -0
- package/docs/system.ja.md +169 -0
- package/docs/system.ko.md +171 -0
- package/docs/system.md +173 -0
- package/docs/system.zh-CN.md +173 -0
- package/docs/window.ja.md +138 -0
- package/docs/window.ko.md +140 -0
- package/docs/window.md +141 -0
- package/docs/window.zh-CN.md +141 -0
- package/native/addon.cc +129 -0
- package/native/audio-binding.cc +543 -0
- package/native/audio-codec-binding.cc +246 -0
- package/native/audio-device-binding.cc +160 -0
- package/native/audio-file-binding.cc +192 -0
- package/native/audio-recorder-binding.cc +237 -0
- package/native/audio-recorder.h +39 -0
- package/native/audio-state.h +220 -0
- package/native/audio-stream-binding.cc +284 -0
- package/native/audio-stream.h +28 -0
- package/native/audio-worker-binding.cc +447 -0
- package/native/audio-worker.h +121 -0
- package/native/batch-drawable.cc +189 -0
- package/native/batch-drawable.h +57 -0
- package/native/context-binding.cc +180 -0
- package/native/context-settings.h +74 -0
- package/native/deferred-delete.cc +49 -0
- package/native/deferred-delete.h +84 -0
- package/native/error-stream-binding.cc +270 -0
- package/native/exception-boundary.h +97 -0
- package/native/font-binding.cc +210 -0
- package/native/font-state.h +27 -0
- package/native/graphics-binding.cc +338 -0
- package/native/graphics-state.h +253 -0
- package/native/image-binding.cc +258 -0
- package/native/image-state.h +93 -0
- package/native/input-binding.cc +246 -0
- package/native/numeric-fields.h +96 -0
- package/native/render-window-binding.cc +103 -0
- package/native/render-window-state.h +22 -0
- package/native/shader-binding.cc +292 -0
- package/native/shape-binding.cc +283 -0
- package/native/shape-state.h +68 -0
- package/native/shaped-glyph-storage.h +45 -0
- package/native/shared-handle.h +69 -0
- package/native/stream-binding.cc +286 -0
- package/native/system-binding.cc +91 -0
- package/native/text-binding.cc +205 -0
- package/native/text-state.h +101 -0
- package/native/texture-binding.cc +330 -0
- package/native/texture-resource.h +52 -0
- package/native/time-value.h +28 -0
- package/native/transformable-binding.cc +23 -0
- package/native/transformable-state.h +44 -0
- package/native/value-binding.h +200 -0
- package/native/value-layout.h +116 -0
- package/native/values-binding.cc +27 -0
- package/native/vertex-binding.cc +50 -0
- package/native/vertex-buffer-binding.cc +232 -0
- package/native/vertex-storage.h +20 -0
- package/native/view-data.h +24 -0
- package/native/window-binding.cc +388 -0
- package/native/window-event.h +92 -0
- package/native/window-owner.h +81 -0
- package/package.json +87 -35
- package/src/audio/effect-processor.ts +86 -0
- package/src/audio/input-sound-file.ts +259 -0
- package/src/audio/listener.ts +136 -0
- package/src/audio/music.ts +357 -0
- package/src/audio/output-sound-file.ts +96 -0
- package/src/audio/playback-device.ts +145 -0
- package/src/audio/sound-buffer-recorder.ts +141 -0
- package/src/audio/sound-buffer.ts +275 -0
- package/src/audio/sound-file-factory.ts +235 -0
- package/src/audio/sound-file-reader.ts +224 -0
- package/src/audio/sound-file-writer.ts +61 -0
- package/src/audio/sound-recorder.ts +315 -0
- package/src/audio/sound-source.ts +396 -0
- package/src/audio/sound-stream.ts +108 -0
- package/src/audio/sound.ts +63 -0
- package/src/audio/value.ts +408 -0
- package/src/audio/worker.ts +308 -0
- package/src/graphics/blend-mode.ts +291 -0
- package/src/graphics/boolean-vector.ts +225 -0
- package/src/graphics/circle-shape.ts +113 -0
- package/src/graphics/color.ts +374 -0
- package/src/graphics/convex-shape.ts +76 -0
- package/src/graphics/drawable.ts +32 -0
- package/src/graphics/font.ts +377 -0
- package/src/graphics/glsl-matrix.ts +110 -0
- package/src/graphics/glsl.ts +229 -0
- package/src/graphics/glyph.ts +186 -0
- package/src/graphics/image.ts +366 -0
- package/src/graphics/primitive-type.ts +56 -0
- package/src/graphics/rect.ts +350 -0
- package/src/graphics/rectangle-shape.ts +76 -0
- package/src/graphics/render-states.ts +238 -0
- package/src/graphics/render-target.ts +554 -0
- package/src/graphics/render-texture.ts +234 -0
- package/src/graphics/render-window.ts +250 -0
- package/src/graphics/shader.ts +353 -0
- package/src/graphics/shape.ts +343 -0
- package/src/graphics/sprite.ts +203 -0
- package/src/graphics/stencil-mode.ts +258 -0
- package/src/graphics/swap.ts +28 -0
- package/src/graphics/text.ts +944 -0
- package/src/graphics/texture.ts +529 -0
- package/src/graphics/transform.ts +321 -0
- package/src/graphics/transformable.ts +37 -0
- package/src/graphics/vertex-array.ts +270 -0
- package/src/graphics/vertex-buffer.ts +345 -0
- package/src/graphics/vertex.ts +211 -0
- package/src/graphics/view.ts +355 -0
- package/src/index.ts +147 -0
- package/src/internal/audio-codec-registry.ts +68 -0
- package/src/internal/audio-input-stream.ts +42 -0
- package/src/internal/audio-music-pump.ts +199 -0
- package/src/internal/audio-native.ts +176 -0
- package/src/internal/audio-recorder-session.ts +234 -0
- package/src/internal/audio-worker-session.ts +89 -0
- package/src/internal/audio-worker.ts +146 -0
- package/src/internal/glsl-value.ts +79 -0
- package/src/internal/graphics-state.ts +131 -0
- package/src/internal/input-stream.ts +30 -0
- package/src/internal/lazy-value.ts +62 -0
- package/src/internal/native.ts +581 -0
- package/src/internal/numeric-properties.ts +37 -0
- package/src/internal/render-states.ts +42 -0
- package/src/internal/scalar.ts +117 -0
- package/src/internal/shaped-glyph.ts +68 -0
- package/src/internal/struct-view.ts +49 -0
- package/src/internal/text-indices.ts +19 -0
- package/src/internal/transformable.ts +260 -0
- package/src/internal/value-storage.ts +40 -0
- package/src/network/common.ts +58 -0
- package/src/network/dns.ts +191 -0
- package/src/network/ftp.ts +386 -0
- package/src/network/gen/constants.ts +879 -0
- package/src/network/http.ts +680 -0
- package/src/network/ip-address.ts +311 -0
- package/src/network/packet.ts +388 -0
- package/src/network/sftp.ts +1015 -0
- package/src/network/socket-selector.ts +206 -0
- package/src/network/socket.ts +415 -0
- package/src/network/tcp-listener.ts +193 -0
- package/src/network/tcp-socket.ts +569 -0
- package/src/network/tls-material.ts +46 -0
- package/src/network/udp-socket.ts +294 -0
- package/src/system/angle.ts +132 -0
- package/src/system/clock.ts +104 -0
- package/src/system/err.ts +58 -0
- package/src/system/error.ts +18 -0
- package/src/system/file-input-stream.ts +147 -0
- package/src/system/input-stream.ts +150 -0
- package/src/system/operators.ts +681 -0
- package/src/system/sleep.ts +25 -0
- package/src/system/suspend-aware-clock.ts +27 -0
- package/src/system/time.ts +218 -0
- package/src/system/timeout-with-predicate.ts +94 -0
- package/src/system/unicode.ts +64 -0
- package/src/system/vector2.ts +549 -0
- package/src/system/vector3.ts +433 -0
- package/src/system/version.ts +66 -0
- package/src/window/clipboard.ts +22 -0
- package/src/window/context-settings.ts +143 -0
- package/src/window/context.ts +152 -0
- package/src/window/cursor.ts +116 -0
- package/src/window/event.ts +580 -0
- package/src/window/gen/constants.ts +2231 -0
- package/src/window/joystick.ts +108 -0
- package/src/window/keyboard.ts +78 -0
- package/src/window/mouse.ts +58 -0
- package/src/window/sensor.ts +37 -0
- package/src/window/touch.ts +42 -0
- package/src/window/video-mode.ts +136 -0
- package/src/window/vulkan.ts +42 -0
- package/src/window/window.ts +579 -0
- package/test/native/audio-probes.cc +181 -0
- package/test/native/deferred-delete-probes.cc +62 -0
- package/test/native/drawable-probes.cc +168 -0
- package/test/native/exception-probes.cc +83 -0
- package/test/native/image-probes.cc +105 -0
- package/test/native/matrix-probes.cc +67 -0
- package/test/native/network-oracle.cc +32 -0
- package/test/native/render-texture-probes.cc +193 -0
- package/test/native/shader-probes.cc +69 -0
- package/test/native/shape-probes.cc +160 -0
- package/test/native/sprite-probes.cc +146 -0
- package/test/native/system-probes.cc +109 -0
- package/test/native/text-probes.cc +211 -0
- package/test/native/texture-probes.cc +200 -0
- package/test/native/time-probes.cc +143 -0
- package/test/native/transform-probes.cc +92 -0
- package/test/native/transformable-probes.cc +152 -0
- package/test/native/value-oracle.h +88 -0
- package/test/native/value-probes.cc +379 -0
- package/test/native/vertex-array-probes.cc +82 -0
- package/test/native/vertex-buffer-probes.cc +87 -0
- package/test/native/view-probes.cc +150 -0
- package/test/native/window-probes.cc +172 -0
- package/test/tsconfig.json +8 -0
- package/tools/configure-lsp.cjs +23 -0
- package/tools/constant-docs.cjs +109 -0
- package/tools/constant-docs.json +1318 -0
- package/tools/generate-network-constants.cjs +59 -0
- package/tools/generate-window-constants.cjs +178 -0
- package/tools/lib_downloader.cjs +92 -0
- package/tools/lib_downloader_urls.cjs +23 -0
- package/tsconfig.json +11 -4
- package/index.d.ts +0 -1
- package/lib/clock.d.ts +0 -8
- package/lib/clock.js +0 -5
- package/lib/color.d.ts +0 -11
- package/lib/color.js +0 -98
- package/lib/common.js +0 -47
- package/lib/drawable/circle_shape.d.ts +0 -5
- package/lib/drawable/circle_shape.js +0 -26
- package/lib/drawable/convex_shape.d.ts +0 -5
- package/lib/drawable/convex_shape.js +0 -35
- package/lib/drawable/drawable.d.ts +0 -6
- package/lib/drawable/drawable.js +0 -18
- package/lib/drawable/plugin_package.d.ts +0 -31
- package/lib/drawable/plugin_package.js +0 -102
- package/lib/drawable/rectangle_shape.d.ts +0 -9
- package/lib/drawable/rectangle_shape.js +0 -28
- package/lib/drawable/shape.d.ts +0 -14
- package/lib/drawable/shape.js +0 -30
- package/lib/drawable/sprite.d.ts +0 -17
- package/lib/drawable/sprite.js +0 -53
- package/lib/drawable/text.d.ts +0 -26
- package/lib/drawable/text.js +0 -88
- package/lib/drawable/transformable.d.ts +0 -28
- package/lib/drawable/transformable.js +0 -113
- package/lib/drawable/vertex_array.d.ts +0 -40
- package/lib/drawable/vertex_array.js +0 -128
- package/lib/font.d.ts +0 -24
- package/lib/font.js +0 -137
- package/lib/image.d.ts +0 -26
- package/lib/image.js +0 -147
- package/lib/joystick.d.ts +0 -21
- package/lib/joystick.js +0 -72
- package/lib/keyboard.d.ts +0 -113
- package/lib/keyboard.js +0 -17
- package/lib/mouse.d.ts +0 -6
- package/lib/mouse.js +0 -39
- package/lib/poll_event.d.ts +0 -138
- package/lib/rect.d.ts +0 -18
- package/lib/rect.js +0 -119
- package/lib/render_window.d.ts +0 -67
- package/lib/render_window.js +0 -197
- package/lib/sensor.d.ts +0 -12
- package/lib/sensor.js +0 -34
- package/lib/sfml.d.ts +0 -32
- package/lib/sfml.js +0 -36
- package/lib/sound/base.d.ts +0 -33
- package/lib/sound/base.js +0 -109
- package/lib/sound/music.d.ts +0 -15
- package/lib/sound/music.js +0 -65
- package/lib/sound/sound.d.ts +0 -16
- package/lib/sound/sound.js +0 -55
- package/lib/sound/sound_buffer.d.ts +0 -14
- package/lib/sound/sound_buffer.js +0 -78
- package/lib/texture.d.ts +0 -21
- package/lib/texture.js +0 -127
- package/lib/time.d.ts +0 -13
- package/lib/time.js +0 -41
- package/lib/touch.d.ts +0 -7
- package/lib/touch.js +0 -34
- package/lib/vector2.d.ts +0 -49
- package/lib/vector2.js +0 -141
- package/lib/vector3.d.ts +0 -47
- package/lib/vector3.js +0 -154
- package/lib/vertex.d.ts +0 -14
- package/lib/vertex.js +0 -177
- package/lib/video_mode.d.ts +0 -12
- package/lib/video_mode.js +0 -99
- package/src/base_class_with_loading.h +0 -21
- package/src/clock.cc +0 -71
- package/src/clock.h +0 -30
- package/src/color.cc +0 -189
- package/src/color.h +0 -49
- package/src/drawable/circle_shape.cc +0 -78
- package/src/drawable/circle_shape.h +0 -28
- package/src/drawable/convex_shape.cc +0 -57
- package/src/drawable/convex_shape.h +0 -29
- package/src/drawable/drawable-inl.h +0 -29
- package/src/drawable/drawable.cc +0 -41
- package/src/drawable/drawable.h +0 -49
- package/src/drawable/package_plugin-inl.h +0 -191
- package/src/drawable/package_plugin.h +0 -60
- package/src/drawable/rectangle_shape.cc +0 -69
- package/src/drawable/rectangle_shape.h +0 -29
- package/src/drawable/shape.cc +0 -67
- package/src/drawable/shape.h +0 -39
- package/src/drawable/sprite.cc +0 -122
- package/src/drawable/sprite.h +0 -45
- package/src/drawable/text.cc +0 -133
- package/src/drawable/text.h +0 -54
- package/src/drawable/vertex_array.cc +0 -248
- package/src/drawable/vertex_array.h +0 -46
- package/src/font.cc +0 -214
- package/src/font.h +0 -44
- package/src/gen/.gitkeep +0 -0
- package/src/gen/joystick_axis.cc +0 -30
- package/src/gen/keycode.cc +0 -226
- package/src/gen/mouse_button.cc +0 -30
- package/src/gen/sensor_type.cc +0 -26
- package/src/image.cc +0 -379
- package/src/image.h +0 -72
- package/src/joystick.cc +0 -132
- package/src/joystick.h +0 -32
- package/src/keyboard.cc +0 -65
- package/src/keyboard.h +0 -27
- package/src/mouse.cc +0 -95
- package/src/mouse.h +0 -30
- package/src/plugins/transformable_plugin-inl.h +0 -121
- package/src/plugins/transformable_plugin.h +0 -42
- package/src/poll_event.cc +0 -326
- package/src/poll_event.h +0 -18
- package/src/rect-inl.h +0 -154
- package/src/rect.cc +0 -28
- package/src/rect.h +0 -105
- package/src/render_window.cc +0 -413
- package/src/render_window.h +0 -111
- package/src/render_window_async_display.cc +0 -49
- package/src/render_window_async_draw.cc +0 -56
- package/src/resizable_buffer.h +0 -104
- package/src/sensor.cc +0 -82
- package/src/sensor.h +0 -28
- package/src/sfml.cc +0 -85
- package/src/sound/music.cc +0 -113
- package/src/sound/music.h +0 -35
- package/src/sound/sound.cc +0 -116
- package/src/sound/sound.h +0 -41
- package/src/sound/sound_buffer.cc +0 -226
- package/src/sound/sound_buffer.h +0 -46
- package/src/sound/sound_source.cc +0 -124
- package/src/sound/sound_source.h +0 -80
- package/src/texture.cc +0 -246
- package/src/texture.h +0 -47
- package/src/time.cc +0 -177
- package/src/time.h +0 -42
- package/src/touch.cc +0 -54
- package/src/touch.h +0 -23
- package/src/utils-inl.h +0 -48
- package/src/utils.h +0 -21
- package/src/vector2-inl.h +0 -198
- package/src/vector2.cc +0 -36
- package/src/vector2.h +0 -133
- package/src/vector3-inl.h +0 -200
- package/src/vector3.cc +0 -36
- package/src/vector3.h +0 -134
- package/src/vertex.cc +0 -238
- package/src/vertex.h +0 -114
- package/src/video_mode.cc +0 -184
- package/src/video_mode.h +0 -38
- package/src/workers/load_from_file_worker.h +0 -79
- package/src/workers/save_to_file_worker.h +0 -79
- package/third_party/sfml/include/SFML/Audio/AlResource.hpp +0 -70
- package/third_party/sfml/include/SFML/Audio/Export.hpp +0 -48
- package/third_party/sfml/include/SFML/Audio/InputSoundFile.hpp +0 -268
- package/third_party/sfml/include/SFML/Audio/Listener.hpp +0 -234
- package/third_party/sfml/include/SFML/Audio/Music.hpp +0 -337
- package/third_party/sfml/include/SFML/Audio/OutputSoundFile.hpp +0 -133
- package/third_party/sfml/include/SFML/Audio/Sound.hpp +0 -264
- package/third_party/sfml/include/SFML/Audio/SoundBuffer.hpp +0 -352
- package/third_party/sfml/include/SFML/Audio/SoundBufferRecorder.hpp +0 -144
- package/third_party/sfml/include/SFML/Audio/SoundFileFactory.hpp +0 -197
- package/third_party/sfml/include/SFML/Audio/SoundFileFactory.inl +0 -100
- package/third_party/sfml/include/SFML/Audio/SoundFileReader.hpp +0 -165
- package/third_party/sfml/include/SFML/Audio/SoundFileWriter.hpp +0 -125
- package/third_party/sfml/include/SFML/Audio/SoundRecorder.hpp +0 -410
- package/third_party/sfml/include/SFML/Audio/SoundSource.hpp +0 -332
- package/third_party/sfml/include/SFML/Audio/SoundStream.hpp +0 -420
- package/third_party/sfml/include/SFML/Audio.hpp +0 -56
- package/third_party/sfml/include/SFML/Config.hpp +0 -248
- package/third_party/sfml/include/SFML/GpuPreference.hpp +0 -74
- package/third_party/sfml/include/SFML/Graphics/BlendMode.hpp +0 -219
- package/third_party/sfml/include/SFML/Graphics/CircleShape.hpp +0 -154
- package/third_party/sfml/include/SFML/Graphics/Color.hpp +0 -275
- package/third_party/sfml/include/SFML/Graphics/ConvexShape.hpp +0 -153
- package/third_party/sfml/include/SFML/Graphics/Drawable.hpp +0 -126
- package/third_party/sfml/include/SFML/Graphics/Export.hpp +0 -48
- package/third_party/sfml/include/SFML/Graphics/Font.hpp +0 -496
- package/third_party/sfml/include/SFML/Graphics/Glsl.hpp +0 -227
- package/third_party/sfml/include/SFML/Graphics/Glsl.inl +0 -155
- package/third_party/sfml/include/SFML/Graphics/Glyph.hpp +0 -81
- package/third_party/sfml/include/SFML/Graphics/Image.hpp +0 -346
- package/third_party/sfml/include/SFML/Graphics/PrimitiveType.hpp +0 -58
- package/third_party/sfml/include/SFML/Graphics/Rect.hpp +0 -274
- package/third_party/sfml/include/SFML/Graphics/Rect.inl +0 -171
- package/third_party/sfml/include/SFML/Graphics/RectangleShape.hpp +0 -132
- package/third_party/sfml/include/SFML/Graphics/RenderStates.hpp +0 -174
- package/third_party/sfml/include/SFML/Graphics/RenderTarget.hpp +0 -518
- package/third_party/sfml/include/SFML/Graphics/RenderTexture.hpp +0 -334
- package/third_party/sfml/include/SFML/Graphics/RenderWindow.hpp +0 -302
- package/third_party/sfml/include/SFML/Graphics/Shader.hpp +0 -875
- package/third_party/sfml/include/SFML/Graphics/Shape.hpp +0 -355
- package/third_party/sfml/include/SFML/Graphics/Sprite.hpp +0 -279
- package/third_party/sfml/include/SFML/Graphics/Text.hpp +0 -513
- package/third_party/sfml/include/SFML/Graphics/Texture.hpp +0 -733
- package/third_party/sfml/include/SFML/Graphics/Transform.hpp +0 -497
- package/third_party/sfml/include/SFML/Graphics/Transformable.hpp +0 -429
- package/third_party/sfml/include/SFML/Graphics/Vertex.hpp +0 -148
- package/third_party/sfml/include/SFML/Graphics/VertexArray.hpp +0 -223
- package/third_party/sfml/include/SFML/Graphics/VertexBuffer.hpp +0 -408
- package/third_party/sfml/include/SFML/Graphics/View.hpp +0 -343
- package/third_party/sfml/include/SFML/Graphics.hpp +0 -68
- package/third_party/sfml/include/SFML/Main.hpp +0 -43
- package/third_party/sfml/include/SFML/Network/Export.hpp +0 -48
- package/third_party/sfml/include/SFML/Network/Ftp.hpp +0 -616
- package/third_party/sfml/include/SFML/Network/Http.hpp +0 -482
- package/third_party/sfml/include/SFML/Network/IpAddress.hpp +0 -328
- package/third_party/sfml/include/SFML/Network/Packet.hpp +0 -545
- package/third_party/sfml/include/SFML/Network/Socket.hpp +0 -219
- package/third_party/sfml/include/SFML/Network/SocketHandle.hpp +0 -57
- package/third_party/sfml/include/SFML/Network/SocketSelector.hpp +0 -263
- package/third_party/sfml/include/SFML/Network/TcpListener.hpp +0 -170
- package/third_party/sfml/include/SFML/Network/TcpSocket.hpp +0 -316
- package/third_party/sfml/include/SFML/Network/UdpSocket.hpp +0 -292
- package/third_party/sfml/include/SFML/Network.hpp +0 -53
- package/third_party/sfml/include/SFML/OpenGL.hpp +0 -78
- package/third_party/sfml/include/SFML/System/Clock.hpp +0 -117
- package/third_party/sfml/include/SFML/System/Err.hpp +0 -80
- package/third_party/sfml/include/SFML/System/Export.hpp +0 -48
- package/third_party/sfml/include/SFML/System/FileInputStream.hpp +0 -169
- package/third_party/sfml/include/SFML/System/InputStream.hpp +0 -152
- package/third_party/sfml/include/SFML/System/Lock.hpp +0 -139
- package/third_party/sfml/include/SFML/System/MemoryInputStream.hpp +0 -148
- package/third_party/sfml/include/SFML/System/Mutex.hpp +0 -148
- package/third_party/sfml/include/SFML/System/NativeActivity.hpp +0 -62
- package/third_party/sfml/include/SFML/System/NonCopyable.hpp +0 -129
- package/third_party/sfml/include/SFML/System/Sleep.hpp +0 -52
- package/third_party/sfml/include/SFML/System/String.hpp +0 -669
- package/third_party/sfml/include/SFML/System/String.inl +0 -53
- package/third_party/sfml/include/SFML/System/Thread.hpp +0 -282
- package/third_party/sfml/include/SFML/System/Thread.inl +0 -90
- package/third_party/sfml/include/SFML/System/ThreadLocal.hpp +0 -103
- package/third_party/sfml/include/SFML/System/ThreadLocalPtr.hpp +0 -158
- package/third_party/sfml/include/SFML/System/ThreadLocalPtr.inl +0 -77
- package/third_party/sfml/include/SFML/System/Time.hpp +0 -488
- package/third_party/sfml/include/SFML/System/Utf.hpp +0 -763
- package/third_party/sfml/include/SFML/System/Utf.inl +0 -752
- package/third_party/sfml/include/SFML/System/Vector2.hpp +0 -301
- package/third_party/sfml/include/SFML/System/Vector2.inl +0 -161
- package/third_party/sfml/include/SFML/System/Vector3.hpp +0 -302
- package/third_party/sfml/include/SFML/System/Vector3.inl +0 -168
- package/third_party/sfml/include/SFML/System.hpp +0 -60
- package/third_party/sfml/include/SFML/Window/Clipboard.hpp +0 -119
- package/third_party/sfml/include/SFML/Window/Context.hpp +0 -195
- package/third_party/sfml/include/SFML/Window/ContextSettings.hpp +0 -149
- package/third_party/sfml/include/SFML/Window/Cursor.hpp +0 -241
- package/third_party/sfml/include/SFML/Window/Event.hpp +0 -285
- package/third_party/sfml/include/SFML/Window/Export.hpp +0 -48
- package/third_party/sfml/include/SFML/Window/GlResource.hpp +0 -109
- package/third_party/sfml/include/SFML/Window/Joystick.hpp +0 -227
- package/third_party/sfml/include/SFML/Window/Keyboard.hpp +0 -491
- package/third_party/sfml/include/SFML/Window/Mouse.hpp +0 -180
- package/third_party/sfml/include/SFML/Window/Sensor.hpp +0 -150
- package/third_party/sfml/include/SFML/Window/Touch.hpp +0 -137
- package/third_party/sfml/include/SFML/Window/VideoMode.hpp +0 -228
- package/third_party/sfml/include/SFML/Window/Vulkan.hpp +0 -115
- package/third_party/sfml/include/SFML/Window/Window.hpp +0 -354
- package/third_party/sfml/include/SFML/Window/WindowBase.hpp +0 -518
- package/third_party/sfml/include/SFML/Window/WindowHandle.hpp +0 -101
- package/third_party/sfml/include/SFML/Window/WindowStyle.hpp +0 -53
- package/third_party/sfml/include/SFML/Window.hpp +0 -58
- package/tools/clang_format.js +0 -9
- package/tools/copier/linux.js +0 -21
- package/tools/copier/macos.js +0 -34
- package/tools/copier/windows.js +0 -33
- package/tools/joystick_axis.js +0 -63
- package/tools/keycode.js +0 -92
- package/tools/lib_downloader.js +0 -107
- package/tools/lib_downloader_urls.js +0 -59
- package/tools/mouse_button.js +0 -92
- package/tools/sensor_type.js +0 -63
|
@@ -0,0 +1,569 @@
|
|
|
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
|
+
/**
|
|
13
|
+
* Current TLS upgrade state.
|
|
14
|
+
* @zh TLS 升级的当前状态。
|
|
15
|
+
* @ja TLS アップグレードの現在の状態。
|
|
16
|
+
* @ko TLS 업그레이드의 현재 상태.
|
|
17
|
+
*/
|
|
18
|
+
export enum TlsStatus {
|
|
19
|
+
/**
|
|
20
|
+
* No TLS connection is established.
|
|
21
|
+
* @zh 未建立 TLS 连接。
|
|
22
|
+
* @ja TLS 接続は確立されていません。
|
|
23
|
+
* @ko TLS 연결이 설정되지 않았습니다.
|
|
24
|
+
*/
|
|
25
|
+
NotConnected,
|
|
26
|
+
/**
|
|
27
|
+
* The handshake has started but is not complete.
|
|
28
|
+
* @zh 握手已开始但尚未完成。
|
|
29
|
+
* @ja ハンドシェイクは開始済みですが、未完了です。
|
|
30
|
+
* @ko 핸드셰이크가 시작되었지만 완료되지 않았습니다.
|
|
31
|
+
*/
|
|
32
|
+
HandshakeStarted,
|
|
33
|
+
/**
|
|
34
|
+
* The handshake is complete; encrypted data can be transferred.
|
|
35
|
+
* @zh 握手完成,可以传输加密数据。
|
|
36
|
+
* @ja ハンドシェイクが完了し、暗号化データを転送できます。
|
|
37
|
+
* @ko 핸드셰이크가 완료되어 암호화된 데이터를 전송할 수 있습니다.
|
|
38
|
+
*/
|
|
39
|
+
HandshakeComplete,
|
|
40
|
+
/**
|
|
41
|
+
* The handshake failed.
|
|
42
|
+
* @zh 握手失败。
|
|
43
|
+
* @ja ハンドシェイクが失敗しました。
|
|
44
|
+
* @ko 핸드셰이크가 실패했습니다.
|
|
45
|
+
*/
|
|
46
|
+
Error,
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* Result of reading raw TCP bytes.
|
|
50
|
+
* @zh 原始 TCP 字节读取结果。
|
|
51
|
+
* @ja 生の TCP バイトの読み取り結果。
|
|
52
|
+
* @ko 원시 TCP 바이트 읽기 결과.
|
|
53
|
+
*/
|
|
54
|
+
export interface SocketTransfer {
|
|
55
|
+
/**
|
|
56
|
+
* Operation result status.
|
|
57
|
+
* @zh 操作结果状态。
|
|
58
|
+
* @ja 操作結果の状態。
|
|
59
|
+
* @ko 작업 결과 상태.
|
|
60
|
+
*/
|
|
61
|
+
status: Status;
|
|
62
|
+
/**
|
|
63
|
+
* Number of bytes actually written to the destination buffer.
|
|
64
|
+
* @zh 实际写入目标缓冲区的字节数。
|
|
65
|
+
* @ja 出力先バッファに実際に書き込んだバイト数。
|
|
66
|
+
* @ko 대상 버퍼에 실제로 쓴 바이트 수.
|
|
67
|
+
*/
|
|
68
|
+
received: number;
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* Result of sending raw TCP bytes.
|
|
72
|
+
* @zh 原始 TCP 字节发送结果。
|
|
73
|
+
* @ja 生の TCP バイトの送信結果。
|
|
74
|
+
* @ko 원시 TCP 바이트 송신 결과.
|
|
75
|
+
*/
|
|
76
|
+
export interface SocketSendResult {
|
|
77
|
+
/**
|
|
78
|
+
* Operation result status.
|
|
79
|
+
* @zh 操作结果状态。
|
|
80
|
+
* @ja 操作結果の状態。
|
|
81
|
+
* @ko 작업 결과 상태.
|
|
82
|
+
*/
|
|
83
|
+
status: Status;
|
|
84
|
+
/**
|
|
85
|
+
* Bytes handed to the Node transport; this does not imply peer receipt.
|
|
86
|
+
* @zh 已交给 Node 传输层的字节数,不代表对端已接收。
|
|
87
|
+
* @ja Node トランスポートに渡したバイト数。相手の受信を意味しません。
|
|
88
|
+
* @ko Node 전송 계층에 전달한 바이트 수이며 상대방의 수신을 의미하지 않습니다.
|
|
89
|
+
*/
|
|
90
|
+
sent: number;
|
|
91
|
+
}
|
|
92
|
+
export const adoptTcp: unique symbol = Symbol('TcpSocket.adopt');
|
|
93
|
+
|
|
94
|
+
/**
|
|
95
|
+
* TCP socket supporting raw bytes, SFML Packet framing, and TLS upgrades.
|
|
96
|
+
* @zh 支持原始字节、SFML Packet 分帧和 TLS 升级的 TCP 套接字。
|
|
97
|
+
* @ja 生バイト、SFML Packet のフレーミング、TLS アップグレード対応の TCP ソケット。
|
|
98
|
+
* @ko 원시 바이트, SFML Packet 프레이밍 및 TLS 업그레이드를 지원하는 TCP 소켓.
|
|
99
|
+
*/
|
|
100
|
+
export class TcpSocket extends Socket {
|
|
101
|
+
/**
|
|
102
|
+
* TLS handshake status enumeration.
|
|
103
|
+
* @zh TLS 握手状态枚举。
|
|
104
|
+
* @ja TLS ハンドシェイク状態の列挙型。
|
|
105
|
+
* @ko TLS 핸드셰이크 상태 열거형.
|
|
106
|
+
*/
|
|
107
|
+
static readonly TlsStatus = TlsStatus;
|
|
108
|
+
/**
|
|
109
|
+
* Underlying TCP or TLS socket.
|
|
110
|
+
* @zh 底层 TCP 或 TLS 套接字。
|
|
111
|
+
* @ja 下位の TCP または TLS ソケット。
|
|
112
|
+
* @ko 기반 TCP 또는 TLS 소켓.
|
|
113
|
+
*/
|
|
114
|
+
declare protected transport?: NetSocket;
|
|
115
|
+
/** TCP 连接是否已建立。 */
|
|
116
|
+
private connected = false;
|
|
117
|
+
/** 对端是否已关闭发送。 */
|
|
118
|
+
private ended = true;
|
|
119
|
+
/** TLS 握手当前状态。 */
|
|
120
|
+
private tlsStatus = TlsStatus.NotConnected;
|
|
121
|
+
/** 接收操作串行队列,保证分帧完整性。 */
|
|
122
|
+
private readonly reads = new SerialQueue();
|
|
123
|
+
/** 发送操作串行队列。 */
|
|
124
|
+
private readonly writes = new SerialQueue();
|
|
125
|
+
/** Packet 分帧的 4 字节长度前缀缓冲区。 */
|
|
126
|
+
private prefix = Buffer.alloc(4);
|
|
127
|
+
/** 已累积的前缀字节数。 */
|
|
128
|
+
private prefixSize = 0;
|
|
129
|
+
/** 解析出的包体长度。 */
|
|
130
|
+
private packetSize?: number;
|
|
131
|
+
/** 已累积的包体分片。 */
|
|
132
|
+
private packetChunks: Buffer[] = [];
|
|
133
|
+
/** 已累积的包体字节数。 */
|
|
134
|
+
private packetBytes = 0;
|
|
135
|
+
/** 进行中的 Packet 发送快照及其位置。 */
|
|
136
|
+
private outgoing?: { packet: Packet; data: Buffer; position: number };
|
|
137
|
+
|
|
138
|
+
/**
|
|
139
|
+
* Create an unconnected TCP socket, using asynchronous blocking semantics
|
|
140
|
+
* by default.
|
|
141
|
+
* @zh 创建未连接的 TCP 套接字,默认使用异步阻塞语义。
|
|
142
|
+
* @ja 未接続の TCP ソケットを作成します。既定では非同期ブロッキング動作です。
|
|
143
|
+
* @ko 연결되지 않은 TCP 소켓을 생성하며 기본적으로 비동기 블로킹 동작을
|
|
144
|
+
* 사용합니다.
|
|
145
|
+
*/
|
|
146
|
+
constructor() { super(SocketType.Tcp); }
|
|
147
|
+
/**
|
|
148
|
+
* Return the local port, or 0 if not yet assigned.
|
|
149
|
+
* @zh 返回本地端口,尚未分配时为 0。
|
|
150
|
+
* @ja ローカルポートを返し、未割り当てなら 0 を返します。
|
|
151
|
+
* @ko 로컬 포트를 반환하며 아직 할당되지 않았으면 0입니다.
|
|
152
|
+
*/
|
|
153
|
+
getLocalPort(): number { return this.transport?.localPort ?? 0; }
|
|
154
|
+
/**
|
|
155
|
+
* Return the peer address, or undefined when not connected.
|
|
156
|
+
* @zh 返回对端地址,未连接时为 undefined。
|
|
157
|
+
* @ja 相手のアドレスを返し、未接続なら undefined を返します。
|
|
158
|
+
* @ko 상대 주소를 반환하며 연결되지 않았으면 undefined입니다.
|
|
159
|
+
*/
|
|
160
|
+
getRemoteAddress(): IpAddress | undefined {
|
|
161
|
+
const address = this.connected ? this.transport?.remoteAddress : undefined;
|
|
162
|
+
return address ? IpAddress.fromString(address) : undefined;
|
|
163
|
+
}
|
|
164
|
+
/**
|
|
165
|
+
* Return the peer port, or 0 when not connected.
|
|
166
|
+
* @zh 返回对端端口,未连接时为 0。
|
|
167
|
+
* @ja 相手のポートを返し、未接続なら 0 を返します。
|
|
168
|
+
* @ko 상대 포트를 반환하며 연결되지 않았으면 0입니다.
|
|
169
|
+
*/
|
|
170
|
+
getRemotePort(): number {
|
|
171
|
+
return this.connected ? this.transport?.remotePort ?? 0 : 0;
|
|
172
|
+
}
|
|
173
|
+
/**
|
|
174
|
+
* Start a TCP connection; wait for completion by default, or return NotReady
|
|
175
|
+
* in nonblocking mode. Time.Zero disables the timeout.
|
|
176
|
+
* @zh 发起 TCP 连接;默认等待完成,非阻塞模式返回 NotReady,
|
|
177
|
+
* Time.Zero 不设超时。
|
|
178
|
+
* @ja TCP 接続を開始します。既定では完了を待ち、非ブロッキングモードでは
|
|
179
|
+
* NotReady を返します。Time.Zero はタイムアウトなしです。
|
|
180
|
+
* @ko TCP 연결을 시작합니다. 기본적으로 완료를 기다리며 논블로킹 모드에서는
|
|
181
|
+
* NotReady를 반환합니다. Time.Zero는 제한 시간이 없습니다.
|
|
182
|
+
*/
|
|
183
|
+
async connect(address: IpAddress, port: number,
|
|
184
|
+
timeout: NetworkTime = Time.Zero): Promise<Status> {
|
|
185
|
+
if (!(address instanceof IpAddress)) throw new TypeError('Expected IpAddress');
|
|
186
|
+
uint(port, 65535);
|
|
187
|
+
const milliseconds = millisecondsOf(timeout);
|
|
188
|
+
this.create(address.getType());
|
|
189
|
+
const generation = this.epoch;
|
|
190
|
+
const socket = this.transport!;
|
|
191
|
+
let timer: NodeJS.Timeout | undefined;
|
|
192
|
+
const done = waitFor(this[socketEvents], () => this.connected || this.ended ||
|
|
193
|
+
this.epoch !== generation).then(() => {
|
|
194
|
+
if (timer) clearTimeout(timer);
|
|
195
|
+
return this.epoch !== generation ? Status.Disconnected
|
|
196
|
+
: this.connected ? Status.Done : Status.Error;
|
|
197
|
+
});
|
|
198
|
+
if (milliseconds) {
|
|
199
|
+
timer = setTimeout(() => {
|
|
200
|
+
if (this.epoch !== generation) return;
|
|
201
|
+
this.failure = new Error('Connection timed out');
|
|
202
|
+
socket.destroy(this.failure);
|
|
203
|
+
}, milliseconds);
|
|
204
|
+
}
|
|
205
|
+
socket.connect({ host: address.toString(), port,
|
|
206
|
+
family: address.isV4() ? 4 : 6 });
|
|
207
|
+
return this.blocking ? done : Status.NotReady;
|
|
208
|
+
}
|
|
209
|
+
/**
|
|
210
|
+
* Close the connection immediately and clear pending packet transfer state.
|
|
211
|
+
* @zh 立即关闭连接并清除未完成的收发包状态。
|
|
212
|
+
* @ja 接続を即座に閉じ、未完了のパケット送受信状態を消去します。
|
|
213
|
+
* @ko 즉시 연결을 닫고 미완료 패킷 송수신 상태를 지웁니다.
|
|
214
|
+
*/
|
|
215
|
+
disconnect(): void { this.close(); }
|
|
216
|
+
/**
|
|
217
|
+
* Reject UDP or listener transports before adoption.
|
|
218
|
+
* @zh 接管前拒绝 UDP 或监听传输。
|
|
219
|
+
* @ja 引き継ぐ前に UDP またはリスナートランスポートを拒否します。
|
|
220
|
+
* @ko 인수 전에 UDP 또는 리스너 전송 객체를 거부합니다.
|
|
221
|
+
*/
|
|
222
|
+
protected validateHandle(handle: SocketHandle): void {
|
|
223
|
+
if (!(handle instanceof NetSocket)) throw new TypeError('Expected Node TCP');
|
|
224
|
+
}
|
|
225
|
+
/**
|
|
226
|
+
* Integrate the handle allocated or adopted by protected create into
|
|
227
|
+
* TCP send/receive and readiness state.
|
|
228
|
+
* @zh 将受保护 create 分配或接管的句柄接入 TCP 收发和就绪状态。
|
|
229
|
+
* @ja protected の create が割り当てまたは引き継いだハンドルを
|
|
230
|
+
* TCP 送受信と準備状態に組み込みます。
|
|
231
|
+
* @ko protected create가 할당하거나 인수한 핸들을 TCP 송수신 및
|
|
232
|
+
* 준비 상태에 연결합니다.
|
|
233
|
+
*/
|
|
234
|
+
protected onCreate(): void {
|
|
235
|
+
const socket = this.transport!;
|
|
236
|
+
this.connected = !socket.connecting && !!socket.remoteAddress;
|
|
237
|
+
this.attach(socket);
|
|
238
|
+
}
|
|
239
|
+
/**
|
|
240
|
+
* Clear frame parsing, TLS, and send snapshots on recreation;
|
|
241
|
+
* the base-class generation mechanism cancels old waits.
|
|
242
|
+
* @zh 重建时清理帧解析、TLS 和发送快照,旧等待由基类代际机制取消。
|
|
243
|
+
* @ja 再作成時にフレーム解析、TLS、送信スナップショットを消去します。
|
|
244
|
+
* 古い待機は基底クラスの世代機構がキャンセルします。
|
|
245
|
+
* @ko 재생성 시 프레임 파싱, TLS 및 송신 스냅샷을 정리하며,
|
|
246
|
+
* 기본 클래스의 세대 메커니즘이 이전 대기를 취소합니다.
|
|
247
|
+
*/
|
|
248
|
+
protected onClose(): void {
|
|
249
|
+
this.connected = false;
|
|
250
|
+
this.ended = true;
|
|
251
|
+
this.tlsStatus = TlsStatus.NotConnected;
|
|
252
|
+
this.resetPacket();
|
|
253
|
+
this.outgoing = undefined;
|
|
254
|
+
}
|
|
255
|
+
/**
|
|
256
|
+
* Let listeners adopt accepted connections through the same lifecycle.
|
|
257
|
+
* @zh 监听器通过同一生命周期接管已接受的连接。
|
|
258
|
+
* @ja リスナーが同じライフサイクルで受け入れ済み接続を引き継ぎます。
|
|
259
|
+
* @ko 리스너가 같은 수명 주기를 통해 수락한 연결을 인수합니다.
|
|
260
|
+
*/
|
|
261
|
+
[adoptTcp](socket: NetSocket): void {
|
|
262
|
+
this.create(socket);
|
|
263
|
+
}
|
|
264
|
+
/**
|
|
265
|
+
* Upgrade an idle connection to a TLS client with verification enabled
|
|
266
|
+
* by default; CA bytes may use PEM or DER.
|
|
267
|
+
* @zh 将空闲连接升级为 TLS 客户端;默认验证,CA 字节支持 PEM 或 DER。
|
|
268
|
+
* @ja アイドル接続を TLS クライアントにアップグレードします。
|
|
269
|
+
* 既定で検証が有効で、CA バイトは PEM または DER に対応します。
|
|
270
|
+
* @ko 유휴 연결을 TLS 클라이언트로 업그레이드합니다.
|
|
271
|
+
* 기본적으로 검증하며 CA 바이트는 PEM 또는 DER를 지원합니다.
|
|
272
|
+
*/
|
|
273
|
+
async setupTlsClient(hostname: string,
|
|
274
|
+
verifyOrCa: boolean | string | Uint8Array = true): Promise<TlsStatus> {
|
|
275
|
+
if (typeof hostname !== 'string') throw new TypeError('Expected hostname');
|
|
276
|
+
return this.setupTls(() => tlsConnect({
|
|
277
|
+
socket: this.transport, servername: hostname,
|
|
278
|
+
rejectUnauthorized: verifyOrCa !== false,
|
|
279
|
+
ca: typeof verifyOrCa === 'boolean' ? undefined : tlsCertificate(verifyOrCa),
|
|
280
|
+
}), 'secureConnect');
|
|
281
|
+
}
|
|
282
|
+
/**
|
|
283
|
+
* Upgrade to a TLS server using a PEM/DER certificate and private key;
|
|
284
|
+
* password bytes retain their raw contents and subview bounds.
|
|
285
|
+
* @zh 使用 PEM/DER 证书与私钥升级 TLS 服务端;口令字节保留原始内容及子视图。
|
|
286
|
+
* @ja PEM/DER の証明書と秘密鍵で TLS サーバーにアップグレードします。
|
|
287
|
+
* パスワードのバイトは元の内容とサブビューの範囲を保持します。
|
|
288
|
+
* @ko PEM/DER 인증서와 개인 키로 TLS 서버로 업그레이드합니다.
|
|
289
|
+
* 암호 바이트는 원시 내용과 하위 뷰 범위를 유지합니다.
|
|
290
|
+
*/
|
|
291
|
+
async setupTlsServer(certificate: string | Uint8Array,
|
|
292
|
+
key: string | Uint8Array, password: string | Uint8Array = ''):
|
|
293
|
+
Promise<TlsStatus> {
|
|
294
|
+
return this.setupTls(() => new TLSSocket(this.transport!, {
|
|
295
|
+
isServer: true,
|
|
296
|
+
secureContext: createSecureContext({
|
|
297
|
+
cert: tlsCertificate(certificate),
|
|
298
|
+
key: tlsPrivateKey(key, password),
|
|
299
|
+
}),
|
|
300
|
+
}), 'secure');
|
|
301
|
+
}
|
|
302
|
+
/**
|
|
303
|
+
* Return the cipher suite name negotiated during the handshake,
|
|
304
|
+
* or undefined before TLS completes.
|
|
305
|
+
* @zh 返回握手协商的加密套件名;TLS 未完成时为 undefined。
|
|
306
|
+
* @ja ハンドシェイクで合意した暗号スイート名を返します。
|
|
307
|
+
* TLS が完了していなければ undefined です。
|
|
308
|
+
* @ko 핸드셰이크에서 협상한 암호 스위트 이름을 반환하며,
|
|
309
|
+
* TLS가 완료되지 않았으면 undefined입니다.
|
|
310
|
+
*/
|
|
311
|
+
getCurrentCiphersuiteName(): string | undefined {
|
|
312
|
+
return this.tlsStatus === TlsStatus.HandshakeComplete &&
|
|
313
|
+
this.transport instanceof TLSSocket
|
|
314
|
+
? this.transport.getCipher()?.standardName ??
|
|
315
|
+
this.transport.getCipher()?.name : undefined;
|
|
316
|
+
}
|
|
317
|
+
/**
|
|
318
|
+
* Send a call-time packet snapshot with an automatic network-order u32 length
|
|
319
|
+
* header; continue with the same Packet after Partial.
|
|
320
|
+
* @zh 发送调用时的包快照,自动加网络序 u32 长度头;Partial 时用同一 Packet 继续。
|
|
321
|
+
* @ja 呼び出し時のパケットのスナップショットにネットワーク順の u32 長さヘッダーを
|
|
322
|
+
* 自動付加して送信します。Partial の場合は同じ Packet で続行してください。
|
|
323
|
+
* @ko 호출 시점의 패킷 스냅샷에 네트워크 바이트 순서의 u32 길이 헤더를 자동으로
|
|
324
|
+
* 붙여 송신합니다. Partial이면 같은 Packet으로 계속 진행하세요.
|
|
325
|
+
*/
|
|
326
|
+
send(packet: Packet): Promise<Status>;
|
|
327
|
+
/**
|
|
328
|
+
* Send a call-time byte snapshot; after Partial, retry the remaining bytes
|
|
329
|
+
* starting at the sent offset.
|
|
330
|
+
* @zh 发送调用时的字节快照;Partial 时按 sent 偏移重试剩余字节。
|
|
331
|
+
* @ja 呼び出し時のバイトスナップショットを送信します。
|
|
332
|
+
* Partial の場合は sent の位置から残りのバイトを再試行してください。
|
|
333
|
+
* @ko 호출 시점의 바이트 스냅샷을 송신합니다.
|
|
334
|
+
* Partial이면 sent 오프셋부터 남은 바이트를 다시 시도하세요.
|
|
335
|
+
*/
|
|
336
|
+
send(data: Uint8Array): Promise<SocketSendResult>;
|
|
337
|
+
send(data: Packet | Uint8Array): Promise<Status | SocketSendResult> {
|
|
338
|
+
const generation = this.epoch;
|
|
339
|
+
// Snapshot at call time, including for nonblocking writes accepted by Node.
|
|
340
|
+
const snapshot = data instanceof Packet
|
|
341
|
+
? this.outgoing?.packet === data ? undefined : Buffer.from(data[packetSend]())
|
|
342
|
+
: Buffer.from(bytes(data));
|
|
343
|
+
return this.writes.run(async () => {
|
|
344
|
+
const packet = data instanceof Packet ? data : undefined;
|
|
345
|
+
const result = (status: Status, sent = 0) =>
|
|
346
|
+
(packet ? status : { status, sent });
|
|
347
|
+
if (generation !== this.epoch || !this.connected) {
|
|
348
|
+
return result(this.failure ? Status.Error : Status.Disconnected);
|
|
349
|
+
}
|
|
350
|
+
if (this.tlsStatus === TlsStatus.HandshakeStarted) {
|
|
351
|
+
return result(Status.NotReady);
|
|
352
|
+
}
|
|
353
|
+
if (this.outgoing && this.outgoing.packet !== packet) {
|
|
354
|
+
return result(Status.NotReady);
|
|
355
|
+
}
|
|
356
|
+
if (packet && !this.outgoing) {
|
|
357
|
+
const body = snapshot!;
|
|
358
|
+
uint(body.length);
|
|
359
|
+
const wire = Buffer.allocUnsafe(body.length + 4);
|
|
360
|
+
wire.writeUInt32BE(body.length);
|
|
361
|
+
body.copy(wire, 4);
|
|
362
|
+
this.outgoing = { packet, data: wire, position: 0 };
|
|
363
|
+
}
|
|
364
|
+
const input = this.outgoing
|
|
365
|
+
? this.outgoing.data.subarray(this.outgoing.position) : snapshot!;
|
|
366
|
+
const socket = this.transport!;
|
|
367
|
+
if (!input.length) return result(Status.Done);
|
|
368
|
+
const room = this.blocking ? input.length
|
|
369
|
+
: Math.max(0, socket.writableHighWaterMark - socket.writableLength);
|
|
370
|
+
const count = Math.min(input.length, room);
|
|
371
|
+
if (!count) return result(Status.NotReady);
|
|
372
|
+
const completion = new Promise<Status>(resolve => {
|
|
373
|
+
socket.write(input.subarray(0, count), error =>
|
|
374
|
+
resolve(error ? Status.Error : Status.Done));
|
|
375
|
+
});
|
|
376
|
+
if (this.outgoing) {
|
|
377
|
+
this.outgoing.position += count;
|
|
378
|
+
if (this.outgoing.position === this.outgoing.data.length) {
|
|
379
|
+
this.outgoing = undefined;
|
|
380
|
+
}
|
|
381
|
+
}
|
|
382
|
+
const status = this.blocking
|
|
383
|
+
? await this.awaitWrite(completion, generation) : Status.Done;
|
|
384
|
+
if (generation !== this.epoch) return result(Status.Disconnected, count);
|
|
385
|
+
return result(status === Status.Done && count < input.length
|
|
386
|
+
? Status.Partial : status, count);
|
|
387
|
+
});
|
|
388
|
+
}
|
|
389
|
+
/**
|
|
390
|
+
* Replace packet after receiving a complete length-prefixed packet.
|
|
391
|
+
* Nonblocking mode retains incomplete frames; receive at most 64 MiB.
|
|
392
|
+
* @zh 接收完整长度前缀包后替换 packet;非阻塞模式保留未完整的分帧,
|
|
393
|
+
* 最多接收 64 MiB。
|
|
394
|
+
* @ja 長さプレフィックス付きパケットを完全に受信した後で packet を置換します。
|
|
395
|
+
* 非ブロッキングモードは未完のフレームを保持し、受信上限は 64 MiB です。
|
|
396
|
+
* @ko 길이 접두사가 있는 패킷을 완전히 수신한 후 packet을 교체합니다.
|
|
397
|
+
* 논블로킹 모드는 미완성 프레임을 보관하며 최대 64 MiB를 수신합니다.
|
|
398
|
+
*/
|
|
399
|
+
receive(packet: Packet): Promise<Status>;
|
|
400
|
+
/**
|
|
401
|
+
* Receive into data and return the actual byte count;
|
|
402
|
+
* do not modify the destination buffer before completion.
|
|
403
|
+
* @zh 接收至 data 并返回实际字节数;完成前勿修改目标缓冲区。
|
|
404
|
+
* @ja data に受信して実際のバイト数を返します。
|
|
405
|
+
* 完了前に出力先バッファを変更しないでください。
|
|
406
|
+
* @ko data로 수신하고 실제 바이트 수를 반환합니다.
|
|
407
|
+
* 완료 전에 대상 버퍼를 수정하지 마세요.
|
|
408
|
+
*/
|
|
409
|
+
receive(data: Uint8Array): Promise<SocketTransfer>;
|
|
410
|
+
receive(destination: Packet | Uint8Array): Promise<Status | SocketTransfer> {
|
|
411
|
+
const output = destination instanceof Packet ? undefined : bytes(destination);
|
|
412
|
+
const generation = this.epoch;
|
|
413
|
+
return this.reads.run(async () => {
|
|
414
|
+
if (destination instanceof Packet) {
|
|
415
|
+
for (;;) {
|
|
416
|
+
const header = this.packetSize === undefined;
|
|
417
|
+
const needed = header ? 4 - this.prefixSize
|
|
418
|
+
: this.packetSize! - this.packetBytes;
|
|
419
|
+
if (!needed && !header) {
|
|
420
|
+
const payload = Buffer.concat(this.packetChunks, this.packetBytes);
|
|
421
|
+
this.resetPacket();
|
|
422
|
+
destination[packetReceive](payload);
|
|
423
|
+
return Status.Done;
|
|
424
|
+
}
|
|
425
|
+
const chunk = await this.readChunk(needed, generation);
|
|
426
|
+
if (typeof chunk === 'number') return chunk;
|
|
427
|
+
if (header) {
|
|
428
|
+
chunk.copy(this.prefix, this.prefixSize);
|
|
429
|
+
this.prefixSize += chunk.length;
|
|
430
|
+
if (this.prefixSize === 4) {
|
|
431
|
+
this.packetSize = this.prefix.readUInt32BE();
|
|
432
|
+
if (this.packetSize > 64 * 1024 * 1024) {
|
|
433
|
+
this.failure = new Error('Packet exceeds 64 MiB receive limit');
|
|
434
|
+
this.disconnect();
|
|
435
|
+
return Status.Error;
|
|
436
|
+
}
|
|
437
|
+
}
|
|
438
|
+
} else {
|
|
439
|
+
this.packetChunks.push(chunk);
|
|
440
|
+
this.packetBytes += chunk.length;
|
|
441
|
+
}
|
|
442
|
+
}
|
|
443
|
+
}
|
|
444
|
+
if (this.prefixSize || this.packetSize !== undefined) {
|
|
445
|
+
throw new Error('Finish receiving the pending Packet first');
|
|
446
|
+
}
|
|
447
|
+
if (!output!.length) return { status: Status.Error, received: 0 };
|
|
448
|
+
const chunk = await this.readChunk(output!.length, generation);
|
|
449
|
+
if (typeof chunk === 'number') return { status: chunk, received: 0 };
|
|
450
|
+
chunk.copy(output!);
|
|
451
|
+
return { status: Status.Done, received: chunk.length };
|
|
452
|
+
});
|
|
453
|
+
}
|
|
454
|
+
/**
|
|
455
|
+
* Return TCP transport liveness; derived classes may extend this.
|
|
456
|
+
* @zh 返回 TCP 传输存活状态,允许派生类扩展。
|
|
457
|
+
* @ja TCP トランスポートの生存状態を返します。派生クラスで拡張できます。
|
|
458
|
+
* @ko TCP 전송 객체의 활성 상태를 반환하며 파생 클래스에서 확장할 수 있습니다.
|
|
459
|
+
*/
|
|
460
|
+
protected isAlive(): boolean { return !!this.transport && !this.ended; }
|
|
461
|
+
/**
|
|
462
|
+
* Return readiness bits for receiving, sending, and the TLS handshake.
|
|
463
|
+
* @zh 返回接收、发送及 TLS 握手对应的就绪位。
|
|
464
|
+
* @ja 受信、送信、TLS ハンドシェイクに対応する準備状態ビットを返します。
|
|
465
|
+
* @ko 수신, 송신 및 TLS 핸드셰이크에 해당하는 준비 상태 비트를 반환합니다.
|
|
466
|
+
*/
|
|
467
|
+
protected getReadiness(mask: number): number {
|
|
468
|
+
const socket = this.transport;
|
|
469
|
+
const receive = socket && (socket.readableLength > 0 || this.ended) ? 1 : 0;
|
|
470
|
+
const send = this.connected && socket && !socket.destroyed &&
|
|
471
|
+
!socket.writableNeedDrain && this.tlsStatus !== TlsStatus.HandshakeStarted
|
|
472
|
+
? 2 : 0;
|
|
473
|
+
// eslint-disable-next-line no-bitwise
|
|
474
|
+
return (receive | send) & mask;
|
|
475
|
+
}
|
|
476
|
+
protected getNativeHandle(): NetSocket | undefined { return this.transport; }
|
|
477
|
+
/** 重置 Packet 分帧累积状态。 */
|
|
478
|
+
private resetPacket(): void {
|
|
479
|
+
this.prefixSize = 0;
|
|
480
|
+
this.packetSize = undefined;
|
|
481
|
+
this.packetChunks = [];
|
|
482
|
+
this.packetBytes = 0;
|
|
483
|
+
}
|
|
484
|
+
/** 异步读取最多 max 字节,含代际校验。 */
|
|
485
|
+
private async readChunk(max: number, generation: number):
|
|
486
|
+
Promise<Buffer | Status> {
|
|
487
|
+
const available = () => this.ended ||
|
|
488
|
+
(this.transport?.readableLength ?? 0) > 0;
|
|
489
|
+
await this.awaitReady(available, generation);
|
|
490
|
+
if (generation !== this.epoch) return Status.Disconnected;
|
|
491
|
+
const socket = this.transport;
|
|
492
|
+
const count = Math.min(max, socket?.readableLength ?? 0);
|
|
493
|
+
if (count) return socket!.read(count) as Buffer;
|
|
494
|
+
if (this.ended) return this.failure ? Status.Error : Status.Disconnected;
|
|
495
|
+
return Status.NotReady;
|
|
496
|
+
}
|
|
497
|
+
/** 绑定套接字事件监听并设置 TCP_NODELAY。 */
|
|
498
|
+
private attach(socket: NetSocket): void {
|
|
499
|
+
this.detach?.();
|
|
500
|
+
this.transport = socket;
|
|
501
|
+
this.ended = socket.destroyed || socket.readableEnded;
|
|
502
|
+
socket.setNoDelay(true);
|
|
503
|
+
const generation = this.epoch;
|
|
504
|
+
const current = () => socket === this.transport && generation === this.epoch;
|
|
505
|
+
const readable = () => { if (current()) this.changed(); };
|
|
506
|
+
const connected = () => {
|
|
507
|
+
if (!current()) return;
|
|
508
|
+
this.connected = true; this.changed();
|
|
509
|
+
};
|
|
510
|
+
const ended = () => {
|
|
511
|
+
if (!current()) return;
|
|
512
|
+
this.connected = false; this.ended = true; this.changed();
|
|
513
|
+
};
|
|
514
|
+
const error = (error: Error) => {
|
|
515
|
+
if (!current()) return;
|
|
516
|
+
this.failure = error; ended();
|
|
517
|
+
};
|
|
518
|
+
socket.on('readable', readable)
|
|
519
|
+
.on('drain', readable)
|
|
520
|
+
.on('connect', connected)
|
|
521
|
+
.on('end', ended)
|
|
522
|
+
.on('close', ended)
|
|
523
|
+
.on('error', error);
|
|
524
|
+
this.detach = () => {
|
|
525
|
+
socket.off('readable', readable)
|
|
526
|
+
.off('drain', readable)
|
|
527
|
+
.off('connect', connected)
|
|
528
|
+
.off('end', ended)
|
|
529
|
+
.off('close', ended)
|
|
530
|
+
.off('error', error);
|
|
531
|
+
};
|
|
532
|
+
}
|
|
533
|
+
/** 将空闲连接升级为 TLS 并等待握手完成。 */
|
|
534
|
+
private async setupTls(create: () => TLSSocket, event: string):
|
|
535
|
+
Promise<TlsStatus> {
|
|
536
|
+
if (!this.connected) return TlsStatus.NotConnected;
|
|
537
|
+
const generation = this.epoch;
|
|
538
|
+
if (this.tlsStatus === TlsStatus.NotConnected) {
|
|
539
|
+
if (this.transport!.readableLength || this.transport!.writableLength) {
|
|
540
|
+
throw new Error('TLS upgrade requires an empty plaintext queue');
|
|
541
|
+
}
|
|
542
|
+
try {
|
|
543
|
+
this.detach?.();
|
|
544
|
+
const socket = create();
|
|
545
|
+
this.attach(socket);
|
|
546
|
+
this.tlsStatus = TlsStatus.HandshakeStarted;
|
|
547
|
+
const secure = () => {
|
|
548
|
+
if (socket !== this.transport || generation !== this.epoch) return;
|
|
549
|
+
this.tlsStatus = TlsStatus.HandshakeComplete;
|
|
550
|
+
this.changed();
|
|
551
|
+
};
|
|
552
|
+
socket.once(event, secure);
|
|
553
|
+
const detach = this.detach;
|
|
554
|
+
this.detach = () => { detach?.(); socket.off(event, secure); };
|
|
555
|
+
} catch (error) {
|
|
556
|
+
this.failure = error as Error;
|
|
557
|
+
this.disconnect();
|
|
558
|
+
return TlsStatus.Error;
|
|
559
|
+
}
|
|
560
|
+
}
|
|
561
|
+
if (this.blocking && this.tlsStatus === TlsStatus.HandshakeStarted) {
|
|
562
|
+
await waitFor(this[socketEvents], () => this.ended ||
|
|
563
|
+
this.tlsStatus !== TlsStatus.HandshakeStarted ||
|
|
564
|
+
generation !== this.epoch);
|
|
565
|
+
}
|
|
566
|
+
return this.ended || generation !== this.epoch ? TlsStatus.Error
|
|
567
|
+
: this.tlsStatus;
|
|
568
|
+
}
|
|
569
|
+
}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import { X509Certificate, createPrivateKey } from 'node:crypto';
|
|
2
|
+
import { bytes } from './common';
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* Preserve the full PEM certificate chain; parse DER certificates as X.509
|
|
6
|
+
* and convert them to PEM accepted by Node TLS.
|
|
7
|
+
* @zh 保留完整 PEM 证书链;DER 证书经 X.509 解析后转为 Node TLS 接受的 PEM。
|
|
8
|
+
* @ja 完全な PEM 証明書チェーンを保持します。DER 証明書は X.509 として解析し、
|
|
9
|
+
* Node TLS が受け付ける PEM に変換します。
|
|
10
|
+
* @ko 전체 PEM 인증서 체인을 유지합니다. DER 인증서는 X.509로 파싱한 후
|
|
11
|
+
* Node TLS가 허용하는 PEM으로 변환합니다.
|
|
12
|
+
*/
|
|
13
|
+
export function tlsCertificate(input: string | Uint8Array): string | Buffer {
|
|
14
|
+
if (typeof input === 'string') return input;
|
|
15
|
+
const data = bytes(input);
|
|
16
|
+
return data.includes('-----BEGIN CERTIFICATE-----')
|
|
17
|
+
? data : new X509Certificate(data).toString();
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
/**
|
|
21
|
+
* Validate and decrypt a private key, preserving raw password bytes and view
|
|
22
|
+
* bounds; output password-free PKCS#8 PEM.
|
|
23
|
+
* @zh 校验并解密私钥,保留密码的原始字节和视图范围,输出无密码 PKCS#8 PEM。
|
|
24
|
+
* @ja 秘密鍵を検証・復号し、パスワードの生バイトとビューの範囲を保持します。
|
|
25
|
+
* パスワードなしの PKCS#8 PEM を出力します。
|
|
26
|
+
* @ko 개인 키를 검증하고 복호화하며 암호의 원시 바이트와 뷰 범위를 유지합니다.
|
|
27
|
+
* 암호 없는 PKCS#8 PEM을 출력합니다.
|
|
28
|
+
*/
|
|
29
|
+
export function tlsPrivateKey(input: string | Uint8Array,
|
|
30
|
+
password: string | Uint8Array): string | Buffer {
|
|
31
|
+
const key = typeof input === 'string' ? input : bytes(input);
|
|
32
|
+
const passphrase = typeof password === 'string' ? password : bytes(password);
|
|
33
|
+
if (typeof key === 'string' || key.includes('-----BEGIN ')) {
|
|
34
|
+
return createPrivateKey({ key, format: 'pem', passphrase })
|
|
35
|
+
.export({ format: 'pem', type: 'pkcs8' });
|
|
36
|
+
}
|
|
37
|
+
// 每一种 DER 容器均交给 OpenSSL 实际解析校验,不通过前缀猜测密钥格式。
|
|
38
|
+
let failure: unknown;
|
|
39
|
+
for (const type of [ 'pkcs8', 'pkcs1', 'sec1' ] as const) {
|
|
40
|
+
try {
|
|
41
|
+
return createPrivateKey({ key, format: 'der', type, passphrase })
|
|
42
|
+
.export({ format: 'pem', type: 'pkcs8' });
|
|
43
|
+
} catch (error) { failure ??= error; }
|
|
44
|
+
}
|
|
45
|
+
throw failure;
|
|
46
|
+
}
|