@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,236 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ using System;
3
+ using System.Collections.Generic;
4
+ using System.IO;
5
+ using System.Net.Http;
6
+ using System.Net.Sockets;
7
+ using System.Net.WebSockets;
8
+ using System.Threading;
9
+ using System.Threading.Tasks;
10
+
11
+ namespace Honey.Runtime;
12
+
13
+ /* ResumableConnection<T>'s loop (Python's realtime.py), its behavior documented there */
14
+ internal sealed class RealtimeLoop(IReadOnlyList<ITransportAdapter> adapters, TransportOptions options, string url)
15
+ {
16
+ public static readonly TimeSpan OpenLimit = TimeSpan.FromSeconds(30);
17
+
18
+ private readonly CancellationTokenSource _closing = new();
19
+ private CancellationTokenRegistration _registration;
20
+ private ITransportConnection? _conn;
21
+ private ITransportAdapter? _proven;
22
+ private Exception _failure = new ApiConnectionException("the connection ended");
23
+ private OperationCanceledException? _canceled;
24
+ private TimeSpan? _retry;
25
+ private int _attempts;
26
+ /* this open's best refusal; whether nothing is read yet; whether a 401 may still refresh */
27
+ private bool _refused;
28
+ private Exception? _best;
29
+ private bool _fresh;
30
+ private bool _armed;
31
+
32
+ public ConnectionState State { get; private set; } = ConnectionState.Disconnected;
33
+
34
+ public TransportKind? Proven => _proven?.Kind;
35
+
36
+ public void Bind(CancellationToken call) =>
37
+ _registration = call.Register(static (loop, token) => ((RealtimeLoop)loop!).Cancel(token), this);
38
+
39
+ public Task ConnectAsync(CancellationToken token)
40
+ {
41
+ _armed = true;
42
+ return OpenAsync(token);
43
+ }
44
+
45
+ /* the chain in order; refused only when every adapter refused, else its last transient failure */
46
+ private async Task OpenAsync(CancellationToken token)
47
+ {
48
+ var (refused, best, transient) = (adapters.Count > 0, (Exception?)null, (Exception?)null);
49
+ foreach (var adapter in adapters)
50
+ {
51
+ ITransportConnection conn;
52
+ try
53
+ {
54
+ conn = await adapter.ConnectAsync(url, options, token).ConfigureAwait(false);
55
+ }
56
+ catch (Exception e) when (Fails(e))
57
+ {
58
+ if (await RefreshedAsync(adapter, e, token).ConfigureAwait(false))
59
+ {
60
+ await OpenAsync(token).ConfigureAwait(false);
61
+ return;
62
+ }
63
+ if (Rank(e) == 0)
64
+ {
65
+ (refused, transient) = (false, e);
66
+ }
67
+ else if (Rank(e) > Rank(best))
68
+ {
69
+ best = e;
70
+ }
71
+ continue;
72
+ }
73
+ if (_closing.IsCancellationRequested)
74
+ {
75
+ await Quietly(conn).ConfigureAwait(false);
76
+ _closing.Token.ThrowIfCancellationRequested();
77
+ }
78
+ (_conn, _proven, State, _refused, _best, _fresh) = (conn, adapter, ConnectionState.Connected, refused, best, true);
79
+ return;
80
+ }
81
+ (_refused, _failure) = (refused, transient ?? best ?? _failure);
82
+ throw _failure;
83
+ }
84
+
85
+ public async Task<TransportMessage?> NextAsync(CancellationToken token)
86
+ {
87
+ using var read = CancellationTokenSource.CreateLinkedTokenSource(token, _closing.Token);
88
+ try
89
+ {
90
+ while (State != ConnectionState.Disconnected)
91
+ {
92
+ if (_conn is not { } conn)
93
+ {
94
+ await ReconnectAsync(read.Token).ConfigureAwait(false);
95
+ continue;
96
+ }
97
+ TransportMessage? message;
98
+ Exception failure = new ApiConnectionException("the connection ended");
99
+ try
100
+ {
101
+ message = await conn.ReceiveAsync(read.Token).ConfigureAwait(false);
102
+ }
103
+ catch (Exception e) when (Fails(e))
104
+ {
105
+ (message, failure) = (null, e);
106
+ }
107
+ if (message is not null)
108
+ {
109
+ (_attempts, _retry, _fresh) = (0, message.Retry ?? _retry, false);
110
+ return message;
111
+ }
112
+ var opened = _proven!;
113
+ await DropAsync(conn, failure).ConfigureAwait(false);
114
+ if (_fresh && _refused && Rank(failure) > 0)
115
+ {
116
+ /* a lazy long-poll's refused first read: the open's refusal */
117
+ if (await RefreshedAsync(opened, failure, read.Token).ConfigureAwait(false))
118
+ {
119
+ await OpenAsync(read.Token).ConfigureAwait(false);
120
+ continue;
121
+ }
122
+ State = ConnectionState.Disconnected;
123
+ throw Rank(failure) > Rank(_best) ? failure : _best!;
124
+ }
125
+ }
126
+ return Ended();
127
+ }
128
+ catch (OperationCanceledException) when (_closing.IsCancellationRequested)
129
+ {
130
+ return Ended();
131
+ }
132
+ catch (OperationCanceledException) when (token.IsCancellationRequested)
133
+ {
134
+ if (_conn is { } open)
135
+ {
136
+ await DropAsync(open, _failure).ConfigureAwait(false);
137
+ }
138
+ throw;
139
+ }
140
+ }
141
+
142
+ public Task SendAsync(string text, CancellationToken token) =>
143
+ (_conn ?? throw new ApiConnectionException("the connection is not open")).SendAsync(text, token);
144
+
145
+ public async Task CloseAsync()
146
+ {
147
+ State = ConnectionState.Disconnected;
148
+ _registration.Unregister();
149
+ _closing.Cancel();
150
+ if (Interlocked.Exchange(ref _conn, null) is { } conn)
151
+ {
152
+ await Quietly(conn).ConfigureAwait(false);
153
+ }
154
+ }
155
+
156
+ private void Cancel(CancellationToken token)
157
+ {
158
+ _canceled = new OperationCanceledException("the connection was canceled", token);
159
+ _ = CloseAsync();
160
+ }
161
+
162
+ /* the method's cancel, thrown once by the read that ends on it; null for any other end */
163
+ private TransportMessage? Ended() => Interlocked.Exchange(ref _canceled, null) is { } canceled ? throw canceled : null;
164
+
165
+ private async Task ReconnectAsync(CancellationToken token)
166
+ {
167
+ while (_attempts < options.MaxReconnectAttempts)
168
+ {
169
+ var full = TimeSpan.FromTicks((long)Math.Min((_retry ?? options.ReconnectDelay).Ticks * Math.Pow(2, _attempts), OpenLimit.Ticks));
170
+ await Task.Delay(full / 2 + full / 2 * Random.Shared.NextDouble(), token).ConfigureAwait(false);
171
+ _attempts++;
172
+ using var open = CancellationTokenSource.CreateLinkedTokenSource(token);
173
+ open.CancelAfter(OpenLimit);
174
+ try
175
+ {
176
+ await ConnectAsync(open.Token).ConfigureAwait(false);
177
+ return;
178
+ }
179
+ catch (Exception e) when (Fails(e))
180
+ {
181
+ /* ConnectAsync kept the last adapter's failure */
182
+ if (_refused)
183
+ {
184
+ break;
185
+ }
186
+ }
187
+ catch (OperationCanceledException e) when (!token.IsCancellationRequested)
188
+ {
189
+ _failure = new ApiTimeoutException("no transport opened within 30 s", e);
190
+ }
191
+ }
192
+ State = ConnectionState.Disconnected;
193
+ throw _failure;
194
+ }
195
+
196
+ private async Task DropAsync(ITransportConnection conn, Exception failure)
197
+ {
198
+ if (_closing.IsCancellationRequested)
199
+ {
200
+ return;
201
+ }
202
+ (_conn, _proven, _failure, State) = (null, null, failure, ConnectionState.Reconnecting);
203
+ await Quietly(conn).ConfigureAwait(false);
204
+ }
205
+
206
+ private static async Task Quietly(ITransportConnection conn)
207
+ {
208
+ try
209
+ {
210
+ await conn.DisposeAsync().ConfigureAwait(false);
211
+ }
212
+ catch (Exception)
213
+ {
214
+ /* a dead transport's close is not the connection's failure */
215
+ }
216
+ }
217
+
218
+ /* a deterministic refusal's rank, the most specific highest; 0 for a transient failure */
219
+ private static int Rank(Exception? e) =>
220
+ (e as ApiStatusException)?.Status switch { 401 => 6, 403 => 5, 422 => 4, 400 => 3, 410 => 2, 404 or 405 => 1, _ => 0 };
221
+
222
+ /* a 401's one refresh per open: whether the chain restarts */
223
+ private async Task<bool> RefreshedAsync(ITransportAdapter adapter, Exception e, CancellationToken token)
224
+ {
225
+ if (!_armed || Rank(e) != 6 || adapter is not IDialed dialed)
226
+ {
227
+ return false;
228
+ }
229
+ _armed = false;
230
+ return await dialed.Dial.RefreshAsync(token).ConfigureAwait(false);
231
+ }
232
+
233
+ /* what an adapter's open or read throws when that transport failed; anything else is the caller's */
234
+ private static bool Fails(Exception e) =>
235
+ e is HoneyException or IOException or HttpRequestException or SocketException or WebSocketException;
236
+ }
@@ -0,0 +1,53 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ using System;
3
+ using System.Collections.Generic;
4
+ using System.IO;
5
+ using System.Linq;
6
+ using System.Net.Http;
7
+
8
+ namespace Honey.Runtime;
9
+
10
+ internal sealed record Hop(string Method, Uri Url, IReadOnlyDictionary<string, string> Headers, byte[]? Content, Stream? Stream, bool Cross);
11
+
12
+ internal static class Redirects
13
+ {
14
+ public const int Max = 10;
15
+
16
+ private static readonly string[] Safe = ["Accept", "Accept-Language", "User-Agent"];
17
+
18
+ public static Hop? Next(Hop hop, HttpResponseMessage answer, Uri start, RedirectPolicy policy)
19
+ {
20
+ var status = (int)answer.StatusCode;
21
+ var location = answer.Headers.NonValidated.TryGetValues("Location", out var values) ? values.ToString() : null;
22
+ if (policy == RedirectPolicy.Manual || status is not (301 or 302 or 303 or 307 or 308) || string.IsNullOrEmpty(location)
23
+ || !Uri.TryCreate(hop.Url, location, out var target) || target.Scheme is not ("http" or "https"))
24
+ {
25
+ return null;
26
+ }
27
+ var leaves = !SameOrigin(target, start);
28
+ if (leaves && policy != RedirectPolicy.Follow)
29
+ {
30
+ return null;
31
+ }
32
+ var toGet = status == 303 ? hop.Method != "HEAD" : status < 303 && hop.Method == "POST";
33
+ if (!toGet && (hop.Stream is not null || (hop.Content is not null && leaves)))
34
+ {
35
+ return null;
36
+ }
37
+ var cross = hop.Cross || leaves;
38
+ var headers = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
39
+ foreach (var (name, value) in hop.Headers)
40
+ {
41
+ var kept = !(toGet && name.Equals("Content-Type", StringComparison.OrdinalIgnoreCase))
42
+ && (!cross || Safe.Contains(name, StringComparer.OrdinalIgnoreCase));
43
+ if (kept)
44
+ {
45
+ headers[name] = value;
46
+ }
47
+ }
48
+ return new Hop(toGet ? "GET" : hop.Method, target, headers, toGet ? null : hop.Content, null, cross);
49
+ }
50
+
51
+ public static bool SameOrigin(Uri a, Uri b) =>
52
+ a.Scheme == b.Scheme && string.Equals(a.Host, b.Host, StringComparison.OrdinalIgnoreCase) && a.Port == b.Port;
53
+ }
@@ -0,0 +1,57 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ using System;
3
+ using System.Diagnostics.CodeAnalysis;
4
+
5
+ namespace Honey.Runtime;
6
+
7
+ /// <summary>
8
+ /// A <c>client.Safe</c> call's answer: Ok, or Err holding the <see cref="SdkException"/> the client's method throws
9
+ /// for it, with the response either way; no answer still throws. A no-body operation's; the rest answer <see cref="Result{T}"/>.
10
+ /// </summary>
11
+ public class Result
12
+ {
13
+ private readonly SdkException? _error;
14
+
15
+ internal Result(SdkException? error, RawResponse response)
16
+ {
17
+ _error = error;
18
+ Response = response;
19
+ }
20
+
21
+ /// <summary>Whether the call got a 2xx it read.</summary>
22
+ public bool IsOk => _error is null;
23
+
24
+ /// <summary>The answer's error; read on an Ok, an InvalidOperationException.</summary>
25
+ public SdkException Error => _error ?? throw new InvalidOperationException($"Error read on an Ok result: HTTP {Response.Status}");
26
+
27
+ /// <summary>The response the call got, on either arm.</summary>
28
+ public RawResponse Response { get; }
29
+
30
+ /// <summary><paramref name="onOk"/>'s value on an Ok, else <paramref name="onErr"/>'s of its error.</summary>
31
+ public TOut Match<TOut>(Func<TOut> onOk, Func<SdkException, TOut> onErr) => _error is null ? onOk() : onErr(_error);
32
+ }
33
+
34
+ /// <summary>A <c>client.Safe</c> call's answer with a body: its <see cref="Value"/> on an Ok.</summary>
35
+ public sealed class Result<T> : Result
36
+ {
37
+ private readonly T _value;
38
+
39
+ internal Result(T value, SdkException? error, RawResponse response)
40
+ : base(error, response)
41
+ {
42
+ _value = value;
43
+ }
44
+
45
+ /// <summary>The decoded answer; read on an Err, an InvalidOperationException naming its error.</summary>
46
+ public T Value => IsOk ? _value : throw new InvalidOperationException($"Value read on an Err result: {Error.Message}");
47
+
48
+ /// <summary>Whether this is an Ok, its answer in <paramref name="value"/>.</summary>
49
+ public bool TryGetValue([MaybeNullWhen(false)] out T value)
50
+ {
51
+ value = _value;
52
+ return IsOk;
53
+ }
54
+
55
+ /// <summary><paramref name="onOk"/>'s value of the answer on an Ok, else <paramref name="onErr"/>'s of its error.</summary>
56
+ public TOut Match<TOut>(Func<T, TOut> onOk, Func<SdkException, TOut> onErr) => IsOk ? onOk(_value) : onErr(Error);
57
+ }
@@ -0,0 +1,122 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ using System;
3
+ using System.Collections.Generic;
4
+ using System.Globalization;
5
+ using System.IO;
6
+ using System.Text;
7
+
8
+ namespace Honey.Runtime;
9
+
10
+ internal readonly record struct RawEvent(string Data, string? Event, string? Id, TimeSpan? Retry);
11
+
12
+ internal sealed class SseParser
13
+ {
14
+ private const int MaxLine = 1 << 20;
15
+ private const int MaxEvent = 8 << 20;
16
+
17
+ private readonly MemoryStream _line = new();
18
+ private readonly MemoryStream _data = new();
19
+ private bool _cr;
20
+ private bool _started;
21
+ private bool _hasData;
22
+ private string? _event;
23
+ private string? _id;
24
+ private TimeSpan? _retry;
25
+
26
+ public void Feed(ReadOnlySpan<byte> chunk, List<RawEvent> into)
27
+ {
28
+ if (_cr && chunk.Length > 0 && chunk[0] == (byte)'\n')
29
+ {
30
+ chunk = chunk[1..];
31
+ }
32
+ _cr = chunk.Length > 0 && chunk[^1] == (byte)'\r';
33
+ int end;
34
+ while ((end = chunk.IndexOfAny((byte)'\r', (byte)'\n')) >= 0)
35
+ {
36
+ if (_line.Length > 0)
37
+ {
38
+ _line.Write(chunk[..end]);
39
+ Line(_line.GetBuffer().AsSpan(0, (int)_line.Length), into);
40
+ _line.SetLength(0);
41
+ }
42
+ else
43
+ {
44
+ Line(chunk[..end], into);
45
+ }
46
+ var crlf = chunk[end] == (byte)'\r' && end + 1 < chunk.Length && chunk[end + 1] == (byte)'\n';
47
+ chunk = chunk[(end + (crlf ? 2 : 1))..];
48
+ }
49
+ _line.Write(chunk);
50
+ if (_line.Length > MaxLine)
51
+ {
52
+ throw LineCap();
53
+ }
54
+ }
55
+
56
+ private void Line(ReadOnlySpan<byte> line, List<RawEvent> into)
57
+ {
58
+ if (line.Length > MaxLine)
59
+ {
60
+ throw LineCap();
61
+ }
62
+ if (!_started)
63
+ {
64
+ _started = true;
65
+ if (line.StartsWith(""u8))
66
+ {
67
+ line = line[3..];
68
+ }
69
+ }
70
+ if (line.IsEmpty)
71
+ {
72
+ Dispatch(into);
73
+ return;
74
+ }
75
+ var colon = line.IndexOf((byte)':');
76
+ var name = colon < 0 ? line : line[..colon];
77
+ var value = colon < 0 ? [] : line[(colon + 1)..];
78
+ if (value.Length > 0 && value[0] == (byte)' ')
79
+ {
80
+ value = value[1..];
81
+ }
82
+ if (name.SequenceEqual("data"u8))
83
+ {
84
+ if (_data.Length + value.Length + (_hasData ? 1 : 0) > MaxEvent)
85
+ {
86
+ throw new DecodeException("an event's data exceeds 8 MiB");
87
+ }
88
+ if (_hasData)
89
+ {
90
+ _data.WriteByte((byte)'\n');
91
+ }
92
+ _data.Write(value);
93
+ _hasData = true;
94
+ }
95
+ else if (name.SequenceEqual("event"u8))
96
+ {
97
+ _event = Encoding.UTF8.GetString(value);
98
+ }
99
+ else if (name.SequenceEqual("id"u8) && !value.Contains((byte)0))
100
+ {
101
+ _id = value.IsEmpty ? null : Encoding.UTF8.GetString(value);
102
+ }
103
+ else if (name.SequenceEqual("retry"u8) && !value.IsEmpty && !value.ContainsAnyExceptInRange((byte)'0', (byte)'9'))
104
+ {
105
+ _retry = long.TryParse(value, NumberStyles.None, CultureInfo.InvariantCulture, out var ms) && ms <= TimeSpan.MaxValue.Ticks / TimeSpan.TicksPerMillisecond
106
+ ? TimeSpan.FromTicks(ms * TimeSpan.TicksPerMillisecond)
107
+ : null;
108
+ }
109
+ }
110
+
111
+ private void Dispatch(List<RawEvent> into)
112
+ {
113
+ if (_hasData)
114
+ {
115
+ into.Add(new RawEvent(Encoding.UTF8.GetString(_data.GetBuffer(), 0, (int)_data.Length), _event, _id, _retry));
116
+ }
117
+ _data.SetLength(0);
118
+ (_hasData, _event, _retry) = (false, null, null);
119
+ }
120
+
121
+ private static DecodeException LineCap() => new("an event-stream line exceeds 1 MiB");
122
+ }
@@ -0,0 +1,151 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ using System;
3
+ using System.Collections.Generic;
4
+ using System.Diagnostics;
5
+ using System.Linq;
6
+
7
+ namespace Honey.Runtime;
8
+
9
+ internal sealed record StaleMeta(string Selector, bool IsStale, IReadOnlyList<string> InvalidatedBy, long Seq)
10
+ {
11
+ public static readonly StaleMeta None = new("", false, [], 0);
12
+ }
13
+
14
+ internal sealed class StaleTracker
15
+ {
16
+ private readonly long _window;
17
+ private readonly int _maxEntries;
18
+ private readonly int _maxSources;
19
+ private readonly Dictionary<string, Entry> _entries = new(StringComparer.Ordinal);
20
+ private readonly LinkedList<string> _order = new();
21
+ private readonly HashSet<string> _patterns = new(StringComparer.Ordinal);
22
+ private readonly object _lock = new();
23
+ private long _seq;
24
+
25
+ public StaleTracker(InvalidationConfig? config)
26
+ {
27
+ _window = config is null ? 0 : (long)(config.StaleTime.TotalSeconds * Stopwatch.Frequency);
28
+ _maxEntries = Math.Max(config?.StaleMaxEntries ?? 1, 1);
29
+ _maxSources = Math.Max(config?.MaxSourcesPerTarget ?? 1, 1);
30
+ }
31
+
32
+ public StaleMeta Begin(string method, string path)
33
+ {
34
+ if (_window <= 0)
35
+ {
36
+ return StaleMeta.None;
37
+ }
38
+ var selector = $"{method} {path}";
39
+ lock (_lock)
40
+ {
41
+ Expire();
42
+ var by = new List<string>();
43
+ foreach (var key in ReadBy(selector))
44
+ {
45
+ by.AddRange(_entries[key].By.Where(source => !by.Contains(source)));
46
+ }
47
+ return new StaleMeta(selector, by.Count > 0, by, _seq);
48
+ }
49
+ }
50
+
51
+ public void Settle(StaleMeta meta, string[] targets, IReadOnlyDictionary<string, string> values)
52
+ {
53
+ if (_window <= 0)
54
+ {
55
+ return;
56
+ }
57
+ lock (_lock)
58
+ {
59
+ if (targets.Length > 0)
60
+ {
61
+ Mark(meta, targets, values);
62
+ }
63
+ foreach (var key in meta.IsStale ? ReadBy(meta.Selector) : [])
64
+ {
65
+ if (_entries[key].Seq <= meta.Seq)
66
+ {
67
+ Drop(key);
68
+ }
69
+ }
70
+ }
71
+ }
72
+
73
+ private void Mark(StaleMeta meta, string[] targets, IReadOnlyDictionary<string, string> values)
74
+ {
75
+ _seq++;
76
+ var until = Stopwatch.GetTimestamp() + _window;
77
+ foreach (var key in Invalidation.Resolve(targets, values))
78
+ {
79
+ if (_entries.Remove(key, out var entry))
80
+ {
81
+ _order.Remove(entry.Node);
82
+ }
83
+ entry ??= new Entry(new LinkedListNode<string>(key));
84
+ entry.Seq = _seq;
85
+ entry.Until = until;
86
+ if (!entry.By.Contains(meta.Selector) && entry.By.Count < _maxSources)
87
+ {
88
+ entry.By.Add(meta.Selector);
89
+ }
90
+ _entries[key] = entry;
91
+ _order.AddLast(entry.Node);
92
+ if (Invalidation.HasPlaceholders(key[(key.IndexOf(' ') + 1)..]))
93
+ {
94
+ _patterns.Add(key);
95
+ }
96
+ }
97
+ if (_entries.Count > _maxEntries)
98
+ {
99
+ Expire();
100
+ while (_entries.Count > Math.Max(_maxEntries / 2, 1) && _order.First is { } oldest)
101
+ {
102
+ Drop(oldest.Value);
103
+ }
104
+ }
105
+ }
106
+
107
+ private List<string> ReadBy(string selector)
108
+ {
109
+ var space = selector.IndexOf(' ');
110
+ var method = selector[..space];
111
+ var path = selector[(space + 1)..];
112
+ var keys = _patterns
113
+ .Where(key => key.StartsWith(method + " ", StringComparison.Ordinal) && Invalidation.Matches(path, key[(method.Length + 1)..]))
114
+ .ToList();
115
+ if (_entries.ContainsKey(selector) && !keys.Contains(selector))
116
+ {
117
+ keys.Add(selector);
118
+ }
119
+ keys.Sort(StringComparer.Ordinal);
120
+ return keys;
121
+ }
122
+
123
+ private void Expire()
124
+ {
125
+ var now = Stopwatch.GetTimestamp();
126
+ while (_order.First is { } oldest && _entries[oldest.Value].Until <= now)
127
+ {
128
+ Drop(oldest.Value);
129
+ }
130
+ }
131
+
132
+ private void Drop(string key)
133
+ {
134
+ if (_entries.Remove(key, out var entry))
135
+ {
136
+ _order.Remove(entry.Node);
137
+ }
138
+ _patterns.Remove(key);
139
+ }
140
+
141
+ private sealed class Entry(LinkedListNode<string> node)
142
+ {
143
+ public LinkedListNode<string> Node { get; } = node;
144
+
145
+ public long Seq { get; set; }
146
+
147
+ public long Until { get; set; }
148
+
149
+ public List<string> By { get; } = [];
150
+ }
151
+ }