@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,126 @@
1
+ import { csTypeName, pascalWords } from "../shared/lang.js";
2
+ import { enumDecl, enumValues } from "./types-enum.js";
3
+ import { irNames } from "./types-names.js";
4
+ import { fieldsOf, isOpen, recordDecl } from "./types-record.js";
5
+ import { isLiteral, unionDecl } from "./types-union.js";
6
+ export const JSON_ELEMENT = "JsonElement";
7
+ const MAP = "IReadOnlyDictionary<string, ";
8
+ /* deeper than this, a schema is any JSON value */
9
+ const MAX_DEPTH = 12;
10
+ const SCALARS = {
11
+ boolean: "bool",
12
+ integer: "long",
13
+ null: JSON_ELEMENT,
14
+ number: "double",
15
+ string: "string",
16
+ };
17
+ /** A context over `ir`'s components (none without it), with `taken` reserved besides. */
18
+ export function csTypeContext(ir, taken = []) {
19
+ return {
20
+ collections: new Set(),
21
+ decls: new Map(),
22
+ enums: new Set(),
23
+ fieldName: "",
24
+ names: irNames(ir?.schemas ?? {}, taken, declares),
25
+ parentName: "",
26
+ serialized: new Set(),
27
+ unlisted: new Set(),
28
+ };
29
+ }
30
+ /** Whether a scalar is a string or integer enum with a value of its kind: a declared enum. */
31
+ const isEnum = (ir) => enumValues(ir).length > 0;
32
+ /** Whether C# declares a type for a component of `ir`: an enum, a record, a discriminated or const-string union. */
33
+ export function declares(ir) {
34
+ if (ir.kind === "scalar")
35
+ return isEnum(ir);
36
+ if (ir.kind === "object")
37
+ return ir.fields.length > 0 || ir.additional === false;
38
+ if (ir.kind === "allOf")
39
+ return ir.parts.length > 0 && ir.parts.every((p) => p.kind === "object" || p.kind === "ref");
40
+ if (ir.kind !== "union" || ir.variants.length === 0)
41
+ return false;
42
+ return ir.discriminator !== undefined || ir.variants.every(isLiteral);
43
+ }
44
+ /** `ir` declared once as `names.hoist(key, base)` into `at.decls`; its name. */
45
+ function declare(ir, at, key, base) {
46
+ const name = at.names.hoist(key, base);
47
+ if (!at.decls.has(name)) {
48
+ /* claimed before its body: what the body hoists in turn comes after it */
49
+ at.decls.set(name, "");
50
+ at.decls.set(name, csTopLevel(name, ir, at));
51
+ }
52
+ return name;
53
+ }
54
+ /** `ir` hoisted as `<Parent><Field>`. */
55
+ const hoist = (ir, at) => declare(ir, at, `${at.parentName}.${at.fieldName}`, `${csTypeName(at.parentName)}${pascalWords(at.fieldName)}`);
56
+ const deeper = (at, fieldName = at.fieldName) => ({ ...at, depth: at.depth + 1, fieldName });
57
+ /** A const's C# type: its value's, a declared `number` making an integral value double. */
58
+ function constType({ type, value }) {
59
+ if (typeof value === "number")
60
+ return type === "number" || !Number.isInteger(value) ? "double" : "long";
61
+ return typeof value === "boolean" ? "bool" : "string";
62
+ }
63
+ /** A collection of `item`, noted for the JSON context's strict converters. */
64
+ function collection(open, item, at) {
65
+ const type = `${open}${item}>`;
66
+ at.collections.add(type);
67
+ return type;
68
+ }
69
+ function objectUse(ir, at) {
70
+ if (ir.fields.length > 0)
71
+ return hoist(ir, at);
72
+ if (ir.additional)
73
+ return collection(MAP, use(ir.additional, deeper(at)), at);
74
+ return ir.additional === false ? JSON_ELEMENT : `${MAP}${JSON_ELEMENT}>`;
75
+ }
76
+ /** An allOf of one part is that part; of more, its first ref (the rest is not typed here), else any JSON value. */
77
+ function allOfUse(ir, at) {
78
+ const part = ir.parts.length === 1 ? ir.parts[0] : ir.parts.find((p) => p.kind === "ref");
79
+ return part === undefined ? JSON_ELEMENT : use(part, at);
80
+ }
81
+ /** `T?`, but JsonElement stays JsonElement: it holds null itself. */
82
+ function nullableUse(ir, at) {
83
+ const inner = use(ir.inner, deeper(at));
84
+ return inner === JSON_ELEMENT ? JSON_ELEMENT : `${inner.replace(/\?$/, "")}?`;
85
+ }
86
+ /** A declared component's name, or the use type of one that declares nothing. */
87
+ function refUse(ir, at) {
88
+ const aliased = at.names.alias(ir.name);
89
+ return aliased === undefined ? at.names.ref(ir.name) : use(aliased, deeper(at));
90
+ }
91
+ const USES = {
92
+ allOf: allOfUse,
93
+ array: (ir, at) => collection("IReadOnlyList<", use(ir.items, deeper(at, `${at.fieldName}Item`)), at),
94
+ binary: () => "string",
95
+ const: constType,
96
+ nullable: nullableUse,
97
+ object: objectUse,
98
+ ref: refUse,
99
+ scalar: (ir, at) => (isEnum(ir) ? hoist(ir, at) : SCALARS[ir.type]),
100
+ tuple: () => `IReadOnlyList<${JSON_ELEMENT}>`,
101
+ /* a union in use position is any JSON value; a component union is declared (Fb7) */
102
+ union: () => JSON_ELEMENT,
103
+ unknown: () => JSON_ELEMENT,
104
+ };
105
+ function use(ir, at) {
106
+ return at.depth > MAX_DEPTH ? JSON_ELEMENT : USES[ir.kind](ir, at);
107
+ }
108
+ /** The C# type of `ir` in use position; what it hoists lands in `at.decls`. */
109
+ export function csTypeOf(ir, at) {
110
+ return use(ir, { ...at, depth: 0 });
111
+ }
112
+ /** The use positions inside the declaration of `name`. */
113
+ const memberOf = (name, at) => (schema, fieldName) => use(schema, { ...at, depth: 0, fieldName, parentName: name });
114
+ /** The top-level declaration of the type `name` (a C# name already) for `ir`, which `declares`. */
115
+ export function csTopLevel(name, ir, at) {
116
+ const member = memberOf(name, at);
117
+ if (ir.kind === "scalar")
118
+ return enumDecl(name, ir, at);
119
+ const open = isOpen(ir, at.names.resolve);
120
+ if (ir.kind === "object")
121
+ return recordDecl(name, { fields: ir.fields, open }, member, at);
122
+ if (ir.kind === "allOf")
123
+ return recordDecl(name, { fields: fieldsOf(ir, at.names.resolve), open }, member, at);
124
+ const variant = (schema, key, base) => declare(schema, at, key, base);
125
+ return unionDecl(name, ir, { at, declare: variant, member });
126
+ }
@@ -0,0 +1,20 @@
1
+ /**
2
+ * A WebSocket operation's answer (contract 50 §2, Fd5): `Task<TypedWebSocket>` through `SocketAsync`, opened by
3
+ * awaiting the method and dialed offering `protocols`, its `reconnectToken` sent as one query param only when set and
4
+ * non-empty; a declared `reconnect_token` query param is folded into that field.
5
+ */
6
+ import type { CsStream } from "./sdk-answer.ts";
7
+ /** The subprotocols a WebSocket or realtime dial offers. */
8
+ export declare const PROTOCOLS: {
9
+ ident: string;
10
+ type: string;
11
+ };
12
+ /** The resume cursor's token, which the WebSocket and realtime methods take. */
13
+ export declare const RECONNECT_TOKEN: {
14
+ ident: string;
15
+ type: string;
16
+ };
17
+ /** Whether a declared param is the `reconnect_token` query param, the resume channel a socket dial sends. */
18
+ export declare const isReconnectToken: (name: string, where: string) => boolean;
19
+ /** The WebSocket operation's answer, its two fields and its `<returns>` text. */
20
+ export declare const wsStream: CsStream;
@@ -0,0 +1,14 @@
1
+ /** The subprotocols a WebSocket or realtime dial offers. */
2
+ export const PROTOCOLS = { ident: "protocols", type: "IReadOnlyList<string>?" };
3
+ /** The resume cursor's token, which the WebSocket and realtime methods take. */
4
+ export const RECONNECT_TOKEN = { ident: "reconnectToken", type: "string?" };
5
+ /** Whether a declared param is the `reconnect_token` query param, the resume channel a socket dial sends. */
6
+ export const isReconnectToken = (name, where) => where === "query" && name === "reconnect_token";
7
+ /** The WebSocket operation's answer, its two fields and its `<returns>` text. */
8
+ export const wsStream = {
9
+ answer: () => ({ render: () => ["Task<TypedWebSocket>", "SocketAsync"], type: null }),
10
+ args: ["protocols", "reconnectToken"],
11
+ carries: isReconnectToken,
12
+ fields: [PROTOCOLS, RECONNECT_TOKEN],
13
+ returns: "The open socket: a refused handshake throws its status's exception; the token, CloseAsync or DisposeAsync ends it.",
14
+ };
@@ -0,0 +1,7 @@
1
+ import { type SdkModel } from "../../ir/sdk-model.ts";
2
+ import { type GoTypeContext } from "./types.ts";
3
+ /**
4
+ * The `const ( … )` block of every key `model`'s operations declare, `Err<Key>` claimed in code-unit
5
+ * order (a collision gets `…2`), each `<Key>Data` hoisted into `at.decls`; `""` when none declares one.
6
+ */
7
+ export declare function goErrorKeys(model: SdkModel, at: GoTypeContext): string;
@@ -0,0 +1,44 @@
1
+ import { irErrorEnvelope } from "../../ir/sdk-model.js";
2
+ import { goString, lineComment } from "../shared/escape.js";
3
+ import { compareCodeUnits, goExported } from "../shared/lang.js";
4
+ import { goTopLevel } from "./types.js";
5
+ /** Every declared key's schema (the first operation's to declare one), keys in code-unit order. */
6
+ function declaredKeys(model) {
7
+ const declared = model.ops.flatMap((op) => Object.entries(op.ir.extensions.errors ?? {}));
8
+ /* reversed, so a key ends on its first declaration */
9
+ const first = new Map(declared.toReversed().map(([key, { schema }]) => [key, schema]));
10
+ return [...first].sort(([a], [b]) => compareCodeUnits(a, b));
11
+ }
12
+ /** What a body carrying `key` decodes into: its component, a new `<Key>Data`, or nothing to name (no schema, the envelope). */
13
+ function bodyType(key, schema, model, at) {
14
+ if (schema === undefined)
15
+ return undefined;
16
+ if (schema.kind === "ref")
17
+ return at.names.ref(schema.name);
18
+ if (irErrorEnvelope(schema, model.resolve) !== null)
19
+ return undefined;
20
+ const name = at.names.claimConst(`${goExported(key)}Data`);
21
+ at.decls.set(name, goTopLevel(name, schema, at));
22
+ return name;
23
+ }
24
+ /**
25
+ * The `const ( … )` block of every key `model`'s operations declare, `Err<Key>` claimed in code-unit
26
+ * order (a collision gets `…2`), each `<Key>Data` hoisted into `at.decls`; `""` when none declares one.
27
+ */
28
+ export function goErrorKeys(model, at) {
29
+ const keys = declaredKeys(model);
30
+ if (keys.length === 0)
31
+ return "";
32
+ const lines = keys.flatMap(([key, schema]) => {
33
+ const constant = at.names.claimConst(`Err${goExported(key)}`);
34
+ const body = bodyType(key, schema, model, at);
35
+ const doc = body === undefined ? [] : [`\t// ${constant}'s body decodes into ${body} (ClientError.DecodeBody).`];
36
+ return [...doc, `\t${constant} ErrorKey = ${goString(key)}`];
37
+ });
38
+ return [
39
+ ...lineComment("The error keys the API declares: errors.Is(err, key) matches a *ClientError carrying key.", "//"),
40
+ "const (",
41
+ ...lines,
42
+ ")",
43
+ ].join("\n");
44
+ }
@@ -0,0 +1,11 @@
1
+ /** What the API needs from the runtime beyond plain HTTP. */
2
+ export type GoRuntimeFeatures = {
3
+ readonly realtime: boolean;
4
+ readonly ws: boolean;
5
+ };
6
+ /** The runtime file names an SDK with `features` ships, in code-unit order. */
7
+ export declare function runtimeFileNames(features: GoRuntimeFeatures): string[];
8
+ /** Whether these features make the SDK depend on `github.com/coder/websocket`. */
9
+ export declare const needsWebSocket: (features: GoRuntimeFeatures) => boolean;
10
+ /** The runtime files an SDK with `features` ships, by file name, read verbatim. */
11
+ export declare function runtimeFiles(features: GoRuntimeFeatures): Record<string, string>;
@@ -0,0 +1,50 @@
1
+ /**
2
+ * The vendored Go runtime, as the files a Go SDK ships (H9/F5): `runtime/go/*.go`, read here and
3
+ * nowhere else, emitted verbatim into the SDK's package. The WebSocket and realtime files — the
4
+ * only ones importing `github.com/coder/websocket` — ship only when the API has such operations,
5
+ * so a plain HTTP SDK depends on the standard library alone. The one reader is the F8 mutation target.
6
+ */
7
+ import { readFileSync } from "node:fs";
8
+ import { compareCodeUnits } from "../shared/lang.js";
9
+ /* every SDK: config, request, auth, redirects, errors, SSE, invalidation */
10
+ const CORE = [
11
+ "auth",
12
+ "body",
13
+ "config",
14
+ "errors",
15
+ "export",
16
+ "hooks",
17
+ "invalidation",
18
+ "log",
19
+ "nullable",
20
+ "options",
21
+ "path",
22
+ "query",
23
+ "redirect",
24
+ "request",
25
+ "result",
26
+ "sse",
27
+ "stale",
28
+ "stream",
29
+ ];
30
+ /* a WebSocket operation; realtime adds the resumable transports on top of it */
31
+ const WS = ["ws"];
32
+ const REALTIME = ["realtime", "realtime_loop", "transport", "transport_longpoll", "transport_sse"];
33
+ /** The runtime file names an SDK with `features` ships, in code-unit order. */
34
+ export function runtimeFileNames(features) {
35
+ const names = [...CORE];
36
+ if (features.ws || features.realtime)
37
+ names.push(...WS);
38
+ if (features.realtime)
39
+ names.push(...REALTIME);
40
+ return names.map((name) => `${name}.go`).sort(compareCodeUnits);
41
+ }
42
+ /** Whether these features make the SDK depend on `github.com/coder/websocket`. */
43
+ export const needsWebSocket = (features) => features.ws || features.realtime;
44
+ /** The runtime files an SDK with `features` ships, by file name, read verbatim. */
45
+ export function runtimeFiles(features) {
46
+ return Object.fromEntries(runtimeFileNames(features).map((name) => [
47
+ name,
48
+ readFileSync(new URL(`../../runtime/go/${name}`, import.meta.url), "utf8"),
49
+ ]));
50
+ }
@@ -0,0 +1 @@
1
+ export { type GeneratedGoSdk, generateGoSdk, type GoSdkOptions } from "./sdk.ts";
@@ -0,0 +1 @@
1
+ export { generateGoSdk } from "./sdk.js";
@@ -0,0 +1,2 @@
1
+ /** `modulePath` with the major suffix `version` gives from v2 on, each refused unless Go would take it. */
2
+ export declare function goModulePath(modulePath: string, version: string | undefined): string;
@@ -0,0 +1,27 @@
1
+ /**
2
+ * A Go module's path (plan 39 8.5), as the SDK and the CLI take it: refused unless `go mod init` would take it, and
3
+ * given its major version suffix by a `version`. Go puts a v2-or-later module's major version at the end of its path
4
+ * (`/v2`), and reads any last element `v` plus digits and dots as one, refusing it below v2, with a leading zero or
5
+ * with a dot (module.SplitPathVersion). With a version, the path given is the base and the suffix is the version's,
6
+ * so the two can never disagree.
7
+ */
8
+ import { checked, SEMVER } from "../shared/metadata.js";
9
+ /* a dotted domain, then path elements (Go's module.CheckPath, less its rarely used characters) */
10
+ const MODULE_PATH = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)+(?:\/[A-Za-z0-9_~-](?:[A-Za-z0-9._~-]*[A-Za-z0-9_~-])?)*$/;
11
+ /* a last element Go reads as a major version suffix, and the ones it takes */
12
+ const SUFFIX = /\/v[\d.]+$/;
13
+ const MAJOR = /\/v(?:[2-9]|[1-9]\d+)$/;
14
+ /** `modulePath` with the major suffix `version` gives from v2 on, each refused unless Go would take it. */
15
+ export function goModulePath(modulePath, version) {
16
+ checked("modulePath", modulePath, MODULE_PATH);
17
+ const suffixed = SUFFIX.test(modulePath);
18
+ if (suffixed && !MAJOR.test(modulePath))
19
+ throw new Error(`Invalid modulePath: ${JSON.stringify(modulePath)}: Go's major suffix is /vN from v2, as /v2`);
20
+ checked("version", version, SEMVER);
21
+ if (version === undefined)
22
+ return modulePath;
23
+ if (suffixed)
24
+ throw new Error(`Invalid modulePath: ${JSON.stringify(modulePath)}: the version gives its major suffix`);
25
+ const major = Number(version.split(".")[0]);
26
+ return major >= 2 ? `${modulePath}/v${major}` : modulePath;
27
+ }
@@ -0,0 +1,28 @@
1
+ /**
2
+ * How a Go method answers (G1, F1): a JSON body decoded into `*T`, a binary one as `[]byte`, a text
3
+ * one as `string`; an operation without a body `error` alone. A streaming operation answers as its
4
+ * `GoStream` says (`sse.ts`, `ws.ts`). Its `Client.Safe()` twin answers the same in a `Result` (`sdk-method.ts`).
5
+ */
6
+ import type { SdkResponseKind } from "../../ir/sdk-model.ts";
7
+ import type { StreamOpts } from "./sdk-opts.ts";
8
+ /** How a method answers: its return types, the values it fails with, and the statements that send `c` from the `*Client` at `client`. */
9
+ export type Shape = {
10
+ readonly returns: string;
11
+ readonly fail: string;
12
+ readonly tail: (client: string) => string[];
13
+ };
14
+ /** What a streaming operation's method is: how it answers, what its Opts add, and the note its godoc ends on. */
15
+ export type GoStream = {
16
+ readonly shape: Shape;
17
+ readonly opts: StreamOpts;
18
+ readonly doc: string;
19
+ };
20
+ /** The runtime call's arguments: the ctx, the client's config, the call, each of `extra`, then the per-call options. */
21
+ export declare const sendArgs: (client: string, ...extra: string[]) => string;
22
+ /** What the method of an operation that answers once answers: `kind` of `result` (its JSON type). */
23
+ export type Answered = {
24
+ readonly kind: SdkResponseKind;
25
+ readonly result: string | undefined;
26
+ };
27
+ /** The shape of a method answering as `answered`; a JSON answer without a schema has none to decode. */
28
+ export declare function shapeOf(answered: Answered): Shape;
@@ -0,0 +1,41 @@
1
+ /** The runtime call's arguments: the ctx, the client's config, the call, each of `extra`, then the per-call options. */
2
+ export const sendArgs = (client, ...extra) => ["ctx", `${client}.cfg`, "c", ...extra, "reqOpts"].join(", ");
3
+ /* an operation answering without a body */
4
+ const NO_BODY_SHAPE = {
5
+ fail: "err",
6
+ returns: "error",
7
+ tail: (client) => [
8
+ `\tif _, err := doRequest(${sendArgs(client)}); err != nil {`,
9
+ "\t\treturn err",
10
+ "\t}",
11
+ "\treturn nil",
12
+ ],
13
+ };
14
+ /** The answer of each body kind: JSON decoded into `*T`, binary as the bytes, text as the string. */
15
+ function answerOf(kind, result) {
16
+ if (kind === "binary")
17
+ return { pointer: false, read: "result.body", type: "[]byte", zero: "nil" };
18
+ if (kind === "text")
19
+ return { pointer: false, read: "string(result.body)", type: "string", zero: '""' };
20
+ return { pointer: true, read: `decodeJSON[${result}](result)`, type: result, zero: "nil" };
21
+ }
22
+ /** A method answering once: the answer, an error status or an undecodable one as the error. */
23
+ function valueShape(answer) {
24
+ const fail = `${answer.zero}, err`;
25
+ const done = answer.pointer ? `\treturn ${answer.read}` : `\treturn ${answer.read}, nil`;
26
+ const tail = (client) => [
27
+ `\tresult, err := doRequest(${sendArgs(client)})`,
28
+ "\tif err != nil {",
29
+ `\t\treturn ${fail}`,
30
+ "\t}",
31
+ done,
32
+ ];
33
+ return { fail, returns: `(${answer.pointer ? "*" : ""}${answer.type}, error)`, tail };
34
+ }
35
+ /** The shape of a method answering as `answered`; a JSON answer without a schema has none to decode. */
36
+ export function shapeOf(answered) {
37
+ const { kind, result } = answered;
38
+ if (kind !== "binary" && kind !== "text" && result === undefined)
39
+ return NO_BODY_SHAPE;
40
+ return valueShape(answerOf(kind, result));
41
+ }
@@ -0,0 +1,24 @@
1
+ import type { SdkBody, SdkOp } from "../../ir/sdk-model.ts";
2
+ import { type GoTypeContext } from "./types.ts";
3
+ /** A method's body: its parameter's type, the statements encoding it (failing with `fail`), and the expression the call sends. */
4
+ export type GoBody = {
5
+ readonly type: string;
6
+ readonly lines: (fail: string) => string[];
7
+ readonly send: string;
8
+ /** a multipart body's parts as `<Op>Body` names them: the CLI fills that struct by its fields */
9
+ readonly parts?: readonly GoPart[];
10
+ };
11
+ /** One multipart part: its spec name, its `<Op>Body` field, whether it is a file, whether it repeats. */
12
+ export type GoPart = {
13
+ readonly part: string;
14
+ readonly field: string;
15
+ readonly file: boolean;
16
+ readonly list: boolean;
17
+ };
18
+ /** Where the body lands: the method's body local, and the SDK's type context. */
19
+ export type BodyEnv = {
20
+ readonly local: string;
21
+ readonly at: GoTypeContext;
22
+ };
23
+ /** The body of `op` as its method takes and sends it. */
24
+ export declare function goBody(op: SdkOp, body: SdkBody, env: BodyEnv): GoBody;
@@ -0,0 +1,76 @@
1
+ import { goString, lineComment } from "../shared/escape.js";
2
+ import { goExported, NameScope } from "../shared/lang.js";
3
+ import { goTypeOf } from "./types.js";
4
+ /* a body sent as it is: nothing to encode first */
5
+ const NO_LINES = () => [];
6
+ /* a text part's Go type by its scalar type (v0 codegen-go.ts:382-391); any other schema is sent as a string */
7
+ const PART_SCALARS = {
8
+ boolean: "bool",
9
+ integer: "int64",
10
+ null: "string",
11
+ number: "float64",
12
+ string: "string",
13
+ };
14
+ /** `fields = append(fields, <part>)` at `indent`. */
15
+ const appended = (indent, part) => `${indent}fields = append(fields, ${part})`;
16
+ /** The field of `part` named `name` on the body `local`: a list repeats the part, an unset value sends none. */
17
+ function partField(part, name, local, at) {
18
+ /* the IR gives every part its schema (ir/slots.ts partsOf, sdk-model bodyOf) */
19
+ const schema = at.names.resolve(part.schema);
20
+ const list = schema.kind === "array";
21
+ const item = schema.kind === "array" ? at.names.resolve(schema.items) : schema;
22
+ const key = goString(part.name);
23
+ const field = `${local}.${name}`;
24
+ if (part.type === "file") {
25
+ const sent = (value) => [`if ${value}.Data != nil {`, appended("\t", `fileField(${key}, ${value})`), "}"];
26
+ const lines = list ? [`for _, v := range ${field} {`, ...sent("v").map((line) => `\t${line}`), "}"] : sent(field);
27
+ return { lines, name, type: list ? "[]FilePart" : "FilePart" };
28
+ }
29
+ const scalar = item.kind === "scalar" ? PART_SCALARS[item.type] : "string";
30
+ const lines = list
31
+ ? [`for _, v := range ${field} {`, appended("\t", `textField(${key}, v)`), "}"]
32
+ : [`if ${field} != nil {`, appended("\t", `textField(${key}, *${field})`), "}"];
33
+ return { lines, name, type: list ? `[]${scalar}` : `*${scalar}` };
34
+ }
35
+ /** A multipart body: `<Op>Body` hoisted into the type context, and the statements encoding it as `mp`. */
36
+ function multipartBody(op, parts, env) {
37
+ const type = env.at.names.claimConst(`${goExported(op.id)}Body`);
38
+ const scope = new NameScope();
39
+ const fields = parts.map((part) => partField(part, scope.claim(goExported(part.name)), env.local, env.at));
40
+ const doc = `${type} is the multipart/form-data body of ${op.id}: a nil text part or a file part without Data is not sent.`;
41
+ env.at.decls.set(type, [...lineComment(doc, "//"), `type ${type} struct {`, ...fields.map((f) => `\t${f.name} ${f.type}`), "}"].join("\n"));
42
+ const lines = (fail) => [
43
+ "\tvar fields []multipartField",
44
+ ...fields.flatMap((field) => field.lines.map((line) => `\t${line}`)),
45
+ "\tmp, err := multipartBody(fields)",
46
+ "\tif err != nil {",
47
+ `\t\treturn ${fail}`,
48
+ "\t}",
49
+ ];
50
+ const plan = parts.map((part, i) => ({
51
+ field: fields[i].name,
52
+ file: part.type === "file",
53
+ list: fields[i].type.startsWith("[]"),
54
+ part: part.name,
55
+ }));
56
+ return { lines, parts: plan, send: "mp", type };
57
+ }
58
+ /** The body of `op` as its method takes and sends it. */
59
+ export function goBody(op, body, env) {
60
+ const { local } = env;
61
+ const contentType = goString(body.contentType);
62
+ switch (body.kind) {
63
+ case "json": {
64
+ const type = goTypeOf(body.schema, { ...env.at, fieldName: "Body", parentName: op.id });
65
+ return { lines: NO_LINES, send: `jsonBody(${local})`, type };
66
+ }
67
+ case "form":
68
+ return { lines: NO_LINES, send: `formBody(${local})`, type: "url.Values" };
69
+ case "binary":
70
+ return { lines: NO_LINES, send: `readerBody(${local}, ${contentType})`, type: "io.Reader" };
71
+ case "text":
72
+ return { lines: NO_LINES, send: `rawBody([]byte(${local}), ${contentType})`, type: "string" };
73
+ case "multipart":
74
+ return multipartBody(op, body.parts, env);
75
+ }
76
+ }
@@ -0,0 +1,29 @@
1
+ /**
2
+ * client.go's body (G1): `Client` with one field per top-level namespace of `IR.tree`, a
3
+ * `<Path>Resource` struct per nested namespace, every operation a method on the struct of its
4
+ * namespace, `NewClient` wiring them, and each method's `<Op>Opts` and `<Op>Headers` after them in
5
+ * name order. `Client.Safe()` (bit 21 i3) is the safe mirror (sdk-mirror.ts): `SafeClient` and a
6
+ * `Safe<Path>Resource` per struct, claimed after every normal name so none moves, wired in NewClient. A root
7
+ * member spelled `Safe` is emitted as `Safe_`, and noticed.
8
+ */
9
+ import type { IR } from "../../ir/model.ts";
10
+ import type { SdkOp } from "../../ir/sdk-model.ts";
11
+ import { type GoMethodCall, type MethodEnv } from "./sdk-method.ts";
12
+ /** A method's call plan (G8.4): how to reach it, starting from the client's resource fields. */
13
+ export type GoCallPlan = GoMethodCall & {
14
+ /** the resource fields from the client to the method's receiver: `["Users", "Profile"]` */
15
+ readonly members: readonly string[];
16
+ };
17
+ /** The method env, the operations by id, and the notices the generation reports (a root member renamed for the mirror). */
18
+ export type ClientEnv = MethodEnv & {
19
+ readonly ops: ReadonlyMap<string, SdkOp>;
20
+ readonly notices: string[];
21
+ };
22
+ /**
23
+ * client.go's declarations for `ir` (the client, its resources and methods, then every `<Op>Opts`
24
+ * and `<Op>Headers` in name order), and every method's call plan.
25
+ */
26
+ export declare function clientDecls(ir: IR, env: ClientEnv): {
27
+ readonly decls: string;
28
+ readonly plans: GoCallPlan[];
29
+ };