@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,117 @@
1
+ // Code generated by honey. DO NOT EDIT.
2
+
3
+ package cli
4
+
5
+ import (
6
+ "fmt"
7
+ "net"
8
+ "net/url"
9
+ "strings"
10
+
11
+ "github.com/spf13/cobra"
12
+ )
13
+
14
+ // Target is where the run's calls go: "local" for a loopback host (localhost, 127.0.0.0/8, ::1),
15
+ // else "remote", and the host (with its port); none when no base URL is set and the API declares
16
+ // no server.
17
+ func (c Config) Target() (kind, host string) {
18
+ base := c.BaseURL
19
+ if base == "" {
20
+ base = c.server
21
+ }
22
+ if base == "" {
23
+ return "none", ""
24
+ }
25
+ parsed, err := url.Parse(base)
26
+ if err != nil || parsed.Host == "" {
27
+ return "remote", base
28
+ }
29
+ name := strings.ToLower(parsed.Hostname())
30
+ if ip := net.ParseIP(name); name == "localhost" || strings.HasSuffix(name, ".localhost") || (ip != nil && ip.IsLoopback()) {
31
+ return "local", parsed.Host
32
+ }
33
+ return "remote", parsed.Host
34
+ }
35
+
36
+ // Announce writes the target to stderr as `→ local 127.0.0.1:3000` when stderr is a terminal and
37
+ // the run is not --quiet: a person watching sees it; a pipe's stderr stays one JSON line.
38
+ func (c Config) Announce() {
39
+ if c.Quiet || !terminal(c.log) {
40
+ return
41
+ }
42
+ kind, host := c.Target()
43
+ fmt.Fprintf(c.log, "→ %s %s\n", kind, host)
44
+ }
45
+
46
+ // configCommand adds `config`: the run's resolved settings, each with its source (flag, env, file
47
+ // or default) and every secret redacted, then the target; under --json one object.
48
+ func configCommand(root *cobra.Command) {
49
+ root.AddCommand(&cobra.Command{
50
+ Use: "config",
51
+ Short: "the settings this run resolves, each with its source, and where calls go",
52
+ GroupID: localGroup,
53
+ Args: cobra.NoArgs,
54
+ RunE: func(c *cobra.Command, _ []string) error {
55
+ cfg, err := Settings(c)
56
+ if err != nil {
57
+ return err
58
+ }
59
+ return cfg.print(c)
60
+ },
61
+ })
62
+ }
63
+
64
+ func (c Config) print(cmd *cobra.Command) error {
65
+ timeout := c.Timeout.String()
66
+ if c.Timeout == 0 {
67
+ timeout = "30s"
68
+ }
69
+ apiKey := ""
70
+ if c.APIKey != "" {
71
+ apiKey = redacted
72
+ }
73
+ headers := map[string]any{}
74
+ // secretsOf holds credential headers' values
75
+ for name, value := range c.Headers {
76
+ headers[name] = c.redact(value)
77
+ }
78
+ values := map[string]any{
79
+ "api_key": apiKey, "base_url": c.redact(c.BaseURL), "headers": headers,
80
+ "quiet": c.Quiet, "redirect": c.Redirect, "timeout": timeout, "verbose": c.Verbose,
81
+ }
82
+ kind, host := c.Target()
83
+ if jsonAsked(cmd) {
84
+ out := map[string]any{"target": map[string]string{"kind": kind, "host": host}}
85
+ for name, value := range values {
86
+ out[name] = map[string]any{"value": value, "source": c.sources[name]}
87
+ }
88
+ line, err := compact(out)
89
+ if err == nil {
90
+ _, err = cmd.OutOrStdout().Write(line)
91
+ }
92
+ return err
93
+ }
94
+ var b strings.Builder
95
+ for _, name := range sortedKeys(values) {
96
+ value := values[name]
97
+ if h, ok := value.(map[string]any); ok {
98
+ value = headerList(h)
99
+ }
100
+ if value == "" {
101
+ value = "-"
102
+ }
103
+ fmt.Fprintf(&b, "%s %v (%s)\n", name, value, c.sources[name])
104
+ }
105
+ fmt.Fprintln(&b, strings.TrimSpace("target "+kind+" "+host))
106
+ _, err := fmt.Fprint(cmd.OutOrStdout(), escapeControls(b.String(), true))
107
+ return err
108
+ }
109
+
110
+ // headerList is headers as `Name: value; Name: value`, by name, or "" for none.
111
+ func headerList(headers map[string]any) string {
112
+ var parts []string
113
+ for _, name := range sortedKeys(headers) {
114
+ parts = append(parts, fmt.Sprintf("%s: %v", name, headers[name]))
115
+ }
116
+ return strings.Join(parts, "; ")
117
+ }
@@ -0,0 +1,183 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ using System;
3
+ using System.Collections.Generic;
4
+ using System.Globalization;
5
+ using System.Text.Json;
6
+ using System.Text.Json.Serialization.Metadata;
7
+ using System.Threading;
8
+ using System.Threading.Tasks;
9
+
10
+ namespace Honey.Runtime;
11
+
12
+ /// <summary>What a realtime connection opens over.</summary>
13
+ public enum TransportKind
14
+ {
15
+ /// <summary>A WebSocket.</summary>
16
+ Ws,
17
+
18
+ /// <summary>A server-sent event stream.</summary>
19
+ Sse,
20
+
21
+ /// <summary>One GET per message.</summary>
22
+ LongPoll,
23
+ }
24
+
25
+ /// <summary>A realtime connection's resume cursor, advanced past each message it delivers, its subprotocols and its reconnect policy.</summary>
26
+ public sealed class TransportOptions
27
+ {
28
+ /// <summary>The last event id delivered: sent as <c>last_event_id</c>, or as Last-Event-ID on an event stream.</summary>
29
+ public string? LastEventId { get; set; }
30
+
31
+ /// <summary>The last reconnect token delivered: sent as <c>reconnect_token</c>.</summary>
32
+ public string? ReconnectToken { get; set; }
33
+
34
+ /// <summary>The subprotocols a WebSocket dial offers.</summary>
35
+ public IReadOnlyList<string> Protocols { get; init; } = [];
36
+
37
+ /// <summary>The reconnects in a row before the connection gives up.</summary>
38
+ public int MaxReconnectAttempts { get; init; } = 5;
39
+
40
+ /// <summary>The first reconnect's base delay, doubled per attempt up to 30 s; an SSE <c>retry</c> replaces it.</summary>
41
+ public TimeSpan ReconnectDelay { get; init; } = TimeSpan.FromSeconds(1);
42
+
43
+ internal static TransportOptions Of(string? lastEventId, string? reconnectToken, IReadOnlyList<string>? protocols, int? maxReconnectAttempts, TimeSpan? reconnectDelay) =>
44
+ new()
45
+ {
46
+ LastEventId = lastEventId,
47
+ ReconnectToken = reconnectToken,
48
+ Protocols = protocols ?? [],
49
+ MaxReconnectAttempts = maxReconnectAttempts ?? 5,
50
+ ReconnectDelay = reconnectDelay ?? TimeSpan.FromSeconds(1),
51
+ };
52
+
53
+ /* past a message: its SSE id, else the payload's id or last_event_id (a string or an integer), and its reconnect_token */
54
+ internal void Advance(string? id, JsonElement payload)
55
+ {
56
+ var found = payload.ValueKind == JsonValueKind.Object ? payload : default;
57
+ if ((string.IsNullOrEmpty(id) ? Cursor(found) : id) is { Length: > 0 } cursor)
58
+ {
59
+ LastEventId = cursor;
60
+ }
61
+ if (found.ValueKind == JsonValueKind.Object && found.TryGetProperty("reconnect_token", out var token)
62
+ && token.ValueKind == JsonValueKind.String && token.GetString() is { Length: > 0 } text)
63
+ {
64
+ ReconnectToken = text;
65
+ }
66
+ }
67
+
68
+ private static string? Cursor(JsonElement found)
69
+ {
70
+ if (found.ValueKind != JsonValueKind.Object)
71
+ {
72
+ return null;
73
+ }
74
+ var at = found.TryGetProperty("id", out var id) ? id : found.TryGetProperty("last_event_id", out var last) ? last : default;
75
+ return at.ValueKind switch
76
+ {
77
+ JsonValueKind.String => at.GetString(),
78
+ JsonValueKind.Number when at.TryGetInt64(out var n) => n.ToString(CultureInfo.InvariantCulture),
79
+ _ => null,
80
+ };
81
+ }
82
+ }
83
+
84
+ /// <summary>One message as a transport read it: its text, and an SSE event's id and <c>retry</c>.</summary>
85
+ public sealed record TransportMessage(string Text, string? Id = null, TimeSpan? Retry = null);
86
+
87
+ /// <summary>One open transport; a receive answering null means it ended.</summary>
88
+ public interface ITransportConnection : IAsyncDisposable
89
+ {
90
+ /// <summary>The next message; null once the transport ended.</summary>
91
+ Task<TransportMessage?> ReceiveAsync(CancellationToken cancellationToken);
92
+
93
+ /// <summary>Sends <paramref name="text"/> over the transport.</summary>
94
+ Task SendAsync(string text, CancellationToken cancellationToken);
95
+ }
96
+
97
+ /// <summary>A transport a realtime connection opens over: one of a call's defaults, or a caller's own.</summary>
98
+ public interface ITransportAdapter
99
+ {
100
+ /// <summary>The adapter's name.</summary>
101
+ string Name { get; }
102
+
103
+ /// <summary>What it opens.</summary>
104
+ TransportKind Kind { get; }
105
+
106
+ /// <summary>Opens a connection to <paramref name="url"/> resuming from <paramref name="options"/>' cursor.</summary>
107
+ Task<ITransportConnection> ConnectAsync(string url, TransportOptions options, CancellationToken cancellationToken);
108
+ }
109
+
110
+ internal interface IDialed
111
+ {
112
+ Dial Dial { get; }
113
+ }
114
+
115
+ /* a call's default adapters' dials: fresh exchanges without a 401 refresh (the loop's) */
116
+ internal sealed class Dial(Transport client, Operation op, Call call)
117
+ {
118
+ private string? _used;
119
+
120
+ public Transport Client => client;
121
+
122
+ public Uri Url() => new Exchange(client, op, call).Url();
123
+
124
+ public Exchange Socket(TransportOptions cursor) => With(op, Cursored(cursor), true, null);
125
+
126
+ public Exchange Stream(TransportOptions cursor) =>
127
+ With(op with { Accept = "text/event-stream" }, call with
128
+ {
129
+ Query = [.. call.Query, Arg.Text("reconnect_token", cursor.ReconnectToken)],
130
+ Headers = [.. call.Headers, Arg.Text("Last-Event-ID", cursor.LastEventId)],
131
+ }, true, null);
132
+
133
+ /* a poll waits up to 60 s whatever the client's timeout */
134
+ public Exchange Poll(TransportOptions cursor) => With(op, Cursored(cursor), false, TimeSpan.FromSeconds(60));
135
+
136
+ public async Task PostAsync(string text, CancellationToken cancellationToken)
137
+ {
138
+ var post = With(op with { Method = "POST", Accept = null }, call with { Body = Body.Text(text, "application/json") }, false, null, true, dial: false);
139
+ var (_, error) = await post.RunAsync(cancellationToken).ConfigureAwait(false);
140
+ if (error is not null)
141
+ {
142
+ throw error;
143
+ }
144
+ }
145
+
146
+ public async Task<bool> RefreshAsync(CancellationToken cancellationToken) =>
147
+ client.Config.OnAuthExpired is { } hook && await client.Auth.RefreshAsync(_used, hook, cancellationToken).ConfigureAwait(false) is not null;
148
+
149
+ /* the call's own Raw: the answer the connection last opened with, its body never read */
150
+ public void Opened(RawResponse raw) => call.Options?.Raw?.Fill(raw.Status, raw.Headers, [], raw.Url!);
151
+
152
+ private Call Cursored(TransportOptions cursor) =>
153
+ call with { Query = [.. call.Query, Arg.Text("last_event_id", cursor.LastEventId), Arg.Text("reconnect_token", cursor.ReconnectToken)] };
154
+
155
+ private Exchange With(Operation dialed, Call at, bool stream, TimeSpan? timeout, bool refreshes = false, bool dial = true)
156
+ {
157
+ var options = at.Options ?? new RequestOptions();
158
+ _used = client.Auth.Token;
159
+ return new Exchange(client, dialed, at with { Options = options with { Raw = new RawResponse(), Timeout = timeout ?? options.Timeout } }, stream, refreshes, dial);
160
+ }
161
+ }
162
+
163
+ internal sealed partial class Transport
164
+ {
165
+ public async Task<ResumableConnection<T>> RealtimeAsync<T>(Operation op, Call call, TransportOptions options, JsonTypeInfo<T> info, CancellationToken cancellationToken)
166
+ {
167
+ var dial = new Dial(this, op, call);
168
+ var url = dial.Url();
169
+ cancellationToken.ThrowIfCancellationRequested();
170
+ var connection = new ResumableConnection<T>(url.ToString(), [new WsAdapter(dial), new SseAdapter(dial), new LongPollAdapter(dial)], info, options);
171
+ using var bound = CancellationTokenSource.CreateLinkedTokenSource(cancellationToken);
172
+ bound.CancelAfter(RealtimeLoop.OpenLimit);
173
+ try
174
+ {
175
+ await connection.ConnectAsync(bound.Token).ConfigureAwait(false);
176
+ }
177
+ catch (OperationCanceledException e) when (!cancellationToken.IsCancellationRequested)
178
+ {
179
+ throw new ApiTimeoutException("no transport opened within 30 s", e);
180
+ }
181
+ return connection.Bound(cancellationToken);
182
+ }
183
+ }
@@ -0,0 +1,56 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ using System;
3
+ using System.Threading;
4
+ using System.Threading.Tasks;
5
+
6
+ namespace Honey.Runtime;
7
+
8
+ internal sealed class Credential
9
+ {
10
+ private readonly SemaphoreSlim _gate = new(1, 1);
11
+ private volatile string? _token;
12
+
13
+ public Credential(ClientConfig config, Defaults defaults)
14
+ {
15
+ Header = config.AuthHeaderName ?? defaults.AuthHeader;
16
+ Prefix = config.AuthHeaderPrefix ?? (config.AuthHeaderName is null ? defaults.AuthPrefix : "");
17
+ _token = string.IsNullOrEmpty(config.BearerToken) ? (string.IsNullOrEmpty(config.ApiKey) ? null : config.ApiKey) : config.BearerToken;
18
+ }
19
+
20
+ public string Header { get; }
21
+
22
+ public string Prefix { get; }
23
+
24
+ public string? Token => _token;
25
+
26
+ public async Task<string?> RefreshAsync(string? rejected, Func<CancellationToken, Task<string?>> hook, CancellationToken cancellationToken)
27
+ {
28
+ await _gate.WaitAsync(cancellationToken).ConfigureAwait(false);
29
+ try
30
+ {
31
+ if (_token != rejected)
32
+ {
33
+ return _token;
34
+ }
35
+ string? fresh;
36
+ try
37
+ {
38
+ fresh = await hook(cancellationToken).ConfigureAwait(false);
39
+ }
40
+ catch (Exception e) when (Hooks.Wraps(e, cancellationToken))
41
+ {
42
+ throw new HookException($"on_auth_expired: {e.Message}", e);
43
+ }
44
+ if (string.IsNullOrEmpty(fresh))
45
+ {
46
+ return null;
47
+ }
48
+ _token = fresh;
49
+ return fresh;
50
+ }
51
+ finally
52
+ {
53
+ _gate.Release();
54
+ }
55
+ }
56
+ }
@@ -0,0 +1,135 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ using System;
3
+ using System.Collections.Generic;
4
+ using System.IO;
5
+ using System.Text;
6
+ using System.Text.Json;
7
+ using System.Text.Json.Serialization.Metadata;
8
+
9
+ namespace Honey.Runtime;
10
+
11
+ /// <summary>
12
+ /// A binary body: a <c>byte[]</c>, sent with its length and sent again after a 401 or a 307/308, or a
13
+ /// <c>Stream</c>, read once as it is sent (chunked) and never sent again.
14
+ /// </summary>
15
+ public sealed class BinaryBody
16
+ {
17
+ private BinaryBody(byte[]? bytes, Stream? stream)
18
+ {
19
+ Bytes = bytes;
20
+ Stream = stream;
21
+ }
22
+
23
+ internal byte[]? Bytes { get; }
24
+
25
+ internal Stream? Stream { get; }
26
+
27
+ /// <summary>A body in memory: replayable.</summary>
28
+ public static implicit operator BinaryBody(byte[] bytes) => new(bytes, null);
29
+
30
+ /// <summary>A body read once: one-shot.</summary>
31
+ public static implicit operator BinaryBody(Stream stream) => new(null, stream);
32
+ }
33
+
34
+ /// <summary>One multipart file, in memory, so a retry or a redirect can send it again.</summary>
35
+ public sealed record FilePart(string FileName, byte[] Data, string ContentType = "application/octet-stream");
36
+
37
+ internal sealed class Part
38
+ {
39
+ private Part(string name, List<(FilePart? File, string? Text)> items)
40
+ {
41
+ Name = name;
42
+ Items = items;
43
+ }
44
+
45
+ public string Name { get; }
46
+
47
+ public List<(FilePart? File, string? Text)> Items { get; }
48
+
49
+ public static Part Text<T>(string name, T? value, JsonTypeInfo<T> info)
50
+ {
51
+ var items = new List<(FilePart?, string?)>();
52
+ if (value is not null)
53
+ {
54
+ var element = JsonSerializer.SerializeToElement(value, info);
55
+ var all = element.ValueKind == JsonValueKind.Array ? [.. element.EnumerateArray()] : new List<JsonElement> { element };
56
+ foreach (var item in all)
57
+ {
58
+ if (UrlQuery.Text(item) is { } text)
59
+ {
60
+ items.Add((null, text));
61
+ }
62
+ }
63
+ }
64
+ return new(name, items);
65
+ }
66
+
67
+ public static Part File(string name, FilePart? file) => new(name, file is null ? [] : [(file, null)]);
68
+
69
+ public static Part Files(string name, IReadOnlyList<FilePart>? files)
70
+ {
71
+ var items = new List<(FilePart?, string?)>();
72
+ foreach (var file in files ?? [])
73
+ {
74
+ items.Add((file, null));
75
+ }
76
+ return new(name, items);
77
+ }
78
+ }
79
+
80
+ internal sealed record Body(byte[]? Content, Stream? Stream, string MediaType)
81
+ {
82
+ public bool Replayable => Stream is null;
83
+
84
+ public static Body? Json<T>(T? value, JsonTypeInfo<T> info, string mediaType = "application/json") =>
85
+ value is null ? null : new(JsonSerializer.SerializeToUtf8Bytes(value, info), null, mediaType);
86
+
87
+ public static Body? Form<T>(T? value, JsonTypeInfo<T> info)
88
+ {
89
+ if (value is null)
90
+ {
91
+ return null;
92
+ }
93
+ var args = new List<Arg>();
94
+ var element = JsonSerializer.SerializeToElement(value, info);
95
+ if (element.ValueKind == JsonValueKind.Object)
96
+ {
97
+ foreach (var member in element.EnumerateObject())
98
+ {
99
+ args.Add(new Arg(member.Name, member.Value));
100
+ }
101
+ }
102
+ return new(Encoding.UTF8.GetBytes(UrlQuery.Encode([.. args])), null, "application/x-www-form-urlencoded");
103
+ }
104
+
105
+ public static Body? Text(string? value, string mediaType) =>
106
+ value is null ? null : new(Encoding.UTF8.GetBytes(value), null, mediaType);
107
+
108
+ public static Body? Binary(BinaryBody? value, string mediaType) =>
109
+ value is null ? null : new(value.Bytes, value.Stream, mediaType);
110
+
111
+ public static Body? Multipart(Part[]? parts)
112
+ {
113
+ if (parts is null)
114
+ {
115
+ return null;
116
+ }
117
+ var mark = $"honey-{Guid.NewGuid()}";
118
+ var body = new MemoryStream();
119
+ foreach (var part in parts)
120
+ {
121
+ foreach (var (file, text) in part.Items)
122
+ {
123
+ var head = $"--{mark}\r\nContent-Disposition: form-data; name=\"{Quoted(part.Name)}\"";
124
+ head += file is null ? "\r\n\r\n" : $"; filename=\"{Quoted(file.FileName)}\"\r\nContent-Type: {Quoted(file.ContentType)}\r\n\r\n";
125
+ body.Write(Encoding.UTF8.GetBytes(head));
126
+ body.Write(file is null ? Encoding.UTF8.GetBytes(text ?? "") : file.Data);
127
+ body.Write("\r\n"u8);
128
+ }
129
+ }
130
+ body.Write(Encoding.UTF8.GetBytes($"--{mark}--\r\n"));
131
+ return new(body.ToArray(), null, $"multipart/form-data; boundary={mark}");
132
+ }
133
+
134
+ private static string Quoted(string raw) => raw.Replace("\r", "%0D").Replace("\n", "%0A").Replace("\"", "%22");
135
+ }
@@ -0,0 +1,161 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ using System;
3
+ using System.Collections.Generic;
4
+ using System.Linq;
5
+ using System.Net.Http;
6
+ using System.Text;
7
+ using System.Threading;
8
+ using System.Threading.Tasks;
9
+
10
+ namespace Honey.Runtime;
11
+
12
+ /// <summary>
13
+ /// How a client connects and what it runs around each call: its base URL (the API's first server when unset), its
14
+ /// credential, the headers every call sends, a whole call's timeout, the redirects it follows, the largest answer it
15
+ /// reads, its hooks, its log and its stale tracking. <c>ToString</c> never shows a credential, a header value, the
16
+ /// base URL's user or query, or a delegate.
17
+ /// </summary>
18
+ public sealed record ClientConfig
19
+ {
20
+ /// <summary>The API's base URL, an absolute http(s) URL; the API's first server when unset.</summary>
21
+ public string? BaseUrl { get; init; }
22
+
23
+ /// <summary>A bearer token, sent in the API's auth header; it goes before <see cref="ApiKey"/>.</summary>
24
+ public string? BearerToken { get; init; }
25
+
26
+ /// <summary>An API key, sent in the API's auth header.</summary>
27
+ public string? ApiKey { get; init; }
28
+
29
+ /// <summary>The header the credential goes in: the API's own when unset, then with no prefix unless one is set.</summary>
30
+ public string? AuthHeaderName { get; init; }
31
+
32
+ /// <summary>The text before the credential: the API's own prefix when unset.</summary>
33
+ public string? AuthHeaderPrefix { get; init; }
34
+
35
+ /// <summary>Headers every call sends; a call's own headers and the credential go after them.</summary>
36
+ public IReadOnlyDictionary<string, string>? Headers { get; init; }
37
+
38
+ /// <summary>A whole call's bound, its retry, redirects, hooks and body read included: 30 seconds when unset, none when zero.</summary>
39
+ public TimeSpan? Timeout { get; init; }
40
+
41
+ /// <summary>
42
+ /// The handler the client sends through, never disposed by it; one of its own (gzip, deflate and brotli decoded,
43
+ /// no cookies) when unset. The client turns its <c>AllowAutoRedirect</c> off and puts a handler of its own above
44
+ /// it that strips a cross-origin hop to <c>Accept</c>, <c>Accept-Language</c> and <c>User-Agent</c>; it refuses
45
+ /// one whose <c>Credentials</c> are not a <c>CredentialCache</c> (they would answer any origin's challenge) and
46
+ /// one that has already sent. Its own decompression and cookies are its own; a handler of another type must not
47
+ /// follow redirects itself.
48
+ /// </summary>
49
+ public HttpMessageHandler? Handler { get; init; }
50
+
51
+ /// <summary>Which redirects a call follows: same-origin ones when unset.</summary>
52
+ public RedirectPolicy Redirect { get; init; }
53
+
54
+ /// <summary>The most bytes an answer's body may decode to: 100 MiB when unset, none when zero.</summary>
55
+ public long? MaxResponseBytes { get; init; }
56
+
57
+ /// <summary>Run in order before each attempt is sent, with the call's token; a hook may change the request.</summary>
58
+ public IReadOnlyList<Func<RequestContext, CancellationToken, Task>>? OnRequest { get; init; }
59
+
60
+ /// <summary>Run in order on each attempt's answer, with the call's token; a hook may change its headers and body.</summary>
61
+ public IReadOnlyList<Func<ResponseContext, CancellationToken, Task>>? OnResponse { get; init; }
62
+
63
+ /// <summary>Asked once per call for a new token after a 401, with the call's token; null or empty keeps the 401.</summary>
64
+ public Func<CancellationToken, Task<string?>>? OnAuthExpired { get; init; }
65
+
66
+ /// <summary>Told of each call's start, its answer and its error; what it throws is ignored.</summary>
67
+ public Action<LogEntry>? OnLog { get; init; }
68
+
69
+ /// <summary>The stale window marking what a mutation's <c>x-invalidate</c> targets; off when unset.</summary>
70
+ public InvalidationConfig? Invalidation { get; init; }
71
+
72
+ /// <summary>The state every hook of a call shares; a fresh dictionary per call when unset.</summary>
73
+ public IDictionary<string, object?>? State { get; init; }
74
+
75
+ private bool PrintMembers(StringBuilder builder)
76
+ {
77
+ builder.Append("BaseUrl = ").Append(Redacted(BaseUrl));
78
+ builder.Append(", BearerToken = ").Append(BearerToken is null ? "null" : "***");
79
+ builder.Append(", ApiKey = ").Append(ApiKey is null ? "null" : "***");
80
+ builder.Append(", AuthHeaderName = ").Append(AuthHeaderName);
81
+ builder.Append(", Headers = ").Append(Headers is null ? "null" : $"[{string.Join(", ", Headers.Keys)}]");
82
+ builder.Append(", Timeout = ").Append(Timeout);
83
+ builder.Append(", Redirect = ").Append(Redirect);
84
+ builder.Append(", MaxResponseBytes = ").Append(MaxResponseBytes);
85
+ (string Name, bool Set)[] hooks =
86
+ [("OnRequest", OnRequest is not null), ("OnResponse", OnResponse is not null), ("OnAuthExpired", OnAuthExpired is not null), ("OnLog", OnLog is not null)];
87
+ builder.Append(", Hooks = [").Append(string.Join(", ", hooks.Where(hook => hook.Set).Select(hook => hook.Name))).Append(']');
88
+ return true;
89
+ }
90
+
91
+ private static string? Redacted(string? url) =>
92
+ url is null ? null
93
+ : Uri.TryCreate(url, UriKind.Absolute, out var uri) ? $"{uri.Scheme}://{uri.Host}:{uri.Port}{uri.AbsolutePath}"
94
+ : "(not an absolute URL)";
95
+ }
96
+
97
+ /// <summary>Which redirects a call follows; a call never follows more than 10.</summary>
98
+ public enum RedirectPolicy
99
+ {
100
+ /// <summary>Same-origin redirects only: a cross-origin one is the answer.</summary>
101
+ SameOrigin,
102
+
103
+ /// <summary>Every redirect, a cross-origin hop stripped to Accept, Accept-Language and User-Agent, never with a body.</summary>
104
+ Follow,
105
+
106
+ /// <summary>None: every 3xx is the answer.</summary>
107
+ Manual,
108
+ }
109
+
110
+ /// <summary>How long a mutation's <c>x-invalidate</c> targets stay stale, and how many are kept.</summary>
111
+ public sealed record InvalidationConfig
112
+ {
113
+ /// <summary>How long a target stays stale after a mutation; zero is off.</summary>
114
+ public TimeSpan StaleTime { get; init; }
115
+
116
+ /// <summary>The most stale targets kept: past it, the least recently staled go until half remain.</summary>
117
+ public int StaleMaxEntries { get; init; } = 1000;
118
+
119
+ /// <summary>The most mutations recorded per stale target.</summary>
120
+ public int MaxSourcesPerTarget { get; init; } = 16;
121
+ }
122
+
123
+ /// <summary>One call's overrides: its timeout, the headers it adds, its base URL, and a raw response to fill.</summary>
124
+ public sealed record RequestOptions
125
+ {
126
+ /// <summary>This call's bound, in place of the client's; none when zero.</summary>
127
+ public TimeSpan? Timeout { get; init; }
128
+
129
+ /// <summary>Headers this call adds, after the client's and its own params, before the credential.</summary>
130
+ public IReadOnlyDictionary<string, string>? Headers { get; init; }
131
+
132
+ /// <summary>This call's base URL, an absolute http(s) URL, in place of the client's.</summary>
133
+ public string? BaseUrl { get; init; }
134
+
135
+ /// <summary>Filled with the response the call gets, an error status's included.</summary>
136
+ public RawResponse? Raw { get; init; }
137
+ }
138
+
139
+ /// <summary>The response a call got: its status, its headers by lower-case name, its body, and the URL that answered.</summary>
140
+ public sealed class RawResponse
141
+ {
142
+ /// <summary>The HTTP status.</summary>
143
+ public int Status { get; private set; }
144
+
145
+ /// <summary>Each header by lower-case name, repeated values joined with <c>", "</c>; a decoded answer has no Content-Encoding.</summary>
146
+ public IReadOnlyDictionary<string, string> Headers { get; private set; } = new Dictionary<string, string>();
147
+
148
+ /// <summary>The body as received, decoded.</summary>
149
+ public byte[] Body { get; private set; } = [];
150
+
151
+ /// <summary>The last hop's URL: the one that answered.</summary>
152
+ public Uri? Url { get; private set; }
153
+
154
+ internal void Fill(int status, IReadOnlyDictionary<string, string> headers, byte[] body, Uri url)
155
+ {
156
+ Status = status;
157
+ Headers = headers;
158
+ Body = body;
159
+ Url = url;
160
+ }
161
+ }