@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,124 @@
1
+ export type HeadersContext = {
2
+ method: string
3
+ path: string
4
+ }
5
+
6
+ type HeadersRecord = Record<string, string | undefined>
7
+
8
+ export type HeadersInit = ((ctx: HeadersContext) => HeadersRecord | Promise<HeadersRecord>) | HeadersRecord
9
+
10
+ /** What the SDK knows of a read's staleness, handed to the request and response hooks. */
11
+ export type RequestMeta = {
12
+ invalidatedBy: string[]
13
+ isStale: boolean
14
+ selector: string
15
+ seqSnapshot: number
16
+ }
17
+
18
+ export type OnRequestContext = {
19
+ body?: BodyInit | undefined
20
+ headers: Headers
21
+ invalidatedBy?: string[] | undefined
22
+ isStale?: boolean | undefined
23
+ method: string
24
+ /** the operation's path template, as the document spells it (`/items/{id}`), never the filled-in URL */
25
+ path: string
26
+ selector?: string | undefined
27
+ state: Record<string, unknown>
28
+ url: string
29
+ }
30
+
31
+ export type OnResponseContext = {
32
+ invalidatedBy?: string[]
33
+ isRetry: boolean
34
+ isStale?: boolean
35
+ method: string
36
+ /** the operation's path template, as the document spells it (`/items/{id}`), never the filled-in URL */
37
+ path: string
38
+ readonly request: Request
39
+ response: Response
40
+ /**
41
+ * Send the request once more and resolve with the new response, whatever its status. On a
42
+ * request that is itself a retry, it resolves with the current response (one retry max).
43
+ */
44
+ retry: () => Promise<Response>
45
+ selector?: string
46
+ state: Record<string, unknown>
47
+ url: string
48
+ }
49
+
50
+ /**
51
+ * - `same-origin` (default): follow redirects that stay on the base URL's origin; a cross-origin
52
+ * redirect is returned unfollowed (a non-2xx result). In browsers, which hide redirect targets
53
+ * from script, the platform follows and applies CORS to the target.
54
+ * - `follow`: also follow cross-origin redirects. Such a hop carries only `Accept`,
55
+ * `Accept-Language` and `User-Agent` (no credentials, auth header, configured, per-call or
56
+ * `onRequest` header) and never replays a body.
57
+ * - `manual` / `error`: passed to `fetch`.
58
+ */
59
+ export type RedirectPolicy = "error" | "follow" | "manual" | "same-origin"
60
+
61
+ /**
62
+ * One `onLog` entry: what happened to which operation and how long it took. `operation` is `METHOD` and the
63
+ * path template, the same spelling a hook's `ctx.path` carries (`GET /items/{id}`).
64
+ */
65
+ export type LogEntry = {
66
+ duration_ms: number
67
+ error?: unknown
68
+ event: "error" | "hook_executed" | "request_start" | "response_received"
69
+ level: "debug" | "error" | "info" | "warn"
70
+ operation: string
71
+ status?: number
72
+ }
73
+
74
+ export type AuthExpiredContext = {
75
+ /** The token the 401 rejected (read from the auth header), so concurrent 401s can share one refresh. */
76
+ rejectedToken: string | null
77
+ }
78
+
79
+ export type ClientConfig = {
80
+ /** The header for `onAuthExpired`'s token: unset, the API's scheme's; set, its prefix is yours (unset: none). */
81
+ authHeaderName?: string
82
+ /** That header's prefix; set alone, the scheme's header keeps it. */
83
+ authHeaderPrefix?: string
84
+ /** Absolute `http(s):` / `ws(s):` URL, or a same-origin path such as `"/api"`. */
85
+ baseURL: string
86
+ buildSearchParams?: (query: Record<string, unknown>) => URLSearchParams
87
+ credentials?: RequestCredentials
88
+ /** Defaults to the environment `fetch`, bound so it is safe to call in browsers. */
89
+ fetch?: typeof fetch
90
+ headers?: HeadersInit
91
+ /** The most characters of a server's error message a ClientError carries. Default 512. */
92
+ maxErrorMessageChars?: number
93
+ /**
94
+ * The most bytes a response body may hold, decoded, before its read is refused with a ClientError and the body
95
+ * cancelled: it is read in the chunks it arrives in, never whole. Default 100 MiB. Streams are bounded by their
96
+ * own per-event caps instead.
97
+ */
98
+ maxResponseBytes?: number
99
+ mode?: RequestMode
100
+ /**
101
+ * Called on a 401. Return a fresh token to retry the request once with it (and use it for later
102
+ * requests); return null or "" to give up. Concurrent 401s share one call. Requests whose body
103
+ * is a stream are not retried.
104
+ */
105
+ onAuthExpired?: (ctx: AuthExpiredContext) => Promise<string | null | undefined> | string | null | undefined
106
+ /** Called at each exchange's start, its answer and its failure (v0's entry shape). */
107
+ onLog?: (entry: LogEntry) => void
108
+ onReconnected?: () => void
109
+ onReconnecting?: (attempt: number, transport: string) => void
110
+ onRequest?: Array<(ctx: OnRequestContext) => Promise<void> | void>
111
+ onResponse?: Array<(ctx: OnResponseContext) => Promise<Response | undefined> | Response | undefined>
112
+ /** Redirect handling; see `RedirectPolicy`. Default `"same-origin"`. */
113
+ redirect?: RedirectPolicy
114
+ /** Send an `x-request-id` header on every request. Default `true`; `false` avoids a CORS preflight. */
115
+ requestId?: boolean
116
+ sortSearchParams?: boolean
117
+ /** The most UTF-8 bytes one event-stream line may hold before the stream errors. Default 1 MiB. */
118
+ sseMaxLineBytes?: number
119
+ /** The most UTF-8 bytes one event's data may hold, its joining newlines counted. Default 8 MiB. */
120
+ sseMaxEventBytes?: number
121
+ state?: Record<string, unknown>
122
+ /** Milliseconds for a whole request, including reading the body; a stream's only up to its headers. */
123
+ timeout?: number
124
+ }
@@ -0,0 +1,48 @@
1
+ /** Absolute client bases: http(s) and ws(s). Case-insensitive per WHATWG. */
2
+ const ABSOLUTE_CLIENT_URL = /^(?:https?|wss?):\/\//i
3
+
4
+ export function invalidBaseURLError(baseURL: string): Error {
5
+ return new Error(
6
+ `Invalid baseURL ${JSON.stringify(baseURL)}: expected an absolute http(s): or ws(s): URL. Path-only values such as "/api" resolve against location.origin in browsers.`,
7
+ )
8
+ }
9
+
10
+ /**
11
+ * Honor `config.fetch` as-is. If omitted, bind the environment fetch so storing it on a client
12
+ * field does not throw `Illegal invocation` in browsers.
13
+ */
14
+ export function bindDefaultFetch(custom?: typeof fetch): typeof fetch {
15
+ if (custom) return custom
16
+ const nativeFetch = globalThis.fetch
17
+ return typeof nativeFetch === "function" ? nativeFetch.bind(globalThis) : (nativeFetch as typeof fetch)
18
+ }
19
+
20
+ function currentLocationOrigin(): string | undefined {
21
+ let origin: unknown
22
+ try {
23
+ origin = globalThis.location?.origin
24
+ } catch {
25
+ /* a sandboxed location that throws on read: there is no origin to resolve against */
26
+ return undefined
27
+ }
28
+ if (typeof origin !== "string" || origin === "" || origin === "null") return undefined
29
+ if (!ABSOLUTE_CLIENT_URL.test(origin)) return undefined
30
+ return origin
31
+ }
32
+
33
+ /**
34
+ * Parse `baseURL`. Absolute `http(s):` / `ws(s):` URLs are unchanged. Path-only values such as
35
+ * `/api` resolve against `location.origin` when present.
36
+ */
37
+ export function parseClientBaseURL(baseURL: string): URL {
38
+ if (ABSOLUTE_CLIENT_URL.test(baseURL)) return new URL(baseURL)
39
+ const origin = currentLocationOrigin()
40
+ if (origin !== undefined) {
41
+ try {
42
+ return new URL(baseURL, origin)
43
+ } catch {
44
+ throw invalidBaseURLError(baseURL)
45
+ }
46
+ }
47
+ throw invalidBaseURLError(baseURL)
48
+ }
@@ -0,0 +1,113 @@
1
+ export type ClientErrorInit<TBody = unknown> = {
2
+ body: TBody
3
+ cause?: unknown
4
+ message: string
5
+ response: Response
6
+ status: number
7
+ }
8
+
9
+ /** A non-2xx answer: its status, the parsed body (JSON when it parses, else text) and the response. */
10
+ export class ClientError<TBody = unknown> extends Error {
11
+ readonly body: TBody
12
+ readonly response: Response
13
+ readonly status: number
14
+
15
+ constructor(init: ClientErrorInit<TBody>) {
16
+ super(init.message, init)
17
+ /* V8 only, and not in every lib: read it as optional so the runtime compiles anywhere */
18
+ ;(Error as { captureStackTrace?: (target: object, ctor?: unknown) => void }).captureStackTrace?.(this, new.target)
19
+ this.name = "ClientError"
20
+ this.body = init.body
21
+ this.response = init.response
22
+ this.status = init.status
23
+ }
24
+ }
25
+
26
+ export class BadRequestError<TBody = unknown> extends ClientError<TBody> {
27
+ override name = "BadRequestError"
28
+ }
29
+ export class UnauthorizedError<TBody = unknown> extends ClientError<TBody> {
30
+ override name = "UnauthorizedError"
31
+ }
32
+ export class ForbiddenError<TBody = unknown> extends ClientError<TBody> {
33
+ override name = "ForbiddenError"
34
+ }
35
+ export class NotFoundError<TBody = unknown> extends ClientError<TBody> {
36
+ override name = "NotFoundError"
37
+ }
38
+ export class ConflictError<TBody = unknown> extends ClientError<TBody> {
39
+ override name = "ConflictError"
40
+ }
41
+ export class UnprocessableEntityError<TBody = unknown> extends ClientError<TBody> {
42
+ override name = "UnprocessableEntityError"
43
+ }
44
+ export class RateLimitError<TBody = unknown> extends ClientError<TBody> {
45
+ override name = "RateLimitError"
46
+ }
47
+ export class InternalServerError<TBody = unknown> extends ClientError<TBody> {
48
+ override name = "InternalServerError"
49
+ }
50
+ export class BadGatewayError<TBody = unknown> extends ClientError<TBody> {
51
+ override name = "BadGatewayError"
52
+ }
53
+ export class ServiceUnavailableError<TBody = unknown> extends ClientError<TBody> {
54
+ override name = "ServiceUnavailableError"
55
+ }
56
+ export class GatewayTimeoutError<TBody = unknown> extends ClientError<TBody> {
57
+ override name = "GatewayTimeoutError"
58
+ }
59
+
60
+ /** A 2xx whose body is no value of its operation: the text (null past the size cap), the parse error its cause. */
61
+ export class DecodeError extends ClientError<string | null> {
62
+ /* a literal, so a declared error with a string body never reads as one */
63
+ override readonly name = "DecodeError"
64
+ }
65
+
66
+ const STATUS_ERRORS: Readonly<Record<number, new (init: ClientErrorInit) => ClientError>> = {
67
+ 400: BadRequestError,
68
+ 401: UnauthorizedError,
69
+ 403: ForbiddenError,
70
+ 404: NotFoundError,
71
+ 409: ConflictError,
72
+ 422: UnprocessableEntityError,
73
+ 429: RateLimitError,
74
+ 500: InternalServerError,
75
+ 502: BadGatewayError,
76
+ 503: ServiceUnavailableError,
77
+ 504: GatewayTimeoutError,
78
+ }
79
+
80
+ /** The most specific error class for a status: `UnauthorizedError` for 401, `ClientError` otherwise. */
81
+ export function clientErrorFor<TBody>(init: ClientErrorInit<TBody>): ClientError<TBody> {
82
+ const Cls = (Object.hasOwn(STATUS_ERRORS, init.status) ? STATUS_ERRORS[init.status] : undefined) ?? ClientError
83
+ return new Cls(init) as ClientError<TBody>
84
+ }
85
+
86
+ export function isClientError<T = unknown>(e: unknown): e is ClientError<T> {
87
+ return e instanceof ClientError
88
+ }
89
+
90
+ /** A request with no answer; the platform error is its `cause`. */
91
+ export class APIConnectionError extends Error {
92
+ override name = "APIConnectionError"
93
+ }
94
+
95
+ /** A send or body read with no answer as APIConnectionError, its cause the platform's; an abort's as it is (f2). */
96
+ export function noAnswer(cause: unknown, url: unknown, init?: RequestInit): unknown {
97
+ if (init?.signal?.aborted) return cause
98
+ const { origin, pathname } = new URL(String(url))
99
+ return new APIConnectionError(`${init?.method} ${origin}${pathname}: the connection failed`, { cause })
100
+ }
101
+
102
+ /** A fetch failure as APIConnectionError; an abort's as it is. */
103
+ export function connectionErrors(fetch: typeof globalThis.fetch): typeof globalThis.fetch {
104
+ if (typeof fetch !== "function") return fetch
105
+ /* asserted, as Bun's fetch type also names `preconnect` */
106
+ return (async (input, init) => {
107
+ try {
108
+ return await fetch(input, init)
109
+ } catch (cause) {
110
+ throw noAnswer(cause, input, init)
111
+ }
112
+ }) as typeof globalThis.fetch
113
+ }
@@ -0,0 +1,92 @@
1
+ import type { ClientConfig, LogEntry, OnRequestContext, OnResponseContext, RequestMeta } from "./config.ts"
2
+ import { isReplayable } from "./request.ts"
3
+
4
+ /** Where a response hook runs: the request as sent, its answer, and how to send it again. */
5
+ export type ResponseAt = {
6
+ init: RequestInit
7
+ isRetry: boolean
8
+ meta: RequestMeta | undefined
9
+ method: string
10
+ path: string
11
+ response: Response
12
+ retry: () => Promise<Response>
13
+ state: Record<string, unknown>
14
+ url: URL
15
+ }
16
+
17
+ /**
18
+ * `init` as a `Request` can take it: a body that cannot be sent twice is left out, never set to
19
+ * `undefined`, which `RequestInit` does not declare.
20
+ */
21
+ function replayable(init: RequestInit): RequestInit {
22
+ if (isReplayable(init.body)) return init
23
+ const { body: _body, ...rest } = init
24
+ return rest
25
+ }
26
+
27
+ /** `ctx` with the read's stale view, when the SDK tracks one. */
28
+ function withMeta<T extends object>(ctx: T, meta: RequestMeta | undefined): T {
29
+ if (meta) Object.assign(ctx, { invalidatedBy: meta.invalidatedBy, isStale: meta.isStale, selector: meta.selector })
30
+ return ctx
31
+ }
32
+
33
+ /** Let each `onRequest` hook see the request and change it; resolves to the body it now sends. */
34
+ export async function runRequestHooks(
35
+ hooks: NonNullable<ClientConfig["onRequest"]>,
36
+ ctx: OnRequestContext,
37
+ meta: RequestMeta | undefined,
38
+ ): Promise<BodyInit | undefined> {
39
+ withMeta(ctx, meta)
40
+ for (const hook of hooks) await hook(ctx)
41
+ return ctx.body
42
+ }
43
+
44
+ /** Let each `onResponse` hook see the answer and replace it. */
45
+ export async function runResponseHooks(
46
+ hooks: NonNullable<ClientConfig["onResponse"]>,
47
+ at: ResponseAt,
48
+ ): Promise<Response> {
49
+ let request: Request | undefined
50
+ const { init } = at
51
+ const ctx: OnResponseContext = {
52
+ isRetry: at.isRetry,
53
+ method: at.method,
54
+ path: at.path,
55
+ get request() {
56
+ /* built on demand: constructing a Request per response is not free */
57
+ request ??= new Request(at.url.toString(), replayable(init))
58
+ return request
59
+ },
60
+ response: at.response,
61
+ retry: () => (at.isRetry ? Promise.resolve(ctx.response) : at.retry()),
62
+ state: at.state,
63
+ url: at.url.toString(),
64
+ }
65
+ withMeta(ctx, at.meta)
66
+ for (const hook of hooks) {
67
+ const result = await hook(ctx)
68
+ if (result instanceof Response) ctx.response = result
69
+ }
70
+ return ctx.response
71
+ }
72
+
73
+ /** The `onLog` entries of one exchange: its start now, then its answer or its failure, each with its duration. */
74
+ export function exchangeLog(
75
+ onLog: ((entry: LogEntry) => void) | undefined,
76
+ operation: string,
77
+ ): { answered: (response: Response) => void; failed: (error: unknown) => void } {
78
+ const start = Date.now()
79
+ onLog?.({ duration_ms: 0, event: "request_start", level: "debug", operation })
80
+ const took = () => Date.now() - start
81
+ return {
82
+ answered: (response) => {
83
+ const level = response.status >= 400 ? "warn" : "info"
84
+ onLog?.({ duration_ms: took(), event: "response_received", level, operation, status: response.status })
85
+ },
86
+ failed: (error) => {
87
+ const status = (error as { status?: unknown } | null)?.status
88
+ const entry: LogEntry = { duration_ms: took(), error, event: "error", level: "error", operation }
89
+ onLog?.(typeof status === "number" ? { ...entry, status } : entry)
90
+ },
91
+ }
92
+ }
@@ -0,0 +1,228 @@
1
+ import type { ClientConfig, HeadersContext, RequestMeta } from "./config.ts"
2
+ import { bindDefaultFetch, parseClientBaseURL } from "./defaults.ts"
3
+ import { connectionErrors, noAnswer } from "./error.ts"
4
+ import { exchangeLog, runRequestHooks, runResponseHooks } from "./hooks.ts"
5
+ import { interpolatePath } from "./path.ts"
6
+ import { fetchFollowing } from "./redirects.ts"
7
+ import {
8
+ defaultSearchParams,
9
+ encodeBody,
10
+ headersOf,
11
+ isReplayable,
12
+ type RequestKind,
13
+ type RequestOptions,
14
+ requestInit,
15
+ requestSignal,
16
+ } from "./request.ts"
17
+ import { type Answer, finishRequest, type Reading, type Sent } from "./response.ts"
18
+
19
+ /** One request, ready to send: where, with what, and the hooks' view of it. */
20
+ type Prepared = { body: BodyInit | undefined; headers: Headers; url: URL }
21
+
22
+ /** One call: its method, path template and options; `refreshes: false` leaves a 401 to the realtime loop. */
23
+ export type Call = { method: string; opts: RequestOptions; path: string; refreshes?: false | undefined }
24
+
25
+ /** The realtime loop's refresh key, exported by the SDK under no name. */
26
+ export const REFRESH_AUTH: unique symbol = /* @__PURE__ */ Symbol("honey.refreshAuth")
27
+
28
+ /** The send and the config, for the stream functions beside the client. */
29
+ export const SEND: unique symbol = /* @__PURE__ */ Symbol("honey.send")
30
+ export const CONFIG: unique symbol = /* @__PURE__ */ Symbol("honey.config")
31
+
32
+ /** One operation of a generated SDK: the call, how it is read, and its stale view for the hooks. */
33
+ export type Operation = Call & {
34
+ /** the non-JSON media type the operation declares, read as that type; null when it declares no body */
35
+ declared?: string | null | undefined
36
+ meta?: RequestMeta | undefined
37
+ }
38
+
39
+ /** Ignore a failed cancel: the body is being discarded either way. */
40
+ const discard = (response: Response) =>
41
+ response.body?.cancel().catch(() => {
42
+ /* discarded */
43
+ })
44
+
45
+ export class HTTPClient {
46
+ readonly #config: ClientConfig
47
+ readonly #fetch: typeof fetch
48
+ #base: URL | undefined
49
+ #token: string | null = null
50
+ #refreshing: Promise<string | null> | null = null
51
+
52
+ readonly #disposal: AbortSignal | undefined
53
+
54
+ /** `disposal` aborts every request in flight and refuses later ones (a generated SDK's `dispose()`). */
55
+ constructor(config: ClientConfig, disposal?: AbortSignal) {
56
+ this.#config = config
57
+ this.#fetch = connectionErrors(bindDefaultFetch(config.fetch))
58
+ this.#disposal = disposal
59
+ }
60
+
61
+ /** The base URL, parsed once; a per-call base (C2) is parsed for that call. */
62
+ #baseFor(opts: RequestOptions): URL {
63
+ if (opts.baseURL !== undefined) return parseClientBaseURL(opts.baseURL)
64
+ this.#base ??= parseClientBaseURL(this.#config.baseURL)
65
+ return this.#base
66
+ }
67
+
68
+ get #authName(): string {
69
+ return this.#config.authHeaderName ?? "Authorization"
70
+ }
71
+
72
+ get #authPrefix(): string {
73
+ return this.#config.authHeaderPrefix ?? (this.#config.authHeaderName === undefined ? "Bearer " : "")
74
+ }
75
+
76
+ #query(search: Record<string, unknown>): URLSearchParams {
77
+ const params = (this.#config.buildSearchParams ?? defaultSearchParams)(search)
78
+ if (this.#config.sortSearchParams) params.sort()
79
+ return params
80
+ }
81
+
82
+ /** Resolve `path` against the base URL, keeping the base path and query, and assert it stays there. */
83
+ #url(path: string, opts: RequestOptions): URL {
84
+ const resolved = interpolatePath(path, opts.params)
85
+ const base = this.#baseFor(opts)
86
+ const basePath = base.pathname.endsWith("/") ? base.pathname : `${base.pathname}/`
87
+ const url = new URL(base.href)
88
+ url.pathname = `${basePath}${resolved.startsWith("/") ? resolved.slice(1) : resolved}`
89
+ url.hash = ""
90
+ /* params are validated, so this only fires on a malformed template; never send it anywhere else */
91
+ if (url.origin !== base.origin || !url.pathname.startsWith(basePath.slice(0, -1))) {
92
+ throw new Error(`Request path ${JSON.stringify(path)} resolves outside the base URL`)
93
+ }
94
+ if (opts.search) for (const [k, v] of this.#query(opts.search).entries()) url.searchParams.append(k, v)
95
+ return url
96
+ }
97
+
98
+ async #headers(opts: RequestOptions, ctx: HeadersContext): Promise<Headers> {
99
+ const configured = this.#config.headers
100
+ const resolved = typeof configured === "function" ? await configured(ctx) : configured
101
+ /* a refreshed token replaces the configured one; per-call headers still win */
102
+ const auth = this.#token === null ? {} : { [this.#authName]: `${this.#authPrefix}${this.#token}` }
103
+ return headersOf([resolved ?? {}, auth, opts.headers ?? {}], opts.cookies, this.#config.requestId !== false)
104
+ }
105
+
106
+ /** Share one `onAuthExpired` call between concurrent 401s; reuse a token another request already got. */
107
+ #refresh(rejectedToken: string | null): Promise<string | null> {
108
+ if (this.#token !== null && rejectedToken !== this.#token) return Promise.resolve(this.#token)
109
+ if (this.#refreshing) return this.#refreshing
110
+ const hook = this.#config.onAuthExpired
111
+ if (!hook) return Promise.resolve(null)
112
+ this.#refreshing = Promise.resolve()
113
+ .then(() => hook({ rejectedToken }))
114
+ .then((token) => {
115
+ this.#token = typeof token === "string" && token.length > 0 ? token : null
116
+ return this.#token
117
+ })
118
+ .finally(() => {
119
+ this.#refreshing = null
120
+ })
121
+ return this.#refreshing
122
+ }
123
+
124
+ /** @internal */
125
+ get [CONFIG](): ClientConfig {
126
+ return this.#config
127
+ }
128
+
129
+ /** @internal One request sent: its hooks run, its auth refreshed, its redirects followed. */
130
+ [SEND](call: Call, kind: RequestKind, meta?: RequestMeta): Promise<Sent> {
131
+ return this.#send(call, kind, meta)
132
+ }
133
+
134
+ /** @internal The client's one shared refresh; whether a new token is in place. */
135
+ async [REFRESH_AUTH](): Promise<boolean> {
136
+ return (await this.#refresh(this.#token)) !== null
137
+ }
138
+
139
+ /** Build the request and let the `onRequest` hooks see and change it. */
140
+ async #prepare({ method, opts, path }: Call, kind: RequestKind, meta?: RequestMeta) {
141
+ const url = this.#url(path, opts)
142
+ const headers = await this.#headers(opts, { method, path })
143
+ if (kind === "stream") {
144
+ headers.set("accept", "text/event-stream")
145
+ if (opts.lastEventId) headers.set("last-event-id", opts.lastEventId)
146
+ }
147
+ const prepared: Prepared = { body: encodeBody(opts, headers), headers, url }
148
+ if (!this.#config.onRequest) return prepared
149
+ const ctx = { body: prepared.body, headers, method, path, state: this.#config.state ?? {}, url: url.toString() }
150
+ prepared.body = await runRequestHooks(this.#config.onRequest, ctx, meta)
151
+ return prepared
152
+ }
153
+
154
+ /** Send, following redirects; on a 401 with a refresh hook, retry once with the fresh token. */
155
+ async #transmit(url: URL, init: RequestInit, isRetry: boolean): Promise<Response> {
156
+ const options = { origin: url.origin, policy: this.#config.redirect ?? "same-origin" }
157
+ const response = await fetchFollowing(this.#fetch, url, init, options)
158
+ if (response.status !== 401 || !this.#config.onAuthExpired || isRetry || !isReplayable(init.body)) return response
159
+ const sent = (init.headers as Headers).get(this.#authName)
160
+ const rejected = sent?.startsWith(this.#authPrefix) ? sent.slice(this.#authPrefix.length) : (sent ?? null)
161
+ const token = await this.#refresh(rejected)
162
+ if (token === null) return response
163
+ const headers = new Headers(init.headers)
164
+ headers.set(this.#authName, `${this.#authPrefix}${token}`)
165
+ init.headers = headers
166
+ await discard(response)
167
+ return fetchFollowing(this.#fetch, url, { ...init }, options)
168
+ }
169
+
170
+ /** Build, send and post-process one request: hooks, auth refresh, redirects. */
171
+ async #send(call: Call, kind: RequestKind, meta?: RequestMeta, isRetry = false): Promise<Sent> {
172
+ const { method, opts, path } = call
173
+ const { body, headers, url } = await this.#prepare(call, kind, meta)
174
+ const timeout = opts.timeout ?? this.#config.timeout
175
+ const { done, exemptFromTimeout, signal } = requestSignal([opts.signal, this.#disposal], timeout)
176
+ const cleanups: Array<() => void> = [done]
177
+ const finish = () => {
178
+ for (const fn of cleanups.splice(0)) fn()
179
+ }
180
+ const init = requestInit({ body, headers, method, signal }, this.#config)
181
+ const log = exchangeLog(this.#config.onLog, `${method.toUpperCase()} ${path}`)
182
+ try {
183
+ signal?.throwIfAborted()
184
+ let response = await this.#transmit(url, init, isRetry || call.refreshes === false)
185
+ log.answered(response)
186
+ if (this.#config.onResponse) {
187
+ const retry = async () => {
188
+ const again = await this.#send(call, kind, meta, true)
189
+ cleanups.push(again.done)
190
+ return again.response
191
+ }
192
+ const state = this.#config.state ?? {}
193
+ const at = { init, isRetry, meta, method, path, response, retry, state, url }
194
+ response = await runResponseHooks(this.#config.onResponse, at)
195
+ }
196
+ return { done: finish, exemptFromTimeout, failed: (cause) => noAnswer(cause, url, init), response }
197
+ } catch (e) {
198
+ finish()
199
+ log.failed(e)
200
+ throw e
201
+ }
202
+ }
203
+
204
+ #reading(method: string, opts: RequestOptions): Reading {
205
+ return { limits: this.#config, method, raw: opts.raw }
206
+ }
207
+
208
+ /** The parsed body; a non-2xx throws its ClientError (a per-status subclass). */
209
+ async request(method: string, path: string, opts: RequestOptions, meta?: RequestMeta): Promise<unknown> {
210
+ return (await this.requestOperation({ meta, method, opts, path })).data
211
+ }
212
+
213
+ /** One REST operation's answer, read as `op` says: parsed, or raw. */
214
+ async requestOperation(op: Operation): Promise<Answer> {
215
+ const sent = await this.#send(op, "rest", op.meta)
216
+ return finishRequest(sent, { ...this.#reading(op.method, op.opts), declared: op.declared })
217
+ }
218
+
219
+ buildUrl(path: string, opts: RequestOptions): string {
220
+ return this.#url(path, opts).toString()
221
+ }
222
+
223
+ buildPath(path: string, opts: RequestOptions): string {
224
+ const resolved = interpolatePath(path, opts.params)
225
+ const qs = opts.search ? this.#query(opts.search).toString() : ""
226
+ return qs ? `${resolved}?${qs}` : resolved
227
+ }
228
+ }
@@ -0,0 +1,36 @@
1
+ /** A `Content-Type`, read as far as the client needs it: its essence, type and structured suffix. */
2
+ export type MediaType = {
3
+ /** `type/subtype`, lowercased, without parameters */
4
+ essence: string
5
+ /** the structured-syntax suffix (`json` for `application/vnd.api+json`), or `null` */
6
+ suffix: string | null
7
+ type: string
8
+ }
9
+
10
+ /* RFC 9110 token characters */
11
+ const MEDIA_TOKEN = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+$/
12
+
13
+ /** `value` as a media type; `null` when it is missing or not `token/token`. */
14
+ export function parseMediaType(value: string | null | undefined): MediaType | null {
15
+ if (value === null || value === undefined) return null
16
+ const semi = value.indexOf(";")
17
+ const head = (semi === -1 ? value : value.slice(0, semi)).trim()
18
+ const slash = head.indexOf("/")
19
+ if (slash === -1) return null
20
+ const type = head.slice(0, slash).toLowerCase()
21
+ const subtype = head.slice(slash + 1).toLowerCase()
22
+ if (!MEDIA_TOKEN.test(type) || !MEDIA_TOKEN.test(subtype)) return null
23
+ const plus = subtype.lastIndexOf("+")
24
+ const suffix = plus > 0 && plus < subtype.length - 1 ? subtype.slice(plus + 1) : null
25
+ return { essence: `${type}/${subtype}`, suffix, type }
26
+ }
27
+
28
+ /** JSON bodies: `application/json` and any `+json` type. */
29
+ export function isJsonMediaType(mt: MediaType | null): boolean {
30
+ return mt !== null && (mt.essence === "application/json" || mt.suffix === "json")
31
+ }
32
+
33
+ /** Text-like bodies: `text/*`, `application/xml`, and any `+xml` type. */
34
+ export function isTextMediaType(mt: MediaType | null): boolean {
35
+ return mt !== null && (mt.type === "text" || mt.essence === "application/xml" || mt.suffix === "xml")
36
+ }