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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (558) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +619 -2
  3. package/bin/honey-clients.js +94 -0
  4. package/dist/cli.d.ts +102 -0
  5. package/dist/cli.js +190 -0
  6. package/dist/emit/cli/channels.d.ts +73 -0
  7. package/dist/emit/cli/channels.js +197 -0
  8. package/dist/emit/cli/commands.d.ts +27 -0
  9. package/dist/emit/cli/commands.js +187 -0
  10. package/dist/emit/cli/discovery.d.ts +35 -0
  11. package/dist/emit/cli/discovery.js +202 -0
  12. package/dist/emit/cli/flags.d.ts +59 -0
  13. package/dist/emit/cli/flags.js +186 -0
  14. package/dist/emit/cli/index.d.ts +1 -0
  15. package/dist/emit/cli/index.js +1 -0
  16. package/dist/emit/cli/install.d.ts +37 -0
  17. package/dist/emit/cli/install.js +88 -0
  18. package/dist/emit/cli/layout.d.ts +23 -0
  19. package/dist/emit/cli/layout.js +118 -0
  20. package/dist/emit/cli/module.d.ts +30 -0
  21. package/dist/emit/cli/module.js +186 -0
  22. package/dist/emit/cli/release.d.ts +40 -0
  23. package/dist/emit/cli/release.js +183 -0
  24. package/dist/emit/cli/skills.d.ts +11 -0
  25. package/dist/emit/cli/skills.js +56 -0
  26. package/dist/emit/csharp/errors.d.ts +7 -0
  27. package/dist/emit/csharp/errors.js +69 -0
  28. package/dist/emit/csharp/index.d.ts +1 -0
  29. package/dist/emit/csharp/index.js +1 -0
  30. package/dist/emit/csharp/json.d.ts +13 -0
  31. package/dist/emit/csharp/json.js +113 -0
  32. package/dist/emit/csharp/realtime.d.ts +10 -0
  33. package/dist/emit/csharp/realtime.js +33 -0
  34. package/dist/emit/csharp/sdk-answer.d.ts +48 -0
  35. package/dist/emit/csharp/sdk-answer.js +85 -0
  36. package/dist/emit/csharp/sdk-body.d.ts +10 -0
  37. package/dist/emit/csharp/sdk-body.js +87 -0
  38. package/dist/emit/csharp/sdk-client.d.ts +32 -0
  39. package/dist/emit/csharp/sdk-client.js +177 -0
  40. package/dist/emit/csharp/sdk-csproj.d.ts +36 -0
  41. package/dist/emit/csharp/sdk-csproj.js +136 -0
  42. package/dist/emit/csharp/sdk-doc.d.ts +12 -0
  43. package/dist/emit/csharp/sdk-doc.js +35 -0
  44. package/dist/emit/csharp/sdk-method.d.ts +26 -0
  45. package/dist/emit/csharp/sdk-method.js +187 -0
  46. package/dist/emit/csharp/sdk-plan.d.ts +38 -0
  47. package/dist/emit/csharp/sdk-plan.js +1 -0
  48. package/dist/emit/csharp/sdk.d.ts +40 -0
  49. package/dist/emit/csharp/sdk.js +105 -0
  50. package/dist/emit/csharp/sse.d.ts +18 -0
  51. package/dist/emit/csharp/sse.js +29 -0
  52. package/dist/emit/csharp/transport.d.ts +11 -0
  53. package/dist/emit/csharp/transport.js +67 -0
  54. package/dist/emit/csharp/types-enum.d.ts +19 -0
  55. package/dist/emit/csharp/types-enum.js +63 -0
  56. package/dist/emit/csharp/types-names.d.ts +33 -0
  57. package/dist/emit/csharp/types-names.js +182 -0
  58. package/dist/emit/csharp/types-record.d.ts +25 -0
  59. package/dist/emit/csharp/types-record.js +65 -0
  60. package/dist/emit/csharp/types-union.d.ts +27 -0
  61. package/dist/emit/csharp/types-union.js +113 -0
  62. package/dist/emit/csharp/types.d.ts +36 -0
  63. package/dist/emit/csharp/types.js +126 -0
  64. package/dist/emit/csharp/ws.d.ts +20 -0
  65. package/dist/emit/csharp/ws.js +14 -0
  66. package/dist/emit/go/errors.d.ts +7 -0
  67. package/dist/emit/go/errors.js +44 -0
  68. package/dist/emit/go/http.d.ts +11 -0
  69. package/dist/emit/go/http.js +50 -0
  70. package/dist/emit/go/index.d.ts +1 -0
  71. package/dist/emit/go/index.js +1 -0
  72. package/dist/emit/go/module-path.d.ts +2 -0
  73. package/dist/emit/go/module-path.js +27 -0
  74. package/dist/emit/go/sdk-answer.d.ts +28 -0
  75. package/dist/emit/go/sdk-answer.js +41 -0
  76. package/dist/emit/go/sdk-body.d.ts +24 -0
  77. package/dist/emit/go/sdk-body.js +76 -0
  78. package/dist/emit/go/sdk-client.d.ts +29 -0
  79. package/dist/emit/go/sdk-client.js +141 -0
  80. package/dist/emit/go/sdk-method.d.ts +68 -0
  81. package/dist/emit/go/sdk-method.js +172 -0
  82. package/dist/emit/go/sdk-mirror.d.ts +23 -0
  83. package/dist/emit/go/sdk-mirror.js +97 -0
  84. package/dist/emit/go/sdk-opts.d.ts +55 -0
  85. package/dist/emit/go/sdk-opts.js +100 -0
  86. package/dist/emit/go/sdk.d.ts +26 -0
  87. package/dist/emit/go/sdk.js +111 -0
  88. package/dist/emit/go/sse.d.ts +16 -0
  89. package/dist/emit/go/sse.js +26 -0
  90. package/dist/emit/go/types-codec.d.ts +15 -0
  91. package/dist/emit/go/types-codec.js +171 -0
  92. package/dist/emit/go/types-names.d.ts +14 -0
  93. package/dist/emit/go/types-names.js +64 -0
  94. package/dist/emit/go/types-struct.d.ts +29 -0
  95. package/dist/emit/go/types-struct.js +65 -0
  96. package/dist/emit/go/types-union.d.ts +17 -0
  97. package/dist/emit/go/types-union.js +84 -0
  98. package/dist/emit/go/types.d.ts +32 -0
  99. package/dist/emit/go/types.js +177 -0
  100. package/dist/emit/go/ws.d.ts +12 -0
  101. package/dist/emit/go/ws.js +70 -0
  102. package/dist/emit/java/gradle.d.ts +57 -0
  103. package/dist/emit/java/gradle.js +221 -0
  104. package/dist/emit/java/index.d.ts +2 -0
  105. package/dist/emit/java/index.js +2 -0
  106. package/dist/emit/java/json.d.ts +13 -0
  107. package/dist/emit/java/json.js +84 -0
  108. package/dist/emit/java/layout-ast.d.ts +146 -0
  109. package/dist/emit/java/layout-ast.js +102 -0
  110. package/dist/emit/java/layout-decl.d.ts +20 -0
  111. package/dist/emit/java/layout-decl.js +155 -0
  112. package/dist/emit/java/layout-doc.d.ts +55 -0
  113. package/dist/emit/java/layout-doc.js +166 -0
  114. package/dist/emit/java/layout-dot.d.ts +18 -0
  115. package/dist/emit/java/layout-dot.js +127 -0
  116. package/dist/emit/java/layout-strings.d.ts +8 -0
  117. package/dist/emit/java/layout-strings.js +76 -0
  118. package/dist/emit/java/layout-types.d.ts +11 -0
  119. package/dist/emit/java/layout-types.js +95 -0
  120. package/dist/emit/java/layout-visitor.d.ts +38 -0
  121. package/dist/emit/java/layout-visitor.js +232 -0
  122. package/dist/emit/java/layout.d.ts +61 -0
  123. package/dist/emit/java/layout.js +121 -0
  124. package/dist/emit/java/models-enum.d.ts +17 -0
  125. package/dist/emit/java/models-enum.js +51 -0
  126. package/dist/emit/java/models-names.d.ts +29 -0
  127. package/dist/emit/java/models-names.js +97 -0
  128. package/dist/emit/java/models-record.d.ts +24 -0
  129. package/dist/emit/java/models-record.js +79 -0
  130. package/dist/emit/java/models-union.d.ts +27 -0
  131. package/dist/emit/java/models-union.js +86 -0
  132. package/dist/emit/java/models.d.ts +28 -0
  133. package/dist/emit/java/models.js +118 -0
  134. package/dist/emit/java/realtime.d.ts +50 -0
  135. package/dist/emit/java/realtime.js +69 -0
  136. package/dist/emit/java/sdk-client.d.ts +66 -0
  137. package/dist/emit/java/sdk-client.js +207 -0
  138. package/dist/emit/java/sdk-decl.d.ts +11 -0
  139. package/dist/emit/java/sdk-decl.js +63 -0
  140. package/dist/emit/java/sdk-errors.d.ts +13 -0
  141. package/dist/emit/java/sdk-errors.js +141 -0
  142. package/dist/emit/java/sdk-headers.d.ts +12 -0
  143. package/dist/emit/java/sdk-headers.js +74 -0
  144. package/dist/emit/java/sdk-mirror.d.ts +14 -0
  145. package/dist/emit/java/sdk-mirror.js +107 -0
  146. package/dist/emit/java/sdk-models.d.ts +16 -0
  147. package/dist/emit/java/sdk-models.js +68 -0
  148. package/dist/emit/java/sdk-op.d.ts +57 -0
  149. package/dist/emit/java/sdk-op.js +216 -0
  150. package/dist/emit/java/sdk-params.d.ts +38 -0
  151. package/dist/emit/java/sdk-params.js +133 -0
  152. package/dist/emit/java/sdk-plan.d.ts +52 -0
  153. package/dist/emit/java/sdk-plan.js +1 -0
  154. package/dist/emit/java/sdk-record.d.ts +16 -0
  155. package/dist/emit/java/sdk-record.js +99 -0
  156. package/dist/emit/java/sdk.d.ts +49 -0
  157. package/dist/emit/java/sdk.js +216 -0
  158. package/dist/emit/java/sse.d.ts +35 -0
  159. package/dist/emit/java/sse.js +57 -0
  160. package/dist/emit/java/ws.d.ts +27 -0
  161. package/dist/emit/java/ws.js +31 -0
  162. package/dist/emit/mcp/annotations.d.ts +15 -0
  163. package/dist/emit/mcp/annotations.js +15 -0
  164. package/dist/emit/mcp/files.d.ts +18 -0
  165. package/dist/emit/mcp/files.js +42 -0
  166. package/dist/emit/mcp/index.d.ts +3 -0
  167. package/dist/emit/mcp/index.js +3 -0
  168. package/dist/emit/mcp/literal.d.ts +2 -0
  169. package/dist/emit/mcp/literal.js +33 -0
  170. package/dist/emit/mcp/mounted.d.ts +21 -0
  171. package/dist/emit/mcp/mounted.js +89 -0
  172. package/dist/emit/mcp/output-schema.d.ts +18 -0
  173. package/dist/emit/mcp/output-schema.js +38 -0
  174. package/dist/emit/mcp/registry.d.ts +23 -0
  175. package/dist/emit/mcp/registry.js +83 -0
  176. package/dist/emit/mcp/runtime.d.ts +10 -0
  177. package/dist/emit/mcp/runtime.js +47 -0
  178. package/dist/emit/mcp/schema.d.ts +19 -0
  179. package/dist/emit/mcp/schema.js +88 -0
  180. package/dist/emit/mcp/server.d.ts +30 -0
  181. package/dist/emit/mcp/server.js +246 -0
  182. package/dist/emit/mcp/tools.d.ts +51 -0
  183. package/dist/emit/mcp/tools.js +153 -0
  184. package/dist/emit/python/errors.d.ts +8 -0
  185. package/dist/emit/python/errors.js +68 -0
  186. package/dist/emit/python/index.d.ts +1 -0
  187. package/dist/emit/python/index.js +1 -0
  188. package/dist/emit/python/realtime.d.ts +10 -0
  189. package/dist/emit/python/realtime.js +33 -0
  190. package/dist/emit/python/sdk-answer.d.ts +49 -0
  191. package/dist/emit/python/sdk-answer.js +89 -0
  192. package/dist/emit/python/sdk-body.d.ts +11 -0
  193. package/dist/emit/python/sdk-body.js +40 -0
  194. package/dist/emit/python/sdk-client.d.ts +36 -0
  195. package/dist/emit/python/sdk-client.js +163 -0
  196. package/dist/emit/python/sdk-doc.d.ts +9 -0
  197. package/dist/emit/python/sdk-doc.js +32 -0
  198. package/dist/emit/python/sdk-imports.d.ts +14 -0
  199. package/dist/emit/python/sdk-imports.js +38 -0
  200. package/dist/emit/python/sdk-method.d.ts +29 -0
  201. package/dist/emit/python/sdk-method.js +183 -0
  202. package/dist/emit/python/sdk-plan.d.ts +33 -0
  203. package/dist/emit/python/sdk-plan.js +1 -0
  204. package/dist/emit/python/sdk-pyproject.d.ts +27 -0
  205. package/dist/emit/python/sdk-pyproject.js +103 -0
  206. package/dist/emit/python/sdk.d.ts +22 -0
  207. package/dist/emit/python/sdk.js +154 -0
  208. package/dist/emit/python/sse.d.ts +12 -0
  209. package/dist/emit/python/sse.js +23 -0
  210. package/dist/emit/python/transport.d.ts +15 -0
  211. package/dist/emit/python/transport.js +60 -0
  212. package/dist/emit/python/types-dict.d.ts +31 -0
  213. package/dist/emit/python/types-dict.js +45 -0
  214. package/dist/emit/python/types-names.d.ts +16 -0
  215. package/dist/emit/python/types-names.js +52 -0
  216. package/dist/emit/python/types-union.d.ts +32 -0
  217. package/dist/emit/python/types-union.js +46 -0
  218. package/dist/emit/python/types.d.ts +36 -0
  219. package/dist/emit/python/types.js +128 -0
  220. package/dist/emit/python/ws.d.ts +14 -0
  221. package/dist/emit/python/ws.js +16 -0
  222. package/dist/emit/rust/errors.d.ts +7 -0
  223. package/dist/emit/rust/errors.js +107 -0
  224. package/dist/emit/rust/http.d.ts +13 -0
  225. package/dist/emit/rust/http.js +67 -0
  226. package/dist/emit/rust/index.d.ts +1 -0
  227. package/dist/emit/rust/index.js +1 -0
  228. package/dist/emit/rust/realtime.d.ts +11 -0
  229. package/dist/emit/rust/realtime.js +29 -0
  230. package/dist/emit/rust/sdk-body.d.ts +19 -0
  231. package/dist/emit/rust/sdk-body.js +53 -0
  232. package/dist/emit/rust/sdk-cargo.d.ts +43 -0
  233. package/dist/emit/rust/sdk-cargo.js +178 -0
  234. package/dist/emit/rust/sdk-client.d.ts +25 -0
  235. package/dist/emit/rust/sdk-client.js +108 -0
  236. package/dist/emit/rust/sdk-method.d.ts +15 -0
  237. package/dist/emit/rust/sdk-method.js +119 -0
  238. package/dist/emit/rust/sdk-opts.d.ts +58 -0
  239. package/dist/emit/rust/sdk-opts.js +117 -0
  240. package/dist/emit/rust/sdk-plan.d.ts +33 -0
  241. package/dist/emit/rust/sdk-plan.js +1 -0
  242. package/dist/emit/rust/sdk.d.ts +23 -0
  243. package/dist/emit/rust/sdk.js +111 -0
  244. package/dist/emit/rust/sse.d.ts +19 -0
  245. package/dist/emit/rust/sse.js +20 -0
  246. package/dist/emit/rust/types-enum.d.ts +13 -0
  247. package/dist/emit/rust/types-enum.js +62 -0
  248. package/dist/emit/rust/types-names.d.ts +19 -0
  249. package/dist/emit/rust/types-names.js +66 -0
  250. package/dist/emit/rust/types-struct.d.ts +21 -0
  251. package/dist/emit/rust/types-struct.js +59 -0
  252. package/dist/emit/rust/types-union.d.ts +24 -0
  253. package/dist/emit/rust/types-union.js +97 -0
  254. package/dist/emit/rust/types.d.ts +34 -0
  255. package/dist/emit/rust/types.js +105 -0
  256. package/dist/emit/rust/ws.d.ts +21 -0
  257. package/dist/emit/rust/ws.js +20 -0
  258. package/dist/emit/shared/escape.d.ts +55 -0
  259. package/dist/emit/shared/escape.js +144 -0
  260. package/dist/emit/shared/format.d.ts +24 -0
  261. package/dist/emit/shared/format.js +23 -0
  262. package/dist/emit/shared/gofmt.d.ts +3 -0
  263. package/dist/emit/shared/gofmt.js +26 -0
  264. package/dist/emit/shared/lang.d.ts +60 -0
  265. package/dist/emit/shared/lang.js +233 -0
  266. package/dist/emit/shared/literals.d.ts +4 -0
  267. package/dist/emit/shared/literals.js +31 -0
  268. package/dist/emit/shared/metadata.d.ts +106 -0
  269. package/dist/emit/shared/metadata.js +130 -0
  270. package/dist/emit/shared/mirror.d.ts +22 -0
  271. package/dist/emit/shared/mirror.js +26 -0
  272. package/dist/emit/shared/ruff.d.ts +3 -0
  273. package/dist/emit/shared/ruff.js +31 -0
  274. package/dist/emit/shared/rustfmt.d.ts +3 -0
  275. package/dist/emit/shared/rustfmt.js +32 -0
  276. package/dist/emit/shared/status-keys.d.ts +7 -0
  277. package/dist/emit/shared/status-keys.js +67 -0
  278. package/dist/emit/shared/type-emitter.d.ts +19 -0
  279. package/dist/emit/shared/type-emitter.js +100 -0
  280. package/dist/emit/ts/app-client.d.ts +4 -0
  281. package/dist/emit/ts/app-client.js +68 -0
  282. package/dist/emit/ts/http.d.ts +20 -0
  283. package/dist/emit/ts/http.js +74 -0
  284. package/dist/emit/ts/package.d.ts +36 -0
  285. package/dist/emit/ts/package.js +126 -0
  286. package/dist/emit/ts/route-tree.d.ts +68 -0
  287. package/dist/emit/ts/route-tree.js +240 -0
  288. package/dist/emit/ts/sdk-types-preamble.d.ts +14 -0
  289. package/dist/emit/ts/sdk-types-preamble.js +123 -0
  290. package/dist/emit/ts/sdk-types.d.ts +13 -0
  291. package/dist/emit/ts/sdk-types.js +213 -0
  292. package/dist/emit/ts/sdk.d.ts +21 -0
  293. package/dist/emit/ts/sdk.js +173 -0
  294. package/dist/emit/ts/service-map.d.ts +40 -0
  295. package/dist/emit/ts/service-map.js +171 -0
  296. package/dist/emit/ts/tanstack-query.d.ts +12 -0
  297. package/dist/emit/ts/tanstack-query.js +156 -0
  298. package/dist/emit/ts/type-gen.d.ts +26 -0
  299. package/dist/emit/ts/type-gen.js +255 -0
  300. package/dist/emit/ts/webhooks.d.ts +19 -0
  301. package/dist/emit/ts/webhooks.js +81 -0
  302. package/dist/extract/chain.d.ts +34 -0
  303. package/dist/extract/chain.js +84 -0
  304. package/dist/extract/extract.d.ts +41 -0
  305. package/dist/extract/extract.js +191 -0
  306. package/dist/extract/serialize.d.ts +34 -0
  307. package/dist/extract/serialize.js +295 -0
  308. package/dist/extract/walk.d.ts +47 -0
  309. package/dist/extract/walk.js +109 -0
  310. package/dist/gen/args.d.ts +28 -0
  311. package/dist/gen/args.js +133 -0
  312. package/dist/gen/formatters.d.ts +62 -0
  313. package/dist/gen/formatters.js +146 -0
  314. package/dist/gen/process.d.ts +13 -0
  315. package/dist/gen/process.js +35 -0
  316. package/dist/gen/shipped.d.ts +17 -0
  317. package/dist/gen/shipped.js +55 -0
  318. package/dist/gen/targets.d.ts +93 -0
  319. package/dist/gen/targets.js +171 -0
  320. package/dist/gen/write.d.ts +33 -0
  321. package/dist/gen/write.js +118 -0
  322. package/dist/index.d.ts +13 -0
  323. package/dist/index.js +15 -0
  324. package/dist/ir/build.d.ts +37 -0
  325. package/dist/ir/build.js +152 -0
  326. package/dist/ir/load.d.ts +11 -0
  327. package/dist/ir/load.js +112 -0
  328. package/dist/ir/model.d.ts +206 -0
  329. package/dist/ir/model.js +5 -0
  330. package/dist/ir/resolve-refs.d.ts +11 -0
  331. package/dist/ir/resolve-refs.js +66 -0
  332. package/dist/ir/resource-tree.d.ts +9 -0
  333. package/dist/ir/resource-tree.js +53 -0
  334. package/dist/ir/route-tree-intern.d.ts +18 -0
  335. package/dist/ir/route-tree-intern.js +174 -0
  336. package/dist/ir/schema.d.ts +11 -0
  337. package/dist/ir/schema.js +192 -0
  338. package/dist/ir/sdk-model.d.ts +86 -0
  339. package/dist/ir/sdk-model.js +204 -0
  340. package/dist/ir/slots.d.ts +42 -0
  341. package/dist/ir/slots.js +245 -0
  342. package/dist/runtime/cli/body.go +176 -0
  343. package/dist/runtime/cli/config.go +243 -0
  344. package/dist/runtime/cli/discovery.go +147 -0
  345. package/dist/runtime/cli/format.go +174 -0
  346. package/dist/runtime/cli/log.go +117 -0
  347. package/dist/runtime/cli/output.go +247 -0
  348. package/dist/runtime/cli/params.go +197 -0
  349. package/dist/runtime/cli/run.go +226 -0
  350. package/dist/runtime/cli/socket.go +60 -0
  351. package/dist/runtime/cli/stream.go +217 -0
  352. package/dist/runtime/cli/target.go +117 -0
  353. package/dist/runtime/csharp/Adapters.cs +183 -0
  354. package/dist/runtime/csharp/Auth.cs +56 -0
  355. package/dist/runtime/csharp/Body.cs +135 -0
  356. package/dist/runtime/csharp/Config.cs +161 -0
  357. package/dist/runtime/csharp/Envelope.cs +149 -0
  358. package/dist/runtime/csharp/Errors.cs +194 -0
  359. package/dist/runtime/csharp/Events.cs +155 -0
  360. package/dist/runtime/csharp/Exchange.cs +247 -0
  361. package/dist/runtime/csharp/Handler.cs +103 -0
  362. package/dist/runtime/csharp/Hooks.cs +128 -0
  363. package/dist/runtime/csharp/Invalidation.cs +102 -0
  364. package/dist/runtime/csharp/Json.cs +144 -0
  365. package/dist/runtime/csharp/Log.cs +48 -0
  366. package/dist/runtime/csharp/Operation.cs +33 -0
  367. package/dist/runtime/csharp/Path.cs +65 -0
  368. package/dist/runtime/csharp/Query.cs +72 -0
  369. package/dist/runtime/csharp/Realtime.cs +118 -0
  370. package/dist/runtime/csharp/RealtimeLoop.cs +236 -0
  371. package/dist/runtime/csharp/Redirect.cs +53 -0
  372. package/dist/runtime/csharp/Result.cs +57 -0
  373. package/dist/runtime/csharp/Sse.cs +122 -0
  374. package/dist/runtime/csharp/Stale.cs +151 -0
  375. package/dist/runtime/csharp/Transport.cs +143 -0
  376. package/dist/runtime/csharp/TransportLongPoll.cs +63 -0
  377. package/dist/runtime/csharp/TransportSse.cs +54 -0
  378. package/dist/runtime/csharp/TransportWs.cs +40 -0
  379. package/dist/runtime/csharp/Wire.cs +109 -0
  380. package/dist/runtime/csharp/Ws.cs +300 -0
  381. package/dist/runtime/csharp/WsDial.cs +127 -0
  382. package/dist/runtime/go/auth.go +127 -0
  383. package/dist/runtime/go/body.go +129 -0
  384. package/dist/runtime/go/config.go +75 -0
  385. package/dist/runtime/go/errors.go +185 -0
  386. package/dist/runtime/go/export.go +37 -0
  387. package/dist/runtime/go/hooks.go +53 -0
  388. package/dist/runtime/go/invalidation.go +112 -0
  389. package/dist/runtime/go/log.go +92 -0
  390. package/dist/runtime/go/nullable.go +64 -0
  391. package/dist/runtime/go/options.go +118 -0
  392. package/dist/runtime/go/path.go +156 -0
  393. package/dist/runtime/go/query.go +147 -0
  394. package/dist/runtime/go/realtime.go +239 -0
  395. package/dist/runtime/go/realtime_loop.go +208 -0
  396. package/dist/runtime/go/redirect.go +124 -0
  397. package/dist/runtime/go/request.go +222 -0
  398. package/dist/runtime/go/result.go +86 -0
  399. package/dist/runtime/go/sse.go +186 -0
  400. package/dist/runtime/go/stale.go +229 -0
  401. package/dist/runtime/go/stream.go +105 -0
  402. package/dist/runtime/go/transport.go +242 -0
  403. package/dist/runtime/go/transport_longpoll.go +121 -0
  404. package/dist/runtime/go/transport_sse.go +175 -0
  405. package/dist/runtime/go/ws.go +205 -0
  406. package/dist/runtime/java/Answer.java +107 -0
  407. package/dist/runtime/java/ApiException.java +110 -0
  408. package/dist/runtime/java/BinaryBody.java +36 -0
  409. package/dist/runtime/java/Body.java +105 -0
  410. package/dist/runtime/java/Call.java +23 -0
  411. package/dist/runtime/java/CallLog.java +51 -0
  412. package/dist/runtime/java/ClientConfig.java +233 -0
  413. package/dist/runtime/java/ConnectionState.java +12 -0
  414. package/dist/runtime/java/Credential.java +58 -0
  415. package/dist/runtime/java/Deadline.java +38 -0
  416. package/dist/runtime/java/Decode.java +181 -0
  417. package/dist/runtime/java/Envelope.java +141 -0
  418. package/dist/runtime/java/ErrorEnvelope.java +23 -0
  419. package/dist/runtime/java/EventStream.java +129 -0
  420. package/dist/runtime/java/Exchange.java +62 -0
  421. package/dist/runtime/java/FilePart.java +5 -0
  422. package/dist/runtime/java/Flight.java +306 -0
  423. package/dist/runtime/java/HoneyException.java +14 -0
  424. package/dist/runtime/java/Hooks.java +47 -0
  425. package/dist/runtime/java/Hops.java +133 -0
  426. package/dist/runtime/java/InvalidationConfig.java +73 -0
  427. package/dist/runtime/java/Json.java +23 -0
  428. package/dist/runtime/java/Keepalive.java +60 -0
  429. package/dist/runtime/java/LogEntry.java +14 -0
  430. package/dist/runtime/java/LongPollAdapter.java +68 -0
  431. package/dist/runtime/java/Operation.java +21 -0
  432. package/dist/runtime/java/Opt.java +121 -0
  433. package/dist/runtime/java/Pump.java +160 -0
  434. package/dist/runtime/java/RawResponse.java +48 -0
  435. package/dist/runtime/java/Realtime.java +152 -0
  436. package/dist/runtime/java/RealtimeLoop.java +371 -0
  437. package/dist/runtime/java/RedirectPolicy.java +13 -0
  438. package/dist/runtime/java/Redirects.java +126 -0
  439. package/dist/runtime/java/RequestContext.java +78 -0
  440. package/dist/runtime/java/RequestHook.java +9 -0
  441. package/dist/runtime/java/RequestOptions.java +91 -0
  442. package/dist/runtime/java/ResponseContext.java +70 -0
  443. package/dist/runtime/java/ResponseHook.java +12 -0
  444. package/dist/runtime/java/Result.java +32 -0
  445. package/dist/runtime/java/ResumableConnection.java +165 -0
  446. package/dist/runtime/java/SdkException.java +11 -0
  447. package/dist/runtime/java/Socket.java +301 -0
  448. package/dist/runtime/java/Sse.java +171 -0
  449. package/dist/runtime/java/SseAdapter.java +61 -0
  450. package/dist/runtime/java/SseEvent.java +10 -0
  451. package/dist/runtime/java/StaleMeta.java +16 -0
  452. package/dist/runtime/java/StaleTracker.java +287 -0
  453. package/dist/runtime/java/Transport.java +16 -0
  454. package/dist/runtime/java/TransportAdapter.java +14 -0
  455. package/dist/runtime/java/TransportConnection.java +15 -0
  456. package/dist/runtime/java/TransportKind.java +12 -0
  457. package/dist/runtime/java/TransportMessage.java +9 -0
  458. package/dist/runtime/java/TransportOptions.java +138 -0
  459. package/dist/runtime/java/TypedWebSocket.java +83 -0
  460. package/dist/runtime/java/UrlPath.java +49 -0
  461. package/dist/runtime/java/UrlQuery.java +99 -0
  462. package/dist/runtime/java/WsAdapter.java +52 -0
  463. package/dist/runtime/java/WsClose.java +47 -0
  464. package/dist/runtime/java/WsDial.java +148 -0
  465. package/dist/runtime/java/WsMessage.java +18 -0
  466. package/dist/runtime/mcp/call.ts +167 -0
  467. package/dist/runtime/mcp/files.ts +183 -0
  468. package/dist/runtime/mcp/guard.ts +176 -0
  469. package/dist/runtime/mcp/http.ts +159 -0
  470. package/dist/runtime/mcp/jsonrpc.ts +50 -0
  471. package/dist/runtime/mcp/listen.ts +76 -0
  472. package/dist/runtime/mcp/mount.ts +123 -0
  473. package/dist/runtime/mcp/protocol.ts +219 -0
  474. package/dist/runtime/mcp/reader.ts +57 -0
  475. package/dist/runtime/mcp/result.ts +85 -0
  476. package/dist/runtime/mcp/stdio.ts +79 -0
  477. package/dist/runtime/mcp/stream.ts +62 -0
  478. package/dist/runtime/python/__init__.py +2 -0
  479. package/dist/runtime/python/auth.py +67 -0
  480. package/dist/runtime/python/body.py +83 -0
  481. package/dist/runtime/python/config.py +139 -0
  482. package/dist/runtime/python/errors.py +213 -0
  483. package/dist/runtime/python/events.py +152 -0
  484. package/dist/runtime/python/exchange.py +298 -0
  485. package/dist/runtime/python/hooks.py +86 -0
  486. package/dist/runtime/python/invalidation.py +57 -0
  487. package/dist/runtime/python/log.py +60 -0
  488. package/dist/runtime/python/operation.py +25 -0
  489. package/dist/runtime/python/path.py +41 -0
  490. package/dist/runtime/python/query.py +48 -0
  491. package/dist/runtime/python/realtime.py +244 -0
  492. package/dist/runtime/python/redirect.py +93 -0
  493. package/dist/runtime/python/result.py +58 -0
  494. package/dist/runtime/python/send_async.py +189 -0
  495. package/dist/runtime/python/send_sync.py +105 -0
  496. package/dist/runtime/python/sse.py +81 -0
  497. package/dist/runtime/python/stale.py +94 -0
  498. package/dist/runtime/python/transport.py +157 -0
  499. package/dist/runtime/python/transport_longpoll.py +60 -0
  500. package/dist/runtime/python/transport_sse.py +60 -0
  501. package/dist/runtime/python/transport_ws.py +57 -0
  502. package/dist/runtime/python/ws.py +276 -0
  503. package/dist/runtime/rust/Cargo.lock +1763 -0
  504. package/dist/runtime/rust/answer.rs +120 -0
  505. package/dist/runtime/rust/auth.rs +80 -0
  506. package/dist/runtime/rust/body.rs +150 -0
  507. package/dist/runtime/rust/call.rs +200 -0
  508. package/dist/runtime/rust/config.rs +254 -0
  509. package/dist/runtime/rust/envelope.rs +84 -0
  510. package/dist/runtime/rust/errors.rs +235 -0
  511. package/dist/runtime/rust/events.rs +177 -0
  512. package/dist/runtime/rust/exchange.rs +287 -0
  513. package/dist/runtime/rust/hooks.rs +63 -0
  514. package/dist/runtime/rust/invalidation.rs +84 -0
  515. package/dist/runtime/rust/log.rs +88 -0
  516. package/dist/runtime/rust/nullable.rs +13 -0
  517. package/dist/runtime/rust/path.rs +83 -0
  518. package/dist/runtime/rust/query.rs +84 -0
  519. package/dist/runtime/rust/realtime.rs +182 -0
  520. package/dist/runtime/rust/realtime_loop.rs +177 -0
  521. package/dist/runtime/rust/redirect.rs +121 -0
  522. package/dist/runtime/rust/request.rs +178 -0
  523. package/dist/runtime/rust/result.rs +101 -0
  524. package/dist/runtime/rust/sse.rs +104 -0
  525. package/dist/runtime/rust/stale.rs +209 -0
  526. package/dist/runtime/rust/transport.rs +221 -0
  527. package/dist/runtime/rust/transport_longpoll.rs +108 -0
  528. package/dist/runtime/rust/transport_sse.rs +91 -0
  529. package/dist/runtime/rust/transport_ws.rs +75 -0
  530. package/dist/runtime/rust/ws.rs +322 -0
  531. package/dist/runtime/ts/app-types.ts +200 -0
  532. package/dist/runtime/ts/app.ts +104 -0
  533. package/dist/runtime/ts/config.ts +124 -0
  534. package/dist/runtime/ts/defaults.ts +48 -0
  535. package/dist/runtime/ts/error.ts +113 -0
  536. package/dist/runtime/ts/hooks.ts +92 -0
  537. package/dist/runtime/ts/http.ts +228 -0
  538. package/dist/runtime/ts/media-type.ts +36 -0
  539. package/dist/runtime/ts/path.ts +152 -0
  540. package/dist/runtime/ts/realtime-connection.ts +296 -0
  541. package/dist/runtime/ts/realtime-transports.ts +149 -0
  542. package/dist/runtime/ts/realtime.ts +293 -0
  543. package/dist/runtime/ts/redirect-policy.ts +17 -0
  544. package/dist/runtime/ts/redirects.ts +74 -0
  545. package/dist/runtime/ts/request.ts +239 -0
  546. package/dist/runtime/ts/response.ts +219 -0
  547. package/dist/runtime/ts/sdk-realtime.ts +10 -0
  548. package/dist/runtime/ts/sdk-sse.ts +55 -0
  549. package/dist/runtime/ts/sdk-ws.ts +21 -0
  550. package/dist/runtime/ts/sdk.ts +242 -0
  551. package/dist/runtime/ts/sse.ts +175 -0
  552. package/dist/runtime/ts/stale.ts +137 -0
  553. package/dist/runtime/ts/stream.ts +87 -0
  554. package/dist/runtime/ts/webhook.ts +116 -0
  555. package/dist/runtime/ts/ws.ts +155 -0
  556. package/dist/runtime/ts-tanstack-query/invalidate.ts +152 -0
  557. package/dist/runtime/ts-tanstack-query/query.ts +261 -0
  558. package/package.json +84 -5
