@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,247 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ using System;
3
+ using System.Collections.Generic;
4
+ using System.IO;
5
+ using System.Linq;
6
+ using System.Net.Http;
7
+ using System.Threading;
8
+ using System.Threading.Tasks;
9
+
10
+ namespace Honey.Runtime;
11
+
12
+ internal sealed record Answered(int Status, Dictionary<string, string> Headers, byte[] Body, Uri Url, bool Over);
13
+
14
+ /* a realtime `dial`'s answer past the cap is no answer: its reconnect policy sees a drop */
15
+ internal sealed class Exchange(Transport client, Operation op, Call call, bool stream = false, bool refreshes = true, bool dial = false)
16
+ {
17
+ private const int ReadBuffer = 81_920;
18
+ private const long DefaultMaxResponseBytes = 100L << 20;
19
+ private const long StreamErrorBytes = 64 << 10;
20
+ private static readonly TimeSpan DefaultTimeout = TimeSpan.FromSeconds(30);
21
+
22
+ private readonly CallLog _log = new(client.Config.OnLog, $"{op.Method} {op.Path}");
23
+
24
+ public string Route => $"{op.Method} {op.Path}";
25
+
26
+ public TimeSpan Limit => call.Options?.Timeout ?? client.Config.Timeout ?? DefaultTimeout;
27
+
28
+ public RawResponse? Raw => call.Options?.Raw;
29
+ private StaleMeta _meta = StaleMeta.None;
30
+ private string? _key;
31
+ private int _redirects;
32
+ private HttpResponseMessage? _live;
33
+
34
+ public async Task<(RawResponse Raw, SdkException? Error)> RunAsync(CancellationToken cancellationToken) =>
35
+ Done(await BoundedAsync(cancellationToken).ConfigureAwait(false));
36
+
37
+ public async Task<HttpResponseMessage> OpenAsync(CancellationToken cancellationToken)
38
+ {
39
+ try
40
+ {
41
+ var (raw, error) = Done(await BoundedAsync(cancellationToken).ConfigureAwait(false));
42
+ if (error is not null)
43
+ {
44
+ throw error;
45
+ }
46
+ call.Read?.Invoke(raw.Headers);
47
+ return _live!;
48
+ }
49
+ catch
50
+ {
51
+ _live?.Dispose();
52
+ throw;
53
+ }
54
+ }
55
+
56
+ private async Task<Answered> BoundedAsync(CancellationToken cancellationToken)
57
+ {
58
+ _log.Start();
59
+ var limit = Limit;
60
+ using var deadline = CancellationTokenSource.CreateLinkedTokenSource(cancellationToken);
61
+ if (limit > TimeSpan.Zero)
62
+ {
63
+ deadline.CancelAfter(limit);
64
+ }
65
+ try
66
+ {
67
+ return await AnswerAsync(deadline.Token).ConfigureAwait(false);
68
+ }
69
+ catch (HoneyException e)
70
+ {
71
+ _log.Failed(e);
72
+ throw;
73
+ }
74
+ catch (OperationCanceledException) when (cancellationToken.IsCancellationRequested)
75
+ {
76
+ _log.Canceled();
77
+ throw;
78
+ }
79
+ catch (OperationCanceledException e)
80
+ {
81
+ throw Failed(new ApiTimeoutException($"{Route} timed out after {limit.TotalMilliseconds} ms", e));
82
+ }
83
+ catch (Exception e) when (e is HttpRequestException or IOException)
84
+ {
85
+ throw Failed(new ApiConnectionException($"{Route}: {e.Message}", e));
86
+ }
87
+ }
88
+
89
+ private HoneyException Failed(HoneyException error)
90
+ {
91
+ _log.Failed(error);
92
+ return error;
93
+ }
94
+
95
+ private async Task<Answered> AnswerAsync(CancellationToken token)
96
+ {
97
+ var path = UrlPath.Expand(op, call.Path);
98
+ var url = Url(path);
99
+ _meta = client.Stale.Begin(op.Method, path);
100
+ _key = op.Idempotent ? call.IdempotencyKey ?? Guid.NewGuid().ToString() : null;
101
+ var state = client.Config.State ?? new Dictionary<string, object?>();
102
+ var used = client.Auth.Token;
103
+ var answer = await AttemptAsync(url, used, new CallState(false, _meta.Selector, _meta.IsStale, _meta.InvalidatedBy, state), token).ConfigureAwait(false);
104
+ if (answer.Status == 401 && refreshes && client.Config.OnAuthExpired is { } hook && (call.Body?.Replayable ?? true)
105
+ && await client.Auth.RefreshAsync(used, hook, token).ConfigureAwait(false) is { } fresh)
106
+ {
107
+ answer = await AttemptAsync(url, fresh, new CallState(true, _meta.Selector, _meta.IsStale, _meta.InvalidatedBy, state), token).ConfigureAwait(false);
108
+ }
109
+ return answer;
110
+ }
111
+
112
+ private async Task<Answered> AttemptAsync(Uri url, string? credential, CallState shared, CancellationToken token)
113
+ {
114
+ var request = new RequestContext(op.Method, url, DialHeaders(credential), shared) { Body = call.Body?.Content };
115
+ await Hooks.RunAsync(client.Config.OnRequest, request, token).ConfigureAwait(false);
116
+ Wire.Check(request.Headers);
117
+ var upload = request.Body is null ? call.Body?.Stream : null;
118
+ var hop = new Hop(request.Method, request.Url, new Dictionary<string, string>(request.Headers, StringComparer.OrdinalIgnoreCase), request.Body, upload, false);
119
+ var start = hop.Url;
120
+ while (true)
121
+ {
122
+ var response = await client.Http.SendAsync(Wire.Message(hop), HttpCompletionOption.ResponseHeadersRead, token).ConfigureAwait(false);
123
+ var next = _redirects < Redirects.Max ? Redirects.Next(hop, response, start, client.Config.Redirect) : null;
124
+ if (next is not null)
125
+ {
126
+ response.Dispose();
127
+ _redirects++;
128
+ hop = next;
129
+ continue;
130
+ }
131
+ var status = (int)response.StatusCode;
132
+ var headers = Wire.HeadersOf(response);
133
+ byte[]? body = [];
134
+ if (stream && status is >= 200 and < 300)
135
+ {
136
+ _live = response;
137
+ }
138
+ else
139
+ {
140
+ using (response)
141
+ {
142
+ body = await BodyAsync(response, token).ConfigureAwait(false) ?? (dial ? throw Over() : null);
143
+ }
144
+ }
145
+ var answer = new ResponseContext(status, headers, body ?? [], shared);
146
+ await Hooks.RunAsync(client.Config.OnResponse, answer, token).ConfigureAwait(false);
147
+ return new Answered(answer.Status, new Dictionary<string, string>(answer.Headers, StringComparer.OrdinalIgnoreCase), answer.Body, hop.Url, body is null);
148
+ }
149
+ }
150
+
151
+ public Uri Url() => Url(UrlPath.Expand(op, call.Path));
152
+
153
+ private Uri Url(string path)
154
+ {
155
+ var origin = call.Options?.BaseUrl is { Length: > 0 } alt ? Transport.Absolute(alt, "RequestOptions.BaseUrl") : client.Base;
156
+ return new Uri(Transport.Url(origin, path, UrlQuery.Encode(call.Query)));
157
+ }
158
+
159
+ public Dictionary<string, string> DialHeaders(string? credential)
160
+ {
161
+ var headers = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
162
+ void Layer(string name, string value)
163
+ {
164
+ headers.Remove(name);
165
+ headers[name] = value;
166
+ }
167
+ Layer("X-Request-Id", Guid.NewGuid().ToString());
168
+ if (call.Body is { } body)
169
+ {
170
+ Layer("Content-Type", body.MediaType);
171
+ }
172
+ foreach (var (name, value) in client.Config.Headers ?? new Dictionary<string, string>())
173
+ {
174
+ Layer(name, value);
175
+ }
176
+ if (op.Accept is { } accept)
177
+ {
178
+ Layer("Accept", accept);
179
+ }
180
+ if (_key is not null)
181
+ {
182
+ Layer("Idempotency-Key", _key);
183
+ }
184
+ foreach (var arg in call.Headers)
185
+ {
186
+ if (UrlQuery.Text(arg.Value) is { } text)
187
+ {
188
+ Layer(arg.Name, text);
189
+ }
190
+ }
191
+ foreach (var (name, value) in call.Options?.Headers ?? new Dictionary<string, string>())
192
+ {
193
+ Layer(name, value);
194
+ }
195
+ if (!string.IsNullOrEmpty(credential))
196
+ {
197
+ Layer(client.Auth.Header, client.Auth.Prefix + credential);
198
+ }
199
+ return headers;
200
+ }
201
+
202
+ public async Task<byte[]> ReadAsync(HttpResponseMessage response, CancellationToken token) =>
203
+ await BodyAsync(response, token).ConfigureAwait(false) ?? throw Over();
204
+
205
+ private ApiConnectionException Over() => new($"the answer exceeds {Max} bytes");
206
+
207
+ private long Max => stream ? StreamErrorBytes : client.Config.MaxResponseBytes ?? DefaultMaxResponseBytes;
208
+
209
+ /* null past the cap */
210
+ private async Task<byte[]?> BodyAsync(HttpResponseMessage response, CancellationToken token)
211
+ {
212
+ var source = await response.Content.ReadAsStreamAsync(token).ConfigureAwait(false);
213
+ await using var _ = source.ConfigureAwait(false);
214
+ using var body = new MemoryStream();
215
+ var buffer = new byte[ReadBuffer];
216
+ int read;
217
+ while ((read = await source.ReadAsync(buffer, token).ConfigureAwait(false)) > 0)
218
+ {
219
+ body.Write(buffer, 0, read);
220
+ if (Max > 0 && body.Length > Max)
221
+ {
222
+ return null;
223
+ }
224
+ }
225
+ return body.ToArray();
226
+ }
227
+
228
+ private (RawResponse Raw, SdkException? Error) Done(Answered answer)
229
+ {
230
+ _log.Received(answer.Status);
231
+ SdkException? error = null;
232
+ if (answer.Status is >= 200 and < 300)
233
+ {
234
+ var values = op.PathParams.Zip(call.Path).ToDictionary(pair => pair.First, pair => pair.Second);
235
+ client.Stale.Settle(_meta, op.Invalidates ?? [], values);
236
+ error = answer.Over ? new DecodeException($"the answer exceeds {Max} bytes") : null;
237
+ }
238
+ else
239
+ {
240
+ error = ApiStatusException.Of(Envelopes.Of(answer.Status, answer.Headers, answer.Body, client.Json));
241
+ _log.Failed(error);
242
+ }
243
+ var raw = call.Options?.Raw ?? new RawResponse();
244
+ raw.Fill(answer.Status, answer.Headers, answer.Body, answer.Url);
245
+ return (raw, error);
246
+ }
247
+ }
@@ -0,0 +1,103 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ using System;
3
+ using System.Linq;
4
+ using System.Net;
5
+ using System.Net.Http;
6
+ using System.Threading;
7
+ using System.Threading.Tasks;
8
+
9
+ namespace Honey.Runtime;
10
+
11
+ internal sealed class StripHandler : DelegatingHandler
12
+ {
13
+ public static readonly HttpRequestOptionsKey<bool> Cross = new("honey.cross");
14
+
15
+ private static readonly string[] Safe = ["Accept", "Accept-Language", "User-Agent"];
16
+
17
+ protected override Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)
18
+ {
19
+ if (request.Options.TryGetValue(Cross, out var cross) && cross)
20
+ {
21
+ foreach (var name in request.Headers.Select(header => header.Key).ToList())
22
+ {
23
+ if (!Safe.Contains(name, StringComparer.OrdinalIgnoreCase))
24
+ {
25
+ request.Headers.Remove(name);
26
+ }
27
+ }
28
+ }
29
+ return base.SendAsync(request, cancellationToken);
30
+ }
31
+ }
32
+
33
+ internal static class Handler
34
+ {
35
+ public static (HttpMessageHandler Root, bool Owned) Install(ClientConfig config)
36
+ {
37
+ if (config.Handler is not { } root)
38
+ {
39
+ var primary = new SocketsHttpHandler
40
+ {
41
+ AllowAutoRedirect = false,
42
+ UseCookies = false,
43
+ /* a stream let go early closes its connection at once instead of draining it first (up to 2 s) */
44
+ MaxResponseDrainSize = 0,
45
+ AutomaticDecompression = DecompressionMethods.GZip | DecompressionMethods.Deflate | DecompressionMethods.Brotli,
46
+ };
47
+ return (new StripHandler { InnerHandler = primary }, true);
48
+ }
49
+ try
50
+ {
51
+ return (Insert(root), false);
52
+ }
53
+ catch (InvalidOperationException)
54
+ {
55
+ throw new ConfigException("ClientConfig.Handler has already sent a request: pass one that has not, with AllowAutoRedirect off or left for the SDK to turn off");
56
+ }
57
+ }
58
+
59
+ private static HttpMessageHandler Insert(HttpMessageHandler root)
60
+ {
61
+ DelegatingHandler? last = null;
62
+ var at = root;
63
+ while (at is DelegatingHandler link)
64
+ {
65
+ if (link is StripHandler)
66
+ {
67
+ return root;
68
+ }
69
+ last = link;
70
+ at = link.InnerHandler ?? throw new ConfigException("ClientConfig.Handler: a DelegatingHandler has no InnerHandler");
71
+ }
72
+ Prepare(at);
73
+ var strip = new StripHandler { InnerHandler = at };
74
+ if (last is null)
75
+ {
76
+ return strip;
77
+ }
78
+ last.InnerHandler = strip;
79
+ return root;
80
+ }
81
+
82
+ private static void Prepare(HttpMessageHandler primary)
83
+ {
84
+ var credentials = primary switch
85
+ {
86
+ SocketsHttpHandler sockets => sockets.Credentials,
87
+ HttpClientHandler client => client.Credentials,
88
+ _ => null,
89
+ };
90
+ if (credentials is not (null or CredentialCache))
91
+ {
92
+ throw new ConfigException("ClientConfig.Handler's Credentials answer every origin's challenge: scope them with a CredentialCache");
93
+ }
94
+ if (primary is SocketsHttpHandler { AllowAutoRedirect: true } own)
95
+ {
96
+ own.AllowAutoRedirect = false;
97
+ }
98
+ else if (primary is HttpClientHandler { AllowAutoRedirect: true } client)
99
+ {
100
+ client.AllowAutoRedirect = false;
101
+ }
102
+ }
103
+ }
@@ -0,0 +1,128 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ using System;
3
+ using System.Collections.Generic;
4
+ using System.Threading;
5
+ using System.Threading.Tasks;
6
+
7
+ namespace Honey.Runtime;
8
+
9
+ /// <summary>
10
+ /// A request about to be sent, before each attempt: a hook may change its method, URL, headers and body. Its
11
+ /// headers are one value per name whatever the casing, the credential included, and every hop is built from them.
12
+ /// <c>Body</c> is null for a stream body. <c>ToString</c> names only the method, the retry and the stale fields.
13
+ /// </summary>
14
+ public sealed class RequestContext
15
+ {
16
+ internal RequestContext(string method, Uri url, IDictionary<string, string> headers, CallState call)
17
+ {
18
+ Method = method;
19
+ Url = url;
20
+ Headers = headers;
21
+ IsRetry = call.IsRetry;
22
+ Selector = call.Selector;
23
+ IsStale = call.IsStale;
24
+ InvalidatedBy = call.InvalidatedBy;
25
+ State = call.State;
26
+ }
27
+
28
+ /// <summary>The HTTP method.</summary>
29
+ public string Method { get; set; }
30
+
31
+ /// <summary>The URL, query included.</summary>
32
+ public Uri Url { get; set; }
33
+
34
+ /// <summary>Every header the request sends, by case-insensitive name.</summary>
35
+ public IDictionary<string, string> Headers { get; }
36
+
37
+ /// <summary>The body; null without one, or for a stream body.</summary>
38
+ public byte[]? Body { get; set; }
39
+
40
+ /// <summary>Whether this is the attempt after a 401 and a new token.</summary>
41
+ public bool IsRetry { get; }
42
+
43
+ /// <summary><c>METHOD /path</c>, the stale tracker's key; empty when stale tracking is off.</summary>
44
+ public string Selector { get; }
45
+
46
+ /// <summary>Whether a mutation marked this selector stale.</summary>
47
+ public bool IsStale { get; }
48
+
49
+ /// <summary>The mutations that marked it, as their selectors.</summary>
50
+ public IReadOnlyList<string> InvalidatedBy { get; }
51
+
52
+ /// <summary>The state every hook of the call shares.</summary>
53
+ public IDictionary<string, object?> State { get; }
54
+
55
+ /// <inheritdoc/>
56
+ public override string ToString() =>
57
+ $"RequestContext {{ Method = {Method}, IsRetry = {IsRetry}, Selector = {Selector}, IsStale = {IsStale}, InvalidatedBy = [{string.Join(", ", InvalidatedBy)}] }}";
58
+ }
59
+
60
+ /// <summary>
61
+ /// An attempt's answer before it is read as the call's: a hook may change its headers and body, never its status.
62
+ /// <c>ToString</c> names only the status, the retry and the stale fields.
63
+ /// </summary>
64
+ public sealed class ResponseContext
65
+ {
66
+ internal ResponseContext(int status, IDictionary<string, string> headers, byte[] body, CallState call)
67
+ {
68
+ Status = status;
69
+ Headers = headers;
70
+ Body = body;
71
+ IsRetry = call.IsRetry;
72
+ Selector = call.Selector;
73
+ IsStale = call.IsStale;
74
+ InvalidatedBy = call.InvalidatedBy;
75
+ State = call.State;
76
+ }
77
+
78
+ /// <summary>The HTTP status.</summary>
79
+ public int Status { get; }
80
+
81
+ /// <summary>Every header of the answer, by case-insensitive name.</summary>
82
+ public IDictionary<string, string> Headers { get; }
83
+
84
+ /// <summary>The body as received, decoded.</summary>
85
+ public byte[] Body { get; set; }
86
+
87
+ /// <summary>Whether this is the attempt after a 401 and a new token.</summary>
88
+ public bool IsRetry { get; }
89
+
90
+ /// <summary><c>METHOD /path</c>, the stale tracker's key; empty when stale tracking is off.</summary>
91
+ public string Selector { get; }
92
+
93
+ /// <summary>Whether a mutation marked this selector stale.</summary>
94
+ public bool IsStale { get; }
95
+
96
+ /// <summary>The mutations that marked it, as their selectors.</summary>
97
+ public IReadOnlyList<string> InvalidatedBy { get; }
98
+
99
+ /// <summary>The state every hook of the call shares.</summary>
100
+ public IDictionary<string, object?> State { get; }
101
+
102
+ /// <inheritdoc/>
103
+ public override string ToString() =>
104
+ $"ResponseContext {{ Status = {Status}, IsRetry = {IsRetry}, Selector = {Selector}, IsStale = {IsStale}, InvalidatedBy = [{string.Join(", ", InvalidatedBy)}] }}";
105
+ }
106
+
107
+ internal sealed record CallState(bool IsRetry, string Selector, bool IsStale, IReadOnlyList<string> InvalidatedBy, IDictionary<string, object?> State);
108
+
109
+ internal static class Hooks
110
+ {
111
+ public static async Task RunAsync<T>(IReadOnlyList<Func<T, CancellationToken, Task>>? hooks, T context, CancellationToken token)
112
+ {
113
+ foreach (var hook in hooks ?? [])
114
+ {
115
+ try
116
+ {
117
+ await hook(context, token).ConfigureAwait(false);
118
+ }
119
+ catch (Exception e) when (Wraps(e, token))
120
+ {
121
+ throw new HookException($"hook: {e.Message}", e);
122
+ }
123
+ }
124
+ }
125
+
126
+ public static bool Wraps(Exception error, CancellationToken token) =>
127
+ error is not HoneyException && !(error is OperationCanceledException && token.IsCancellationRequested);
128
+ }
@@ -0,0 +1,102 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ using System.Collections.Generic;
3
+ using System.Linq;
4
+ using System.Text;
5
+
6
+ namespace Honey.Runtime;
7
+
8
+ internal static class Invalidation
9
+ {
10
+ public static List<string> Resolve(IEnumerable<string> targets, IReadOnlyDictionary<string, string> values) =>
11
+ [.. targets.Select(target =>
12
+ {
13
+ var space = target.IndexOf(' ');
14
+ var path = space < 0 ? null : Expand(target[(space + 1)..], values);
15
+ return path is null ? target : $"{target[..space]} {path}";
16
+ })];
17
+
18
+ public static bool HasPlaceholders(string path) =>
19
+ path.Split('/').Any(part => ColonName(part) is not null || (part.Contains('{') && part.Contains('}')));
20
+
21
+ public static bool Matches(string path, string pattern)
22
+ {
23
+ if (path == pattern)
24
+ {
25
+ return true;
26
+ }
27
+ var got = path.Split('/');
28
+ var want = pattern.Split('/');
29
+ return got.Length == want.Length
30
+ && got.Zip(want).All(pair => ColonName(pair.Second) is not null ? pair.First.Length > 0 : SegmentMatches(pair.First, pair.Second));
31
+ }
32
+
33
+ private static bool SegmentMatches(string text, string pattern)
34
+ {
35
+ var open = pattern.IndexOf('{');
36
+ var close = open < 0 ? -1 : pattern.IndexOf('}', open);
37
+ if (close < 0)
38
+ {
39
+ return text == pattern;
40
+ }
41
+ var head = pattern[..open];
42
+ var rest = pattern[(close + 1)..];
43
+ if (!text.StartsWith(head, System.StringComparison.Ordinal))
44
+ {
45
+ return false;
46
+ }
47
+ var tail = text[head.Length..];
48
+ for (var i = 1; i <= tail.Length; i++)
49
+ {
50
+ if (SegmentMatches(tail[i..], rest))
51
+ {
52
+ return true;
53
+ }
54
+ }
55
+ return false;
56
+ }
57
+
58
+ private static string? ColonName(string part) =>
59
+ part.Length > 1 && part[0] == ':' && (char.IsAsciiLetter(part[1]) || part[1] == '_')
60
+ && part.Skip(1).All(c => char.IsAsciiLetterOrDigit(c) || c == '_') ? part[1..] : null;
61
+
62
+ private static string? Expand(string template, IReadOnlyDictionary<string, string> values)
63
+ {
64
+ var segments = new List<string>();
65
+ foreach (var segment in template.Split('/'))
66
+ {
67
+ if (ColonName(segment) is { } colon)
68
+ {
69
+ if (Value(colon, values) is not { } named)
70
+ {
71
+ return null;
72
+ }
73
+ segments.Add(named);
74
+ continue;
75
+ }
76
+ var text = new StringBuilder();
77
+ var part = segment;
78
+ for (var open = part.IndexOf('{'); open >= 0; open = part.IndexOf('{'))
79
+ {
80
+ var close = part.IndexOf('}', open);
81
+ var name = close < 0 ? "" : part[(open + 1)..close];
82
+ if (name.Length == 0 || name.Contains('{'))
83
+ {
84
+ text.Append(part, 0, open + 1);
85
+ part = part[(open + 1)..];
86
+ continue;
87
+ }
88
+ if (Value(name, values) is not { } value)
89
+ {
90
+ return null;
91
+ }
92
+ text.Append(part, 0, open).Append(value);
93
+ part = part[(close + 1)..];
94
+ }
95
+ segments.Add(text.Append(part).ToString());
96
+ }
97
+ return string.Join('/', segments);
98
+ }
99
+
100
+ private static string? Value(string name, IReadOnlyDictionary<string, string> values) =>
101
+ values.TryGetValue(name, out var value) && value is not ("" or "." or "..") ? UrlPath.Encoded(value) : null;
102
+ }