@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
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"workload.js","sourceRoot":"","sources":["../../src/sources/workload.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import type { TransferLimits } from './types.js';
|
|
2
|
+
export declare const DEFAULT_TRANSFER_LIMITS: Readonly<TransferLimits>;
|
|
3
|
+
/** The name a file is written under when nothing names it. */
|
|
4
|
+
export declare const FALLBACK_FILE_NAME = "download";
|
|
5
|
+
//# sourceMappingURL=consts.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../src/transfer/consts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,cAAc,CAI3D,CAAA;AAEF,8DAA8D;AAC9D,eAAO,MAAM,kBAAkB,aAAa,CAAA"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
export const DEFAULT_TRANSFER_LIMITS = Object.freeze({
|
|
2
|
+
maxBytes: 512 * 1024 * 1024,
|
|
3
|
+
timeoutMs: 600_000,
|
|
4
|
+
idleTimeoutMs: 30_000,
|
|
5
|
+
});
|
|
6
|
+
/** The name a file is written under when nothing names it. */
|
|
7
|
+
export const FALLBACK_FILE_NAME = 'download';
|
|
8
|
+
//# sourceMappingURL=consts.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"consts.js","sourceRoot":"","sources":["../../src/transfer/consts.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,uBAAuB,GAA6B,MAAM,CAAC,MAAM,CAAC;IAC7E,QAAQ,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI;IAC3B,SAAS,EAAE,OAAO;IAClB,aAAa,EAAE,MAAM;CACtB,CAAC,CAAA;AAEF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAA"}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
import type { FileInspector, FileVerdict, VerifyPolicy } from '@owlmeans/file-inspector';
|
|
2
|
+
import type { FileInfo, FileSink, FileSource, SignalOptions, SinkResult, TreeSink } from '../types.js';
|
|
3
|
+
export interface TransferLimits {
|
|
4
|
+
/** Bytes accepted, counted after content decoding. Default 512 MiB. */
|
|
5
|
+
maxBytes: number;
|
|
6
|
+
/** Whole-transfer deadline. Default 600 000 ms. */
|
|
7
|
+
timeoutMs: number;
|
|
8
|
+
/** Longest silence between chunks. Default 30 000 ms. */
|
|
9
|
+
idleTimeoutMs: number;
|
|
10
|
+
}
|
|
11
|
+
export interface TransferProgress {
|
|
12
|
+
bytes: number;
|
|
13
|
+
total?: number;
|
|
14
|
+
elapsedMs: number;
|
|
15
|
+
}
|
|
16
|
+
export interface TransferProgressListener {
|
|
17
|
+
(progress: TransferProgress): void;
|
|
18
|
+
}
|
|
19
|
+
export interface TransferOptions extends SignalOptions {
|
|
20
|
+
limits?: Partial<TransferLimits>;
|
|
21
|
+
/** Head verification before the first byte reaches the sink. Default `{}` (on); `false` skips it. */
|
|
22
|
+
verify?: VerifyPolicy | false;
|
|
23
|
+
onProgress?: TransferProgressListener;
|
|
24
|
+
/** Default 250 ms; a final call always fires. */
|
|
25
|
+
progressIntervalMs?: number;
|
|
26
|
+
hash?: 'sha256';
|
|
27
|
+
/** Overrides of the source's claims (a target name, a known media type). */
|
|
28
|
+
info?: Partial<Omit<FileInfo, 'origin'>>;
|
|
29
|
+
}
|
|
30
|
+
export interface TransferResult {
|
|
31
|
+
bytes: number;
|
|
32
|
+
durationMs: number;
|
|
33
|
+
info: FileInfo;
|
|
34
|
+
verdict?: FileVerdict;
|
|
35
|
+
sha256?: string;
|
|
36
|
+
sink: SinkResult;
|
|
37
|
+
}
|
|
38
|
+
export interface TransferHelperOptions {
|
|
39
|
+
inspector?: FileInspector;
|
|
40
|
+
limits?: Partial<TransferLimits>;
|
|
41
|
+
}
|
|
42
|
+
/** Moves one file from a source to a sink under limits, verifying it on the way. */
|
|
43
|
+
export interface TransferHelper {
|
|
44
|
+
/** Source → sink; the head is verified before the sink sees a byte unless `verify: false`. */
|
|
45
|
+
copy: (source: FileSource, sink: FileSink, options?: TransferOptions) => Promise<TransferResult>;
|
|
46
|
+
/** The same into a tree, under the source's own sanitized name (or `options.info.name`). */
|
|
47
|
+
copyInto: (source: FileSource, tree: TreeSink, options?: TransferOptions) => Promise<TransferResult>;
|
|
48
|
+
}
|
|
49
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/transfer/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACxF,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEtG,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAA;IAChB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAA;IACjB,yDAAyD;IACzD,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAA;CACnC;AAED,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IAChC,qGAAqG;IACrG,MAAM,CAAC,EAAE,YAAY,GAAG,KAAK,CAAA;IAC7B,UAAU,CAAC,EAAE,wBAAwB,CAAA;IACrC,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,4EAA4E;IAC5E,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAA;CACzC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,UAAU,CAAA;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,aAAa,CAAA;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;CACjC;AAED,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,8FAA8F;IAC9F,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;IAChG,4FAA4F;IAC5F,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;CACrG"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/transfer/types.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { TransferHelper, TransferHelperOptions } from './transfer/types.js';
|
|
2
|
+
export declare const createTransferHelper: (options?: TransferHelperOptions) => TransferHelper;
|
|
3
|
+
export declare const transferHelper: TransferHelper;
|
|
4
|
+
//# sourceMappingURL=transfer.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"transfer.d.ts","sourceRoot":"","sources":["../src/transfer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAmC,MAAM,qBAAqB,CAAA;AAQjH,eAAO,MAAM,oBAAoB,aAAa,qBAAqB,KAAQ,cAuE1E,CAAA;AAED,eAAO,MAAM,cAAc,gBAAyB,CAAA"}
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
import { pipeline } from 'node:stream';
|
|
2
|
+
import { logger } from '@owlmeans/log';
|
|
3
|
+
import { DEFAULT_SAMPLE_BYTES, fileInspector } from '@owlmeans/file-inspector';
|
|
4
|
+
import { LimitError } from './errors.js';
|
|
5
|
+
import { DEFAULT_TRANSFER_LIMITS, FALLBACK_FILE_NAME } from './transfer/consts.js';
|
|
6
|
+
import { nameUtils } from './utils/names.js';
|
|
7
|
+
import { signalUtils } from './utils/signals.js';
|
|
8
|
+
import { streamUtils } from './utils/streams.js';
|
|
9
|
+
const log = logger('file-streams:transfer');
|
|
10
|
+
export const createTransferHelper = (options = {}) => {
|
|
11
|
+
const inspector = options.inspector ?? fileInspector;
|
|
12
|
+
const run = async (source, sinkOf, transferOptions = {}) => {
|
|
13
|
+
const limits = { ...DEFAULT_TRANSFER_LIMITS, ...options.limits, ...transferOptions.limits };
|
|
14
|
+
const composed = signalUtils.compose([transferOptions.signal], limits.timeoutMs);
|
|
15
|
+
const signal = composed.signal;
|
|
16
|
+
const started = Date.now();
|
|
17
|
+
let stream;
|
|
18
|
+
try {
|
|
19
|
+
const opened = await source.open({ signal });
|
|
20
|
+
const info = { ...opened.info, ...transferOptions.info };
|
|
21
|
+
if (transferOptions.info?.name != null) {
|
|
22
|
+
info.name = nameUtils.sanitize(transferOptions.info.name);
|
|
23
|
+
}
|
|
24
|
+
if (info.size != null && info.size > limits.maxBytes) {
|
|
25
|
+
streamUtils.discard(opened.stream);
|
|
26
|
+
throw new LimitError('max-bytes');
|
|
27
|
+
}
|
|
28
|
+
const meter = streamUtils.meter({
|
|
29
|
+
maxBytes: limits.maxBytes,
|
|
30
|
+
idleTimeoutMs: limits.idleTimeoutMs,
|
|
31
|
+
total: info.size,
|
|
32
|
+
onProgress: transferOptions.onProgress,
|
|
33
|
+
progressIntervalMs: transferOptions.progressIntervalMs,
|
|
34
|
+
hash: transferOptions.hash,
|
|
35
|
+
});
|
|
36
|
+
stream = pipeline(opened.stream, meter.stream, () => undefined);
|
|
37
|
+
const current = stream;
|
|
38
|
+
const release = signalUtils.onAbort(signal, reason => current.destroy(reason));
|
|
39
|
+
try {
|
|
40
|
+
let verdict;
|
|
41
|
+
if (transferOptions.verify !== false) {
|
|
42
|
+
const policy = transferOptions.verify ?? {};
|
|
43
|
+
const peeked = await streamUtils.peek(stream, policy.sampleBytes ?? DEFAULT_SAMPLE_BYTES);
|
|
44
|
+
stream = peeked.stream;
|
|
45
|
+
verdict = inspector.enforce(await inspector.inspect(peeked.head, { name: info.name, mime: info.mime }, { complete: peeked.ended }), policy);
|
|
46
|
+
}
|
|
47
|
+
const sink = await sinkOf(info).write({ stream, info, verdict }, { signal, maxBytes: limits.maxBytes });
|
|
48
|
+
const result = { bytes: meter.bytes(), durationMs: Date.now() - started, info, verdict, sink };
|
|
49
|
+
const digest = meter.sha256();
|
|
50
|
+
if (digest != null) {
|
|
51
|
+
result.sha256 = digest;
|
|
52
|
+
}
|
|
53
|
+
log.debug('Transferred', { origin: info.origin, bytes: result.bytes, sink: sink.kind });
|
|
54
|
+
return result;
|
|
55
|
+
}
|
|
56
|
+
finally {
|
|
57
|
+
release();
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
catch (error) {
|
|
61
|
+
if (stream != null) {
|
|
62
|
+
streamUtils.discard(stream);
|
|
63
|
+
}
|
|
64
|
+
throw signal.aborted && signal.reason != null ? signal.reason : error;
|
|
65
|
+
}
|
|
66
|
+
finally {
|
|
67
|
+
composed.dispose();
|
|
68
|
+
}
|
|
69
|
+
};
|
|
70
|
+
const copy = async (source, sink, transferOptions) => await run(source, () => sink, transferOptions);
|
|
71
|
+
const copyInto = async (source, tree, transferOptions) => await run(source, info => tree.entry(info.name ?? FALLBACK_FILE_NAME), transferOptions);
|
|
72
|
+
return { copy, copyInto };
|
|
73
|
+
};
|
|
74
|
+
export const transferHelper = createTransferHelper();
|
|
75
|
+
//# sourceMappingURL=transfer.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"transfer.js","sourceRoot":"","sources":["../src/transfer.ts"],"names":[],"mappings":"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"}
|
package/build/types.d.ts
ADDED
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
import type { Readable } from 'node:stream';
|
|
2
|
+
import type { FileVerdict } from '@owlmeans/file-inspector';
|
|
3
|
+
/** What is known about a file. Every field is a claim until a verdict confirms it. */
|
|
4
|
+
export interface FileInfo {
|
|
5
|
+
/**
|
|
6
|
+
* Redacted origin for logs and results: `https://host/path` (no userinfo, query or fragment;
|
|
7
|
+
* long opaque segments masked), `s3://bucket/key`, a filesystem path, or `buffer`.
|
|
8
|
+
*/
|
|
9
|
+
origin: string;
|
|
10
|
+
/** A safe base name — from Content-Disposition, the URL's last segment, the key, or the caller. */
|
|
11
|
+
name?: string;
|
|
12
|
+
/** Declared bytes. Never trusted as a limit: counted bytes are. */
|
|
13
|
+
size?: number;
|
|
14
|
+
/** Declared media type, lower-cased, without parameters; uninformative ones are dropped. */
|
|
15
|
+
mime?: string;
|
|
16
|
+
/** A strong validator (ETag, `<mtimeMs>-<size>`); range reads refuse an origin that changed. */
|
|
17
|
+
etag?: string;
|
|
18
|
+
modifiedAt?: Date;
|
|
19
|
+
}
|
|
20
|
+
/** A byte span, `end` inclusive like HTTP; no `end` means to the last byte. */
|
|
21
|
+
export interface ByteRange {
|
|
22
|
+
start: number;
|
|
23
|
+
end?: number;
|
|
24
|
+
}
|
|
25
|
+
export interface SignalOptions {
|
|
26
|
+
/** Aborts the operation; the rejection is the signal's reason. */
|
|
27
|
+
signal?: AbortSignal;
|
|
28
|
+
}
|
|
29
|
+
export interface OpenOptions extends SignalOptions {
|
|
30
|
+
/** Open only this span — honoured when the origin supports ranges. */
|
|
31
|
+
range?: ByteRange;
|
|
32
|
+
}
|
|
33
|
+
export interface OpenedFile {
|
|
34
|
+
stream: Readable;
|
|
35
|
+
info: FileInfo;
|
|
36
|
+
/** The span actually served, when a range was asked for and honoured. */
|
|
37
|
+
range?: {
|
|
38
|
+
start: number;
|
|
39
|
+
end: number;
|
|
40
|
+
total: number;
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
/** Random access over ONE immutable version of a file. */
|
|
44
|
+
export interface RangeReader {
|
|
45
|
+
/** Total bytes of the file. */
|
|
46
|
+
readonly size: number;
|
|
47
|
+
/** Up to `length` bytes at `offset`; fewer only at the end of the file. */
|
|
48
|
+
read: (offset: number, length: number, signal?: AbortSignal) => Promise<Uint8Array>;
|
|
49
|
+
/** A stream over `[start, end)` — for spans too large to buffer. */
|
|
50
|
+
stream: (start: number, end: number, signal?: AbortSignal) => Promise<Readable>;
|
|
51
|
+
close: () => Promise<void>;
|
|
52
|
+
}
|
|
53
|
+
/** Where a file's bytes come from. */
|
|
54
|
+
export interface FileSource {
|
|
55
|
+
/** `http`, `s3`, `file`, `buffer`, `stream`, `archive`, `gzip`. */
|
|
56
|
+
readonly kind: string;
|
|
57
|
+
/** Metadata without the body (HEAD, HeadObject, stat); cached. */
|
|
58
|
+
info: (options?: SignalOptions) => Promise<FileInfo>;
|
|
59
|
+
/** A fresh body stream. A one-shot source refuses a second open with `SourceError('consumed')`. */
|
|
60
|
+
open: (options?: OpenOptions) => Promise<OpenedFile>;
|
|
61
|
+
/** Random access when the origin offers it, otherwise `null` (probing then reads the head only). */
|
|
62
|
+
ranges: (options?: SignalOptions) => Promise<RangeReader | null>;
|
|
63
|
+
}
|
|
64
|
+
export interface SinkInput {
|
|
65
|
+
stream: Readable;
|
|
66
|
+
info: FileInfo;
|
|
67
|
+
/** The transfer's verdict, when one ran — sinks take the Content-Type from it. */
|
|
68
|
+
verdict?: FileVerdict;
|
|
69
|
+
}
|
|
70
|
+
export interface SinkWriteOptions extends SignalOptions {
|
|
71
|
+
/** Ceiling on accepted bytes; a sink may lower it. */
|
|
72
|
+
maxBytes?: number;
|
|
73
|
+
}
|
|
74
|
+
export interface SinkResult {
|
|
75
|
+
/** `file`, `s3`, `workload`, `buffer`. */
|
|
76
|
+
kind: string;
|
|
77
|
+
/** Path, `s3://bucket/key` or workload file path. */
|
|
78
|
+
location: string;
|
|
79
|
+
bytes: number;
|
|
80
|
+
/** Public URL when the destination has one — for S3 the one storage-resource answers. */
|
|
81
|
+
url?: string;
|
|
82
|
+
etag?: string;
|
|
83
|
+
mime?: string;
|
|
84
|
+
}
|
|
85
|
+
/** Where one file's bytes go. */
|
|
86
|
+
export interface FileSink {
|
|
87
|
+
readonly kind: string;
|
|
88
|
+
/** Writes the whole stream and commits atomically; on failure nothing is left behind. */
|
|
89
|
+
write: (input: SinkInput, options?: SinkWriteOptions) => Promise<SinkResult>;
|
|
90
|
+
}
|
|
91
|
+
/** Many files under one root — a directory, an S3 prefix, a workload folder. */
|
|
92
|
+
export interface TreeSink {
|
|
93
|
+
readonly kind: string;
|
|
94
|
+
/** The sink of one entry; `path` is normalized and confined to the root, otherwise `PathError`. */
|
|
95
|
+
entry: (path: string) => FileSink;
|
|
96
|
+
/** An empty directory where the store has directories; a no-op elsewhere. */
|
|
97
|
+
directory: (path: string, options?: SignalOptions) => Promise<void>;
|
|
98
|
+
}
|
|
99
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
|
package/build/types.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../../src/utils/names/consts.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAA+C,CAAA;AAEhG,kDAAkD;AAClD,eAAO,MAAM,cAAc,MAAM,CAAA"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"consts.js","sourceRoot":"","sources":["../../../src/utils/names/consts.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,CAAC,MAAM,mBAAmB,GAAsB,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAA;AAEhG,kDAAkD;AAClD,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAA"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
export interface NameUtils {
|
|
2
|
+
/** The file name a `Content-Disposition` header carries (`filename*` per RFC 5987 first), sanitized. */
|
|
3
|
+
fromDisposition: (header: string | undefined) => string | undefined;
|
|
4
|
+
/** The last path segment of a URL, decoded and sanitized. */
|
|
5
|
+
fromUrl: (url: URL) => string | undefined;
|
|
6
|
+
/** The base name of an object key or a path, sanitized. */
|
|
7
|
+
fromKey: (key: string) => string | undefined;
|
|
8
|
+
/** A base name safe to write: no directories, control characters, `..` or leading dots. */
|
|
9
|
+
sanitize: (name: string | undefined) => string | undefined;
|
|
10
|
+
/** The lower-cased extension, keeping the compound ones (`tar.gz`). */
|
|
11
|
+
extOf: (name: string | undefined) => string | undefined;
|
|
12
|
+
}
|
|
13
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/names/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,wGAAwG;IACxG,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,CAAA;IACnE,6DAA6D;IAC7D,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,GAAG,SAAS,CAAA;IACzC,2DAA2D;IAC3D,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;IAC5C,2FAA2F;IAC3F,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,CAAA;IAC1D,uEAAuE;IACvE,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,CAAA;CACxD"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/names/types.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../src/utils/names.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD,eAAO,MAAM,eAAe,QAAO,SAgElC,CAAA;AAED,eAAO,MAAM,SAAS,WAAoB,CAAA"}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
import { COMPOUND_EXTENSIONS, MAX_NAME_BYTES } from './names/consts.js';
|
|
2
|
+
export const createNameUtils = () => {
|
|
3
|
+
const sanitize = (name) => {
|
|
4
|
+
if (name == null) {
|
|
5
|
+
return undefined;
|
|
6
|
+
}
|
|
7
|
+
let base = name.replace(/\\/g, '/').split('/').pop()?.replace(/[\u0000-\u001f\u007f\u202a-\u202e\u2066-\u2069]/g, '') ?? '';
|
|
8
|
+
base = base.normalize('NFC').trim().replace(/^\.+/, '').replace(/[. ]+$/, '');
|
|
9
|
+
if (base === '' || base === '..') {
|
|
10
|
+
return undefined;
|
|
11
|
+
}
|
|
12
|
+
while (Buffer.byteLength(base) > MAX_NAME_BYTES) {
|
|
13
|
+
base = base.slice(0, -1);
|
|
14
|
+
}
|
|
15
|
+
return base;
|
|
16
|
+
};
|
|
17
|
+
const decode = (value) => {
|
|
18
|
+
try {
|
|
19
|
+
return decodeURIComponent(value);
|
|
20
|
+
}
|
|
21
|
+
catch {
|
|
22
|
+
return value;
|
|
23
|
+
}
|
|
24
|
+
};
|
|
25
|
+
const fromDisposition = (header) => {
|
|
26
|
+
if (header == null || header === '') {
|
|
27
|
+
return undefined;
|
|
28
|
+
}
|
|
29
|
+
const extended = /filename\*\s*=\s*([^']*)'[^']*'([^;]+)/i.exec(header);
|
|
30
|
+
if (extended != null) {
|
|
31
|
+
return sanitize(decode(extended[2].trim().replace(/^"|"$/g, '')));
|
|
32
|
+
}
|
|
33
|
+
const plain = /filename\s*=\s*("(?:[^"\\]|\\.)*"|[^;]+)/i.exec(header);
|
|
34
|
+
if (plain != null) {
|
|
35
|
+
const value = plain[1].trim();
|
|
36
|
+
return sanitize(value.startsWith('"') ? value.slice(1, -1).replace(/\\(.)/g, '$1') : value);
|
|
37
|
+
}
|
|
38
|
+
return undefined;
|
|
39
|
+
};
|
|
40
|
+
const fromUrl = (url) => {
|
|
41
|
+
const segment = url.pathname.split('/').filter(part => part !== '').pop();
|
|
42
|
+
return segment != null ? sanitize(decode(segment)) : undefined;
|
|
43
|
+
};
|
|
44
|
+
const fromKey = (key) => sanitize(key.split('/').filter(part => part !== '').pop());
|
|
45
|
+
const extOf = (name) => {
|
|
46
|
+
if (name == null) {
|
|
47
|
+
return undefined;
|
|
48
|
+
}
|
|
49
|
+
const lower = name.toLowerCase();
|
|
50
|
+
const compound = COMPOUND_EXTENSIONS.find(ext => lower.endsWith(`.${ext}`));
|
|
51
|
+
if (compound != null) {
|
|
52
|
+
return compound;
|
|
53
|
+
}
|
|
54
|
+
const dot = lower.lastIndexOf('.');
|
|
55
|
+
return dot > 0 && dot < lower.length - 1 ? lower.slice(dot + 1) : undefined;
|
|
56
|
+
};
|
|
57
|
+
return { fromDisposition, fromUrl, fromKey, sanitize, extOf };
|
|
58
|
+
};
|
|
59
|
+
export const nameUtils = createNameUtils();
|
|
60
|
+
//# sourceMappingURL=names.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"names.js","sourceRoot":"","sources":["../../src/utils/names.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../../src/utils/paths/consts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,UAAU,CAA8D,CAAA"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"consts.js","sourceRoot":"","sources":["../../../src/utils/paths/consts.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mBAAmB,GAAyB,MAAM,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC,CAAA"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
export interface PathLimits {
|
|
2
|
+
/** Longest relative path, in UTF-8 bytes. */
|
|
3
|
+
maxPathBytes: number;
|
|
4
|
+
/** Deepest relative path, in segments. */
|
|
5
|
+
maxPathSegments: number;
|
|
6
|
+
}
|
|
7
|
+
export interface PathUtils {
|
|
8
|
+
/**
|
|
9
|
+
* A relative entry path normalized (`\` → `/`, NFC, `.` and empty segments dropped), or a
|
|
10
|
+
* `PathError`: `invalid-char`, `absolute`, `traversal`, `empty`, `too-long`, `too-deep`.
|
|
11
|
+
*/
|
|
12
|
+
entry: (raw: string, limits?: Partial<PathLimits>) => string;
|
|
13
|
+
/** The absolute path of a normalized relative path under `root`; refuses an escape. */
|
|
14
|
+
join: (root: string, relative: string) => string;
|
|
15
|
+
/** Refuses (`PathError('symlink')`) when any existing ancestor of `target` below `root` is a link. */
|
|
16
|
+
assertNoLinks: (root: string, target: string) => Promise<void>;
|
|
17
|
+
/** An object key: `prefix` and a normalized relative path joined by `/`. */
|
|
18
|
+
key: (prefix: string, relative: string) => string;
|
|
19
|
+
}
|
|
20
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/paths/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAA;IACpB,0CAA0C;IAC1C,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,KAAK,MAAM,CAAA;IAC5D,uFAAuF;IACvF,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAA;IAChD,sGAAsG;IACtG,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9D,4EAA4E;IAC5E,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAA;CAClD"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/paths/types.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAE7D,eAAO,MAAM,eAAe,QAAO,SAkElC,CAAA;AAED,eAAO,MAAM,SAAS,WAAoB,CAAA"}
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
import { lstat } from 'node:fs/promises';
|
|
2
|
+
import { isAbsolute, relative as relativeOf, resolve, sep } from 'node:path';
|
|
3
|
+
import { PathError } from '../errors.js';
|
|
4
|
+
import { DEFAULT_PATH_LIMITS } from './paths/consts.js';
|
|
5
|
+
export const createPathUtils = () => {
|
|
6
|
+
const forbidden = /[\u0000-\u001f\u007f\u202a-\u202e\u2066-\u2069]/;
|
|
7
|
+
const entry = (raw, limits = {}) => {
|
|
8
|
+
const { maxPathBytes, maxPathSegments } = { ...DEFAULT_PATH_LIMITS, ...limits };
|
|
9
|
+
const path = raw.normalize('NFC').replace(/\\/g, '/');
|
|
10
|
+
if (forbidden.test(path)) {
|
|
11
|
+
throw new PathError('invalid-char');
|
|
12
|
+
}
|
|
13
|
+
if (path.startsWith('/') || /^[A-Za-z]:/.test(path)) {
|
|
14
|
+
throw new PathError('absolute');
|
|
15
|
+
}
|
|
16
|
+
const segments = path.split('/').filter(segment => segment !== '' && segment !== '.');
|
|
17
|
+
if (segments.includes('..')) {
|
|
18
|
+
throw new PathError('traversal');
|
|
19
|
+
}
|
|
20
|
+
if (segments.length === 0) {
|
|
21
|
+
throw new PathError('empty');
|
|
22
|
+
}
|
|
23
|
+
const normalized = segments.join('/');
|
|
24
|
+
if (Buffer.byteLength(normalized) > maxPathBytes) {
|
|
25
|
+
throw new PathError('too-long');
|
|
26
|
+
}
|
|
27
|
+
if (segments.length > maxPathSegments) {
|
|
28
|
+
throw new PathError('too-deep');
|
|
29
|
+
}
|
|
30
|
+
return normalized;
|
|
31
|
+
};
|
|
32
|
+
const join = (root, relative) => {
|
|
33
|
+
const base = resolve(root);
|
|
34
|
+
const target = resolve(base, relative);
|
|
35
|
+
const inside = relativeOf(base, target);
|
|
36
|
+
if (inside === '' || inside.startsWith('..') || isAbsolute(inside)) {
|
|
37
|
+
throw new PathError('traversal');
|
|
38
|
+
}
|
|
39
|
+
return target;
|
|
40
|
+
};
|
|
41
|
+
const assertNoLinks = async (root, target) => {
|
|
42
|
+
const base = resolve(root);
|
|
43
|
+
const parts = relativeOf(base, resolve(target)).split(sep).filter(part => part !== '');
|
|
44
|
+
let current = base;
|
|
45
|
+
for (const part of parts) {
|
|
46
|
+
current = `${current}${sep}${part}`;
|
|
47
|
+
try {
|
|
48
|
+
if ((await lstat(current)).isSymbolicLink()) {
|
|
49
|
+
throw new PathError('symlink');
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
catch (error) {
|
|
53
|
+
if (error.code === 'ENOENT') {
|
|
54
|
+
return;
|
|
55
|
+
}
|
|
56
|
+
throw error;
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
};
|
|
60
|
+
const key = (prefix, relative) => {
|
|
61
|
+
const clean = prefix.replace(/\/+$/, '');
|
|
62
|
+
return clean === '' ? entry(relative) : `${clean}/${entry(relative)}`;
|
|
63
|
+
};
|
|
64
|
+
return { entry, join, assertNoLinks, key };
|
|
65
|
+
};
|
|
66
|
+
export const pathUtils = createPathUtils();
|
|
67
|
+
//# sourceMappingURL=paths.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,QAAQ,IAAI,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAGvD,MAAM,CAAC,MAAM,eAAe,GAAG,GAAc,EAAE;IAC7C,MAAM,SAAS,GAAG,iDAAiD,CAAA;IAEnE,MAAM,KAAK,GAAG,CAAC,GAAW,EAAE,MAAM,GAAwB,EAAE,EAAU,EAAE;QACtE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,EAAE,GAAG,mBAAmB,EAAE,GAAG,MAAM,EAAE,CAAA;QAC/E,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QACrD,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,SAAS,CAAC,cAAc,CAAC,CAAA;QACrC,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,SAAS,CAAC,UAAU,CAAC,CAAA;QACjC,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG,CAAC,CAAA;QACrF,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,SAAS,CAAC,WAAW,CAAC,CAAA;QAClC,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,SAAS,CAAC,OAAO,CAAC,CAAA;QAC9B,CAAC;QACD,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACrC,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,YAAY,EAAE,CAAC;YACjD,MAAM,IAAI,SAAS,CAAC,UAAU,CAAC,CAAA;QACjC,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;YACtC,MAAM,IAAI,SAAS,CAAC,UAAU,CAAC,CAAA;QACjC,CAAC;QAED,OAAO,UAAU,CAAA;IACnB,CAAC,CAAA;IAED,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,QAAgB,EAAU,EAAE;QACtD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;QAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;QACtC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QACvC,IAAI,MAAM,KAAK,EAAE,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACnE,MAAM,IAAI,SAAS,CAAC,WAAW,CAAC,CAAA;QAClC,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;IAED,MAAM,aAAa,GAAG,KAAK,EAAE,IAAY,EAAE,MAAc,EAAiB,EAAE;QAC1E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;QAC1B,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAA;QACtF,IAAI,OAAO,GAAG,IAAI,CAAA;QAClB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,OAAO,GAAG,GAAG,OAAO,GAAG,GAAG,GAAG,IAAI,EAAE,CAAA;YACnC,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC;oBAC5C,MAAM,IAAI,SAAS,CAAC,SAAS,CAAC,CAAA;gBAChC,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACvD,OAAM;gBACR,CAAC;gBACD,MAAM,KAAK,CAAA;YACb,CAAC;QACH,CAAC;IACH,CAAC,CAAA;IAED,MAAM,GAAG,GAAG,CAAC,MAAc,EAAE,QAAgB,EAAU,EAAE;QACvD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QACxC,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAA;IACvE,CAAC,CAAA;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,CAAA;AAC5C,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,eAAe,EAAE,CAAA"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { RandomAccessReader as ZipRandomAccessReader } from 'yauzl';
|
|
2
|
+
import type { RangeReader } from '../../types.js';
|
|
3
|
+
export interface RangeUtils {
|
|
4
|
+
/** A yauzl random-access reader (central-directory zip reading) over a reader. */
|
|
5
|
+
zipReader: (reader: RangeReader) => ZipRandomAccessReader;
|
|
6
|
+
/** A reader over bytes in memory. */
|
|
7
|
+
ofBuffer: (bytes: Uint8Array) => RangeReader;
|
|
8
|
+
/** A reader over a regular file of known size. */
|
|
9
|
+
ofFile: (path: string, size: number) => RangeReader;
|
|
10
|
+
}
|
|
11
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/range/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,IAAI,qBAAqB,EAAE,MAAM,OAAO,CAAA;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,MAAM,WAAW,UAAU;IACzB,kFAAkF;IAClF,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,qBAAqB,CAAA;IACzD,qCAAqC;IACrC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,WAAW,CAAA;IAC5C,kDAAkD;IAClD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,WAAW,CAAA;CACpD"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/range/types.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../../src/utils/range.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,eAAO,MAAM,gBAAgB,QAAO,UAoEnC,CAAA;AAED,eAAO,MAAM,UAAU,YAAqB,CAAA"}
|