@workerstack/clients 0.0.0-stage → 1.0.0-rc.24

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 (558) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +619 -2
  3. package/bin/honey-clients.js +94 -0
  4. package/dist/cli.d.ts +102 -0
  5. package/dist/cli.js +190 -0
  6. package/dist/emit/cli/channels.d.ts +73 -0
  7. package/dist/emit/cli/channels.js +197 -0
  8. package/dist/emit/cli/commands.d.ts +27 -0
  9. package/dist/emit/cli/commands.js +187 -0
  10. package/dist/emit/cli/discovery.d.ts +35 -0
  11. package/dist/emit/cli/discovery.js +202 -0
  12. package/dist/emit/cli/flags.d.ts +59 -0
  13. package/dist/emit/cli/flags.js +186 -0
  14. package/dist/emit/cli/index.d.ts +1 -0
  15. package/dist/emit/cli/index.js +1 -0
  16. package/dist/emit/cli/install.d.ts +37 -0
  17. package/dist/emit/cli/install.js +88 -0
  18. package/dist/emit/cli/layout.d.ts +23 -0
  19. package/dist/emit/cli/layout.js +118 -0
  20. package/dist/emit/cli/module.d.ts +30 -0
  21. package/dist/emit/cli/module.js +186 -0
  22. package/dist/emit/cli/release.d.ts +40 -0
  23. package/dist/emit/cli/release.js +183 -0
  24. package/dist/emit/cli/skills.d.ts +11 -0
  25. package/dist/emit/cli/skills.js +56 -0
  26. package/dist/emit/csharp/errors.d.ts +7 -0
  27. package/dist/emit/csharp/errors.js +69 -0
  28. package/dist/emit/csharp/index.d.ts +1 -0
  29. package/dist/emit/csharp/index.js +1 -0
  30. package/dist/emit/csharp/json.d.ts +13 -0
  31. package/dist/emit/csharp/json.js +113 -0
  32. package/dist/emit/csharp/realtime.d.ts +10 -0
  33. package/dist/emit/csharp/realtime.js +33 -0
  34. package/dist/emit/csharp/sdk-answer.d.ts +48 -0
  35. package/dist/emit/csharp/sdk-answer.js +85 -0
  36. package/dist/emit/csharp/sdk-body.d.ts +10 -0
  37. package/dist/emit/csharp/sdk-body.js +87 -0
  38. package/dist/emit/csharp/sdk-client.d.ts +32 -0
  39. package/dist/emit/csharp/sdk-client.js +177 -0
  40. package/dist/emit/csharp/sdk-csproj.d.ts +36 -0
  41. package/dist/emit/csharp/sdk-csproj.js +136 -0
  42. package/dist/emit/csharp/sdk-doc.d.ts +12 -0
  43. package/dist/emit/csharp/sdk-doc.js +35 -0
  44. package/dist/emit/csharp/sdk-method.d.ts +26 -0
  45. package/dist/emit/csharp/sdk-method.js +187 -0
  46. package/dist/emit/csharp/sdk-plan.d.ts +38 -0
  47. package/dist/emit/csharp/sdk-plan.js +1 -0
  48. package/dist/emit/csharp/sdk.d.ts +40 -0
  49. package/dist/emit/csharp/sdk.js +105 -0
  50. package/dist/emit/csharp/sse.d.ts +18 -0
  51. package/dist/emit/csharp/sse.js +29 -0
  52. package/dist/emit/csharp/transport.d.ts +11 -0
  53. package/dist/emit/csharp/transport.js +67 -0
  54. package/dist/emit/csharp/types-enum.d.ts +19 -0
  55. package/dist/emit/csharp/types-enum.js +63 -0
  56. package/dist/emit/csharp/types-names.d.ts +33 -0
  57. package/dist/emit/csharp/types-names.js +182 -0
  58. package/dist/emit/csharp/types-record.d.ts +25 -0
  59. package/dist/emit/csharp/types-record.js +65 -0
  60. package/dist/emit/csharp/types-union.d.ts +27 -0
  61. package/dist/emit/csharp/types-union.js +113 -0
  62. package/dist/emit/csharp/types.d.ts +36 -0
  63. package/dist/emit/csharp/types.js +126 -0
  64. package/dist/emit/csharp/ws.d.ts +20 -0
  65. package/dist/emit/csharp/ws.js +14 -0
  66. package/dist/emit/go/errors.d.ts +7 -0
  67. package/dist/emit/go/errors.js +44 -0
  68. package/dist/emit/go/http.d.ts +11 -0
  69. package/dist/emit/go/http.js +50 -0
  70. package/dist/emit/go/index.d.ts +1 -0
  71. package/dist/emit/go/index.js +1 -0
  72. package/dist/emit/go/module-path.d.ts +2 -0
  73. package/dist/emit/go/module-path.js +27 -0
  74. package/dist/emit/go/sdk-answer.d.ts +28 -0
  75. package/dist/emit/go/sdk-answer.js +41 -0
  76. package/dist/emit/go/sdk-body.d.ts +24 -0
  77. package/dist/emit/go/sdk-body.js +76 -0
  78. package/dist/emit/go/sdk-client.d.ts +29 -0
  79. package/dist/emit/go/sdk-client.js +141 -0
  80. package/dist/emit/go/sdk-method.d.ts +68 -0
  81. package/dist/emit/go/sdk-method.js +172 -0
  82. package/dist/emit/go/sdk-mirror.d.ts +23 -0
  83. package/dist/emit/go/sdk-mirror.js +97 -0
  84. package/dist/emit/go/sdk-opts.d.ts +55 -0
  85. package/dist/emit/go/sdk-opts.js +100 -0
  86. package/dist/emit/go/sdk.d.ts +26 -0
  87. package/dist/emit/go/sdk.js +111 -0
  88. package/dist/emit/go/sse.d.ts +16 -0
  89. package/dist/emit/go/sse.js +26 -0
  90. package/dist/emit/go/types-codec.d.ts +15 -0
  91. package/dist/emit/go/types-codec.js +171 -0
  92. package/dist/emit/go/types-names.d.ts +14 -0
  93. package/dist/emit/go/types-names.js +64 -0
  94. package/dist/emit/go/types-struct.d.ts +29 -0
  95. package/dist/emit/go/types-struct.js +65 -0
  96. package/dist/emit/go/types-union.d.ts +17 -0
  97. package/dist/emit/go/types-union.js +84 -0
  98. package/dist/emit/go/types.d.ts +32 -0
  99. package/dist/emit/go/types.js +177 -0
  100. package/dist/emit/go/ws.d.ts +12 -0
  101. package/dist/emit/go/ws.js +70 -0
  102. package/dist/emit/java/gradle.d.ts +57 -0
  103. package/dist/emit/java/gradle.js +221 -0
  104. package/dist/emit/java/index.d.ts +2 -0
  105. package/dist/emit/java/index.js +2 -0
  106. package/dist/emit/java/json.d.ts +13 -0
  107. package/dist/emit/java/json.js +84 -0
  108. package/dist/emit/java/layout-ast.d.ts +146 -0
  109. package/dist/emit/java/layout-ast.js +102 -0
  110. package/dist/emit/java/layout-decl.d.ts +20 -0
  111. package/dist/emit/java/layout-decl.js +155 -0
  112. package/dist/emit/java/layout-doc.d.ts +55 -0
  113. package/dist/emit/java/layout-doc.js +166 -0
  114. package/dist/emit/java/layout-dot.d.ts +18 -0
  115. package/dist/emit/java/layout-dot.js +127 -0
  116. package/dist/emit/java/layout-strings.d.ts +8 -0
  117. package/dist/emit/java/layout-strings.js +76 -0
  118. package/dist/emit/java/layout-types.d.ts +11 -0
  119. package/dist/emit/java/layout-types.js +95 -0
  120. package/dist/emit/java/layout-visitor.d.ts +38 -0
  121. package/dist/emit/java/layout-visitor.js +232 -0
  122. package/dist/emit/java/layout.d.ts +61 -0
  123. package/dist/emit/java/layout.js +121 -0
  124. package/dist/emit/java/models-enum.d.ts +17 -0
  125. package/dist/emit/java/models-enum.js +51 -0
  126. package/dist/emit/java/models-names.d.ts +29 -0
  127. package/dist/emit/java/models-names.js +97 -0
  128. package/dist/emit/java/models-record.d.ts +24 -0
  129. package/dist/emit/java/models-record.js +79 -0
  130. package/dist/emit/java/models-union.d.ts +27 -0
  131. package/dist/emit/java/models-union.js +86 -0
  132. package/dist/emit/java/models.d.ts +28 -0
  133. package/dist/emit/java/models.js +118 -0
  134. package/dist/emit/java/realtime.d.ts +50 -0
  135. package/dist/emit/java/realtime.js +69 -0
  136. package/dist/emit/java/sdk-client.d.ts +66 -0
  137. package/dist/emit/java/sdk-client.js +207 -0
  138. package/dist/emit/java/sdk-decl.d.ts +11 -0
  139. package/dist/emit/java/sdk-decl.js +63 -0
  140. package/dist/emit/java/sdk-errors.d.ts +13 -0
  141. package/dist/emit/java/sdk-errors.js +141 -0
  142. package/dist/emit/java/sdk-headers.d.ts +12 -0
  143. package/dist/emit/java/sdk-headers.js +74 -0
  144. package/dist/emit/java/sdk-mirror.d.ts +14 -0
  145. package/dist/emit/java/sdk-mirror.js +107 -0
  146. package/dist/emit/java/sdk-models.d.ts +16 -0
  147. package/dist/emit/java/sdk-models.js +68 -0
  148. package/dist/emit/java/sdk-op.d.ts +57 -0
  149. package/dist/emit/java/sdk-op.js +216 -0
  150. package/dist/emit/java/sdk-params.d.ts +38 -0
  151. package/dist/emit/java/sdk-params.js +133 -0
  152. package/dist/emit/java/sdk-plan.d.ts +52 -0
  153. package/dist/emit/java/sdk-plan.js +1 -0
  154. package/dist/emit/java/sdk-record.d.ts +16 -0
  155. package/dist/emit/java/sdk-record.js +99 -0
  156. package/dist/emit/java/sdk.d.ts +49 -0
  157. package/dist/emit/java/sdk.js +216 -0
  158. package/dist/emit/java/sse.d.ts +35 -0
  159. package/dist/emit/java/sse.js +57 -0
  160. package/dist/emit/java/ws.d.ts +27 -0
  161. package/dist/emit/java/ws.js +31 -0
  162. package/dist/emit/mcp/annotations.d.ts +15 -0
  163. package/dist/emit/mcp/annotations.js +15 -0
  164. package/dist/emit/mcp/files.d.ts +18 -0
  165. package/dist/emit/mcp/files.js +42 -0
  166. package/dist/emit/mcp/index.d.ts +3 -0
  167. package/dist/emit/mcp/index.js +3 -0
  168. package/dist/emit/mcp/literal.d.ts +2 -0
  169. package/dist/emit/mcp/literal.js +33 -0
  170. package/dist/emit/mcp/mounted.d.ts +21 -0
  171. package/dist/emit/mcp/mounted.js +89 -0
  172. package/dist/emit/mcp/output-schema.d.ts +18 -0
  173. package/dist/emit/mcp/output-schema.js +38 -0
  174. package/dist/emit/mcp/registry.d.ts +23 -0
  175. package/dist/emit/mcp/registry.js +83 -0
  176. package/dist/emit/mcp/runtime.d.ts +10 -0
  177. package/dist/emit/mcp/runtime.js +47 -0
  178. package/dist/emit/mcp/schema.d.ts +19 -0
  179. package/dist/emit/mcp/schema.js +88 -0
  180. package/dist/emit/mcp/server.d.ts +30 -0
  181. package/dist/emit/mcp/server.js +246 -0
  182. package/dist/emit/mcp/tools.d.ts +51 -0
  183. package/dist/emit/mcp/tools.js +153 -0
  184. package/dist/emit/python/errors.d.ts +8 -0
  185. package/dist/emit/python/errors.js +68 -0
  186. package/dist/emit/python/index.d.ts +1 -0
  187. package/dist/emit/python/index.js +1 -0
  188. package/dist/emit/python/realtime.d.ts +10 -0
  189. package/dist/emit/python/realtime.js +33 -0
  190. package/dist/emit/python/sdk-answer.d.ts +49 -0
  191. package/dist/emit/python/sdk-answer.js +89 -0
  192. package/dist/emit/python/sdk-body.d.ts +11 -0
  193. package/dist/emit/python/sdk-body.js +40 -0
  194. package/dist/emit/python/sdk-client.d.ts +36 -0
  195. package/dist/emit/python/sdk-client.js +163 -0
  196. package/dist/emit/python/sdk-doc.d.ts +9 -0
  197. package/dist/emit/python/sdk-doc.js +32 -0
  198. package/dist/emit/python/sdk-imports.d.ts +14 -0
  199. package/dist/emit/python/sdk-imports.js +38 -0
  200. package/dist/emit/python/sdk-method.d.ts +29 -0
  201. package/dist/emit/python/sdk-method.js +183 -0
  202. package/dist/emit/python/sdk-plan.d.ts +33 -0
  203. package/dist/emit/python/sdk-plan.js +1 -0
  204. package/dist/emit/python/sdk-pyproject.d.ts +27 -0
  205. package/dist/emit/python/sdk-pyproject.js +103 -0
  206. package/dist/emit/python/sdk.d.ts +22 -0
  207. package/dist/emit/python/sdk.js +154 -0
  208. package/dist/emit/python/sse.d.ts +12 -0
  209. package/dist/emit/python/sse.js +23 -0
  210. package/dist/emit/python/transport.d.ts +15 -0
  211. package/dist/emit/python/transport.js +60 -0
  212. package/dist/emit/python/types-dict.d.ts +31 -0
  213. package/dist/emit/python/types-dict.js +45 -0
  214. package/dist/emit/python/types-names.d.ts +16 -0
  215. package/dist/emit/python/types-names.js +52 -0
  216. package/dist/emit/python/types-union.d.ts +32 -0
  217. package/dist/emit/python/types-union.js +46 -0
  218. package/dist/emit/python/types.d.ts +36 -0
  219. package/dist/emit/python/types.js +128 -0
  220. package/dist/emit/python/ws.d.ts +14 -0
  221. package/dist/emit/python/ws.js +16 -0
  222. package/dist/emit/rust/errors.d.ts +7 -0
  223. package/dist/emit/rust/errors.js +107 -0
  224. package/dist/emit/rust/http.d.ts +13 -0
  225. package/dist/emit/rust/http.js +67 -0
  226. package/dist/emit/rust/index.d.ts +1 -0
  227. package/dist/emit/rust/index.js +1 -0
  228. package/dist/emit/rust/realtime.d.ts +11 -0
  229. package/dist/emit/rust/realtime.js +29 -0
  230. package/dist/emit/rust/sdk-body.d.ts +19 -0
  231. package/dist/emit/rust/sdk-body.js +53 -0
  232. package/dist/emit/rust/sdk-cargo.d.ts +43 -0
  233. package/dist/emit/rust/sdk-cargo.js +178 -0
  234. package/dist/emit/rust/sdk-client.d.ts +25 -0
  235. package/dist/emit/rust/sdk-client.js +108 -0
  236. package/dist/emit/rust/sdk-method.d.ts +15 -0
  237. package/dist/emit/rust/sdk-method.js +119 -0
  238. package/dist/emit/rust/sdk-opts.d.ts +58 -0
  239. package/dist/emit/rust/sdk-opts.js +117 -0
  240. package/dist/emit/rust/sdk-plan.d.ts +33 -0
  241. package/dist/emit/rust/sdk-plan.js +1 -0
  242. package/dist/emit/rust/sdk.d.ts +23 -0
  243. package/dist/emit/rust/sdk.js +111 -0
  244. package/dist/emit/rust/sse.d.ts +19 -0
  245. package/dist/emit/rust/sse.js +20 -0
  246. package/dist/emit/rust/types-enum.d.ts +13 -0
  247. package/dist/emit/rust/types-enum.js +62 -0
  248. package/dist/emit/rust/types-names.d.ts +19 -0
  249. package/dist/emit/rust/types-names.js +66 -0
  250. package/dist/emit/rust/types-struct.d.ts +21 -0
  251. package/dist/emit/rust/types-struct.js +59 -0
  252. package/dist/emit/rust/types-union.d.ts +24 -0
  253. package/dist/emit/rust/types-union.js +97 -0
  254. package/dist/emit/rust/types.d.ts +34 -0
  255. package/dist/emit/rust/types.js +105 -0
  256. package/dist/emit/rust/ws.d.ts +21 -0
  257. package/dist/emit/rust/ws.js +20 -0
  258. package/dist/emit/shared/escape.d.ts +55 -0
  259. package/dist/emit/shared/escape.js +144 -0
  260. package/dist/emit/shared/format.d.ts +24 -0
  261. package/dist/emit/shared/format.js +23 -0
  262. package/dist/emit/shared/gofmt.d.ts +3 -0
  263. package/dist/emit/shared/gofmt.js +26 -0
  264. package/dist/emit/shared/lang.d.ts +60 -0
  265. package/dist/emit/shared/lang.js +233 -0
  266. package/dist/emit/shared/literals.d.ts +4 -0
  267. package/dist/emit/shared/literals.js +31 -0
  268. package/dist/emit/shared/metadata.d.ts +106 -0
  269. package/dist/emit/shared/metadata.js +130 -0
  270. package/dist/emit/shared/mirror.d.ts +22 -0
  271. package/dist/emit/shared/mirror.js +26 -0
  272. package/dist/emit/shared/ruff.d.ts +3 -0
  273. package/dist/emit/shared/ruff.js +31 -0
  274. package/dist/emit/shared/rustfmt.d.ts +3 -0
  275. package/dist/emit/shared/rustfmt.js +32 -0
  276. package/dist/emit/shared/status-keys.d.ts +7 -0
  277. package/dist/emit/shared/status-keys.js +67 -0
  278. package/dist/emit/shared/type-emitter.d.ts +19 -0
  279. package/dist/emit/shared/type-emitter.js +100 -0
  280. package/dist/emit/ts/app-client.d.ts +4 -0
  281. package/dist/emit/ts/app-client.js +68 -0
  282. package/dist/emit/ts/http.d.ts +20 -0
  283. package/dist/emit/ts/http.js +74 -0
  284. package/dist/emit/ts/package.d.ts +36 -0
  285. package/dist/emit/ts/package.js +126 -0
  286. package/dist/emit/ts/route-tree.d.ts +68 -0
  287. package/dist/emit/ts/route-tree.js +240 -0
  288. package/dist/emit/ts/sdk-types-preamble.d.ts +14 -0
  289. package/dist/emit/ts/sdk-types-preamble.js +123 -0
  290. package/dist/emit/ts/sdk-types.d.ts +13 -0
  291. package/dist/emit/ts/sdk-types.js +213 -0
  292. package/dist/emit/ts/sdk.d.ts +21 -0
  293. package/dist/emit/ts/sdk.js +173 -0
  294. package/dist/emit/ts/service-map.d.ts +40 -0
  295. package/dist/emit/ts/service-map.js +171 -0
  296. package/dist/emit/ts/tanstack-query.d.ts +12 -0
  297. package/dist/emit/ts/tanstack-query.js +156 -0
  298. package/dist/emit/ts/type-gen.d.ts +26 -0
  299. package/dist/emit/ts/type-gen.js +255 -0
  300. package/dist/emit/ts/webhooks.d.ts +19 -0
  301. package/dist/emit/ts/webhooks.js +81 -0
  302. package/dist/extract/chain.d.ts +34 -0
  303. package/dist/extract/chain.js +84 -0
  304. package/dist/extract/extract.d.ts +41 -0
  305. package/dist/extract/extract.js +191 -0
  306. package/dist/extract/serialize.d.ts +34 -0
  307. package/dist/extract/serialize.js +295 -0
  308. package/dist/extract/walk.d.ts +47 -0
  309. package/dist/extract/walk.js +109 -0
  310. package/dist/gen/args.d.ts +28 -0
  311. package/dist/gen/args.js +133 -0
  312. package/dist/gen/formatters.d.ts +62 -0
  313. package/dist/gen/formatters.js +146 -0
  314. package/dist/gen/process.d.ts +13 -0
  315. package/dist/gen/process.js +35 -0
  316. package/dist/gen/shipped.d.ts +17 -0
  317. package/dist/gen/shipped.js +55 -0
  318. package/dist/gen/targets.d.ts +93 -0
  319. package/dist/gen/targets.js +171 -0
  320. package/dist/gen/write.d.ts +33 -0
  321. package/dist/gen/write.js +118 -0
  322. package/dist/index.d.ts +13 -0
  323. package/dist/index.js +15 -0
  324. package/dist/ir/build.d.ts +37 -0
  325. package/dist/ir/build.js +152 -0
  326. package/dist/ir/load.d.ts +11 -0
  327. package/dist/ir/load.js +112 -0
  328. package/dist/ir/model.d.ts +206 -0
  329. package/dist/ir/model.js +5 -0
  330. package/dist/ir/resolve-refs.d.ts +11 -0
  331. package/dist/ir/resolve-refs.js +66 -0
  332. package/dist/ir/resource-tree.d.ts +9 -0
  333. package/dist/ir/resource-tree.js +53 -0
  334. package/dist/ir/route-tree-intern.d.ts +18 -0
  335. package/dist/ir/route-tree-intern.js +174 -0
  336. package/dist/ir/schema.d.ts +11 -0
  337. package/dist/ir/schema.js +192 -0
  338. package/dist/ir/sdk-model.d.ts +86 -0
  339. package/dist/ir/sdk-model.js +204 -0
  340. package/dist/ir/slots.d.ts +42 -0
  341. package/dist/ir/slots.js +245 -0
  342. package/dist/runtime/cli/body.go +176 -0
  343. package/dist/runtime/cli/config.go +243 -0
  344. package/dist/runtime/cli/discovery.go +147 -0
  345. package/dist/runtime/cli/format.go +174 -0
  346. package/dist/runtime/cli/log.go +117 -0
  347. package/dist/runtime/cli/output.go +247 -0
  348. package/dist/runtime/cli/params.go +197 -0
  349. package/dist/runtime/cli/run.go +226 -0
  350. package/dist/runtime/cli/socket.go +60 -0
  351. package/dist/runtime/cli/stream.go +217 -0
  352. package/dist/runtime/cli/target.go +117 -0
  353. package/dist/runtime/csharp/Adapters.cs +183 -0
  354. package/dist/runtime/csharp/Auth.cs +56 -0
  355. package/dist/runtime/csharp/Body.cs +135 -0
  356. package/dist/runtime/csharp/Config.cs +161 -0
  357. package/dist/runtime/csharp/Envelope.cs +149 -0
  358. package/dist/runtime/csharp/Errors.cs +194 -0
  359. package/dist/runtime/csharp/Events.cs +155 -0
  360. package/dist/runtime/csharp/Exchange.cs +247 -0
  361. package/dist/runtime/csharp/Handler.cs +103 -0
  362. package/dist/runtime/csharp/Hooks.cs +128 -0
  363. package/dist/runtime/csharp/Invalidation.cs +102 -0
  364. package/dist/runtime/csharp/Json.cs +144 -0
  365. package/dist/runtime/csharp/Log.cs +48 -0
  366. package/dist/runtime/csharp/Operation.cs +33 -0
  367. package/dist/runtime/csharp/Path.cs +65 -0
  368. package/dist/runtime/csharp/Query.cs +72 -0
  369. package/dist/runtime/csharp/Realtime.cs +118 -0
  370. package/dist/runtime/csharp/RealtimeLoop.cs +236 -0
  371. package/dist/runtime/csharp/Redirect.cs +53 -0
  372. package/dist/runtime/csharp/Result.cs +57 -0
  373. package/dist/runtime/csharp/Sse.cs +122 -0
  374. package/dist/runtime/csharp/Stale.cs +151 -0
  375. package/dist/runtime/csharp/Transport.cs +143 -0
  376. package/dist/runtime/csharp/TransportLongPoll.cs +63 -0
  377. package/dist/runtime/csharp/TransportSse.cs +54 -0
  378. package/dist/runtime/csharp/TransportWs.cs +40 -0
  379. package/dist/runtime/csharp/Wire.cs +109 -0
  380. package/dist/runtime/csharp/Ws.cs +300 -0
  381. package/dist/runtime/csharp/WsDial.cs +127 -0
  382. package/dist/runtime/go/auth.go +127 -0
  383. package/dist/runtime/go/body.go +129 -0
  384. package/dist/runtime/go/config.go +75 -0
  385. package/dist/runtime/go/errors.go +185 -0
  386. package/dist/runtime/go/export.go +37 -0
  387. package/dist/runtime/go/hooks.go +53 -0
  388. package/dist/runtime/go/invalidation.go +112 -0
  389. package/dist/runtime/go/log.go +92 -0
  390. package/dist/runtime/go/nullable.go +64 -0
  391. package/dist/runtime/go/options.go +118 -0
  392. package/dist/runtime/go/path.go +156 -0
  393. package/dist/runtime/go/query.go +147 -0
  394. package/dist/runtime/go/realtime.go +239 -0
  395. package/dist/runtime/go/realtime_loop.go +208 -0
  396. package/dist/runtime/go/redirect.go +124 -0
  397. package/dist/runtime/go/request.go +222 -0
  398. package/dist/runtime/go/result.go +86 -0
  399. package/dist/runtime/go/sse.go +186 -0
  400. package/dist/runtime/go/stale.go +229 -0
  401. package/dist/runtime/go/stream.go +105 -0
  402. package/dist/runtime/go/transport.go +242 -0
  403. package/dist/runtime/go/transport_longpoll.go +121 -0
  404. package/dist/runtime/go/transport_sse.go +175 -0
  405. package/dist/runtime/go/ws.go +205 -0
  406. package/dist/runtime/java/Answer.java +107 -0
  407. package/dist/runtime/java/ApiException.java +110 -0
  408. package/dist/runtime/java/BinaryBody.java +36 -0
  409. package/dist/runtime/java/Body.java +105 -0
  410. package/dist/runtime/java/Call.java +23 -0
  411. package/dist/runtime/java/CallLog.java +51 -0
  412. package/dist/runtime/java/ClientConfig.java +233 -0
  413. package/dist/runtime/java/ConnectionState.java +12 -0
  414. package/dist/runtime/java/Credential.java +58 -0
  415. package/dist/runtime/java/Deadline.java +38 -0
  416. package/dist/runtime/java/Decode.java +181 -0
  417. package/dist/runtime/java/Envelope.java +141 -0
  418. package/dist/runtime/java/ErrorEnvelope.java +23 -0
  419. package/dist/runtime/java/EventStream.java +129 -0
  420. package/dist/runtime/java/Exchange.java +62 -0
  421. package/dist/runtime/java/FilePart.java +5 -0
  422. package/dist/runtime/java/Flight.java +306 -0
  423. package/dist/runtime/java/HoneyException.java +14 -0
  424. package/dist/runtime/java/Hooks.java +47 -0
  425. package/dist/runtime/java/Hops.java +133 -0
  426. package/dist/runtime/java/InvalidationConfig.java +73 -0
  427. package/dist/runtime/java/Json.java +23 -0
  428. package/dist/runtime/java/Keepalive.java +60 -0
  429. package/dist/runtime/java/LogEntry.java +14 -0
  430. package/dist/runtime/java/LongPollAdapter.java +68 -0
  431. package/dist/runtime/java/Operation.java +21 -0
  432. package/dist/runtime/java/Opt.java +121 -0
  433. package/dist/runtime/java/Pump.java +160 -0
  434. package/dist/runtime/java/RawResponse.java +48 -0
  435. package/dist/runtime/java/Realtime.java +152 -0
  436. package/dist/runtime/java/RealtimeLoop.java +371 -0
  437. package/dist/runtime/java/RedirectPolicy.java +13 -0
  438. package/dist/runtime/java/Redirects.java +126 -0
  439. package/dist/runtime/java/RequestContext.java +78 -0
  440. package/dist/runtime/java/RequestHook.java +9 -0
  441. package/dist/runtime/java/RequestOptions.java +91 -0
  442. package/dist/runtime/java/ResponseContext.java +70 -0
  443. package/dist/runtime/java/ResponseHook.java +12 -0
  444. package/dist/runtime/java/Result.java +32 -0
  445. package/dist/runtime/java/ResumableConnection.java +165 -0
  446. package/dist/runtime/java/SdkException.java +11 -0
  447. package/dist/runtime/java/Socket.java +301 -0
  448. package/dist/runtime/java/Sse.java +171 -0
  449. package/dist/runtime/java/SseAdapter.java +61 -0
  450. package/dist/runtime/java/SseEvent.java +10 -0
  451. package/dist/runtime/java/StaleMeta.java +16 -0
  452. package/dist/runtime/java/StaleTracker.java +287 -0
  453. package/dist/runtime/java/Transport.java +16 -0
  454. package/dist/runtime/java/TransportAdapter.java +14 -0
  455. package/dist/runtime/java/TransportConnection.java +15 -0
  456. package/dist/runtime/java/TransportKind.java +12 -0
  457. package/dist/runtime/java/TransportMessage.java +9 -0
  458. package/dist/runtime/java/TransportOptions.java +138 -0
  459. package/dist/runtime/java/TypedWebSocket.java +83 -0
  460. package/dist/runtime/java/UrlPath.java +49 -0
  461. package/dist/runtime/java/UrlQuery.java +99 -0
  462. package/dist/runtime/java/WsAdapter.java +52 -0
  463. package/dist/runtime/java/WsClose.java +47 -0
  464. package/dist/runtime/java/WsDial.java +148 -0
  465. package/dist/runtime/java/WsMessage.java +18 -0
  466. package/dist/runtime/mcp/call.ts +167 -0
  467. package/dist/runtime/mcp/files.ts +183 -0
  468. package/dist/runtime/mcp/guard.ts +176 -0
  469. package/dist/runtime/mcp/http.ts +159 -0
  470. package/dist/runtime/mcp/jsonrpc.ts +50 -0
  471. package/dist/runtime/mcp/listen.ts +76 -0
  472. package/dist/runtime/mcp/mount.ts +123 -0
  473. package/dist/runtime/mcp/protocol.ts +219 -0
  474. package/dist/runtime/mcp/reader.ts +57 -0
  475. package/dist/runtime/mcp/result.ts +85 -0
  476. package/dist/runtime/mcp/stdio.ts +79 -0
  477. package/dist/runtime/mcp/stream.ts +62 -0
  478. package/dist/runtime/python/__init__.py +2 -0
  479. package/dist/runtime/python/auth.py +67 -0
  480. package/dist/runtime/python/body.py +83 -0
  481. package/dist/runtime/python/config.py +139 -0
  482. package/dist/runtime/python/errors.py +213 -0
  483. package/dist/runtime/python/events.py +152 -0
  484. package/dist/runtime/python/exchange.py +298 -0
  485. package/dist/runtime/python/hooks.py +86 -0
  486. package/dist/runtime/python/invalidation.py +57 -0
  487. package/dist/runtime/python/log.py +60 -0
  488. package/dist/runtime/python/operation.py +25 -0
  489. package/dist/runtime/python/path.py +41 -0
  490. package/dist/runtime/python/query.py +48 -0
  491. package/dist/runtime/python/realtime.py +244 -0
  492. package/dist/runtime/python/redirect.py +93 -0
  493. package/dist/runtime/python/result.py +58 -0
  494. package/dist/runtime/python/send_async.py +189 -0
  495. package/dist/runtime/python/send_sync.py +105 -0
  496. package/dist/runtime/python/sse.py +81 -0
  497. package/dist/runtime/python/stale.py +94 -0
  498. package/dist/runtime/python/transport.py +157 -0
  499. package/dist/runtime/python/transport_longpoll.py +60 -0
  500. package/dist/runtime/python/transport_sse.py +60 -0
  501. package/dist/runtime/python/transport_ws.py +57 -0
  502. package/dist/runtime/python/ws.py +276 -0
  503. package/dist/runtime/rust/Cargo.lock +1763 -0
  504. package/dist/runtime/rust/answer.rs +120 -0
  505. package/dist/runtime/rust/auth.rs +80 -0
  506. package/dist/runtime/rust/body.rs +150 -0
  507. package/dist/runtime/rust/call.rs +200 -0
  508. package/dist/runtime/rust/config.rs +254 -0
  509. package/dist/runtime/rust/envelope.rs +84 -0
  510. package/dist/runtime/rust/errors.rs +235 -0
  511. package/dist/runtime/rust/events.rs +177 -0
  512. package/dist/runtime/rust/exchange.rs +287 -0
  513. package/dist/runtime/rust/hooks.rs +63 -0
  514. package/dist/runtime/rust/invalidation.rs +84 -0
  515. package/dist/runtime/rust/log.rs +88 -0
  516. package/dist/runtime/rust/nullable.rs +13 -0
  517. package/dist/runtime/rust/path.rs +83 -0
  518. package/dist/runtime/rust/query.rs +84 -0
  519. package/dist/runtime/rust/realtime.rs +182 -0
  520. package/dist/runtime/rust/realtime_loop.rs +177 -0
  521. package/dist/runtime/rust/redirect.rs +121 -0
  522. package/dist/runtime/rust/request.rs +178 -0
  523. package/dist/runtime/rust/result.rs +101 -0
  524. package/dist/runtime/rust/sse.rs +104 -0
  525. package/dist/runtime/rust/stale.rs +209 -0
  526. package/dist/runtime/rust/transport.rs +221 -0
  527. package/dist/runtime/rust/transport_longpoll.rs +108 -0
  528. package/dist/runtime/rust/transport_sse.rs +91 -0
  529. package/dist/runtime/rust/transport_ws.rs +75 -0
  530. package/dist/runtime/rust/ws.rs +322 -0
  531. package/dist/runtime/ts/app-types.ts +200 -0
  532. package/dist/runtime/ts/app.ts +104 -0
  533. package/dist/runtime/ts/config.ts +124 -0
  534. package/dist/runtime/ts/defaults.ts +48 -0
  535. package/dist/runtime/ts/error.ts +113 -0
  536. package/dist/runtime/ts/hooks.ts +92 -0
  537. package/dist/runtime/ts/http.ts +228 -0
  538. package/dist/runtime/ts/media-type.ts +36 -0
  539. package/dist/runtime/ts/path.ts +152 -0
  540. package/dist/runtime/ts/realtime-connection.ts +296 -0
  541. package/dist/runtime/ts/realtime-transports.ts +149 -0
  542. package/dist/runtime/ts/realtime.ts +293 -0
  543. package/dist/runtime/ts/redirect-policy.ts +17 -0
  544. package/dist/runtime/ts/redirects.ts +74 -0
  545. package/dist/runtime/ts/request.ts +239 -0
  546. package/dist/runtime/ts/response.ts +219 -0
  547. package/dist/runtime/ts/sdk-realtime.ts +10 -0
  548. package/dist/runtime/ts/sdk-sse.ts +55 -0
  549. package/dist/runtime/ts/sdk-ws.ts +21 -0
  550. package/dist/runtime/ts/sdk.ts +242 -0
  551. package/dist/runtime/ts/sse.ts +175 -0
  552. package/dist/runtime/ts/stale.ts +137 -0
  553. package/dist/runtime/ts/stream.ts +87 -0
  554. package/dist/runtime/ts/webhook.ts +116 -0
  555. package/dist/runtime/ts/ws.ts +155 -0
  556. package/dist/runtime/ts-tanstack-query/invalidate.ts +152 -0
  557. package/dist/runtime/ts-tanstack-query/query.ts +261 -0
  558. package/package.json +135 -5