@@ -0,0 +1,240 @@
1
+ /**
2
+ * `generateRouteTree(tree)` (F2/F17): a route-tree snapshot (core's v2 wire format, restated here
3
+ * because gen never imports core) as a TS module an app boots from. Topology with route-id leaves,
4
+ * each route's data (meta, error keys, error statuses, boundary key, declared body kind), shared
5
+ * values interned.
6
+ * Live validators (`iv`, `out`) and the handler record (`h`) are never written (Q1).
7
+ */
8
+ import { InternPool } from "../../ir/route-tree-intern.js";
9
+ import { tsString, wellFormed } from "../shared/escape.js";
10
+ import { compareCodeUnits } from "../shared/lang.js";
11
+ import { literalType, quoteKey } from "../shared/literals.js";
12
+ /** Every route id a leaf of `root` names: method maps, wildcard method maps and WebSocket leaves. */
13
+ function leafIds(root) {
14
+ const ids = new Set();
15
+ const stack = [root];
16
+ for (let node = stack.pop(); node !== undefined; node = stack.pop()) {
17
+ for (const id of Object.values(node.m ?? {}))
18
+ ids.add(id);
19
+ for (const id of Object.values(node.w?.m ?? {}))
20
+ ids.add(id);
21
+ if (node.ws !== null)
22
+ ids.add(node.ws);
23
+ if (node.d !== null)
24
+ stack.push(node.d.c);
25
+ stack.push(...Object.values(node.s));
26
+ }
27
+ return ids;
28
+ }
29
+ /** What `value` is when JSON cannot carry it, else `null`. */
30
+ function notJson(value) {
31
+ if (typeof value === "number")
32
+ return Number.isFinite(value) ? null : String(value);
33
+ if (value === null || typeof value === "string" || typeof value === "boolean" || value === undefined)
34
+ return null;
35
+ if (typeof value !== "object")
36
+ return `a ${typeof value}`;
37
+ if (Array.isArray(value))
38
+ return null;
39
+ const proto = Object.getPrototypeOf(value);
40
+ if (proto === Object.prototype || proto === null)
41
+ return null;
42
+ return `a ${value.constructor?.name ?? "non-plain object"}`;
43
+ }
44
+ /** Refuse meta JSON cannot carry, naming the route and the path; iterative, so deep meta keeps the stack. */
45
+ function assertJsonMeta(id, meta) {
46
+ const fail = (path, what) => {
47
+ throw new Error(`${id}: ${path} is ${what} — route trees carry JSON values only`);
48
+ };
49
+ const open = new Set();
50
+ const stack = [[meta, "meta"]];
51
+ for (let at = stack.pop(); at !== undefined; at = stack.pop()) {
52
+ const [value, path] = at;
53
+ const what = notJson(value);
54
+ if (what !== null)
55
+ fail(path, what);
56
+ if (value === null || typeof value !== "object")
57
+ continue;
58
+ if (open.has(value))
59
+ fail(path, "a cycle");
60
+ open.add(value);
61
+ if (Array.isArray(value))
62
+ value.forEach((child, k) => stack.push([child, `${path}[${k}]`]));
63
+ else
64
+ for (const [key, child] of Object.entries(value))
65
+ stack.push([child, `${path}.${key}`]);
66
+ }
67
+ }
68
+ /** Every string and key in `value`, iteratively: a deep meta keeps the stack. */
69
+ function* stringsIn(value) {
70
+ const stack = [value];
71
+ const seen = new Set();
72
+ while (stack.length > 0) {
73
+ const at = stack.pop();
74
+ if (typeof at === "string")
75
+ yield at;
76
+ if (at === null || typeof at !== "object" || seen.has(at))
77
+ continue;
78
+ seen.add(at);
79
+ for (const [key, child] of Object.entries(at)) {
80
+ yield key;
81
+ stack.push(child);
82
+ }
83
+ }
84
+ }
85
+ /** Refuse a lone surrogate anywhere in the tree: printed through F2 it would become U+FFFD and re-key a route. */
86
+ function assertWellFormed(tree) {
87
+ const data = Object.values(tree.routes).map(({ bek, ek, es, mt }) => ({ bek, ek, es, mt }));
88
+ for (const text of stringsIn([tree.root, tree.routes, data])) {
89
+ if (wellFormed(text) !== text)
90
+ throw new Error(`route tree string ${JSON.stringify(text)} is not well-formed UTF-16`);
91
+ }
92
+ }
93
+ /** The routes to emit: the input's `routes` order, restricted to leaf ids, each checked. */
94
+ function emittedRoutes(tree) {
95
+ const leaves = leafIds(tree.root);
96
+ for (const id of leaves)
97
+ if (!Object.hasOwn(tree.routes, id))
98
+ throw new Error(`route tree leaf ${id} has no route entry`);
99
+ return Object.keys(tree.routes)
100
+ .filter((id) => leaves.has(id))
101
+ .map((id) => {
102
+ const entry = tree.routes[id];
103
+ /* core's snapshot writes `mt: {}` for every route without meta: no key, no meta */
104
+ const mt = entry.mt && Object.keys(entry.mt).length > 0 ? entry.mt : null;
105
+ if (mt !== null)
106
+ assertJsonMeta(id, mt);
107
+ const es = entry.es && Object.keys(entry.es).length > 0 ? entry.es : null;
108
+ const sorted = es && Object.fromEntries(Object.entries(es).sort(([a], [b]) => compareCodeUnits(a, b)));
109
+ return {
110
+ bd: entry.bd ?? null,
111
+ bek: entry.bek ?? null,
112
+ ek: entry.ek ?? [],
113
+ es: sorted,
114
+ i: entry.i ?? null,
115
+ id,
116
+ mt,
117
+ };
118
+ });
119
+ }
120
+ /** `export type MetaShape`: each key's literal types in first-seen order, optional when some meta lacks it. */
121
+ function metaShape(routes) {
122
+ const withMeta = routes.flatMap((route) => (route.mt === null ? [] : [route.mt]));
123
+ const types = new Map();
124
+ const counts = new Map();
125
+ for (const mt of withMeta) {
126
+ for (const [key, value] of Object.entries(mt)) {
127
+ types.set(key, (types.get(key) ?? new Set()).add(literalType(value)));
128
+ counts.set(key, (counts.get(key) ?? 0) + 1);
129
+ }
130
+ }
131
+ if (types.size === 0)
132
+ return null;
133
+ const props = [...types]
134
+ .sort(([a], [b]) => compareCodeUnits(a, b))
135
+ .map(([key, set]) => `\t${quoteKey(key)}${counts.get(key) === withMeta.length ? "" : "?"}: ${[...set].join(" | ")}`);
136
+ return `export type MetaShape = {\n${props.join("\n")}\n} & Record<string, unknown>\n`;
137
+ }
138
+ const methodMap = (m, intern) => `S({ ${Object.entries(m)
139
+ .map(([method, id]) => `${quoteKey(method)}: ${intern.expr(id)}`)
140
+ .join(", ")} })`;
141
+ /** A node as `N(s, m, d, w, ws)`, trailing defaults left out. */
142
+ function nodeText(node, intern) {
143
+ const statics = Object.entries(node.s);
144
+ const args = [
145
+ statics.length > 0
146
+ ? `S({ ${statics.map(([k, c]) => `${keyText(k)}: ${nodeText(c, intern)}`).join(", ")} })`
147
+ : "undefined",
148
+ node.m === null ? "null" : methodMap(node.m, intern),
149
+ node.d === null ? "null" : `{ n: ${tsString(node.d.n)}, c: ${nodeText(node.d.c, intern)} }`,
150
+ node.w === null ? "null" : `{ n: ${tsString(node.w.n)}, m: ${methodMap(node.w.m, intern)} }`,
151
+ node.ws === null ? "null" : intern.expr(node.ws),
152
+ ];
153
+ while (args.length > 0 && (args.at(-1) === "null" || args.at(-1) === "undefined"))
154
+ args.pop();
155
+ return `N(${args.join(", ")})`;
156
+ }
157
+ /** An object-literal key that defines an own property even for `__proto__`. */
158
+ const keyText = (key) => (key === "__proto__" ? '["__proto__"]' : tsString(key));
159
+ /** Count every value a route carries, and force a name on each id and each meta. */
160
+ function internOf(routes) {
161
+ const intern = new InternPool();
162
+ for (const route of routes) {
163
+ intern.count(route.bd);
164
+ intern.count(route.bek);
165
+ if (route.ek.length > 0)
166
+ intern.count(route.ek);
167
+ intern.count(route.es);
168
+ intern.count(route.mt);
169
+ intern.count(route.id);
170
+ }
171
+ for (const route of routes) {
172
+ intern.force(route.mt, "M");
173
+ intern.force(route.id, "P");
174
+ }
175
+ intern.seal();
176
+ return intern;
177
+ }
178
+ function routeLine(route, intern) {
179
+ const parts = [];
180
+ if (route.bd !== null)
181
+ parts.push(`bd: ${intern.expr(route.bd)}`);
182
+ if (route.bek !== null)
183
+ parts.push(`bek: ${intern.expr(route.bek)}`);
184
+ if (route.ek.length > 0)
185
+ parts.push(`ek: ${intern.expr(route.ek)}`);
186
+ if (route.es !== null)
187
+ parts.push(`es: ${intern.expr(route.es)}`);
188
+ if (route.i !== null)
189
+ parts.push(`i: ${String(route.i)}`);
190
+ if (route.mt !== null)
191
+ parts.push(`mt: ${intern.expr(route.mt)}`);
192
+ return `\t[${intern.expr(route.id)}]: ${parts.length > 0 ? `{ ${parts.join(", ")} }` : "{}"}`;
193
+ }
194
+ const HEAD = `import type { RouteTree, TreeNode } from "@workerstack/backend/tree"
195
+
196
+ function S<T>(o: Record<string, T>): Record<string, T> {
197
+ return Object.assign(Object.create(null) as Record<string, T>, o)
198
+ }
199
+ function N(s: Record<string, TreeNode> = S({}), m: Record<string, string> | null = null, d: TreeNode["d"] = null, w: TreeNode["w"] = null, ws: string | null = null): TreeNode {
200
+ return { d, m, s, w, ws }
201
+ }
202
+ `;
203
+ /** The exported selectors: every HTTP route that is neither internal nor marked internal by its meta. */
204
+ function selectorType(routes, intern) {
205
+ const ids = routes
206
+ .filter((route) => !route.id.startsWith("WS ") && route.i === null && route.mt?.internal !== true)
207
+ .map((route) => route.id)
208
+ .sort(compareCodeUnits);
209
+ if (ids.length === 0)
210
+ return "";
211
+ return `\nexport type RouteSelector = ${ids.map((id) => `typeof ${intern.id(id)}`).join(" | ")}\n`;
212
+ }
213
+ /** The route-tree module for `tree` (a snapshot or a merged tree); throws on anything it cannot carry. */
214
+ export function generateRouteTree(tree) {
215
+ if (tree.v !== 2)
216
+ throw new Error(`route tree version ${String(tree.v)} is not supported: generateRouteTree reads v2`);
217
+ const routes = emittedRoutes(tree);
218
+ assertWellFormed(tree);
219
+ const intern = internOf(routes);
220
+ const shape = metaShape(routes);
221
+ const consts = intern
222
+ .emitConstLines()
223
+ .map((line) => (shape !== null && /^const M\d+ = /.test(line) ? `${line} as unknown as MetaShape` : line));
224
+ const withMeta = routes.filter((route) => route.mt !== null);
225
+ const metaType = shape === null ? "Record<string, Record<string, unknown>>" : "Record<string, MetaShape>";
226
+ const meta = withMeta.map((route) => `\t[${intern.expr(route.id)}]: ${intern.expr(route.mt)}`);
227
+ return [
228
+ HEAD,
229
+ consts.length > 0 ? `${consts.join("\n")}\n` : "",
230
+ `export const tree: TreeNode = ${nodeText(tree.root, intern)}\n`,
231
+ /* S typed by its entry: inferred from the literals, the union of entries would give each es the others' keys */
232
+ `export const routes: RouteTree["routes"] = S<RouteTree["routes"][string]>({\n${routes.map((route) => routeLine(route, intern)).join(",\n")}\n})\n`,
233
+ shape ?? "",
234
+ selectorType(routes, intern),
235
+ meta.length > 0 ? `export const meta: ${metaType} = S({\n${meta.join(",\n")}\n})\n` : "",
236
+ `export const routeTree: RouteTree = { v: 2, root: tree, routes, ${meta.length > 0 ? "meta" : "meta: {}"} }\n`,
237
+ ]
238
+ .filter((part) => part !== "")
239
+ .join("\n");
240
+ }
@@ -0,0 +1,14 @@
1
+ /**
2
+ * What a `${stem}.types.gen.ts` says before its own types: the import line, naming only the runtime
3
+ * types the file goes on to read, and the vocabulary every generated client shares (the call and
4
+ * stream shapes, the error envelope, the safe mirror). Here so sdk-types.ts holds only how a
5
+ * document becomes those types.
6
+ */
7
+ import type { TsRuntimeFeatures } from "./http.ts";
8
+ export declare const RESERVED: string[];
9
+ /** The input fields every call takes, by transport, and the safe twin's types, for an API with `features`. */
10
+ export declare function shared(features: TsRuntimeFeatures): string;
11
+ /** The runtime types this text names, in order: a document with no realtime route uses neither
12
+ * `SSEEvent` nor `ResumableConnection`, and an import a file never reads is a consumer's error
13
+ * under `noUnusedLocals`. A type in `aliases` is imported, and named in `body`, by its alias. */
14
+ export declare function importText(body: string, runtime: string, aliases?: Readonly<Record<string, string>>): string;
@@ -0,0 +1,123 @@
1
+ /* globals the emitted types read, and the names they declare: a component schema never takes one */
2
+ export const RESERVED = [
3
+ "AbortSignal",
4
+ "ArrayBuffer",
5
+ "AsyncIterable",
6
+ "Blob",
7
+ "ErrorEnvelope",
8
+ "ErrorField",
9
+ "HoneyArgs",
10
+ "HoneyCall",
11
+ "HoneySafe",
12
+ "HoneyStream",
13
+ "HttpOptions",
14
+ "Omit",
15
+ "Promise",
16
+ "ReadableStream",
17
+ "RealtimeCallOptions",
18
+ "RealtimeOptions",
19
+ "Record",
20
+ "ResumableConnection",
21
+ "Response",
22
+ "Result",
23
+ "SDKConfig",
24
+ "SSEEvent",
25
+ "SseOptions",
26
+ "TypedWebSocket",
27
+ "Uint8Array",
28
+ "WsOptions",
29
+ ];
30
+ /** What the types file may import from the runtime module, in the order the import lists them. */
31
+ const RUNTIME_TYPES = [
32
+ "RealtimeOptions",
33
+ "Result",
34
+ "ResumableConnection",
35
+ "SDKConfig",
36
+ "SSEEvent",
37
+ "TypedWebSocket",
38
+ ];
39
+ /** The input fields every call takes, by transport. */
40
+ const OPTIONS = `export type HttpOptions = {
41
+ baseURL?: string
42
+ cookies?: Record<string, string>
43
+ headers?: Record<string, string>
44
+ idempotencyKey?: string
45
+ signal?: AbortSignal
46
+ timeout?: number
47
+ }
48
+ export type SseOptions = Omit<HttpOptions, "idempotencyKey"> & { lastEventId?: string }
49
+ export type WsOptions = { protocols?: string | string[]; reconnectToken?: string }
50
+ `;
51
+ /* the error envelope, the call and stream shapes, and the safe mirror's opening */
52
+ const CALLS = `
53
+ type ErrorField = { error_key: string; message: string; path: string }
54
+
55
+ /** honey's error envelope at one status, its error keys as literals. */
56
+ export type ErrorEnvelope<TStatus extends number, TKey extends string> = {
57
+ error_key: TKey
58
+ fields: Record<string, ErrorField[]>
59
+ message: string
60
+ status: TStatus
61
+ status_key: string
62
+ success: false
63
+ }
64
+
65
+ /* a call's declared errors and headers, which only its safe twin reads: a type, never a value */
66
+ declare const answer: unique symbol
67
+
68
+ /** A call's input: optional when none of its fields is required. */
69
+ type HoneyArgs<I, O> = {} extends I ? [input?: I & O] : [input: I & O]
70
+
71
+ /** A REST operation: its raw overload and its value, an error status thrown; its declared errors and headers. */
72
+ type HoneyCall<I, D, E = never, H = never> = {
73
+ (input: I & HttpOptions & { raw: true }): Promise<Response>
74
+ (...input: HoneyArgs<I, HttpOptions & { raw?: false }>): Promise<D>
75
+ readonly [answer]?: [E, H]
76
+ }
77
+
78
+ /** An event stream, sent when its iteration starts; its opening answer's declared errors. */
79
+ type HoneyStream<I, V, E = never> = {
80
+ (...input: HoneyArgs<I, SseOptions>): AsyncIterable<V>
81
+ readonly [answer]?: [E, never]
82
+ }
83
+
84
+ /** \`client.safe\`: every REST and stream call answering a Result, never throwing an API answer; a connection as is. */
85
+ export type HoneySafe<T> = {
86
+ [K in keyof T]: `;
87
+ /* the safe mirror's REST and stream arms */
88
+ const SAFE_ARMS = ` ? {
89
+ (input: I & HttpOptions & { raw: true }): Promise<Result<Response, E>>
90
+ (...input: HoneyArgs<I, HttpOptions & { raw?: false }>): Promise<Result<D, E, H>>
91
+ }
92
+ : T[K] extends HoneyStream<infer I, infer V, infer E>
93
+ ? (...input: HoneyArgs<I, SseOptions>) => Promise<Result<AsyncIterable<V>, E>>
94
+ : HoneySafe<T[K]>
95
+ }
96
+ `;
97
+ /** The input fields every call takes, by transport, and the safe twin's types, for an API with `features`. */
98
+ export function shared(features) {
99
+ const connections = [
100
+ ...(features.realtime ? ["ResumableConnection<infer _>"] : []),
101
+ ...(features.ws || features.realtime ? ["TypedWebSocket"] : []),
102
+ ];
103
+ const realtime = features.realtime
104
+ ? `export type RealtimeCallOptions = Omit<HttpOptions, "idempotencyKey" | "timeout"> & RealtimeOptions\n`
105
+ : "";
106
+ const rest = "T[K] extends HoneyCall<infer I, infer D, infer E, infer H>";
107
+ const safe = connections.length === 0
108
+ ? rest
109
+ : `T[K] extends (...input: never[]) => ${connections.join(" | ")}\n\t\t? T[K]\n\t\t: ${rest}`;
110
+ return `${OPTIONS}${realtime}${CALLS}${safe}\n${SAFE_ARMS}`;
111
+ }
112
+ /** The runtime types this text names, in order: a document with no realtime route uses neither
113
+ * `SSEEvent` nor `ResumableConnection`, and an import a file never reads is a consumer's error
114
+ * under `noUnusedLocals`. A type in `aliases` is imported, and named in `body`, by its alias. */
115
+ export function importText(body, runtime, aliases = {}) {
116
+ const used = RUNTIME_TYPES.flatMap((type) => {
117
+ const local = aliases[type] ?? type;
118
+ if (!new RegExp(`\\b${local}\\b`).test(body))
119
+ return [];
120
+ return local === type ? [type] : [`${type} as ${local}`];
121
+ });
122
+ return `import type { ${used.join(", ")} } from "./${runtime}.js"\n`;
123
+ }
@@ -0,0 +1,13 @@
1
+ /**
2
+ * The `${stem}.types.gen.ts` text: the component schemas, each operation's input, data, error and
3
+ * header types, the SDK's config, and the interface its class merges with. Types and runtime meet
4
+ * in the member tree, so a renamed member (`state` → `state_`) is renamed in both.
5
+ */
6
+ import type { IR } from "../../ir/model.ts";
7
+ /**
8
+ * The component schemas' declared names, clear of `reserved` (the names the emitted file declares
9
+ * and the globals it reads), claimed in code-unit order so the same document names them alike.
10
+ */
11
+ export declare function componentNames(ir: IR, reserved: readonly string[]): (schema: string) => string;
12
+ /** The `${stem}.types.gen.ts` text of `ir` for the SDK `name`, importing the runtime module `runtime`. */
13
+ export declare function sdkTypesText(ir: IR, name: string, runtime: string): string;
@@ -0,0 +1,213 @@
1
+ import { irErrorEnvelope, isJsonMedia, mediaEssence, sdkModel, sseEventSchema } from "../../ir/sdk-model.js";
2
+ import { bodiesOf } from "../../ir/slots.js";
3
+ import { blockCommentText, tsString } from "../shared/escape.js";
4
+ import { compareCodeUnits, NameTable, pascalWords } from "../shared/lang.js";
5
+ import { quoteKey } from "../shared/literals.js";
6
+ import { irToTs } from "../shared/type-emitter.js";
7
+ import { runtimeFeatures } from "./http.js";
8
+ import { importText, RESERVED, shared } from "./sdk-types-preamble.js";
9
+ import { memberTree } from "./service-map.js";
10
+ import { webhookTypeNames, webhookTypesText } from "./webhooks.js";
11
+ const objectText = (fields) => (fields.length === 0 ? "{}" : `{ ${fields.join("; ")} }`);
12
+ /** A params, search, headers or cookies field from declared parameters. */
13
+ function paramsPart(field, params, value) {
14
+ if (params.length === 0)
15
+ return null;
16
+ const entries = [...params]
17
+ .sort((a, b) => compareCodeUnits(a.name, b.name))
18
+ .map((p) => `${quoteKey(p.name)}${p.required === true ? "" : "?"}: ${value(p)}`);
19
+ return { field, required: params.some((p) => p.required === true), type: objectText(entries) };
20
+ }
21
+ /** The input field a request body fills, by its media type. */
22
+ function bodyField(body) {
23
+ if (body.kind === "stream")
24
+ return "body";
25
+ if (body.kind === "multipart")
26
+ return "form";
27
+ if (isJsonMedia(body.contentType))
28
+ return "json";
29
+ const essence = mediaEssence(body.contentType);
30
+ return essence === "multipart/form-data" || essence === "application/x-www-form-urlencoded" ? "form" : null;
31
+ }
32
+ /** One input field per body kind, the preferred content type of each kind winning: bytes, JSON, a form. */
33
+ function bodyParts(op, ctx) {
34
+ const byField = new Map();
35
+ for (const body of bodiesOf(op.ir)) {
36
+ const field = bodyField(body);
37
+ if (field && !byField.has(field))
38
+ byField.set(field, body);
39
+ }
40
+ return ["body", "json", "form"].flatMap((field) => {
41
+ const body = byField.get(field);
42
+ if (body === undefined)
43
+ return [];
44
+ /* a multipart file part is a Blob, so a File passes; in JSON a binary field stays a string. the form's own
45
+ shape is emitted, never its component's name: one named type cannot be `string` for JSON and `Blob` here,
46
+ and a name is what hid the Blob until bit 22 b */
47
+ const type = body.kind === "stream"
48
+ ? "ArrayBuffer | Blob | ReadableStream<Uint8Array> | Uint8Array"
49
+ : field === "form"
50
+ ? irToTs(ctx.resolve(body.schema), { ...ctx.types, binary: "Blob" })
51
+ : irToTs(body.schema, ctx.types);
52
+ return [{ field, required: body.required, type }];
53
+ });
54
+ }
55
+ /** A call's input object, and whether it must be passed. */
56
+ function inputOf(op, ctx) {
57
+ const { types } = ctx;
58
+ /* a header or cookie is text on the wire: an enum keeps its values, anything else is a string */
59
+ const text = (p) => (p.schema.kind === "scalar" && p.schema.enum ? irToTs(p.schema, types) : "string");
60
+ const pathParams = op.pathParams.map((p) => ({ ...p, required: true }));
61
+ const parts = [
62
+ paramsPart("params", pathParams, (p) => irToTs(p.schema, types)),
63
+ paramsPart("search", op.query, (p) => irToTs(p.schema, types)),
64
+ paramsPart("headers", op.headers, text),
65
+ paramsPart("cookies", op.ir.params.cookie ?? [], text),
66
+ ...bodyParts(op, ctx),
67
+ ].filter((part) => part !== null);
68
+ const ordered = [...parts.filter((p) => p.required), ...parts.filter((p) => !p.required)];
69
+ const fields = ordered.map((p) => `${p.field}${p.required ? "" : "?"}: ${p.type}`);
70
+ return { required: parts.some((p) => p.required), type: objectText(fields) };
71
+ }
72
+ /** The data a successful call resolves to: JSON from its schema, text as a string, bytes (A1), else null. */
73
+ function dataOf(op, types) {
74
+ const { kind, schema } = op.success;
75
+ if (kind === "none")
76
+ return "null";
77
+ if (kind === "text")
78
+ return "string";
79
+ if (kind === "binary")
80
+ return "Uint8Array<ArrayBuffer>";
81
+ return schema ? irToTs(schema, types) : "unknown";
82
+ }
83
+ /** The declared error bodies by concrete status; honey's envelope with its keys as literals. */
84
+ function errorsOf(op, types, resolve) {
85
+ const entries = op.errorStatuses.flatMap((status) => {
86
+ const response = op.ir.responses[String(status)];
87
+ if (!response?.schema || !response.contentType || !isJsonMedia(response.contentType))
88
+ return [];
89
+ const envelope = irErrorEnvelope(response.schema, resolve);
90
+ if (!envelope)
91
+ return [`${status}: ${irToTs(response.schema, types)}`];
92
+ return [`${status}: ErrorEnvelope<${envelope.status}, ${envelope.keys.map(tsString).join(" | ")}>`];
93
+ });
94
+ return entries.length === 0 ? null : `{ ${entries.join("; ")} }`;
95
+ }
96
+ /** The success answer's declared headers, lower case, a required one required (A2). */
97
+ function headersOf(op) {
98
+ const declared = op.ir.responses[op.success.status]?.headers ?? [];
99
+ if (declared.length === 0)
100
+ return null;
101
+ const byName = new Map(declared.map((h) => [h.name.toLowerCase(), h.required]));
102
+ const fields = [...byName].sort(([a], [b]) => compareCodeUnits(a, b));
103
+ return objectText(fields.map(([name, required]) => `${quoteKey(name)}${required ? "" : "?"}: string`));
104
+ }
105
+ /** `op`'s member line `name`: a REST call a HoneyCall, a stream a HoneyStream, defaults dropped; a connection its method. */
106
+ function signature(name, op, ctx) {
107
+ const input = inputOf(op, ctx);
108
+ const arg = (extra) => {
109
+ const type = input.type === "{}" ? extra : `${input.type} & ${extra}`;
110
+ return `${input.required ? "input" : "input?"}: ${type}`;
111
+ };
112
+ const key = quoteKey(name);
113
+ /* a realtime op is one resumable connection of its event data; any other is typed by its transport */
114
+ const { realtime, sse, websocket } = op.ir.extensions;
115
+ if (realtime) {
116
+ const events = sseEventSchema(op.ir, ctx.resolve);
117
+ return `${key}(${arg("RealtimeCallOptions")}): ResumableConnection<${events ? irToTs(events, ctx.types) : "unknown"}>`;
118
+ }
119
+ if (websocket)
120
+ return `${key}(${arg("WsOptions")}): TypedWebSocket`;
121
+ const errors = errorsOf(op, ctx.types, ctx.resolve);
122
+ if (sse) {
123
+ const events = sseEventSchema(op.ir, ctx.resolve);
124
+ const event = events === undefined ? "SSEEvent" : `SSEEvent<${irToTs(events, ctx.types)}>`;
125
+ return `${key}: HoneyStream<${[input.type, event, ...(errors === null ? [] : [errors])].join(", ")}>`;
126
+ }
127
+ const headers = headersOf(op);
128
+ const tail = headers === null ? (errors === null ? [] : [errors]) : [errors ?? "never", headers];
129
+ return `${key}: HoneyCall<${[input.type, dataOf(op, ctx.types), ...tail].join(", ")}>`;
130
+ }
131
+ /* every line break a comment splits at, as the shared comment writers split (escape.ts) */
132
+ const LINE_BREAKS = /\r\n|\r|\n|\u2028|\u2029/;
133
+ /**
134
+ * `op`'s summary and description as a JSDoc block above its overloads at `indent`, a paragraph each, as Go, Rust,
135
+ * Python and C# write them; spec text made inert by blockCommentText. None for an operation with neither.
136
+ */
137
+ function opDoc(op, indent) {
138
+ const paragraphs = [op.summary, op.description].filter((text) => text !== "");
139
+ if (paragraphs.length === 0)
140
+ return [];
141
+ const lines = paragraphs.flatMap((text, i) => [
142
+ ...(i === 0 ? [] : [""]),
143
+ ...blockCommentText(text).split(LINE_BREAKS),
144
+ ]);
145
+ return [
146
+ `${indent}/**`,
147
+ ...lines.map((line) => (line.trim() === "" ? `${indent} *` : `${indent} * ${line}`)),
148
+ `${indent} */`,
149
+ ];
150
+ }
151
+ /** A namespace's members as type-literal lines, nested namespaces as nested literals. */
152
+ function members(ns, ctx, indent) {
153
+ return [...ns.entries].flatMap(([name, entry]) => {
154
+ if (entry.kind === "method") {
155
+ const op = ctx.ops.get(entry.op.id);
156
+ return [...opDoc(op, indent), `${indent}${signature(name, op, ctx)}`];
157
+ }
158
+ return [`${indent}${quoteKey(name)}: {`, ...members(entry.ns, ctx, `${indent}\t`), `${indent}}`];
159
+ });
160
+ }
161
+ /**
162
+ * The component schemas' declared names, clear of `reserved` (the names the emitted file declares
163
+ * and the globals it reads), claimed in code-unit order so the same document names them alike.
164
+ */
165
+ export function componentNames(ir, reserved) {
166
+ const table = new NameTable(reserved);
167
+ for (const schema of Object.keys(ir.schemas).sort(compareCodeUnits)) {
168
+ const base = pascalWords(schema) || "Schema";
169
+ table.get(schema, /^[0-9]/.test(base) ? `Schema${base}` : base);
170
+ }
171
+ return (schema) => table.get(schema, "Schema");
172
+ }
173
+ /** The config type: `baseURL` optional when the document declares a server, the first one being its default. */
174
+ function configText(name, server, runtimeConfig) {
175
+ const head = `export type ${name}Config =`;
176
+ if (server === undefined)
177
+ return `${head} ${runtimeConfig}`;
178
+ return `${head} Omit<${runtimeConfig}, "baseURL"> & {
179
+ /** Default: the document's first server, ${blockCommentText(server)} */
180
+ baseURL?: string
181
+ }`;
182
+ }
183
+ /** The `${stem}.types.gen.ts` text of `ir` for the SDK `name`, importing the runtime module `runtime`. */
184
+ export function sdkTypesText(ir, name, runtime) {
185
+ const model = sdkModel(ir);
186
+ /* the SDK named `SDK` declares `SDKConfig`, so the runtime's own is imported under another name */
187
+ const aliases = name === "SDK" ? { SDKConfig: "HoneySDKConfig" } : {};
188
+ const runtimeConfig = aliases["SDKConfig"] ?? "SDKConfig";
189
+ const own = [
190
+ name,
191
+ `${name}Config`,
192
+ `${name}Operations`,
193
+ `${name}Safe`,
194
+ ...webhookTypeNames(ir),
195
+ ...Object.values(aliases),
196
+ ];
197
+ const types = { refName: componentNames(ir, [...RESERVED, ...own]) };
198
+ const ctx = { ops: model.opsById, resolve: model.resolve, types };
199
+ const schemas = model.schemaNames.map((schema) => `export type ${types.refName?.(schema)} = ${irToTs(ir.schemas[schema], types)}`);
200
+ const body = `${schemas.length === 0 ? "" : `${schemas.join("\n")}\n\n`}${webhookTypesText(ir, types)}${shared(runtimeFeatures(ir))}
201
+ ${configText(name, ir.servers[0], runtimeConfig)}
202
+
203
+ /** Every operation of the SDK, by its member path. */
204
+ export interface ${name}Operations {
205
+ ${members(memberTree(ir.tree), ctx, "\t").join("\n")}
206
+ }
207
+
208
+ /** \`client.safe\`: every operation, a call answering a Result. */
209
+ export type ${name}Safe = HoneySafe<${name}Operations>
210
+ `;
211
+ return `${importText(body, runtime, aliases)}
212
+ ${body}`;
213
+ }
@@ -0,0 +1,21 @@
1
+ export { sdkMemberPaths, serviceMapOf } from "./service-map.ts";
2
+ export type SdkOptions = {
3
+ /** the SDK class name, a TypeScript identifier */
4
+ readonly name: string;
5
+ /** the file-name stem; the name kebab-cased when left out (`TestSDK` → `test-sdk`) */
6
+ readonly stem?: string;
7
+ /** also write `<stem>.tanstack-query.gen.ts`; `@tanstack/query-core` is then the consumer's own peer */
8
+ readonly tanstackQuery?: boolean;
9
+ };
10
+ /**
11
+ * The SDK's files, its stem, the document's own version, and what the generation tells its caller: a root group
12
+ * renamed off the safe mirror.
13
+ */
14
+ export type GeneratedSdk = {
15
+ readonly files: Readonly<Record<string, string>>;
16
+ readonly notices: readonly string[];
17
+ readonly stem: string;
18
+ readonly version: string | undefined;
19
+ };
20
+ /** The SDK files for `document`, by file name, and their stem. */
21
+ export declare function generateSdk(document: Record<string, unknown>, options: SdkOptions): GeneratedSdk;