@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 @@
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,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -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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"}
@@ -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,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,5 @@
1
+ /** Extensions that span two dots and name one format. */
2
+ export declare const COMPOUND_EXTENSIONS: readonly string[];
3
+ /** The longest base name kept, in UTF-8 bytes. */
4
+ export declare const MAX_NAME_BYTES = 255;
5
+ //# sourceMappingURL=consts.d.ts.map
@@ -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,5 @@
1
+ /** Extensions that span two dots and name one format. */
2
+ export const COMPOUND_EXTENSIONS = ['tar.gz', 'tar.bz2', 'tar.xz', 'tar.zst'];
3
+ /** The longest base name kept, in UTF-8 bytes. */
4
+ export const MAX_NAME_BYTES = 255;
5
+ //# sourceMappingURL=consts.js.map
@@ -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,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/names/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,4 @@
1
+ import type { NameUtils } from './names/types.js';
2
+ export declare const createNameUtils: () => NameUtils;
3
+ export declare const nameUtils: NameUtils;
4
+ //# sourceMappingURL=names.d.ts.map
@@ -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,3 @@
1
+ import type { PathLimits } from './types.js';
2
+ export declare const DEFAULT_PATH_LIMITS: Readonly<PathLimits>;
3
+ //# sourceMappingURL=consts.d.ts.map
@@ -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,2 @@
1
+ export const DEFAULT_PATH_LIMITS = Object.freeze({ maxPathBytes: 1024, maxPathSegments: 64 });
2
+ //# sourceMappingURL=consts.js.map
@@ -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,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/paths/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,4 @@
1
+ import type { PathUtils } from './paths/types.js';
2
+ export declare const createPathUtils: () => PathUtils;
3
+ export declare const pathUtils: PathUtils;
4
+ //# sourceMappingURL=paths.d.ts.map
@@ -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":"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"}
@@ -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,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/range/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,4 @@
1
+ import type { RangeUtils } from './range/types.js';
2
+ export declare const createRangeUtils: () => RangeUtils;
3
+ export declare const rangeUtils: RangeUtils;
4
+ //# sourceMappingURL=range.d.ts.map
@@ -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"}