@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,75 @@
1
+ // Code generated by honey. DO NOT EDIT.
2
+
3
+ package sdk
4
+
5
+ import (
6
+ "context"
7
+ "net/http"
8
+ "time"
9
+ )
10
+
11
+ // Config holds the client-wide settings. Per-call RequestOptions override BaseURL, Timeout and
12
+ // headers for one call without changing it.
13
+ //
14
+ // Timeout bounds a whole regular request, body included, and an SSE stream up to its headers;
15
+ // WebSocket and realtime are not bounded by it. Zero means 30s; a negative value disables it.
16
+ //
17
+ // Redirect picks which redirects are followed (RedirectSameOrigin by default). Under any policy, a
18
+ // hop to another origin carries only Accept, Accept-Language and User-Agent. A caller-supplied
19
+ // HTTPClient is cloned and held to the same rule; headers its own Transport adds are the caller's,
20
+ // and reach every hop.
21
+ //
22
+ // MaxResponseBytes caps a buffered response body. Zero means 100 MiB; a negative value disables
23
+ // the cap.
24
+ //
25
+ // WSKeepalive is a WebSocket's ping interval and pong wait: zero means 20s, negative none.
26
+ //
27
+ // AuthHeaderName and AuthHeaderPrefix are a pair: leave both empty for the API's scheme; set the
28
+ // name and the prefix is yours (empty means none); set only the prefix to keep the scheme's header.
29
+ type Config struct {
30
+ BaseURL string
31
+ BearerToken string
32
+ Headers map[string]string
33
+ Timeout time.Duration
34
+ Invalidation *InvalidationConfig
35
+ OnAuthExpired func(context.Context) (string, error)
36
+ HTTPClient *http.Client
37
+ Redirect RedirectPolicy
38
+ AuthHeaderName string
39
+ AuthHeaderPrefix string
40
+ OnRequest []func(*RequestContext) error
41
+ OnResponse []func(*ResponseContext) error
42
+ OnLog func(LogEntry)
43
+ MaxResponseBytes int64
44
+ WSKeepalive time.Duration
45
+
46
+ auth *authState
47
+ }
48
+
49
+ const (
50
+ defaultTimeout = 30 * time.Second
51
+ defaultMaxResponseBytes = 100 << 20
52
+ maxErrorMessageRunes = 512
53
+ )
54
+
55
+ // prepareConfig fills the defaults and wraps the HTTP client in the redirect policy. NewClient
56
+ // calls it once.
57
+ func prepareConfig(cfg Config) Config {
58
+ cfg.HTTPClient = redirectClient(cfg.HTTPClient, cfg.Redirect)
59
+ if cfg.Timeout == 0 {
60
+ cfg.Timeout = defaultTimeout
61
+ }
62
+ if cfg.MaxResponseBytes == 0 {
63
+ cfg.MaxResponseBytes = defaultMaxResponseBytes
64
+ }
65
+ cfg.auth = &authState{token: cfg.BearerToken}
66
+ return cfg
67
+ }
68
+
69
+ // streamClient is the configured client without its overall timeout: an http.Client Timeout also
70
+ // bounds body reads, which would cut every stream.
71
+ func streamClient(cfg Config) *http.Client {
72
+ c := *cfg.HTTPClient
73
+ c.Timeout = 0
74
+ return &c
75
+ }
@@ -0,0 +1,185 @@
1
+ // Code generated by honey. DO NOT EDIT.
2
+
3
+ package sdk
4
+
5
+ import (
6
+ "encoding/json"
7
+ "net/http"
8
+ "strconv"
9
+ "strings"
10
+ "unicode"
11
+ "unicode/utf8"
12
+ )
13
+
14
+ // APIError is implemented by every error for a non-2xx answer: *ClientError and the per-status
15
+ // types that embed it.
16
+ type APIError interface {
17
+ error
18
+ Status() int
19
+ }
20
+
21
+ // ErrorKey is a honey error key. A declared key is a constant that is itself an error, so
22
+ // errors.Is(err, ErrItemNotFound) matches any *ClientError carrying that key.
23
+ type ErrorKey string
24
+
25
+ func (k ErrorKey) Error() string { return string(k) }
26
+
27
+ // FieldError is one problem with one input field.
28
+ type FieldError struct {
29
+ ErrorKey string `json:"error_key"`
30
+ Message string `json:"message"`
31
+ Path string `json:"path"`
32
+ }
33
+
34
+ // ErrorEnvelope is honey's error body. Members it does not name, or that have another type than
35
+ // the envelope's, are kept raw in Extra.
36
+ type ErrorEnvelope struct {
37
+ Status int `json:"status,omitempty"`
38
+ ErrorKey string `json:"error_key,omitempty"`
39
+ StatusKey string `json:"status_key,omitempty"`
40
+ Message string `json:"message,omitempty"`
41
+ Fields map[string][]FieldError `json:"fields,omitempty"`
42
+ Extra map[string]json.RawMessage `json:"-"`
43
+ }
44
+
45
+ // ClientError is a non-2xx answer: its status, honey error key, a sanitized message, the parsed
46
+ // envelope, the raw body and the response (its Body re-readable). Reach it with errors.As:
47
+ //
48
+ // var ce *ClientError
49
+ // if errors.As(err, &ce) { ... }
50
+ //
51
+ // The known statuses come as a per-status type embedding it (var nf *NotFoundError; errors.As(err, &nf)).
52
+ type ClientError struct {
53
+ StatusCode int
54
+ Key ErrorKey
55
+ Message string
56
+ Envelope ErrorEnvelope
57
+ Body []byte
58
+ Response *http.Response
59
+ }
60
+
61
+ func (e *ClientError) Error() string {
62
+ head := "HTTP " + strconv.Itoa(e.StatusCode)
63
+ if e.Message == "" {
64
+ return head
65
+ }
66
+ return head + ": " + e.Message
67
+ }
68
+
69
+ // Status returns the HTTP status code.
70
+ func (e *ClientError) Status() int { return e.StatusCode }
71
+
72
+ // Is matches an ErrorKey equal to the error's key.
73
+ func (e *ClientError) Is(target error) bool {
74
+ k, ok := target.(ErrorKey)
75
+ return ok && k != "" && k == e.Key
76
+ }
77
+
78
+ // DecodeBody decodes the raw error body into v, for a declared per-key schema.
79
+ func (e *ClientError) DecodeBody(v any) error { return json.Unmarshal(e.Body, v) }
80
+
81
+ // The per-status errors, one for each status the TypeScript SDK names. Each embeds *ClientError
82
+ // and unwraps to it, so errors.As reaches either the status type or the base.
83
+ type (
84
+ BadRequestError struct{ *ClientError }
85
+ UnauthorizedError struct{ *ClientError }
86
+ ForbiddenError struct{ *ClientError }
87
+ NotFoundError struct{ *ClientError }
88
+ ConflictError struct{ *ClientError }
89
+ UnprocessableEntityError struct{ *ClientError }
90
+ RateLimitError struct{ *ClientError }
91
+ InternalServerError struct{ *ClientError }
92
+ BadGatewayError struct{ *ClientError }
93
+ ServiceUnavailableError struct{ *ClientError }
94
+ GatewayTimeoutError struct{ *ClientError }
95
+ )
96
+
97
+ func (e *BadRequestError) Unwrap() error { return e.ClientError }
98
+ func (e *UnauthorizedError) Unwrap() error { return e.ClientError }
99
+ func (e *ForbiddenError) Unwrap() error { return e.ClientError }
100
+ func (e *NotFoundError) Unwrap() error { return e.ClientError }
101
+ func (e *ConflictError) Unwrap() error { return e.ClientError }
102
+ func (e *UnprocessableEntityError) Unwrap() error { return e.ClientError }
103
+ func (e *RateLimitError) Unwrap() error { return e.ClientError }
104
+ func (e *InternalServerError) Unwrap() error { return e.ClientError }
105
+ func (e *BadGatewayError) Unwrap() error { return e.ClientError }
106
+ func (e *ServiceUnavailableError) Unwrap() error { return e.ClientError }
107
+ func (e *GatewayTimeoutError) Unwrap() error { return e.ClientError }
108
+
109
+ // raiseForStatus returns nil for a 2xx response, else the most specific error for its status: a
110
+ // per-status type for a known one, *ClientError for any other.
111
+ func raiseForStatus(resp *http.Response, body []byte) error {
112
+ if resp.StatusCode >= 200 && resp.StatusCode < 300 {
113
+ return nil
114
+ }
115
+ env, message := parseEnvelope(body)
116
+ e := &ClientError{StatusCode: resp.StatusCode, Key: ErrorKey(env.ErrorKey), Message: sanitizeMessage(message), Envelope: env, Body: body, Response: withBody(resp, body)}
117
+ switch e.StatusCode {
118
+ case 400:
119
+ return &BadRequestError{e}
120
+ case 401:
121
+ return &UnauthorizedError{e}
122
+ case 403:
123
+ return &ForbiddenError{e}
124
+ case 404:
125
+ return &NotFoundError{e}
126
+ case 409:
127
+ return &ConflictError{e}
128
+ case 422:
129
+ return &UnprocessableEntityError{e}
130
+ case 429:
131
+ return &RateLimitError{e}
132
+ case 500:
133
+ return &InternalServerError{e}
134
+ case 502:
135
+ return &BadGatewayError{e}
136
+ case 503:
137
+ return &ServiceUnavailableError{e}
138
+ case 504:
139
+ return &GatewayTimeoutError{e}
140
+ }
141
+ return e
142
+ }
143
+
144
+ // parseEnvelope reads honey's envelope from a JSON object body, and the message to show: the
145
+ // envelope's string message when it has one, else the body text.
146
+ func parseEnvelope(body []byte) (ErrorEnvelope, string) {
147
+ var env ErrorEnvelope
148
+ var members map[string]json.RawMessage
149
+ if json.Unmarshal(body, &members) != nil || members == nil {
150
+ return env, string(body)
151
+ }
152
+ known := map[string]any{"status": &env.Status, "error_key": &env.ErrorKey, "status_key": &env.StatusKey, "message": &env.Message, "fields": &env.Fields}
153
+ for name, raw := range members {
154
+ if dst, ok := known[name]; ok && json.Unmarshal(raw, dst) == nil {
155
+ continue
156
+ }
157
+ if env.Extra == nil {
158
+ env.Extra = map[string]json.RawMessage{}
159
+ }
160
+ env.Extra[name] = raw
161
+ }
162
+ if _, ok := members["message"]; ok && env.Extra["message"] == nil {
163
+ return env, env.Message
164
+ }
165
+ return env, string(body)
166
+ }
167
+
168
+ // sanitizeMessage drops control characters and invalid UTF-8 and caps the text at 512 runes, so a
169
+ // hostile server cannot fill logs or drive a terminal.
170
+ func sanitizeMessage(text string) string {
171
+ var b strings.Builder
172
+ n := 0
173
+ for _, r := range text {
174
+ if n >= maxErrorMessageRunes {
175
+ b.WriteString("…")
176
+ break
177
+ }
178
+ if r == utf8.RuneError || unicode.IsControl(r) {
179
+ continue
180
+ }
181
+ b.WriteRune(r)
182
+ n++
183
+ }
184
+ return b.String()
185
+ }
@@ -0,0 +1,37 @@
1
+ // Code generated by honey. DO NOT EDIT.
2
+
3
+ package sdk
4
+
5
+ import (
6
+ "context"
7
+ "iter"
8
+ "net/http"
9
+ )
10
+
11
+ // The Honey* functions expose the SDK's URL, SSE and error handling to the generated CLI, so both
12
+ // send byte-identical requests and read answers the same way.
13
+
14
+ // HoneyExpandPath fills a path template with escaped values and refuses "", "." and "..".
15
+ func HoneyExpandPath(template string, params map[string]string) (string, error) {
16
+ return expandPath(template, params)
17
+ }
18
+
19
+ // HoneyBuildURL joins base and an escaped path (keeping the base path) and appends the query pairs
20
+ // in order.
21
+ func HoneyBuildURL(baseURL, path string, query [][2]string) (string, error) {
22
+ q := make(queryList, 0, len(query))
23
+ for _, p := range query {
24
+ q = append(q, queryPair{key: p[0], value: p[1]})
25
+ }
26
+ return buildURL(baseURL, path, q)
27
+ }
28
+
29
+ // HoneyParseSSEStream yields the events of an SSE response and closes its body.
30
+ func HoneyParseSSEStream(ctx context.Context, resp *http.Response) iter.Seq2[SSEEvent[string], error] {
31
+ return parseSSEStream(ctx, resp)
32
+ }
33
+
34
+ // HoneyRaiseForStatus returns the typed error for a non-2xx response, or nil.
35
+ func HoneyRaiseForStatus(resp *http.Response, body []byte) error {
36
+ return raiseForStatus(resp, body)
37
+ }
@@ -0,0 +1,53 @@
1
+ // Code generated by honey. DO NOT EDIT.
2
+
3
+ package sdk
4
+
5
+ import (
6
+ "fmt"
7
+ "net/http"
8
+ )
9
+
10
+ // RequestContext is what each OnRequest hook sees, in declaration order. A hook may change
11
+ // Method, URL, Headers or Body; the request is built from the result. Body is nil for a streamed
12
+ // io.Reader body. Selector, IsStale and InvalidatedBy are set only when invalidation is on.
13
+ type RequestContext struct {
14
+ Method string
15
+ URL string
16
+ Path string
17
+ Headers http.Header
18
+ Body []byte
19
+ IsRetry bool
20
+ Selector string
21
+ IsStale bool
22
+ InvalidatedBy []string
23
+ }
24
+
25
+ // ResponseContext is what each OnResponse hook sees. A hook may replace Body before the SDK
26
+ // decodes it; Status is for reading only.
27
+ type ResponseContext struct {
28
+ Status int
29
+ Headers http.Header
30
+ Body []byte
31
+ IsRetry bool
32
+ Selector string
33
+ IsStale bool
34
+ InvalidatedBy []string
35
+ }
36
+
37
+ // runHooks runs hooks on rc in declaration order; the first error ends them, wrapped as phase's.
38
+ func runHooks[C any](phase string, hooks []func(C) error, rc C) error {
39
+ for _, hook := range hooks {
40
+ if err := hook(rc); err != nil {
41
+ return fmt.Errorf("honey: %s hook: %w", phase, err)
42
+ }
43
+ }
44
+ return nil
45
+ }
46
+
47
+ // stale is m's fields as a hook context holds them; zero for a nil m.
48
+ func (m *RequestMeta) stale() (string, bool, []string) {
49
+ if m == nil {
50
+ return "", false, nil
51
+ }
52
+ return m.Selector, m.IsStale, m.InvalidatedBy
53
+ }
@@ -0,0 +1,112 @@
1
+ // Code generated by honey. DO NOT EDIT.
2
+
3
+ package sdk
4
+
5
+ import (
6
+ "fmt"
7
+ "regexp"
8
+ "strings"
9
+ "sync"
10
+ )
11
+
12
+ // InvalidationConfig turns on stale tracking. StaleTime is in milliseconds; <= 0 disables the
13
+ // tracker. StaleMaxEntries caps the tracked selectors (default 1000), and MaxSourcesPerTarget the
14
+ // mutations recorded per selector (default 16).
15
+ type InvalidationConfig struct {
16
+ StaleTime int64
17
+ StaleMaxEntries int
18
+ MaxSourcesPerTarget int
19
+ }
20
+
21
+ // RequestMeta is a request's staleness snapshot, as the hook contexts see it.
22
+ type RequestMeta struct {
23
+ Selector string
24
+ IsStale bool
25
+ InvalidatedBy []string
26
+ SeqSnapshot uint64
27
+ }
28
+
29
+ /* placeholderRe matches `{name}` (any name without braces or slashes) and a `:name` segment. A
30
+ * colon inside a segment (`/ops/1:cancel`) is literal. */
31
+ var placeholderRe = regexp.MustCompile(`\{([^{}/]+)\}|(^|/):([a-zA-Z_][a-zA-Z0-9_]*)`)
32
+
33
+ /* patternRegexCache holds the compiled matcher per pattern; patterns come from the spec, so it is bounded. */
34
+ var patternRegexCache sync.Map /* map[string]*regexp.Regexp */
35
+
36
+ func compilePattern(pattern string) *regexp.Regexp {
37
+ if cached, ok := patternRegexCache.Load(pattern); ok {
38
+ return cached.(*regexp.Regexp)
39
+ }
40
+ var b strings.Builder
41
+ b.WriteByte('^')
42
+ last := 0
43
+ for _, m := range placeholderRe.FindAllStringIndex(pattern, -1) {
44
+ start := m[0]
45
+ if pattern[start] == '/' {
46
+ start++ /* keep the segment slash literal */
47
+ }
48
+ b.WriteString(regexp.QuoteMeta(pattern[last:start]))
49
+ b.WriteString(`[^/]+`)
50
+ last = m[1]
51
+ }
52
+ b.WriteString(regexp.QuoteMeta(pattern[last:]))
53
+ b.WriteByte('$')
54
+ actual, _ := patternRegexCache.LoadOrStore(pattern, regexp.MustCompile(b.String()))
55
+ return actual.(*regexp.Regexp)
56
+ }
57
+
58
+ func pathHasPlaceholders(path string) bool {
59
+ return placeholderRe.MatchString(path)
60
+ }
61
+
62
+ // pathMatchesPattern reports whether concretePath matches pattern, whose `{name}` and `:name`
63
+ // placeholders each match one segment.
64
+ func pathMatchesPattern(concretePath, pattern string) bool {
65
+ return concretePath == pattern || compilePattern(pattern).MatchString(concretePath)
66
+ }
67
+
68
+ // interpolatePath fills the `{name}` and `:name` placeholders of template from params, or fails
69
+ // naming the first one params lacks.
70
+ func interpolatePath(template string, params map[string]string) (string, error) {
71
+ var missing string
72
+ out := placeholderRe.ReplaceAllStringFunc(template, func(match string) string {
73
+ groups := placeholderRe.FindStringSubmatch(match)
74
+ key, prefix := groups[1], ""
75
+ if key == "" {
76
+ prefix, key = groups[2], groups[3]
77
+ }
78
+ val, ok := params[key]
79
+ if !ok {
80
+ if missing == "" {
81
+ missing = key
82
+ }
83
+ return match
84
+ }
85
+ return prefix + escapePathSegment(val)
86
+ })
87
+ if missing != "" {
88
+ return "", fmt.Errorf("honey: missing path param %q", missing)
89
+ }
90
+ return out, nil
91
+ }
92
+
93
+ // resolveTargets expands templated `METHOD /path/{x}` invalidation targets into concrete selectors
94
+ // with params. A target whose placeholders cannot all be filled stays a pattern, so it marks every
95
+ // instance stale (TypeScript parity).
96
+ func resolveTargets(targets []string, params map[string]string) []string {
97
+ out := make([]string, 0, len(targets))
98
+ for _, entry := range targets {
99
+ method, template, ok := strings.Cut(entry, " ")
100
+ if !ok || !pathHasPlaceholders(template) {
101
+ out = append(out, entry)
102
+ continue
103
+ }
104
+ concrete, err := interpolatePath(template, params)
105
+ if err != nil {
106
+ out = append(out, entry)
107
+ continue
108
+ }
109
+ out = append(out, method+" "+concrete)
110
+ }
111
+ return out
112
+ }
@@ -0,0 +1,92 @@
1
+ // Code generated by honey. DO NOT EDIT.
2
+
3
+ package sdk
4
+
5
+ import (
6
+ "errors"
7
+ "net/url"
8
+ "strconv"
9
+ "strings"
10
+ "time"
11
+ )
12
+
13
+ // LogEntry is what Config.OnLog receives. The SDK never formats, levels or persists it. No entry's
14
+ // text carries a path value, header value or query: Operation is "METHOD /template", and Err (the
15
+ // "error" event's failure) names it in place of the URL. Status is nil when no response arrived.
16
+ type LogEntry struct {
17
+ Level string `json:"level"`
18
+ Event string `json:"event"`
19
+ Operation string `json:"operation"`
20
+ DurationMs int64 `json:"duration_ms"`
21
+ Status *int `json:"status,omitempty"`
22
+ Err error `json:"-"`
23
+ }
24
+
25
+ // emitLog calls OnLog, recovering a panic so a faulty logger cannot break the request.
26
+ func emitLog(cfg Config, entry LogEntry) {
27
+ if cfg.OnLog == nil {
28
+ return
29
+ }
30
+ defer func() {
31
+ _ = recover()
32
+ }()
33
+ cfg.OnLog(entry)
34
+ }
35
+
36
+ func errorEntry(operation string, start time.Time, err error) LogEntry {
37
+ entry := LogEntry{Level: "error", Event: "error", Operation: operation, DurationMs: time.Since(start).Milliseconds(), Err: templated(err, operation)}
38
+ var apiErr APIError
39
+ if errors.As(err, &apiErr) {
40
+ status := apiErr.Status()
41
+ entry.Status = &status
42
+ }
43
+ return entry
44
+ }
45
+
46
+ // redactedError keeps an error's chain for errors.Is and errors.As, but its text names the request
47
+ // URL without query, userinfo or fragment, so a logged error never carries a credential.
48
+ type redactedError struct {
49
+ msg string
50
+ err error
51
+ }
52
+
53
+ func (e *redactedError) Error() string { return e.msg }
54
+
55
+ func (e *redactedError) Unwrap() error { return e.err }
56
+
57
+ // redactURL rewrites the text of an error that wraps a *url.Error to name the redacted URL.
58
+ func redactURL(err error) error {
59
+ var ue *url.Error
60
+ if !errors.As(err, &ue) {
61
+ return err
62
+ }
63
+ safe := redactedURL(ue.URL)
64
+ if safe == ue.URL {
65
+ return err
66
+ }
67
+ msg := strings.ReplaceAll(err.Error(), strconv.Quote(ue.URL), strconv.Quote(safe))
68
+ return &redactedError{msg: strings.ReplaceAll(msg, ue.URL, safe), err: err}
69
+ }
70
+
71
+ func redactedURL(raw string) string {
72
+ u, err := url.Parse(raw)
73
+ if err != nil {
74
+ return "(url redacted)"
75
+ }
76
+ u.User = nil
77
+ u.RawQuery = ""
78
+ u.ForceQuery = false
79
+ u.Fragment = ""
80
+ u.RawFragment = ""
81
+ return u.String()
82
+ }
83
+
84
+ // templated names operation in place of the request in the text of an error wrapping a *url.Error
85
+ // (its URL as wrapTransportError left it), so a logged error carries no path value.
86
+ func templated(err error, operation string) error {
87
+ var ue *url.Error
88
+ if !errors.As(err, &ue) {
89
+ return err
90
+ }
91
+ return &redactedError{msg: strings.ReplaceAll(err.Error(), ue.Op+" "+strconv.Quote(redactedURL(ue.URL)), operation), err: err}
92
+ }
@@ -0,0 +1,64 @@
1
+ // Code generated by honey. DO NOT EDIT.
2
+
3
+ package sdk
4
+
5
+ import (
6
+ "bytes"
7
+ "encoding/json"
8
+ )
9
+
10
+ // Nullable is an optional field that may also be null. Its zero value is "absent": the key is left
11
+ // out of the request (the field carries `omitzero`). NullOf sends an explicit null, Some a value.
12
+ // Decoding sets it from the response: absent stays absent, null becomes null.
13
+ type Nullable[T any] struct {
14
+ value T
15
+ set bool
16
+ null bool
17
+ }
18
+
19
+ // Some is a present, non-null value.
20
+ func Some[T any](v T) Nullable[T] {
21
+ return Nullable[T]{value: v, set: true}
22
+ }
23
+
24
+ // NullOf is an explicit null.
25
+ func NullOf[T any]() Nullable[T] {
26
+ return Nullable[T]{set: true, null: true}
27
+ }
28
+
29
+ // IsZero reports an absent field; encoding/json leaves it out under `omitzero`.
30
+ func (n Nullable[T]) IsZero() bool {
31
+ return !n.set
32
+ }
33
+
34
+ // IsNull reports an explicit null.
35
+ func (n Nullable[T]) IsNull() bool {
36
+ return n.set && n.null
37
+ }
38
+
39
+ // Get returns the value and whether there is one (false for absent and for null).
40
+ func (n Nullable[T]) Get() (T, bool) {
41
+ return n.value, n.set && !n.null
42
+ }
43
+
44
+ // MarshalJSON encodes null for an explicit null (an absent field is left out by omitzero).
45
+ func (n Nullable[T]) MarshalJSON() ([]byte, error) {
46
+ if !n.set || n.null {
47
+ return []byte("null"), nil
48
+ }
49
+ return json.Marshal(n.value)
50
+ }
51
+
52
+ // UnmarshalJSON sets a present value or an explicit null.
53
+ func (n *Nullable[T]) UnmarshalJSON(data []byte) error {
54
+ if bytes.Equal(bytes.TrimSpace(data), []byte("null")) {
55
+ *n = NullOf[T]()
56
+ return nil
57
+ }
58
+ var v T
59
+ if err := json.Unmarshal(data, &v); err != nil {
60
+ return err
61
+ }
62
+ *n = Some(v)
63
+ return nil
64
+ }