@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,144 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ using System;
3
+ using System.Collections.Generic;
4
+ using System.Text.Json;
5
+ using System.Text.Json.Serialization;
6
+ using System.Text.Json.Serialization.Metadata;
7
+
8
+ namespace Honey.Runtime;
9
+
10
+ /// <summary>An optional nullable member: unset (the default, never written), null, or a value.</summary>
11
+ public readonly struct Opt<T> : IEquatable<Opt<T>>
12
+ {
13
+ /// <summary>A set member: null or a value.</summary>
14
+ public Opt(T? value)
15
+ {
16
+ Value = value;
17
+ IsSet = true;
18
+ }
19
+
20
+ /// <summary>Whether the member is there, null included.</summary>
21
+ public bool IsSet { get; }
22
+
23
+ /// <summary>The value; default when unset or null.</summary>
24
+ public T? Value { get; }
25
+
26
+ /// <summary>A set member of <paramref name="value"/>, null included.</summary>
27
+ public static implicit operator Opt<T>(T? value) => new(value);
28
+
29
+ public bool Equals(Opt<T> other) => IsSet == other.IsSet && EqualityComparer<T?>.Default.Equals(Value, other.Value);
30
+
31
+ public override bool Equals(object? obj) => obj is Opt<T> other && Equals(other);
32
+
33
+ public override int GetHashCode() => HashCode.Combine(IsSet, Value);
34
+
35
+ public static bool operator ==(Opt<T> left, Opt<T> right) => left.Equals(right);
36
+
37
+ public static bool operator !=(Opt<T> left, Opt<T> right) => !left.Equals(right);
38
+ }
39
+
40
+ /// <summary>Reads a member that is there, null included, as set; an unset one is skipped on write.</summary>
41
+ public sealed class OptConverter<T> : JsonConverter<Opt<T>>
42
+ {
43
+ public override bool HandleNull => true;
44
+
45
+ public override Opt<T> Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) =>
46
+ reader.TokenType == JsonTokenType.Null
47
+ ? new Opt<T>(default)
48
+ : new Opt<T>(JsonSerializer.Deserialize(ref reader, (JsonTypeInfo<T>)options.GetTypeInfo(typeof(T))));
49
+
50
+ public override void Write(Utf8JsonWriter writer, Opt<T> value, JsonSerializerOptions options)
51
+ {
52
+ if (value.Value is { } set)
53
+ {
54
+ JsonSerializer.Serialize(writer, set, (JsonTypeInfo<T>)options.GetTypeInfo(typeof(T)));
55
+ }
56
+ else
57
+ {
58
+ writer.WriteNullValue();
59
+ }
60
+ }
61
+ }
62
+
63
+ /// <summary>A list whose items may not be null: a null item fails the read, as a null member does (Fb6).</summary>
64
+ public sealed class NonNullList<T> : JsonConverter<IReadOnlyList<T>>
65
+ where T : class
66
+ {
67
+ public override IReadOnlyList<T> Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
68
+ {
69
+ if (reader.TokenType != JsonTokenType.StartArray)
70
+ {
71
+ throw new JsonException("expected an array");
72
+ }
73
+ var info = (JsonTypeInfo<T>)options.GetTypeInfo(typeof(T));
74
+ var items = new List<T>();
75
+ while (reader.Read() && reader.TokenType != JsonTokenType.EndArray)
76
+ {
77
+ items.Add(JsonSerializer.Deserialize(ref reader, info) ?? throw new JsonException($"item {items.Count} is null"));
78
+ }
79
+ return items;
80
+ }
81
+
82
+ public override void Write(Utf8JsonWriter writer, IReadOnlyList<T> value, JsonSerializerOptions options)
83
+ {
84
+ var info = (JsonTypeInfo<T>)options.GetTypeInfo(typeof(T));
85
+ writer.WriteStartArray();
86
+ foreach (var item in value)
87
+ {
88
+ JsonSerializer.Serialize(writer, item, info);
89
+ }
90
+ writer.WriteEndArray();
91
+ }
92
+ }
93
+
94
+ /// <summary>A map whose values may not be null: a null value fails the read, as a null member does (Fb6).</summary>
95
+ public sealed class NonNullMap<T> : JsonConverter<IReadOnlyDictionary<string, T>>
96
+ where T : class
97
+ {
98
+ public override IReadOnlyDictionary<string, T> Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
99
+ {
100
+ if (reader.TokenType != JsonTokenType.StartObject)
101
+ {
102
+ throw new JsonException("expected an object");
103
+ }
104
+ var info = (JsonTypeInfo<T>)options.GetTypeInfo(typeof(T));
105
+ var members = new Dictionary<string, T>();
106
+ while (reader.Read() && reader.TokenType == JsonTokenType.PropertyName)
107
+ {
108
+ var key = reader.GetString() ?? "";
109
+ reader.Read();
110
+ members[key] = JsonSerializer.Deserialize(ref reader, info) ?? throw new JsonException($"member {key} is null");
111
+ }
112
+ return members;
113
+ }
114
+
115
+ public override void Write(Utf8JsonWriter writer, IReadOnlyDictionary<string, T> value, JsonSerializerOptions options)
116
+ {
117
+ var info = (JsonTypeInfo<T>)options.GetTypeInfo(typeof(T));
118
+ writer.WriteStartObject();
119
+ foreach (var (key, item) in value)
120
+ {
121
+ writer.WritePropertyName(key);
122
+ JsonSerializer.Serialize(writer, item, info);
123
+ }
124
+ writer.WriteEndObject();
125
+ }
126
+ }
127
+
128
+ /// <summary>An integer enum on the wire: a JSON integer, only a declared value.</summary>
129
+ public sealed class IntEnumConverter<T> : JsonConverter<T>
130
+ where T : struct, Enum
131
+ {
132
+ public override T Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
133
+ {
134
+ if (reader.TokenType != JsonTokenType.Number || !reader.TryGetInt64(out var number))
135
+ {
136
+ throw new JsonException($"a {typeof(T).Name} is an integer");
137
+ }
138
+ var value = (T)Enum.ToObject(typeof(T), number);
139
+ return Enum.IsDefined(value) ? value : throw new JsonException($"{number} is no {typeof(T).Name}");
140
+ }
141
+
142
+ public override void Write(Utf8JsonWriter writer, T value, JsonSerializerOptions options) =>
143
+ writer.WriteNumberValue(Convert.ToInt64(value, System.Globalization.CultureInfo.InvariantCulture));
144
+ }
@@ -0,0 +1,48 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ using System;
3
+ using System.Diagnostics;
4
+
5
+ namespace Honey.Runtime;
6
+
7
+ /// <summary>
8
+ /// One event of a call for <c>ClientConfig.OnLog</c>: <c>request_start</c> (debug), <c>response_received</c> (info
9
+ /// below 400, warn from 400) or <c>error</c> (error), the operation as <c>METHOD /template</c>, the milliseconds since
10
+ /// <c>request_start</c> (0 for it), the status and the error. No entry holds a URL, a header value or a query.
11
+ /// </summary>
12
+ public sealed record LogEntry(string Level, string Event, string Operation, long DurationMs, int? Status, string? Error);
13
+
14
+ internal sealed class CallLog(Action<LogEntry>? hook, string operation)
15
+ {
16
+ private long _start;
17
+
18
+ public void Start()
19
+ {
20
+ _start = Stopwatch.GetTimestamp();
21
+ Emit("debug", "request_start", 0, null, null);
22
+ }
23
+
24
+ public void Received(int status) => Emit(status >= 400 ? "warn" : "info", "response_received", Elapsed, status, null);
25
+
26
+ public void Failed(Exception error) =>
27
+ Emit("error", "error", Elapsed, (error as ApiStatusException)?.Status, $"{error.GetType().Name}: {error.Message}");
28
+
29
+ public void Canceled() => Emit("error", "error", Elapsed, null, "the call was canceled");
30
+
31
+ private long Elapsed => (long)Stopwatch.GetElapsedTime(_start).TotalMilliseconds;
32
+
33
+ private void Emit(string level, string name, long durationMs, int? status, string? error)
34
+ {
35
+ if (hook is null)
36
+ {
37
+ return;
38
+ }
39
+ try
40
+ {
41
+ hook(new LogEntry(level, name, operation, durationMs, status, error));
42
+ }
43
+ catch (Exception)
44
+ {
45
+ /* a logger's failure is not the call's */
46
+ }
47
+ }
48
+ }
@@ -0,0 +1,33 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ using System;
3
+ using System.Collections.Generic;
4
+ using System.Text.Json;
5
+ using System.Text.Json.Serialization.Metadata;
6
+
7
+ namespace Honey.Runtime;
8
+
9
+ internal sealed record Operation(string Method, string Path, string[] PathParams, bool Idempotent, string? Accept = null, string[]? Invalidates = null);
10
+
11
+ internal sealed record Defaults(string? BaseUrl, string AuthHeader, string AuthPrefix, JsonSerializerOptions Json);
12
+
13
+ internal readonly record struct Arg(string Name, JsonElement Value)
14
+ {
15
+ /* a string's metadata with no SDK context: plain options throw without a resolver, an empty combined one does not */
16
+ public static readonly JsonTypeInfo<string> StringInfo = JsonMetadataServices.CreateValueInfo<string>(
17
+ new JsonSerializerOptions { TypeInfoResolver = JsonTypeInfoResolver.Combine() }, JsonMetadataServices.StringConverter);
18
+
19
+ public static Arg Of<T>(string name, T? value, JsonTypeInfo<T> info) =>
20
+ value is null ? new(name, default) : new(name, JsonSerializer.SerializeToElement(value, info));
21
+
22
+ /* a stream's cursor value: null or empty sends nothing */
23
+ public static Arg Text(string name, string? value) => Of(name, string.IsNullOrEmpty(value) ? null : value, StringInfo);
24
+ }
25
+
26
+ internal readonly record struct Call(
27
+ string[] Path,
28
+ Arg[] Query,
29
+ Arg[] Headers,
30
+ Body? Body,
31
+ string? IdempotencyKey,
32
+ RequestOptions? Options,
33
+ Action<IReadOnlyDictionary<string, string>>? Read = null);
@@ -0,0 +1,65 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ using System;
3
+ using System.Text;
4
+
5
+ namespace Honey.Runtime;
6
+
7
+ internal static class UrlPath
8
+ {
9
+ public static string Expand(Operation op, string[] values)
10
+ {
11
+ var template = op.Path;
12
+ var path = new StringBuilder();
13
+ var from = 0;
14
+ for (var open = template.IndexOf('{'); open >= 0; open = template.IndexOf('{', from))
15
+ {
16
+ var close = template.IndexOf('}', open + 1);
17
+ if (close < 0)
18
+ {
19
+ break;
20
+ }
21
+ var name = template[(open + 1)..close];
22
+ if (name.Length == 0 || name.Contains('{'))
23
+ {
24
+ path.Append(template, from, open + 1 - from);
25
+ from = open + 1;
26
+ continue;
27
+ }
28
+ path.Append(template, from, open - from);
29
+ Encode(path, Value(op, name, values));
30
+ from = close + 1;
31
+ }
32
+ return path.Append(template, from, template.Length - from).ToString();
33
+ }
34
+
35
+ private static string Value(Operation op, string name, string[] values)
36
+ {
37
+ var at = Array.IndexOf(op.PathParams, name);
38
+ var value = at < 0 ? null : values[at];
39
+ return value is null or "" or "." or ".."
40
+ ? throw new PathParamException($"path param {name}: \"{value}\" is not a path segment")
41
+ : value;
42
+ }
43
+
44
+ public static string Encoded(string value)
45
+ {
46
+ var path = new StringBuilder();
47
+ Encode(path, value);
48
+ return path.ToString();
49
+ }
50
+
51
+ private static void Encode(StringBuilder path, string value)
52
+ {
53
+ foreach (var b in Encoding.UTF8.GetBytes(value))
54
+ {
55
+ if (char.IsAsciiLetterOrDigit((char)b) || "-_.!~*'()".Contains((char)b))
56
+ {
57
+ path.Append((char)b);
58
+ }
59
+ else
60
+ {
61
+ path.Append('%').Append(b.ToString("X2", System.Globalization.CultureInfo.InvariantCulture));
62
+ }
63
+ }
64
+ }
65
+ }
@@ -0,0 +1,72 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ using System.Collections.Generic;
3
+ using System.Text;
4
+ using System.Text.Json;
5
+
6
+ namespace Honey.Runtime;
7
+
8
+ internal static class UrlQuery
9
+ {
10
+ public static string Encode(Arg[] args)
11
+ {
12
+ var query = new StringBuilder();
13
+ foreach (var arg in args)
14
+ {
15
+ foreach (var text in Texts(arg.Value))
16
+ {
17
+ Form(query.Append(query.Length > 0 ? "&" : ""), arg.Name).Append('=');
18
+ Form(query, text);
19
+ }
20
+ }
21
+ return query.ToString();
22
+ }
23
+
24
+ public static string? Text(JsonElement value) =>
25
+ value.ValueKind switch
26
+ {
27
+ JsonValueKind.Undefined or JsonValueKind.Null => null,
28
+ JsonValueKind.String => value.GetString(),
29
+ JsonValueKind.Object when !value.EnumerateObject().MoveNext() => null,
30
+ _ => value.GetRawText(),
31
+ };
32
+
33
+ private static List<string> Texts(JsonElement value)
34
+ {
35
+ var texts = new List<string>();
36
+ if (value.ValueKind == JsonValueKind.Array)
37
+ {
38
+ foreach (var item in value.EnumerateArray())
39
+ {
40
+ if (Text(item) is { } text)
41
+ {
42
+ texts.Add(text);
43
+ }
44
+ }
45
+ }
46
+ else if (Text(value) is { } text)
47
+ {
48
+ texts.Add(text);
49
+ }
50
+ return texts;
51
+ }
52
+
53
+ private static StringBuilder Form(StringBuilder query, string text)
54
+ {
55
+ foreach (var b in Encoding.UTF8.GetBytes(text))
56
+ {
57
+ if (char.IsAsciiLetterOrDigit((char)b) || "*-._".Contains((char)b))
58
+ {
59
+ query.Append((char)b);
60
+ }
61
+ else if (b == ' ')
62
+ {
63
+ query.Append('+');
64
+ }
65
+ else
66
+ {
67
+ query.Append('%').Append(b.ToString("X2", System.Globalization.CultureInfo.InvariantCulture));
68
+ }
69
+ }
70
+ return query;
71
+ }
72
+ }
@@ -0,0 +1,118 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ using System;
3
+ using System.Collections.Generic;
4
+ using System.Text.Json;
5
+ using System.Text.Json.Serialization.Metadata;
6
+ using System.Threading;
7
+ using System.Threading.Tasks;
8
+
9
+ namespace Honey.Runtime;
10
+
11
+ /// <summary>Where a realtime connection stands.</summary>
12
+ public enum ConnectionState
13
+ {
14
+ /// <summary>A transport is open.</summary>
15
+ Connected,
16
+
17
+ /// <summary>The transport dropped; the next read reopens the chain.</summary>
18
+ Reconnecting,
19
+
20
+ /// <summary>Not open yet, closed, or given up.</summary>
21
+ Disconnected,
22
+ }
23
+
24
+ /// <summary>
25
+ /// A connection over a chain of transports, tried in order, read by <c>await foreach</c>: each message decoded as
26
+ /// <typeparamref name="T"/> (a message that does not decode throws once, the connection kept), the cursor in
27
+ /// <see cref="Options"/> advanced past it. After a drop it reopens the chain from the cursor, backing off from the
28
+ /// delay (an SSE <c>retry</c> first), doubling to 30 s, for up to <c>MaxReconnectAttempts</c> in a row; giving up
29
+ /// throws the last failure once, and the enumeration then ends. Leaving a loop keeps the connection; a canceled read
30
+ /// leaves it reconnecting. <see cref="CloseAsync"/> from any task ends a pending read with no message.
31
+ /// </summary>
32
+ public sealed class ResumableConnection<T> : IAsyncEnumerable<T>, IAsyncDisposable
33
+ {
34
+ private readonly JsonTypeInfo<T> _info;
35
+ private readonly RealtimeLoop _loop;
36
+
37
+ /// <summary>A connection to <paramref name="url"/> over <paramref name="adapters"/>, its messages read through <paramref name="info"/>; it opens at <see cref="ConnectAsync"/>.</summary>
38
+ public ResumableConnection(string url, IReadOnlyList<ITransportAdapter> adapters, JsonTypeInfo<T> info, TransportOptions? options = null)
39
+ {
40
+ Url = url;
41
+ Adapters = adapters;
42
+ Options = options ?? new TransportOptions();
43
+ _info = info;
44
+ _loop = new RealtimeLoop(adapters, Options, url);
45
+ }
46
+
47
+ /// <summary>The URL each adapter connects to.</summary>
48
+ public string Url { get; }
49
+
50
+ /// <summary>The transports, in the order they are tried.</summary>
51
+ public IReadOnlyList<ITransportAdapter> Adapters { get; }
52
+
53
+ /// <summary>The cursor, advanced past each message delivered, and the reconnect policy.</summary>
54
+ public TransportOptions Options { get; }
55
+
56
+ /// <summary>Where the connection stands.</summary>
57
+ public ConnectionState State => _loop.State;
58
+
59
+ /// <summary>The transport that last opened; null after a drop, until the next open.</summary>
60
+ public TransportKind? ProvenTransport => _loop.Proven;
61
+
62
+ /// <summary>Opens the first adapter in order that opens; the last failure when none does.</summary>
63
+ public Task ConnectAsync(CancellationToken cancellationToken = default) => _loop.ConnectAsync(cancellationToken);
64
+
65
+ /// <summary>The messages in order; its token, once fired, leaves the connection reconnecting.</summary>
66
+ public IAsyncEnumerator<T> GetAsyncEnumerator(CancellationToken cancellationToken = default) => MessagesAsync(cancellationToken);
67
+
68
+ /// <summary>Sends <paramref name="text"/> as it is over the open transport (an SSE or long-poll one POSTs it).</summary>
69
+ public Task SendAsync(string text, CancellationToken cancellationToken = default) => _loop.SendAsync(text, cancellationToken);
70
+
71
+ /// <summary>Sends <paramref name="value"/> as its JSON text.</summary>
72
+ public Task SendAsync<TValue>(TValue value, JsonTypeInfo<TValue> info, CancellationToken cancellationToken = default) =>
73
+ _loop.SendAsync(JsonSerializer.Serialize(value, info), cancellationToken);
74
+
75
+ /// <summary>Closes the open transport and ends a pending read in any task with no message.</summary>
76
+ public Task CloseAsync() => _loop.CloseAsync();
77
+
78
+ /// <summary>Closes the connection, as <see cref="CloseAsync"/> does.</summary>
79
+ public ValueTask DisposeAsync() => new(CloseAsync());
80
+
81
+ internal ResumableConnection<T> Bound(CancellationToken call)
82
+ {
83
+ _loop.Bind(call);
84
+ return this;
85
+ }
86
+
87
+ private async IAsyncEnumerator<T> MessagesAsync(CancellationToken token)
88
+ {
89
+ while (await _loop.NextAsync(token).ConfigureAwait(false) is { } message)
90
+ {
91
+ yield return Deliver(message);
92
+ }
93
+ }
94
+
95
+ /* the message as JSON, else as a JSON string of its text; the cursor advanced before it decodes */
96
+ private T Deliver(TransportMessage message)
97
+ {
98
+ JsonElement payload;
99
+ try
100
+ {
101
+ using var document = JsonDocument.Parse(message.Text);
102
+ payload = document.RootElement.Clone();
103
+ }
104
+ catch (JsonException)
105
+ {
106
+ payload = JsonSerializer.SerializeToElement(message.Text, Arg.StringInfo);
107
+ }
108
+ Options.Advance(message.Id, payload);
109
+ try
110
+ {
111
+ return JsonSerializer.Deserialize(payload, _info) ?? throw new DecodeException("a message does not decode: it is null");
112
+ }
113
+ catch (JsonException e)
114
+ {
115
+ throw new DecodeException($"a message does not decode: {e.Message}", e);
116
+ }
117
+ }
118
+ }