@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,173 @@
1
+ /**
2
+ * The TypeScript SDK front (F1): `new <Name>(config)` over the vendored runtime. Five files under
3
+ * one stem: the class, the service map it dispatches by, the types it merges with, the runtime
4
+ * verbatim, and the index a consumer imports; a sixth for a document with Standard Webhooks events,
5
+ * `verifyWebhook` on its own so a receiver imports nothing else. Read from the IR alone (H2).
6
+ */
7
+ import { toIR } from "../../ir/build.js";
8
+ import { tsString } from "../shared/escape.js";
9
+ import { compareCodeUnits, words } from "../shared/lang.js";
10
+ import { MIRROR, mirrorNotice } from "../shared/mirror.js";
11
+ import { runtimeFeatures, runtimeSource } from "./http.js";
12
+ import { RESERVED } from "./sdk-types-preamble.js";
13
+ import { sdkTypesText } from "./sdk-types.js";
14
+ import { tanstackQueryText } from "./tanstack-query.js";
15
+ import { memberTree, serviceMapText } from "./service-map.js";
16
+ import { webhooksText, webhookTypeNames } from "./webhooks.js";
17
+ export { sdkMemberPaths, serviceMapOf } from "./service-map.js";
18
+ const IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
19
+ /* the error classes and helpers a consumer imports from the SDK beside the class, by the transport that ships them */
20
+ const RUNTIME_EXPORTS = {
21
+ core: [
22
+ "APIConnectionError",
23
+ "BadGatewayError",
24
+ "BadRequestError",
25
+ "ClientError",
26
+ "ConflictError",
27
+ "DecodeError",
28
+ "ForbiddenError",
29
+ "GatewayTimeoutError",
30
+ "HTTPClient",
31
+ "InternalServerError",
32
+ "isClientError",
33
+ "newClientRequestId",
34
+ "NotFoundError",
35
+ "PathParamError",
36
+ "RateLimitError",
37
+ "ServiceUnavailableError",
38
+ "UnauthorizedError",
39
+ "UnprocessableEntityError",
40
+ ],
41
+ realtime: [
42
+ "createFallbackChain",
43
+ "createKeepaliveLoop",
44
+ "createResumableConnection",
45
+ "RealtimeAbortError",
46
+ "RealtimeConnectError",
47
+ "RealtimeError",
48
+ "RealtimeKickedError",
49
+ ],
50
+ sse: ["parseSSEStream"],
51
+ ws: [],
52
+ };
53
+ const RUNTIME_TYPES = {
54
+ core: ["ClientConfig", "InvalidationConfig", "LogEntry", "RequestOptions", "Result"],
55
+ realtime: [
56
+ "ConnectionState",
57
+ "RealtimeOptions",
58
+ "ResumableConnection",
59
+ "ResumableConnectionOpts",
60
+ "ServerFrame",
61
+ "Transport",
62
+ "TransportAdapter",
63
+ "TransportConnection",
64
+ "TransportOpts",
65
+ ],
66
+ sse: ["SSEEvent"],
67
+ ws: ["TypedWebSocket"],
68
+ };
69
+ /** The names of `lists` a runtime with `features` ships, ignoring case in their order. */
70
+ function shipped(lists, features) {
71
+ const realtime = features.realtime;
72
+ const groups = [lists.core, features.sse || realtime ? lists.sse : [], features.ws || realtime ? lists.ws : []];
73
+ return [...groups, realtime ? lists.realtime : []]
74
+ .flat()
75
+ .sort((a, b) => compareCodeUnits(a.toLowerCase(), b.toLowerCase()));
76
+ }
77
+ /** `TestSDK` → `test-sdk`: the words of the name, lower case, joined by `-`. */
78
+ const kebab = (name) => words(name)
79
+ .map((word) => word.toLowerCase())
80
+ .join("-");
81
+ /**
82
+ * Whether `own` is a name the runtime of any features shares with the index, or one the client file imports and the
83
+ * index re-exports beside the class.
84
+ */
85
+ const runtimeOwns = (own) => ["SDKClient", "schemeAuth", "serviceMap"].includes(own) ||
86
+ [RUNTIME_EXPORTS, RUNTIME_TYPES].some((lists) => Object.values(lists).some((names) => names.includes(own)));
87
+ /** The names the SDK `name` declares: the class, then the types file's three. */
88
+ const ownNames = (name) => [name, `${name}Config`, `${name}Operations`, `${name}Safe`];
89
+ /**
90
+ * Refuses a name whose class or derived types clash with a name the files already use, `taken` saying whose.
91
+ * `${name}Config` may be `SDKConfig`: the types file then imports the runtime's own under another name.
92
+ */
93
+ function refuseClash(name, taken) {
94
+ for (const own of ownNames(name)) {
95
+ if (own === "SDKConfig" && own !== name)
96
+ continue;
97
+ const owner = taken(own);
98
+ if (owner === undefined)
99
+ continue;
100
+ const subject = own === name ? `name ${JSON.stringify(name)} is` : `name ${JSON.stringify(name)} declares ${own}, which is`;
101
+ throw new Error(`generateSdk: ${subject} a name ${owner} already uses; choose another name (--ts-name)`);
102
+ }
103
+ }
104
+ /** The class name lands in source and the stem in import specifiers and file names: both are checked. */
105
+ function validated(options) {
106
+ const { name } = options;
107
+ if (!IDENTIFIER.test(name))
108
+ throw new Error(`generateSdk: name ${JSON.stringify(name)} is not a TypeScript identifier`);
109
+ refuseClash(name, (own) => runtimeOwns(own) ? "the SDK's runtime" : RESERVED.includes(own) ? "the SDK's types" : undefined);
110
+ const stem = options.stem ?? kebab(name);
111
+ if (!/^[A-Za-z0-9_-][A-Za-z0-9._-]*$/.test(stem)) {
112
+ throw new Error(`generateSdk: stem ${JSON.stringify(stem)} must be a plain file name (letters, digits, ".", "_", "-")`);
113
+ }
114
+ return { name, stem };
115
+ }
116
+ /**
117
+ * The class: the runtime's `SDKClient` over the service map, merged with the operations' interface.
118
+ * A config without `baseURL` sends to `server`, the document's first one, when it declares any; its auth header
119
+ * pair defaults to the API's scheme (`auth`), as every sibling SDK's does.
120
+ */
121
+ function clientText(name, stem, server, auth) {
122
+ const based = server === undefined ? "config" : `{ ...config, baseURL: config.baseURL ?? ${tsString(server)} }`;
123
+ const config = `schemeAuth(${based}, ${tsString(auth.headerName)}, ${tsString(auth.prefix)})`;
124
+ return `import { SDKClient, schemeAuth } from "./${stem}.runtime.gen.js"
125
+ import { serviceMap } from "./${stem}.map.gen.js"
126
+ import type { ${name}Config, ${name}Operations, ${name}Safe } from "./${stem}.types.gen.js"
127
+
128
+ export class ${name} extends SDKClient {
129
+ constructor(config: ${name}Config) {
130
+ super(serviceMap, ${config})
131
+ }
132
+ }
133
+
134
+ /* declaration merge: the Proxy-backed class carries the typed operations, and their safe twins */
135
+ export interface ${name} extends ${name}Operations {
136
+ readonly safe: ${name}Safe
137
+ }
138
+ `;
139
+ }
140
+ function indexText(name, stem, features) {
141
+ return `export { ${name} } from "./${stem}.client.gen.js"
142
+ export { serviceMap } from "./${stem}.map.gen.js"
143
+ export type * from "./${stem}.types.gen.js"
144
+ export { ${shipped(RUNTIME_EXPORTS, features).join(", ")} } from "./${stem}.runtime.gen.js"
145
+ export type { ${shipped(RUNTIME_TYPES, features).join(", ")} } from "./${stem}.runtime.gen.js"
146
+ `;
147
+ }
148
+ /** The SDK files for `document`, by file name, and their stem. */
149
+ export function generateSdk(document, options) {
150
+ const { name, stem } = validated(options);
151
+ const ir = toIR(document, { deriveOperationIds: true, duplicateOperationIds: "throw" });
152
+ const events = new Set(webhookTypeNames(ir));
153
+ refuseClash(name, (own) => (events.has(own) ? "the document's webhook events" : undefined));
154
+ const runtime = `${stem}.runtime.gen`;
155
+ const features = runtimeFeatures(ir);
156
+ /* memberTree emits the root groups in code-unit order, each renamed in place */
157
+ const emitted = [...memberTree(ir.tree).entries.keys()];
158
+ const groups = [...ir.tree.entries.keys()].sort(compareCodeUnits);
159
+ const notices = groups.flatMap((group, i) => mirrorNotice("ts", MIRROR, group, emitted[i]) ?? []);
160
+ const files = {
161
+ [`${stem}.client.gen.ts`]: clientText(name, stem, ir.servers[0], ir.auth),
162
+ [`${stem}.index.gen.ts`]: indexText(name, stem, features),
163
+ [`${stem}.map.gen.ts`]: serviceMapText(ir, runtime),
164
+ [`${stem}.runtime.gen.ts`]: runtimeSource(features),
165
+ [`${stem}.types.gen.ts`]: sdkTypesText(ir, name, runtime),
166
+ };
167
+ if (ir.webhooks.some((webhook) => webhook.event))
168
+ files[`${stem}.webhook.gen.ts`] = webhooksText(ir, stem);
169
+ /* the index never names it: its text must not vary by option, and it must never name query-core */
170
+ if (options.tanstackQuery === true)
171
+ files[`${stem}.tanstack-query.gen.ts`] = tanstackQueryText(ir, name, stem);
172
+ return { files, notices, stem, version: ir.info.version };
173
+ }
@@ -0,0 +1,40 @@
1
+ /**
2
+ * Where each operation sits on a generated TS client, and the service map the runtime dispatches
3
+ * by: the resource tree with every member name a client can expose, and one entry per operation.
4
+ */
5
+ import type { IR, IRNamespace } from "../../ir/model.ts";
6
+ /** One operation as the runtime's service map holds it (`runtime/ts/sdk.ts` `ServiceEntry`). */
7
+ export type ServiceEntry = {
8
+ accept?: string;
9
+ /** the operation declares no success body: a 2xx reads as null, its body only through `raw` */
10
+ empty?: true;
11
+ headers?: string[];
12
+ idempotent?: true;
13
+ invalidate?: string[];
14
+ method: string;
15
+ params?: string[];
16
+ path: string;
17
+ realtime?: true;
18
+ /** an event stream; `"json"` when its declared event schema is not a string */
19
+ sse?: "json" | true;
20
+ wildcard?: string;
21
+ ws?: true;
22
+ };
23
+ export type ServiceMapNode = ServiceEntry | {
24
+ [key: string]: ServiceMapNode;
25
+ };
26
+ /**
27
+ * The resource tree with every member name a client can expose, in code-unit order. A name that
28
+ * would shadow a client member or an `Object.prototype` name gets a trailing `_` (`state` →
29
+ * `state_`), the same rename in the types and the service map, so types and runtime agree.
30
+ */
31
+ export declare function memberTree(ns: IRNamespace, root?: boolean): IRNamespace;
32
+ /** The member path of every operation on a generated client, after the renames: `state.get` → `["state_", "get"]`. */
33
+ export declare function sdkMemberPaths(ir: IR): Map<string, string[]>;
34
+ /**
35
+ * The nested service map of `ir`: a dotted id's segments as nested keys, renamed as on the client.
36
+ * Null-prototype nodes: an id of `__proto__.x` must never reach `Object.prototype`.
37
+ */
38
+ export declare function serviceMapOf(ir: IR): Record<string, ServiceMapNode>;
39
+ /** The `${stem}.map.gen.ts` text: the service map as a `const`, importing the adapters its entries name. */
40
+ export declare function serviceMapText(ir: IR, runtime: string): string;
@@ -0,0 +1,171 @@
1
+ import { isJsonMedia, mediaEssence, sdkModel, sseEventSchema, } from "../../ir/sdk-model.js";
2
+ import { openApiPathParams } from "../../ir/slots.js";
3
+ import { tsString } from "../shared/escape.js";
4
+ import { compareCodeUnits } from "../shared/lang.js";
5
+ import { quoteKey } from "../shared/literals.js";
6
+ import { MIRROR } from "../shared/mirror.js";
7
+ /** Members a generated client already has; a resource of the same name would hide them. */
8
+ const ROOT_MEMBERS = ["dispose", MIRROR, "state"];
9
+ /**
10
+ * Names JavaScript machinery reads off any object: a `then` member makes the client a thenable,
11
+ * `toString` breaks `String(sdk)`, `__proto__` sets the prototype.
12
+ */
13
+ const OBJECT_MEMBERS = [
14
+ "__defineGetter__",
15
+ "__defineSetter__",
16
+ "__lookupGetter__",
17
+ "__lookupSetter__",
18
+ "__proto__",
19
+ "constructor",
20
+ "hasOwnProperty",
21
+ "isPrototypeOf",
22
+ "propertyIsEnumerable",
23
+ "then",
24
+ "toJSON",
25
+ "toLocaleString",
26
+ "toString",
27
+ "valueOf",
28
+ ];
29
+ /**
30
+ * The resource tree with every member name a client can expose, in code-unit order. A name that
31
+ * would shadow a client member or an `Object.prototype` name gets a trailing `_` (`state` →
32
+ * `state_`), the same rename in the types and the service map, so types and runtime agree.
33
+ */
34
+ export function memberTree(ns, root = true) {
35
+ const entries = new Map();
36
+ for (const [key, entry] of [...ns.entries].sort(([a], [b]) => compareCodeUnits(a, b))) {
37
+ let name = key;
38
+ if ((root && ROOT_MEMBERS.includes(key)) || OBJECT_MEMBERS.includes(key)) {
39
+ name = `${key}_`;
40
+ while (ns.entries.has(name) || entries.has(name))
41
+ name += "_";
42
+ }
43
+ entries.set(name, entry.kind === "namespace" ? { kind: "namespace", ns: memberTree(entry.ns, false) } : entry);
44
+ }
45
+ return { entries };
46
+ }
47
+ /** The member path of every operation on a generated client, after the renames: `state.get` → `["state_", "get"]`. */
48
+ export function sdkMemberPaths(ir) {
49
+ const out = new Map();
50
+ const walk = (ns, prefix) => {
51
+ for (const [key, entry] of ns.entries) {
52
+ if (entry.kind === "namespace")
53
+ walk(entry.ns, [...prefix, key]);
54
+ else
55
+ out.set(entry.op.id, [...prefix, key]);
56
+ }
57
+ };
58
+ walk(memberTree(ir.tree), []);
59
+ return out;
60
+ }
61
+ /** The media type a call asks for: the declared one when the answer is neither JSON nor an event stream. */
62
+ function acceptOf(op, contentType) {
63
+ if (contentType === undefined || op.extensions.sse === true || isJsonMedia(contentType))
64
+ return undefined;
65
+ return mediaEssence(contentType);
66
+ }
67
+ /** The response headers the success answer declares, lower case and sorted (A2). */
68
+ function headersOf(op, status) {
69
+ const declared = op.responses[status]?.headers ?? [];
70
+ return [...new Set(declared.map(({ name }) => name.toLowerCase()))].sort(compareCodeUnits);
71
+ }
72
+ /** The service entry of `op`; `success` is its success answer as the SDK model reads it. */
73
+ function entryOf(op, success, resolve) {
74
+ const entry = { method: op.method, path: op.path };
75
+ const params = openApiPathParams(op.path);
76
+ if (params.length > 0)
77
+ entry.params = params;
78
+ const wildcard = op.params.path.find((p) => p.wildcard === true);
79
+ if (wildcard)
80
+ entry.wildcard = wildcard.name;
81
+ if (op.extensions.sse)
82
+ entry.sse = sseEventSchema(op, resolve) === undefined ? true : "json";
83
+ if (op.extensions.websocket)
84
+ entry.ws = true;
85
+ if (op.extensions.realtime)
86
+ entry.realtime = true;
87
+ if (op.extensions.idempotencyKey)
88
+ entry.idempotent = true;
89
+ const invalidate = op.extensions.invalidates;
90
+ if (invalidate && invalidate.length > 0)
91
+ entry.invalidate = [...invalidate];
92
+ const accept = acceptOf(op, success.contentType);
93
+ if (accept !== undefined)
94
+ entry.accept = accept;
95
+ if (success.kind === "none" && !entry.sse && !entry.ws)
96
+ entry.empty = true;
97
+ const headers = headersOf(op, success.status);
98
+ if (headers.length > 0)
99
+ entry.headers = headers;
100
+ return entry;
101
+ }
102
+ /** The runtime adapter each non-REST transport is called through (`runtime/ts/sdk-*.ts`). */
103
+ const OPERATION_CALLS = {
104
+ realtime: "realtimeOp",
105
+ sse: "sseOp",
106
+ ws: "wsOp",
107
+ };
108
+ /** A name the map text writes bare: an entry's adapter, imported from the runtime. */
109
+ class Identifier {
110
+ name;
111
+ constructor(name) {
112
+ this.name = name;
113
+ }
114
+ }
115
+ /** The nested map of `ir`, each entry with its adapter's `call` when `calls`. */
116
+ function mapOf(ir, calls) {
117
+ const model = sdkModel(ir);
118
+ const ops = model.opsById;
119
+ const walk = (ns) => {
120
+ const node = Object.create(null);
121
+ for (const [key, entry] of ns.entries) {
122
+ if (entry.kind === "namespace") {
123
+ node[key] = walk(entry.ns);
124
+ continue;
125
+ }
126
+ const op = ops.get(entry.op.id);
127
+ const value = entryOf(entry.op, op.success, model.resolve);
128
+ if (calls && op.stream !== null)
129
+ value.call = new Identifier(OPERATION_CALLS[op.stream]);
130
+ node[key] = value;
131
+ }
132
+ return node;
133
+ };
134
+ return walk(memberTree(ir.tree));
135
+ }
136
+ /**
137
+ * The nested service map of `ir`: a dotted id's segments as nested keys, renamed as on the client.
138
+ * Null-prototype nodes: an id of `__proto__.x` must never reach `Object.prototype`.
139
+ */
140
+ export function serviceMapOf(ir) {
141
+ return mapOf(ir, false);
142
+ }
143
+ /** A service map value as TS literal text; each adapter's name is collected into `used`. */
144
+ function valueText(value, indent, used) {
145
+ if (value instanceof Identifier) {
146
+ used.add(value.name);
147
+ return value.name;
148
+ }
149
+ if (typeof value === "string")
150
+ return tsString(value);
151
+ if (typeof value === "boolean")
152
+ return String(value);
153
+ if (Array.isArray(value))
154
+ return `[${value.map((item) => valueText(item, indent, used)).join(", ")}]`;
155
+ const inner = `${indent}\t`;
156
+ const lines = Object.entries(value)
157
+ .sort(([a], [b]) => compareCodeUnits(a, b))
158
+ .map(([key, item]) => `${inner}${quoteKey(key)}: ${valueText(item, inner, used)},`);
159
+ return lines.length === 0 ? "{}" : `{\n${lines.join("\n")}\n${indent}}`;
160
+ }
161
+ /** The `${stem}.map.gen.ts` text: the service map as a `const`, importing the adapters its entries name. */
162
+ export function serviceMapText(ir, runtime) {
163
+ const used = new Set();
164
+ const map = valueText(mapOf(ir, true), "", used);
165
+ const calls = [...used].sort(compareCodeUnits);
166
+ const names = calls.length === 0 ? "type { ServiceMap }" : `{ ${calls.join(", ")}, type ServiceMap }`;
167
+ return `import ${names} from "./${runtime}.js"
168
+
169
+ export const serviceMap: ServiceMap = ${map}
170
+ `;
171
+ }
@@ -0,0 +1,12 @@
1
+ import type { IR } from "../../ir/model.ts";
2
+ /**
3
+ * The adapter as one module, its imports hoisted: `runtime` is the emitted runtime's specifier
4
+ * (`<stem>.runtime.gen`). Every module's own `export` keywords survive, so the emitted file exports what
5
+ * the types below wrap.
6
+ */
7
+ export declare function tanstackQuerySource(runtime: string): string;
8
+ /**
9
+ * `<stem>.tanstack-query.gen.ts`: the vendored adapter, the two key trees read off this document, and the
10
+ * mapped types that turn them into exact surfaces over the client's own operations.
11
+ */
12
+ export declare function tanstackQueryText(ir: IR, name: string, stem: string): string;
@@ -0,0 +1,156 @@
1
+ /**
2
+ * The TanStack Query adapter the `ts` target writes under `--ts-tanstack-query` (bit 22):
3
+ * `<stem>.tanstack-query.gen.ts`, the vendored modules under `runtime/ts-tanstack-query` joined into one
4
+ * file beside the SDK, plus the types that make its surfaces exact for this document.
5
+ *
6
+ * The vendoring mirrors `http.ts`'s `runtimeSource`, with one difference it cannot share: those modules
7
+ * import only each other, so dropping every sibling import is enough. These import honey's runtime too
8
+ * (`../ts/sdk.ts`), and the emitted file needs those names from `./<stem>.runtime.gen`, so the specifier is
9
+ * rewritten rather than dropped.
10
+ */
11
+ import { readFileSync } from "node:fs";
12
+ import { compareCodeUnits } from "../shared/lang.js";
13
+ import { quoteKey } from "../shared/literals.js";
14
+ import { memberTree } from "./service-map.js";
15
+ /** The adapter's modules, each after the ones it imports, as `RUNTIME_MODULES` is ordered. */
16
+ const QUERY_MODULES = ["invalidate", "query"];
17
+ /* an import of a module beside this one: now the same file, so the names are already in scope */
18
+ const SIBLING_IMPORT = /^import\s+(?:type\s+)?\{[^}]*\}\s+from\s+"\.\/[\w-]+\.ts"\n/gm;
19
+ /* an import of honey's own runtime, which the emitted file reads from `<stem>.runtime.gen` */
20
+ const RUNTIME_IMPORT = /^import\s+(type\s+)?\{([^}]*)\}\s+from\s+"\.\.\/ts\/[\w-]+\.ts"\n/gm;
21
+ /* query-core, which stays exactly as written: type-only, so nothing has to resolve at run time */
22
+ const QUERY_CORE_IMPORT = /^import\s+type\s+\{([^}]*)\}\s+from\s+"@tanstack\/query-core"\n/gm;
23
+ /** The names a `{ a, type b }` clause lists, in code-unit order and once each. */
24
+ function namesOf(clauses) {
25
+ const names = new Set();
26
+ for (const clause of clauses)
27
+ for (const name of clause.split(","))
28
+ if (name.trim() !== "")
29
+ names.add(name.trim().replace(/^type\s+/, ""));
30
+ return [...names].sort(compareCodeUnits);
31
+ }
32
+ /**
33
+ * The adapter as one module, its imports hoisted: `runtime` is the emitted runtime's specifier
34
+ * (`<stem>.runtime.gen`). Every module's own `export` keywords survive, so the emitted file exports what
35
+ * the types below wrap.
36
+ */
37
+ export function tanstackQuerySource(runtime) {
38
+ const core = [];
39
+ const honey = [];
40
+ const bodies = QUERY_MODULES.map((name) => {
41
+ const text = readFileSync(new URL(`../../runtime/ts-tanstack-query/${name}.ts`, import.meta.url), "utf8");
42
+ return text
43
+ .replace(QUERY_CORE_IMPORT, (_, named) => {
44
+ core.push(named);
45
+ return "";
46
+ })
47
+ .replace(RUNTIME_IMPORT, (_, __, named) => {
48
+ honey.push(named);
49
+ return "";
50
+ })
51
+ .replace(SIBLING_IMPORT, "")
52
+ .trim();
53
+ });
54
+ const imports = [
55
+ `import type { ${namesOf(core).join(", ")} } from "@tanstack/query-core"`,
56
+ `import type { ${namesOf(honey).join(", ")} } from "./${runtime}.js"`,
57
+ ];
58
+ return `${imports.join("\n")}\n\n${bodies.join("\n\n")}\n`;
59
+ }
60
+ /** The member tree of the operations `keep` admits, branches with nothing in them left out. */
61
+ function treeOf(ns, keep, ops) {
62
+ const out = {};
63
+ for (const [name, entry] of ns.entries) {
64
+ if (entry.kind === "namespace") {
65
+ const nested = treeOf(entry.ns, keep, ops);
66
+ if (Object.keys(nested).length > 0)
67
+ out[name] = nested;
68
+ continue;
69
+ }
70
+ if (keep(entry.op) && ops.get(entry.op.id) !== undefined)
71
+ out[name] = 1;
72
+ }
73
+ return out;
74
+ }
75
+ /** A tree as a type literal; `{}` when it holds nothing, which no surface then offers. */
76
+ function treeText(tree, indent = "\t") {
77
+ const keys = Object.keys(tree);
78
+ if (keys.length === 0)
79
+ return "{}";
80
+ const lines = keys.map((key) => {
81
+ const value = tree[key];
82
+ return `${indent}${quoteKey(key)}: ${value === 1 ? "1" : treeText(value, `${indent}\t`)}`;
83
+ });
84
+ return `{\n${lines.join("\n")}\n${indent.slice(1)}}`;
85
+ }
86
+ /** Whether each operation can be cached: a `GET` that is not a stream or a connection. */
87
+ function readable(ir) {
88
+ const out = new Map();
89
+ for (const op of ir.operations) {
90
+ const stream = op.extensions.sse === true || op.extensions.websocket === true || op.extensions.realtime === true;
91
+ if (stream)
92
+ continue;
93
+ out.set(op.id, op.method === "GET");
94
+ }
95
+ return out;
96
+ }
97
+ /**
98
+ * `<stem>.tanstack-query.gen.ts`: the vendored adapter, the two key trees read off this document, and the
99
+ * mapped types that turn them into exact surfaces over the client's own operations.
100
+ */
101
+ export function tanstackQueryText(ir, name, stem) {
102
+ const ops = readable(ir);
103
+ const tree = memberTree(ir.tree);
104
+ const queries = treeOf(tree, (op) => ops.get(op.id) === true, ops);
105
+ const mutations = treeOf(tree, (op) => ops.get(op.id) === false, ops);
106
+ return `${tanstackQuerySource(`${stem}.runtime.gen`)}
107
+ import { serviceMap } from "./${stem}.map.gen.js"
108
+ import type { ${name} } from "./${stem}.client.gen.js"
109
+
110
+ /** Every operation of this API a cache can hold, nested as the client nests them. */
111
+ type TanstackQueryTree = ${treeText(queries)}
112
+
113
+ /** Every operation that changes something, nested the same way. */
114
+ type TanstackMutationTree = ${treeText(mutations)}
115
+
116
+ type TreeShape = { readonly [key: string]: TreeShape | 1 }
117
+
118
+ type Surfaced<TOps, TTree extends TreeShape, TLeaf> = {
119
+ [K in Extract<keyof TTree, keyof TOps>]: TTree[K] extends 1
120
+ ? TLeaf extends 0
121
+ ? QueryFactory<TOps[K]>
122
+ : TLeaf extends 1
123
+ ? MutationFactory<TOps[K]>
124
+ : TLeaf extends 2
125
+ ? InfiniteFactory<TOps[K]>
126
+ : KeyFactory<TOps[K]>
127
+ : TTree[K] extends TreeShape
128
+ ? Surfaced<TOps[K], TTree[K], TLeaf>
129
+ : never
130
+ }
131
+
132
+ /**
133
+ * The TanStack Query factories for this SDK. \`sdk\` may be a client or a thunk for one, which an
134
+ * isomorphic app needs; \`getQueryClient\` is what a successful write invalidates against.
135
+ */
136
+ export function createQueryHelpers(
137
+ sdk: SdkSource<${name}>,
138
+ options: QueryHelperOptions = {},
139
+ ): {
140
+ infiniteQuery: Surfaced<${name}, TanstackQueryTree, 2>
141
+ mutation: Surfaced<${name}, TanstackMutationTree, 1>
142
+ mutationKey: Surfaced<${name}, TanstackMutationTree, 3>
143
+ query: Surfaced<${name}, TanstackQueryTree, 0>
144
+ queryKey: Surfaced<${name}, TanstackQueryTree, 3>
145
+ } {
146
+ const helpers = queryHelpers(sdk, serviceMap as ServiceMap, ${JSON.stringify(name)}, options)
147
+ return helpers as unknown as {
148
+ infiniteQuery: Surfaced<${name}, TanstackQueryTree, 2>
149
+ mutation: Surfaced<${name}, TanstackMutationTree, 1>
150
+ mutationKey: Surfaced<${name}, TanstackMutationTree, 3>
151
+ query: Surfaced<${name}, TanstackQueryTree, 0>
152
+ queryKey: Surfaced<${name}, TanstackQueryTree, 3>
153
+ }
154
+ }
155
+ `;
156
+ }
@@ -0,0 +1,26 @@
1
+ /**
2
+ * `generateTypes` (F3): an app's `_gen/types.gen.d.ts` — the `Routes` map, each route's ctx,
3
+ * input, output, errors and meta, the route selectors with the `HoneyCodegen` augmentation, and
4
+ * `BaseCtx`. Read from the app's OpenAPI document (the IR), its route tree (meta, O1) and the
5
+ * extracted ctx types (middleware, env, taps, parsed inputs, O3), joined on `x-honey-route`.
6
+ */
7
+ import type { ExtractedTypes } from "../../extract/extract.ts";
8
+ import type { RouteTree } from "./route-tree.ts";
9
+ /**
10
+ * What `generateTypes` reads: the app's document, route tree and extracted types, and how to report what could not be
11
+ * joined.
12
+ */
13
+ export type GenerateTypesOptions = {
14
+ /** what the ctx base type is named; default `BaseCtx` */
15
+ readonly baseCtxName?: string;
16
+ /** the app's OpenAPI document; an operation without an `operationId` gets a derived one */
17
+ readonly document: Record<string, unknown>;
18
+ /** the app's extracted types; null without ts-morph (inputs then fall back to the document's) */
19
+ readonly extracted: ExtractedTypes | null;
20
+ /** what could not be joined, said once each */
21
+ readonly report: (message: string) => void;
22
+ /** the app's route tree, read for each route's meta */
23
+ readonly tree: RouteTree;
24
+ };
25
+ /** The `types.gen.d.ts` text for the app the options describe. */
26
+ export declare function generateTypes(options: GenerateTypesOptions): string;