@owlmeans/file-streams 0.0.0-stage → 0.2.0-alpha.0
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 +21 -0
- package/README.md +71 -2
- package/agent-meta/manifest.json +64 -0
- package/agent-meta/skills/file-streams/SKILL.md +183 -0
- package/agent-meta/skills/file-streams/parts/network.md +47 -0
- package/agent-meta/skills/file-streams/parts/workspaces.md +129 -0
- package/build/archive/consts.d.ts +16 -0
- package/build/archive/consts.d.ts.map +1 -0
- package/build/archive/consts.js +24 -0
- package/build/archive/consts.js.map +1 -0
- package/build/archive/formats.d.ts +4 -0
- package/build/archive/formats.d.ts.map +1 -0
- package/build/archive/formats.js +53 -0
- package/build/archive/formats.js.map +1 -0
- package/build/archive/guard.d.ts +5 -0
- package/build/archive/guard.d.ts.map +1 -0
- package/build/archive/guard.js +62 -0
- package/build/archive/guard.js.map +1 -0
- package/build/archive/ratio.d.ts +5 -0
- package/build/archive/ratio.d.ts.map +1 -0
- package/build/archive/ratio.js +30 -0
- package/build/archive/ratio.js.map +1 -0
- package/build/archive/tar.d.ts +4 -0
- package/build/archive/tar.d.ts.map +1 -0
- package/build/archive/tar.js +142 -0
- package/build/archive/tar.js.map +1 -0
- package/build/archive/types.d.ts +95 -0
- package/build/archive/types.d.ts.map +1 -0
- package/build/archive/types.js +2 -0
- package/build/archive/types.js.map +1 -0
- package/build/archive/types.local.d.ts +64 -0
- package/build/archive/types.local.d.ts.map +1 -0
- package/build/archive/types.local.js +2 -0
- package/build/archive/types.local.js.map +1 -0
- package/build/archive/zip.d.ts +4 -0
- package/build/archive/zip.d.ts.map +1 -0
- package/build/archive/zip.js +135 -0
- package/build/archive/zip.js.map +1 -0
- package/build/archive.d.ts +4 -0
- package/build/archive.d.ts.map +1 -0
- package/build/archive.js +265 -0
- package/build/archive.js.map +1 -0
- package/build/backed-workspace/types.d.ts +67 -0
- package/build/backed-workspace/types.d.ts.map +1 -0
- package/build/backed-workspace/types.js +2 -0
- package/build/backed-workspace/types.js.map +1 -0
- package/build/backed-workspace.d.ts +4 -0
- package/build/backed-workspace.d.ts.map +1 -0
- package/build/backed-workspace.js +63 -0
- package/build/backed-workspace.js.map +1 -0
- package/build/consts.d.ts +3 -0
- package/build/consts.d.ts.map +1 -0
- package/build/consts.js +3 -0
- package/build/consts.js.map +1 -0
- package/build/consts.local.d.ts +3 -0
- package/build/consts.local.d.ts.map +1 -0
- package/build/consts.local.js +3 -0
- package/build/consts.local.js.map +1 -0
- package/build/errors.d.ts +59 -0
- package/build/errors.d.ts.map +1 -0
- package/build/errors.js +105 -0
- package/build/errors.js.map +1 -0
- package/build/http/connector.d.ts +11 -0
- package/build/http/connector.d.ts.map +1 -0
- package/build/http/connector.js +124 -0
- package/build/http/connector.js.map +1 -0
- package/build/http/consts.d.ts +9 -0
- package/build/http/consts.d.ts.map +1 -0
- package/build/http/consts.js +8 -0
- package/build/http/consts.js.map +1 -0
- package/build/http/source.d.ts +5 -0
- package/build/http/source.d.ts.map +1 -0
- package/build/http/source.js +76 -0
- package/build/http/source.js.map +1 -0
- package/build/http/types.d.ts +67 -0
- package/build/http/types.d.ts.map +1 -0
- package/build/http/types.js +2 -0
- package/build/http/types.js.map +1 -0
- package/build/http/types.local.d.ts +21 -0
- package/build/http/types.local.d.ts.map +1 -0
- package/build/http/types.local.js +2 -0
- package/build/http/types.local.js.map +1 -0
- package/build/http.d.ts +4 -0
- package/build/http.d.ts.map +1 -0
- package/build/http.js +248 -0
- package/build/http.js.map +1 -0
- package/build/index.d.ts +53 -0
- package/build/index.d.ts.map +1 -0
- package/build/index.js +33 -0
- package/build/index.js.map +1 -0
- package/build/network/consts.d.ts +12 -0
- package/build/network/consts.d.ts.map +1 -0
- package/build/network/consts.js +20 -0
- package/build/network/consts.js.map +1 -0
- package/build/network/types.d.ts +43 -0
- package/build/network/types.d.ts.map +1 -0
- package/build/network/types.js +2 -0
- package/build/network/types.js.map +1 -0
- package/build/network.d.ts +4 -0
- package/build/network.d.ts.map +1 -0
- package/build/network.js +165 -0
- package/build/network.js.map +1 -0
- package/build/proxy/consts.d.ts +7 -0
- package/build/proxy/consts.d.ts.map +1 -0
- package/build/proxy/consts.js +9 -0
- package/build/proxy/consts.js.map +1 -0
- package/build/proxy/endpoint.d.ts +4 -0
- package/build/proxy/endpoint.d.ts.map +1 -0
- package/build/proxy/endpoint.js +27 -0
- package/build/proxy/endpoint.js.map +1 -0
- package/build/proxy/http.d.ts +5 -0
- package/build/proxy/http.d.ts.map +1 -0
- package/build/proxy/http.js +95 -0
- package/build/proxy/http.js.map +1 -0
- package/build/proxy/router.d.ts +4 -0
- package/build/proxy/router.d.ts.map +1 -0
- package/build/proxy/router.js +85 -0
- package/build/proxy/router.js.map +1 -0
- package/build/proxy/socks.d.ts +5 -0
- package/build/proxy/socks.d.ts.map +1 -0
- package/build/proxy/socks.js +44 -0
- package/build/proxy/socks.js.map +1 -0
- package/build/proxy/types.d.ts +99 -0
- package/build/proxy/types.d.ts.map +1 -0
- package/build/proxy/types.js +2 -0
- package/build/proxy/types.js.map +1 -0
- package/build/resolvers/google-drive/consts.d.ts +10 -0
- package/build/resolvers/google-drive/consts.d.ts.map +1 -0
- package/build/resolvers/google-drive/consts.js +16 -0
- package/build/resolvers/google-drive/consts.js.map +1 -0
- package/build/resolvers/google-drive/types.d.ts +21 -0
- package/build/resolvers/google-drive/types.d.ts.map +1 -0
- package/build/resolvers/google-drive/types.js +2 -0
- package/build/resolvers/google-drive/types.js.map +1 -0
- package/build/resolvers/google-drive.d.ts +10 -0
- package/build/resolvers/google-drive.d.ts.map +1 -0
- package/build/resolvers/google-drive.js +130 -0
- package/build/resolvers/google-drive.js.map +1 -0
- package/build/resolvers/types.d.ts +39 -0
- package/build/resolvers/types.d.ts.map +1 -0
- package/build/resolvers/types.js +2 -0
- package/build/resolvers/types.js.map +1 -0
- package/build/s3/consts.d.ts +9 -0
- package/build/s3/consts.d.ts.map +1 -0
- package/build/s3/consts.js +9 -0
- package/build/s3/consts.js.map +1 -0
- package/build/s3/prefix.d.ts +4 -0
- package/build/s3/prefix.d.ts.map +1 -0
- package/build/s3/prefix.js +87 -0
- package/build/s3/prefix.js.map +1 -0
- package/build/s3/sink.d.ts +6 -0
- package/build/s3/sink.d.ts.map +1 -0
- package/build/s3/sink.js +30 -0
- package/build/s3/sink.js.map +1 -0
- package/build/s3/source.d.ts +5 -0
- package/build/s3/source.d.ts.map +1 -0
- package/build/s3/source.js +81 -0
- package/build/s3/source.js.map +1 -0
- package/build/s3/types.d.ts +66 -0
- package/build/s3/types.d.ts.map +1 -0
- package/build/s3/types.js +2 -0
- package/build/s3/types.js.map +1 -0
- package/build/s3/types.local.d.ts +43 -0
- package/build/s3/types.local.d.ts.map +1 -0
- package/build/s3/types.local.js +2 -0
- package/build/s3/types.local.js.map +1 -0
- package/build/s3/upload.d.ts +4 -0
- package/build/s3/upload.d.ts.map +1 -0
- package/build/s3/upload.js +118 -0
- package/build/s3/upload.js.map +1 -0
- package/build/s3.d.ts +5 -0
- package/build/s3.d.ts.map +1 -0
- package/build/s3.js +68 -0
- package/build/s3.js.map +1 -0
- package/build/service/types.d.ts +66 -0
- package/build/service/types.d.ts.map +1 -0
- package/build/service/types.js +2 -0
- package/build/service/types.js.map +1 -0
- package/build/service/types.local.d.ts +11 -0
- package/build/service/types.local.d.ts.map +1 -0
- package/build/service/types.local.js +2 -0
- package/build/service/types.local.js.map +1 -0
- package/build/service.d.ts +6 -0
- package/build/service.d.ts.map +1 -0
- package/build/service.js +73 -0
- package/build/service.js.map +1 -0
- package/build/sinks/buffer/consts.d.ts +2 -0
- package/build/sinks/buffer/consts.d.ts.map +1 -0
- package/build/sinks/buffer/consts.js +2 -0
- package/build/sinks/buffer/consts.js.map +1 -0
- package/build/sinks/buffer/types.d.ts +11 -0
- package/build/sinks/buffer/types.d.ts.map +1 -0
- package/build/sinks/buffer/types.js +2 -0
- package/build/sinks/buffer/types.js.map +1 -0
- package/build/sinks/buffer.d.ts +4 -0
- package/build/sinks/buffer.d.ts.map +1 -0
- package/build/sinks/buffer.js +13 -0
- package/build/sinks/buffer.js.map +1 -0
- package/build/sinks/directory/types.d.ts +7 -0
- package/build/sinks/directory/types.d.ts.map +1 -0
- package/build/sinks/directory/types.js +2 -0
- package/build/sinks/directory/types.js.map +1 -0
- package/build/sinks/directory.d.ts +8 -0
- package/build/sinks/directory.d.ts.map +1 -0
- package/build/sinks/directory.js +43 -0
- package/build/sinks/directory.js.map +1 -0
- package/build/sinks/file.d.ts +5 -0
- package/build/sinks/file.d.ts.map +1 -0
- package/build/sinks/file.js +46 -0
- package/build/sinks/file.js.map +1 -0
- package/build/sinks/types.d.ts +11 -0
- package/build/sinks/types.d.ts.map +1 -0
- package/build/sinks/types.js +2 -0
- package/build/sinks/types.js.map +1 -0
- package/build/sinks/workload/consts.d.ts +5 -0
- package/build/sinks/workload/consts.d.ts.map +1 -0
- package/build/sinks/workload/consts.js +5 -0
- package/build/sinks/workload/consts.js.map +1 -0
- package/build/sinks/workload/types.d.ts +17 -0
- package/build/sinks/workload/types.d.ts.map +1 -0
- package/build/sinks/workload/types.js +2 -0
- package/build/sinks/workload/types.js.map +1 -0
- package/build/sinks/workload.d.ts +8 -0
- package/build/sinks/workload.d.ts.map +1 -0
- package/build/sinks/workload.js +51 -0
- package/build/sinks/workload.js.map +1 -0
- package/build/sources/buffer.d.ts +5 -0
- package/build/sources/buffer.d.ts.map +1 -0
- package/build/sources/buffer.js +20 -0
- package/build/sources/buffer.js.map +1 -0
- package/build/sources/file.d.ts +5 -0
- package/build/sources/file.d.ts.map +1 -0
- package/build/sources/file.js +50 -0
- package/build/sources/file.js.map +1 -0
- package/build/sources/stream.d.ts +5 -0
- package/build/sources/stream.d.ts.map +1 -0
- package/build/sources/stream.js +19 -0
- package/build/sources/stream.js.map +1 -0
- package/build/sources/types.d.ts +10 -0
- package/build/sources/types.d.ts.map +1 -0
- package/build/sources/types.js +2 -0
- package/build/sources/types.js.map +1 -0
- package/build/sources/workload/types.d.ts +29 -0
- package/build/sources/workload/types.d.ts.map +1 -0
- package/build/sources/workload/types.js +2 -0
- package/build/sources/workload/types.js.map +1 -0
- package/build/sources/workload.d.ts +7 -0
- package/build/sources/workload.d.ts.map +1 -0
- package/build/sources/workload.js +67 -0
- package/build/sources/workload.js.map +1 -0
- package/build/transfer/consts.d.ts +5 -0
- package/build/transfer/consts.d.ts.map +1 -0
- package/build/transfer/consts.js +8 -0
- package/build/transfer/consts.js.map +1 -0
- package/build/transfer/types.d.ts +49 -0
- package/build/transfer/types.d.ts.map +1 -0
- package/build/transfer/types.js +2 -0
- package/build/transfer/types.js.map +1 -0
- package/build/transfer.d.ts +4 -0
- package/build/transfer.d.ts.map +1 -0
- package/build/transfer.js +75 -0
- package/build/transfer.js.map +1 -0
- package/build/types.d.ts +99 -0
- package/build/types.d.ts.map +1 -0
- package/build/types.js +2 -0
- package/build/types.js.map +1 -0
- package/build/utils/names/consts.d.ts +5 -0
- package/build/utils/names/consts.d.ts.map +1 -0
- package/build/utils/names/consts.js +5 -0
- package/build/utils/names/consts.js.map +1 -0
- package/build/utils/names/types.d.ts +13 -0
- package/build/utils/names/types.d.ts.map +1 -0
- package/build/utils/names/types.js +2 -0
- package/build/utils/names/types.js.map +1 -0
- package/build/utils/names.d.ts +4 -0
- package/build/utils/names.d.ts.map +1 -0
- package/build/utils/names.js +60 -0
- package/build/utils/names.js.map +1 -0
- package/build/utils/paths/consts.d.ts +3 -0
- package/build/utils/paths/consts.d.ts.map +1 -0
- package/build/utils/paths/consts.js +2 -0
- package/build/utils/paths/consts.js.map +1 -0
- package/build/utils/paths/types.d.ts +20 -0
- package/build/utils/paths/types.d.ts.map +1 -0
- package/build/utils/paths/types.js +2 -0
- package/build/utils/paths/types.js.map +1 -0
- package/build/utils/paths.d.ts +4 -0
- package/build/utils/paths.d.ts.map +1 -0
- package/build/utils/paths.js +67 -0
- package/build/utils/paths.js.map +1 -0
- package/build/utils/range/types.d.ts +11 -0
- package/build/utils/range/types.d.ts.map +1 -0
- package/build/utils/range/types.js +2 -0
- package/build/utils/range/types.js.map +1 -0
- package/build/utils/range.d.ts +4 -0
- package/build/utils/range.d.ts.map +1 -0
- package/build/utils/range.js +64 -0
- package/build/utils/range.js.map +1 -0
- package/build/utils/redact/types.d.ts +16 -0
- package/build/utils/redact/types.d.ts.map +1 -0
- package/build/utils/redact/types.js +2 -0
- package/build/utils/redact/types.js.map +1 -0
- package/build/utils/redact.d.ts +4 -0
- package/build/utils/redact.d.ts.map +1 -0
- package/build/utils/redact.js +18 -0
- package/build/utils/redact.js.map +1 -0
- package/build/utils/signals/types.d.ts +17 -0
- package/build/utils/signals/types.d.ts.map +1 -0
- package/build/utils/signals/types.js +2 -0
- package/build/utils/signals/types.js.map +1 -0
- package/build/utils/signals.d.ts +4 -0
- package/build/utils/signals.d.ts.map +1 -0
- package/build/utils/signals.js +52 -0
- package/build/utils/signals.js.map +1 -0
- package/build/utils/streams/consts.d.ts +3 -0
- package/build/utils/streams/consts.d.ts.map +1 -0
- package/build/utils/streams/consts.js +3 -0
- package/build/utils/streams/consts.js.map +1 -0
- package/build/utils/streams/types.d.ts +59 -0
- package/build/utils/streams/types.d.ts.map +1 -0
- package/build/utils/streams/types.js +2 -0
- package/build/utils/streams/types.js.map +1 -0
- package/build/utils/streams.d.ts +4 -0
- package/build/utils/streams.d.ts.map +1 -0
- package/build/utils/streams.js +167 -0
- package/build/utils/streams.js.map +1 -0
- package/build/utils/tree/types.d.ts +6 -0
- package/build/utils/tree/types.d.ts.map +1 -0
- package/build/utils/tree/types.js +2 -0
- package/build/utils/tree/types.js.map +1 -0
- package/build/utils/tree.d.ts +4 -0
- package/build/utils/tree.d.ts.map +1 -0
- package/build/utils/tree.js +14 -0
- package/build/utils/tree.js.map +1 -0
- package/build/workspace/consts.d.ts +12 -0
- package/build/workspace/consts.d.ts.map +1 -0
- package/build/workspace/consts.js +12 -0
- package/build/workspace/consts.js.map +1 -0
- package/build/workspace/consts.local.d.ts +3 -0
- package/build/workspace/consts.local.d.ts.map +1 -0
- package/build/workspace/consts.local.js +3 -0
- package/build/workspace/consts.local.js.map +1 -0
- package/build/workspace/fs.d.ts +4 -0
- package/build/workspace/fs.d.ts.map +1 -0
- package/build/workspace/fs.js +45 -0
- package/build/workspace/fs.js.map +1 -0
- package/build/workspace/scope.d.ts +6 -0
- package/build/workspace/scope.d.ts.map +1 -0
- package/build/workspace/scope.js +180 -0
- package/build/workspace/scope.js.map +1 -0
- package/build/workspace/types.d.ts +66 -0
- package/build/workspace/types.d.ts.map +1 -0
- package/build/workspace/types.js +2 -0
- package/build/workspace/types.js.map +1 -0
- package/build/workspace/types.local.d.ts +20 -0
- package/build/workspace/types.local.d.ts.map +1 -0
- package/build/workspace/types.local.js +2 -0
- package/build/workspace/types.local.js.map +1 -0
- package/build/workspace.d.ts +7 -0
- package/build/workspace.d.ts.map +1 -0
- package/build/workspace.js +87 -0
- package/build/workspace.js.map +1 -0
- package/package.json +61 -4
- package/src/archive/consts.ts +28 -0
- package/src/archive/formats.ts +60 -0
- package/src/archive/guard.ts +68 -0
- package/src/archive/ratio.ts +35 -0
- package/src/archive/tar.ts +147 -0
- package/src/archive/types.local.ts +72 -0
- package/src/archive/types.ts +107 -0
- package/src/archive/zip.ts +142 -0
- package/src/archive.ts +298 -0
- package/src/backed-workspace/types.ts +72 -0
- package/src/backed-workspace.ts +85 -0
- package/src/consts.local.ts +2 -0
- package/src/consts.ts +2 -0
- package/src/errors.ts +128 -0
- package/src/http/connector.ts +136 -0
- package/src/http/consts.ts +13 -0
- package/src/http/source.ts +89 -0
- package/src/http/types.local.ts +23 -0
- package/src/http/types.ts +74 -0
- package/src/http.ts +276 -0
- package/src/index.ts +65 -0
- package/src/network/consts.ts +22 -0
- package/src/network/types.ts +45 -0
- package/src/network.ts +179 -0
- package/src/proxy/consts.ts +11 -0
- package/src/proxy/endpoint.ts +28 -0
- package/src/proxy/http.ts +108 -0
- package/src/proxy/router.ts +93 -0
- package/src/proxy/socks.ts +48 -0
- package/src/proxy/types.ts +114 -0
- package/src/resolvers/google-drive/consts.ts +22 -0
- package/src/resolvers/google-drive/types.ts +22 -0
- package/src/resolvers/google-drive.ts +153 -0
- package/src/resolvers/types.ts +45 -0
- package/src/s3/consts.ts +12 -0
- package/src/s3/prefix.ts +100 -0
- package/src/s3/sink.ts +36 -0
- package/src/s3/source.ts +90 -0
- package/src/s3/types.local.ts +49 -0
- package/src/s3/types.ts +70 -0
- package/src/s3/upload.ts +130 -0
- package/src/s3.ts +83 -0
- package/src/service/types.local.ts +9 -0
- package/src/service/types.ts +71 -0
- package/src/service.ts +97 -0
- package/src/sinks/buffer/consts.ts +1 -0
- package/src/sinks/buffer/types.ts +12 -0
- package/src/sinks/buffer.ts +18 -0
- package/src/sinks/directory/types.ts +7 -0
- package/src/sinks/directory.ts +49 -0
- package/src/sinks/file.ts +52 -0
- package/src/sinks/types.ts +12 -0
- package/src/sinks/workload/consts.ts +5 -0
- package/src/sinks/workload/types.ts +17 -0
- package/src/sinks/workload.ts +59 -0
- package/src/sources/buffer.ts +27 -0
- package/src/sources/file.ts +57 -0
- package/src/sources/stream.ts +26 -0
- package/src/sources/types.ts +12 -0
- package/src/sources/workload/types.ts +31 -0
- package/src/sources/workload.ts +79 -0
- package/src/transfer/consts.ts +10 -0
- package/src/transfer/types.ts +55 -0
- package/src/transfer.ts +89 -0
- package/src/types.ts +106 -0
- package/src/utils/names/consts.ts +5 -0
- package/src/utils/names/types.ts +12 -0
- package/src/utils/names.ts +70 -0
- package/src/utils/paths/consts.ts +3 -0
- package/src/utils/paths/types.ts +20 -0
- package/src/utils/paths.ts +75 -0
- package/src/utils/range/types.ts +11 -0
- package/src/utils/range.ts +80 -0
- package/src/utils/redact/types.ts +16 -0
- package/src/utils/redact.ts +23 -0
- package/src/utils/signals/types.ts +17 -0
- package/src/utils/signals.ts +63 -0
- package/src/utils/streams/consts.ts +2 -0
- package/src/utils/streams/types.ts +65 -0
- package/src/utils/streams.ts +188 -0
- package/src/utils/tree/types.ts +6 -0
- package/src/utils/tree.ts +18 -0
- package/src/workspace/consts.local.ts +2 -0
- package/src/workspace/consts.ts +14 -0
- package/src/workspace/fs.ts +48 -0
- package/src/workspace/scope.ts +196 -0
- package/src/workspace/types.local.ts +21 -0
- package/src/workspace/types.ts +71 -0
- package/src/workspace.ts +102 -0
- package/tests/archive.spec.ts +134 -0
- package/tests/backed.spec.ts +147 -0
- package/tests/context.ts +114 -0
- package/tests/fixtures.ts +190 -0
- package/tests/google-drive.spec.ts +76 -0
- package/tests/harness/drive.ts +92 -0
- package/tests/harness/http-proxy.ts +96 -0
- package/tests/harness/origin.ts +134 -0
- package/tests/harness/socks5.ts +135 -0
- package/tests/harness/workload.ts +118 -0
- package/tests/http.spec.ts +101 -0
- package/tests/inspector.spec.ts +40 -0
- package/tests/live.spec.ts +27 -0
- package/tests/network.spec.ts +79 -0
- package/tests/proxy.spec.ts +149 -0
- package/tests/s3.spec.ts +133 -0
- package/tests/service.spec.ts +77 -0
- package/tests/sources-sinks.spec.ts +96 -0
- package/tests/transfer.spec.ts +99 -0
- package/tests/tsconfig.json +12 -0
- package/tests/workload.spec.ts +140 -0
- package/tests/workspace.spec.ts +158 -0
- package/tsconfig.json +16 -0
package/build/network.js
ADDED
|
@@ -0,0 +1,165 @@
|
|
|
1
|
+
import { lookup } from 'node:dns/promises';
|
|
2
|
+
import { BlockList, isIP } from 'node:net';
|
|
3
|
+
import { logger } from '@owlmeans/log';
|
|
4
|
+
import { NetworkPolicyError } from './errors.js';
|
|
5
|
+
import { DEFAULT_SCHEMES, DENIED_HOST_SUFFIXES, DENIED_IPV4_CIDRS, DENIED_IPV6_CIDRS } from './network/consts.js';
|
|
6
|
+
const log = logger('file-streams:network');
|
|
7
|
+
export const createNetworkPolicy = (options = {}) => {
|
|
8
|
+
const schemes = options.schemes ?? DEFAULT_SCHEMES;
|
|
9
|
+
const listOf = (cidrs) => {
|
|
10
|
+
const list = new BlockList();
|
|
11
|
+
for (const cidr of cidrs) {
|
|
12
|
+
const [address, prefix] = cidr.split('/');
|
|
13
|
+
const family = isIP(address) === 6 ? 'ipv6' : 'ipv4';
|
|
14
|
+
if (prefix == null) {
|
|
15
|
+
list.addAddress(address, family);
|
|
16
|
+
}
|
|
17
|
+
else {
|
|
18
|
+
list.addSubnet(address, Number(prefix), family);
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
return list;
|
|
22
|
+
};
|
|
23
|
+
const denied = listOf([...DENIED_IPV4_CIDRS, ...DENIED_IPV6_CIDRS]);
|
|
24
|
+
const extraDenied = listOf(options.denyCidrs ?? []);
|
|
25
|
+
const allowed = listOf(options.allowCidrs ?? []);
|
|
26
|
+
const ipv6Bytes = (address) => {
|
|
27
|
+
let text = address.toLowerCase().replace(/^\[|\]$/g, '').split('%')[0];
|
|
28
|
+
const dotted = /(\d+\.\d+\.\d+\.\d+)$/.exec(text);
|
|
29
|
+
if (dotted != null) {
|
|
30
|
+
const octets = dotted[1].split('.').map(Number);
|
|
31
|
+
text = `${text.slice(0, -dotted[1].length)}${((octets[0] << 8) | octets[1]).toString(16)}:${((octets[2] << 8) | octets[3]).toString(16)}`;
|
|
32
|
+
}
|
|
33
|
+
const halves = text.split('::');
|
|
34
|
+
if (halves.length > 2) {
|
|
35
|
+
return undefined;
|
|
36
|
+
}
|
|
37
|
+
const head = halves[0] === '' ? [] : halves[0].split(':');
|
|
38
|
+
const tail = halves.length === 2 && halves[1] !== '' ? halves[1].split(':') : [];
|
|
39
|
+
const groups = halves.length === 2 ? [...head, ...new Array(8 - head.length - tail.length).fill('0'), ...tail] : head;
|
|
40
|
+
if (groups.length !== 8) {
|
|
41
|
+
return undefined;
|
|
42
|
+
}
|
|
43
|
+
return groups.flatMap(group => {
|
|
44
|
+
const value = parseInt(group, 16);
|
|
45
|
+
return [(value >> 8) & 0xff, value & 0xff];
|
|
46
|
+
});
|
|
47
|
+
};
|
|
48
|
+
/** The IPv4 an IPv6 address carries: mapped, NAT64, 6to4, Teredo, IPv4-compatible. */
|
|
49
|
+
const embeddedIpv4 = (address) => {
|
|
50
|
+
const bytes = ipv6Bytes(address);
|
|
51
|
+
if (bytes == null) {
|
|
52
|
+
return undefined;
|
|
53
|
+
}
|
|
54
|
+
const quad = (offset, mask = 0) => bytes.slice(offset, offset + 4).map(byte => byte ^ mask).join('.');
|
|
55
|
+
const zeros = (from, to) => bytes.slice(from, to).every(byte => byte === 0);
|
|
56
|
+
if (zeros(0, 10) && bytes[10] === 0xff && bytes[11] === 0xff) {
|
|
57
|
+
return quad(12);
|
|
58
|
+
}
|
|
59
|
+
if (bytes[0] === 0x00 && bytes[1] === 0x64 && bytes[2] === 0xff && bytes[3] === 0x9b) {
|
|
60
|
+
return quad(12);
|
|
61
|
+
}
|
|
62
|
+
if (bytes[0] === 0x20 && bytes[1] === 0x02) {
|
|
63
|
+
return quad(2);
|
|
64
|
+
}
|
|
65
|
+
if (bytes[0] === 0x20 && bytes[1] === 0x01 && bytes[2] === 0x00 && bytes[3] === 0x00) {
|
|
66
|
+
return quad(12, 0xff);
|
|
67
|
+
}
|
|
68
|
+
if (zeros(0, 12) && !zeros(12, 16)) {
|
|
69
|
+
return quad(12);
|
|
70
|
+
}
|
|
71
|
+
return undefined;
|
|
72
|
+
};
|
|
73
|
+
const allowsAddress = (address) => {
|
|
74
|
+
const family = isIP(address);
|
|
75
|
+
if (family === 0) {
|
|
76
|
+
return false;
|
|
77
|
+
}
|
|
78
|
+
const type = family === 6 ? 'ipv6' : 'ipv4';
|
|
79
|
+
if (allowed.check(address, type)) {
|
|
80
|
+
return true;
|
|
81
|
+
}
|
|
82
|
+
if (extraDenied.check(address, type)) {
|
|
83
|
+
return false;
|
|
84
|
+
}
|
|
85
|
+
if (options.allowPrivate === true) {
|
|
86
|
+
return true;
|
|
87
|
+
}
|
|
88
|
+
if (denied.check(address, type)) {
|
|
89
|
+
return false;
|
|
90
|
+
}
|
|
91
|
+
if (family === 6) {
|
|
92
|
+
const inner = embeddedIpv4(address);
|
|
93
|
+
if (inner != null) {
|
|
94
|
+
return allowsAddress(inner);
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
return true;
|
|
98
|
+
};
|
|
99
|
+
const matches = (hostname, pattern) => {
|
|
100
|
+
const host = hostname.toLowerCase();
|
|
101
|
+
const rule = pattern.toLowerCase();
|
|
102
|
+
return rule.startsWith('*.') ? host.endsWith(rule.slice(1)) : host === rule;
|
|
103
|
+
};
|
|
104
|
+
const hostOf = (url) => url.hostname.replace(/^\[|\]$/g, '');
|
|
105
|
+
const assertUrl = (url, from) => {
|
|
106
|
+
if (!schemes.includes(url.protocol)) {
|
|
107
|
+
throw new NetworkPolicyError('scheme');
|
|
108
|
+
}
|
|
109
|
+
if ((url.username !== '' || url.password !== '') && options.allowUrlCredentials !== true) {
|
|
110
|
+
throw new NetworkPolicyError('credentials');
|
|
111
|
+
}
|
|
112
|
+
if (from?.protocol === 'https:' && url.protocol === 'http:' && options.allowDowngrade !== true) {
|
|
113
|
+
throw new NetworkPolicyError('downgrade');
|
|
114
|
+
}
|
|
115
|
+
const host = hostOf(url);
|
|
116
|
+
if (options.allowHosts != null && !options.allowHosts.some(pattern => matches(host, pattern))) {
|
|
117
|
+
throw new NetworkPolicyError('blocked-host');
|
|
118
|
+
}
|
|
119
|
+
if (options.denyHosts?.some(pattern => matches(host, pattern)) === true) {
|
|
120
|
+
throw new NetworkPolicyError('blocked-host');
|
|
121
|
+
}
|
|
122
|
+
const port = url.port !== '' ? Number(url.port) : url.protocol === 'https:' ? 443 : 80;
|
|
123
|
+
if (options.ports != null && !options.ports.includes(port)) {
|
|
124
|
+
throw new NetworkPolicyError('port');
|
|
125
|
+
}
|
|
126
|
+
};
|
|
127
|
+
const resolve = async (hostname, signal) => {
|
|
128
|
+
const host = hostname.replace(/^\[|\]$/g, '').toLowerCase();
|
|
129
|
+
const literal = isIP(host);
|
|
130
|
+
let addresses;
|
|
131
|
+
if (literal !== 0) {
|
|
132
|
+
addresses = [{ address: host, family: literal }];
|
|
133
|
+
}
|
|
134
|
+
else {
|
|
135
|
+
const explicitlyAllowed = options.allowHosts?.some(pattern => matches(host, pattern)) === true;
|
|
136
|
+
if (options.allowPrivate !== true && !explicitlyAllowed
|
|
137
|
+
&& DENIED_HOST_SUFFIXES.some(suffix => suffix.startsWith('.') ? host.endsWith(suffix) : host === suffix)) {
|
|
138
|
+
log.warn('Refused an internal host name', { host }, { event: 'file-streams.policy.blocked' });
|
|
139
|
+
throw new NetworkPolicyError('blocked-host');
|
|
140
|
+
}
|
|
141
|
+
try {
|
|
142
|
+
addresses = options.resolver != null
|
|
143
|
+
? await options.resolver(host, signal)
|
|
144
|
+
: (await lookup(host, { all: true, verbatim: true })).map(entry => ({ address: entry.address, family: entry.family }));
|
|
145
|
+
}
|
|
146
|
+
catch (error) {
|
|
147
|
+
if (error instanceof NetworkPolicyError) {
|
|
148
|
+
throw error;
|
|
149
|
+
}
|
|
150
|
+
throw new NetworkPolicyError('unresolvable');
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
if (addresses.length === 0) {
|
|
154
|
+
throw new NetworkPolicyError('unresolvable');
|
|
155
|
+
}
|
|
156
|
+
if (addresses.some(entry => !allowsAddress(entry.address))) {
|
|
157
|
+
log.warn('Refused a blocked address', { host }, { event: 'file-streams.policy.blocked' });
|
|
158
|
+
throw new NetworkPolicyError('blocked-address');
|
|
159
|
+
}
|
|
160
|
+
return addresses;
|
|
161
|
+
};
|
|
162
|
+
return { trustProxyDns: options.trustProxyDns === true, assertUrl, resolve, allowsAddress };
|
|
163
|
+
};
|
|
164
|
+
export const networkPolicy = createNetworkPolicy();
|
|
165
|
+
//# sourceMappingURL=network.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"network.js","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
export declare const DEFAULT_PROXY_RETRIES = 1;
|
|
2
|
+
export declare const DEFAULT_PROXY_COOLDOWN_MS = 30000;
|
|
3
|
+
/** The longest CONNECT reply head a proxy may send. */
|
|
4
|
+
export declare const CONNECT_MAX_HEADER_BYTES: number;
|
|
5
|
+
/** Default ports by proxy type. */
|
|
6
|
+
export declare const DEFAULT_PROXY_PORTS: Readonly<Record<string, number>>;
|
|
7
|
+
//# sourceMappingURL=consts.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../src/proxy/consts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,IAAI,CAAA;AAEtC,eAAO,MAAM,yBAAyB,QAAS,CAAA;AAE/C,uDAAuD;AACvD,eAAO,MAAM,wBAAwB,QAAY,CAAA;AAEjD,mCAAmC;AACnC,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE/D,CAAA"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
export const DEFAULT_PROXY_RETRIES = 1;
|
|
2
|
+
export const DEFAULT_PROXY_COOLDOWN_MS = 30_000;
|
|
3
|
+
/** The longest CONNECT reply head a proxy may send. */
|
|
4
|
+
export const CONNECT_MAX_HEADER_BYTES = 16 * 1024;
|
|
5
|
+
/** Default ports by proxy type. */
|
|
6
|
+
export const DEFAULT_PROXY_PORTS = Object.freeze({
|
|
7
|
+
http: 8080, https: 443, socks4: 1080, socks4a: 1080, socks5: 1080, socks5h: 1080,
|
|
8
|
+
});
|
|
9
|
+
//# sourceMappingURL=consts.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"consts.js","sourceRoot":"","sources":["../../src/proxy/consts.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAA;AAEtC,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAA;AAE/C,uDAAuD;AACvD,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,GAAG,IAAI,CAAA;AAEjD,mCAAmC;AACnC,MAAM,CAAC,MAAM,mBAAmB,GAAqC,MAAM,CAAC,MAAM,CAAC;IACjF,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI;CACjF,CAAC,CAAA"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../../src/proxy/endpoint.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,yEAAyE;AACzE,eAAO,MAAM,kBAAkB,UAAW,aAAa,GAAG,MAAM,KAAG,aAsBlE,CAAA"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import { ProxyError } from '../errors.js';
|
|
2
|
+
import { DEFAULT_PROXY_PORTS } from './consts.js';
|
|
3
|
+
/** A proxy URL (`socks5h://user:pass@host:1080`) read as an endpoint. */
|
|
4
|
+
export const parseProxyEndpoint = (value) => {
|
|
5
|
+
if (typeof value !== 'string') {
|
|
6
|
+
return value;
|
|
7
|
+
}
|
|
8
|
+
let url;
|
|
9
|
+
try {
|
|
10
|
+
url = new URL(value);
|
|
11
|
+
}
|
|
12
|
+
catch {
|
|
13
|
+
throw new ProxyError('endpoint');
|
|
14
|
+
}
|
|
15
|
+
const type = url.protocol.replace(/:$/, '').toLowerCase();
|
|
16
|
+
const port = url.port !== '' ? Number(url.port) : DEFAULT_PROXY_PORTS[type];
|
|
17
|
+
if (url.hostname === '' || port == null) {
|
|
18
|
+
throw new ProxyError('endpoint');
|
|
19
|
+
}
|
|
20
|
+
const endpoint = { type, host: url.hostname.replace(/^\[|\]$/g, ''), port };
|
|
21
|
+
if (url.username !== '') {
|
|
22
|
+
endpoint.username = decodeURIComponent(url.username);
|
|
23
|
+
endpoint.password = decodeURIComponent(url.password);
|
|
24
|
+
}
|
|
25
|
+
return endpoint;
|
|
26
|
+
};
|
|
27
|
+
//# sourceMappingURL=endpoint.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"endpoint.js","sourceRoot":"","sources":["../../src/proxy/endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAGjD,yEAAyE;AACzE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAA6B,EAAiB,EAAE;IACjF,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAA;IACd,CAAC;IACD,IAAI,GAAQ,CAAA;IACZ,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAA;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,UAAU,CAAC,UAAU,CAAC,CAAA;IAClC,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;IACzD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAA;IAC3E,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QACxC,MAAM,IAAI,UAAU,CAAC,UAAU,CAAC,CAAA;IAClC,CAAC;IACD,MAAM,QAAQ,GAAkB,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAA;IAC1F,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE,EAAE,CAAC;QACxB,QAAQ,CAAC,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACpD,QAAQ,CAAC,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACtD,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA"}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import type { HttpProxyPluginOptions, ProxyPlugin } from './types.js';
|
|
2
|
+
/** HTTP(S) proxies: CONNECT tunnels, and forward mode for plain-http targets. */
|
|
3
|
+
export declare const createHttpProxyPlugin: (options?: HttpProxyPluginOptions) => ProxyPlugin;
|
|
4
|
+
export declare const httpProxyPlugin: ProxyPlugin;
|
|
5
|
+
//# sourceMappingURL=http.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/proxy/http.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,sBAAsB,EAAuD,WAAW,EAAgB,MAAM,YAAY,CAAA;AAExI,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,aAAa,sBAAsB,KAAQ,WAgG5E,CAAA;AAED,eAAO,MAAM,eAAe,aAA0B,CAAA"}
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
import { connect as connectTcp } from 'node:net';
|
|
2
|
+
import { connect as connectTls } from 'node:tls';
|
|
3
|
+
import { ProxyError } from '../errors.js';
|
|
4
|
+
import { signalUtils } from '../utils/signals.js';
|
|
5
|
+
import { CONNECT_MAX_HEADER_BYTES } from './consts.js';
|
|
6
|
+
/** HTTP(S) proxies: CONNECT tunnels, and forward mode for plain-http targets. */
|
|
7
|
+
export const createHttpProxyPlugin = (options = {}) => {
|
|
8
|
+
const authorization = (endpoint) => endpoint.username != null
|
|
9
|
+
? `Basic ${Buffer.from(`${endpoint.username}:${endpoint.password ?? ''}`).toString('base64')}`
|
|
10
|
+
: undefined;
|
|
11
|
+
const open = (endpoint, context) => new Promise((resolve, reject) => {
|
|
12
|
+
const socket = endpoint.type === 'https'
|
|
13
|
+
? connectTls({ host: endpoint.host, port: endpoint.port, servername: endpoint.host, ca: options.ca, minVersion: 'TLSv1.2' })
|
|
14
|
+
: connectTcp({ host: endpoint.host, port: endpoint.port });
|
|
15
|
+
const timer = setTimeout(() => fail(new ProxyError('connect')), context.timeoutMs);
|
|
16
|
+
const release = signalUtils.onAbort(context.signal, reason => fail(reason));
|
|
17
|
+
const done = () => {
|
|
18
|
+
clearTimeout(timer);
|
|
19
|
+
release();
|
|
20
|
+
socket.removeListener('error', fail);
|
|
21
|
+
};
|
|
22
|
+
function fail(error) {
|
|
23
|
+
done();
|
|
24
|
+
socket.destroy();
|
|
25
|
+
reject(error instanceof ProxyError || context.signal?.aborted === true ? error : new ProxyError('connect'));
|
|
26
|
+
}
|
|
27
|
+
socket.once(endpoint.type === 'https' ? 'secureConnect' : 'connect', () => {
|
|
28
|
+
done();
|
|
29
|
+
resolve(socket);
|
|
30
|
+
});
|
|
31
|
+
socket.once('error', fail);
|
|
32
|
+
});
|
|
33
|
+
const tunnel = (socket, endpoint, target, context) => new Promise((resolve, reject) => {
|
|
34
|
+
const authority = target.host.includes(':') ? `[${target.host}]:${target.port}` : `${target.host}:${target.port}`;
|
|
35
|
+
const auth = authorization(endpoint);
|
|
36
|
+
const chunks = [];
|
|
37
|
+
let length = 0;
|
|
38
|
+
const timer = setTimeout(() => fail(new ProxyError('handshake')), context.timeoutMs);
|
|
39
|
+
const release = signalUtils.onAbort(context.signal, reason => fail(reason));
|
|
40
|
+
const cleanup = () => {
|
|
41
|
+
clearTimeout(timer);
|
|
42
|
+
release();
|
|
43
|
+
socket.removeListener('data', onData);
|
|
44
|
+
socket.removeListener('error', onError);
|
|
45
|
+
socket.removeListener('close', onClose);
|
|
46
|
+
};
|
|
47
|
+
function fail(error) {
|
|
48
|
+
cleanup();
|
|
49
|
+
socket.destroy();
|
|
50
|
+
reject(error);
|
|
51
|
+
}
|
|
52
|
+
const onError = () => fail(new ProxyError('handshake'));
|
|
53
|
+
const onClose = () => fail(new ProxyError('handshake'));
|
|
54
|
+
function onData(chunk) {
|
|
55
|
+
chunks.push(chunk);
|
|
56
|
+
length += chunk.length;
|
|
57
|
+
const buffer = Buffer.concat(chunks, length);
|
|
58
|
+
const end = buffer.indexOf('\r\n\r\n');
|
|
59
|
+
if (end === -1) {
|
|
60
|
+
if (length > CONNECT_MAX_HEADER_BYTES) {
|
|
61
|
+
fail(new ProxyError('handshake'));
|
|
62
|
+
}
|
|
63
|
+
return;
|
|
64
|
+
}
|
|
65
|
+
cleanup();
|
|
66
|
+
const status = Number(/^HTTP\/1\.[01] (\d{3})/.exec(buffer.subarray(0, end).toString('latin1'))?.[1]);
|
|
67
|
+
if (status === 200) {
|
|
68
|
+
const rest = buffer.subarray(end + 4);
|
|
69
|
+
if (rest.length > 0) {
|
|
70
|
+
socket.unshift(rest);
|
|
71
|
+
}
|
|
72
|
+
resolve();
|
|
73
|
+
return;
|
|
74
|
+
}
|
|
75
|
+
socket.destroy();
|
|
76
|
+
reject(new ProxyError(status === 407 ? 'auth-failed' : `refused:${Number.isNaN(status) ? 'invalid' : status}`));
|
|
77
|
+
}
|
|
78
|
+
socket.on('data', onData);
|
|
79
|
+
socket.once('error', onError);
|
|
80
|
+
socket.once('close', onClose);
|
|
81
|
+
socket.write(`CONNECT ${authority} HTTP/1.1\r\nHost: ${authority}\r\n${auth != null ? `Proxy-Authorization: ${auth}\r\n` : ''}\r\n`);
|
|
82
|
+
});
|
|
83
|
+
const connect = async (endpoint, target, context) => {
|
|
84
|
+
const socket = await open(endpoint, context);
|
|
85
|
+
if (!target.secure && options.httpTargets !== 'connect') {
|
|
86
|
+
const auth = authorization(endpoint);
|
|
87
|
+
return { socket, mode: 'forward', headers: auth != null ? { 'proxy-authorization': auth } : undefined };
|
|
88
|
+
}
|
|
89
|
+
await tunnel(socket, endpoint, target, context);
|
|
90
|
+
return { socket, mode: 'tunnel' };
|
|
91
|
+
};
|
|
92
|
+
return { types: ['http', 'https'], remoteDns: () => options.remoteDns === true, connect };
|
|
93
|
+
};
|
|
94
|
+
export const httpProxyPlugin = createHttpProxyPlugin();
|
|
95
|
+
//# sourceMappingURL=http.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/proxy/http.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { ProxyRouter, ProxyRouterOptions } from './types.js';
|
|
2
|
+
/** Chooses a proxy per connection from a list (with a strategy) or a provider callback. */
|
|
3
|
+
export declare const createProxyRouter: (options?: ProxyRouterOptions) => ProxyRouter;
|
|
4
|
+
//# sourceMappingURL=router.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/proxy/router.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAA+B,WAAW,EAAE,kBAAkB,EAAkB,MAAM,YAAY,CAAA;AAI9G,2FAA2F;AAC3F,eAAO,MAAM,iBAAiB,aAAa,kBAAkB,KAAQ,WA+EpE,CAAA"}
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
import { createHash } from 'node:crypto';
|
|
2
|
+
import { logger } from '@owlmeans/log';
|
|
3
|
+
import { ProxyError } from '../errors.js';
|
|
4
|
+
import { redactUtils } from '../utils/redact.js';
|
|
5
|
+
import { DEFAULT_PROXY_COOLDOWN_MS, DEFAULT_PROXY_RETRIES } from './consts.js';
|
|
6
|
+
import { parseProxyEndpoint } from './endpoint.js';
|
|
7
|
+
import { httpProxyPlugin } from './http.js';
|
|
8
|
+
import { socksProxyPlugin } from './socks.js';
|
|
9
|
+
const log = logger('file-streams:proxy');
|
|
10
|
+
/** Chooses a proxy per connection from a list (with a strategy) or a provider callback. */
|
|
11
|
+
export const createProxyRouter = (options = {}) => {
|
|
12
|
+
const plugins = [...(options.plugins ?? []), httpProxyPlugin, socksProxyPlugin];
|
|
13
|
+
const list = Array.isArray(options.proxies) ? options.proxies.map(parseProxyEndpoint) : undefined;
|
|
14
|
+
const cooldownMs = options.cooldownMs ?? DEFAULT_PROXY_COOLDOWN_MS;
|
|
15
|
+
const cooling = new Map();
|
|
16
|
+
let cursor = 0;
|
|
17
|
+
const idOf = (endpoint) => redactUtils.proxy(endpoint);
|
|
18
|
+
const bypassed = (url) => {
|
|
19
|
+
const host = url.hostname.replace(/^\[|\]$/g, '').toLowerCase();
|
|
20
|
+
return options.bypass?.some(rule => {
|
|
21
|
+
const pattern = rule.toLowerCase();
|
|
22
|
+
return pattern.startsWith('*.') ? host.endsWith(pattern.slice(1)) : host === pattern;
|
|
23
|
+
}) === true;
|
|
24
|
+
};
|
|
25
|
+
const fromList = (members, request) => {
|
|
26
|
+
const now = Date.now();
|
|
27
|
+
const warm = members.filter(member => (cooling.get(idOf(member)) ?? 0) <= now);
|
|
28
|
+
const pool = warm.length > 0 ? warm : members;
|
|
29
|
+
switch (options.strategy) {
|
|
30
|
+
case 'random':
|
|
31
|
+
return pool[Math.floor(Math.random() * pool.length)];
|
|
32
|
+
case 'failover':
|
|
33
|
+
return pool[0];
|
|
34
|
+
case 'by-key':
|
|
35
|
+
if (request.key != null) {
|
|
36
|
+
const index = createHash('sha256').update(request.key).digest().readUInt32BE(0) % members.length;
|
|
37
|
+
const sticky = members[index];
|
|
38
|
+
return pool.includes(sticky) ? sticky : pool[index % pool.length];
|
|
39
|
+
}
|
|
40
|
+
return pool[cursor++ % pool.length];
|
|
41
|
+
default:
|
|
42
|
+
return pool[cursor++ % pool.length];
|
|
43
|
+
}
|
|
44
|
+
};
|
|
45
|
+
const select = async (request) => {
|
|
46
|
+
if (options.proxies == null || bypassed(request.url)) {
|
|
47
|
+
return null;
|
|
48
|
+
}
|
|
49
|
+
let endpoint;
|
|
50
|
+
if (list != null) {
|
|
51
|
+
if (list.length === 0) {
|
|
52
|
+
return null;
|
|
53
|
+
}
|
|
54
|
+
endpoint = fromList(list, request);
|
|
55
|
+
}
|
|
56
|
+
else {
|
|
57
|
+
const provided = await options.proxies(request);
|
|
58
|
+
if (provided == null) {
|
|
59
|
+
return null;
|
|
60
|
+
}
|
|
61
|
+
endpoint = parseProxyEndpoint(provided);
|
|
62
|
+
}
|
|
63
|
+
if (endpoint.username == null && options.credentials != null) {
|
|
64
|
+
const credentials = await options.credentials(endpoint, request);
|
|
65
|
+
if (credentials != null) {
|
|
66
|
+
endpoint = { ...endpoint, username: credentials.username, password: credentials.password };
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
const plugin = plugins.find(candidate => candidate.types.includes(endpoint.type));
|
|
70
|
+
if (plugin == null) {
|
|
71
|
+
throw new ProxyError('no-plugin');
|
|
72
|
+
}
|
|
73
|
+
return { endpoint, plugin };
|
|
74
|
+
};
|
|
75
|
+
const report = (endpoint, ok) => {
|
|
76
|
+
if (ok) {
|
|
77
|
+
cooling.delete(idOf(endpoint));
|
|
78
|
+
return;
|
|
79
|
+
}
|
|
80
|
+
cooling.set(idOf(endpoint), Date.now() + cooldownMs);
|
|
81
|
+
log.warn('Proxy failed, cooling down', { proxy: idOf(endpoint), cooldownMs });
|
|
82
|
+
};
|
|
83
|
+
return { retries: options.retries ?? DEFAULT_PROXY_RETRIES, select, report };
|
|
84
|
+
};
|
|
85
|
+
//# sourceMappingURL=router.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/proxy/router.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import type { ProxyPlugin, SocksProxyPluginOptions } from './types.js';
|
|
2
|
+
/** SOCKS4, SOCKS4a, SOCKS5 and SOCKS5h proxies, with user/password authentication. */
|
|
3
|
+
export declare const createSocksProxyPlugin: (options?: SocksProxyPluginOptions) => ProxyPlugin;
|
|
4
|
+
export declare const socksProxyPlugin: ProxyPlugin;
|
|
5
|
+
//# sourceMappingURL=socks.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"socks.d.ts","sourceRoot":"","sources":["../../src/proxy/socks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAuD,WAAW,EAAE,uBAAuB,EAAgB,MAAM,YAAY,CAAA;AAEzI,sFAAsF;AACtF,eAAO,MAAM,sBAAsB,aAAa,uBAAuB,KAAQ,WAuC9E,CAAA;AAED,eAAO,MAAM,gBAAgB,aAA2B,CAAA"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import { SocksClient } from 'socks';
|
|
2
|
+
import { ProxyError } from '../errors.js';
|
|
3
|
+
import { signalUtils } from '../utils/signals.js';
|
|
4
|
+
/** SOCKS4, SOCKS4a, SOCKS5 and SOCKS5h proxies, with user/password authentication. */
|
|
5
|
+
export const createSocksProxyPlugin = (options = {}) => {
|
|
6
|
+
const remoteDns = (endpoint) => endpoint.type === 'socks5h' || endpoint.type === 'socks4a' || options.remoteDns === true;
|
|
7
|
+
const connect = async (endpoint, target, context) => {
|
|
8
|
+
signalUtils.throwIfAborted(context.signal);
|
|
9
|
+
const pending = SocksClient.createConnection({
|
|
10
|
+
command: 'connect',
|
|
11
|
+
destination: { host: target.host, port: target.port },
|
|
12
|
+
proxy: {
|
|
13
|
+
host: endpoint.host,
|
|
14
|
+
port: endpoint.port,
|
|
15
|
+
type: endpoint.type.startsWith('socks4') ? 4 : 5,
|
|
16
|
+
userId: endpoint.username,
|
|
17
|
+
password: endpoint.password,
|
|
18
|
+
},
|
|
19
|
+
timeout: context.timeoutMs,
|
|
20
|
+
});
|
|
21
|
+
let release = () => undefined;
|
|
22
|
+
const aborted = new Promise((_resolve, reject) => {
|
|
23
|
+
release = signalUtils.onAbort(context.signal, reason => reject(reason));
|
|
24
|
+
});
|
|
25
|
+
try {
|
|
26
|
+
const { socket } = await Promise.race([pending, aborted]);
|
|
27
|
+
return { socket, mode: 'tunnel' };
|
|
28
|
+
}
|
|
29
|
+
catch (error) {
|
|
30
|
+
pending.then(({ socket }) => socket.destroy(), () => undefined);
|
|
31
|
+
if (context.signal?.aborted === true) {
|
|
32
|
+
throw error;
|
|
33
|
+
}
|
|
34
|
+
const message = error.message ?? '';
|
|
35
|
+
throw new ProxyError(/auth/i.test(message) ? 'auth-failed' : /rejected|refused|failed/i.test(message) ? 'refused:socks' : 'connect');
|
|
36
|
+
}
|
|
37
|
+
finally {
|
|
38
|
+
release();
|
|
39
|
+
}
|
|
40
|
+
};
|
|
41
|
+
return { types: ['socks4', 'socks4a', 'socks5', 'socks5h'], remoteDns, connect };
|
|
42
|
+
};
|
|
43
|
+
export const socksProxyPlugin = createSocksProxyPlugin();
|
|
44
|
+
//# sourceMappingURL=socks.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"socks.js","sourceRoot":"","sources":["../../src/proxy/socks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAGjD,sFAAsF;AACtF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,OAAO,GAA4B,EAAE,EAAe,EAAE;IAC3F,MAAM,SAAS,GAAG,CAAC,QAAuB,EAAW,EAAE,CACrD,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,KAAK,IAAI,CAAA;IAE1F,MAAM,OAAO,GAAG,KAAK,EAAE,QAAuB,EAAE,MAAoB,EAAE,OAA4B,EAA4B,EAAE;QAC9H,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAC1C,MAAM,OAAO,GAAG,WAAW,CAAC,gBAAgB,CAAC;YAC3C,OAAO,EAAE,SAAS;YAClB,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;YACrD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAChD,MAAM,EAAE,QAAQ,CAAC,QAAQ;gBACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;aAC5B;YACD,OAAO,EAAE,OAAO,CAAC,SAAS;SAC3B,CAAC,CAAA;QAEF,IAAI,OAAO,GAAG,GAAS,EAAE,CAAC,SAAS,CAAA;QACnC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;YACtD,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAA;QACzE,CAAC,CAAC,CAAA;QACF,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;YACzD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;YAC/D,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrC,MAAM,KAAK,CAAA;YACb,CAAC;YACD,MAAM,OAAO,GAAI,KAAe,CAAC,OAAO,IAAI,EAAE,CAAA;YAC9C,MAAM,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;QACtI,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAA;QACX,CAAC;IACH,CAAC,CAAA;IAED,OAAO,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAA;AAClF,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,EAAE,CAAA"}
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
import type { Duplex } from 'node:stream';
|
|
2
|
+
/** One proxy. `type` names the plugin that speaks to it. */
|
|
3
|
+
export interface ProxyEndpoint {
|
|
4
|
+
/** `http`, `https`, `socks4`, `socks4a`, `socks5`, `socks5h`, or a custom plugin's type. */
|
|
5
|
+
type: string;
|
|
6
|
+
host: string;
|
|
7
|
+
port: number;
|
|
8
|
+
username?: string;
|
|
9
|
+
password?: string;
|
|
10
|
+
/** A credential-free name for logs; default `<type>://<host>:<port>`. */
|
|
11
|
+
id?: string;
|
|
12
|
+
}
|
|
13
|
+
export interface ProxyCredentials {
|
|
14
|
+
username: string;
|
|
15
|
+
password: string;
|
|
16
|
+
}
|
|
17
|
+
/** What a proxy is chosen for: the caller's routing key and the URL. */
|
|
18
|
+
export interface ProxyRequest {
|
|
19
|
+
key?: string;
|
|
20
|
+
url: URL;
|
|
21
|
+
}
|
|
22
|
+
/** A pool as a callback: the proxy (credentials included) for a key and a URL, or nothing to go direct. */
|
|
23
|
+
export interface ProxyProvider {
|
|
24
|
+
(request: ProxyRequest): ProxyEndpoint | string | null | undefined | Promise<ProxyEndpoint | string | null | undefined>;
|
|
25
|
+
}
|
|
26
|
+
/** Credentials for a chosen endpoint that carries none (a per-key session user, a vault lookup). */
|
|
27
|
+
export interface ProxyCredentialsProvider {
|
|
28
|
+
(endpoint: ProxyEndpoint, request: ProxyRequest): ProxyCredentials | null | undefined | Promise<ProxyCredentials | null | undefined>;
|
|
29
|
+
}
|
|
30
|
+
/** How a list of proxies is walked. */
|
|
31
|
+
export type ProxyStrategy = 'round-robin' | 'random' | 'failover' | 'by-key';
|
|
32
|
+
export interface ProxyRouterOptions {
|
|
33
|
+
/** Endpoints or URLs (`socks5h://user:pass@egress:1080`), or a provider callback. */
|
|
34
|
+
proxies?: Array<ProxyEndpoint | string> | ProxyProvider;
|
|
35
|
+
credentials?: ProxyCredentialsProvider;
|
|
36
|
+
/** Default `round-robin`; `by-key` keeps one key on one proxy. */
|
|
37
|
+
strategy?: ProxyStrategy;
|
|
38
|
+
/** Hosts (`x.com`, `*.x.com`) never proxied. */
|
|
39
|
+
bypass?: string[];
|
|
40
|
+
/** Plugins tried before the built-in http and socks ones. */
|
|
41
|
+
plugins?: ProxyPlugin[];
|
|
42
|
+
/** Further proxies tried after a failed connect. Default 1. */
|
|
43
|
+
retries?: number;
|
|
44
|
+
/** How long a failed proxy is skipped. Default 30 000 ms. */
|
|
45
|
+
cooldownMs?: number;
|
|
46
|
+
}
|
|
47
|
+
export interface ProxySelection {
|
|
48
|
+
endpoint: ProxyEndpoint;
|
|
49
|
+
plugin: ProxyPlugin;
|
|
50
|
+
}
|
|
51
|
+
/** Chooses the proxy of each connection. */
|
|
52
|
+
export interface ProxyRouter {
|
|
53
|
+
/** Further attempts after a failed connect. */
|
|
54
|
+
readonly retries: number;
|
|
55
|
+
/** The proxy for a request, or `null` to connect directly. */
|
|
56
|
+
select: (request: ProxyRequest) => Promise<ProxySelection | null>;
|
|
57
|
+
/** How a connect through `endpoint` went; failures cool it down. */
|
|
58
|
+
report: (endpoint: ProxyEndpoint, ok: boolean) => void;
|
|
59
|
+
}
|
|
60
|
+
export interface TunnelTarget {
|
|
61
|
+
/** The checked IP, or the host name when the proxy resolves it. */
|
|
62
|
+
host: string;
|
|
63
|
+
port: number;
|
|
64
|
+
/** The host name (SNI, `Host`). */
|
|
65
|
+
hostname: string;
|
|
66
|
+
/** TLS rides inside the tunnel; a plugin never terminates it. */
|
|
67
|
+
secure: boolean;
|
|
68
|
+
}
|
|
69
|
+
export interface ProxyConnectContext {
|
|
70
|
+
signal?: AbortSignal;
|
|
71
|
+
timeoutMs: number;
|
|
72
|
+
}
|
|
73
|
+
export interface ProxyConnection {
|
|
74
|
+
socket: Duplex;
|
|
75
|
+
/** `forward`: absolute-form plain HTTP through the proxy (http targets only). */
|
|
76
|
+
mode: 'tunnel' | 'forward';
|
|
77
|
+
/** Headers a forward-mode request carries (`Proxy-Authorization`). */
|
|
78
|
+
headers?: Record<string, string>;
|
|
79
|
+
}
|
|
80
|
+
/** Speaks one or more proxy protocols. */
|
|
81
|
+
export interface ProxyPlugin {
|
|
82
|
+
readonly types: string[];
|
|
83
|
+
/** Whether the proxy resolves names itself for this endpoint. */
|
|
84
|
+
remoteDns: (endpoint: ProxyEndpoint) => boolean;
|
|
85
|
+
connect: (endpoint: ProxyEndpoint, target: TunnelTarget, context: ProxyConnectContext) => Promise<ProxyConnection>;
|
|
86
|
+
}
|
|
87
|
+
export interface HttpProxyPluginOptions {
|
|
88
|
+
/** How plain-http targets travel. Default `forward` (proxies often refuse CONNECT to port 80). */
|
|
89
|
+
httpTargets?: 'forward' | 'connect';
|
|
90
|
+
/** Put the host name, not the checked IP, in CONNECT. Default `false`. */
|
|
91
|
+
remoteDns?: boolean;
|
|
92
|
+
/** Extra CAs for `https` proxy endpoints. */
|
|
93
|
+
ca?: string | string[];
|
|
94
|
+
}
|
|
95
|
+
export interface SocksProxyPluginOptions {
|
|
96
|
+
/** Let socks4/socks5 endpoints resolve names too; socks4a/socks5h always do. Default `false`. */
|
|
97
|
+
remoteDns?: boolean;
|
|
98
|
+
}
|
|
99
|
+
//# sourceMappingURL=types.d.ts.map
|