@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,64 @@
1
+ import { createReadStream } from 'node:fs';
2
+ import { open } from 'node:fs/promises';
3
+ import { PassThrough, Readable } from 'node:stream';
4
+ import yauzl from 'yauzl';
5
+ export const createRangeUtils = () => {
6
+ const zipReader = (reader) => {
7
+ const ZipReader = yauzl.RandomAccessReader;
8
+ const adapter = new ZipReader();
9
+ adapter._readStreamForRange = (start, end) => {
10
+ const out = new PassThrough();
11
+ reader.stream(start, end).then(stream => {
12
+ stream.once('error', error => out.destroy(error));
13
+ stream.pipe(out);
14
+ }, error => out.destroy(error));
15
+ return out;
16
+ };
17
+ adapter.read = (buffer, offset, length, position, callback) => {
18
+ reader.read(position, length).then(bytes => {
19
+ if (bytes.length < length) {
20
+ callback(new Error('unexpected EOF'));
21
+ return;
22
+ }
23
+ buffer.set(bytes.subarray(0, length), offset);
24
+ callback(null);
25
+ }, error => callback(error));
26
+ };
27
+ adapter.close = callback => {
28
+ reader.close().then(() => callback(null), error => callback(error));
29
+ };
30
+ return adapter;
31
+ };
32
+ const ofBuffer = (bytes) => ({
33
+ size: bytes.length,
34
+ read: async (offset, length) => bytes.subarray(offset, Math.min(offset + length, bytes.length)),
35
+ stream: async (start, end) => Readable.from([Buffer.from(bytes.subarray(start, end))], { objectMode: false }),
36
+ close: async () => undefined,
37
+ });
38
+ const ofFile = (path, size) => {
39
+ let handle;
40
+ return {
41
+ size,
42
+ read: async (offset, length) => {
43
+ handle ??= open(path, 'r');
44
+ const count = Math.max(0, Math.min(length, size - offset));
45
+ const buffer = Buffer.alloc(count);
46
+ const { bytesRead } = await (await handle).read(buffer, 0, count, offset);
47
+ return buffer.subarray(0, bytesRead);
48
+ },
49
+ stream: async (start, end) => end <= start
50
+ ? Readable.from([], { objectMode: false })
51
+ : createReadStream(path, { start, end: end - 1 }),
52
+ close: async () => {
53
+ const opened = handle;
54
+ handle = undefined;
55
+ if (opened != null) {
56
+ await (await opened).close();
57
+ }
58
+ },
59
+ };
60
+ };
61
+ return { zipReader, ofBuffer, ofFile };
62
+ };
63
+ export const rangeUtils = createRangeUtils();
64
+ //# sourceMappingURL=range.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"range.js","sourceRoot":"","sources":["../../src/utils/range.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAEvC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAe,EAAE;IAC/C,MAAM,SAAS,GAAG,CAAC,MAAmB,EAAyB,EAAE;QAC/D,MAAM,SAAS,GAAG,KAAK,CAAC,kBAAgE,CAAA;QACxF,MAAM,OAAO,GAAG,IAAI,SAAS,EAAE,CAAA;QAE/B,OAAO,CAAC,mBAAmB,GAAG,CAAC,KAAa,EAAE,GAAW,EAAY,EAAE;YACrE,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAA;YAC7B,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,CAC5B,MAAM,CAAC,EAAE;gBACP,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;gBACjD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAClB,CAAC,EACD,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAc,CAAC,CACrC,CAAA;YACD,OAAO,GAAG,CAAA;QACZ,CAAC,CAAA;QAED,OAAO,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE;YAC5D,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;gBACzC,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;oBAC1B,QAAQ,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAA;oBACrC,OAAM;gBACR,CAAC;gBACD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAA;gBAC7C,QAAQ,CAAC,IAAI,CAAC,CAAA;YAChB,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAc,CAAC,CAAC,CAAA;QACvC,CAAC,CAAA;QAED,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC,EAAE;YACzB,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAc,CAAC,CAAC,CAAA;QAC9E,CAAC,CAAA;QAED,OAAO,OAAO,CAAA;IAChB,CAAC,CAAA;IAED,MAAM,QAAQ,GAAG,CAAC,KAAiB,EAAe,EAAE,CAAC,CAAC;QACpD,IAAI,EAAE,KAAK,CAAC,MAAM;QAClB,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAC/F,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAC7G,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;KAC7B,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,IAAY,EAAe,EAAE;QACzD,IAAI,MAAuC,CAAA;QAE3C,OAAO;YACL,IAAI;YACJ,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;gBAC7B,MAAM,KAAK,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;gBAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,GAAG,MAAM,CAAC,CAAC,CAAA;gBAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;gBAClC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;gBACzE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;YACtC,CAAC;YACD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,KAAK;gBACxC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;gBAC1C,CAAC,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC;YACnD,KAAK,EAAE,KAAK,IAAI,EAAE;gBAChB,MAAM,MAAM,GAAG,MAAM,CAAA;gBACrB,MAAM,GAAG,SAAS,CAAA;gBAClB,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;oBACnB,MAAM,CAAC,MAAM,MAAM,CAAC,CAAC,KAAK,EAAE,CAAA;gBAC9B,CAAC;YACH,CAAC;SACF,CAAA;IACH,CAAC,CAAA;IAED,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;AACxC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,gBAAgB,EAAE,CAAA"}
@@ -0,0 +1,16 @@
1
+ export interface RedactedProxy {
2
+ type: string;
3
+ host: string;
4
+ port: number;
5
+ id?: string;
6
+ }
7
+ export interface RedactUtils {
8
+ /**
9
+ * `scheme://host[:port]/path` with no userinfo, query or fragment, and opaque path segments
10
+ * (20+ token characters: Drive ids, capability paths) masked.
11
+ */
12
+ url: (url: string | URL) => string;
13
+ /** A proxy by its credential-free id. */
14
+ proxy: (endpoint: RedactedProxy) => string;
15
+ }
16
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/redact/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,KAAK,MAAM,CAAA;IAClC,yCAAyC;IACzC,KAAK,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,MAAM,CAAA;CAC3C"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/redact/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,4 @@
1
+ import type { RedactUtils } from './redact/types.js';
2
+ export declare const createRedactUtils: () => RedactUtils;
3
+ export declare const redactUtils: RedactUtils;
4
+ //# sourceMappingURL=redact.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/utils/redact.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEnE,eAAO,MAAM,iBAAiB,QAAO,WAkBpC,CAAA;AAED,eAAO,MAAM,WAAW,aAAsB,CAAA"}
@@ -0,0 +1,18 @@
1
+ export const createRedactUtils = () => {
2
+ const opaque = /^[A-Za-z0-9_-]{20,}$/;
3
+ const url = (input) => {
4
+ let parsed;
5
+ try {
6
+ parsed = typeof input === 'string' ? new URL(input) : input;
7
+ }
8
+ catch {
9
+ return '<invalid-url>';
10
+ }
11
+ const path = parsed.pathname.split('/').map(segment => opaque.test(segment) ? '***' : segment).join('/');
12
+ return `${parsed.protocol}//${parsed.host}${path}`;
13
+ };
14
+ const proxy = (endpoint) => endpoint.id ?? `${endpoint.type}://${endpoint.host}:${endpoint.port}`;
15
+ return { url, proxy };
16
+ };
17
+ export const redactUtils = createRedactUtils();
18
+ //# sourceMappingURL=redact.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"redact.js","sourceRoot":"","sources":["../../src/utils/redact.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAgB,EAAE;IACjD,MAAM,MAAM,GAAG,sBAAsB,CAAA;IAErC,MAAM,GAAG,GAAG,CAAC,KAAmB,EAAU,EAAE;QAC1C,IAAI,MAAW,CAAA;QACf,IAAI,CAAC;YACH,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;QAC7D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,eAAe,CAAA;QACxB,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAExG,OAAO,GAAG,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,IAAI,GAAG,IAAI,EAAE,CAAA;IACpD,CAAC,CAAA;IAED,MAAM,KAAK,GAAG,CAAC,QAAuB,EAAU,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,GAAG,QAAQ,CAAC,IAAI,MAAM,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAA;IAExH,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAA;AACvB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,EAAE,CAAA"}
@@ -0,0 +1,17 @@
1
+ export interface ComposedSignal {
2
+ signal: AbortSignal;
3
+ /** Releases the timer and the listeners on the parent signals. */
4
+ dispose: () => void;
5
+ }
6
+ export interface SignalUtils {
7
+ /**
8
+ * One signal that aborts when any parent aborts (with its reason) or, given `timeoutMs`, when
9
+ * the time runs out (with `reason()`).
10
+ */
11
+ compose: (signals: Array<AbortSignal | undefined>, timeoutMs?: number, reason?: () => Error) => ComposedSignal;
12
+ /** Throws the signal's reason when it already aborted. */
13
+ throwIfAborted: (signal?: AbortSignal) => void;
14
+ /** Calls `listener` once when the signal aborts (in a microtask when it already did); answers the unsubscribe. */
15
+ onAbort: (signal: AbortSignal | undefined, listener: (reason: unknown) => void) => () => void;
16
+ }
17
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/signals/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,CAAA;IACnB,kEAAkE;IAClE,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,OAAO,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,KAAK,cAAc,CAAA;IAC9G,0DAA0D;IAC1D,cAAc,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,IAAI,CAAA;IAC9C,kHAAkH;IAClH,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;CAC9F"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/signals/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,4 @@
1
+ import type { SignalUtils } from './signals/types.js';
2
+ export declare const createSignalUtils: () => SignalUtils;
3
+ export declare const signalUtils: SignalUtils;
4
+ //# sourceMappingURL=signals.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../src/utils/signals.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErE,eAAO,MAAM,iBAAiB,QAAO,WAyDpC,CAAA;AAED,eAAO,MAAM,WAAW,aAAsB,CAAA"}
@@ -0,0 +1,52 @@
1
+ import { LimitError } from '../errors.js';
2
+ export const createSignalUtils = () => {
3
+ const onAbort = (signal, listener) => {
4
+ if (signal == null) {
5
+ return () => undefined;
6
+ }
7
+ if (signal.aborted) {
8
+ // Deferred, so a caller can finish wiring (its own release, its handlers) before it runs.
9
+ let active = true;
10
+ queueMicrotask(() => { if (active)
11
+ listener(signal.reason); });
12
+ return () => { active = false; };
13
+ }
14
+ const handler = () => listener(signal.reason);
15
+ signal.addEventListener('abort', handler, { once: true });
16
+ return () => signal.removeEventListener('abort', handler);
17
+ };
18
+ const compose = (signals, timeoutMs, reason = () => new LimitError('timeout')) => {
19
+ const controller = new AbortController();
20
+ const releases = [];
21
+ let timer;
22
+ const dispose = () => {
23
+ if (timer != null) {
24
+ clearTimeout(timer);
25
+ timer = undefined;
26
+ }
27
+ releases.splice(0).forEach(release => release());
28
+ };
29
+ for (const parent of signals) {
30
+ releases.push(onAbort(parent, cause => {
31
+ controller.abort(cause);
32
+ dispose();
33
+ }));
34
+ }
35
+ if (timeoutMs != null && !controller.signal.aborted) {
36
+ timer = setTimeout(() => {
37
+ controller.abort(reason());
38
+ dispose();
39
+ }, timeoutMs);
40
+ timer.unref?.();
41
+ }
42
+ return { signal: controller.signal, dispose };
43
+ };
44
+ const throwIfAborted = (signal) => {
45
+ if (signal?.aborted === true) {
46
+ throw signal.reason;
47
+ }
48
+ };
49
+ return { compose, throwIfAborted, onAbort };
50
+ };
51
+ export const signalUtils = createSignalUtils();
52
+ //# sourceMappingURL=signals.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"signals.js","sourceRoot":"","sources":["../../src/utils/signals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAGzC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAgB,EAAE;IACjD,MAAM,OAAO,GAAG,CAAC,MAA+B,EAAE,QAAmC,EAAc,EAAE;QACnG,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACnB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAA;QACxB,CAAC;QACD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,0FAA0F;YAC1F,IAAI,MAAM,GAAG,IAAI,CAAA;YACjB,cAAc,CAAC,GAAG,EAAE,GAAG,IAAI,MAAM;gBAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;YAC7D,OAAO,GAAG,EAAE,GAAG,MAAM,GAAG,KAAK,CAAA,CAAC,CAAC,CAAA;QACjC,CAAC;QACD,MAAM,OAAO,GAAG,GAAS,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACnD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QAEzD,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAC3D,CAAC,CAAA;IAED,MAAM,OAAO,GAAG,CACd,OAAuC,EAAE,SAAkB,EAAE,MAAM,GAAgB,GAAG,EAAE,CAAC,IAAI,UAAU,CAAC,SAAS,CAAC,EAClG,EAAE;QAClB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;QACxC,MAAM,QAAQ,GAAsB,EAAE,CAAA;QACtC,IAAI,KAAiC,CAAA;QAErC,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;gBAClB,YAAY,CAAC,KAAK,CAAC,CAAA;gBACnB,KAAK,GAAG,SAAS,CAAA;YACnB,CAAC;YACD,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;QAClD,CAAC,CAAA;QAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE;gBACpC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;gBACvB,OAAO,EAAE,CAAA;YACX,CAAC,CAAC,CAAC,CAAA;QACL,CAAC;QAED,IAAI,SAAS,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACtB,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;gBAC1B,OAAO,EAAE,CAAA;YACX,CAAC,EAAE,SAAS,CAAC,CAAA;YACb,KAAK,CAAC,KAAK,EAAE,EAAE,CAAA;QACjB,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,CAAA;IAC/C,CAAC,CAAA;IAED,MAAM,cAAc,GAAG,CAAC,MAAoB,EAAQ,EAAE;QACpD,IAAI,MAAM,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;YAC7B,MAAM,MAAM,CAAC,MAAM,CAAA;QACrB,CAAC;IACH,CAAC,CAAA;IAED,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,CAAA;AAC7C,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,EAAE,CAAA"}
@@ -0,0 +1,3 @@
1
+ /** How often progress is reported while bytes flow. */
2
+ export declare const DEFAULT_PROGRESS_INTERVAL_MS = 250;
3
+ //# sourceMappingURL=consts.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../../src/utils/streams/consts.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,eAAO,MAAM,4BAA4B,MAAM,CAAA"}
@@ -0,0 +1,3 @@
1
+ /** How often progress is reported while bytes flow. */
2
+ export const DEFAULT_PROGRESS_INTERVAL_MS = 250;
3
+ //# sourceMappingURL=consts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"consts.js","sourceRoot":"","sources":["../../../src/utils/streams/consts.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAA"}
@@ -0,0 +1,59 @@
1
+ import type { Readable, Transform } from 'node:stream';
2
+ import type { StreamInput } from '../../sources/types.js';
3
+ export interface MeterProgress {
4
+ bytes: number;
5
+ total?: number;
6
+ elapsedMs: number;
7
+ }
8
+ export interface MeterOptions {
9
+ /** Refuse with `LimitError('max-bytes')` past this many bytes. */
10
+ maxBytes?: number;
11
+ /** Refuse with `LimitError('idle-timeout')` after this long without a chunk. */
12
+ idleTimeoutMs?: number;
13
+ /** The expected total, reported with progress. */
14
+ total?: number;
15
+ onProgress?: (progress: MeterProgress) => void;
16
+ progressIntervalMs?: number;
17
+ hash?: 'sha256';
18
+ }
19
+ export interface StreamMeter {
20
+ /** The pass-through to pipe the bytes through. */
21
+ readonly stream: Transform;
22
+ /** Bytes that passed so far. */
23
+ bytes: () => number;
24
+ /** Hex sha256 of what passed, once the stream ended and a hash was asked for. */
25
+ sha256: () => string | undefined;
26
+ }
27
+ export interface PeekedStream {
28
+ /** The leading bytes read (at least the asked size unless the stream ended first). */
29
+ head: Uint8Array;
30
+ /** The whole stream again, head included. */
31
+ stream: Readable;
32
+ /** Whether the head is the whole stream. */
33
+ ended: boolean;
34
+ }
35
+ export interface SpoolOptions {
36
+ maxBytes?: number;
37
+ signal?: AbortSignal;
38
+ }
39
+ export interface SpooledFile {
40
+ path: string;
41
+ size: number;
42
+ /** Removes the file and its private directory. */
43
+ dispose: () => Promise<void>;
44
+ }
45
+ export interface StreamUtils {
46
+ /** A Node stream over any accepted input. */
47
+ toReadable: (input: StreamInput | Uint8Array) => Readable;
48
+ /** Counting, limiting, idle-guarding, hashing pass-through. */
49
+ meter: (options: MeterOptions) => StreamMeter;
50
+ /** Reads the head of a stream and hands back a stream that replays it. */
51
+ peek: (stream: Readable, size: number) => Promise<PeekedStream>;
52
+ /** The whole stream in memory, refused past `maxBytes`. */
53
+ collect: (stream: Readable, maxBytes: number) => Promise<Buffer>;
54
+ /** The stream written to a private temporary file. */
55
+ spool: (stream: Readable, options?: SpoolOptions) => Promise<SpooledFile>;
56
+ /** Destroys a stream nobody will read, swallowing its error. */
57
+ discard: (stream: Readable) => void;
58
+ }
59
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/streams/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEzD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAA;IAC9C,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,IAAI,CAAC,EAAE,QAAQ,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;IAC1B,gCAAgC;IAChC,KAAK,EAAE,MAAM,MAAM,CAAA;IACnB,iFAAiF;IACjF,MAAM,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,sFAAsF;IACtF,IAAI,EAAE,UAAU,CAAA;IAChB,6CAA6C;IAC7C,MAAM,EAAE,QAAQ,CAAA;IAChB,4CAA4C;IAC5C,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,UAAU,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG,UAAU,KAAK,QAAQ,CAAA;IACzD,+DAA+D;IAC/D,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,WAAW,CAAA;IAC7C,0EAA0E;IAC1E,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;IAC/D,2DAA2D;IAC3D,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAChE,sDAAsD;IACtD,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC,WAAW,CAAC,CAAA;IACzE,gEAAgE;IAChE,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,IAAI,CAAA;CACpC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/streams/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,4 @@
1
+ import type { StreamUtils } from './streams/types.js';
2
+ export declare const createStreamUtils: () => StreamUtils;
3
+ export declare const streamUtils: StreamUtils;
4
+ //# sourceMappingURL=streams.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"streams.d.ts","sourceRoot":"","sources":["../../src/utils/streams.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAsE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEzH,eAAO,MAAM,iBAAiB,QAAO,WA6KpC,CAAA;AAED,eAAO,MAAM,WAAW,aAAsB,CAAA"}
@@ -0,0 +1,167 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { createWriteStream } from 'node:fs';
3
+ import { mkdtemp, rm } from 'node:fs/promises';
4
+ import { tmpdir } from 'node:os';
5
+ import { join } from 'node:path';
6
+ import { Readable, Transform } from 'node:stream';
7
+ import { pipeline } from 'node:stream/promises';
8
+ import { LimitError } from '../errors.js';
9
+ import { DEFAULT_PROGRESS_INTERVAL_MS } from './streams/consts.js';
10
+ export const createStreamUtils = () => {
11
+ const toReadable = (input) => {
12
+ if (input instanceof Readable) {
13
+ return input;
14
+ }
15
+ if (input instanceof Uint8Array) {
16
+ return Readable.from([Buffer.from(input.buffer, input.byteOffset, input.byteLength)], { objectMode: false });
17
+ }
18
+ if (typeof input.getReader === 'function') {
19
+ return Readable.fromWeb(input);
20
+ }
21
+ return Readable.from(input, { objectMode: false });
22
+ };
23
+ const meter = (options) => {
24
+ const started = Date.now();
25
+ const hash = options.hash === 'sha256' ? createHash('sha256') : undefined;
26
+ const interval = options.progressIntervalMs ?? DEFAULT_PROGRESS_INTERVAL_MS;
27
+ let bytes = 0;
28
+ let lastReport = 0;
29
+ let digest;
30
+ let idle;
31
+ const report = (force) => {
32
+ if (options.onProgress == null) {
33
+ return;
34
+ }
35
+ const now = Date.now();
36
+ if (force || now - lastReport >= interval) {
37
+ lastReport = now;
38
+ options.onProgress({ bytes, total: options.total, elapsedMs: now - started });
39
+ }
40
+ };
41
+ const stopIdle = () => {
42
+ if (idle != null) {
43
+ clearTimeout(idle);
44
+ idle = undefined;
45
+ }
46
+ };
47
+ const transform = new Transform({
48
+ transform: (chunk, _encoding, callback) => {
49
+ bytes += chunk.length;
50
+ if (options.maxBytes != null && bytes > options.maxBytes) {
51
+ stopIdle();
52
+ callback(new LimitError('max-bytes'));
53
+ return;
54
+ }
55
+ hash?.update(chunk);
56
+ armIdle();
57
+ report(false);
58
+ callback(null, chunk);
59
+ },
60
+ flush: callback => {
61
+ stopIdle();
62
+ digest = hash?.digest('hex');
63
+ report(true);
64
+ callback();
65
+ },
66
+ });
67
+ const armIdle = () => {
68
+ if (options.idleTimeoutMs == null) {
69
+ return;
70
+ }
71
+ stopIdle();
72
+ idle = setTimeout(() => transform.destroy(new LimitError('idle-timeout')), options.idleTimeoutMs);
73
+ idle.unref?.();
74
+ };
75
+ transform.once('close', stopIdle);
76
+ armIdle();
77
+ return { stream: transform, bytes: () => bytes, sha256: () => digest };
78
+ };
79
+ const peek = async (stream, size) => {
80
+ const iterator = stream[Symbol.asyncIterator]();
81
+ const chunks = [];
82
+ let length = 0;
83
+ let ended = false;
84
+ try {
85
+ while (length < size) {
86
+ const next = await iterator.next();
87
+ if (next.done === true) {
88
+ ended = true;
89
+ break;
90
+ }
91
+ const chunk = typeof next.value === 'string' ? Buffer.from(next.value) : next.value;
92
+ chunks.push(chunk);
93
+ length += chunk.length;
94
+ }
95
+ }
96
+ catch (error) {
97
+ await iterator.return?.();
98
+ throw error;
99
+ }
100
+ const head = Buffer.concat(chunks, length);
101
+ let finished = ended;
102
+ const replay = async function* () {
103
+ try {
104
+ if (head.length > 0) {
105
+ yield head;
106
+ }
107
+ while (!finished) {
108
+ const next = await iterator.next();
109
+ if (next.done === true) {
110
+ finished = true;
111
+ break;
112
+ }
113
+ yield next.value;
114
+ }
115
+ }
116
+ finally {
117
+ if (!finished) {
118
+ await iterator.return?.();
119
+ }
120
+ }
121
+ };
122
+ const replayed = Readable.from(replay(), { objectMode: false });
123
+ // A replay destroyed before it was read never enters the generator: release the source here.
124
+ replayed.once('close', () => {
125
+ if (!finished) {
126
+ finished = true;
127
+ stream.destroy();
128
+ }
129
+ });
130
+ return { head, stream: replayed, ended };
131
+ };
132
+ const collect = async (stream, maxBytes) => {
133
+ const chunks = [];
134
+ let length = 0;
135
+ for await (const chunk of stream) {
136
+ const buffer = typeof chunk === 'string' ? Buffer.from(chunk) : chunk;
137
+ length += buffer.length;
138
+ if (length > maxBytes) {
139
+ stream.destroy();
140
+ throw new LimitError('max-bytes');
141
+ }
142
+ chunks.push(buffer);
143
+ }
144
+ return Buffer.concat(chunks, length);
145
+ };
146
+ const spool = async (stream, options = {}) => {
147
+ const dir = await mkdtemp(join(tmpdir(), 'owlmeans-file-streams-'));
148
+ const path = join(dir, 'spool');
149
+ const dispose = async () => { await rm(dir, { recursive: true, force: true }); };
150
+ const counter = meter({ maxBytes: options.maxBytes });
151
+ try {
152
+ await pipeline(stream, counter.stream, createWriteStream(path, { mode: 0o600, flags: 'wx' }), { signal: options.signal });
153
+ }
154
+ catch (error) {
155
+ await dispose();
156
+ throw error;
157
+ }
158
+ return { path, size: counter.bytes(), dispose };
159
+ };
160
+ const discard = (stream) => {
161
+ stream.once('error', () => undefined);
162
+ stream.destroy();
163
+ };
164
+ return { toReadable, meter, peek, collect, spool, discard };
165
+ };
166
+ export const streamUtils = createStreamUtils();
167
+ //# sourceMappingURL=streams.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"streams.js","sourceRoot":"","sources":["../../src/utils/streams.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ import type { TreeSink } from '../../types.js';
2
+ export interface TreeUtils {
3
+ /** A view of `tree` whose entries all land under `prefix`. */
4
+ prefixed: (tree: TreeSink, prefix: string) => TreeSink;
5
+ }
6
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/tree/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE9C,MAAM,WAAW,SAAS;IACxB,8DAA8D;IAC9D,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,KAAK,QAAQ,CAAA;CACvD"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/tree/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,4 @@
1
+ import type { TreeUtils } from './tree/types.js';
2
+ export declare const createTreeUtils: () => TreeUtils;
3
+ export declare const treeUtils: TreeUtils;
4
+ //# sourceMappingURL=tree.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../src/utils/tree.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,eAAO,MAAM,eAAe,QAAO,SAWlC,CAAA;AAED,eAAO,MAAM,SAAS,WAAoB,CAAA"}
@@ -0,0 +1,14 @@
1
+ import { pathUtils } from './paths.js';
2
+ export const createTreeUtils = () => {
3
+ const prefixed = (tree, prefix) => {
4
+ const base = pathUtils.entry(prefix);
5
+ return {
6
+ kind: tree.kind,
7
+ entry: path => tree.entry(`${base}/${pathUtils.entry(path)}`),
8
+ directory: async (path, options) => await tree.directory(`${base}/${pathUtils.entry(path)}`, options),
9
+ };
10
+ };
11
+ return { prefixed };
12
+ };
13
+ export const treeUtils = createTreeUtils();
14
+ //# sourceMappingURL=tree.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tree.js","sourceRoot":"","sources":["../../src/utils/tree.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAGtC,MAAM,CAAC,MAAM,eAAe,GAAG,GAAc,EAAE;IAC7C,MAAM,QAAQ,GAAG,CAAC,IAAc,EAAE,MAAc,EAAY,EAAE;QAC5D,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QACpC,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7D,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;SACtG,CAAA;IACH,CAAC,CAAA;IAED,OAAO,EAAE,QAAQ,EAAE,CAAA;AACrB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,eAAe,EAAE,CAAA"}
@@ -0,0 +1,12 @@
1
+ /** The folder under `os.tmpdir()` a workspace lives in when no root is named. */
2
+ export declare const DEFAULT_WORKSPACE_DIR = "owlmeans-workspace";
3
+ /**
4
+ * The file that makes a folder a scope. It is reserved: no entry path may contain a segment of this
5
+ * name, listings never show it.
6
+ */
7
+ export declare const WORKSPACE_SCOPE_MARKER = ".owlmeans-scope";
8
+ /** Mode of the folders a workspace creates: private to the service's user. */
9
+ export declare const DEFAULT_WORKSPACE_DIR_MODE = 448;
10
+ /** Mode of the files a workspace writes. */
11
+ export declare const DEFAULT_WORKSPACE_FILE_MODE = 384;
12
+ //# sourceMappingURL=consts.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../src/workspace/consts.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,uBAAuB,CAAA;AAEzD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,oBAAoB,CAAA;AAEvD,8EAA8E;AAC9E,eAAO,MAAM,0BAA0B,MAAQ,CAAA;AAE/C,4CAA4C;AAC5C,eAAO,MAAM,2BAA2B,MAAQ,CAAA"}
@@ -0,0 +1,12 @@
1
+ /** The folder under `os.tmpdir()` a workspace lives in when no root is named. */
2
+ export const DEFAULT_WORKSPACE_DIR = 'owlmeans-workspace';
3
+ /**
4
+ * The file that makes a folder a scope. It is reserved: no entry path may contain a segment of this
5
+ * name, listings never show it.
6
+ */
7
+ export const WORKSPACE_SCOPE_MARKER = '.owlmeans-scope';
8
+ /** Mode of the folders a workspace creates: private to the service's user. */
9
+ export const DEFAULT_WORKSPACE_DIR_MODE = 0o700;
10
+ /** Mode of the files a workspace writes. */
11
+ export const DEFAULT_WORKSPACE_FILE_MODE = 0o600;
12
+ //# sourceMappingURL=consts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"consts.js","sourceRoot":"","sources":["../../src/workspace/consts.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,CAAC,MAAM,qBAAqB,GAAG,oBAAoB,CAAA;AAEzD;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,iBAAiB,CAAA;AAEvD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAA;AAE/C,4CAA4C;AAC5C,MAAM,CAAC,MAAM,2BAA2B,GAAG,KAAK,CAAA"}
@@ -0,0 +1,3 @@
1
+ /** The private temporary file a file sink writes before it commits (`.<name>.<12 hex>.tmp`). */
2
+ export declare const IN_FLIGHT_FILE: RegExp;
3
+ //# sourceMappingURL=consts.local.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"consts.local.d.ts","sourceRoot":"","sources":["../../src/workspace/consts.local.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,eAAO,MAAM,cAAc,QAA8B,CAAA"}
@@ -0,0 +1,3 @@
1
+ /** The private temporary file a file sink writes before it commits (`.<name>.<12 hex>.tmp`). */
2
+ export const IN_FLIGHT_FILE = /^\..+\.[0-9a-f]{12}\.tmp$/;
3
+ //# sourceMappingURL=consts.local.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"consts.local.js","sourceRoot":"","sources":["../../src/workspace/consts.local.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,MAAM,CAAC,MAAM,cAAc,GAAG,2BAA2B,CAAA"}
@@ -0,0 +1,4 @@
1
+ import type { WorkspaceFs } from './types.local.js';
2
+ export declare const createWorkspaceFs: () => WorkspaceFs;
3
+ export declare const workspaceFs: WorkspaceFs;
4
+ //# sourceMappingURL=fs.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/workspace/fs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,eAAO,MAAM,iBAAiB,QAAO,WAyCpC,CAAA;AAED,eAAO,MAAM,WAAW,aAAsB,CAAA"}