@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.
Files changed (475) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +71 -2
  3. package/agent-meta/manifest.json +64 -0
  4. package/agent-meta/skills/file-streams/SKILL.md +183 -0
  5. package/agent-meta/skills/file-streams/parts/network.md +47 -0
  6. package/agent-meta/skills/file-streams/parts/workspaces.md +129 -0
  7. package/build/archive/consts.d.ts +16 -0
  8. package/build/archive/consts.d.ts.map +1 -0
  9. package/build/archive/consts.js +24 -0
  10. package/build/archive/consts.js.map +1 -0
  11. package/build/archive/formats.d.ts +4 -0
  12. package/build/archive/formats.d.ts.map +1 -0
  13. package/build/archive/formats.js +53 -0
  14. package/build/archive/formats.js.map +1 -0
  15. package/build/archive/guard.d.ts +5 -0
  16. package/build/archive/guard.d.ts.map +1 -0
  17. package/build/archive/guard.js +62 -0
  18. package/build/archive/guard.js.map +1 -0
  19. package/build/archive/ratio.d.ts +5 -0
  20. package/build/archive/ratio.d.ts.map +1 -0
  21. package/build/archive/ratio.js +30 -0
  22. package/build/archive/ratio.js.map +1 -0
  23. package/build/archive/tar.d.ts +4 -0
  24. package/build/archive/tar.d.ts.map +1 -0
  25. package/build/archive/tar.js +142 -0
  26. package/build/archive/tar.js.map +1 -0
  27. package/build/archive/types.d.ts +95 -0
  28. package/build/archive/types.d.ts.map +1 -0
  29. package/build/archive/types.js +2 -0
  30. package/build/archive/types.js.map +1 -0
  31. package/build/archive/types.local.d.ts +64 -0
  32. package/build/archive/types.local.d.ts.map +1 -0
  33. package/build/archive/types.local.js +2 -0
  34. package/build/archive/types.local.js.map +1 -0
  35. package/build/archive/zip.d.ts +4 -0
  36. package/build/archive/zip.d.ts.map +1 -0
  37. package/build/archive/zip.js +135 -0
  38. package/build/archive/zip.js.map +1 -0
  39. package/build/archive.d.ts +4 -0
  40. package/build/archive.d.ts.map +1 -0
  41. package/build/archive.js +265 -0
  42. package/build/archive.js.map +1 -0
  43. package/build/backed-workspace/types.d.ts +67 -0
  44. package/build/backed-workspace/types.d.ts.map +1 -0
  45. package/build/backed-workspace/types.js +2 -0
  46. package/build/backed-workspace/types.js.map +1 -0
  47. package/build/backed-workspace.d.ts +4 -0
  48. package/build/backed-workspace.d.ts.map +1 -0
  49. package/build/backed-workspace.js +63 -0
  50. package/build/backed-workspace.js.map +1 -0
  51. package/build/consts.d.ts +3 -0
  52. package/build/consts.d.ts.map +1 -0
  53. package/build/consts.js +3 -0
  54. package/build/consts.js.map +1 -0
  55. package/build/consts.local.d.ts +3 -0
  56. package/build/consts.local.d.ts.map +1 -0
  57. package/build/consts.local.js +3 -0
  58. package/build/consts.local.js.map +1 -0
  59. package/build/errors.d.ts +59 -0
  60. package/build/errors.d.ts.map +1 -0
  61. package/build/errors.js +105 -0
  62. package/build/errors.js.map +1 -0
  63. package/build/http/connector.d.ts +11 -0
  64. package/build/http/connector.d.ts.map +1 -0
  65. package/build/http/connector.js +124 -0
  66. package/build/http/connector.js.map +1 -0
  67. package/build/http/consts.d.ts +9 -0
  68. package/build/http/consts.d.ts.map +1 -0
  69. package/build/http/consts.js +8 -0
  70. package/build/http/consts.js.map +1 -0
  71. package/build/http/source.d.ts +5 -0
  72. package/build/http/source.d.ts.map +1 -0
  73. package/build/http/source.js +76 -0
  74. package/build/http/source.js.map +1 -0
  75. package/build/http/types.d.ts +67 -0
  76. package/build/http/types.d.ts.map +1 -0
  77. package/build/http/types.js +2 -0
  78. package/build/http/types.js.map +1 -0
  79. package/build/http/types.local.d.ts +21 -0
  80. package/build/http/types.local.d.ts.map +1 -0
  81. package/build/http/types.local.js +2 -0
  82. package/build/http/types.local.js.map +1 -0
  83. package/build/http.d.ts +4 -0
  84. package/build/http.d.ts.map +1 -0
  85. package/build/http.js +248 -0
  86. package/build/http.js.map +1 -0
  87. package/build/index.d.ts +53 -0
  88. package/build/index.d.ts.map +1 -0
  89. package/build/index.js +33 -0
  90. package/build/index.js.map +1 -0
  91. package/build/network/consts.d.ts +12 -0
  92. package/build/network/consts.d.ts.map +1 -0
  93. package/build/network/consts.js +20 -0
  94. package/build/network/consts.js.map +1 -0
  95. package/build/network/types.d.ts +43 -0
  96. package/build/network/types.d.ts.map +1 -0
  97. package/build/network/types.js +2 -0
  98. package/build/network/types.js.map +1 -0
  99. package/build/network.d.ts +4 -0
  100. package/build/network.d.ts.map +1 -0
  101. package/build/network.js +165 -0
  102. package/build/network.js.map +1 -0
  103. package/build/proxy/consts.d.ts +7 -0
  104. package/build/proxy/consts.d.ts.map +1 -0
  105. package/build/proxy/consts.js +9 -0
  106. package/build/proxy/consts.js.map +1 -0
  107. package/build/proxy/endpoint.d.ts +4 -0
  108. package/build/proxy/endpoint.d.ts.map +1 -0
  109. package/build/proxy/endpoint.js +27 -0
  110. package/build/proxy/endpoint.js.map +1 -0
  111. package/build/proxy/http.d.ts +5 -0
  112. package/build/proxy/http.d.ts.map +1 -0
  113. package/build/proxy/http.js +95 -0
  114. package/build/proxy/http.js.map +1 -0
  115. package/build/proxy/router.d.ts +4 -0
  116. package/build/proxy/router.d.ts.map +1 -0
  117. package/build/proxy/router.js +85 -0
  118. package/build/proxy/router.js.map +1 -0
  119. package/build/proxy/socks.d.ts +5 -0
  120. package/build/proxy/socks.d.ts.map +1 -0
  121. package/build/proxy/socks.js +44 -0
  122. package/build/proxy/socks.js.map +1 -0
  123. package/build/proxy/types.d.ts +99 -0
  124. package/build/proxy/types.d.ts.map +1 -0
  125. package/build/proxy/types.js +2 -0
  126. package/build/proxy/types.js.map +1 -0
  127. package/build/resolvers/google-drive/consts.d.ts +10 -0
  128. package/build/resolvers/google-drive/consts.d.ts.map +1 -0
  129. package/build/resolvers/google-drive/consts.js +16 -0
  130. package/build/resolvers/google-drive/consts.js.map +1 -0
  131. package/build/resolvers/google-drive/types.d.ts +21 -0
  132. package/build/resolvers/google-drive/types.d.ts.map +1 -0
  133. package/build/resolvers/google-drive/types.js +2 -0
  134. package/build/resolvers/google-drive/types.js.map +1 -0
  135. package/build/resolvers/google-drive.d.ts +10 -0
  136. package/build/resolvers/google-drive.d.ts.map +1 -0
  137. package/build/resolvers/google-drive.js +130 -0
  138. package/build/resolvers/google-drive.js.map +1 -0
  139. package/build/resolvers/types.d.ts +39 -0
  140. package/build/resolvers/types.d.ts.map +1 -0
  141. package/build/resolvers/types.js +2 -0
  142. package/build/resolvers/types.js.map +1 -0
  143. package/build/s3/consts.d.ts +9 -0
  144. package/build/s3/consts.d.ts.map +1 -0
  145. package/build/s3/consts.js +9 -0
  146. package/build/s3/consts.js.map +1 -0
  147. package/build/s3/prefix.d.ts +4 -0
  148. package/build/s3/prefix.d.ts.map +1 -0
  149. package/build/s3/prefix.js +87 -0
  150. package/build/s3/prefix.js.map +1 -0
  151. package/build/s3/sink.d.ts +6 -0
  152. package/build/s3/sink.d.ts.map +1 -0
  153. package/build/s3/sink.js +30 -0
  154. package/build/s3/sink.js.map +1 -0
  155. package/build/s3/source.d.ts +5 -0
  156. package/build/s3/source.d.ts.map +1 -0
  157. package/build/s3/source.js +81 -0
  158. package/build/s3/source.js.map +1 -0
  159. package/build/s3/types.d.ts +66 -0
  160. package/build/s3/types.d.ts.map +1 -0
  161. package/build/s3/types.js +2 -0
  162. package/build/s3/types.js.map +1 -0
  163. package/build/s3/types.local.d.ts +43 -0
  164. package/build/s3/types.local.d.ts.map +1 -0
  165. package/build/s3/types.local.js +2 -0
  166. package/build/s3/types.local.js.map +1 -0
  167. package/build/s3/upload.d.ts +4 -0
  168. package/build/s3/upload.d.ts.map +1 -0
  169. package/build/s3/upload.js +118 -0
  170. package/build/s3/upload.js.map +1 -0
  171. package/build/s3.d.ts +5 -0
  172. package/build/s3.d.ts.map +1 -0
  173. package/build/s3.js +68 -0
  174. package/build/s3.js.map +1 -0
  175. package/build/service/types.d.ts +66 -0
  176. package/build/service/types.d.ts.map +1 -0
  177. package/build/service/types.js +2 -0
  178. package/build/service/types.js.map +1 -0
  179. package/build/service/types.local.d.ts +11 -0
  180. package/build/service/types.local.d.ts.map +1 -0
  181. package/build/service/types.local.js +2 -0
  182. package/build/service/types.local.js.map +1 -0
  183. package/build/service.d.ts +6 -0
  184. package/build/service.d.ts.map +1 -0
  185. package/build/service.js +73 -0
  186. package/build/service.js.map +1 -0
  187. package/build/sinks/buffer/consts.d.ts +2 -0
  188. package/build/sinks/buffer/consts.d.ts.map +1 -0
  189. package/build/sinks/buffer/consts.js +2 -0
  190. package/build/sinks/buffer/consts.js.map +1 -0
  191. package/build/sinks/buffer/types.d.ts +11 -0
  192. package/build/sinks/buffer/types.d.ts.map +1 -0
  193. package/build/sinks/buffer/types.js +2 -0
  194. package/build/sinks/buffer/types.js.map +1 -0
  195. package/build/sinks/buffer.d.ts +4 -0
  196. package/build/sinks/buffer.d.ts.map +1 -0
  197. package/build/sinks/buffer.js +13 -0
  198. package/build/sinks/buffer.js.map +1 -0
  199. package/build/sinks/directory/types.d.ts +7 -0
  200. package/build/sinks/directory/types.d.ts.map +1 -0
  201. package/build/sinks/directory/types.js +2 -0
  202. package/build/sinks/directory/types.js.map +1 -0
  203. package/build/sinks/directory.d.ts +8 -0
  204. package/build/sinks/directory.d.ts.map +1 -0
  205. package/build/sinks/directory.js +43 -0
  206. package/build/sinks/directory.js.map +1 -0
  207. package/build/sinks/file.d.ts +5 -0
  208. package/build/sinks/file.d.ts.map +1 -0
  209. package/build/sinks/file.js +46 -0
  210. package/build/sinks/file.js.map +1 -0
  211. package/build/sinks/types.d.ts +11 -0
  212. package/build/sinks/types.d.ts.map +1 -0
  213. package/build/sinks/types.js +2 -0
  214. package/build/sinks/types.js.map +1 -0
  215. package/build/sinks/workload/consts.d.ts +5 -0
  216. package/build/sinks/workload/consts.d.ts.map +1 -0
  217. package/build/sinks/workload/consts.js +5 -0
  218. package/build/sinks/workload/consts.js.map +1 -0
  219. package/build/sinks/workload/types.d.ts +17 -0
  220. package/build/sinks/workload/types.d.ts.map +1 -0
  221. package/build/sinks/workload/types.js +2 -0
  222. package/build/sinks/workload/types.js.map +1 -0
  223. package/build/sinks/workload.d.ts +8 -0
  224. package/build/sinks/workload.d.ts.map +1 -0
  225. package/build/sinks/workload.js +51 -0
  226. package/build/sinks/workload.js.map +1 -0
  227. package/build/sources/buffer.d.ts +5 -0
  228. package/build/sources/buffer.d.ts.map +1 -0
  229. package/build/sources/buffer.js +20 -0
  230. package/build/sources/buffer.js.map +1 -0
  231. package/build/sources/file.d.ts +5 -0
  232. package/build/sources/file.d.ts.map +1 -0
  233. package/build/sources/file.js +50 -0
  234. package/build/sources/file.js.map +1 -0
  235. package/build/sources/stream.d.ts +5 -0
  236. package/build/sources/stream.d.ts.map +1 -0
  237. package/build/sources/stream.js +19 -0
  238. package/build/sources/stream.js.map +1 -0
  239. package/build/sources/types.d.ts +10 -0
  240. package/build/sources/types.d.ts.map +1 -0
  241. package/build/sources/types.js +2 -0
  242. package/build/sources/types.js.map +1 -0
  243. package/build/sources/workload/types.d.ts +29 -0
  244. package/build/sources/workload/types.d.ts.map +1 -0
  245. package/build/sources/workload/types.js +2 -0
  246. package/build/sources/workload/types.js.map +1 -0
  247. package/build/sources/workload.d.ts +7 -0
  248. package/build/sources/workload.d.ts.map +1 -0
  249. package/build/sources/workload.js +67 -0
  250. package/build/sources/workload.js.map +1 -0
  251. package/build/transfer/consts.d.ts +5 -0
  252. package/build/transfer/consts.d.ts.map +1 -0
  253. package/build/transfer/consts.js +8 -0
  254. package/build/transfer/consts.js.map +1 -0
  255. package/build/transfer/types.d.ts +49 -0
  256. package/build/transfer/types.d.ts.map +1 -0
  257. package/build/transfer/types.js +2 -0
  258. package/build/transfer/types.js.map +1 -0
  259. package/build/transfer.d.ts +4 -0
  260. package/build/transfer.d.ts.map +1 -0
  261. package/build/transfer.js +75 -0
  262. package/build/transfer.js.map +1 -0
  263. package/build/types.d.ts +99 -0
  264. package/build/types.d.ts.map +1 -0
  265. package/build/types.js +2 -0
  266. package/build/types.js.map +1 -0
  267. package/build/utils/names/consts.d.ts +5 -0
  268. package/build/utils/names/consts.d.ts.map +1 -0
  269. package/build/utils/names/consts.js +5 -0
  270. package/build/utils/names/consts.js.map +1 -0
  271. package/build/utils/names/types.d.ts +13 -0
  272. package/build/utils/names/types.d.ts.map +1 -0
  273. package/build/utils/names/types.js +2 -0
  274. package/build/utils/names/types.js.map +1 -0
  275. package/build/utils/names.d.ts +4 -0
  276. package/build/utils/names.d.ts.map +1 -0
  277. package/build/utils/names.js +60 -0
  278. package/build/utils/names.js.map +1 -0
  279. package/build/utils/paths/consts.d.ts +3 -0
  280. package/build/utils/paths/consts.d.ts.map +1 -0
  281. package/build/utils/paths/consts.js +2 -0
  282. package/build/utils/paths/consts.js.map +1 -0
  283. package/build/utils/paths/types.d.ts +20 -0
  284. package/build/utils/paths/types.d.ts.map +1 -0
  285. package/build/utils/paths/types.js +2 -0
  286. package/build/utils/paths/types.js.map +1 -0
  287. package/build/utils/paths.d.ts +4 -0
  288. package/build/utils/paths.d.ts.map +1 -0
  289. package/build/utils/paths.js +67 -0
  290. package/build/utils/paths.js.map +1 -0
  291. package/build/utils/range/types.d.ts +11 -0
  292. package/build/utils/range/types.d.ts.map +1 -0
  293. package/build/utils/range/types.js +2 -0
  294. package/build/utils/range/types.js.map +1 -0
  295. package/build/utils/range.d.ts +4 -0
  296. package/build/utils/range.d.ts.map +1 -0
  297. package/build/utils/range.js +64 -0
  298. package/build/utils/range.js.map +1 -0
  299. package/build/utils/redact/types.d.ts +16 -0
  300. package/build/utils/redact/types.d.ts.map +1 -0
  301. package/build/utils/redact/types.js +2 -0
  302. package/build/utils/redact/types.js.map +1 -0
  303. package/build/utils/redact.d.ts +4 -0
  304. package/build/utils/redact.d.ts.map +1 -0
  305. package/build/utils/redact.js +18 -0
  306. package/build/utils/redact.js.map +1 -0
  307. package/build/utils/signals/types.d.ts +17 -0
  308. package/build/utils/signals/types.d.ts.map +1 -0
  309. package/build/utils/signals/types.js +2 -0
  310. package/build/utils/signals/types.js.map +1 -0
  311. package/build/utils/signals.d.ts +4 -0
  312. package/build/utils/signals.d.ts.map +1 -0
  313. package/build/utils/signals.js +52 -0
  314. package/build/utils/signals.js.map +1 -0
  315. package/build/utils/streams/consts.d.ts +3 -0
  316. package/build/utils/streams/consts.d.ts.map +1 -0
  317. package/build/utils/streams/consts.js +3 -0
  318. package/build/utils/streams/consts.js.map +1 -0
  319. package/build/utils/streams/types.d.ts +59 -0
  320. package/build/utils/streams/types.d.ts.map +1 -0
  321. package/build/utils/streams/types.js +2 -0
  322. package/build/utils/streams/types.js.map +1 -0
  323. package/build/utils/streams.d.ts +4 -0
  324. package/build/utils/streams.d.ts.map +1 -0
  325. package/build/utils/streams.js +167 -0
  326. package/build/utils/streams.js.map +1 -0
  327. package/build/utils/tree/types.d.ts +6 -0
  328. package/build/utils/tree/types.d.ts.map +1 -0
  329. package/build/utils/tree/types.js +2 -0
  330. package/build/utils/tree/types.js.map +1 -0
  331. package/build/utils/tree.d.ts +4 -0
  332. package/build/utils/tree.d.ts.map +1 -0
  333. package/build/utils/tree.js +14 -0
  334. package/build/utils/tree.js.map +1 -0
  335. package/build/workspace/consts.d.ts +12 -0
  336. package/build/workspace/consts.d.ts.map +1 -0
  337. package/build/workspace/consts.js +12 -0
  338. package/build/workspace/consts.js.map +1 -0
  339. package/build/workspace/consts.local.d.ts +3 -0
  340. package/build/workspace/consts.local.d.ts.map +1 -0
  341. package/build/workspace/consts.local.js +3 -0
  342. package/build/workspace/consts.local.js.map +1 -0
  343. package/build/workspace/fs.d.ts +4 -0
  344. package/build/workspace/fs.d.ts.map +1 -0
  345. package/build/workspace/fs.js +45 -0
  346. package/build/workspace/fs.js.map +1 -0
  347. package/build/workspace/scope.d.ts +6 -0
  348. package/build/workspace/scope.d.ts.map +1 -0
  349. package/build/workspace/scope.js +180 -0
  350. package/build/workspace/scope.js.map +1 -0
  351. package/build/workspace/types.d.ts +66 -0
  352. package/build/workspace/types.d.ts.map +1 -0
  353. package/build/workspace/types.js +2 -0
  354. package/build/workspace/types.js.map +1 -0
  355. package/build/workspace/types.local.d.ts +20 -0
  356. package/build/workspace/types.local.d.ts.map +1 -0
  357. package/build/workspace/types.local.js +2 -0
  358. package/build/workspace/types.local.js.map +1 -0
  359. package/build/workspace.d.ts +7 -0
  360. package/build/workspace.d.ts.map +1 -0
  361. package/build/workspace.js +87 -0
  362. package/build/workspace.js.map +1 -0
  363. package/package.json +61 -4
  364. package/src/archive/consts.ts +28 -0
  365. package/src/archive/formats.ts +60 -0
  366. package/src/archive/guard.ts +68 -0
  367. package/src/archive/ratio.ts +35 -0
  368. package/src/archive/tar.ts +147 -0
  369. package/src/archive/types.local.ts +72 -0
  370. package/src/archive/types.ts +107 -0
  371. package/src/archive/zip.ts +142 -0
  372. package/src/archive.ts +298 -0
  373. package/src/backed-workspace/types.ts +72 -0
  374. package/src/backed-workspace.ts +85 -0
  375. package/src/consts.local.ts +2 -0
  376. package/src/consts.ts +2 -0
  377. package/src/errors.ts +128 -0
  378. package/src/http/connector.ts +136 -0
  379. package/src/http/consts.ts +13 -0
  380. package/src/http/source.ts +89 -0
  381. package/src/http/types.local.ts +23 -0
  382. package/src/http/types.ts +74 -0
  383. package/src/http.ts +276 -0
  384. package/src/index.ts +65 -0
  385. package/src/network/consts.ts +22 -0
  386. package/src/network/types.ts +45 -0
  387. package/src/network.ts +179 -0
  388. package/src/proxy/consts.ts +11 -0
  389. package/src/proxy/endpoint.ts +28 -0
  390. package/src/proxy/http.ts +108 -0
  391. package/src/proxy/router.ts +93 -0
  392. package/src/proxy/socks.ts +48 -0
  393. package/src/proxy/types.ts +114 -0
  394. package/src/resolvers/google-drive/consts.ts +22 -0
  395. package/src/resolvers/google-drive/types.ts +22 -0
  396. package/src/resolvers/google-drive.ts +153 -0
  397. package/src/resolvers/types.ts +45 -0
  398. package/src/s3/consts.ts +12 -0
  399. package/src/s3/prefix.ts +100 -0
  400. package/src/s3/sink.ts +36 -0
  401. package/src/s3/source.ts +90 -0
  402. package/src/s3/types.local.ts +49 -0
  403. package/src/s3/types.ts +70 -0
  404. package/src/s3/upload.ts +130 -0
  405. package/src/s3.ts +83 -0
  406. package/src/service/types.local.ts +9 -0
  407. package/src/service/types.ts +71 -0
  408. package/src/service.ts +97 -0
  409. package/src/sinks/buffer/consts.ts +1 -0
  410. package/src/sinks/buffer/types.ts +12 -0
  411. package/src/sinks/buffer.ts +18 -0
  412. package/src/sinks/directory/types.ts +7 -0
  413. package/src/sinks/directory.ts +49 -0
  414. package/src/sinks/file.ts +52 -0
  415. package/src/sinks/types.ts +12 -0
  416. package/src/sinks/workload/consts.ts +5 -0
  417. package/src/sinks/workload/types.ts +17 -0
  418. package/src/sinks/workload.ts +59 -0
  419. package/src/sources/buffer.ts +27 -0
  420. package/src/sources/file.ts +57 -0
  421. package/src/sources/stream.ts +26 -0
  422. package/src/sources/types.ts +12 -0
  423. package/src/sources/workload/types.ts +31 -0
  424. package/src/sources/workload.ts +79 -0
  425. package/src/transfer/consts.ts +10 -0
  426. package/src/transfer/types.ts +55 -0
  427. package/src/transfer.ts +89 -0
  428. package/src/types.ts +106 -0
  429. package/src/utils/names/consts.ts +5 -0
  430. package/src/utils/names/types.ts +12 -0
  431. package/src/utils/names.ts +70 -0
  432. package/src/utils/paths/consts.ts +3 -0
  433. package/src/utils/paths/types.ts +20 -0
  434. package/src/utils/paths.ts +75 -0
  435. package/src/utils/range/types.ts +11 -0
  436. package/src/utils/range.ts +80 -0
  437. package/src/utils/redact/types.ts +16 -0
  438. package/src/utils/redact.ts +23 -0
  439. package/src/utils/signals/types.ts +17 -0
  440. package/src/utils/signals.ts +63 -0
  441. package/src/utils/streams/consts.ts +2 -0
  442. package/src/utils/streams/types.ts +65 -0
  443. package/src/utils/streams.ts +188 -0
  444. package/src/utils/tree/types.ts +6 -0
  445. package/src/utils/tree.ts +18 -0
  446. package/src/workspace/consts.local.ts +2 -0
  447. package/src/workspace/consts.ts +14 -0
  448. package/src/workspace/fs.ts +48 -0
  449. package/src/workspace/scope.ts +196 -0
  450. package/src/workspace/types.local.ts +21 -0
  451. package/src/workspace/types.ts +71 -0
  452. package/src/workspace.ts +102 -0
  453. package/tests/archive.spec.ts +134 -0
  454. package/tests/backed.spec.ts +147 -0
  455. package/tests/context.ts +114 -0
  456. package/tests/fixtures.ts +190 -0
  457. package/tests/google-drive.spec.ts +76 -0
  458. package/tests/harness/drive.ts +92 -0
  459. package/tests/harness/http-proxy.ts +96 -0
  460. package/tests/harness/origin.ts +134 -0
  461. package/tests/harness/socks5.ts +135 -0
  462. package/tests/harness/workload.ts +118 -0
  463. package/tests/http.spec.ts +101 -0
  464. package/tests/inspector.spec.ts +40 -0
  465. package/tests/live.spec.ts +27 -0
  466. package/tests/network.spec.ts +79 -0
  467. package/tests/proxy.spec.ts +149 -0
  468. package/tests/s3.spec.ts +133 -0
  469. package/tests/service.spec.ts +77 -0
  470. package/tests/sources-sinks.spec.ts +96 -0
  471. package/tests/transfer.spec.ts +99 -0
  472. package/tests/tsconfig.json +12 -0
  473. package/tests/workload.spec.ts +140 -0
  474. package/tests/workspace.spec.ts +158 -0
  475. package/tsconfig.json +16 -0
@@ -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,4 @@
1
+ import type { ProxyEndpoint } from './types.js';
2
+ /** A proxy URL (`socks5h://user:pass@host:1080`) read as an endpoint. */
3
+ export declare const parseProxyEndpoint: (value: ProxyEndpoint | string) => ProxyEndpoint;
4
+ //# sourceMappingURL=endpoint.d.ts.map
@@ -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