@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,175 @@
1
+ /** One server-sent event; `data` is the raw text, or the parsed value when the operation declares JSON events. */
2
+ export type SSEEvent<T = string> = {
3
+ data: T
4
+ event?: string
5
+ /** The last event ID (sticky across events, as `EventSource.lastEventId`). Absent while empty. */
6
+ id?: string
7
+ retry?: number
8
+ }
9
+
10
+ /* the siblings' caps, in UTF-8 bytes */
11
+ const MAX_LINE = 1 << 20
12
+ const MAX_EVENT = 8 << 20
13
+
14
+ /** `text`'s UTF-8 bytes, counted until past `max`. */
15
+ function bytesOf(text: string, max = Infinity): number {
16
+ let bytes = 0
17
+ for (let i = 0; i < text.length && bytes <= max; i++) {
18
+ const unit = text.charCodeAt(i)
19
+ bytes += unit < 0x80 ? 1 : unit < 0x800 || (unit >= 0xd800 && unit < 0xe000) ? 2 : 3
20
+ }
21
+ return bytes
22
+ }
23
+
24
+ /** Whether `line` is over `max` UTF-8 bytes; a third of `max` in code units is within it, uncounted. */
25
+ const overLine = (line: string, max: number) => line.length * 3 > max && bytesOf(line, max) > max
26
+
27
+ /** One event being read: its fields as they arrive, dispatched on a blank line. */
28
+ class EventFields {
29
+ readonly #max: number
30
+ #data: string[] = []
31
+ #size = 0
32
+ #hasData = false
33
+ #event: string | undefined
34
+ #lastId = ""
35
+ #retry: number | undefined
36
+
37
+ constructor(max: number) {
38
+ this.#max = max
39
+ }
40
+
41
+ /** The event so far, when it has data; every field but the sticky id resets. */
42
+ dispatch(): SSEEvent | undefined {
43
+ const out = this.#hasData ? ({ data: this.#data.join("\n") } as SSEEvent) : undefined
44
+ if (out) {
45
+ if (this.#event !== undefined && this.#event !== "") out.event = this.#event
46
+ if (this.#lastId !== "") out.id = this.#lastId
47
+ if (this.#retry !== undefined) out.retry = this.#retry
48
+ this.#retry = undefined
49
+ }
50
+ this.#data = []
51
+ this.#size = 0
52
+ this.#hasData = false
53
+ this.#event = undefined
54
+ return out
55
+ }
56
+
57
+ /** One `field: value` line; a comment or an unknown field changes nothing. */
58
+ read(line: string): void {
59
+ if (line.charCodeAt(0) === 58 /* : */) return
60
+ const colon = line.indexOf(":")
61
+ const field = colon === -1 ? line : line.slice(0, colon)
62
+ let value = colon === -1 ? "" : line.slice(colon + 1)
63
+ if (value.charCodeAt(0) === 32) value = value.slice(1)
64
+ if (field === "data") {
65
+ this.#size += bytesOf(value) + (this.#hasData ? 1 : 0)
66
+ if (this.#size > this.#max) throw new Error(`SSE event exceeds ${this.#max} bytes`)
67
+ this.#data.push(value)
68
+ this.#hasData = true
69
+ } else if (field === "event") this.#event = value
70
+ else if (field === "id") {
71
+ if (!value.includes("\0")) this.#lastId = value
72
+ } else if (field === "retry" && /^\d+$/.test(value)) this.#retry = Number(value)
73
+ }
74
+ }
75
+
76
+ /** The complete lines at the head of `pending` (CRLF, LF or CR), and what is left after them. */
77
+ function completeLines(pending: string): { lines: string[]; rest: string } {
78
+ const lines: string[] = []
79
+ let start = 0
80
+ let end = 0
81
+ while (start < pending.length) {
82
+ end = start
83
+ while (end < pending.length && pending.charCodeAt(end) !== 10 && pending.charCodeAt(end) !== 13) end++
84
+ if (end === pending.length) break
85
+ /* a CR as the last character may be the first half of CRLF */
86
+ if (pending.charCodeAt(end) === 13 && end === pending.length - 1) break
87
+ lines.push(pending.slice(start, end))
88
+ start = end + (pending.charCodeAt(end) === 13 && pending.charCodeAt(end + 1) === 10 ? 2 : 1)
89
+ }
90
+ return { lines, rest: pending.slice(start) }
91
+ }
92
+
93
+ /** The open line as its pieces and their UTF-8 bytes: joining it per chunk was quadratic. */
94
+ function openLine(max: number) {
95
+ let pieces: string[] = []
96
+ let bytes = 0
97
+ return {
98
+ /** The lines `text` completes; with no line end, and no CR before it, it extends the open line. */
99
+ take(text: string): string[] {
100
+ const last = pieces[pieces.length - 1]
101
+ if (!/[\r\n]/.test(text) && last?.charCodeAt(last.length - 1) !== 13) {
102
+ pieces.push(text)
103
+ bytes += bytesOf(text, max)
104
+ return []
105
+ }
106
+ const { lines, rest } = completeLines(pieces.join("") + text)
107
+ pieces = rest === "" ? [] : [rest]
108
+ bytes = bytesOf(rest, max)
109
+ return lines
110
+ },
111
+ over: () => bytes > max,
112
+ /** only a CR is open, held back as a possible CRLF's first half */
113
+ lone: () => pieces.length === 1 && pieces[0] === "\r",
114
+ }
115
+ }
116
+
117
+ /** `stream`'s reader, and a read whose failure throws `failed`'s error for it. */
118
+ function readerOf(stream: ReadableStream<Uint8Array>, failed = (cause: unknown) => cause) {
119
+ const reader = stream.getReader()
120
+ const read = () =>
121
+ /* no answer (f2) */
122
+ reader.read().catch((cause) => {
123
+ throw failed(cause)
124
+ })
125
+ return { read, reader }
126
+ }
127
+
128
+ /**
129
+ * Parse a `text/event-stream` body per the WHATWG "event stream interpretation" rules: lines end
130
+ * at CRLF, LF or CR; a leading BOM is skipped; `id` persists until changed and an `id` holding NUL
131
+ * is ignored; `retry` counts only when all ASCII digits; an event still open when the stream ends
132
+ * is discarded. A line over `maxLineBytes` (1 MiB) or an event's data over `maxEventBytes` (8 MiB), in UTF-8 bytes,
133
+ * throws after every event completed before it, as does a failed read, by `failed`. Leaving a `for await` early (a
134
+ * break, return or throw) cancels the body's reader, which frees the connection.
135
+ */
136
+ export async function* parseSSEStream(
137
+ stream: ReadableStream<Uint8Array>,
138
+ opts?: {
139
+ failed?: ((cause: unknown) => unknown) | undefined
140
+ maxLineBytes?: number | undefined
141
+ maxEventBytes?: number | undefined
142
+ },
143
+ ): AsyncGenerator<SSEEvent, void, undefined> {
144
+ const decoder = new TextDecoder()
145
+ const { failed, maxEventBytes = MAX_EVENT, maxLineBytes: maxLine = MAX_LINE } = opts ?? {}
146
+ const { read, reader } = readerOf(stream, failed)
147
+ const fields = new EventFields(maxEventBytes)
148
+ const open = openLine(maxLine)
149
+ let first = true
150
+ try {
151
+ for (let chunk = await read(); !chunk.done; chunk = await read()) {
152
+ let text = decoder.decode(chunk.value, { stream: true })
153
+ if (first && text.length > 0) {
154
+ if (text.charCodeAt(0) === 0xfeff) text = text.slice(1)
155
+ first = false
156
+ }
157
+ for (const line of open.take(text)) {
158
+ if (overLine(line, maxLine)) throw new Error(`SSE line exceeds ${maxLine} bytes`)
159
+ const out = line === "" ? fields.dispatch() : fields.read(line)
160
+ if (out) yield out
161
+ }
162
+ if (open.over()) throw new Error(`SSE line exceeds ${maxLine} bytes`)
163
+ }
164
+ /* a lone CR held back at the end of the stream still ends a blank line; anything else open is discarded */
165
+ if (open.lone()) {
166
+ const out = fields.dispatch()
167
+ if (out) yield out
168
+ }
169
+ } finally {
170
+ await reader.cancel().catch(() => {
171
+ /* the stream is done either way */
172
+ })
173
+ reader.releaseLock()
174
+ }
175
+ }
@@ -0,0 +1,137 @@
1
+ import { compilePattern, hasPlaceholder, interpolatePartial } from "./path.ts"
2
+
3
+ /**
4
+ * Resolve invalidation targets by substituting the mutation's params. Params that are absent stay
5
+ * placeholders, so a partially resolved target is a narrower pattern, never dropped: `PUT
6
+ * /orgs/{org}` invalidating `GET /orgs/:org/members/:id` marks `GET /orgs/acme/members/:id`.
7
+ */
8
+ export function resolveInvalidationTargets(
9
+ targets: readonly string[],
10
+ params: Record<string, string> | undefined,
11
+ ): string[] {
12
+ return targets.map((target) => {
13
+ const space = target.indexOf(" ")
14
+ if (space === -1 || !params) return target
15
+ try {
16
+ return `${target.slice(0, space)} ${interpolatePartial(target.slice(space + 1), params)}`
17
+ } catch {
18
+ /* a param value that is not a path segment cannot address a resource; keep the pattern */
19
+ return target
20
+ }
21
+ })
22
+ }
23
+
24
+ /* Bound memory: which concrete paths have already refreshed against a pattern-level mark, and the
25
+ compiled patterns, are capped; the marks and their sources are capped by `StaleLimits`. */
26
+ const MAX_REFRESHED = 1024
27
+ const MAX_PATTERNS = 1024
28
+
29
+ type StaleEntry = {
30
+ by: Set<string>
31
+ /** concrete paths that have read once since this pattern was marked (pattern entries only) */
32
+ refreshed?: Set<string> | undefined
33
+ seq: number
34
+ until: number
35
+ }
36
+
37
+ /** Drop the oldest value of an insertion-ordered set once it holds `max`. */
38
+ function capped<T>(set: Set<T>, max: number): void {
39
+ if (set.size < max) return
40
+ const oldest = set.values().next().value
41
+ if (oldest !== undefined) set.delete(oldest)
42
+ }
43
+
44
+ /** How many exact marks the index keeps, and how many mutations each mark remembers. */
45
+ export type StaleLimits = { maxEntries: number; maxSources: number }
46
+
47
+ /**
48
+ * Stale marks, split by kind so a concrete key is never re-read as a pattern (a path may contain
49
+ * `:`), and a lookup scans only patterns for its own method.
50
+ */
51
+ export class StaleIndex {
52
+ readonly exact: Map<string, StaleEntry> = new Map()
53
+ readonly patterns: Map<string, Map<string, StaleEntry>> = new Map()
54
+ readonly #compiled = new Map<string, RegExp>()
55
+ readonly #limits: StaleLimits
56
+
57
+ constructor(limits: StaleLimits) {
58
+ this.#limits = limits
59
+ }
60
+
61
+ /** Whether `path` matches the route pattern `pattern` (`:name`, `{name}`, `*`), literal text escaped. */
62
+ matches(path: string, pattern: string): boolean {
63
+ let re = this.#compiled.get(pattern)
64
+ if (re === undefined) {
65
+ if (this.#compiled.size >= MAX_PATTERNS) this.#compiled.delete(this.#compiled.keys().next().value as string)
66
+ re = compilePattern(pattern)
67
+ this.#compiled.set(pattern, re)
68
+ }
69
+ return re.test(path)
70
+ }
71
+
72
+ /** Mark `target` stale on behalf of `mutation`, until `at.until`. */
73
+ mark(target: string, mutation: string, at: { now: number; seq: number; until: number }): void {
74
+ const { seq, until } = at
75
+ const space = target.indexOf(" ")
76
+ const method = target.slice(0, space)
77
+ const isPattern = hasPlaceholder(target.slice(space + 1))
78
+ let table = this.exact
79
+ if (isPattern) {
80
+ table = this.patterns.get(method) ?? new Map()
81
+ this.patterns.set(method, table)
82
+ }
83
+ const existing = table.get(target)
84
+ if (!existing) {
85
+ table.set(target, { by: new Set([mutation]), refreshed: isPattern ? new Set() : undefined, seq, until })
86
+ if (!isPattern) this.#bound(at.now)
87
+ return
88
+ }
89
+ existing.by.delete(mutation)
90
+ capped(existing.by, this.#limits.maxSources)
91
+ existing.by.add(mutation)
92
+ existing.until = until
93
+ existing.seq = seq
94
+ /* a new mutation re-marks every instance */
95
+ existing.refreshed?.clear()
96
+ }
97
+
98
+ /** Past `maxEntries` exact marks, drop the expired ones, then the oldest live ones. */
99
+ #bound(now: number): void {
100
+ const { maxEntries } = this.#limits
101
+ if (this.exact.size <= maxEntries) return
102
+ for (const [key, entry] of this.exact) if (entry.until <= now) this.exact.delete(key)
103
+ for (const key of this.exact.keys()) {
104
+ if (this.exact.size <= maxEntries) return
105
+ this.exact.delete(key)
106
+ }
107
+ }
108
+
109
+ lookup(selector: string, path: string, method: string, now: number): { by: string[]; isStale: boolean } {
110
+ const by = new Set<string>()
111
+ const exact = this.exact.get(selector)
112
+ if (exact && exact.until > now) for (const m of exact.by) by.add(m)
113
+ else if (exact) this.exact.delete(selector)
114
+ for (const [key, entry] of this.patterns.get(method) ?? []) {
115
+ if (entry.until <= now) this.patterns.get(method)?.delete(key)
116
+ else if (!entry.refreshed?.has(path) && this.matches(path, key.slice(key.indexOf(" ") + 1))) {
117
+ for (const m of entry.by) by.add(m)
118
+ }
119
+ }
120
+ return { by: [...by], isStale: by.size > 0 }
121
+ }
122
+
123
+ /**
124
+ * A successful stale read clears the mark for that resource only: the exact entry, and this
125
+ * concrete path's share of any pattern entry. Marks newer than the read's snapshot stay.
126
+ */
127
+ clear(selector: string, path: string, method: string, snapshot: number): void {
128
+ const exact = this.exact.get(selector)
129
+ if (exact && exact.seq <= snapshot) this.exact.delete(selector)
130
+ for (const [key, entry] of this.patterns.get(method) ?? []) {
131
+ if (entry.seq > snapshot || !entry.refreshed) continue
132
+ if (!this.matches(path, key.slice(key.indexOf(" ") + 1))) continue
133
+ capped(entry.refreshed, MAX_REFRESHED)
134
+ entry.refreshed.add(path)
135
+ }
136
+ }
137
+ }
@@ -0,0 +1,87 @@
1
+ import type { RequestMeta } from "./config.ts"
2
+ import { type Call, CONFIG, type HTTPClient, SEND } from "./http.ts"
3
+ import { parseMediaType } from "./media-type.ts"
4
+ import type { RequestOptions } from "./request.ts"
5
+ import { type Answer, errorFromResponse, finishRequest, type Sent } from "./response.ts"
6
+ import { parseSSEStream, type SSEEvent } from "./sse.ts"
7
+
8
+ /** An event stream's call: its stale view, and what runs once its answer is ok. */
9
+ export type StreamCall = Call & { meta?: RequestMeta | undefined; onOpen?: ((response: Response) => void) | undefined }
10
+
11
+ /** Whether `response` answers with an event stream. */
12
+ export function isEventStream(response: Response): boolean {
13
+ return parseMediaType(response.headers.get("content-type"))?.essence === "text/event-stream"
14
+ }
15
+
16
+ /** An event stream sent when its iteration starts: `open`'s events. */
17
+ export const later = (open: () => Promise<Answer>): AsyncIterable<SSEEvent> => ({
18
+ async *[Symbol.asyncIterator]() {
19
+ yield* (await open()).data as AsyncIterable<SSEEvent>
20
+ },
21
+ })
22
+
23
+ /** The events of a sent stream, read as they arrive; the request is done when iteration ends. */
24
+ function iterate(http: HTTPClient, sent: Sent): AsyncIterable<SSEEvent> {
25
+ const config = http[CONFIG]
26
+ const caps = { maxEventBytes: config.sseMaxEventBytes, maxLineBytes: config.sseMaxLineBytes }
27
+ return {
28
+ async *[Symbol.asyncIterator]() {
29
+ try {
30
+ if (sent.response.body) yield* parseSSEStream(sent.response.body, { ...caps, failed: sent.failed })
31
+ } finally {
32
+ sent.done()
33
+ }
34
+ },
35
+ }
36
+ }
37
+
38
+ /**
39
+ * One request whose shape is decided by the answer: an event stream becomes an
40
+ * `AsyncIterable<SSEEvent>` (never buffered, exempt from the timeout once headers arrive);
41
+ * anything else is read as in `request`.
42
+ */
43
+ export async function requestAuto(
44
+ http: HTTPClient,
45
+ method: string,
46
+ path: string,
47
+ opts: RequestOptions,
48
+ ): Promise<Answer> {
49
+ const sent = await http[SEND]({ method, opts, path }, "auto")
50
+ if (!sent.response.ok || !isEventStream(sent.response) || opts.raw)
51
+ return finishRequest(sent, { limits: http[CONFIG], method, raw: opts.raw })
52
+ sent.exemptFromTimeout()
53
+ return { data: iterate(http, sent), response: sent.response }
54
+ }
55
+
56
+ export function requestStream(
57
+ http: HTTPClient,
58
+ method: string,
59
+ path: string,
60
+ opts: RequestOptions,
61
+ ): AsyncIterable<SSEEvent> {
62
+ return streamOperation(http, { method, opts, path })
63
+ }
64
+
65
+ /** An event stream, sent when iteration starts; `onOpen` runs once the answer is ok. */
66
+ export function streamOperation(http: HTTPClient, op: StreamCall): AsyncIterable<SSEEvent> {
67
+ return later(() => openStream(http, op))
68
+ }
69
+
70
+ /** An event stream opened: its non-2xx thrown as its ClientError, `onOpen` run, its events read as they arrive. */
71
+ export async function openStream(
72
+ http: HTTPClient,
73
+ op: StreamCall,
74
+ ): Promise<{ data: AsyncIterable<SSEEvent>; response: Response }> {
75
+ const sent = await http[SEND](op, "stream", op.meta)
76
+ /* the timeout bounded the open; the stream itself is never cut by it */
77
+ sent.exemptFromTimeout()
78
+ if (!sent.response.ok) {
79
+ try {
80
+ throw await errorFromResponse(sent.response, http[CONFIG])
81
+ } finally {
82
+ sent.done()
83
+ }
84
+ }
85
+ op.onOpen?.(sent.response)
86
+ return { data: iterate(http, sent), response: sent.response }
87
+ }
@@ -0,0 +1,116 @@
1
+ /** A webhook delivery that is not genuine: unsigned, signed by no key the receiver holds, stale, or not an event. */
2
+ export class WebhookVerificationError extends Error {
3
+ override readonly name = "WebhookVerificationError"
4
+ }
5
+
6
+ /** A delivery's headers: a `Headers`, or a record in any case as Node's `IncomingHttpHeaders` holds them. */
7
+ export type WebhookHeaders = Headers | Readonly<Record<string, string | readonly string[] | undefined>>
8
+
9
+ /** A verified Standard Webhooks event, untyped: the delivery's id and its body's envelope. */
10
+ export type VerifiedWebhook = { id: string; type: string; timestamp: string; data: unknown }
11
+
12
+ /* how far a delivery's timestamp may be from now, either way, in seconds */
13
+ const TOLERANCE = 300
14
+
15
+ /** The header `name` (lower case) of `headers`, read case-insensitively; several values are one space-separated. */
16
+ function headerOf(headers: WebhookHeaders, name: string): string | undefined {
17
+ if (headers instanceof Headers) return headers.get(name) ?? undefined
18
+ for (const [key, value] of Object.entries(headers)) {
19
+ if (key.toLowerCase() === name && value !== undefined) return typeof value === "string" ? value : value.join(" ")
20
+ }
21
+ return undefined
22
+ }
23
+
24
+ /** `text`'s base64 bytes, or undefined when it is not base64. */
25
+ function base64Bytes(text: string): Uint8Array<ArrayBuffer> | undefined {
26
+ let binary: string
27
+ try {
28
+ binary = atob(text)
29
+ } catch {
30
+ return undefined
31
+ }
32
+ const bytes = new Uint8Array(binary.length)
33
+ for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i)
34
+ return bytes
35
+ }
36
+
37
+ /** The HMAC-SHA256 keys of `secrets` (`whsec_` and base64); a secret that is not one is a `TypeError`. */
38
+ function keysOf(secrets: string | readonly string[]): Promise<CryptoKey[]> {
39
+ const list = typeof secrets === "string" ? [secrets] : secrets
40
+ if (list.length === 0) throw new TypeError("verifyWebhook: no secret to verify with")
41
+ return Promise.all(
42
+ list.map((secret) => {
43
+ const bytes = base64Bytes(secret.startsWith("whsec_") ? secret.slice(6) : secret)
44
+ if (!bytes?.length) throw new TypeError("verifyWebhook: a secret is not a base64 key, with or without whsec_")
45
+ return crypto.subtle.importKey("raw", bytes, { hash: "SHA-256", name: "HMAC" }, false, ["verify"])
46
+ }),
47
+ )
48
+ }
49
+
50
+ /** The bytes a Standard Webhooks signature covers: `{id}.{timestamp}.{body}`. */
51
+ function signedContent(id: string, timestamp: string, body: Uint8Array): Uint8Array<ArrayBuffer> {
52
+ const prefix = new TextEncoder().encode(`${id}.${timestamp}.`)
53
+ const bytes = new Uint8Array(prefix.length + body.length)
54
+ bytes.set(prefix)
55
+ bytes.set(body, prefix.length)
56
+ return bytes
57
+ }
58
+
59
+ /** `body` parsed as a Standard Webhooks envelope, or a `WebhookVerificationError` naming why it is not one. */
60
+ function envelopeOf(text: string): Omit<VerifiedWebhook, "id"> {
61
+ let value: unknown
62
+ try {
63
+ value = JSON.parse(text)
64
+ } catch (cause) {
65
+ throw new WebhookVerificationError("the signed body is not a Standard Webhooks event: not JSON", { cause })
66
+ }
67
+ const event = value as Partial<Record<"data" | "timestamp" | "type", unknown>> | null
68
+ if (
69
+ typeof event !== "object" ||
70
+ event === null ||
71
+ Array.isArray(event) ||
72
+ typeof event.type !== "string" ||
73
+ typeof event.timestamp !== "string" ||
74
+ !("data" in event)
75
+ )
76
+ throw new WebhookVerificationError("the signed body is not a Standard Webhooks event { type, timestamp, data }")
77
+ return { data: event.data, timestamp: event.timestamp, type: event.type }
78
+ }
79
+
80
+ /**
81
+ * Verifies a Standard Webhooks delivery and returns its event. The body is the raw text (or bytes) as received, before
82
+ * any parse; `secrets` holds the receiver's key or, while rotating, both. A delivery whose `webhook-signature` holds no
83
+ * `v1` signature one of the keys makes over its id, timestamp and body, whose timestamp is more than five minutes
84
+ * from now either way, or whose body is not a `{ type, timestamp, data }` event is a `WebhookVerificationError`; a
85
+ * secret that is not a key is a `TypeError`. Signatures are checked by WebCrypto, in constant time.
86
+ */
87
+ export async function verifyStandardWebhook(
88
+ body: string | Uint8Array,
89
+ headers: WebhookHeaders,
90
+ secrets: string | readonly string[],
91
+ ): Promise<VerifiedWebhook> {
92
+ const keys = await keysOf(secrets)
93
+ const [id, timestamp, signatures] = ["webhook-id", "webhook-timestamp", "webhook-signature"].map((name) => {
94
+ const value = headerOf(headers, name)
95
+ if (!value) throw new WebhookVerificationError(`the delivery is missing the ${name} header`)
96
+ return value
97
+ }) as [string, string, string]
98
+ const sentAt = /^\d+$/.test(timestamp) ? Number(timestamp) : Number.NaN
99
+ if (!(Math.abs(Date.now() / 1000 - sentAt) <= TOLERANCE))
100
+ throw new WebhookVerificationError(`the delivery's timestamp ${timestamp} is outside the tolerance of now`)
101
+ const bytes = typeof body === "string" ? new TextEncoder().encode(body) : body
102
+ const content = signedContent(id, timestamp, bytes)
103
+ const candidates = signatures
104
+ .split(" ")
105
+ .flatMap((entry) => (entry.startsWith("v1,") ? [base64Bytes(entry.slice(3))] : []))
106
+ .filter((signature) => signature !== undefined)
107
+ for (const signature of candidates) {
108
+ for (const key of keys) {
109
+ if (await crypto.subtle.verify("HMAC", key, signature, content)) {
110
+ const text = typeof body === "string" ? body : new TextDecoder().decode(body)
111
+ return { id, ...envelopeOf(text) }
112
+ }
113
+ }
114
+ }
115
+ throw new WebhookVerificationError("no signature matches a key the receiver holds")
116
+ }
@@ -0,0 +1,155 @@
1
+ /**
2
+ * An operation's WebSocket. Its dial runs no onRequest or onResponse hook, and a refused handshake's 401 is its error,
3
+ * with no onAuthExpired refresh. The platform WebSocket exposes no ping and no message cap, so this socket has neither.
4
+ */
5
+ import type { HTTPClient } from "./http.ts"
6
+ import type { RequestOptions } from "./request.ts"
7
+
8
+ export type TypedWebSocket = {
9
+ close(code?: number, reason?: string): void
10
+ off(event: "binary" | "close" | "error" | "message" | "open", handler: (...args: never[]) => void): void
11
+ /** Binary frames, as `ArrayBuffer`. Text frames go to `"message"`. */
12
+ on(event: "binary", handler: (data: ArrayBuffer) => void): void
13
+ on(event: "close", handler: (code: number, reason: string) => void): void
14
+ on(event: "error", handler: (error: unknown) => void): void
15
+ /** Text frames. */
16
+ on(event: "message", handler: (data: string) => void): void
17
+ on(event: "open", handler: () => void): void
18
+ readonly readyState: number
19
+ /**
20
+ * Strings, `ArrayBuffer`, typed arrays and `Blob` are sent as-is; any other value is JSON-encoded.
21
+ * Sends before the socket opens are queued; after it closes they are dropped.
22
+ */
23
+ send(data: ArrayBuffer | ArrayBufferView | Blob | object | string): void
24
+ }
25
+
26
+ export type WSOptions = {
27
+ protocols?: string | string[] | undefined
28
+ }
29
+
30
+ type Payload = Blob | string | Uint8Array<ArrayBuffer>
31
+ type Handler = (...args: never[]) => void
32
+
33
+ const WS_EVENTS: readonly string[] = ["binary", "close", "error", "message", "open"]
34
+
35
+ /** The DOM listener that hands `event` to `handler` in its typed shape. */
36
+ function wrapListener(event: string, handler: Handler): EventListener {
37
+ const call = handler as (...args: unknown[]) => void
38
+ if (event === "message") {
39
+ return (e) => {
40
+ const data = (e as MessageEvent).data
41
+ if (typeof data === "string") call(data)
42
+ }
43
+ }
44
+ if (event === "binary") {
45
+ return (e) => {
46
+ const data = (e as MessageEvent).data
47
+ if (data instanceof ArrayBuffer) call(data)
48
+ }
49
+ }
50
+ if (event === "open") return () => call()
51
+ if (event === "close") return (e) => call((e as CloseEvent).code, (e as CloseEvent).reason)
52
+ return (e) => call(e)
53
+ }
54
+
55
+ /** `data` as a frame: text and Blobs as they are, bytes copied, anything else as JSON. */
56
+ function toPayload(data: ArrayBuffer | ArrayBufferView | Blob | object | string): Payload {
57
+ if (typeof data === "string") return data
58
+ if (typeof Blob !== "undefined" && data instanceof Blob) return data
59
+ if (data instanceof ArrayBuffer || ArrayBuffer.isView(data)) {
60
+ const view =
61
+ data instanceof ArrayBuffer ? new Uint8Array(data) : new Uint8Array(data.buffer, data.byteOffset, data.byteLength)
62
+ const copy = new Uint8Array(view.byteLength)
63
+ copy.set(view)
64
+ return copy
65
+ }
66
+ return JSON.stringify(data)
67
+ }
68
+
69
+ /** A WebSocket with typed events, a send queue until it opens, and nothing sent once it closes. */
70
+ class TypedSocket {
71
+ readonly #ws: WebSocket
72
+ /* user handler → wrapped listener, per event, so one handler can be registered for several events */
73
+ readonly #listeners = new Map<string, WeakMap<Handler, EventListener>>()
74
+ readonly #queue: Payload[] = []
75
+ #state: "closed" | "connecting" | "open" = "connecting"
76
+
77
+ constructor(ws: WebSocket) {
78
+ this.#ws = ws
79
+ ws.binaryType = "arraybuffer"
80
+ ws.addEventListener("open", () => {
81
+ this.#state = "open"
82
+ for (const msg of this.#queue) ws.send(msg)
83
+ this.#queue.length = 0
84
+ })
85
+ ws.addEventListener("close", () => {
86
+ this.#state = "closed"
87
+ this.#queue.length = 0
88
+ })
89
+ }
90
+
91
+ get readyState(): number {
92
+ return this.#ws.readyState
93
+ }
94
+
95
+ close(code?: number, reason?: string): void {
96
+ this.#state = "closed"
97
+ this.#queue.length = 0
98
+ this.#ws.close(code, reason)
99
+ }
100
+
101
+ on(event: string, handler: Handler): void {
102
+ if (!WS_EVENTS.includes(event)) return
103
+ const byHandler = this.#listeners.get(event) ?? new WeakMap<Handler, EventListener>()
104
+ this.#listeners.set(event, byHandler)
105
+ const target = event === "binary" ? "message" : event
106
+ const previous = byHandler.get(handler)
107
+ if (previous) this.#ws.removeEventListener(target, previous)
108
+ const wrapped = wrapListener(event, handler)
109
+ byHandler.set(handler, wrapped)
110
+ this.#ws.addEventListener(target, wrapped)
111
+ }
112
+
113
+ off(event: string, handler: Handler): void {
114
+ const byHandler = this.#listeners.get(event)
115
+ const wrapped = byHandler?.get(handler)
116
+ if (!wrapped) return
117
+ this.#ws.removeEventListener(event === "binary" ? "message" : event, wrapped)
118
+ byHandler?.delete(handler)
119
+ }
120
+
121
+ send(data: ArrayBuffer | ArrayBufferView | Blob | object | string): void {
122
+ if (this.#state === "closed") return
123
+ const payload = toPayload(data)
124
+ if (this.#state === "connecting") this.#queue.push(payload)
125
+ else this.#ws.send(payload)
126
+ }
127
+ }
128
+
129
+ /** The WebSocket URL of `path`: its HTTP URL under the ws: or wss: scheme. */
130
+ export function wsUrl(http: HTTPClient, path: string, opts: RequestOptions): string {
131
+ const url = new URL(http.buildUrl(path, opts))
132
+ if (url.protocol === "https:") url.protocol = "wss:"
133
+ else if (url.protocol === "http:") url.protocol = "ws:"
134
+ return url.toString()
135
+ }
136
+
137
+ export function createTypedWebSocket(
138
+ url: string,
139
+ opts?: WSOptions,
140
+ WebSocketImpl: typeof WebSocket = WebSocket,
141
+ ): TypedWebSocket {
142
+ const ws = opts?.protocols ? new WebSocketImpl(url, opts.protocols) : new WebSocketImpl(url)
143
+ const socket = new TypedSocket(ws)
144
+ const typed: TypedWebSocket = {
145
+ close: (code, reason) => socket.close(code, reason),
146
+ off: (event, handler) => socket.off(event, handler),
147
+ on: ((event: string, handler: Handler) => socket.on(event, handler)) as TypedWebSocket["on"],
148
+ get readyState() {
149
+ return socket.readyState
150
+ },
151
+ send: (data) => socket.send(data),
152
+ }
153
+ Object.defineProperty(typed, "_ws", { enumerable: false, value: ws })
154
+ return typed
155
+ }