@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,178 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ //! One call's request as a method fills it: its route, query, headers and body, copied in up
3
+ //! front so the `Call` holding it borrows nothing; a value that cannot be sent fails the call when
4
+ //! it is awaited.
5
+
6
+ use bytes::Bytes;
7
+
8
+ use crate::auth::new_v4;
9
+ use crate::body::{Body, Content};
10
+ use crate::errors::Error;
11
+ use crate::path::expand_path;
12
+ use crate::query::{form_encode, object_pairs, texts, to_value};
13
+
14
+ /// One call's request: owned, so the `Call` holding it borrows nothing.
15
+ pub(crate) struct RequestSpec {
16
+ pub(crate) method: reqwest::Method,
17
+ pub(crate) template: &'static str,
18
+ pub(crate) path: String,
19
+ pub(crate) params: Vec<(&'static str, String)>,
20
+ pub(crate) query: Vec<(String, String)>,
21
+ pub(crate) headers: Vec<(String, String)>,
22
+ pub(crate) body: Option<Body>,
23
+ pub(crate) content_type: Option<String>,
24
+ pub(crate) invalidates: &'static [&'static str],
25
+ /// what made the request unsendable (a path param, a body that would not encode)
26
+ pub(crate) failed: Option<Error>,
27
+ }
28
+
29
+ /// A resume cursor as it is sent: an empty one names no position, so it is none (WHATWG).
30
+ #[allow(dead_code)] // a stream operation's resume cursor
31
+ pub(crate) fn cursor(value: &Option<String>) -> Option<&str> {
32
+ value.as_deref().filter(|v| !v.is_empty())
33
+ }
34
+
35
+ /* an SDK calls the builders its operations need */
36
+ #[allow(dead_code)]
37
+ impl RequestSpec {
38
+ /// `method template`, its placeholders filled from `params`.
39
+ pub(crate) fn new(
40
+ method: &'static str,
41
+ template: &'static str,
42
+ params: &[(&'static str, &str)],
43
+ ) -> Self {
44
+ let (path, failed) = match expand_path(template, params) {
45
+ Ok(path) => (path, None),
46
+ Err(e) => (String::new(), Some(e)),
47
+ };
48
+ RequestSpec {
49
+ method: reqwest::Method::from_bytes(method.as_bytes()).unwrap_or_default(),
50
+ template,
51
+ path,
52
+ params: params.iter().map(|(k, v)| (*k, (*v).to_owned())).collect(),
53
+ query: Vec::new(),
54
+ headers: Vec::new(),
55
+ body: None,
56
+ content_type: None,
57
+ invalidates: &[],
58
+ failed,
59
+ }
60
+ }
61
+
62
+ fn fail(&mut self, e: Error) {
63
+ self.failed.get_or_insert(e);
64
+ }
65
+
66
+ /// The query param `name`: each list item repeats it, `None` sends none.
67
+ pub(crate) fn query<T: serde::Serialize + ?Sized>(&mut self, name: &str, value: &T) {
68
+ match to_value(value) {
69
+ Ok(v) => self
70
+ .query
71
+ .extend(texts(&v).into_iter().map(|t| (name.to_owned(), t))),
72
+ Err(e) => self.fail(Error::Config(format!("query param {name:?}: {e}"))),
73
+ }
74
+ }
75
+
76
+ /// The header param `name`: a list joined with `,`, `None` sends none.
77
+ pub(crate) fn header<T: serde::Serialize + ?Sized>(&mut self, name: &str, value: &T) {
78
+ match to_value(value) {
79
+ Ok(v) => {
80
+ let all = texts(&v);
81
+ if !all.is_empty() {
82
+ self.headers.push((name.to_owned(), all.join(",")));
83
+ }
84
+ }
85
+ Err(e) => self.fail(Error::Config(format!("header param {name:?}: {e}"))),
86
+ }
87
+ }
88
+
89
+ fn has_header(&self, name: &str) -> bool {
90
+ self.headers
91
+ .iter()
92
+ .any(|(k, _)| k.eq_ignore_ascii_case(name))
93
+ }
94
+
95
+ /// The `Idempotency-Key`: a declared header already set wins, then `key`, then a fresh v4 id,
96
+ /// the same on an auth retry.
97
+ pub(crate) fn idempotency_key(&mut self, key: &Option<String>) {
98
+ if !self.has_header("Idempotency-Key") {
99
+ let key = key.clone().unwrap_or_else(new_v4);
100
+ self.headers.push(("Idempotency-Key".into(), key));
101
+ }
102
+ }
103
+
104
+ /// The media type the answer is asked for, unless a declared header names one.
105
+ pub(crate) fn accept(&mut self, media: &str) {
106
+ if !self.has_header("Accept") {
107
+ self.headers.push(("Accept".into(), media.to_owned()));
108
+ }
109
+ }
110
+
111
+ /// The `METHOD /path` targets a 2xx answer stales.
112
+ pub(crate) fn invalidates(&mut self, targets: &'static [&'static str]) {
113
+ self.invalidates = targets;
114
+ }
115
+
116
+ fn bytes(&mut self, body: impl Into<Bytes>, content_type: impl Into<String>) {
117
+ self.body = Some(Body::from(body.into()));
118
+ self.content_type = Some(content_type.into());
119
+ }
120
+
121
+ /// A JSON body, encoded now: the call keeps the bytes, not the value.
122
+ pub(crate) fn json<T: serde::Serialize + ?Sized>(&mut self, body: &T, content_type: &str) {
123
+ match serde_json::to_vec(body) {
124
+ Ok(b) => self.bytes(b, content_type),
125
+ Err(e) => self.fail(Error::Config(format!("body: {e}"))),
126
+ }
127
+ }
128
+
129
+ /// A form body: each field of the object, a list repeating its key.
130
+ pub(crate) fn form<T: serde::Serialize + ?Sized>(&mut self, body: &T, content_type: &str) {
131
+ match to_value(body) {
132
+ Ok(v) => self.bytes(form_encode(&object_pairs(&v)), content_type),
133
+ Err(e) => self.fail(Error::Config(format!("body: {e}"))),
134
+ }
135
+ }
136
+
137
+ /// A `multipart/form-data` body, its parts added by the method.
138
+ pub(crate) fn multipart(&mut self, form: crate::body::Multipart) {
139
+ if let Some(e) = &form.failed {
140
+ return self.fail(Error::Config(format!("body: {e}")));
141
+ }
142
+ let (bytes, media) = form.finish();
143
+ self.bytes(bytes, media);
144
+ }
145
+
146
+ /// A text body.
147
+ pub(crate) fn text(&mut self, body: &str, content_type: &str) {
148
+ self.bytes(body.to_owned(), content_type);
149
+ }
150
+
151
+ /// A binary body: bytes, or a stream sent as it is read.
152
+ pub(crate) fn binary(&mut self, body: Body, content_type: &str) {
153
+ self.body = Some(body);
154
+ self.content_type = Some(content_type.to_owned());
155
+ }
156
+
157
+ /// What made the request unsendable, taken out.
158
+ pub(crate) fn take_failure(&mut self) -> Option<Error> {
159
+ self.failed.take()
160
+ }
161
+
162
+ /// `METHOD /template`, the name a log entry gives the call.
163
+ pub(crate) fn operation(&self) -> String {
164
+ format!("{} {}", self.method, self.template)
165
+ }
166
+
167
+ /// The body for one send: bytes again on every send, a stream only on the first.
168
+ pub(crate) fn take_body(&mut self) -> Option<Body> {
169
+ match &self.body {
170
+ Some(Body(Content::Bytes(b))) => Some(Body::from(b.clone())),
171
+ _ => self.body.take(),
172
+ }
173
+ }
174
+
175
+ pub(crate) fn replayable(&self) -> bool {
176
+ !matches!(self.body, Some(Body(Content::Stream(_))))
177
+ }
178
+ }
@@ -0,0 +1,101 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ //! How a call settles (G16): the normal client's `Result<T, Error>`, or `Client::safe`'s
3
+ //! `Result<Answer<T>, Error>`, whose `Err` is a failure without an answer alone.
4
+
5
+ use crate::call::RawResponse;
6
+ use crate::errors::{ApiError, DecodeError, Error};
7
+
8
+ /// What a safe call answers: a 2xx's data, or the answer it got as an error, each with its response.
9
+ #[derive(Debug)]
10
+ pub enum Answer<T, E = ApiError> {
11
+ Ok {
12
+ data: T,
13
+ response: RawResponse,
14
+ },
15
+ Err {
16
+ error: SafeError<E>,
17
+ response: RawResponse,
18
+ },
19
+ }
20
+
21
+ /// An answer that is an error: an error status, or a 2xx (or a declared header) that is not the
22
+ /// declared type, its body past the cap included.
23
+ #[derive(Debug)]
24
+ pub enum SafeError<E = ApiError> {
25
+ Api(E),
26
+ Decode(DecodeError),
27
+ }
28
+
29
+ mod sealed {
30
+ use super::*;
31
+
32
+ /// How a call failed: with its answer (boxed, a response being large), or without one.
33
+ pub enum Failed {
34
+ Answered(Box<(SafeError, RawResponse)>),
35
+ Unanswered(Error),
36
+ }
37
+ }
38
+
39
+ pub(crate) use sealed::Failed;
40
+
41
+ impl Failed {
42
+ /// `error`, the answer `raw` is.
43
+ pub(crate) fn answered(error: SafeError, raw: RawResponse) -> Self {
44
+ Failed::Answered(Box::new((error, raw)))
45
+ }
46
+ }
47
+
48
+ impl From<Error> for Failed {
49
+ fn from(e: Error) -> Self {
50
+ Failed::Unanswered(e)
51
+ }
52
+ }
53
+
54
+ /// The normal client's error for a failure: an answer's as `Api` or `Decode`.
55
+ impl From<Failed> for Error {
56
+ fn from(failed: Failed) -> Self {
57
+ match failed {
58
+ Failed::Answered(answered) => match answered.0 {
59
+ SafeError::Api(e) => Error::Api(e),
60
+ SafeError::Decode(e) => Error::Decode(e),
61
+ },
62
+ Failed::Unanswered(e) => e,
63
+ }
64
+ }
65
+ }
66
+
67
+ /// How a call settles: `Throw` (the normal client) or `Safe` (`Client::safe`). Sealed.
68
+ pub trait Style: Send + Sync + 'static {
69
+ type Out<T>;
70
+ #[doc(hidden)]
71
+ fn settle<T>(sent: Result<(T, RawResponse), Failed>) -> Self::Out<T>;
72
+ }
73
+
74
+ /// Every answer that is an error is `Err`.
75
+ #[derive(Debug, Clone, Copy)]
76
+ pub enum Throw {}
77
+
78
+ /// Every answer is `Ok`, as an `Answer`.
79
+ #[derive(Debug, Clone, Copy)]
80
+ pub enum Safe {}
81
+
82
+ impl Style for Throw {
83
+ type Out<T> = Result<T, Error>;
84
+ fn settle<T>(sent: Result<(T, RawResponse), Failed>) -> Self::Out<T> {
85
+ sent.map(|(data, _)| data).map_err(Error::from)
86
+ }
87
+ }
88
+
89
+ impl Style for Safe {
90
+ type Out<T> = Result<Answer<T>, Error>;
91
+ fn settle<T>(sent: Result<(T, RawResponse), Failed>) -> Self::Out<T> {
92
+ match sent {
93
+ Ok((data, response)) => Ok(Answer::Ok { data, response }),
94
+ Err(Failed::Answered(answered)) => {
95
+ let (error, response) = *answered;
96
+ Ok(Answer::Err { error, response })
97
+ }
98
+ Err(Failed::Unanswered(e)) => Err(e),
99
+ }
100
+ }
101
+ }
@@ -0,0 +1,104 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ //! The WHATWG event-stream parser: lines end in CRLF, LF or CR; a blank line dispatches; a final
3
+ //! event without its blank line is never dispatched; the id is sticky and one holding NUL is
4
+ //! ignored; `retry` takes ASCII digits only; a leading BOM is skipped; values are not trimmed.
5
+
6
+ use crate::errors::Error;
7
+
8
+ /// The longest line, and the most data one event holds.
9
+ const MAX_LINE: usize = 1 << 20;
10
+ const MAX_EVENT: usize = 8 << 20;
11
+
12
+ /// One server-sent event. `id` is the last event id seen on the stream so far, to resume from.
13
+ #[derive(Debug, Clone, Default, PartialEq)]
14
+ pub struct SseEvent<T = String> {
15
+ pub data: T,
16
+ pub event: String,
17
+ pub id: String,
18
+ pub retry: Option<u64>,
19
+ }
20
+
21
+ /// An incremental parser: each byte is scanned once.
22
+ #[derive(Debug, Default)]
23
+ pub(crate) struct SseParser {
24
+ line: Vec<u8>,
25
+ pending_cr: bool,
26
+ started: bool,
27
+ data: String,
28
+ has_data: bool,
29
+ event: String,
30
+ last_id: String,
31
+ retry: Option<u64>,
32
+ }
33
+
34
+ impl SseParser {
35
+ /// Consumes `chunk`: every event it completes, then the cap it crossed, if one (the stream
36
+ /// ends there, the events before it delivered).
37
+ pub(crate) fn feed(&mut self, chunk: &[u8]) -> (Vec<SseEvent>, Option<Error>) {
38
+ let mut out = Vec::new();
39
+ for &b in chunk {
40
+ if std::mem::take(&mut self.pending_cr) && b == b'\n' {
41
+ continue;
42
+ }
43
+ if b == b'\n' || b == b'\r' {
44
+ self.pending_cr = b == b'\r';
45
+ let line = std::mem::take(&mut self.line);
46
+ match self.line_of(&line) {
47
+ Ok(event) => out.extend(event),
48
+ Err(e) => return (out, Some(e)),
49
+ }
50
+ } else if self.line.len() >= MAX_LINE {
51
+ let e = Error::decode("an event-stream line exceeds 1 MiB");
52
+ return (out, Some(e));
53
+ } else {
54
+ self.line.push(b);
55
+ }
56
+ }
57
+ (out, None)
58
+ }
59
+
60
+ fn line_of(&mut self, raw: &[u8]) -> Result<Option<SseEvent>, Error> {
61
+ let text = String::from_utf8_lossy(raw);
62
+ let mut line: &str = &text;
63
+ if !std::mem::replace(&mut self.started, true) {
64
+ line = line.strip_prefix('\u{feff}').unwrap_or(line);
65
+ }
66
+ if line.is_empty() {
67
+ return Ok(self.dispatch());
68
+ }
69
+ let (field, value) = match line.split_once(':') {
70
+ Some((field, value)) => (field, value.strip_prefix(' ').unwrap_or(value)),
71
+ None => (line, ""),
72
+ };
73
+ match field {
74
+ "data" => {
75
+ if self.data.len() + value.len() + 1 > MAX_EVENT {
76
+ return Err(Error::decode("an event's data exceeds 8 MiB"));
77
+ }
78
+ if std::mem::replace(&mut self.has_data, true) {
79
+ self.data.push('\n');
80
+ }
81
+ self.data.push_str(value);
82
+ }
83
+ "event" => self.event = value.to_owned(),
84
+ "id" if !value.contains('\0') => self.last_id = value.to_owned(),
85
+ "retry" if !value.is_empty() && value.bytes().all(|c| c.is_ascii_digit()) => {
86
+ self.retry = value.parse().ok();
87
+ }
88
+ _ => {}
89
+ }
90
+ Ok(None)
91
+ }
92
+
93
+ fn dispatch(&mut self) -> Option<SseEvent> {
94
+ let data = std::mem::take(&mut self.data);
95
+ let event = std::mem::take(&mut self.event);
96
+ let retry = self.retry.take();
97
+ std::mem::take(&mut self.has_data).then(|| SseEvent {
98
+ data,
99
+ event,
100
+ id: self.last_id.clone(),
101
+ retry,
102
+ })
103
+ }
104
+ }
@@ -0,0 +1,209 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ //! Staleness per `METHOD /path` selector with TypeScript parity: exact keys and pattern keys, a
3
+ //! stale window, eviction of the least recently staled at the cap, and a sequence stamp so a read
4
+ //! clears only what was staled before it began. A lookup reads its own key and the pattern keys,
5
+ //! never every entry: each window is as long as the next, so the staling order is the expiry order.
6
+
7
+ use std::collections::{BTreeMap, BTreeSet, HashMap};
8
+ use std::sync::Mutex;
9
+ use std::time::{Duration, Instant};
10
+
11
+ use crate::invalidation::{
12
+ InvalidationConfig, RequestMeta, has_placeholders, matches_pattern, resolve_targets,
13
+ };
14
+
15
+ /// One stale selector: the mutations that staled it, the sequence of the mutation that last did (a
16
+ /// read clears what came before it), the order it was last staled in (eviction), and its expiry.
17
+ struct Entry {
18
+ by: Vec<String>,
19
+ seq: u64,
20
+ stamp: u64,
21
+ until: Instant,
22
+ }
23
+
24
+ /// The entries by key, by the order they were last staled in, and the pattern keys.
25
+ #[derive(Default)]
26
+ struct Entries {
27
+ map: HashMap<String, Entry>,
28
+ order: BTreeMap<u64, String>,
29
+ patterns: BTreeSet<String>,
30
+ seq: u64,
31
+ stamps: u64,
32
+ }
33
+
34
+ impl Entries {
35
+ fn remove(&mut self, key: &str) {
36
+ if let Some(entry) = self.map.remove(key) {
37
+ self.order.remove(&entry.stamp);
38
+ self.patterns.remove(key);
39
+ }
40
+ }
41
+
42
+ /// Drops the least recently staled entry.
43
+ fn pop_oldest(&mut self) {
44
+ if let Some((_, key)) = self.order.pop_first() {
45
+ self.map.remove(&key);
46
+ self.patterns.remove(&key);
47
+ }
48
+ }
49
+
50
+ /// Drops the expired entries: the least recently staled, all windows being as long.
51
+ fn expire(&mut self, now: Instant) {
52
+ while let Some(key) = self.order.values().next() {
53
+ if self.map.get(key).is_some_and(|e| e.until > now) {
54
+ return;
55
+ }
56
+ self.pop_oldest();
57
+ }
58
+ }
59
+
60
+ /// The keys a read of `method path` reads, in key order: its own, and each pattern key of its
61
+ /// method its path matches.
62
+ fn read_by(&self, selector: &str, method: &str, path: &str) -> Vec<String> {
63
+ let mut keys: Vec<&String> = self
64
+ .patterns
65
+ .iter()
66
+ .filter(|key| pattern_of(key, method).is_some_and(|p| matches_pattern(path, p)))
67
+ .collect();
68
+ if let Some((key, _)) = self.map.get_key_value(selector) {
69
+ keys.push(key);
70
+ }
71
+ keys.sort();
72
+ keys.dedup();
73
+ keys.into_iter().cloned().collect()
74
+ }
75
+ }
76
+
77
+ /// The selectors invalidation staled; a cheap no-op when invalidation is off.
78
+ pub(crate) struct StaleTracker {
79
+ entries: Mutex<Entries>,
80
+ stale_time: Duration,
81
+ max_entries: usize,
82
+ max_sources: usize,
83
+ }
84
+
85
+ /// `n`, or `fallback` for zero.
86
+ fn or(n: usize, fallback: usize) -> usize {
87
+ if n == 0 { fallback } else { n }
88
+ }
89
+
90
+ /// The pattern part of a `METHOD /path` key, when its path holds placeholders.
91
+ fn pattern_of<'a>(key: &'a str, method: &str) -> Option<&'a str> {
92
+ let (m, path) = key.split_once(' ')?;
93
+ (m == method && has_placeholders(path)).then_some(path)
94
+ }
95
+
96
+ impl StaleTracker {
97
+ pub(crate) fn new(config: Option<&InvalidationConfig>) -> Self {
98
+ let config = config.cloned().unwrap_or_default();
99
+ StaleTracker {
100
+ entries: Mutex::new(Entries::default()),
101
+ stale_time: config.stale_time,
102
+ max_entries: or(config.stale_max_entries, 1000),
103
+ max_sources: or(config.max_sources_per_target, 16),
104
+ }
105
+ }
106
+
107
+ fn enabled(&self) -> bool {
108
+ !self.stale_time.is_zero()
109
+ }
110
+
111
+ fn lock(&self) -> std::sync::MutexGuard<'_, Entries> {
112
+ self.entries.lock().unwrap_or_else(|e| e.into_inner())
113
+ }
114
+
115
+ /// The staleness of `method path` for a request about to start; default when off.
116
+ pub(crate) fn begin(&self, method: &str, path: &str) -> RequestMeta {
117
+ if !self.enabled() {
118
+ return RequestMeta::default();
119
+ }
120
+ let selector = format!("{method} {path}");
121
+ let mut entries = self.lock();
122
+ let invalidated_by = lookup(&mut entries, &selector, path, method);
123
+ RequestMeta {
124
+ is_stale: !invalidated_by.is_empty(),
125
+ invalidated_by,
126
+ selector,
127
+ seq: entries.seq,
128
+ }
129
+ }
130
+
131
+ /// After a 2xx: stales `targets` (filled from `params`), then clears what the call read through
132
+ /// a stale window.
133
+ pub(crate) fn settle(&self, meta: &RequestMeta, targets: &[&str], params: &[(&str, String)]) {
134
+ if !self.enabled() {
135
+ return;
136
+ }
137
+ let mut entries = self.lock();
138
+ if !targets.is_empty() {
139
+ entries.seq += 1;
140
+ let until = Instant::now() + self.stale_time;
141
+ for target in resolve_targets(targets, params) {
142
+ self.upsert(&mut entries, target, until, &meta.selector);
143
+ }
144
+ self.evict(&mut entries);
145
+ }
146
+ if meta.is_stale {
147
+ let (method, path) = meta.selector.split_once(' ').unwrap_or_default();
148
+ for key in entries.read_by(&meta.selector, method, path) {
149
+ if entries.map.get(&key).is_some_and(|e| e.seq <= meta.seq) {
150
+ entries.remove(&key);
151
+ }
152
+ }
153
+ }
154
+ }
155
+
156
+ fn upsert(&self, entries: &mut Entries, key: String, until: Instant, source: &str) {
157
+ entries.stamps += 1;
158
+ let (seq, stamp) = (entries.seq, entries.stamps);
159
+ if let Some(old) = entries.map.get(&key) {
160
+ entries.order.remove(&old.stamp);
161
+ } else if key
162
+ .split_once(' ')
163
+ .is_some_and(|(_, path)| has_placeholders(path))
164
+ {
165
+ entries.patterns.insert(key.clone());
166
+ }
167
+ entries.order.insert(stamp, key.clone());
168
+ let entry = entries.map.entry(key).or_insert_with(|| Entry {
169
+ by: Vec::new(),
170
+ seq,
171
+ stamp,
172
+ until,
173
+ });
174
+ entry.seq = seq;
175
+ entry.stamp = stamp;
176
+ entry.until = until;
177
+ if entry.by.len() < self.max_sources && !entry.by.iter().any(|b| b == source) {
178
+ entry.by.push(source.to_owned());
179
+ }
180
+ }
181
+
182
+ /// Past the cap: drops the expired, then the least recently staled down to half the cap (one
183
+ /// mutation's targets each staled in turn, so its first target goes first).
184
+ fn evict(&self, entries: &mut Entries) {
185
+ if entries.map.len() <= self.max_entries {
186
+ return;
187
+ }
188
+ entries.expire(Instant::now());
189
+ let keep = (self.max_entries / 2).max(1);
190
+ while entries.map.len() > keep {
191
+ entries.pop_oldest();
192
+ }
193
+ }
194
+ }
195
+
196
+ /// The mutations that staled `selector` (exactly, or by a pattern its path matches), the expired
197
+ /// entries dropped on the way.
198
+ fn lookup(entries: &mut Entries, selector: &str, path: &str, method: &str) -> Vec<String> {
199
+ entries.expire(Instant::now());
200
+ let mut by: Vec<String> = Vec::new();
201
+ for key in entries.read_by(selector, method, path) {
202
+ for source in &entries.map[&key].by {
203
+ if !by.contains(source) {
204
+ by.push(source.clone());
205
+ }
206
+ }
207
+ }
208
+ by
209
+ }