@workerstack/clients 0.0.0-stage → 1.0.0-rc.24

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 +135 -5
@@ -0,0 +1,322 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ //! A WebSocket operation's answer: the open socket, dialed with the call's URL, headers and
3
+ //! credential, its offered subprotocols, and a 16 MiB message cap. The call's `cancel_on` bounds the
4
+ //! handshake and ends an open socket's reads quietly; dropping it closes the connection. Its dial
5
+ //! runs no `on_request` or `on_response` hook, and a refused handshake's 401 is its error, with no
6
+ //! `on_auth_expired` refresh.
7
+
8
+ use std::sync::Arc;
9
+ use std::time::Duration;
10
+
11
+ use bytes::Bytes;
12
+ use futures_util::{SinkExt, StreamExt};
13
+ use reqwest::header::HeaderValue;
14
+ use tokio::io::AsyncReadExt;
15
+ use tokio_tungstenite::tungstenite::client::IntoClientRequest;
16
+ use tokio_tungstenite::tungstenite::protocol::frame::coding::CloseCode;
17
+ use tokio_tungstenite::tungstenite::protocol::{CloseFrame, WebSocketConfig};
18
+ use tokio_tungstenite::tungstenite::{self, Message};
19
+
20
+ use crate::call::{Overrides, RawResponse, Run, Signal};
21
+ use crate::config::Inner;
22
+ use crate::errors::{ApiError, Error};
23
+ use crate::exchange::{headers_of, token_of, url_of};
24
+ use crate::request::RequestSpec;
25
+
26
+ /// The largest message either side may send.
27
+ const MAX_MESSAGE: usize = 16 << 20;
28
+ /// The most bytes a close reason may hold (RFC 6455: 125 less the code).
29
+ const MAX_REASON: usize = 123;
30
+ /// How long `close` waits for the server's close frame.
31
+ const CLOSE_WAIT: Duration = Duration::from_secs(5);
32
+ /// A ping each interval while a read waits; one unanswered as long ends the socket.
33
+ struct Keepalive {
34
+ every: Duration,
35
+ due: tokio::time::Instant,
36
+ pinged: bool,
37
+ }
38
+
39
+ /// The close codes RFC 6455 names for a normal close, a peer going away and a protocol error.
40
+ pub const WS_STATUS_NORMAL_CLOSURE: u16 = 1000;
41
+ pub const WS_STATUS_GOING_AWAY: u16 = 1001;
42
+ pub const WS_STATUS_PROTOCOL_ERROR: u16 = 1002;
43
+
44
+ type Socket =
45
+ tokio_tungstenite::WebSocketStream<tokio_tungstenite::MaybeTlsStream<tokio::net::TcpStream>>;
46
+
47
+ /// What an `on` handler is called for: each message read, the close (with its reason), or the error
48
+ /// the socket ended on (with its text). The socket's end fires one of the two, once.
49
+ #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
50
+ pub enum WsEvent {
51
+ Message,
52
+ Close,
53
+ Error,
54
+ }
55
+
56
+ /// The close frame the server ended the socket with.
57
+ #[derive(Debug, Clone, PartialEq, Eq)]
58
+ pub struct WsClose {
59
+ pub code: u16,
60
+ pub reason: String,
61
+ }
62
+
63
+ type Handler = Box<dyn FnMut(&[u8]) + Send>;
64
+
65
+ /// An open WebSocket: messages in and out, JSON on top. Reading `None` means it closed: `closed_by`
66
+ /// holds the server's close frame, if it sent one.
67
+ pub struct TypedWebSocket {
68
+ socket: Socket,
69
+ handlers: Vec<(WsEvent, Handler)>,
70
+ closed_by: Option<WsClose>,
71
+ ended: bool,
72
+ cancel: Option<Signal>,
73
+ keepalive: Option<Keepalive>,
74
+ }
75
+
76
+ /// Resolves once `signal` fires; never without one.
77
+ pub(crate) async fn canceled(signal: Option<Signal>) {
78
+ match signal {
79
+ Some(signal) => signal.await,
80
+ None => std::future::pending().await,
81
+ }
82
+ }
83
+
84
+ fn transport(e: tungstenite::Error) -> Error {
85
+ match e {
86
+ tungstenite::Error::Http(response) => {
87
+ let (parts, body) = response.into_parts();
88
+ Error::Api(ApiError::new(
89
+ parts.status.as_u16(),
90
+ parts.headers,
91
+ Bytes::from(body.unwrap_or_default()),
92
+ ))
93
+ }
94
+ tungstenite::Error::ConnectionClosed | tungstenite::Error::AlreadyClosed => Error::Closed,
95
+ other => Error::Transport(Box::new(other)),
96
+ }
97
+ }
98
+
99
+ impl TypedWebSocket {
100
+ /// Calls `handler` on each `event` (TypeScript parity); a read loop is the typed way in.
101
+ pub fn on(&mut self, event: WsEvent, handler: impl FnMut(&[u8]) + Send + 'static) {
102
+ self.handlers.push((event, Box::new(handler)));
103
+ }
104
+
105
+ fn fire(&mut self, event: WsEvent, data: &[u8]) {
106
+ for (on, handler) in &mut self.handlers {
107
+ if *on == event {
108
+ handler(data);
109
+ }
110
+ }
111
+ }
112
+
113
+ /// Marks the socket ended, firing `event` once.
114
+ fn end(&mut self, event: WsEvent, data: &[u8]) {
115
+ if !std::mem::replace(&mut self.ended, true) {
116
+ self.fire(event, data);
117
+ }
118
+ }
119
+
120
+ /// Sends `text` as one text frame.
121
+ pub async fn send_text(&mut self, text: impl Into<String>) -> Result<(), Error> {
122
+ let text: String = text.into();
123
+ self.socket
124
+ .send(Message::text(text))
125
+ .await
126
+ .map_err(transport)
127
+ }
128
+
129
+ /// Sends `data` as one binary frame.
130
+ pub async fn send_binary(&mut self, data: impl Into<Bytes>) -> Result<(), Error> {
131
+ let data: Bytes = data.into();
132
+ self.socket
133
+ .send(Message::binary(data))
134
+ .await
135
+ .map_err(transport)
136
+ }
137
+
138
+ /// Sends `value` as JSON in one text frame.
139
+ pub async fn send_json<T: serde::Serialize + ?Sized>(
140
+ &mut self,
141
+ value: &T,
142
+ ) -> Result<(), Error> {
143
+ let text = serde_json::to_string(value).map_err(Error::decode)?;
144
+ self.send_text(text).await
145
+ }
146
+
147
+ /// The next message's bytes (text or binary); `None` once the socket closed, failed or the
148
+ /// call's `cancel_on` fired.
149
+ pub async fn recv(&mut self) -> Option<Result<Vec<u8>, Error>> {
150
+ while !self.ended {
151
+ let signal = self.cancel.clone();
152
+ let at = self.keepalive.as_ref().map(|k| k.due);
153
+ let wait = tokio::time::sleep_until(at.unwrap_or_else(tokio::time::Instant::now));
154
+ let read = tokio::select! {
155
+ biased;
156
+ () = canceled(signal) => None,
157
+ read = self.socket.next() => Some(read),
158
+ () = wait, if at.is_some() => {
159
+ if let Some(e) = self.ping().await {
160
+ return Some(Err(e));
161
+ }
162
+ continue;
163
+ }
164
+ };
165
+ let Some(read) = read else {
166
+ /* canceled: the reads end quietly, and close has nothing left to do */
167
+ self.ended = true;
168
+ break;
169
+ };
170
+ if let (Some(k), Some(Ok(_))) = (self.keepalive.as_mut(), &read) {
171
+ k.pinged = false;
172
+ }
173
+ match read {
174
+ Some(Ok(Message::Text(t))) => return Some(Ok(self.message(t.as_bytes()))),
175
+ Some(Ok(Message::Binary(b))) => return Some(Ok(self.message(&b))),
176
+ Some(Ok(Message::Close(frame))) => {
177
+ let (code, reason) = frame.map_or((1005, String::new()), |f| {
178
+ (f.code.into(), f.reason.as_str().to_owned())
179
+ });
180
+ /* send the close echo tungstenite queued, completing the handshake */
181
+ let _ = self.socket.flush().await;
182
+ self.end(WsEvent::Close, reason.as_bytes());
183
+ self.closed_by = Some(WsClose { code, reason });
184
+ }
185
+ Some(Ok(_)) => {}
186
+ Some(Err(e)) => {
187
+ if matches!(e, tungstenite::Error::Capacity(_)) {
188
+ let frame = CloseFrame {
189
+ code: CloseCode::Size,
190
+ reason: "Message too big".into(),
191
+ };
192
+ let _ = self.socket.close(Some(frame)).await;
193
+ /* drain to the server's end: a close with unread bytes resets, losing the frame */
194
+ let raw = self.socket.get_mut();
195
+ let drain = async {
196
+ let mut sink = [0u8; 16 << 10];
197
+ while matches!(raw.read(&mut sink).await, Ok(n) if n > 0) {}
198
+ };
199
+ let _ = tokio::time::timeout(CLOSE_WAIT, drain).await;
200
+ }
201
+ let e = transport(e);
202
+ self.end(WsEvent::Error, e.to_string().as_bytes());
203
+ return Some(Err(e));
204
+ }
205
+ None => self.end(WsEvent::Close, b""),
206
+ }
207
+ }
208
+ None
209
+ }
210
+
211
+ /// A ping, or the end of a socket whose last one went unanswered.
212
+ async fn ping(&mut self) -> Option<Error> {
213
+ let k = self.keepalive.as_mut()?;
214
+ let sent = if k.pinged {
215
+ Err(Error::Transport("no pong within the keepalive".into()))
216
+ } else {
217
+ k.pinged = true;
218
+ k.due = tokio::time::Instant::now() + k.every;
219
+ let ping = self.socket.send(Message::Ping(Bytes::new()));
220
+ ping.await.map_err(transport)
221
+ };
222
+ let e = sent.err()?;
223
+ self.end(WsEvent::Error, e.to_string().as_bytes());
224
+ Some(e)
225
+ }
226
+
227
+ fn message(&mut self, data: &[u8]) -> Vec<u8> {
228
+ self.fire(WsEvent::Message, data);
229
+ data.to_vec()
230
+ }
231
+
232
+ /// The close frame the server sent, once `recv` read it.
233
+ pub fn closed_by(&self) -> Option<&WsClose> {
234
+ self.closed_by.as_ref()
235
+ }
236
+
237
+ /// Closes with `code` and `reason` (cut to 123 bytes at a character boundary), then waits up to
238
+ /// 5 s for the server's close frame. A socket that already ended (the server closed it, it
239
+ /// failed, or the call was canceled) closes quietly: `Ok`, nothing sent.
240
+ pub async fn close(&mut self, code: u16, reason: &str) -> Result<(), Error> {
241
+ if self.ended {
242
+ return Ok(());
243
+ }
244
+ let cut = (0..=reason.len().min(MAX_REASON))
245
+ .rev()
246
+ .find(|&i| reason.is_char_boundary(i))
247
+ .unwrap_or(0);
248
+ let frame = CloseFrame {
249
+ code: CloseCode::from(code),
250
+ reason: reason[..cut].into(),
251
+ };
252
+ let sent = self.socket.close(Some(frame)).await;
253
+ self.end(WsEvent::Close, &reason.as_bytes()[..cut]);
254
+ let echo = async { while let Some(Ok(_)) = self.socket.next().await {} };
255
+ let _ = tokio::time::timeout(CLOSE_WAIT, echo).await;
256
+ sent.map_err(transport)
257
+ }
258
+ }
259
+
260
+ /// Dials the socket of `spec`: its URL with a ws(s) scheme, the call's headers and credential (a fresh
261
+ /// `X-Request-Id` unless one is set), and `protocols` offered.
262
+ pub(crate) async fn connect(
263
+ inner: &Inner,
264
+ spec: &RequestSpec,
265
+ ov: &Overrides,
266
+ protocols: &[String],
267
+ ) -> Result<(TypedWebSocket, RawResponse), Error> {
268
+ let mut url = url_of(inner, spec, ov)?;
269
+ let scheme = if url.scheme() == "https" { "wss" } else { "ws" };
270
+ url.set_scheme(scheme)
271
+ .map_err(|()| Error::Config("the base_url cannot carry a WebSocket".into()))?;
272
+ let token = token_of(inner, ov).await;
273
+ let headers = headers_of(inner, spec, ov, token.as_deref())?;
274
+ let mut request = url.as_str().into_client_request().map_err(transport)?;
275
+ request.headers_mut().extend(headers);
276
+ if !protocols.is_empty() {
277
+ let offered = HeaderValue::from_str(&protocols.join(", "))
278
+ .map_err(|_| Error::Config("a subprotocol is not valid in a header".into()))?;
279
+ request
280
+ .headers_mut()
281
+ .insert("sec-websocket-protocol", offered);
282
+ }
283
+ let config = WebSocketConfig::default().max_message_size(Some(MAX_MESSAGE));
284
+ let (socket, response) =
285
+ tokio_tungstenite::connect_async_with_config(request, Some(config), false)
286
+ .await
287
+ .map_err(transport)?;
288
+ let raw = RawResponse {
289
+ status: response.status().as_u16(),
290
+ url,
291
+ headers: response.headers().clone(),
292
+ body: Bytes::new(),
293
+ };
294
+ let socket = TypedWebSocket {
295
+ socket,
296
+ handlers: Vec::new(),
297
+ closed_by: None,
298
+ ended: false,
299
+ cancel: ov.cancel.clone(),
300
+ keepalive: inner.ws_keepalive.map(|every| Keepalive {
301
+ every,
302
+ due: tokio::time::Instant::now() + every,
303
+ pinged: false,
304
+ }),
305
+ };
306
+ Ok((socket, raw))
307
+ }
308
+
309
+ /// A WebSocket operation: dials offering `protocols`.
310
+ #[allow(dead_code)] // a realtime-only SDK dials through its transports
311
+ pub(crate) fn dial(protocols: Vec<String>) -> Run<TypedWebSocket> {
312
+ Box::new(
313
+ move |inner: Arc<Inner>, mut spec: RequestSpec, ov: Overrides| {
314
+ Box::pin(async move {
315
+ if let Some(e) = spec.take_failure() {
316
+ return Err(e.into());
317
+ }
318
+ Ok(connect(&inner, &spec, &ov, &protocols).await?)
319
+ })
320
+ },
321
+ )
322
+ }
@@ -0,0 +1,200 @@
1
+ /**
2
+ * The app-typed client's types. They read the app's `$routes` phantom structurally, so the
3
+ * emitted client imports nothing from honey (D3): `InferRoutes`, the path params and a schema's
4
+ * output type are spelled here as honey spells them.
5
+ */
6
+ import type { ClientError } from "./error.ts"
7
+ import type { Result, StatusOf } from "./response.ts"
8
+ import type { SSEEvent } from "./sse.ts"
9
+ import type { TypedWebSocket } from "./ws.ts"
10
+
11
+ /** An app's routes: the `$routes` phantom its type carries. */
12
+ export type InferRoutes<T> = T extends { readonly $routes: infer R } ? R : never
13
+
14
+ /** One problem with one input field, as the error envelope lists it. */
15
+ export type FieldError = { error_key: string; message: string; path: string }
16
+
17
+ /** The type a Standard schema produces once it validated a value. */
18
+ type SchemaOutput<T> = T extends { readonly "~standard": { readonly types?: infer TTypes } }
19
+ ? NonNullable<TTypes> extends { readonly output: infer O }
20
+ ? O
21
+ : unknown
22
+ : unknown
23
+
24
+ type ParamKey<T extends string> = T extends `${infer Name}?` ? Name : T
25
+
26
+ /** A route pattern's param names: `:name` (optional or not), a named wildcard, an unnamed one as `*`. */
27
+ type ParamKeys<Path extends string> = Path extends `${string}:${infer Param}/${infer Rest}`
28
+ ? ParamKey<Param> | ParamKeys<`/${Rest}`>
29
+ : Path extends `${string}:${infer Param}`
30
+ ? ParamKey<Param>
31
+ : Path extends `${string}*${infer Name}`
32
+ ? Name extends ""
33
+ ? "*"
34
+ : Name
35
+ : never
36
+
37
+ /** Paths that register `M`. */
38
+ export type PathsForMethod<TRoutes, M extends string> = {
39
+ [P in keyof TRoutes & string]: M extends keyof TRoutes[P] ? P : never
40
+ }[keyof TRoutes & string]
41
+
42
+ /** One route's record, when the app has it. */
43
+ type RouteOf<TRoutes, P extends string, M extends string> = P extends keyof TRoutes
44
+ ? M extends keyof TRoutes[P]
45
+ ? TRoutes[P][M]
46
+ : never
47
+ : never
48
+
49
+ /** What a call sends: the route's `request` (each source's schema input, `streamed()` unwrapped). */
50
+ export type InputFor<TRoutes, P extends string, M extends string> =
51
+ RouteOf<TRoutes, P, M> extends { request: infer I } ? ([I] extends [never] ? {} : I) : {}
52
+
53
+ export type OutputDefFor<TRoutes, P extends string, M extends string> =
54
+ RouteOf<TRoutes, P, M> extends { output: infer O } ? O : never
55
+
56
+ /** Statuses whose answer never carries a body (204, 205, 304): the client reads each as null. */
57
+ type NullBodyStatus = "no_content" | "not_modified" | "reset_content"
58
+
59
+ /** The statuses a declaration names under each key (a media type, `headers`, `redirect`). */
60
+ type StatusesOf<O> = { [K in keyof O]: keyof NonNullable<O[K]> }[keyof O]
61
+
62
+ /** Media type `CT`'s statuses that carry a body. */
63
+ type BodyStatuses<O, CT extends string> = CT extends keyof O ? Exclude<keyof O[CT], NullBodyStatus> : never
64
+
65
+ /** Whether media type `CT` declares a status that carries a body. */
66
+ type Answers<O, CT extends string> = [BodyStatuses<O, CT>] extends [never] ? false : true
67
+
68
+ /**
69
+ * A body's value: JSON by its schemas, text types as text, octet-stream as bytes (A1); `unknown`
70
+ * when a status carries a body no media type here types; `never` when none carries one.
71
+ */
72
+ type BodyValue<O> =
73
+ Answers<O, "application/json"> extends true
74
+ ? O extends { "application/json": infer JsonMap }
75
+ ? SchemaOutput<JsonMap[BodyStatuses<O, "application/json"> & keyof JsonMap]>
76
+ : never
77
+ : true extends
78
+ | Answers<O, "text/plain">
79
+ | Answers<O, "text/html">
80
+ | Answers<O, "text/csv">
81
+ | Answers<O, "application/xml">
82
+ ? string
83
+ : Answers<O, "application/octet-stream"> extends true
84
+ ? Uint8Array<ArrayBuffer>
85
+ : [Exclude<StatusesOf<O>, NullBodyStatus>] extends [never]
86
+ ? never
87
+ : unknown
88
+
89
+ /** What a declaration answers with: its body's value, `null` for each declared no-content status. */
90
+ type DeclaredValue<O> = BodyValue<O> | ([Extract<StatusesOf<O>, NullBodyStatus>] extends [never] ? never : null)
91
+
92
+ /**
93
+ * The value a route answers with, `unknown` when it declares no status: undeclared is not empty,
94
+ * the handler's body comes back.
95
+ */
96
+ export type OutputFor<TRoutes, P extends string, M extends string> =
97
+ OutputDefFor<TRoutes, P, M> extends infer O
98
+ ? [O] extends [never]
99
+ ? unknown
100
+ : [DeclaredValue<O>] extends [never]
101
+ ? unknown
102
+ : DeclaredValue<O>
103
+ : unknown
104
+
105
+ /** Whether a route answers an event stream. */
106
+ export type IsSSE<TRoutes, P extends string, M extends string> =
107
+ OutputDefFor<TRoutes, P, M> extends infer O ? (O extends { "text/event-stream": unknown } ? true : false) : false
108
+
109
+ type ErrorsByStatusFor<TRoutes, P extends string, M extends string> =
110
+ RouteOf<TRoutes, P, M> extends { errorsByStatus: infer S } ? S : never
111
+
112
+ /** honey's error envelope, as a route without a schema of its own answers an error. */
113
+ export type ErrorEnvelope<TStatus extends number = number, TKey extends string = string> = {
114
+ error_key: TKey
115
+ fields: Record<string, FieldError[]>
116
+ message: string
117
+ status: TStatus
118
+ status_key: string
119
+ success: false
120
+ }
121
+
122
+ /** `null` in a route's errorsByStatus means the default envelope, not a null body. */
123
+ type ResolveErrorBody<S extends number, T> = T extends null ? ErrorEnvelope<S> : T
124
+
125
+ /** Each declared status's error body, honey's envelope where the route names none. */
126
+ type ErrorBodies<S> = { [K in keyof S]: ResolveErrorBody<StatusOf<K>, S[K]> }
127
+
128
+ /** What a call resolves to, by transport. */
129
+ export type ReturnFor<TRoutes, P extends string, M extends string> =
130
+ IsSSE<TRoutes, P, M> extends true ? AsyncIterable<SSEEvent> : Promise<OutputFor<TRoutes, P, M>>
131
+
132
+ /** What a safe call resolves to: its value, an event stream opened, or the answer's error; never a thrown answer. */
133
+ export type SafeReturnFor<TRoutes, P extends string, M extends string> = Promise<
134
+ Result<
135
+ IsSSE<TRoutes, P, M> extends true ? AsyncIterable<SSEEvent> : OutputFor<TRoutes, P, M>,
136
+ ErrorBodies<ErrorsByStatusFor<TRoutes, P, M>>
137
+ >
138
+ >
139
+
140
+ /** A path's params, required whenever the pattern names one. */
141
+ type ParamsInput<P extends string> = [ParamKeys<P>] extends [never] ? {} : { params: { [K in ParamKeys<P>]: string } }
142
+
143
+ /** The call input: the route's declared input with the path's params. */
144
+ export type ClientInput<TRoutes, P extends string, M extends string> = InputFor<TRoutes, P, M> & ParamsInput<P>
145
+
146
+ export type ErrorsFor<TRoutes, P extends string, M extends string> =
147
+ RouteOf<TRoutes, P, M> extends { errors: infer E extends string } ? E : never
148
+
149
+ type RequiresAllOptional<T> = {
150
+ [K in keyof T]-?: undefined extends T[K] ? true : false
151
+ }[keyof T] extends true
152
+ ? true
153
+ : Partial<T> extends T
154
+ ? true
155
+ : false
156
+
157
+ /** The input is optional when it is empty or every key is optional. */
158
+ type OptionalInput<T> = keyof T extends never
159
+ ? [input?: T]
160
+ : [RequiresAllOptional<T>] extends [true]
161
+ ? [input?: T]
162
+ : [input: T]
163
+
164
+ type Method<TRoutes, M extends string> = <P extends PathsForMethod<TRoutes, M>>(
165
+ path: P,
166
+ ...input: OptionalInput<ClientInput<TRoutes, P, M>>
167
+ ) => ReturnFor<TRoutes, P, M>
168
+
169
+ type SafeMethod<TRoutes, M extends string> = <P extends PathsForMethod<TRoutes, M>>(
170
+ path: P,
171
+ ...input: OptionalInput<ClientInput<TRoutes, P, M>>
172
+ ) => SafeReturnFor<TRoutes, P, M>
173
+
174
+ type PathHelper<TRoutes> = <P extends keyof TRoutes & string>(
175
+ path: P,
176
+ input?: { params?: Record<string, string>; search?: Record<string, unknown> },
177
+ ) => string
178
+
179
+ /** The typed client: each call resolves to its value and throws an error status; `safe`'s answer a Result. */
180
+ export type HoneyClient<TRoutes> = {
181
+ $isClientError: (e: unknown) => e is ClientError
182
+ $path: PathHelper<TRoutes>
183
+ $url: PathHelper<TRoutes>
184
+ delete: Method<TRoutes, "delete">
185
+ get: Method<TRoutes, "get">
186
+ patch: Method<TRoutes, "patch">
187
+ post: Method<TRoutes, "post">
188
+ put: Method<TRoutes, "put">
189
+ /** the same calls, each answering a Result instead of throwing an API answer (bit 21 i) */
190
+ safe: { [M in "delete" | "get" | "patch" | "post" | "put"]: SafeMethod<TRoutes, M> }
191
+ ws(
192
+ path: string,
193
+ input?: {
194
+ params?: Record<string, string>
195
+ protocols?: string | string[]
196
+ reconnectToken?: string
197
+ search?: Record<string, unknown>
198
+ },
199
+ ): TypedWebSocket
200
+ }
@@ -0,0 +1,104 @@
1
+ import type { HoneyClient, InferRoutes } from "./app-types.ts"
2
+ import type { ClientConfig } from "./config.ts"
3
+ import { isClientError } from "./error.ts"
4
+ import { HTTPClient } from "./http.ts"
5
+ import type { RequestOptions } from "./request.ts"
6
+ import { resultOf } from "./response.ts"
7
+ import type { SSEEvent } from "./sse.ts"
8
+ import { requestAuto, requestStream } from "./stream.ts"
9
+ import { createTypedWebSocket, type TypedWebSocket, wsUrl } from "./ws.ts"
10
+
11
+ const HTTP_METHODS: readonly string[] = ["delete", "get", "patch", "post", "put"]
12
+
13
+ /** What a path-addressed helper (`$url`, `$path`, `ws`) reads of its input. */
14
+ type PathInput = {
15
+ params?: Record<string, string>
16
+ protocols?: string | string[]
17
+ reconnectToken?: string
18
+ search?: Record<string, unknown>
19
+ }
20
+
21
+ function isAsyncIterable(value: unknown): value is AsyncIterable<SSEEvent> {
22
+ return typeof value === "object" && value !== null && Symbol.asyncIterator in value
23
+ }
24
+
25
+ /**
26
+ * One call, one request, consumed either way:
27
+ * - `await api.get(...)` sends it; an event-stream response resolves to an
28
+ * `AsyncIterable<SSEEvent>` (never buffered), anything else to the parsed body.
29
+ * - `for await (... of api.get(...))` before the call has started sends it as a stream request
30
+ * (`accept: text/event-stream`, no timeout).
31
+ * - iterating after awaiting reuses the same response instead of sending again.
32
+ */
33
+ function lazyCall(http: HTTPClient, call: { method: string; opts: RequestOptions; path: string }) {
34
+ const { method, opts, path } = call
35
+ let mode: "auto" | "idle" | "sse" = "idle"
36
+ let auto: Promise<unknown> | undefined
37
+ const runAuto = (): Promise<unknown> => {
38
+ auto ??= requestAuto(http, method, path, opts).then((answer) => answer.data)
39
+ return auto
40
+ }
41
+ const lazy = new Promise((resolve, reject) => {
42
+ queueMicrotask(() => {
43
+ if (mode === "sse") return
44
+ mode = "auto"
45
+ runAuto().then(resolve, reject)
46
+ })
47
+ })
48
+ Object.defineProperty(lazy, Symbol.asyncIterator, {
49
+ value() {
50
+ if (mode === "idle") {
51
+ mode = "sse"
52
+ return requestStream(http, method, path, opts)[Symbol.asyncIterator]()
53
+ }
54
+ return (async function* () {
55
+ const data = await runAuto()
56
+ if (!isAsyncIterable(data)) throw new TypeError(`${method} ${path} did not respond with an event stream`)
57
+ yield* data
58
+ })()
59
+ },
60
+ })
61
+ return lazy
62
+ }
63
+
64
+ /** The helpers that sit beside the methods: `$isClientError`, `$url`, `$path` and `ws`. */
65
+ function helper(http: HTTPClient, prop: string): unknown {
66
+ if (prop === "$isClientError") return isClientError
67
+ if (prop === "$url") return (path: string, input?: PathInput) => http.buildUrl(path, input ?? {})
68
+ if (prop === "$path") return (path: string, input?: PathInput) => http.buildPath(path, input ?? {})
69
+ if (prop !== "ws") return undefined
70
+ return (path: string, input?: PathInput): TypedWebSocket => {
71
+ let url = wsUrl(http, path, { params: input?.params, search: input?.search })
72
+ if (input?.reconnectToken)
73
+ url += `${url.includes("?") ? "&" : "?"}reconnect_token=${encodeURIComponent(input.reconnectToken)}`
74
+ return createTypedWebSocket(url, { protocols: input?.protocols })
75
+ }
76
+ }
77
+
78
+ /** `client.safe`: each method's call answering a Result, an event stream's opened before it resolves. */
79
+ function safeMethods(http: HTTPClient): object {
80
+ return Object.fromEntries(
81
+ HTTP_METHODS.map((method) => [
82
+ method,
83
+ (path: string, input?: RequestOptions) => resultOf(requestAuto(http, method.toUpperCase(), path, input ?? {})),
84
+ ]),
85
+ )
86
+ }
87
+
88
+ /** The app-typed client: each call throws an error status, and `client.safe`'s calls answer it as a Result. */
89
+ export function createClient<T>(config: ClientConfig): HoneyClient<InferRoutes<T>> {
90
+ const http = new HTTPClient(config)
91
+ const safe = safeMethods(http)
92
+ return new Proxy({} as HoneyClient<InferRoutes<T>>, {
93
+ get(_target, prop: string | symbol) {
94
+ /* not a thenable, and printable: `await client` and `String(client)` must not hit the method table */
95
+ if (prop === Symbol.toStringTag) return "HoneyClient"
96
+ if (typeof prop === "symbol" || prop === "then") return undefined
97
+ if (prop === "toString" || prop === "toJSON") return () => "[object HoneyClient]"
98
+ if (prop === "safe") return safe
99
+ if (!HTTP_METHODS.includes(prop)) return helper(http, prop)
100
+ return (path: string, input?: RequestOptions) =>
101
+ lazyCall(http, { method: prop.toUpperCase(), opts: input ?? {}, path })
102
+ },
103
+ })
104
+ }