ts-procedures 5.9.1 → 5.10.2

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 (305) hide show
  1. package/README.md +1 -1
  2. package/agent_config/bin/postinstall.mjs +3 -3
  3. package/agent_config/bin/setup.mjs +22 -11
  4. package/agent_config/claude-code/agents/ts-procedures-architect.md +46 -101
  5. package/agent_config/claude-code/skills/{guide → ts-procedures}/SKILL.md +50 -35
  6. package/agent_config/claude-code/skills/{guide → ts-procedures}/anti-patterns.md +6 -5
  7. package/agent_config/claude-code/skills/{guide → ts-procedures}/api-reference.md +60 -49
  8. package/agent_config/claude-code/skills/ts-procedures-review/SKILL.md +48 -0
  9. package/agent_config/claude-code/skills/{scaffold → ts-procedures-scaffold}/SKILL.md +19 -24
  10. package/agent_config/claude-code/skills/ts-procedures-scaffold/templates/client.md +115 -0
  11. package/agent_config/lib/install-claude.mjs +35 -87
  12. package/build/src/client/call.d.ts +14 -0
  13. package/build/src/client/call.js +47 -0
  14. package/build/src/client/call.js.map +1 -0
  15. package/build/src/client/call.test.d.ts +1 -0
  16. package/build/src/client/call.test.js +124 -0
  17. package/build/src/client/call.test.js.map +1 -0
  18. package/build/src/client/errors.d.ts +25 -0
  19. package/build/src/client/errors.js +33 -0
  20. package/build/src/client/errors.js.map +1 -0
  21. package/build/src/client/errors.test.d.ts +1 -0
  22. package/build/src/client/errors.test.js +41 -0
  23. package/build/src/client/errors.test.js.map +1 -0
  24. package/build/src/client/fetch-adapter.d.ts +12 -0
  25. package/build/src/client/fetch-adapter.js +156 -0
  26. package/build/src/client/fetch-adapter.js.map +1 -0
  27. package/build/src/client/fetch-adapter.test.d.ts +1 -0
  28. package/build/src/client/fetch-adapter.test.js +271 -0
  29. package/build/src/client/fetch-adapter.test.js.map +1 -0
  30. package/build/src/client/hooks.d.ts +17 -0
  31. package/build/src/client/hooks.js +40 -0
  32. package/build/src/client/hooks.js.map +1 -0
  33. package/build/src/client/hooks.test.d.ts +1 -0
  34. package/build/src/client/hooks.test.js +163 -0
  35. package/build/src/client/hooks.test.js.map +1 -0
  36. package/build/src/client/index.d.ts +22 -0
  37. package/build/src/client/index.js +67 -0
  38. package/build/src/client/index.js.map +1 -0
  39. package/build/src/client/index.test.d.ts +1 -0
  40. package/build/src/client/index.test.js +231 -0
  41. package/build/src/client/index.test.js.map +1 -0
  42. package/build/src/client/request-builder.d.ts +13 -0
  43. package/build/src/client/request-builder.js +53 -0
  44. package/build/src/client/request-builder.js.map +1 -0
  45. package/build/src/client/request-builder.test.d.ts +1 -0
  46. package/build/src/client/request-builder.test.js +160 -0
  47. package/build/src/client/request-builder.test.js.map +1 -0
  48. package/build/src/client/stream.d.ts +27 -0
  49. package/build/src/client/stream.js +118 -0
  50. package/build/src/client/stream.js.map +1 -0
  51. package/build/src/client/stream.test.d.ts +1 -0
  52. package/build/src/client/stream.test.js +228 -0
  53. package/build/src/client/stream.test.js.map +1 -0
  54. package/build/src/client/types.d.ts +78 -0
  55. package/build/src/client/types.js +3 -0
  56. package/build/src/client/types.js.map +1 -0
  57. package/build/src/codegen/bin/cli.d.ts +45 -0
  58. package/build/src/codegen/bin/cli.js +246 -0
  59. package/build/src/codegen/bin/cli.js.map +1 -0
  60. package/build/src/codegen/bin/cli.test.d.ts +1 -0
  61. package/build/src/codegen/bin/cli.test.js +220 -0
  62. package/build/src/codegen/bin/cli.test.js.map +1 -0
  63. package/build/src/codegen/constants.d.ts +1 -0
  64. package/build/src/codegen/constants.js +2 -0
  65. package/build/src/codegen/constants.js.map +1 -0
  66. package/build/src/codegen/e2e.test.d.ts +1 -0
  67. package/build/src/codegen/e2e.test.js +464 -0
  68. package/build/src/codegen/e2e.test.js.map +1 -0
  69. package/build/src/codegen/emit-client-runtime.d.ts +9 -0
  70. package/build/src/codegen/emit-client-runtime.js +99 -0
  71. package/build/src/codegen/emit-client-runtime.js.map +1 -0
  72. package/build/src/codegen/emit-client-runtime.test.d.ts +1 -0
  73. package/build/src/codegen/emit-client-runtime.test.js +78 -0
  74. package/build/src/codegen/emit-client-runtime.test.js.map +1 -0
  75. package/build/src/codegen/emit-client-types.d.ts +8 -0
  76. package/build/src/codegen/emit-client-types.js +25 -0
  77. package/build/src/codegen/emit-client-types.js.map +1 -0
  78. package/build/src/codegen/emit-client-types.test.d.ts +1 -0
  79. package/build/src/codegen/emit-client-types.test.js +33 -0
  80. package/build/src/codegen/emit-client-types.test.js.map +1 -0
  81. package/build/src/codegen/emit-errors.d.ts +19 -0
  82. package/build/src/codegen/emit-errors.js +59 -0
  83. package/build/src/codegen/emit-errors.js.map +1 -0
  84. package/build/src/codegen/emit-errors.test.d.ts +1 -0
  85. package/build/src/codegen/emit-errors.test.js +175 -0
  86. package/build/src/codegen/emit-errors.test.js.map +1 -0
  87. package/build/src/codegen/emit-index.d.ts +12 -0
  88. package/build/src/codegen/emit-index.js +41 -0
  89. package/build/src/codegen/emit-index.js.map +1 -0
  90. package/build/src/codegen/emit-index.test.d.ts +1 -0
  91. package/build/src/codegen/emit-index.test.js +106 -0
  92. package/build/src/codegen/emit-index.test.js.map +1 -0
  93. package/build/src/codegen/emit-scope.d.ts +15 -0
  94. package/build/src/codegen/emit-scope.js +299 -0
  95. package/build/src/codegen/emit-scope.js.map +1 -0
  96. package/build/src/codegen/emit-scope.test.d.ts +1 -0
  97. package/build/src/codegen/emit-scope.test.js +559 -0
  98. package/build/src/codegen/emit-scope.test.js.map +1 -0
  99. package/build/src/codegen/emit-types.d.ts +43 -0
  100. package/build/src/codegen/emit-types.js +111 -0
  101. package/build/src/codegen/emit-types.js.map +1 -0
  102. package/build/src/codegen/emit-types.test.d.ts +1 -0
  103. package/build/src/codegen/emit-types.test.js +184 -0
  104. package/build/src/codegen/emit-types.test.js.map +1 -0
  105. package/build/src/codegen/group-routes.d.ts +23 -0
  106. package/build/src/codegen/group-routes.js +46 -0
  107. package/build/src/codegen/group-routes.js.map +1 -0
  108. package/build/src/codegen/group-routes.test.d.ts +1 -0
  109. package/build/src/codegen/group-routes.test.js +131 -0
  110. package/build/src/codegen/group-routes.test.js.map +1 -0
  111. package/build/src/codegen/index.d.ts +15 -0
  112. package/build/src/codegen/index.js +16 -0
  113. package/build/src/codegen/index.js.map +1 -0
  114. package/build/src/codegen/naming.d.ts +7 -0
  115. package/build/src/codegen/naming.js +21 -0
  116. package/build/src/codegen/naming.js.map +1 -0
  117. package/build/src/codegen/naming.test.d.ts +1 -0
  118. package/build/src/codegen/naming.test.js +40 -0
  119. package/build/src/codegen/naming.test.js.map +1 -0
  120. package/build/src/codegen/pipeline.d.ts +17 -0
  121. package/build/src/codegen/pipeline.js +78 -0
  122. package/build/src/codegen/pipeline.js.map +1 -0
  123. package/build/src/codegen/pipeline.test.d.ts +1 -0
  124. package/build/src/codegen/pipeline.test.js +269 -0
  125. package/build/src/codegen/pipeline.test.js.map +1 -0
  126. package/build/src/codegen/resolve-envelope.d.ts +7 -0
  127. package/build/src/codegen/resolve-envelope.js +46 -0
  128. package/build/src/codegen/resolve-envelope.js.map +1 -0
  129. package/build/src/codegen/resolve-envelope.test.d.ts +1 -0
  130. package/build/src/codegen/resolve-envelope.test.js +69 -0
  131. package/build/src/codegen/resolve-envelope.test.js.map +1 -0
  132. package/build/src/errors.d.ts +33 -0
  133. package/build/src/errors.js +91 -0
  134. package/build/src/errors.js.map +1 -0
  135. package/build/src/errors.test.d.ts +1 -0
  136. package/build/src/errors.test.js +122 -0
  137. package/build/src/errors.test.js.map +1 -0
  138. package/build/src/exports.d.ts +7 -0
  139. package/build/src/exports.js +8 -0
  140. package/build/src/exports.js.map +1 -0
  141. package/build/src/implementations/http/doc-registry.d.ts +12 -0
  142. package/build/src/implementations/http/doc-registry.js +114 -0
  143. package/build/src/implementations/http/doc-registry.js.map +1 -0
  144. package/build/src/implementations/http/doc-registry.test.d.ts +1 -0
  145. package/build/src/implementations/http/doc-registry.test.js +347 -0
  146. package/build/src/implementations/http/doc-registry.test.js.map +1 -0
  147. package/build/src/implementations/http/express-rpc/index.d.ts +94 -0
  148. package/build/src/implementations/http/express-rpc/index.js +185 -0
  149. package/build/src/implementations/http/express-rpc/index.js.map +1 -0
  150. package/build/src/implementations/http/express-rpc/index.test.d.ts +1 -0
  151. package/build/src/implementations/http/express-rpc/index.test.js +684 -0
  152. package/build/src/implementations/http/express-rpc/index.test.js.map +1 -0
  153. package/build/src/implementations/http/express-rpc/types.d.ts +11 -0
  154. package/build/src/implementations/http/express-rpc/types.js +2 -0
  155. package/build/src/implementations/http/express-rpc/types.js.map +1 -0
  156. package/build/src/implementations/http/hono-api/index.d.ts +102 -0
  157. package/build/src/implementations/http/hono-api/index.js +341 -0
  158. package/build/src/implementations/http/hono-api/index.js.map +1 -0
  159. package/build/src/implementations/http/hono-api/index.test.d.ts +1 -0
  160. package/build/src/implementations/http/hono-api/index.test.js +992 -0
  161. package/build/src/implementations/http/hono-api/index.test.js.map +1 -0
  162. package/build/src/implementations/http/hono-api/types.d.ts +13 -0
  163. package/build/src/implementations/http/hono-api/types.js +2 -0
  164. package/build/src/implementations/http/hono-api/types.js.map +1 -0
  165. package/build/src/implementations/http/hono-rpc/index.d.ts +92 -0
  166. package/build/src/implementations/http/hono-rpc/index.js +161 -0
  167. package/build/src/implementations/http/hono-rpc/index.js.map +1 -0
  168. package/build/src/implementations/http/hono-rpc/index.test.d.ts +1 -0
  169. package/build/src/implementations/http/hono-rpc/index.test.js +803 -0
  170. package/build/src/implementations/http/hono-rpc/index.test.js.map +1 -0
  171. package/build/src/implementations/http/hono-rpc/types.d.ts +11 -0
  172. package/build/src/implementations/http/hono-rpc/types.js +2 -0
  173. package/build/src/implementations/http/hono-rpc/types.js.map +1 -0
  174. package/build/src/implementations/http/hono-stream/index.d.ts +120 -0
  175. package/build/src/implementations/http/hono-stream/index.js +309 -0
  176. package/build/src/implementations/http/hono-stream/index.js.map +1 -0
  177. package/build/src/implementations/http/hono-stream/index.test.d.ts +1 -0
  178. package/build/src/implementations/http/hono-stream/index.test.js +1356 -0
  179. package/build/src/implementations/http/hono-stream/index.test.js.map +1 -0
  180. package/build/src/implementations/http/hono-stream/types.d.ts +15 -0
  181. package/build/src/implementations/http/hono-stream/types.js +2 -0
  182. package/build/src/implementations/http/hono-stream/types.js.map +1 -0
  183. package/build/src/implementations/types.d.ts +142 -0
  184. package/build/src/implementations/types.js +2 -0
  185. package/build/src/implementations/types.js.map +1 -0
  186. package/build/src/index.d.ts +165 -0
  187. package/build/src/index.js +253 -0
  188. package/build/src/index.js.map +1 -0
  189. package/build/src/index.test.d.ts +1 -0
  190. package/build/src/index.test.js +890 -0
  191. package/build/src/index.test.js.map +1 -0
  192. package/build/src/schema/compute-schema.d.ts +35 -0
  193. package/build/src/schema/compute-schema.js +41 -0
  194. package/build/src/schema/compute-schema.js.map +1 -0
  195. package/build/src/schema/compute-schema.test.d.ts +1 -0
  196. package/build/src/schema/compute-schema.test.js +107 -0
  197. package/build/src/schema/compute-schema.test.js.map +1 -0
  198. package/build/src/schema/extract-json-schema.d.ts +2 -0
  199. package/build/src/schema/extract-json-schema.js +12 -0
  200. package/build/src/schema/extract-json-schema.js.map +1 -0
  201. package/build/src/schema/extract-json-schema.test.d.ts +1 -0
  202. package/build/src/schema/extract-json-schema.test.js +23 -0
  203. package/build/src/schema/extract-json-schema.test.js.map +1 -0
  204. package/build/src/schema/parser.d.ts +28 -0
  205. package/build/src/schema/parser.js +170 -0
  206. package/build/src/schema/parser.js.map +1 -0
  207. package/build/src/schema/parser.test.d.ts +1 -0
  208. package/build/src/schema/parser.test.js +120 -0
  209. package/build/src/schema/parser.test.js.map +1 -0
  210. package/build/src/schema/resolve-schema-lib.d.ts +12 -0
  211. package/build/src/schema/resolve-schema-lib.js +11 -0
  212. package/build/src/schema/resolve-schema-lib.js.map +1 -0
  213. package/build/src/schema/resolve-schema-lib.test.d.ts +1 -0
  214. package/build/src/schema/resolve-schema-lib.test.js +17 -0
  215. package/build/src/schema/resolve-schema-lib.test.js.map +1 -0
  216. package/build/src/schema/types.d.ts +8 -0
  217. package/build/src/schema/types.js +2 -0
  218. package/build/src/schema/types.js.map +1 -0
  219. package/build/src/stack-utils.d.ts +25 -0
  220. package/build/src/stack-utils.js +95 -0
  221. package/build/src/stack-utils.js.map +1 -0
  222. package/build/src/stack-utils.test.d.ts +1 -0
  223. package/build/src/stack-utils.test.js +80 -0
  224. package/build/src/stack-utils.test.js.map +1 -0
  225. package/docs/ai-agent-setup.md +7 -6
  226. package/docs/core.md +5 -9
  227. package/docs/streaming.md +9 -9
  228. package/package.json +2 -13
  229. package/src/client/call.test.ts +162 -0
  230. package/src/client/errors.test.ts +43 -0
  231. package/src/client/fetch-adapter.test.ts +340 -0
  232. package/src/client/hooks.test.ts +191 -0
  233. package/src/client/index.test.ts +290 -0
  234. package/src/client/request-builder.test.ts +184 -0
  235. package/src/client/stream.test.ts +331 -0
  236. package/src/codegen/bin/cli.test.ts +260 -0
  237. package/src/codegen/bin/cli.ts +282 -0
  238. package/src/codegen/constants.ts +1 -0
  239. package/src/codegen/e2e.test.ts +565 -0
  240. package/src/codegen/emit-client-runtime.test.ts +93 -0
  241. package/src/codegen/emit-client-runtime.ts +114 -0
  242. package/src/codegen/emit-client-types.test.ts +39 -0
  243. package/src/codegen/emit-client-types.ts +27 -0
  244. package/src/codegen/emit-errors.test.ts +202 -0
  245. package/src/codegen/emit-errors.ts +80 -0
  246. package/src/codegen/emit-index.test.ts +127 -0
  247. package/src/codegen/emit-index.ts +58 -0
  248. package/src/codegen/emit-scope.test.ts +624 -0
  249. package/src/codegen/emit-scope.ts +389 -0
  250. package/src/codegen/emit-types.test.ts +205 -0
  251. package/src/codegen/emit-types.ts +158 -0
  252. package/src/codegen/group-routes.test.ts +159 -0
  253. package/src/codegen/group-routes.ts +61 -0
  254. package/src/codegen/index.ts +30 -0
  255. package/src/codegen/naming.test.ts +50 -0
  256. package/src/codegen/naming.ts +25 -0
  257. package/src/codegen/pipeline.test.ts +316 -0
  258. package/src/codegen/pipeline.ts +108 -0
  259. package/src/codegen/resolve-envelope.test.ts +76 -0
  260. package/src/codegen/resolve-envelope.ts +61 -0
  261. package/src/errors.test.ts +163 -0
  262. package/src/errors.ts +107 -0
  263. package/src/exports.ts +7 -0
  264. package/src/implementations/http/doc-registry.test.ts +415 -0
  265. package/src/implementations/http/doc-registry.ts +143 -0
  266. package/src/implementations/http/express-rpc/README.md +6 -6
  267. package/src/implementations/http/express-rpc/index.test.ts +957 -0
  268. package/src/implementations/http/express-rpc/index.ts +266 -0
  269. package/src/implementations/http/express-rpc/types.ts +16 -0
  270. package/src/implementations/http/hono-api/index.test.ts +1341 -0
  271. package/src/implementations/http/hono-api/index.ts +463 -0
  272. package/src/implementations/http/hono-api/types.ts +16 -0
  273. package/src/implementations/http/hono-rpc/README.md +6 -6
  274. package/src/implementations/http/hono-rpc/index.test.ts +1075 -0
  275. package/src/implementations/http/hono-rpc/index.ts +238 -0
  276. package/src/implementations/http/hono-rpc/types.ts +16 -0
  277. package/src/implementations/http/hono-stream/README.md +12 -12
  278. package/src/implementations/http/hono-stream/index.test.ts +1768 -0
  279. package/src/implementations/http/hono-stream/index.ts +456 -0
  280. package/src/implementations/http/hono-stream/types.ts +20 -0
  281. package/src/implementations/types.ts +174 -0
  282. package/src/index.test.ts +1185 -0
  283. package/src/index.ts +522 -0
  284. package/src/schema/compute-schema.test.ts +128 -0
  285. package/src/schema/compute-schema.ts +88 -0
  286. package/src/schema/extract-json-schema.test.ts +25 -0
  287. package/src/schema/extract-json-schema.ts +15 -0
  288. package/src/schema/parser.test.ts +182 -0
  289. package/src/schema/parser.ts +215 -0
  290. package/src/schema/resolve-schema-lib.test.ts +19 -0
  291. package/src/schema/resolve-schema-lib.ts +29 -0
  292. package/src/schema/types.ts +20 -0
  293. package/src/stack-utils.test.ts +94 -0
  294. package/src/stack-utils.ts +129 -0
  295. package/agent_config/claude-code/skills/review/SKILL.md +0 -53
  296. package/docs/superpowers/plans/2026-03-30-client-codegen.md +0 -2833
  297. package/docs/superpowers/specs/2026-03-30-client-codegen-design.md +0 -632
  298. /package/agent_config/claude-code/skills/{guide → ts-procedures}/patterns.md +0 -0
  299. /package/agent_config/claude-code/skills/{review → ts-procedures-review}/checklist.md +0 -0
  300. /package/agent_config/claude-code/skills/{scaffold → ts-procedures-scaffold}/templates/express-rpc.md +0 -0
  301. /package/agent_config/claude-code/skills/{scaffold → ts-procedures-scaffold}/templates/hono-api.md +0 -0
  302. /package/agent_config/claude-code/skills/{scaffold → ts-procedures-scaffold}/templates/hono-rpc.md +0 -0
  303. /package/agent_config/claude-code/skills/{scaffold → ts-procedures-scaffold}/templates/hono-stream.md +0 -0
  304. /package/agent_config/claude-code/skills/{scaffold → ts-procedures-scaffold}/templates/procedure.md +0 -0
  305. /package/agent_config/claude-code/skills/{scaffold → ts-procedures-scaffold}/templates/stream-procedure.md +0 -0
