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

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 +84 -5
@@ -0,0 +1,233 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ package honey.runtime;
3
+
4
+ import java.net.URI;
5
+ import java.time.Duration;
6
+ import java.util.ArrayList;
7
+ import java.util.List;
8
+ import java.util.Map;
9
+ import java.util.TreeMap;
10
+ import java.util.function.Consumer;
11
+ import java.util.function.Supplier;
12
+
13
+ /**
14
+ * How a client connects and what it runs around each call. The generated builder forwards to this
15
+ * one.
16
+ */
17
+ final class ClientConfig {
18
+ private final String baseUrl;
19
+ private final String token;
20
+ private final String authHeader;
21
+ private final String authPrefix;
22
+ private final Map<String, String> headers;
23
+ private final Duration timeout;
24
+ private final List<RequestHook> onRequest;
25
+ private final List<ResponseHook> onResponse;
26
+ private final Supplier<String> onAuthExpired;
27
+ private final Consumer<LogEntry> onLog;
28
+ private final RedirectPolicy redirect;
29
+ private final long maxResponseBytes;
30
+ private final InvalidationConfig invalidation;
31
+
32
+ private ClientConfig(Builder builder) {
33
+ this.baseUrl = builder.baseUrl;
34
+ this.token = builder.token;
35
+ this.authHeader = builder.authHeader;
36
+ this.authPrefix = builder.authPrefix;
37
+ this.headers = builder.headers;
38
+ this.timeout = builder.timeout;
39
+ this.onRequest = List.copyOf(builder.onRequest);
40
+ this.onResponse = List.copyOf(builder.onResponse);
41
+ this.onAuthExpired = builder.onAuthExpired;
42
+ this.onLog = builder.onLog;
43
+ this.redirect = builder.redirect;
44
+ this.maxResponseBytes = builder.maxResponseBytes;
45
+ this.invalidation = builder.invalidation;
46
+ }
47
+
48
+ /** Whether {@code url} is an absolute http(s) URL with a host. */
49
+ static boolean absolute(String url) {
50
+ try {
51
+ URI uri = URI.create(url);
52
+ return ("http".equals(uri.getScheme()) || "https".equals(uri.getScheme()))
53
+ && uri.getHost() != null;
54
+ } catch (IllegalArgumentException e) {
55
+ return false;
56
+ }
57
+ }
58
+
59
+ /**
60
+ * A builder whose defaults are the API's first server and its auth header and prefix (any may be
61
+ * null).
62
+ */
63
+ static Builder builder(String server, String header, String prefix) {
64
+ return new Builder(server, header, prefix);
65
+ }
66
+
67
+ String baseUrl() {
68
+ return baseUrl;
69
+ }
70
+
71
+ String token() {
72
+ return token;
73
+ }
74
+
75
+ String authHeader() {
76
+ return authHeader;
77
+ }
78
+
79
+ String authPrefix() {
80
+ return authPrefix;
81
+ }
82
+
83
+ Map<String, String> headers() {
84
+ return headers;
85
+ }
86
+
87
+ Duration timeout() {
88
+ return timeout;
89
+ }
90
+
91
+ List<RequestHook> onRequest() {
92
+ return onRequest;
93
+ }
94
+
95
+ List<ResponseHook> onResponse() {
96
+ return onResponse;
97
+ }
98
+
99
+ Supplier<String> onAuthExpired() {
100
+ return onAuthExpired;
101
+ }
102
+
103
+ Consumer<LogEntry> onLog() {
104
+ return onLog;
105
+ }
106
+
107
+ RedirectPolicy redirect() {
108
+ return redirect;
109
+ }
110
+
111
+ long maxResponseBytes() {
112
+ return maxResponseBytes;
113
+ }
114
+
115
+ /** The stale window of the x-invalidate targets, or null when off. */
116
+ InvalidationConfig invalidation() {
117
+ return invalidation;
118
+ }
119
+
120
+ /** The config's builder: each setter replaces the one before it, hooks append. */
121
+ static final class Builder {
122
+ /** The default cap on a decoded answer: 100 MiB. */
123
+ private static final long DEFAULT_MAX_RESPONSE_BYTES = 100L << 20;
124
+
125
+ private final String server;
126
+ private final String defaultHeader;
127
+ private final String defaultPrefix;
128
+ private String baseUrl;
129
+ private String bearerToken;
130
+ private String apiKey;
131
+ private String authName;
132
+ private String authPrefixSet;
133
+ private Map<String, String> headers = Map.of();
134
+ private Duration timeout = Duration.ofSeconds(30);
135
+ private final List<RequestHook> onRequest = new ArrayList<>();
136
+ private final List<ResponseHook> onResponse = new ArrayList<>();
137
+ private Supplier<String> onAuthExpired;
138
+ private Consumer<LogEntry> onLog;
139
+ private String token;
140
+ private String authHeader;
141
+ private String authPrefix;
142
+ private RedirectPolicy redirect = RedirectPolicy.SAME_ORIGIN;
143
+ private long maxResponseBytes = DEFAULT_MAX_RESPONSE_BYTES;
144
+ private InvalidationConfig invalidation;
145
+
146
+ private Builder(String server, String header, String prefix) {
147
+ this.server = server;
148
+ this.defaultHeader = header;
149
+ this.defaultPrefix = prefix;
150
+ }
151
+
152
+ void baseUrl(String value) {
153
+ this.baseUrl = value;
154
+ }
155
+
156
+ void bearerToken(String value) {
157
+ this.bearerToken = value;
158
+ }
159
+
160
+ void apiKey(String value) {
161
+ this.apiKey = value;
162
+ }
163
+
164
+ void authHeaderName(String value) {
165
+ this.authName = value;
166
+ }
167
+
168
+ void authHeaderPrefix(String value) {
169
+ this.authPrefixSet = value;
170
+ }
171
+
172
+ void headers(Map<String, String> value) {
173
+ this.headers = Map.copyOf(value);
174
+ }
175
+
176
+ void timeout(Duration value) {
177
+ this.timeout = value;
178
+ }
179
+
180
+ void onRequest(RequestHook hook) {
181
+ this.onRequest.add(hook);
182
+ }
183
+
184
+ void onResponse(ResponseHook hook) {
185
+ this.onResponse.add(hook);
186
+ }
187
+
188
+ void onAuthExpired(Supplier<String> refresh) {
189
+ this.onAuthExpired = refresh;
190
+ }
191
+
192
+ void onLog(Consumer<LogEntry> log) {
193
+ this.onLog = log;
194
+ }
195
+
196
+ void redirect(RedirectPolicy value) {
197
+ this.redirect = value;
198
+ }
199
+
200
+ /** The cap on a decoded answer in bytes; 0 is none. */
201
+ void maxResponseBytes(long value) {
202
+ this.maxResponseBytes = value;
203
+ }
204
+
205
+ void invalidation(InvalidationConfig value) {
206
+ this.invalidation = value;
207
+ }
208
+
209
+ /** Builds the config: the base URL is required and must be absolute http(s). */
210
+ ClientConfig build() {
211
+ String url = baseUrl != null ? baseUrl : server;
212
+ if (url == null || url.isEmpty()) {
213
+ throw new ConfigException("baseUrl is required: the API declares no server");
214
+ }
215
+ if (!absolute(url)) {
216
+ throw new ConfigException("baseUrl is not an absolute http(s) URL");
217
+ }
218
+ resolve(url);
219
+ return new ClientConfig(this);
220
+ }
221
+
222
+ private void resolve(String url) {
223
+ this.baseUrl = url;
224
+ this.token = bearerToken != null && !bearerToken.isEmpty() ? bearerToken : apiKey;
225
+ this.authHeader = authName != null ? authName : defaultHeader;
226
+ this.authPrefix =
227
+ authPrefixSet != null ? authPrefixSet : (authName == null ? defaultPrefix : "");
228
+ Map<String, String> folded = new TreeMap<>(String.CASE_INSENSITIVE_ORDER);
229
+ folded.putAll(headers);
230
+ this.headers = folded;
231
+ }
232
+ }
233
+ }
@@ -0,0 +1,12 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ package honey.runtime;
3
+
4
+ /** Where a realtime connection stands. */
5
+ public enum ConnectionState {
6
+ /** A transport is open. */
7
+ CONNECTED,
8
+ /** The transport dropped; the next read reopens the chain. */
9
+ RECONNECTING,
10
+ /** Not open yet, closed, or given up. */
11
+ DISCONNECTED
12
+ }
@@ -0,0 +1,58 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ package honey.runtime;
3
+
4
+ import java.util.Objects;
5
+ import java.util.function.Supplier;
6
+
7
+ /**
8
+ * A client's credential: its token, the header it goes in and the prefix before it, refreshed
9
+ * single-flight.
10
+ */
11
+ final class Credential {
12
+ private String token;
13
+ private final String header;
14
+ private final String prefix;
15
+
16
+ Credential(ClientConfig config) {
17
+ this.token = config.token();
18
+ this.header = config.authHeader();
19
+ this.prefix = config.authPrefix();
20
+ }
21
+
22
+ /** The current token, or null when there is none. */
23
+ synchronized String token() {
24
+ return token;
25
+ }
26
+
27
+ /** The header the credential goes in. */
28
+ String header() {
29
+ return header;
30
+ }
31
+
32
+ /** The text the credential follows in its header. */
33
+ String prefix() {
34
+ return prefix;
35
+ }
36
+
37
+ /**
38
+ * The token after {@code rejected} was refused: the token another call already refreshed, else
39
+ * the refresh's new one. Asked once per rejection, whichever call asks first; null when the
40
+ * refresh gives none.
41
+ */
42
+ synchronized String refresh(String rejected, Supplier<String> refresh) {
43
+ if (!Objects.equals(token, rejected)) {
44
+ return token;
45
+ }
46
+ String fresh;
47
+ try {
48
+ fresh = refresh.get();
49
+ } catch (RuntimeException e) {
50
+ throw Hooks.failure("on_auth_expired", e);
51
+ }
52
+ if (fresh == null || fresh.isEmpty()) {
53
+ return null;
54
+ }
55
+ token = fresh;
56
+ return fresh;
57
+ }
58
+ }
@@ -0,0 +1,38 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ package honey.runtime;
3
+
4
+ import java.time.Duration;
5
+ import java.time.Instant;
6
+
7
+ /**
8
+ * One call's deadline: its bound, the instant it ends, and the route its timeout names. The one
9
+ * deadline covers every hop, the auth retry and the decode of each answer, as C#'s one linked token
10
+ * does.
11
+ */
12
+ final class Deadline {
13
+ private final Duration limit;
14
+ private final Instant end;
15
+ private final String route;
16
+
17
+ Deadline(Duration limit, String route) {
18
+ this.limit = limit;
19
+ this.route = route;
20
+ this.end = Instant.now().plus(limit);
21
+ }
22
+
23
+ /** The time left in milliseconds, never negative. */
24
+ long remainingMillis() {
25
+ return Math.max(0, Duration.between(Instant.now(), end).toMillis());
26
+ }
27
+
28
+ /** Throws the deadline's timeout once it has lapsed. */
29
+ void check() {
30
+ if (!Instant.now().isBefore(end)) {
31
+ throw timeout(null);
32
+ }
33
+ }
34
+
35
+ ApiTimeoutException timeout(Throwable cause) {
36
+ return new ApiTimeoutException(route + " timed out after " + limit.toMillis() + " ms", cause);
37
+ }
38
+ }
@@ -0,0 +1,181 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ package honey.runtime;
3
+
4
+ import java.io.ByteArrayInputStream;
5
+ import java.io.FilterInputStream;
6
+ import java.io.IOException;
7
+ import java.io.InputStream;
8
+ import java.io.PushbackInputStream;
9
+ import java.net.http.HttpResponse;
10
+ import java.util.Locale;
11
+ import java.util.zip.GZIPInputStream;
12
+ import java.util.zip.Inflater;
13
+ import java.util.zip.InflaterInputStream;
14
+
15
+ /**
16
+ * An answer's body as the SDK reads it: gzip or deflate decoded, and bounded by {@code
17
+ * maxResponseBytes} on the decoded size. The decoded size is counted in 64 KiB reads before any
18
+ * byte is held, so an answer over the cap is left unread at the cap, never at the heap; the bytes
19
+ * are then decoded into an array of exactly that size.
20
+ */
21
+ final class Decode {
22
+ private static final int CHUNK = 64 * 1024;
23
+
24
+ /** The largest array a body can be. */
25
+ private static final long MAX_ARRAY = java.lang.Integer.MAX_VALUE - 8;
26
+
27
+ private Decode() {}
28
+
29
+ /** The response's decoded body, or null once its decoded size passes {@code cap}; 0 is none. */
30
+ static byte[] body(HttpResponse<byte[]> response, long cap, Deadline deadline) {
31
+ byte[] raw = response.body();
32
+ String encoding = encoding(response);
33
+ long limit = cap > 0 ? cap : MAX_ARRAY;
34
+ if (!encoding.equals("gzip") && !encoding.equals("deflate")) {
35
+ return raw.length > limit ? null : raw;
36
+ }
37
+ long size = count(raw, encoding, limit, deadline);
38
+ return size > limit ? null : decoded(raw, encoding, size, deadline);
39
+ }
40
+
41
+ /** What an answer past {@code cap} is: its text, the cap in bytes. */
42
+ static String exceeds(long cap) {
43
+ return "the answer exceeds " + (cap > 0 ? cap : MAX_ARRAY) + " bytes";
44
+ }
45
+
46
+ /** The response's content encoding, lower case; empty for none. */
47
+ static String encoding(HttpResponse<?> response) {
48
+ return response
49
+ .headers()
50
+ .firstValue("content-encoding")
51
+ .orElse("")
52
+ .trim()
53
+ .toLowerCase(Locale.ROOT);
54
+ }
55
+
56
+ /**
57
+ * A streamed body decoded as it flows under {@code encoding} (gzip or deflate, else as it is);
58
+ * the decoder starts on the first read, so opening it waits for no byte.
59
+ */
60
+ static InputStream stream(InputStream body, String encoding) {
61
+ if (!encoding.equals("gzip") && !encoding.equals("deflate")) {
62
+ return body;
63
+ }
64
+ return new FilterInputStream(body) {
65
+ private boolean started;
66
+
67
+ @Override
68
+ public int read() throws IOException {
69
+ byte[] one = new byte[1];
70
+ return read(one, 0, 1) < 0 ? -1 : one[0] & 0xff;
71
+ }
72
+
73
+ @Override
74
+ public int read(byte[] buffer, int offset, int length) throws IOException {
75
+ if (!started) {
76
+ started = true;
77
+ in = decoder(new PushbackInputStream(body, 2), encoding);
78
+ }
79
+ return in.read(buffer, offset, length);
80
+ }
81
+ };
82
+ }
83
+
84
+ /**
85
+ * {@code in} decoded as {@code encoding}: gzip, or deflate zlib-wrapped or raw (its first two
86
+ * bytes read).
87
+ */
88
+ private static InputStream decoder(PushbackInputStream in, String encoding) throws IOException {
89
+ if (encoding.equals("gzip")) {
90
+ return new GZIPInputStream(in, CHUNK);
91
+ }
92
+ byte[] head = in.readNBytes(2);
93
+ in.unread(head);
94
+ return inflater(in, zlibWrapped(head));
95
+ }
96
+
97
+ /** The decoded size, counted in 64 KiB reads, which stops the moment it passes {@code limit}. */
98
+ private static long count(byte[] raw, String encoding, long limit, Deadline deadline) {
99
+ byte[] buffer = new byte[CHUNK];
100
+ long total = 0;
101
+ try (InputStream in = open(raw, encoding)) {
102
+ for (int n = in.read(buffer); n > 0; n = in.read(buffer)) {
103
+ lapse(deadline);
104
+ total += n;
105
+ if (total > limit) {
106
+ return total;
107
+ }
108
+ }
109
+ } catch (IOException e) {
110
+ throw malformed(encoding, e);
111
+ }
112
+ return total;
113
+ }
114
+
115
+ private static byte[] decoded(byte[] raw, String encoding, long size, Deadline deadline) {
116
+ byte[] out = new byte[(int) size];
117
+ try (InputStream in = open(raw, encoding)) {
118
+ int at = 0;
119
+ int n;
120
+ while (at < out.length && (n = in.read(out, at, out.length - at)) > 0) {
121
+ lapse(deadline);
122
+ at += n;
123
+ }
124
+ return out;
125
+ } catch (IOException e) {
126
+ throw malformed(encoding, e);
127
+ }
128
+ }
129
+
130
+ /**
131
+ * A stream over {@code raw} decoded as {@code encoding}: gzip, or deflate (zlib-wrapped or raw).
132
+ */
133
+ private static InputStream open(byte[] raw, String encoding) throws IOException {
134
+ InputStream in = new ByteArrayInputStream(raw);
135
+ if (encoding.equals("gzip")) {
136
+ return new GZIPInputStream(in, CHUNK);
137
+ }
138
+ return inflater(in, zlibWrapped(raw));
139
+ }
140
+
141
+ /** A deflate decoder over {@code in}: zlib-wrapped, or raw with its inflater ended on close. */
142
+ private static InputStream inflater(InputStream in, boolean wrapped) {
143
+ if (wrapped) {
144
+ return new InflaterInputStream(in, new Inflater(), CHUNK);
145
+ }
146
+ Inflater inflater = new Inflater(true);
147
+ return new InflaterInputStream(in, inflater, CHUNK) {
148
+ @Override
149
+ public void close() throws IOException {
150
+ try {
151
+ super.close();
152
+ } finally {
153
+ inflater.end();
154
+ }
155
+ }
156
+ };
157
+ }
158
+
159
+ /**
160
+ * Whether {@code raw} opens with a zlib header: deflate method 8, and a header word that is a
161
+ * multiple of 31.
162
+ */
163
+ private static boolean zlibWrapped(byte[] raw) {
164
+ if (raw.length < 2) {
165
+ return false;
166
+ }
167
+ int first = raw[0] & 0xff;
168
+ return (first & 0x0f) == 8 && ((first << 8) | (raw[1] & 0xff)) % 31 == 0;
169
+ }
170
+
171
+ /** Throws the call's timeout once its deadline has lapsed, between two reads of the decode. */
172
+ private static void lapse(Deadline deadline) {
173
+ if (deadline != null) {
174
+ deadline.check();
175
+ }
176
+ }
177
+
178
+ private static ApiConnectionException malformed(String encoding, IOException e) {
179
+ return new ApiConnectionException("the answer does not decode as " + encoding, e);
180
+ }
181
+ }
@@ -0,0 +1,141 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ package honey.runtime;
3
+
4
+ import java.nio.charset.StandardCharsets;
5
+ import java.util.LinkedHashMap;
6
+ import java.util.List;
7
+ import java.util.Map;
8
+ import tools.jackson.core.JacksonException;
9
+ import tools.jackson.databind.JsonNode;
10
+
11
+ /** Reads an error body's envelope and its detail (R3). */
12
+ final class Envelope {
13
+ private static final int MAX_DETAIL = 512;
14
+ private static final ErrorEnvelope EMPTY =
15
+ new ErrorEnvelope(null, null, null, null, Map.of(), Map.of());
16
+
17
+ private Envelope() {}
18
+
19
+ /** The envelope of {@code body}: its members, or empty for a body that is no JSON object. */
20
+ static ErrorEnvelope parse(byte[] body) {
21
+ JsonNode root = tree(body);
22
+ return root != null && root.isObject() ? read(root) : EMPTY;
23
+ }
24
+
25
+ /** Whether {@code body} is JSON at all. */
26
+ static boolean isJson(byte[] body) {
27
+ return tree(body) != null;
28
+ }
29
+
30
+ /** The envelope's message, else the body's text, sanitized and cut. */
31
+ static String detail(ErrorEnvelope envelope, byte[] body) {
32
+ String text =
33
+ envelope.message() != null ? envelope.message() : new String(body, StandardCharsets.UTF_8);
34
+ return sanitized(text);
35
+ }
36
+
37
+ private static JsonNode tree(byte[] body) {
38
+ try {
39
+ return Json.MAPPER.readTree(body);
40
+ } catch (JacksonException e) {
41
+ return null;
42
+ }
43
+ }
44
+
45
+ private static ErrorEnvelope read(JsonNode root) {
46
+ java.lang.Integer status = null;
47
+ String errorKey = null;
48
+ String statusKey = null;
49
+ String message = null;
50
+ Map<String, List<ErrorEnvelope.FieldError>> fields = Map.of();
51
+ Map<String, JsonNode> extra = new LinkedHashMap<>();
52
+ for (Map.Entry<String, JsonNode> member : root.properties()) {
53
+ JsonNode value = member.getValue();
54
+ String text = value.isString() ? value.asString() : null;
55
+ String name = member.getKey();
56
+ Map<String, List<ErrorEnvelope.FieldError>> parsed =
57
+ name.equals("fields") ? fieldsOf(value) : null;
58
+ if (name.equals("status") && value.isIntegralNumber() && value.canConvertToInt()) {
59
+ status = value.asInt();
60
+ } else if (name.equals("error_key") && text != null) {
61
+ errorKey = text;
62
+ } else if (name.equals("status_key") && text != null) {
63
+ statusKey = text;
64
+ } else if (name.equals("message") && text != null) {
65
+ message = text;
66
+ } else if (name.equals("fields") && parsed != null) {
67
+ fields = parsed;
68
+ } else {
69
+ extra.put(name, value);
70
+ }
71
+ }
72
+ return new ErrorEnvelope(status, errorKey, statusKey, message, fields, extra);
73
+ }
74
+
75
+ private static Map<String, List<ErrorEnvelope.FieldError>> fieldsOf(JsonNode value) {
76
+ if (!value.isObject()) {
77
+ return null;
78
+ }
79
+ Map<String, List<ErrorEnvelope.FieldError>> fields = new LinkedHashMap<>();
80
+ for (Map.Entry<String, JsonNode> field : value.properties()) {
81
+ List<ErrorEnvelope.FieldError> errors = errorsOf(field.getValue());
82
+ if (errors == null) {
83
+ return null;
84
+ }
85
+ fields.put(field.getKey(), errors);
86
+ }
87
+ return fields;
88
+ }
89
+
90
+ private static List<ErrorEnvelope.FieldError> errorsOf(JsonNode array) {
91
+ if (!array.isArray()) {
92
+ return null;
93
+ }
94
+ List<ErrorEnvelope.FieldError> errors = new java.util.ArrayList<>();
95
+ for (JsonNode item : array) {
96
+ String key = textOf(item, "error_key");
97
+ String message = textOf(item, "message");
98
+ String path = textOf(item, "path");
99
+ if (!item.isObject() || key == null || message == null || path == null) {
100
+ return null;
101
+ }
102
+ errors.add(new ErrorEnvelope.FieldError(key, message, path));
103
+ }
104
+ return errors;
105
+ }
106
+
107
+ private static String textOf(JsonNode item, String name) {
108
+ JsonNode value = item.get(name);
109
+ return value != null && value.isString() ? value.asString() : null;
110
+ }
111
+
112
+ /**
113
+ * The text with control, format, surrogate, private-use, unassigned and U+FFFD characters
114
+ * dropped, cut at 512 code points.
115
+ */
116
+ static String sanitized(String text) {
117
+ StringBuilder kept = new StringBuilder();
118
+ int count = 0;
119
+ for (int i = 0; i < text.length(); ) {
120
+ int cp = text.codePointAt(i);
121
+ i += Character.charCount(cp);
122
+ if (cp == 0xFFFD || drops(Character.getType(cp))) {
123
+ continue;
124
+ }
125
+ if (count == MAX_DETAIL) {
126
+ return kept.append('…').toString();
127
+ }
128
+ kept.appendCodePoint(cp);
129
+ count++;
130
+ }
131
+ return kept.toString();
132
+ }
133
+
134
+ private static boolean drops(int type) {
135
+ return type == Character.CONTROL
136
+ || type == Character.FORMAT
137
+ || type == Character.SURROGATE
138
+ || type == Character.PRIVATE_USE
139
+ || type == Character.UNASSIGNED;
140
+ }
141
+ }
@@ -0,0 +1,23 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ package honey.runtime;
3
+
4
+ import java.util.List;
5
+ import java.util.Map;
6
+ import tools.jackson.databind.JsonNode;
7
+
8
+ /**
9
+ * honey's error envelope, read from an error body's JSON object (empty for any other body): each
10
+ * member it names when the server sent it with its type, and every other member, a mistyped one
11
+ * included, in {@code extra}.
12
+ */
13
+ public record ErrorEnvelope(
14
+ java.lang.Integer status,
15
+ String errorKey,
16
+ String statusKey,
17
+ String message,
18
+ Map<String, List<FieldError>> fields,
19
+ Map<String, JsonNode> extra) {
20
+
21
+ /** One field's error in an envelope's {@code fields}. */
22
+ public record FieldError(String errorKey, String message, String path) {}
23
+ }