@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,245 @@
1
+ import { schemaToIR } from "./schema.js";
2
+ import { compareCodeUnits } from "../emit/shared/lang.js";
3
+ /** Splits an OpenAPI path template into literal text and `{param}` pieces. */
4
+ export function parseOpenApiPath(path) {
5
+ const out = [];
6
+ let last = 0;
7
+ for (const match of path.matchAll(/\{([^{}]+)\}/g)) {
8
+ if (match.index > last)
9
+ out.push({ kind: "literal", text: path.slice(last, match.index) });
10
+ out.push({ kind: "param", name: match[1] });
11
+ last = match.index + match[0].length;
12
+ }
13
+ if (last < path.length)
14
+ out.push({ kind: "literal", text: path.slice(last) });
15
+ return out;
16
+ }
17
+ /** The path template's parameter names, once each, in order. */
18
+ export function openApiPathParams(path) {
19
+ return [...new Set(parseOpenApiPath(path).flatMap((seg) => (seg.kind === "param" ? [seg.name] : [])))];
20
+ }
21
+ /** Every request body an operation declares, preferred first. */
22
+ export function bodiesOf(op) {
23
+ return op.bodies ?? (op.body === undefined ? [] : [op.body]);
24
+ }
25
+ /** A parameter, body or response object with its component `$ref` followed; `undefined` for a dangling one. */
26
+ function deref(value, components, depth = 0) {
27
+ const object = value;
28
+ if (typeof object?.$ref !== "string" || depth > 16)
29
+ return object;
30
+ const [root, section, name] = object.$ref.replace(/^#\//, "").split("/");
31
+ const target = root === "components" && section !== undefined && Object.hasOwn(components, section)
32
+ ? components[section]
33
+ : undefined;
34
+ return deref(target !== undefined && name !== undefined && Object.hasOwn(target, name) ? target[name] : undefined, components, depth + 1);
35
+ }
36
+ /** `schema` followed through refs, read from `components`, and nullables, for shape checks only. */
37
+ function shallow(schema, components, depth = 0) {
38
+ if (depth > 16)
39
+ return { kind: "unknown" };
40
+ if (schema.kind === "nullable")
41
+ return shallow(schema.inner, components, depth + 1);
42
+ if (schema.kind !== "ref")
43
+ return schema;
44
+ const schemas = components.schemas ?? {};
45
+ const target = Object.hasOwn(schemas, schema.name) ? schemas[schema.name] : undefined;
46
+ return shallow(schemaToIR(target), components, depth + 1);
47
+ }
48
+ const STRING = { kind: "scalar", type: "string" };
49
+ function paramOf(p) {
50
+ const schema = p.schema;
51
+ const param = {
52
+ name: String(p.name),
53
+ required: p.in === "path" || p.required === true,
54
+ schema: schema === undefined ? STRING : schemaToIR(schema),
55
+ };
56
+ if (typeof p.description === "string")
57
+ param.description = p.description;
58
+ if (p["x-honey-wildcard"] === true)
59
+ param.wildcard = true;
60
+ if (schema?.default !== undefined)
61
+ param.default = schema.default;
62
+ return param;
63
+ }
64
+ /** An operation's parameters, the path item's applying unless the operation declares the same name and place. */
65
+ export function paramsOf(path, op, item, components) {
66
+ const declared = (op.parameters ?? [])
67
+ .map((p) => deref(p, components))
68
+ .filter((p) => p !== undefined);
69
+ for (const p of (item.parameters ?? []).map((q) => deref(q, components))) {
70
+ if (p !== undefined && !declared.some((d) => d.name === p.name && d.in === p.in))
71
+ declared.push(p);
72
+ }
73
+ const by = (place) => declared.filter((p) => p.in === place).map(paramOf);
74
+ const pathParams = by("path");
75
+ /* path params in template order; one the template lacks cannot be sent, one it has but nobody declared is a string */
76
+ const params = {
77
+ header: by("header"),
78
+ path: openApiPathParams(path).map((name) => pathParams.find((p) => p.name === name) ?? { name, required: true, schema: STRING }),
79
+ query: by("query"),
80
+ };
81
+ const cookie = by("cookie");
82
+ if (cookie.length > 0)
83
+ params.cookie = cookie;
84
+ return params;
85
+ }
86
+ /* JSON first, then the structured kinds; other JSON-like types next, then the rest as listed */
87
+ const PREFERENCE = [
88
+ "application/json",
89
+ "application/x-www-form-urlencoded",
90
+ "multipart/form-data",
91
+ "application/octet-stream",
92
+ ];
93
+ const essenceOf = (type) => type.split(";")[0].trim().toLowerCase();
94
+ function rank(type) {
95
+ const essence = essenceOf(type);
96
+ const at = PREFERENCE.indexOf(essence);
97
+ if (at >= 0)
98
+ return at;
99
+ return essence.endsWith("+json") ? PREFERENCE.length : PREFERENCE.length + 1;
100
+ }
101
+ /** `content`'s media types in preference order; ties keep the order the document lists them in. */
102
+ function ordered(content) {
103
+ return Object.keys(content)
104
+ .map((type, at) => ({ at, rank: rank(type), type }))
105
+ .sort((a, b) => a.rank - b.rank || a.at - b.at)
106
+ .map(({ type }) => type);
107
+ }
108
+ /** A multipart form's parts, read from its IR: a binary field, or a list of them, is a file. */
109
+ function partsOf(form, components) {
110
+ const object = shallow(form, components);
111
+ if (object.kind !== "object")
112
+ return [];
113
+ return object.fields.map(({ name, schema }) => {
114
+ const resolved = shallow(schema, components);
115
+ const items = resolved.kind === "array" ? shallow(resolved.items, components) : undefined;
116
+ const file = resolved.kind === "binary" || items?.kind === "binary";
117
+ return { name, schema, type: file ? "file" : "text" };
118
+ });
119
+ }
120
+ function bodyOf(type, media, required, components) {
121
+ const schema = media?.schema;
122
+ const essence = essenceOf(type);
123
+ if (essence === "application/octet-stream")
124
+ return { contentType: "application/octet-stream", kind: "stream", required };
125
+ const ir = schemaToIR(schema);
126
+ const parts = essence === "multipart/form-data" ? partsOf(ir, components) : [];
127
+ if (parts.some((part) => part.type === "file")) {
128
+ return { contentType: "multipart/form-data", kind: "multipart", parts, required, schema: ir };
129
+ }
130
+ return { contentType: type, kind: "raw", required, schema: ir };
131
+ }
132
+ /* a urlencoded form cannot carry a file, so a multipart one with a file part ranks just above it */
133
+ const weight = (body) => body.kind === "multipart" ? rank("application/x-www-form-urlencoded") - 0.5 : rank(body.contentType);
134
+ /** Every request body the operation declares, preferred first. */
135
+ export function requestBodies(op, components) {
136
+ const requestBody = deref(op.requestBody, components);
137
+ const content = (requestBody?.content ?? {});
138
+ return ordered(content)
139
+ .map((type) => bodyOf(type, content[type], requestBody?.required === true, components))
140
+ .sort((a, b) => weight(a) - weight(b));
141
+ }
142
+ /** A response's declared headers (A2), refs followed, in code-unit order; none when it declares none. */
143
+ function responseHeaders(response, components) {
144
+ const declared = Object.entries((response?.headers ?? {})).sort(([a], [b]) => compareCodeUnits(a, b));
145
+ if (declared.length === 0)
146
+ return undefined;
147
+ return declared.map(([name, raw]) => {
148
+ const header = deref(raw, components);
149
+ return { name, required: header?.required === true, schema: schemaToIR(header?.schema) };
150
+ });
151
+ }
152
+ /** The responses by status, each with its preferred media type's schema; and whether any streams events. */
153
+ export function responsesOf(op, components) {
154
+ const responses = {};
155
+ let sse = false;
156
+ for (const [status, raw] of Object.entries((op.responses ?? {}))) {
157
+ const response = deref(raw, components);
158
+ const content = (response?.content ?? {});
159
+ const type = ordered(content)[0];
160
+ const out = { status };
161
+ if (type !== undefined) {
162
+ if (Object.keys(content).some((key) => essenceOf(key) === "text/event-stream"))
163
+ sse = true;
164
+ out.contentType = type;
165
+ const schema = content[type]?.schema;
166
+ if (schema !== undefined)
167
+ out.schema = schemaToIR(schema);
168
+ out.contents = ordered(content).map((contentType) => {
169
+ const each = content[contentType]?.schema;
170
+ return each === undefined ? { contentType } : { contentType, schema: schemaToIR(each) };
171
+ });
172
+ }
173
+ if (response?.["x-honey-error"] === true)
174
+ out.error = true;
175
+ const headers = responseHeaders(response, components);
176
+ if (headers !== undefined)
177
+ out.headers = headers;
178
+ responses[status] = out;
179
+ }
180
+ return { responses, sse };
181
+ }
182
+ /** The honey extensions: each only when it is literally `true`; invalidation targets as strings. */
183
+ export function extensionsOf(op, sse) {
184
+ const out = {};
185
+ if (op["x-websocket"] === true)
186
+ out.websocket = true;
187
+ if (op["x-realtime"] === true)
188
+ out.realtime = true;
189
+ if (sse)
190
+ out.sse = true;
191
+ if (op["x-deprecated"] === true || op.deprecated === true)
192
+ out.deprecated = true;
193
+ if (op["x-idempotency-key"] === true)
194
+ out.idempotencyKey = true;
195
+ if (op["x-mcp"] === true)
196
+ out.mcp = true;
197
+ if (typeof op["x-honey-route"] === "string")
198
+ out.route = op["x-honey-route"];
199
+ const invalidate = op["x-invalidate"];
200
+ if (Array.isArray(invalidate))
201
+ out.invalidates = invalidate.filter((target) => typeof target === "string");
202
+ const errors = declaredErrors(op["x-honey-errors"]);
203
+ if (errors !== undefined)
204
+ out.errors = errors;
205
+ return out;
206
+ }
207
+ /** `x-honey-errors` as the IR reads it: each key with a numeric or null status, its schema when it has one. */
208
+ function declaredErrors(raw) {
209
+ if (raw === null || typeof raw !== "object" || Array.isArray(raw))
210
+ return undefined;
211
+ const out = {};
212
+ for (const [key, entry] of Object.entries(raw)) {
213
+ const { schema, status } = (entry ?? {});
214
+ if (status !== null && typeof status !== "number")
215
+ continue;
216
+ out[key] =
217
+ schema !== null && typeof schema === "object" ? { schema: schemaToIR(schema), status } : { status };
218
+ }
219
+ return Object.keys(out).length > 0 ? out : undefined;
220
+ }
221
+ /**
222
+ * The Standard Webhooks event the webhook `name` declares through `x-honey-webhook`, from its JSON
223
+ * body's `{ type, timestamp, data }` envelope; none when unmarked. gen reads documents it did not
224
+ * write: a marked webhook it could not verify into a typed event is refused, never emitted half.
225
+ */
226
+ export function eventOf(name, op, components) {
227
+ const marker = op["x-honey-webhook"];
228
+ if (marker === undefined)
229
+ return undefined;
230
+ const refuse = (reason) => new Error(`x-honey-webhook on webhook ${JSON.stringify(name)}: ${reason}`);
231
+ if (marker !== "standard-webhooks")
232
+ throw refuse(`${JSON.stringify(marker)} is not standard-webhooks`);
233
+ const content = deref(op.requestBody, components)?.content;
234
+ const envelope = deref(content?.["application/json"]?.schema, components);
235
+ const properties = (envelope?.properties ?? {});
236
+ const required = Array.isArray(envelope?.required) ? envelope.required : [];
237
+ const type = properties.type?.const;
238
+ if (typeof type !== "string" ||
239
+ properties.data === undefined ||
240
+ !["type", "timestamp", "data"].every((key) => required.includes(key)))
241
+ throw refuse("the body is not a { type, timestamp, data } envelope");
242
+ if (type !== name)
243
+ throw refuse(`the envelope's type const is ${JSON.stringify(type)}, not the webhook's name`);
244
+ return { data: schemaToIR(properties.data), type };
245
+ }
@@ -0,0 +1,176 @@
1
+ // Code generated by honey. DO NOT EDIT.
2
+
3
+ package cli
4
+
5
+ import (
6
+ "encoding/json"
7
+ "io"
8
+ "net/url"
9
+ "os"
10
+ "path/filepath"
11
+ "strings"
12
+ )
13
+
14
+ // Data declares --data: the body as given, @file to read it from a file, - to read standard input.
15
+ func (p *Params) Data(usage string) {
16
+ p.cmd.Flags().String("data", "", usage+": the body itself, @file to read a file, or - for standard input")
17
+ }
18
+
19
+ // raw is --data's bytes, read from where it names; false when it was not given.
20
+ func (p *Params) raw() ([]byte, bool, error) {
21
+ if !p.cmd.Flags().Changed("data") {
22
+ return nil, false, nil
23
+ }
24
+ given, _ := p.cmd.Flags().GetString("data")
25
+ switch {
26
+ case given == "-":
27
+ raw, err := io.ReadAll(p.cmd.InOrStdin())
28
+ return raw, true, err
29
+ case strings.HasPrefix(given, "@"):
30
+ raw, err := os.ReadFile(given[1:])
31
+ if err != nil {
32
+ return nil, false, Usage("--data: %v", err)
33
+ }
34
+ return raw, true, nil
35
+ }
36
+ return []byte(given), true, nil
37
+ }
38
+
39
+ // missing refuses a call with no body when the operation requires one.
40
+ func (p *Params) missing(required bool) error {
41
+ if required {
42
+ return Usage("%s needs a body: --data, or the body's own flags", p.cmd.CommandPath())
43
+ }
44
+ return nil
45
+ }
46
+
47
+ // JSON decodes the JSON body into dst: --data's object, then each body flag given (by flag name, to
48
+ // its key) over that key. Nothing given leaves dst as it is.
49
+ func (p *Params) JSON(dst any, required bool, fields map[string]string) error {
50
+ raw, given, err := p.raw()
51
+ if err != nil {
52
+ return err
53
+ }
54
+ object := map[string]json.RawMessage{}
55
+ if given && len(fields) > 0 {
56
+ if err := json.Unmarshal(raw, &object); err != nil {
57
+ return Usage("--data: %v", err)
58
+ }
59
+ }
60
+ for flag, key := range fields {
61
+ if values := p.Values(flag); len(values) > 0 {
62
+ object[key], given = p.fieldJSON(flag, values), true
63
+ }
64
+ }
65
+ if !given {
66
+ return p.missing(required)
67
+ }
68
+ if len(fields) > 0 {
69
+ raw, _ = json.Marshal(object)
70
+ }
71
+ if err := json.Unmarshal(raw, dst); err != nil {
72
+ return Usage("--data: %v", err)
73
+ }
74
+ return nil
75
+ }
76
+
77
+ // fieldJSON is a body flag's values as their JSON: a string quoted, any other kind its literal, a
78
+ // list an array of those.
79
+ func (p *Params) fieldJSON(flag string, values []string) json.RawMessage {
80
+ v := p.cmd.Flags().Lookup(flag).Value.(*value)
81
+ one := func(raw string) json.RawMessage {
82
+ if v.kind == "string" {
83
+ quoted, _ := json.Marshal(raw)
84
+ return quoted
85
+ }
86
+ return json.RawMessage(raw)
87
+ }
88
+ if !v.list {
89
+ return one(values[0])
90
+ }
91
+ items := make([]json.RawMessage, len(values))
92
+ for i, raw := range values {
93
+ items[i] = one(raw)
94
+ }
95
+ array, _ := json.Marshal(items)
96
+ return array
97
+ }
98
+
99
+ // Text is the text body: --data's bytes.
100
+ func (p *Params) Text(required bool) (string, error) {
101
+ raw, given, err := p.raw()
102
+ if err == nil && !given {
103
+ err = p.missing(required)
104
+ }
105
+ return string(raw), err
106
+ }
107
+
108
+ // Reader is the binary body, streamed: standard input, the file --data names, or --data's own bytes.
109
+ func (p *Params) Reader(required bool) (io.Reader, error) {
110
+ if !p.cmd.Flags().Changed("data") {
111
+ return nil, p.missing(required)
112
+ }
113
+ given, _ := p.cmd.Flags().GetString("data")
114
+ switch {
115
+ case given == "-":
116
+ return p.cmd.InOrStdin(), nil
117
+ case strings.HasPrefix(given, "@"):
118
+ file, err := os.Open(given[1:])
119
+ if err != nil {
120
+ return nil, Usage("--data: %v", err)
121
+ }
122
+ return file, nil
123
+ }
124
+ return strings.NewReader(given), nil
125
+ }
126
+
127
+ // Form is the form body: --data as a query string (a=1&b=2), then each body flag given over its key.
128
+ func (p *Params) Form(required bool, fields map[string]string) (url.Values, error) {
129
+ raw, given, err := p.raw()
130
+ if err != nil {
131
+ return nil, err
132
+ }
133
+ form, err := url.ParseQuery(string(raw))
134
+ if err != nil {
135
+ return nil, Usage("--data: %v", err)
136
+ }
137
+ for flag, key := range fields {
138
+ if values := p.Values(flag); len(values) > 0 {
139
+ form[key], given = values, true
140
+ }
141
+ }
142
+ if !given {
143
+ return form, p.missing(required)
144
+ }
145
+ return form, nil
146
+ }
147
+
148
+ // Upload is one file a file part sends: its name and its bytes, streamed as read. Its media type
149
+ // is left to the SDK (application/octet-stream).
150
+ type Upload struct {
151
+ Filename string
152
+ Data io.Reader
153
+ }
154
+
155
+ // FileFlag declares --name, the path of a file a part sends (- for standard input), repeatable
156
+ // when list.
157
+ func (p *Params) FileFlag(name string, list bool, usage string) {
158
+ p.Flag(name, "file", list, false, usage)
159
+ }
160
+
161
+ // Files opens each file --name was given, in order; none when it was not given.
162
+ func (p *Params) Files(name string) ([]Upload, error) {
163
+ var uploads []Upload
164
+ for _, path := range p.Values(name) {
165
+ if path == "-" {
166
+ uploads = append(uploads, Upload{Filename: "stdin", Data: p.cmd.InOrStdin()})
167
+ continue
168
+ }
169
+ file, err := os.Open(path)
170
+ if err != nil {
171
+ return nil, Usage("--%s: %v", name, err)
172
+ }
173
+ uploads = append(uploads, Upload{Filename: filepath.Base(path), Data: file})
174
+ }
175
+ return uploads, nil
176
+ }
@@ -0,0 +1,243 @@
1
+ // Code generated by honey. DO NOT EDIT.
2
+
3
+ package cli
4
+
5
+ import (
6
+ "bytes"
7
+ "errors"
8
+ "fmt"
9
+ "io"
10
+ "io/fs"
11
+ "os"
12
+ "path/filepath"
13
+ "strings"
14
+ "time"
15
+
16
+ "github.com/pelletier/go-toml/v2"
17
+ "github.com/spf13/cobra"
18
+ "github.com/spf13/pflag"
19
+ )
20
+
21
+ // Config is one run's settings, each from its flag, else its environment variable, else the
22
+ // config file, else its default.
23
+ type Config struct {
24
+ APIKey string
25
+ BaseURL string
26
+ Headers map[string]string
27
+ Timeout time.Duration
28
+ Verbose bool
29
+ Quiet bool
30
+ // Redirect is which redirects a call follows: same-origin (the default) or follow
31
+ Redirect string
32
+
33
+ log io.Writer
34
+ secrets []string
35
+ // each setting's source, by its config file key: flag, env, file or default
36
+ sources map[string]string
37
+ // the API's default base URL, the target when no setting names one
38
+ server string
39
+ }
40
+
41
+ // saved is the config file: TOML, an unknown key a usage error.
42
+ type saved struct {
43
+ APIKey string `toml:"api_key"`
44
+ BaseURL string `toml:"base_url"`
45
+ Timeout string `toml:"timeout"`
46
+ Verbose *bool `toml:"verbose"`
47
+ Quiet *bool `toml:"quiet"`
48
+ Redirect string `toml:"redirect"`
49
+ Headers map[string]string `toml:"headers"`
50
+ }
51
+
52
+ // the root annotations holding the environment variables' prefix and the API's default base URL
53
+ const (
54
+ envPrefixKey = "honey.envPrefix"
55
+ serverKey = "honey.server"
56
+ )
57
+
58
+ // globalFlags declares the flags every command takes.
59
+ func globalFlags(root *cobra.Command, app App) {
60
+ env := func(key string) string { return "$" + app.EnvPrefix + "_" + key }
61
+ f := root.PersistentFlags()
62
+ f.String("api-key", "", "the API key ("+env("API_KEY")+")")
63
+ f.String("base-url", "", "the API's base URL ("+env("BASE_URL")+")")
64
+ f.String("config", "", "the config file ("+env("CONFIG")+"; default ~/.config/"+app.Name+"/config.toml)")
65
+ f.Duration("timeout", 0, "bound each call; 0 for 30s ("+env("TIMEOUT")+")")
66
+ f.Bool("verbose", false, "log each request and response to stderr, secrets redacted ("+env("VERBOSE")+")")
67
+ f.BoolP("quiet", "q", false, "no target line on a terminal's stderr ("+env("QUIET")+")")
68
+ f.String("redirect", "", "same-origin (the default) or follow, which also follows a cross-origin redirect without the credentials ("+env("REDIRECT")+")")
69
+ f.StringArray("header", nil, `send a header, "Name: value" (repeatable)`)
70
+ root.Annotations = map[string]string{envPrefixKey: app.EnvPrefix, serverKey: app.Server}
71
+ }
72
+
73
+ // Settings resolves the run's settings for c.
74
+ func Settings(c *cobra.Command) (Config, error) {
75
+ root := c.Root()
76
+ prefix := root.Annotations[envPrefixKey]
77
+ flags := c.Flags()
78
+ file, err := readConfig(flags, prefix, root.Name(), c.ErrOrStderr())
79
+ if err != nil {
80
+ return Config{}, err
81
+ }
82
+ cfg := Config{log: c.ErrOrStderr(), sources: map[string]string{}, server: root.Annotations[serverKey]}
83
+ cfg.APIKey, cfg.sources["api_key"] = pick(flags, "api-key", prefix+"_API_KEY", file.APIKey)
84
+ cfg.BaseURL, cfg.sources["base_url"] = pick(flags, "base-url", prefix+"_BASE_URL", file.BaseURL)
85
+ if cfg.Timeout, cfg.sources["timeout"], err = timeout(flags, prefix, file.Timeout); err != nil {
86
+ return Config{}, err
87
+ }
88
+ if cfg.Verbose, cfg.sources["verbose"], err = boolSetting(flags, "verbose", prefix, file.Verbose); err != nil {
89
+ return Config{}, err
90
+ }
91
+ if cfg.Quiet, cfg.sources["quiet"], err = boolSetting(flags, "quiet", prefix, file.Quiet); err != nil {
92
+ return Config{}, err
93
+ }
94
+ cfg.Redirect, cfg.sources["redirect"] = pick(flags, "redirect", prefix+"_REDIRECT", file.Redirect)
95
+ switch cfg.Redirect {
96
+ case "":
97
+ cfg.Redirect = "same-origin"
98
+ case "same-origin", "follow":
99
+ default:
100
+ return Config{}, Usage("redirect %q: want same-origin or follow", cfg.Redirect)
101
+ }
102
+ if cfg.Headers, cfg.sources["headers"], err = headers(flags, file.Headers); err != nil {
103
+ return Config{}, err
104
+ }
105
+ cfg.secrets = secretsOf(cfg)
106
+ return cfg, nil
107
+ }
108
+
109
+ // redirectOf is the run's redirect setting, resolved again where an error is reported (the config
110
+ // file's warnings are not repeated).
111
+ func redirectOf(c *cobra.Command) string {
112
+ prefix := c.Root().Annotations[envPrefixKey]
113
+ file, _ := readConfig(c.Flags(), prefix, c.Root().Name(), io.Discard)
114
+ redirect, _ := pick(c.Flags(), "redirect", prefix+"_REDIRECT", file.Redirect)
115
+ return redirect
116
+ }
117
+
118
+ // pick is a string setting and its source: its flag when given, else its environment variable
119
+ // when set, else the file's, else none.
120
+ func pick(flags *pflag.FlagSet, name, env, file string) (string, string) {
121
+ if flags.Changed(name) {
122
+ value, _ := flags.GetString(name)
123
+ return value, "flag"
124
+ }
125
+ if value := os.Getenv(env); value != "" {
126
+ return value, "env"
127
+ }
128
+ if file != "" {
129
+ return file, "file"
130
+ }
131
+ return "", "default"
132
+ }
133
+
134
+ func timeout(flags *pflag.FlagSet, prefix, file string) (time.Duration, string, error) {
135
+ if flags.Changed("timeout") {
136
+ d, err := flags.GetDuration("timeout")
137
+ return d, "flag", err
138
+ }
139
+ raw, from, source := os.Getenv(prefix+"_TIMEOUT"), "$"+prefix+"_TIMEOUT", "env"
140
+ if raw == "" {
141
+ raw, from, source = file, "the config file's timeout", "file"
142
+ }
143
+ if raw == "" {
144
+ return 0, "default", nil
145
+ }
146
+ d, err := time.ParseDuration(raw)
147
+ if err != nil {
148
+ return 0, "", Usage("%s: %q is not a duration (30s, 1m)", from, raw)
149
+ }
150
+ return d, source, nil
151
+ }
152
+
153
+ // boolSetting is the boolean setting name and its source: its flag, $<PREFIX>_<NAME>, the file's.
154
+ func boolSetting(flags *pflag.FlagSet, name, prefix string, file *bool) (bool, string, error) {
155
+ if flags.Changed(name) {
156
+ on, err := flags.GetBool(name)
157
+ return on, "flag", err
158
+ }
159
+ env := prefix + "_" + strings.ToUpper(name)
160
+ if raw := os.Getenv(env); raw != "" {
161
+ on, err := parseBool(raw)
162
+ if err != nil {
163
+ return false, "", Usage("$%s: %q is not true or false", env, raw)
164
+ }
165
+ return on, "env", nil
166
+ }
167
+ if file != nil {
168
+ return *file, "file", nil
169
+ }
170
+ return false, "default", nil
171
+ }
172
+
173
+ func parseBool(raw string) (bool, error) {
174
+ switch strings.ToLower(raw) {
175
+ case "1", "true", "yes", "on":
176
+ return true, nil
177
+ case "0", "false", "no", "off":
178
+ return false, nil
179
+ }
180
+ return false, errors.New("not a boolean")
181
+ }
182
+
183
+ // headers is the file's headers, each --header over the one of its name, and their source: flag
184
+ // when any --header is given, else file when the file holds any.
185
+ func headers(flags *pflag.FlagSet, file map[string]string) (map[string]string, string, error) {
186
+ out := map[string]string{}
187
+ source := "default"
188
+ for name, value := range file {
189
+ out[name], source = value, "file"
190
+ }
191
+ given, _ := flags.GetStringArray("header")
192
+ for _, header := range given {
193
+ name, value, ok := strings.Cut(header, ":")
194
+ if !ok || strings.TrimSpace(name) == "" {
195
+ return nil, "", Usage("--header %q: want \"Name: value\"", header)
196
+ }
197
+ out[strings.TrimSpace(name)], source = strings.TrimSpace(value), "flag"
198
+ }
199
+ return out, source, nil
200
+ }
201
+
202
+ // readConfig reads the config file: --config, else $<PREFIX>_CONFIG (each must exist), else the
203
+ // user config dir's <name>/config.toml when there is one.
204
+ func readConfig(flags *pflag.FlagSet, prefix, name string, stderr io.Writer) (saved, error) {
205
+ path, explicit := configPath(flags, prefix, name)
206
+ if path == "" {
207
+ return saved{}, nil
208
+ }
209
+ raw, err := os.ReadFile(path)
210
+ if errors.Is(err, fs.ErrNotExist) && !explicit {
211
+ return saved{}, nil
212
+ }
213
+ if err != nil {
214
+ return saved{}, Usage("config file %s: %v", path, err)
215
+ }
216
+ var file saved
217
+ decoder := toml.NewDecoder(bytes.NewReader(raw))
218
+ decoder.DisallowUnknownFields()
219
+ if err := decoder.Decode(&file); err != nil {
220
+ return saved{}, Usage("config file %s: %v", path, err)
221
+ }
222
+ if info, err := os.Stat(path); err == nil && file.APIKey != "" && info.Mode().Perm()&0o077 != 0 {
223
+ fmt.Fprintf(stderr, "%s: warning: %s holds an API key and others can read it; chmod 600 it\n", name, path)
224
+ }
225
+ return file, nil
226
+ }
227
+
228
+ func configPath(flags *pflag.FlagSet, prefix, name string) (string, bool) {
229
+ if flags.Changed("config") {
230
+ path, _ := flags.GetString("config")
231
+ return path, true
232
+ }
233
+ if path := os.Getenv(prefix + "_CONFIG"); path != "" {
234
+ return path, true
235
+ }
236
+ if dir := os.Getenv("XDG_CONFIG_HOME"); dir != "" {
237
+ return filepath.Join(dir, name, "config.toml"), false
238
+ }
239
+ if home, err := os.UserHomeDir(); err == nil {
240
+ return filepath.Join(home, ".config", name, "config.toml"), false
241
+ }
242
+ return "", false
243
+ }