@@ -0,0 +1,73 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ package honey.runtime;
3
+
4
+ import java.time.Duration;
5
+ import java.util.Objects;
6
+
7
+ /**
8
+ * How long a mutation's {@code x-invalidate} targets stay stale, and how many are kept. A zero
9
+ * stale time, which is the default, is off.
10
+ */
11
+ public final class InvalidationConfig {
12
+ private final Duration staleTime;
13
+ private final int staleMaxEntries;
14
+ private final int maxSourcesPerTarget;
15
+
16
+ private InvalidationConfig(Builder builder) {
17
+ this.staleTime = builder.staleTime;
18
+ this.staleMaxEntries = builder.staleMaxEntries;
19
+ this.maxSourcesPerTarget = builder.maxSourcesPerTarget;
20
+ }
21
+
22
+ /** A builder for a config; the stale time is zero (off) until it is set. */
23
+ public static Builder builder() {
24
+ return new Builder();
25
+ }
26
+
27
+ /** How long a target stays stale after a mutation; zero is off. */
28
+ Duration staleTime() {
29
+ return staleTime;
30
+ }
31
+
32
+ /** The most stale targets kept: past it, the least recently staled go until half remain. */
33
+ int staleMaxEntries() {
34
+ return staleMaxEntries;
35
+ }
36
+
37
+ /** The most mutations recorded per stale target. */
38
+ int maxSourcesPerTarget() {
39
+ return maxSourcesPerTarget;
40
+ }
41
+
42
+ /** Builds an {@link InvalidationConfig}. */
43
+ public static final class Builder {
44
+ private Duration staleTime = Duration.ZERO;
45
+ private int staleMaxEntries = 1000;
46
+ private int maxSourcesPerTarget = 16;
47
+
48
+ private Builder() {}
49
+
50
+ /** Sets how long a target stays stale after a mutation; zero is off. */
51
+ public Builder staleTime(Duration staleTime) {
52
+ this.staleTime = Objects.requireNonNull(staleTime, "staleTime");
53
+ return this;
54
+ }
55
+
56
+ /** Sets the most stale targets kept, 1000 by default. */
57
+ public Builder staleMaxEntries(int staleMaxEntries) {
58
+ this.staleMaxEntries = staleMaxEntries;
59
+ return this;
60
+ }
61
+
62
+ /** Sets the most mutations recorded per stale target, 16 by default. */
63
+ public Builder maxSourcesPerTarget(int maxSourcesPerTarget) {
64
+ this.maxSourcesPerTarget = maxSourcesPerTarget;
65
+ return this;
66
+ }
67
+
68
+ /** Builds the config. */
69
+ public InvalidationConfig build() {
70
+ return new InvalidationConfig(this);
71
+ }
72
+ }
73
+ }
@@ -0,0 +1,23 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ package honey.runtime;
3
+
4
+ import tools.jackson.databind.DeserializationFeature;
5
+ import tools.jackson.databind.json.JsonMapper;
6
+ import tools.jackson.databind.module.SimpleModule;
7
+
8
+ /**
9
+ * The one mapper every model reads and writes through: unknown properties ignored, no type
10
+ * information.
11
+ */
12
+ final class Json {
13
+ static final JsonMapper MAPPER =
14
+ JsonMapper.builder()
15
+ .addModule(
16
+ new SimpleModule("honey-opt")
17
+ .addDeserializer(Opt.class, new Opt.Reader(null))
18
+ .addSerializer(new Opt.Writer()))
19
+ .disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES)
20
+ .build();
21
+
22
+ private Json() {}
23
+ }
@@ -0,0 +1,60 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ package honey.runtime;
3
+
4
+ import java.time.Duration;
5
+ import java.util.concurrent.CompletableFuture;
6
+ import java.util.concurrent.TimeUnit;
7
+
8
+ /**
9
+ * A socket's keepalive: a ping each interval through the socket's one send gate, on the JDK's
10
+ * shared scheduler. A ping waits for a send in flight, and its interval starts when it is sent, so
11
+ * a slow upload is no dead peer; a ping no pong or frame answers within the interval ends the
12
+ * socket through its error path. It stops with the socket.
13
+ */
14
+ final class Keepalive {
15
+ /** The interval, and the wait for a pong (C#'s KeepAliveInterval and KeepAliveTimeout). */
16
+ static final Duration EVERY = Duration.ofSeconds(20);
17
+
18
+ private final Socket socket;
19
+ private final Duration every;
20
+
21
+ /** When the unanswered ping went out (System.nanoTime), 0 when none waits. */
22
+ private volatile long pinged;
23
+
24
+ Keepalive(Socket socket, Duration every) {
25
+ this.socket = socket;
26
+ this.every = every;
27
+ }
28
+
29
+ void start() {
30
+ CompletableFuture.delayedExecutor(every.toMillis(), TimeUnit.MILLISECONDS).execute(this::tick);
31
+ }
32
+
33
+ /** One interval: a ping, or the error path for one unanswered; none once the socket ended. */
34
+ private void tick() {
35
+ long out = pinged;
36
+ if (out != 0 && System.nanoTime() - out >= every.toNanos()) {
37
+ socket.unanswered();
38
+ return;
39
+ }
40
+ if (out == 0 && !socket.ping()) {
41
+ return;
42
+ }
43
+ start();
44
+ }
45
+
46
+ /** The ping goes out: its interval starts now, before a pong can answer it. */
47
+ void sent() {
48
+ pinged = System.nanoTime();
49
+ }
50
+
51
+ /** Whether a ping waits for its pong: no other goes out until one answers it. */
52
+ boolean waiting() {
53
+ return pinged != 0;
54
+ }
55
+
56
+ /** A pong or a frame came in: the peer is alive. */
57
+ void heard() {
58
+ pinged = 0;
59
+ }
60
+ }
@@ -0,0 +1,14 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ package honey.runtime;
3
+
4
+ /**
5
+ * One log line of a call. Its error is {@code <SimpleName>: <message>} or {@code the call was
6
+ * canceled}. It carries no secret and no URL.
7
+ */
8
+ public record LogEntry(
9
+ String level,
10
+ String event,
11
+ String operation,
12
+ long durationMs,
13
+ java.lang.Integer status,
14
+ String error) {}
@@ -0,0 +1,68 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ package honey.runtime;
3
+
4
+ import java.nio.charset.StandardCharsets;
5
+
6
+ /**
7
+ * A realtime call polled through its exchange: one GET per message with the cursor, held up to 60 s
8
+ * whatever the timeout (a 204 polls again); a send is a POST.
9
+ */
10
+ final class LongPollAdapter implements TransportAdapter, RealtimeLoop.Dialed {
11
+ private final Realtime dial;
12
+
13
+ LongPollAdapter(Realtime dial) {
14
+ this.dial = dial;
15
+ }
16
+
17
+ @Override
18
+ public Realtime dial() {
19
+ return dial;
20
+ }
21
+
22
+ @Override
23
+ public String name() {
24
+ return "longpoll";
25
+ }
26
+
27
+ @Override
28
+ public TransportKind kind() {
29
+ return TransportKind.LONG_POLL;
30
+ }
31
+
32
+ /**
33
+ * The connection, which dials nothing: its first poll waits for its first read; each poll reads
34
+ * the connection's own cursor as it stands. {@code url} is a caller's adapter's.
35
+ */
36
+ @Override
37
+ public TransportConnection connect(String url, TransportOptions options) {
38
+ dial.polling(options);
39
+ return new TransportConnection() {
40
+ private volatile boolean closed;
41
+
42
+ @Override
43
+ public TransportMessage receive() {
44
+ while (!closed) {
45
+ Answer answer = dial.poll(options);
46
+ if (answer.error() != null) {
47
+ throw answer.error();
48
+ }
49
+ if (answer.raw().status() != 204) {
50
+ return new TransportMessage(
51
+ new String(answer.body(), StandardCharsets.UTF_8), null, null);
52
+ }
53
+ }
54
+ return null;
55
+ }
56
+
57
+ @Override
58
+ public void send(String text) {
59
+ dial.post(text);
60
+ }
61
+
62
+ @Override
63
+ public void close() {
64
+ closed = true;
65
+ }
66
+ };
67
+ }
68
+ }
@@ -0,0 +1,21 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ package honey.runtime;
3
+
4
+ /** One operation's fixed description: its path params by spec name in path order. */
5
+ record Operation(
6
+ String method,
7
+ String template,
8
+ String[] names,
9
+ String accept,
10
+ boolean idempotent,
11
+ String[] invalidates) {
12
+ /** An operation with no x-invalidate targets. */
13
+ Operation(String method, String template, String[] names, String accept, boolean idempotent) {
14
+ this(method, template, names, accept, idempotent, new String[0]);
15
+ }
16
+
17
+ /** The route as the log and the errors name it: {@code METHOD /template}. */
18
+ String route() {
19
+ return method + " " + template;
20
+ }
21
+ }
@@ -0,0 +1,121 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ package honey.runtime;
3
+
4
+ import tools.jackson.core.JsonGenerator;
5
+ import tools.jackson.core.JsonParser;
6
+ import tools.jackson.databind.BeanProperty;
7
+ import tools.jackson.databind.DeserializationContext;
8
+ import tools.jackson.databind.JavaType;
9
+ import tools.jackson.databind.SerializationContext;
10
+ import tools.jackson.databind.ValueDeserializer;
11
+ import tools.jackson.databind.ValueSerializer;
12
+
13
+ /** A three-state optional: absent, present as JSON null, or present with a value. */
14
+ public final class Opt<T> {
15
+ private final boolean present;
16
+ private final T value;
17
+
18
+ private Opt(boolean present, T value) {
19
+ this.present = present;
20
+ this.value = value;
21
+ }
22
+
23
+ /** The field is not on the wire. */
24
+ public static <T> Opt<T> absent() {
25
+ return new Opt<>(false, null);
26
+ }
27
+
28
+ /** The field is on the wire as JSON null. */
29
+ public static <T> Opt<T> ofNull() {
30
+ return new Opt<>(true, null);
31
+ }
32
+
33
+ /** The field is on the wire with {@code value}. */
34
+ public static <T> Opt<T> of(T value) {
35
+ return new Opt<>(true, value);
36
+ }
37
+
38
+ public boolean isPresent() {
39
+ return present;
40
+ }
41
+
42
+ public T value() {
43
+ return value;
44
+ }
45
+
46
+ @Override
47
+ public boolean equals(Object o) {
48
+ return o instanceof Opt<?> other
49
+ && other.present == present
50
+ && java.util.Objects.equals(other.value, value);
51
+ }
52
+
53
+ @Override
54
+ public int hashCode() {
55
+ return java.util.Objects.hash(present, value);
56
+ }
57
+
58
+ @Override
59
+ public String toString() {
60
+ return present ? "Opt[" + value + "]" : "Opt.absent";
61
+ }
62
+
63
+ /**
64
+ * Reads a present field, JSON null included; the content's type is the field's second type
65
+ * argument.
66
+ */
67
+ static final class Reader extends ValueDeserializer<Opt<?>> {
68
+ private final JavaType content;
69
+
70
+ Reader(JavaType content) {
71
+ this.content = content;
72
+ }
73
+
74
+ @Override
75
+ public ValueDeserializer<?> createContextual(
76
+ DeserializationContext ctxt, BeanProperty property) {
77
+ return new Reader(property == null ? null : property.getType().containedType(0));
78
+ }
79
+
80
+ @Override
81
+ public Opt<?> deserialize(JsonParser p, DeserializationContext ctxt) {
82
+ Object read = content == null ? ctxt.readTree(p) : ctxt.readValue(p, content);
83
+ return Opt.of(read);
84
+ }
85
+
86
+ @Override
87
+ public Object getNullValue(DeserializationContext ctxt) {
88
+ return Opt.ofNull();
89
+ }
90
+
91
+ @Override
92
+ public Object getAbsentValue(DeserializationContext ctxt) {
93
+ return Opt.absent();
94
+ }
95
+ }
96
+
97
+ /**
98
+ * Writes a present value, or JSON null; an absent field is empty, so a NON_EMPTY property leaves
99
+ * it out.
100
+ */
101
+ static final class Writer extends ValueSerializer<Opt<?>> {
102
+ @Override
103
+ public Class<?> handledType() {
104
+ return Opt.class;
105
+ }
106
+
107
+ @Override
108
+ public void serialize(Opt<?> v, JsonGenerator g, SerializationContext c) {
109
+ if (v.value == null) {
110
+ g.writeNull();
111
+ } else {
112
+ c.writeValue(g, v.value);
113
+ }
114
+ }
115
+
116
+ @Override
117
+ public boolean isEmpty(SerializationContext c, Opt<?> v) {
118
+ return v == null || !v.present;
119
+ }
120
+ }
121
+ }
@@ -0,0 +1,160 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ package honey.runtime;
3
+
4
+ import java.io.IOException;
5
+ import java.io.InputStream;
6
+ import java.io.InterruptedIOException;
7
+ import java.net.http.HttpResponse;
8
+ import java.nio.ByteBuffer;
9
+ import java.util.Iterator;
10
+ import java.util.List;
11
+ import java.util.concurrent.BlockingQueue;
12
+ import java.util.concurrent.Flow;
13
+ import java.util.concurrent.LinkedBlockingQueue;
14
+ import java.util.concurrent.TimeUnit;
15
+
16
+ /**
17
+ * A streamed body as the SDK reads it: the publisher's buffers through a queue whose take any
18
+ * interrupt ends, on every JDK (17's own body stream ignores one). Demand is one buffer list at a
19
+ * time, asked for when the reader takes the one before, so at most one waits beside the one being
20
+ * read. An interrupt or a close cancels the subscription, held until it arrives; an error is read
21
+ * once, then the end. A deadline, when given, bounds every wait.
22
+ */
23
+ final class Pump extends InputStream implements Flow.Subscriber<List<ByteBuffer>> {
24
+ private static final Object END = new Object();
25
+
26
+ private record Failure(Throwable cause) {}
27
+
28
+ private final BlockingQueue<Object> queue = new LinkedBlockingQueue<>();
29
+ private final Deadline deadline;
30
+ private Flow.Subscription subscription;
31
+ private boolean canceled;
32
+ private volatile boolean closed;
33
+ private Iterator<ByteBuffer> rest;
34
+ private ByteBuffer current;
35
+ private boolean done;
36
+
37
+ Pump(Deadline deadline) {
38
+ this.deadline = deadline;
39
+ }
40
+
41
+ @Override
42
+ public synchronized void onSubscribe(Flow.Subscription given) {
43
+ if (subscription != null || canceled) {
44
+ given.cancel();
45
+ return;
46
+ }
47
+ subscription = given;
48
+ given.request(1);
49
+ }
50
+
51
+ @Override
52
+ public void onNext(List<ByteBuffer> item) {
53
+ queue.add(item);
54
+ }
55
+
56
+ @Override
57
+ public void onError(Throwable throwable) {
58
+ queue.add(new Failure(throwable));
59
+ }
60
+
61
+ @Override
62
+ public void onComplete() {
63
+ queue.add(END);
64
+ }
65
+
66
+ @Override
67
+ public int read() throws IOException {
68
+ byte[] one = new byte[1];
69
+ return read(one, 0, 1) < 0 ? -1 : one[0] & 0xff;
70
+ }
71
+
72
+ @Override
73
+ public int read(byte[] buffer, int offset, int length) throws IOException {
74
+ while (current == null || !current.hasRemaining()) {
75
+ if (closed || done) {
76
+ return -1;
77
+ }
78
+ if (rest != null && rest.hasNext()) {
79
+ current = rest.next();
80
+ continue;
81
+ }
82
+ Object item = take();
83
+ if (item instanceof Failure failure) {
84
+ done = true;
85
+ throw new IOException(failure.cause());
86
+ }
87
+ if (item == END) {
88
+ done = true;
89
+ return -1;
90
+ }
91
+ @SuppressWarnings("unchecked")
92
+ List<ByteBuffer> buffers = (List<ByteBuffer>) item;
93
+ rest = buffers.iterator();
94
+ request();
95
+ }
96
+ int n = Math.min(length, current.remaining());
97
+ current.get(buffer, offset, n);
98
+ return n;
99
+ }
100
+
101
+ private Object take() throws InterruptedIOException {
102
+ try {
103
+ if (deadline == null) {
104
+ return queue.take();
105
+ }
106
+ Object item = queue.poll(deadline.remainingMillis(), TimeUnit.MILLISECONDS);
107
+ if (item == null) {
108
+ cancel();
109
+ throw deadline.timeout(null);
110
+ }
111
+ return item;
112
+ } catch (InterruptedException e) {
113
+ java.lang.Thread.currentThread().interrupt();
114
+ cancel();
115
+ throw new InterruptedIOException("the read was interrupted");
116
+ }
117
+ }
118
+
119
+ private synchronized void request() {
120
+ if (!canceled) {
121
+ subscription.request(1);
122
+ }
123
+ }
124
+
125
+ /** Cancels the subscription once, now or when it arrives; a pending read then ends. */
126
+ private synchronized void cancel() {
127
+ if (canceled) {
128
+ return;
129
+ }
130
+ canceled = true;
131
+ if (subscription != null) {
132
+ subscription.cancel();
133
+ }
134
+ }
135
+
136
+ /** A redirect's unread stream body, let go. */
137
+ static void discard(HttpResponse<Flow.Publisher<List<ByteBuffer>>> response) {
138
+ Pump pump = new Pump(null);
139
+ pump.close();
140
+ response.body().subscribe(pump);
141
+ }
142
+
143
+ /** {@code live} let go, when there is one. */
144
+ static void release(InputStream live) {
145
+ if (live != null) {
146
+ try {
147
+ live.close();
148
+ } catch (IOException e) {
149
+ /* the connection is let go either way */
150
+ }
151
+ }
152
+ }
153
+
154
+ @Override
155
+ public void close() {
156
+ closed = true;
157
+ cancel();
158
+ queue.add(END);
159
+ }
160
+ }
@@ -0,0 +1,48 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ package honey.runtime;
3
+
4
+ import java.net.URI;
5
+ import java.util.Collections;
6
+ import java.util.Map;
7
+ import java.util.TreeMap;
8
+
9
+ /**
10
+ * The response a call got. A box the call fills: pass a new one through {@link
11
+ * RequestOptions.Builder#raw(RawResponse)}.
12
+ */
13
+ public final class RawResponse {
14
+ private int status;
15
+ private Map<String, String> headers = Map.of();
16
+ private byte[] body = new byte[0];
17
+ private URI url;
18
+
19
+ /** An empty box, filled by the call it is passed to. */
20
+ public RawResponse() {}
21
+
22
+ /** The HTTP status. */
23
+ public int status() {
24
+ return status;
25
+ }
26
+
27
+ /** Each header by lower-case name, repeated values joined with {@code ", "}. */
28
+ public Map<String, String> headers() {
29
+ return headers;
30
+ }
31
+
32
+ /** The body as received. */
33
+ public byte[] body() {
34
+ return body.clone();
35
+ }
36
+
37
+ /** The last hop's URL: the one that answered. */
38
+ public URI url() {
39
+ return url;
40
+ }
41
+
42
+ void fill(int status, Map<String, String> headers, byte[] body, URI url) {
43
+ this.status = status;
44
+ this.headers = Collections.unmodifiableMap(new TreeMap<>(headers));
45
+ this.body = body.clone();
46
+ this.url = url;
47
+ }
48
+ }