@@ -0,0 +1,253 @@
1
+ import { ProcedureError, ProcedureValidationError, ProcedureYieldValidationError, } from './errors.js';
2
+ import { computeSchema } from './schema/compute-schema.js';
3
+ import { captureDefinitionInfo } from './stack-utils.js';
4
+ export function Procedures(
5
+ /**
6
+ * Optionally provided builder to register Procedures
7
+ */
8
+ builder) {
9
+ const procedures = new Map();
10
+ function Create(name, config, handler) {
11
+ // Capture definition location as first action
12
+ const definitionInfo = captureDefinitionInfo();
13
+ // BEFORE computeSchema - fail fast on duplicate
14
+ if (procedures.has(name)) {
15
+ throw new Error(`Procedure with name ${name} is already registered`);
16
+ }
17
+ const { jsonSchema, validations } = computeSchema(name, config.schema, definitionInfo);
18
+ // Create error factory once at registration time (outside handler)
19
+ const errorFactory = (message, meta) => {
20
+ return new ProcedureError(name, message, meta, definitionInfo);
21
+ };
22
+ const registeredProcedure = {
23
+ name,
24
+ config: {
25
+ // ctx: config.hook, ??? why was this here
26
+ ...config,
27
+ description: config.description,
28
+ schema: jsonSchema,
29
+ validation: {
30
+ params: validations.params,
31
+ ...(validations.input && { input: validations.input }),
32
+ },
33
+ },
34
+ handler: async (ctx, params) => {
35
+ try {
36
+ // Skip validation if caller has already validated (e.g., HonoStreamAppBuilder)
37
+ const isPrevalidated = ctx.isPrevalidated;
38
+ if (validations?.params && !isPrevalidated) {
39
+ const { errors } = validations.params(params);
40
+ if (errors) {
41
+ throw new ProcedureValidationError(name, `Validation error for ${name}`, errors, definitionInfo);
42
+ }
43
+ }
44
+ // Validate each input channel independently for better error messages.
45
+ // Double validation (per-channel + merged) is intentional for developer experience;
46
+ // the cost is negligible — revisit if validation becomes a performance bottleneck.
47
+ if (validations?.input && !isPrevalidated) {
48
+ for (const [channel, validator] of Object.entries(validations.input)) {
49
+ const channelValue = params?.[channel];
50
+ const { errors } = validator(channelValue);
51
+ if (errors) {
52
+ throw new ProcedureValidationError(name, `Validation error for ${name} in input.${channel}`, errors, definitionInfo);
53
+ }
54
+ }
55
+ }
56
+ const localCtx = {
57
+ error: errorFactory, // Reuse pre-created factory
58
+ };
59
+ // params is correctly typed at the public API boundary via conditional type;
60
+ // cast here because TS cannot narrow conditional generics inside implementations
61
+ return await handler({
62
+ ...ctx,
63
+ ...localCtx,
64
+ }, params);
65
+ }
66
+ catch (error) {
67
+ if (error instanceof ProcedureError) {
68
+ throw error;
69
+ }
70
+ else {
71
+ const err = new ProcedureError(name, `Error in handler for ${name} - ${error?.message}`, undefined, definitionInfo);
72
+ err.cause = error; // Preserve original error
73
+ // Preserve original stack but append definition info
74
+ if (error.stack && definitionInfo.definedAt) {
75
+ const { file, line, column } = definitionInfo.definedAt;
76
+ err.stack =
77
+ error.stack +
78
+ `\n--- Procedure "${name}" defined at ---\n at ${file}:${line}:${column}`;
79
+ }
80
+ else if (error.stack) {
81
+ err.stack = error.stack;
82
+ }
83
+ throw err;
84
+ }
85
+ }
86
+ },
87
+ };
88
+ procedures.set(name, registeredProcedure);
89
+ if (builder?.onCreate) {
90
+ builder.onCreate(registeredProcedure);
91
+ }
92
+ const info = {
93
+ name,
94
+ ...registeredProcedure.config,
95
+ };
96
+ // return so can be called directly (ie: int/unit tests)
97
+ return {
98
+ [name]: registeredProcedure.handler,
99
+ procedure: registeredProcedure.handler,
100
+ info,
101
+ };
102
+ }
103
+ function CreateStream(name, config, handler) {
104
+ // Capture definition location as first action
105
+ const definitionInfo = captureDefinitionInfo();
106
+ // BEFORE computeSchema - fail fast on duplicate
107
+ if (procedures.has(name)) {
108
+ throw new Error(`Procedure with name ${name} is already registered`);
109
+ }
110
+ const { jsonSchema, validations } = computeSchema(name, config.schema, definitionInfo);
111
+ // Create error factory once at registration time (outside handler)
112
+ const errorFactory = (message, meta) => {
113
+ return new ProcedureError(name, message, meta, definitionInfo);
114
+ };
115
+ const validateYields = config.validateYields ?? false;
116
+ const registeredProcedure = {
117
+ name,
118
+ isStream: true,
119
+ config: {
120
+ ...config,
121
+ description: config.description,
122
+ schema: jsonSchema,
123
+ validation: {
124
+ params: validations.params,
125
+ yield: validations.yield,
126
+ ...(validations.input && { input: validations.input }),
127
+ },
128
+ },
129
+ handler: async function* wrappedHandler(ctx, params) {
130
+ // Create abort controller for this stream
131
+ const abortController = new AbortController();
132
+ // Skip validation if caller has already validated (e.g., HonoStreamAppBuilder)
133
+ const isPrevalidated = ctx.isPrevalidated;
134
+ if (validations?.params && !isPrevalidated) {
135
+ const { errors } = validations.params(params);
136
+ if (errors) {
137
+ throw new ProcedureValidationError(name, `Validation error for ${name}`, errors, definitionInfo);
138
+ }
139
+ }
140
+ // Validate each input channel independently (see Create for rationale)
141
+ if (validations?.input && !isPrevalidated) {
142
+ for (const [channel, validator] of Object.entries(validations.input)) {
143
+ const channelValue = params?.[channel];
144
+ const { errors } = validator(channelValue);
145
+ if (errors) {
146
+ throw new ProcedureValidationError(name, `Validation error for ${name} in input.${channel}`, errors, definitionInfo);
147
+ }
148
+ }
149
+ }
150
+ // Combine with external signal (e.g., from HTTP request) if provided
151
+ const incomingSignal = ctx.signal;
152
+ const signal = incomingSignal
153
+ ? AbortSignal.any([incomingSignal, abortController.signal])
154
+ : abortController.signal;
155
+ const streamCtx = {
156
+ error: errorFactory,
157
+ signal,
158
+ };
159
+ // params is correctly typed at the public API boundary via conditional type;
160
+ // cast here because TS cannot narrow conditional generics inside implementations
161
+ const userGenerator = handler({
162
+ ...ctx,
163
+ ...streamCtx,
164
+ }, params);
165
+ try {
166
+ const userIterator = userGenerator[Symbol.asyncIterator]();
167
+ let userIterResult = await userIterator.next();
168
+ while (!userIterResult.done) {
169
+ const value = userIterResult.value;
170
+ // Only validate if explicitly enabled via validateYields: true
171
+ if (validateYields && validations.yield) {
172
+ const { errors } = validations.yield(value);
173
+ if (errors) {
174
+ throw new ProcedureYieldValidationError(name, `Yield validation error for ${name}`, errors, definitionInfo);
175
+ }
176
+ }
177
+ yield value;
178
+ userIterResult = await userIterator.next();
179
+ }
180
+ // Propagate the generator's return value so consumers (e.g. HonoStreamAppBuilder)
181
+ // can send it as a special 'return' SSE event
182
+ return userIterResult.value;
183
+ }
184
+ catch (error) {
185
+ if (error instanceof ProcedureError) {
186
+ throw error;
187
+ }
188
+ else {
189
+ const err = new ProcedureError(name, `Error in streaming handler for ${name} - ${error?.message}`, undefined, definitionInfo);
190
+ err.cause = error;
191
+ if (error.stack && definitionInfo.definedAt) {
192
+ const { file, line, column } = definitionInfo.definedAt;
193
+ err.stack =
194
+ error.stack +
195
+ `\n--- Procedure "${name}" defined at ---\n at ${file}:${line}:${column}`;
196
+ }
197
+ else if (error.stack) {
198
+ err.stack = error.stack;
199
+ }
200
+ throw err;
201
+ }
202
+ }
203
+ finally {
204
+ abortController.abort('stream-completed');
205
+ }
206
+ },
207
+ };
208
+ procedures.set(name, registeredProcedure);
209
+ if (builder?.onCreate) {
210
+ builder.onCreate(registeredProcedure);
211
+ }
212
+ const info = {
213
+ name,
214
+ isStream: true,
215
+ ...registeredProcedure.config,
216
+ };
217
+ // return so can be called directly (ie: int/unit tests)
218
+ return {
219
+ [name]: registeredProcedure.handler,
220
+ procedure: registeredProcedure.handler,
221
+ info,
222
+ };
223
+ }
224
+ return {
225
+ /**
226
+ * Get all registered procedures
227
+ */
228
+ getProcedures: () => {
229
+ return Array.from(procedures.values());
230
+ },
231
+ /**
232
+ * Get a specific procedure by name
233
+ */
234
+ getProcedure: (name) => {
235
+ return procedures.get(name);
236
+ },
237
+ /**
238
+ * Remove a procedure by name
239
+ */
240
+ removeProcedure: (name) => {
241
+ return procedures.delete(name);
242
+ },
243
+ /**
244
+ * Clear all registered procedures
245
+ */
246
+ clear: () => {
247
+ procedures.clear();
248
+ },
249
+ Create,
250
+ CreateStream,
251
+ };
252
+ }
253
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export {};