@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,120 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ //! How a method reads its answer (G16): JSON into its type, none as `()`, text as a `String`,
3
+ //! binary as bytes. An error status, and a 2xx that does not read (its body past the cap
4
+ //! included), fail with the answer; the call's style settles them (result.rs).
5
+ #![allow(dead_code)] // an SDK reads the answer kinds its operations declare
6
+
7
+ use std::sync::Arc;
8
+
9
+ use reqwest::header::HeaderMap;
10
+ use serde::de::DeserializeOwned;
11
+
12
+ use crate::call::{BoxFuture, Overrides, RawResponse};
13
+ use crate::config::Inner;
14
+ use crate::errors::{ApiError, DecodeError, Error};
15
+ use crate::exchange::{Answer, send};
16
+ use crate::request::RequestSpec;
17
+ use crate::result::{Failed, SafeError};
18
+
19
+ /// What an answer is read as.
20
+ type Decode<T> = fn(&RawResponse) -> Result<T, DecodeError>;
21
+
22
+ /// A call's future: the answer read by `decode`, and the response it was read from.
23
+ type Answered<T> = BoxFuture<Result<(T, RawResponse), Failed>>;
24
+
25
+ fn decode_json<T: DeserializeOwned>(raw: &RawResponse) -> Result<T, DecodeError> {
26
+ let body: &[u8] = if raw.body.is_empty() {
27
+ b"null"
28
+ } else {
29
+ &raw.body
30
+ };
31
+ serde_json::from_slice(body).map_err(|e| DecodeError(e.to_string()))
32
+ }
33
+
34
+ fn decode_text(raw: &RawResponse) -> Result<String, DecodeError> {
35
+ Ok(String::from_utf8_lossy(&raw.body).into_owned())
36
+ }
37
+
38
+ fn decode_binary(raw: &RawResponse) -> Result<Vec<u8>, DecodeError> {
39
+ Ok(raw.body.to_vec())
40
+ }
41
+
42
+ fn decode_none(_: &RawResponse) -> Result<(), DecodeError> {
43
+ Ok(())
44
+ }
45
+
46
+ /// An error status, failed with its answer.
47
+ pub(crate) fn error_status(raw: RawResponse) -> Failed {
48
+ let e = ApiError::new(raw.status, raw.headers.clone(), raw.body.clone());
49
+ Failed::answered(SafeError::Api(e), raw)
50
+ }
51
+
52
+ fn read<T: Send + 'static>(
53
+ inner: Arc<Inner>,
54
+ mut spec: RequestSpec,
55
+ ov: Overrides,
56
+ decode: Decode<T>,
57
+ ) -> Answered<T> {
58
+ Box::pin(async move {
59
+ let Answer { raw, over, .. } = send(&inner, &mut spec, &ov).await?;
60
+ if !(200..300).contains(&raw.status) {
61
+ return Err(error_status(raw));
62
+ }
63
+ let read = if over {
64
+ let limit = inner.max_response_bytes;
65
+ Err(DecodeError(format!("the answer exceeds {limit} bytes")))
66
+ } else {
67
+ decode(&raw)
68
+ };
69
+ match read {
70
+ Ok(data) => Ok((data, raw)),
71
+ Err(e) => Err(Failed::answered(SafeError::Decode(e), raw)),
72
+ }
73
+ })
74
+ }
75
+
76
+ pub(crate) fn json<T: DeserializeOwned + Send + 'static>(
77
+ inner: Arc<Inner>,
78
+ spec: RequestSpec,
79
+ ov: Overrides,
80
+ ) -> Answered<T> {
81
+ read(inner, spec, ov, decode_json::<T>)
82
+ }
83
+
84
+ pub(crate) fn text(inner: Arc<Inner>, spec: RequestSpec, ov: Overrides) -> Answered<String> {
85
+ read(inner, spec, ov, decode_text)
86
+ }
87
+
88
+ pub(crate) fn binary(inner: Arc<Inner>, spec: RequestSpec, ov: Overrides) -> Answered<Vec<u8>> {
89
+ read(inner, spec, ov, decode_binary)
90
+ }
91
+
92
+ pub(crate) fn none(inner: Arc<Inner>, spec: RequestSpec, ov: Overrides) -> Answered<()> {
93
+ read(inner, spec, ov, decode_none)
94
+ }
95
+
96
+ /// The response header `name` as a `T`: its text as a JSON string, else as JSON (a number, a
97
+ /// boolean); `None` when absent.
98
+ pub(crate) fn header<T: DeserializeOwned>(
99
+ headers: &HeaderMap,
100
+ name: &str,
101
+ ) -> Result<Option<T>, Error> {
102
+ let Some(value) = headers.get(name) else {
103
+ return Ok(None);
104
+ };
105
+ let text = value
106
+ .to_str()
107
+ .map_err(|_| Error::decode(format!("the {name} header is not text")))?;
108
+ serde_json::from_value(serde_json::Value::String(text.to_owned()))
109
+ .or_else(|_| serde_json::from_str(text))
110
+ .map(Some)
111
+ .map_err(|e| Error::decode(format!("the {name} header: {e}")))
112
+ }
113
+
114
+ /// The required response header `name`; its absence is a decode error.
115
+ pub(crate) fn required_header<T: DeserializeOwned>(
116
+ headers: &HeaderMap,
117
+ name: &str,
118
+ ) -> Result<T, Error> {
119
+ header(headers, name)?.ok_or_else(|| Error::decode(format!("the {name} header is missing")))
120
+ }
@@ -0,0 +1,80 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ //! The credential: the token a call sends, refreshed once for concurrent 401s; and the v4 ids an
3
+ //! `X-Request-Id` and an `Idempotency-Key` take (G9: no uuid crate).
4
+
5
+ use std::collections::hash_map::RandomState;
6
+ use std::hash::{BuildHasher, Hasher};
7
+ use std::sync::atomic::{AtomicU64, Ordering};
8
+ use std::time::{SystemTime, UNIX_EPOCH};
9
+
10
+ use tokio::sync::Mutex;
11
+
12
+ use crate::errors::Error;
13
+ use crate::hooks::OnAuthExpiredHook;
14
+
15
+ /// The current token, so a refreshed one is reused by later calls, behind a lock that makes
16
+ /// concurrent 401s refresh once.
17
+ pub(crate) struct AuthState {
18
+ token: Mutex<Option<String>>,
19
+ }
20
+
21
+ impl AuthState {
22
+ pub(crate) fn new(token: Option<String>) -> Self {
23
+ AuthState {
24
+ token: Mutex::new(token.filter(|t| !t.is_empty())),
25
+ }
26
+ }
27
+
28
+ pub(crate) async fn current(&self) -> Option<String> {
29
+ self.token.lock().await.clone()
30
+ }
31
+
32
+ /// The token to retry with: another call's fresh one, else the hook's; `None` gives up.
33
+ pub(crate) async fn refresh(
34
+ &self,
35
+ hook: &OnAuthExpiredHook,
36
+ rejected: Option<&str>,
37
+ ) -> Result<Option<String>, Error> {
38
+ let mut token = self.token.lock().await;
39
+ if token.as_deref() != rejected {
40
+ return Ok(token.clone());
41
+ }
42
+ let fresh = hook(rejected.map(str::to_owned))
43
+ .await
44
+ .map_err(|e| Error::AuthExpired(e.to_string()))?
45
+ .filter(|t| !t.is_empty());
46
+ if fresh.is_some() {
47
+ token.clone_from(&fresh);
48
+ }
49
+ Ok(fresh)
50
+ }
51
+ }
52
+
53
+ /// Counts the ids this process made: two never hash the same input.
54
+ static IDS: AtomicU64 = AtomicU64::new(0);
55
+
56
+ /// A random RFC 4122 version 4 id, lower case, from the standard library's randomly keyed hasher.
57
+ pub(crate) fn new_v4() -> String {
58
+ let n = IDS.fetch_add(1, Ordering::Relaxed);
59
+ let nanos = SystemTime::now()
60
+ .duration_since(UNIX_EPOCH)
61
+ .map_or(0, |d| d.as_nanos());
62
+ let mut b = [0u8; 16];
63
+ for (i, half) in b.chunks_mut(8).enumerate() {
64
+ let mut h = RandomState::new().build_hasher();
65
+ h.write_u64(n);
66
+ h.write_u128(nanos);
67
+ h.write_usize(i);
68
+ half.copy_from_slice(&h.finish().to_le_bytes());
69
+ }
70
+ b[6] = (b[6] & 0x0f) | 0x40;
71
+ b[8] = (b[8] & 0x3f) | 0x80;
72
+ let mut out = String::with_capacity(36);
73
+ for (i, byte) in b.iter().enumerate() {
74
+ if matches!(i, 4 | 6 | 8 | 10) {
75
+ out.push('-');
76
+ }
77
+ out.push_str(&format!("{byte:02x}"));
78
+ }
79
+ out
80
+ }
@@ -0,0 +1,150 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ //! A request body a method takes as bytes (G4): bytes in memory, or a stream sent as it is read.
3
+
4
+ use bytes::Bytes;
5
+
6
+ /// A binary request body. Bytes in memory are sent again on an auth retry and seen by the
7
+ /// `on_request` hooks; a stream is sent once, as it is read, and no hook sees it.
8
+ #[derive(Debug)]
9
+ pub struct Body(pub(crate) Content);
10
+
11
+ #[derive(Debug)]
12
+ pub(crate) enum Content {
13
+ Bytes(Bytes),
14
+ Stream(reqwest::Body),
15
+ }
16
+
17
+ impl Body {
18
+ /// A body read from `stream` while it is sent.
19
+ pub fn from_stream<S>(stream: S) -> Self
20
+ where
21
+ S: futures_util::TryStream + Send + 'static,
22
+ S::Error: Into<Box<dyn std::error::Error + Send + Sync>>,
23
+ Bytes: From<S::Ok>,
24
+ {
25
+ Body(Content::Stream(reqwest::Body::wrap_stream(stream)))
26
+ }
27
+
28
+ /// The bytes of an in-memory body; `None` for a stream.
29
+ pub fn as_bytes(&self) -> Option<&[u8]> {
30
+ match &self.0 {
31
+ Content::Bytes(b) => Some(b),
32
+ Content::Stream(_) => None,
33
+ }
34
+ }
35
+ }
36
+
37
+ impl From<Bytes> for Body {
38
+ fn from(b: Bytes) -> Self {
39
+ Body(Content::Bytes(b))
40
+ }
41
+ }
42
+
43
+ impl From<Vec<u8>> for Body {
44
+ fn from(v: Vec<u8>) -> Self {
45
+ Body(Content::Bytes(Bytes::from(v)))
46
+ }
47
+ }
48
+
49
+ impl From<&'static [u8]> for Body {
50
+ fn from(s: &'static [u8]) -> Self {
51
+ Body(Content::Bytes(Bytes::from_static(s)))
52
+ }
53
+ }
54
+
55
+ impl From<String> for Body {
56
+ fn from(s: String) -> Self {
57
+ Body(Content::Bytes(Bytes::from(s)))
58
+ }
59
+ }
60
+
61
+ /// A file part of a multipart body: its file name, its media type (`application/octet-stream` when
62
+ /// `None`) and its bytes, held in memory so an auth retry sends the body again.
63
+ #[derive(Debug, Clone, Default, PartialEq, Eq)]
64
+ pub struct FilePart {
65
+ pub filename: String,
66
+ pub content_type: Option<String>,
67
+ pub data: Vec<u8>,
68
+ }
69
+
70
+ /// `s` as a quoted-string's text in a part header: `"`, CR and LF percent-encoded (WHATWG).
71
+ #[allow(dead_code)]
72
+ fn quoted(s: &str) -> String {
73
+ s.replace('"', "%22")
74
+ .replace('\r', "%0D")
75
+ .replace('\n', "%0A")
76
+ }
77
+
78
+ /// A `multipart/form-data` body, encoded part by part as a method adds them. Only an API with a
79
+ /// multipart operation calls it, hence the `dead_code` allows.
80
+ #[allow(dead_code)]
81
+ pub(crate) struct Multipart {
82
+ boundary: String,
83
+ out: Vec<u8>,
84
+ pub(crate) failed: Option<String>,
85
+ }
86
+
87
+ #[allow(dead_code)]
88
+ impl Multipart {
89
+ pub(crate) fn new() -> Self {
90
+ Multipart {
91
+ boundary: format!("honey-{}", crate::auth::new_v4()),
92
+ out: Vec::new(),
93
+ failed: None,
94
+ }
95
+ }
96
+
97
+ fn head(&mut self, disposition: &str, content_type: Option<&str>) {
98
+ let mut head = format!(
99
+ "--{}\r\nContent-Disposition: form-data; {disposition}\r\n",
100
+ self.boundary
101
+ );
102
+ if let Some(media) = content_type {
103
+ head.push_str(&format!("Content-Type: {media}\r\n"));
104
+ }
105
+ head.push_str("\r\n");
106
+ self.out.extend_from_slice(head.as_bytes());
107
+ }
108
+
109
+ /// The text parts of `value`: one per list item, none for `None`.
110
+ pub(crate) fn text<T: serde::Serialize + ?Sized>(&mut self, name: &str, value: &T) {
111
+ let value = match crate::query::to_value(value) {
112
+ Ok(v) => v,
113
+ Err(e) => {
114
+ self.failed.get_or_insert(format!("part {name:?}: {e}"));
115
+ return;
116
+ }
117
+ };
118
+ for text in crate::query::texts(&value) {
119
+ self.head(&format!("name=\"{}\"", quoted(name)), None);
120
+ self.out.extend_from_slice(text.as_bytes());
121
+ self.out.extend_from_slice(b"\r\n");
122
+ }
123
+ }
124
+
125
+ /// A file part for each of `files` (an `Option<FilePart>`, a `Vec<FilePart>`).
126
+ pub(crate) fn files<'a>(&mut self, name: &str, files: impl IntoIterator<Item = &'a FilePart>) {
127
+ for file in files {
128
+ let disposition = format!(
129
+ "name=\"{}\"; filename=\"{}\"",
130
+ quoted(name),
131
+ quoted(&file.filename)
132
+ );
133
+ let media = file
134
+ .content_type
135
+ .as_deref()
136
+ .unwrap_or("application/octet-stream");
137
+ self.head(&disposition, Some(media));
138
+ self.out.extend_from_slice(&file.data);
139
+ self.out.extend_from_slice(b"\r\n");
140
+ }
141
+ }
142
+
143
+ /// The encoded body and its content type.
144
+ pub(crate) fn finish(mut self) -> (Bytes, String) {
145
+ self.out
146
+ .extend_from_slice(format!("--{}--\r\n", self.boundary).as_bytes());
147
+ let media = format!("multipart/form-data; boundary={}", self.boundary);
148
+ (Bytes::from(self.out), media)
149
+ }
150
+ }
@@ -0,0 +1,200 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ //! A method's call (Fb1): `.await` sends it (`IntoFuture`). The method copies its arguments into
3
+ //! the request up front and holds the client's `Arc`, so a `Call` borrows nothing: it can be stored,
4
+ //! moved or spawned. The overrides apply to this call alone. `S` is the client's style: `Throw`
5
+ //! resolves `Result<T, Error>`, `Safe` (`Client::safe`) `Result<Answer<T>, Error>`.
6
+
7
+ use std::future::{Future, IntoFuture};
8
+ use std::marker::PhantomData;
9
+ use std::pin::Pin;
10
+ use std::sync::Arc;
11
+ use std::time::Duration;
12
+
13
+ use bytes::Bytes;
14
+ use futures_util::FutureExt;
15
+ use futures_util::future::Shared;
16
+ use reqwest::header::HeaderMap;
17
+
18
+ use crate::config::{Client, Inner};
19
+ use crate::errors::Error;
20
+ use crate::request::RequestSpec;
21
+ use crate::result::{Failed, SafeError, Style, Throw};
22
+
23
+ /// A boxed future a `Call` resolves through.
24
+ pub(crate) type BoxFuture<T> = Pin<Box<dyn Future<Output = T> + Send + 'static>>;
25
+
26
+ /// A call's cancel signal, shared with the stream, socket or connection it opens.
27
+ pub(crate) type Signal = Shared<BoxFuture<()>>;
28
+
29
+ /// What a call's run resolves to: the answer and its response, or how it failed.
30
+ pub(crate) type Sent<T> = BoxFuture<Result<(T, RawResponse), Failed>>;
31
+
32
+ /// How a call is sent and its answer read: a regular decoder, a stream's open or a socket's dial.
33
+ pub(crate) type Run<T> = Box<dyn FnOnce(Arc<Inner>, RequestSpec, Overrides) -> Sent<T> + Send>;
34
+
35
+ /// The answer a call was read from: its status, the URL it came from (the last of any redirects),
36
+ /// its headers, and its body (empty for a stream).
37
+ #[derive(Debug, Clone)]
38
+ pub struct RawResponse {
39
+ pub status: u16,
40
+ pub url: reqwest::Url,
41
+ pub headers: HeaderMap,
42
+ pub body: Bytes,
43
+ }
44
+
45
+ /// An operation's declared response headers, read from a 2xx answer.
46
+ pub trait FromHeaders: Sized {
47
+ fn from_headers(headers: &HeaderMap) -> Result<Self, Error>;
48
+ }
49
+
50
+ /// What one call overrides of its client.
51
+ #[derive(Clone, Default)]
52
+ pub(crate) struct Overrides {
53
+ pub(crate) timeout: Option<Duration>,
54
+ pub(crate) headers: Vec<(String, String)>,
55
+ pub(crate) base_url: Option<String>,
56
+ pub(crate) cancel: Option<Signal>,
57
+ /// the token a realtime dial sends, its 401 the loop's to refresh
58
+ pub(crate) token: Option<Option<String>>,
59
+ }
60
+
61
+ /// One call to the API; `.await` sends it and resolves as its style `S` settles it. `H` is the
62
+ /// operation's typed response headers, which `.with_headers()` reads.
63
+ #[must_use = "a Call sends nothing until it is awaited"]
64
+ pub struct Call<T, S = Throw, H = ()> {
65
+ inner: Arc<Inner>,
66
+ spec: RequestSpec,
67
+ overrides: Overrides,
68
+ cancel: Option<BoxFuture<()>>,
69
+ run: Run<T>,
70
+ style: PhantomData<fn() -> (S, H)>,
71
+ }
72
+
73
+ impl<T, S, H> Call<T, S, H> {
74
+ pub(crate) fn new<C, R>(client: &Client<C>, spec: RequestSpec, run: R) -> Self
75
+ where
76
+ R: FnOnce(Arc<Inner>, RequestSpec, Overrides) -> Sent<T> + Send + 'static,
77
+ {
78
+ Call {
79
+ inner: Arc::clone(&client.inner),
80
+ spec,
81
+ overrides: Overrides::default(),
82
+ cancel: None,
83
+ run: Box::new(run),
84
+ style: PhantomData,
85
+ }
86
+ }
87
+
88
+ /// This call's timeout in place of the client's (zero: none); a stream is bounded by it up to its headers.
89
+ pub fn timeout(mut self, timeout: Duration) -> Self {
90
+ self.overrides.timeout = Some(timeout);
91
+ self
92
+ }
93
+
94
+ /// A header for this call alone, over the client's and the operation's.
95
+ pub fn header(mut self, name: impl Into<String>, value: impl Into<String>) -> Self {
96
+ self.overrides.headers.push((name.into(), value.into()));
97
+ self
98
+ }
99
+
100
+ /// This call's base URL in place of the client's.
101
+ pub fn base_url(mut self, url: impl Into<String>) -> Self {
102
+ self.overrides.base_url = Some(url.into());
103
+ self
104
+ }
105
+
106
+ /// Ends the call with `Error::Canceled` when `signal` completes first. A stream, socket or
107
+ /// realtime connection already open when it completes ends quietly: its reads then end.
108
+ pub fn cancel_on(mut self, signal: impl Future<Output = ()> + Send + 'static) -> Self {
109
+ self.cancel = Some(Box::pin(signal));
110
+ self
111
+ }
112
+
113
+ /// Resolves to the answer and the response it was read from.
114
+ pub fn with_response(self) -> WithResponse<T, S, H> {
115
+ WithResponse(self)
116
+ }
117
+
118
+ fn send(self) -> Sent<T>
119
+ where
120
+ T: Send + 'static,
121
+ {
122
+ let Call {
123
+ inner,
124
+ spec,
125
+ mut overrides,
126
+ cancel,
127
+ run,
128
+ ..
129
+ } = self;
130
+ let signal = cancel.map(FutureExt::shared);
131
+ overrides.cancel.clone_from(&signal);
132
+ let sent = run(inner, spec, overrides);
133
+ match signal {
134
+ None => sent,
135
+ Some(signal) => Box::pin(async move {
136
+ /* the signal first: one already complete sends nothing */
137
+ tokio::select! {
138
+ biased;
139
+ () = signal => Err(Failed::Unanswered(Error::Canceled)),
140
+ answer = sent => answer,
141
+ }
142
+ }),
143
+ }
144
+ }
145
+ }
146
+
147
+ impl<T, S, H: FromHeaders> Call<T, S, H> {
148
+ /// Resolves to the answer and the operation's declared response headers; headers that do not
149
+ /// read fail with the answer, as a body that does not.
150
+ pub fn with_headers(self) -> WithHeaders<T, S, H> {
151
+ WithHeaders(self)
152
+ }
153
+ }
154
+
155
+ impl<T: Send + 'static, S: Style, H: 'static> IntoFuture for Call<T, S, H> {
156
+ type Output = S::Out<T>;
157
+ type IntoFuture = BoxFuture<S::Out<T>>;
158
+
159
+ fn into_future(self) -> Self::IntoFuture {
160
+ let sent = self.send();
161
+ Box::pin(async move { S::settle(sent.await) })
162
+ }
163
+ }
164
+
165
+ /// A `Call` resolving to `(T, RawResponse)`.
166
+ #[must_use = "a Call sends nothing until it is awaited"]
167
+ pub struct WithResponse<T, S = Throw, H = ()>(Call<T, S, H>);
168
+
169
+ impl<T: Send + 'static, S: Style, H: 'static> IntoFuture for WithResponse<T, S, H> {
170
+ type Output = S::Out<(T, RawResponse)>;
171
+ type IntoFuture = BoxFuture<Self::Output>;
172
+
173
+ fn into_future(self) -> Self::IntoFuture {
174
+ let sent = self.0.send();
175
+ Box::pin(async move { S::settle(sent.await.map(|(t, raw)| ((t, raw.clone()), raw))) })
176
+ }
177
+ }
178
+
179
+ /// A `Call` resolving to `(T, H)`.
180
+ #[must_use = "a Call sends nothing until it is awaited"]
181
+ pub struct WithHeaders<T, S, H>(Call<T, S, H>);
182
+
183
+ impl<T: Send + 'static, S: Style, H: FromHeaders + 'static> IntoFuture for WithHeaders<T, S, H> {
184
+ type Output = S::Out<(T, H)>;
185
+ type IntoFuture = BoxFuture<Self::Output>;
186
+
187
+ fn into_future(self) -> Self::IntoFuture {
188
+ let sent = self.0.send();
189
+ Box::pin(async move {
190
+ let read = sent
191
+ .await
192
+ .and_then(|(t, raw)| match H::from_headers(&raw.headers) {
193
+ Ok(h) => Ok(((t, h), raw)),
194
+ Err(Error::Decode(e)) => Err(Failed::answered(SafeError::Decode(e), raw)),
195
+ Err(e) => Err(Failed::Unanswered(e)),
196
+ });
197
+ S::settle(read)
198
+ })
199
+ }
200
+ }