@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,208 @@
1
+ // Code generated by honey. DO NOT EDIT.
2
+
3
+ package sdk
4
+
5
+ import (
6
+ "context"
7
+ "errors"
8
+ "math/rand/v2"
9
+ "net/http"
10
+ "time"
11
+ )
12
+
13
+ // openChain tries the proven transport first, then the rest in order, each with the current
14
+ // resume cursor. The first that opens becomes the connection and the proven transport. Once ctx
15
+ // ends it tries no further transport: one that opens lazily (long-poll) would otherwise succeed.
16
+ // The chain fails with its last transient failure, else its most specific refusal; a 401 restarts it once.
17
+ func (r *ResumableConnection) openChain(ctx context.Context) error {
18
+ r.mu.Lock()
19
+ proven := r.provenIdx
20
+ opts := r.opts
21
+ r.mu.Unlock()
22
+ order := make([]int, 0, len(r.transports))
23
+ if proven >= 0 && proven < len(r.transports) {
24
+ order = append(order, proven)
25
+ }
26
+ for i := range r.transports {
27
+ if i != proven {
28
+ order = append(order, i)
29
+ }
30
+ }
31
+ var transient, refusal error
32
+ refreshed := false
33
+ for n := 0; n < len(order); n++ {
34
+ i := order[n]
35
+ if err := ctx.Err(); err != nil {
36
+ return wrapTransportError(ctx, err)
37
+ }
38
+ c, err := r.transports[i].Connect(ctx, r.url, &opts)
39
+ if status(err) == http.StatusUnauthorized && !refreshed && opts.refresh != nil && opts.refresh(ctx) {
40
+ refreshed, n, transient, refusal = true, -1, nil, nil /* the chain anew, with the refreshed token */
41
+ continue
42
+ }
43
+ if err != nil {
44
+ if !refused(err) {
45
+ transient = err
46
+ } else if refusal == nil || refusalRank[status(err)] > refusalRank[status(refusal)] {
47
+ refusal = err
48
+ }
49
+ continue
50
+ }
51
+ r.mu.Lock()
52
+ if r.closed {
53
+ r.mu.Unlock()
54
+ _ = c.Close()
55
+ return ErrConnectionClosed
56
+ }
57
+ r.conn, r.provenIdx, r.state = c, i, StateConnected
58
+ r.mu.Unlock()
59
+ return nil
60
+ }
61
+ if transient != nil {
62
+ return transient
63
+ }
64
+ return refusal
65
+ }
66
+
67
+ // advance moves the resume cursor past a delivered value: the connection's own event ID when it
68
+ // tracks one (SSE), else the payload's id or last_event_id, and the payload's reconnect_token.
69
+ func (r *ResumableConnection) advance(conn TransportConn, v any) {
70
+ id, token := payloadCursor(v)
71
+ if cc, ok := conn.(cursorConn); ok {
72
+ if sid := cc.lastEventID(); sid != "" {
73
+ id = sid
74
+ }
75
+ }
76
+ r.mu.Lock()
77
+ advanceCursor(&r.opts, id, token)
78
+ r.mu.Unlock()
79
+ }
80
+
81
+ func (r *ResumableConnection) maxAttempts() int {
82
+ switch {
83
+ case r.opts.MaxReconnectAttempts < 0:
84
+ return -1
85
+ case r.opts.MaxReconnectAttempts == 0:
86
+ return defaultReconnectAttempts
87
+ }
88
+ return r.opts.MaxReconnectAttempts
89
+ }
90
+
91
+ // backoff is the delay before reconnect attempt n (1-based): exponential from the base delay,
92
+ // capped, with jitter so clients do not reconnect in lockstep.
93
+ func (r *ResumableConnection) backoff(n int) time.Duration {
94
+ d := defaultReconnectDelay
95
+ if r.opts.ReconnectDelayMs > 0 {
96
+ d = time.Duration(r.opts.ReconnectDelayMs) * time.Millisecond
97
+ }
98
+ for i := 1; i < n && d < maxReconnectDelay; i++ {
99
+ d *= 2
100
+ }
101
+ d = min(d, maxReconnectDelay)
102
+ half := d / 2
103
+ return half + time.Duration(rand.Int64N(int64(half)+1))
104
+ }
105
+
106
+ func (r *ResumableConnection) fail(err error) {
107
+ select {
108
+ case r.errs <- err:
109
+ default:
110
+ }
111
+ }
112
+
113
+ // readLoop pumps Recv into Events. A transport error reconnects through the whole chain (the
114
+ // proven transport is forgotten) with backoff; exhaustion is sent on Errors and ends the loop.
115
+ // Close cuts every wait short.
116
+ func (r *ResumableConnection) readLoop(done chan struct{}) {
117
+ defer func() {
118
+ r.mu.Lock()
119
+ conn := r.conn
120
+ r.conn, r.running, r.state = nil, false, StateDisconnected
121
+ r.mu.Unlock()
122
+ if conn != nil {
123
+ _ = conn.Close()
124
+ }
125
+ close(done)
126
+ }()
127
+ attempts := 0 /* consecutive failed reconnects; a delivered event resets it */
128
+ for {
129
+ r.mu.Lock()
130
+ conn := r.conn
131
+ r.mu.Unlock()
132
+ if conn == nil {
133
+ return
134
+ }
135
+ v, err := conn.Recv(r.ctx)
136
+ if err == nil {
137
+ select {
138
+ case r.events <- v:
139
+ r.advance(conn, v)
140
+ attempts = 0
141
+ case <-r.ctx.Done():
142
+ return
143
+ }
144
+ continue
145
+ }
146
+ if r.ctx.Err() != nil || !r.reconnect(conn, err, &attempts) {
147
+ return
148
+ }
149
+ }
150
+ }
151
+
152
+ // reconnect drops the failed connection and reopens the chain with backoff, counting into
153
+ // attempts; it reports false when attempts ran out or the connection closed (Close ends the
154
+ // transport before its ctx, so a read can fail first).
155
+ func (r *ResumableConnection) reconnect(failed TransportConn, err error, attempts *int) bool {
156
+ if refused(err) {
157
+ _ = failed.Close()
158
+ r.fail(err)
159
+ return false
160
+ }
161
+ r.mu.Lock()
162
+ if r.closed {
163
+ r.mu.Unlock()
164
+ return false
165
+ }
166
+ r.state, r.conn, r.provenIdx = StateReconnecting, nil, -1
167
+ r.mu.Unlock()
168
+ _ = failed.Close()
169
+ limit := r.maxAttempts()
170
+ for {
171
+ *attempts++
172
+ if limit >= 0 && *attempts > limit {
173
+ r.fail(err)
174
+ return false
175
+ }
176
+ select {
177
+ case <-time.After(r.backoff(*attempts)):
178
+ case <-r.ctx.Done():
179
+ return false
180
+ }
181
+ openCtx, cancel := context.WithTimeout(r.ctx, openTimeout)
182
+ err = r.openChain(openCtx)
183
+ cancel()
184
+ if err == nil {
185
+ return true
186
+ }
187
+ if errors.Is(err, ErrConnectionClosed) {
188
+ return false
189
+ }
190
+ if refused(err) {
191
+ r.fail(err)
192
+ return false
193
+ }
194
+ }
195
+ }
196
+
197
+ func status(err error) int {
198
+ var ce *ClientError
199
+ if errors.As(err, &ce) {
200
+ return ce.StatusCode
201
+ }
202
+ return 0
203
+ }
204
+
205
+ // refusalRank ranks the statuses no retry changes, most specific highest; any other failure is transient.
206
+ var refusalRank = map[int]int{401: 6, 403: 5, 422: 4, 400: 3, 410: 2, 404: 1, 405: 1}
207
+
208
+ func refused(err error) bool { return refusalRank[status(err)] > 0 }
@@ -0,0 +1,124 @@
1
+ // Code generated by honey. DO NOT EDIT.
2
+
3
+ package sdk
4
+
5
+ import (
6
+ "errors"
7
+ "net/http"
8
+ "net/url"
9
+ "slices"
10
+ "strconv"
11
+ "strings"
12
+ )
13
+
14
+ // RedirectPolicy picks which redirects a client follows.
15
+ type RedirectPolicy string
16
+
17
+ const (
18
+ // RedirectSameOrigin follows redirects that stay on the request's origin. A cross-origin
19
+ // redirect is returned unfollowed, as an error for its 3xx status. The zero value means this.
20
+ RedirectSameOrigin RedirectPolicy = "same-origin"
21
+ // RedirectFollow also follows cross-origin redirects. Such a hop carries only the safe headers
22
+ // and never replays a body.
23
+ RedirectFollow RedirectPolicy = "follow"
24
+ )
25
+
26
+ const maxRedirects = 10
27
+
28
+ // crossOriginSafeHeaders are the only headers a request carries to another origin (H18.10). An
29
+ // allowlist, so a header added later never leaks by default.
30
+ var crossOriginSafeHeaders = []string{"Accept", "Accept-Language", "User-Agent"}
31
+
32
+ // http1 is DefaultTransport's settings offering HTTP/1.1 alone (its clone's ALPN list starts with h2).
33
+ var http1 = func() *http.Transport {
34
+ t := http.DefaultTransport.(*http.Transport).Clone()
35
+ t.Protocols = new(http.Protocols)
36
+ t.Protocols.SetHTTP1(true)
37
+ t.TLSClientConfig.NextProtos = []string{"http/1.1"}
38
+ return t
39
+ }()
40
+
41
+ // redirectClient is a copy of base (a fresh client when nil; http1 when it names no Transport) whose
42
+ // CheckRedirect applies policy and strips a cross-origin hop first, then defers to base's own
43
+ // CheckRedirect, so no client escapes it.
44
+ func redirectClient(base *http.Client, policy RedirectPolicy) *http.Client {
45
+ c := &http.Client{}
46
+ if base != nil {
47
+ *c = *base
48
+ }
49
+ if c.Transport == nil {
50
+ c.Transport = http1
51
+ }
52
+ next := c.CheckRedirect
53
+ c.CheckRedirect = func(req *http.Request, via []*http.Request) error {
54
+ if err := checkRedirect(req, via, policy); err != nil {
55
+ return err
56
+ }
57
+ if next != nil {
58
+ return next(req, via)
59
+ }
60
+ if len(via) >= maxRedirects {
61
+ return errors.New("honey: stopped after " + strconv.Itoa(maxRedirects) + " redirects")
62
+ }
63
+ return nil
64
+ }
65
+ return c
66
+ }
67
+
68
+ // transportClient holds a realtime transport's client to the redirect rule: a nil client becomes
69
+ // a same-origin one, and any other is wrapped so a cross-origin hop is stripped.
70
+ func transportClient(c *http.Client) *http.Client {
71
+ if c == nil {
72
+ return redirectClient(nil, RedirectSameOrigin)
73
+ }
74
+ return redirectClient(c, RedirectFollow)
75
+ }
76
+
77
+ // checkRedirect refuses a redirect the policy does not follow and strips a hop that has left the
78
+ // first request's origin down to the safe headers. Go copies the first request's headers onto
79
+ // every hop, so every hop after leaving the origin is stripped again.
80
+ func checkRedirect(req *http.Request, via []*http.Request, policy RedirectPolicy) error {
81
+ if !leftOrigin(req, via) {
82
+ return nil
83
+ }
84
+ if policy != RedirectFollow || (req.Body != nil && req.Body != http.NoBody) {
85
+ return http.ErrUseLastResponse
86
+ }
87
+ for name := range req.Header {
88
+ if !slices.Contains(crossOriginSafeHeaders, http.CanonicalHeaderKey(name)) {
89
+ delete(req.Header, name)
90
+ }
91
+ }
92
+ return nil
93
+ }
94
+
95
+ // leftOrigin reports whether req or any hop before it is on another origin than the first request.
96
+ func leftOrigin(req *http.Request, via []*http.Request) bool {
97
+ first := via[0].URL
98
+ if !sameOrigin(first, req.URL) {
99
+ return true
100
+ }
101
+ for _, hop := range via[1:] {
102
+ if !sameOrigin(first, hop.URL) {
103
+ return true
104
+ }
105
+ }
106
+ return false
107
+ }
108
+
109
+ // sameOrigin compares scheme, host and port, a default port spelled out or not.
110
+ func sameOrigin(a, b *url.URL) bool {
111
+ return strings.EqualFold(a.Scheme, b.Scheme) && strings.EqualFold(a.Hostname(), b.Hostname()) &&
112
+ portOf(a) == portOf(b)
113
+ }
114
+
115
+ func portOf(u *url.URL) string {
116
+ if p := u.Port(); p != "" {
117
+ return p
118
+ }
119
+ switch strings.ToLower(u.Scheme) {
120
+ case "https", "wss":
121
+ return "443"
122
+ }
123
+ return "80"
124
+ }
@@ -0,0 +1,222 @@
1
+ // Code generated by honey. DO NOT EDIT.
2
+
3
+ package sdk
4
+
5
+ import (
6
+ "bytes"
7
+ "context"
8
+ "errors"
9
+ "fmt"
10
+ "io"
11
+ "net/http"
12
+ "time"
13
+ )
14
+
15
+ // call is one operation invocation as a generated method assembles it.
16
+ type call struct {
17
+ method string
18
+ path string // expanded and escaped
19
+ operation string // `METHOD /path/template`, the name OnLog sees
20
+ query queryList
21
+ headers map[string]string // declared header params, Accept, Idempotency-Key
22
+ body requestBody
23
+ protocols []string // WebSocket subprotocols
24
+
25
+ stale *StaleTracker
26
+ invalidates []string // declared invalidation targets, `METHOD /template`
27
+ params map[string]string // path params, to expand templated targets
28
+ meta *RequestMeta
29
+ }
30
+
31
+ // requestResult is a buffered answer: its body after the OnResponse hooks, the response, and
32
+ // whether the body ran past the cap.
33
+ type requestResult struct {
34
+ body []byte
35
+ status int
36
+ resp *http.Response
37
+ over bool
38
+ }
39
+
40
+ // exchange is one call in flight: the client settings, this call's overrides and the call; a
41
+ // stream's 2xx body is left unread for the caller.
42
+ type exchange struct {
43
+ cfg Config
44
+ rc requestConfig
45
+ c *call
46
+ stream bool
47
+ }
48
+
49
+ // ErrResponseTooLarge is a *DecodeError's cause when a 2xx body exceeds Config.MaxResponseBytes.
50
+ var ErrResponseTooLarge = errors.New("honey: response body exceeds MaxResponseBytes")
51
+
52
+ // doRequest sends c and buffers its answer (run), honoring the call's timeout and the stale
53
+ // tracker. A ctx already done sends nothing: OnLog sees only its error. A 2xx past the cap is a
54
+ // *DecodeError.
55
+ func doRequest(ctx context.Context, cfg Config, c *call, opts []RequestOption) (*requestResult, error) {
56
+ x := &exchange{cfg: cfg, rc: newRequestConfig(cfg, opts), c: c}
57
+ if ctx.Err() != nil {
58
+ err := wrapTransportError(ctx, ctx.Err())
59
+ emitLog(cfg, errorEntry(c.operation, time.Now(), err))
60
+ return nil, err
61
+ }
62
+ if x.rc.timeout > 0 {
63
+ var cancel context.CancelFunc
64
+ ctx, cancel = context.WithTimeout(ctx, x.rc.timeout)
65
+ defer cancel()
66
+ }
67
+ c.meta = c.stale.begin(c)
68
+ result, err := x.run(ctx)
69
+ if err != nil {
70
+ return nil, err
71
+ }
72
+ c.stale.settle(c)
73
+ if result.over {
74
+ return nil, &DecodeError{result.resp, ErrResponseTooLarge}
75
+ }
76
+ return result, nil
77
+ }
78
+
79
+ // run is every call's exchange: it injects auth and merges headers, runs the hooks in declaration
80
+ // order, retries once with OnAuthExpired's token on a 401, and turns a non-2xx status into a typed
81
+ // error. OnLog sees request_start, then response_received for the final response, and error on
82
+ // any failure; an auth retry does not log twice.
83
+ func (x *exchange) run(ctx context.Context) (result *requestResult, err error) {
84
+ start := time.Now()
85
+ defer func() {
86
+ if err != nil {
87
+ emitLog(x.cfg, errorEntry(x.c.operation, start, err))
88
+ }
89
+ }()
90
+ emitLog(x.cfg, LogEntry{Level: "debug", Event: "request_start", Operation: x.c.operation})
91
+ if result, err = x.sendWithAuth(ctx); err != nil {
92
+ return nil, err
93
+ }
94
+ status := result.status
95
+ level := "info"
96
+ if status >= 400 {
97
+ level = "warn"
98
+ }
99
+ emitLog(x.cfg, LogEntry{Level: level, Event: "response_received", Operation: x.c.operation, DurationMs: time.Since(start).Milliseconds(), Status: &status})
100
+ x.rc.deliver(result.resp, result.body)
101
+ if err = raiseForStatus(result.resp, result.body); err != nil {
102
+ return nil, err
103
+ }
104
+ return result, nil
105
+ }
106
+
107
+ // sendWithAuth sends once, and once more with a refreshed token when a replayable request got 401.
108
+ func (x *exchange) sendWithAuth(ctx context.Context) (*requestResult, error) {
109
+ token := x.cfg.auth.current(x.cfg)
110
+ result, err := x.send(ctx, token, false)
111
+ if err != nil || result.status != http.StatusUnauthorized || x.cfg.OnAuthExpired == nil || !x.c.body.replayable() {
112
+ return result, err
113
+ }
114
+ fresh, err := x.cfg.auth.refresh(ctx, x.cfg, token)
115
+ if err != nil {
116
+ return nil, fmt.Errorf("honey: OnAuthExpired failed: %w", err)
117
+ }
118
+ if fresh == "" {
119
+ return result, nil
120
+ }
121
+ return x.send(ctx, fresh, true)
122
+ }
123
+
124
+ // send sends once and runs the OnResponse hooks on the answer, its body read first so they may
125
+ // replace it. A stream's 2xx body stays unread (the hooks see a nil Body, and one they set is
126
+ // ignored); of an error body a stream reads at most 64 KiB, a failed read leaving it nil. A body
127
+ // past the cap is nil.
128
+ func (x *exchange) send(ctx context.Context, token string, retry bool) (*requestResult, error) {
129
+ req, err := x.newRequest(ctx, token, retry)
130
+ if err != nil {
131
+ return nil, err
132
+ }
133
+ client, limit := x.cfg.HTTPClient, x.cfg.MaxResponseBytes
134
+ if x.stream {
135
+ client, limit = streamClient(x.cfg), 64<<10
136
+ }
137
+ resp, err := client.Do(req)
138
+ if err != nil {
139
+ return nil, wrapTransportError(ctx, err)
140
+ }
141
+ unread := x.stream && resp.StatusCode >= 200 && resp.StatusCode < 300
142
+ var body []byte
143
+ if !unread {
144
+ body, err = readBody(resp.Body, limit)
145
+ resp.Body.Close()
146
+ if err != nil && !x.stream && err != ErrResponseTooLarge {
147
+ return nil, wrapTransportError(ctx, err)
148
+ }
149
+ }
150
+ over := err == ErrResponseTooLarge
151
+ rc := &ResponseContext{Status: resp.StatusCode, Headers: resp.Header, Body: body, IsRetry: retry}
152
+ rc.Selector, rc.IsStale, rc.InvalidatedBy = x.c.meta.stale()
153
+ if err := runHooks("OnResponse", x.cfg.OnResponse, rc); err != nil {
154
+ resp.Body.Close()
155
+ return nil, err
156
+ }
157
+ if unread {
158
+ return &requestResult{status: resp.StatusCode, resp: resp}, nil
159
+ }
160
+ return &requestResult{rc.Body, resp.StatusCode, withBody(resp, rc.Body), over}, nil
161
+ }
162
+
163
+ // newRequest builds the outgoing request after the OnRequest hooks ran.
164
+ func (x *exchange) newRequest(ctx context.Context, token string, retry bool) (*http.Request, error) {
165
+ c := x.c
166
+ fullURL, err := buildURL(x.rc.baseURL, c.path, c.query)
167
+ if err != nil {
168
+ return nil, fmt.Errorf("honey: build URL: %w", err)
169
+ }
170
+ /* a Reader body streams as is; RequestContext.Body stays nil so no hook reads a one-shot reader */
171
+ payload, err := c.body.bytes()
172
+ if err != nil {
173
+ return nil, err
174
+ }
175
+ headers := withRequestID(mergeHeaders(x.cfg, token, c.body.mediaType(), c.headers, x.rc.headers))
176
+ rc := &RequestContext{Method: c.method, URL: fullURL, Path: c.path, Headers: headers, Body: payload, IsRetry: retry}
177
+ rc.Selector, rc.IsStale, rc.InvalidatedBy = c.meta.stale()
178
+ if err := runHooks("OnRequest", x.cfg.OnRequest, rc); err != nil {
179
+ return nil, err
180
+ }
181
+ var reader io.Reader
182
+ if c.body.reader != nil {
183
+ reader = c.body.reader
184
+ } else if rc.Body != nil {
185
+ reader = bytes.NewReader(rc.Body)
186
+ }
187
+ req, err := http.NewRequestWithContext(ctx, rc.Method, rc.URL, reader)
188
+ if err != nil {
189
+ return nil, fmt.Errorf("honey: build request: %w", err)
190
+ }
191
+ req.Header = rc.Headers
192
+ return req, nil
193
+ }
194
+
195
+ // wrapTransportError names a failed exchange: a timeout or cancel wraps ctx's cause (so errors.Is
196
+ // matches context.DeadlineExceeded or context.Canceled), anything else the redacted cause.
197
+ func wrapTransportError(ctx context.Context, err error) error {
198
+ switch ctxErr := context.Cause(ctx); {
199
+ case errors.Is(ctxErr, context.DeadlineExceeded):
200
+ return fmt.Errorf("honey: request timed out: %w", ctxErr)
201
+ case errors.Is(ctxErr, context.Canceled):
202
+ return fmt.Errorf("honey: request canceled: %w", ctxErr)
203
+ case ctxErr != nil:
204
+ return fmt.Errorf("honey: context error: %w", ctxErr)
205
+ }
206
+ return fmt.Errorf("honey: http do: %w", redactURL(err))
207
+ }
208
+
209
+ // readBody reads r up to limit bytes; a negative limit reads all.
210
+ func readBody(r io.Reader, limit int64) ([]byte, error) {
211
+ if limit < 0 {
212
+ return io.ReadAll(r)
213
+ }
214
+ body, err := io.ReadAll(io.LimitReader(r, limit+1))
215
+ if err != nil {
216
+ return nil, err
217
+ }
218
+ if int64(len(body)) > limit {
219
+ return nil, ErrResponseTooLarge
220
+ }
221
+ return body, nil
222
+ }
@@ -0,0 +1,86 @@
1
+ // Code generated by honey. DO NOT EDIT.
2
+
3
+ package sdk
4
+
5
+ import (
6
+ "encoding/json"
7
+ "errors"
8
+ "iter"
9
+ "net/http"
10
+ )
11
+
12
+ // Result is a Client.Safe() method's answer. Ok: Data is the normal method's. Else Err is the
13
+ // error it returns for the answer, an error status (*ClientError or its per-status type) or a
14
+ // *DecodeError, and Data is the zero value. Response is the answer's. No answer (never sent, a
15
+ // refused or dropped connection, a timeout, a cancel) is the method's error.
16
+ type Result[T any] struct {
17
+ Data T
18
+ Err error
19
+ Response *http.Response
20
+ }
21
+
22
+ // Ok reports whether the call answered its data.
23
+ func (r Result[T]) Ok() bool { return r.Err == nil }
24
+
25
+ // DecodeError is a 2xx whose body did not decode, or ran past Config.MaxResponseBytes (Err is
26
+ // then ErrResponseTooLarge, the Body empty).
27
+ type DecodeError struct {
28
+ Response *http.Response
29
+ Err error
30
+ }
31
+
32
+ func (e *DecodeError) Error() string { return "honey: decode response: " + e.Err.Error() }
33
+
34
+ // Unwrap returns the parse error, or ErrResponseTooLarge.
35
+ func (e *DecodeError) Unwrap() error { return e.Err }
36
+
37
+ // decodeJSON decodes a JSON success body into a *T; an empty body gives the zero value.
38
+ func decodeJSON[T any](result *requestResult) (*T, error) {
39
+ var out T
40
+ if len(result.body) > 0 {
41
+ if err := json.Unmarshal(result.body, &out); err != nil {
42
+ return nil, &DecodeError{result.resp, err}
43
+ }
44
+ }
45
+ return &out, nil
46
+ }
47
+
48
+ // safeCall is a Client.Safe() call: its response and, for a stream, whether it opened and how.
49
+ type safeCall struct {
50
+ resp *http.Response
51
+ sent bool
52
+ err error
53
+ }
54
+
55
+ // with is reqOpts reporting to s.
56
+ func (s *safeCall) with(reqOpts []RequestOption) []RequestOption {
57
+ return append([]RequestOption{func(rc *requestConfig) { rc.safe = s }}, reqOpts...)
58
+ }
59
+
60
+ // safeOf is the Result of a normal method's return: an answer's error in Err, any other the error.
61
+ func safeOf[T any](data T, err error, s *safeCall) (Result[T], error) {
62
+ var ce *ClientError
63
+ var de *DecodeError
64
+ switch {
65
+ case err == nil:
66
+ return Result[T]{Data: data, Response: s.resp}, nil
67
+ case errors.As(err, &ce):
68
+ return Result[T]{Err: err, Response: ce.Response}, nil
69
+ case errors.As(err, &de):
70
+ return Result[T]{Err: err, Response: de.Response}, nil
71
+ }
72
+ return Result[T]{}, err
73
+ }
74
+
75
+ // safeOpen is the Result of a stream opened on the call (Data ranges once); one never sent
76
+ // yields its error, the error.
77
+ func safeOpen[T any](seq iter.Seq2[T, error], s *safeCall) (Result[iter.Seq2[T, error]], error) {
78
+ err := s.err
79
+ if !s.sent {
80
+ for _, failed := range seq {
81
+ err = failed
82
+ break
83
+ }
84
+ }
85
+ return safeOf(seq, err, s)
86
+ }