ts-procedures 7.2.0 → 8.0.0
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.
- package/README.md +65 -3
- package/agent_config/claude-code/agents/ts-procedures-architect.md +6 -8
- package/agent_config/claude-code/skills/ts-procedures/SKILL.md +30 -33
- package/agent_config/claude-code/skills/ts-procedures/anti-patterns.md +139 -53
- package/agent_config/claude-code/skills/ts-procedures/api-reference.md +208 -231
- package/agent_config/claude-code/skills/ts-procedures/patterns.md +80 -153
- package/agent_config/claude-code/skills/ts-procedures-review/SKILL.md +1 -1
- package/agent_config/claude-code/skills/ts-procedures-review/checklist.md +4 -5
- package/agent_config/claude-code/skills/ts-procedures-scaffold/SKILL.md +4 -7
- package/agent_config/claude-code/skills/ts-procedures-scaffold/templates/hono.md +223 -0
- package/agent_config/copilot/copilot-instructions.md +36 -48
- package/agent_config/cursor/cursorrules +36 -48
- package/build/client/call.js +4 -1
- package/build/client/call.js.map +1 -1
- package/build/client/call.test.js +23 -0
- package/build/client/call.test.js.map +1 -1
- package/build/client/fetch-adapter.js +3 -1
- package/build/client/fetch-adapter.js.map +1 -1
- package/build/client/fetch-adapter.test.js +11 -1
- package/build/client/fetch-adapter.test.js.map +1 -1
- package/build/client/index.test.js +7 -7
- package/build/client/index.test.js.map +1 -1
- package/build/client/request-builder.d.ts +1 -1
- package/build/client/request-builder.js +2 -2
- package/build/client/request-builder.js.map +1 -1
- package/build/client/stream.js +13 -2
- package/build/client/stream.js.map +1 -1
- package/build/client/stream.test.js +32 -7
- package/build/client/stream.test.js.map +1 -1
- package/build/client/typed-error-dispatch.test.js +8 -92
- package/build/client/typed-error-dispatch.test.js.map +1 -1
- package/build/client/types.d.ts +21 -3
- package/build/codegen/bin/cli.js +0 -0
- package/build/codegen/e2e.test.js +87 -23
- package/build/codegen/e2e.test.js.map +1 -1
- package/build/codegen/emit-errors.integration.test.js +1 -1
- package/build/codegen/emit-errors.integration.test.js.map +1 -1
- package/build/codegen/emit-scope.js +308 -47
- package/build/codegen/emit-scope.js.map +1 -1
- package/build/codegen/emit-scope.test.js +363 -110
- package/build/codegen/emit-scope.test.js.map +1 -1
- package/build/codegen/pipeline.test.js +7 -7
- package/build/codegen/pipeline.test.js.map +1 -1
- package/build/codegen/resolve-envelope.js +1 -1
- package/build/codegen/resolve-envelope.js.map +1 -1
- package/build/codegen/resolve-envelope.test.js +5 -5
- package/build/codegen/resolve-envelope.test.js.map +1 -1
- package/build/codegen/targets/_shared/route-slots.d.ts +8 -3
- package/build/codegen/targets/_shared/route-slots.js +49 -8
- package/build/codegen/targets/_shared/route-slots.js.map +1 -1
- package/build/codegen/targets/_shared/route-slots.test.js +99 -26
- package/build/codegen/targets/_shared/route-slots.test.js.map +1 -1
- package/build/codegen/targets/kotlin/emit-route-kotlin.test.js +88 -17
- package/build/codegen/targets/kotlin/emit-route-kotlin.test.js.map +1 -1
- package/build/codegen/targets/kotlin/emit-scope-kotlin.test.js +9 -6
- package/build/codegen/targets/kotlin/emit-scope-kotlin.test.js.map +1 -1
- package/build/codegen/targets/kotlin/integration.test.js +6 -0
- package/build/codegen/targets/kotlin/integration.test.js.map +1 -1
- package/build/codegen/targets/swift/access-level.test.js +8 -11
- package/build/codegen/targets/swift/access-level.test.js.map +1 -1
- package/build/codegen/targets/swift/emit-route-swift.test.js +91 -20
- package/build/codegen/targets/swift/emit-route-swift.test.js.map +1 -1
- package/build/codegen/targets/swift/emit-scope-swift.test.js +12 -9
- package/build/codegen/targets/swift/emit-scope-swift.test.js.map +1 -1
- package/build/codegen/targets/swift/integration.test.js +6 -0
- package/build/codegen/targets/swift/integration.test.js.map +1 -1
- package/build/create-http-stream.d.ts +58 -0
- package/build/create-http-stream.js +122 -0
- package/build/create-http-stream.js.map +1 -0
- package/build/create-http-stream.test.js +88 -0
- package/build/create-http-stream.test.js.map +1 -0
- package/build/create-http.d.ts +49 -0
- package/build/create-http.js +108 -0
- package/build/create-http.js.map +1 -0
- package/build/create-http.test.js +137 -0
- package/build/create-http.test.js.map +1 -0
- package/build/create-stream.d.ts +35 -0
- package/build/create-stream.js +123 -0
- package/build/create-stream.js.map +1 -0
- package/build/create-stream.test.js +428 -0
- package/build/create-stream.test.js.map +1 -0
- package/build/create.d.ts +28 -0
- package/build/create.js +82 -0
- package/build/create.js.map +1 -0
- package/build/create.test.js +483 -0
- package/build/create.test.js.map +1 -0
- package/build/exports.d.ts +2 -0
- package/build/implementations/http/astro/index.test.js +20 -12
- package/build/implementations/http/astro/index.test.js.map +1 -1
- package/build/implementations/http/doc-registry.js +1 -1
- package/build/implementations/http/doc-registry.js.map +1 -1
- package/build/implementations/http/doc-registry.test.js +36 -5
- package/build/implementations/http/doc-registry.test.js.map +1 -1
- package/build/implementations/http/error-dispatch.d.ts +76 -0
- package/build/implementations/http/error-dispatch.js +77 -0
- package/build/implementations/http/error-dispatch.js.map +1 -0
- package/build/implementations/http/error-dispatch.test.js +254 -0
- package/build/implementations/http/error-dispatch.test.js.map +1 -0
- package/build/implementations/http/error-taxonomy.d.ts +5 -5
- package/build/implementations/http/hono/docs/http-doc.d.ts +6 -0
- package/build/implementations/http/hono/docs/http-doc.js +42 -0
- package/build/implementations/http/hono/docs/http-doc.js.map +1 -0
- package/build/implementations/http/hono/docs/http-stream-doc.d.ts +6 -0
- package/build/implementations/http/hono/docs/http-stream-doc.js +40 -0
- package/build/implementations/http/hono/docs/http-stream-doc.js.map +1 -0
- package/build/implementations/http/hono/docs/rpc-doc.d.ts +6 -0
- package/build/implementations/http/hono/docs/rpc-doc.js +24 -0
- package/build/implementations/http/hono/docs/rpc-doc.js.map +1 -0
- package/build/implementations/http/hono/docs/stream-doc.d.ts +6 -0
- package/build/implementations/http/hono/docs/stream-doc.js +42 -0
- package/build/implementations/http/hono/docs/stream-doc.js.map +1 -0
- package/build/implementations/http/hono/handlers/http-stream.d.ts +10 -0
- package/build/implementations/http/hono/handlers/http-stream.js +123 -0
- package/build/implementations/http/hono/handlers/http-stream.js.map +1 -0
- package/build/implementations/http/hono/handlers/http-stream.test.js +128 -0
- package/build/implementations/http/hono/handlers/http-stream.test.js.map +1 -0
- package/build/implementations/http/hono/handlers/http.d.ts +10 -0
- package/build/implementations/http/hono/handlers/http.js +115 -0
- package/build/implementations/http/hono/handlers/http.js.map +1 -0
- package/build/implementations/http/hono/handlers/http.test.js +118 -0
- package/build/implementations/http/hono/handlers/http.test.js.map +1 -0
- package/build/implementations/http/hono/handlers/rpc.d.ts +11 -0
- package/build/implementations/http/hono/handlers/rpc.js +32 -0
- package/build/implementations/http/hono/handlers/rpc.js.map +1 -0
- package/build/implementations/http/hono/handlers/rpc.test.js +73 -0
- package/build/implementations/http/hono/handlers/rpc.test.js.map +1 -0
- package/build/implementations/http/hono/handlers/stream.d.ts +23 -0
- package/build/implementations/http/hono/handlers/stream.js +147 -0
- package/build/implementations/http/hono/handlers/stream.js.map +1 -0
- package/build/implementations/http/hono/handlers/stream.test.d.ts +1 -0
- package/build/implementations/http/hono/handlers/stream.test.js +177 -0
- package/build/implementations/http/hono/handlers/stream.test.js.map +1 -0
- package/build/implementations/http/hono/index.d.ts +57 -0
- package/build/implementations/http/hono/index.js +149 -0
- package/build/implementations/http/hono/index.js.map +1 -0
- package/build/implementations/http/hono/index.test.d.ts +1 -0
- package/build/implementations/http/hono/index.test.js +274 -0
- package/build/implementations/http/hono/index.test.js.map +1 -0
- package/build/implementations/http/hono/path.d.ts +17 -0
- package/build/implementations/http/hono/path.js +39 -0
- package/build/implementations/http/hono/path.js.map +1 -0
- package/build/implementations/http/hono/path.test.d.ts +1 -0
- package/build/implementations/http/hono/path.test.js +83 -0
- package/build/implementations/http/hono/path.test.js.map +1 -0
- package/build/implementations/http/hono/types.d.ts +51 -0
- package/build/implementations/http/hono/types.js.map +1 -0
- package/build/implementations/http/on-request-error.test.js +6 -96
- package/build/implementations/http/on-request-error.test.js.map +1 -1
- package/build/implementations/http/route-errors.test.js +11 -59
- package/build/implementations/http/route-errors.test.js.map +1 -1
- package/build/implementations/types.d.ts +43 -9
- package/build/index.d.ts +125 -115
- package/build/index.js +10 -222
- package/build/index.js.map +1 -1
- package/build/index.test.js +30 -822
- package/build/index.test.js.map +1 -1
- package/build/migration.test.d.ts +1 -0
- package/build/migration.test.js +34 -0
- package/build/migration.test.js.map +1 -0
- package/build/schema/compute-schema.d.ts +11 -3
- package/build/schema/compute-schema.js +13 -7
- package/build/schema/compute-schema.js.map +1 -1
- package/build/schema/parser.d.ts +11 -3
- package/build/schema/parser.js +49 -9
- package/build/schema/parser.js.map +1 -1
- package/build/stack-utils.js +8 -0
- package/build/stack-utils.js.map +1 -1
- package/build/types.d.ts +142 -0
- package/build/types.js.map +1 -0
- package/docs/astro-adapter.md +5 -5
- package/docs/core.md +34 -17
- package/docs/http-integrations.md +83 -170
- package/docs/streaming.md +3 -60
- package/docs/superpowers/plans/2026-05-07-astro-adapter.md +2 -7
- package/docs/superpowers/plans/2026-05-08-create-http.md +3355 -0
- package/docs/superpowers/plans/2026-05-08-hono-app-builder-convergence.md +3365 -0
- package/docs/superpowers/specs/2026-05-07-astro-adapter-design.md +1 -3
- package/docs/superpowers/specs/2026-05-08-create-http-design.md +409 -0
- package/docs/superpowers/specs/2026-05-08-hono-app-builder-convergence-design.md +411 -0
- package/package.json +4 -22
- package/src/client/call.test.ts +26 -0
- package/src/client/call.ts +4 -1
- package/src/client/fetch-adapter.test.ts +14 -1
- package/src/client/fetch-adapter.ts +3 -1
- package/src/client/index.test.ts +7 -7
- package/src/client/request-builder.ts +2 -2
- package/src/client/stream.test.ts +39 -7
- package/src/client/stream.ts +16 -2
- package/src/client/typed-error-dispatch.test.ts +7 -97
- package/src/client/types.ts +21 -3
- package/src/codegen/__fixtures__/users-envelope.json +119 -38
- package/src/codegen/e2e.test.ts +98 -24
- package/src/codegen/emit-errors.integration.test.ts +1 -1
- package/src/codegen/emit-scope.test.ts +395 -110
- package/src/codegen/emit-scope.ts +350 -55
- package/src/codegen/pipeline.test.ts +7 -7
- package/src/codegen/resolve-envelope.test.ts +5 -5
- package/src/codegen/resolve-envelope.ts +1 -1
- package/src/codegen/targets/_shared/route-slots.test.ts +109 -26
- package/src/codegen/targets/_shared/route-slots.ts +48 -11
- package/src/codegen/targets/kotlin/__fixtures__/users-golden.kt +73 -0
- package/src/codegen/targets/kotlin/emit-route-kotlin.test.ts +100 -17
- package/src/codegen/targets/kotlin/emit-scope-kotlin.test.ts +9 -6
- package/src/codegen/targets/kotlin/integration.test.ts +19 -0
- package/src/codegen/targets/swift/__fixtures__/users-golden.swift +79 -0
- package/src/codegen/targets/swift/access-level.test.ts +8 -11
- package/src/codegen/targets/swift/emit-route-swift.test.ts +103 -20
- package/src/codegen/targets/swift/emit-scope-swift.test.ts +12 -9
- package/src/codegen/targets/swift/integration.test.ts +17 -0
- package/src/create-http-stream.test.ts +97 -0
- package/src/create-http-stream.ts +191 -0
- package/src/create-http.test.ts +163 -0
- package/src/create-http.ts +211 -0
- package/src/create-stream.test.ts +565 -0
- package/src/create-stream.ts +228 -0
- package/src/create.test.ts +658 -0
- package/src/create.ts +172 -0
- package/src/exports.ts +2 -0
- package/src/implementations/http/README.md +135 -95
- package/src/implementations/http/astro/README.md +4 -5
- package/src/implementations/http/astro/index.test.ts +25 -18
- package/src/implementations/http/doc-registry.test.ts +42 -5
- package/src/implementations/http/doc-registry.ts +1 -1
- package/src/implementations/http/error-dispatch.test.ts +283 -0
- package/src/implementations/http/error-dispatch.ts +176 -0
- package/src/implementations/http/error-taxonomy.ts +5 -5
- package/src/implementations/http/hono/docs/http-doc.ts +43 -0
- package/src/implementations/http/hono/docs/http-stream-doc.ts +44 -0
- package/src/implementations/http/hono/docs/rpc-doc.ts +34 -0
- package/src/implementations/http/hono/docs/stream-doc.ts +53 -0
- package/src/implementations/http/hono/handlers/http-stream.test.ts +150 -0
- package/src/implementations/http/hono/handlers/http-stream.ts +152 -0
- package/src/implementations/http/hono/handlers/http.test.ts +130 -0
- package/src/implementations/http/hono/handlers/http.ts +147 -0
- package/src/implementations/http/hono/handlers/rpc.test.ts +81 -0
- package/src/implementations/http/hono/handlers/rpc.ts +54 -0
- package/src/implementations/http/hono/handlers/stream.test.ts +198 -0
- package/src/implementations/http/hono/handlers/stream.ts +208 -0
- package/src/implementations/http/hono/index.test.ts +329 -0
- package/src/implementations/http/hono/index.ts +204 -0
- package/src/implementations/http/hono/path.test.ts +96 -0
- package/src/implementations/http/hono/path.ts +59 -0
- package/src/implementations/http/hono/types.ts +93 -0
- package/src/implementations/http/on-request-error.test.ts +10 -116
- package/src/implementations/http/route-errors.test.ts +11 -77
- package/src/implementations/types.ts +44 -9
- package/src/index.test.ts +35 -1091
- package/src/index.ts +50 -474
- package/src/migration.test.ts +48 -0
- package/src/schema/compute-schema.ts +26 -12
- package/src/schema/parser.ts +62 -12
- package/src/stack-utils.ts +8 -0
- package/src/types.ts +133 -0
- package/agent_config/claude-code/skills/ts-procedures-scaffold/templates/express-rpc.md +0 -137
- package/agent_config/claude-code/skills/ts-procedures-scaffold/templates/hono-api.md +0 -173
- package/agent_config/claude-code/skills/ts-procedures-scaffold/templates/hono-rpc.md +0 -142
- package/agent_config/claude-code/skills/ts-procedures-scaffold/templates/hono-stream.md +0 -147
- package/build/implementations/http/express-rpc/error-taxonomy.test.js +0 -83
- package/build/implementations/http/express-rpc/error-taxonomy.test.js.map +0 -1
- package/build/implementations/http/express-rpc/index.d.ts +0 -125
- package/build/implementations/http/express-rpc/index.js +0 -216
- package/build/implementations/http/express-rpc/index.js.map +0 -1
- package/build/implementations/http/express-rpc/index.test.js +0 -684
- package/build/implementations/http/express-rpc/index.test.js.map +0 -1
- package/build/implementations/http/express-rpc/types.d.ts +0 -11
- package/build/implementations/http/express-rpc/types.js.map +0 -1
- package/build/implementations/http/hono-api/error-taxonomy.test.js +0 -137
- package/build/implementations/http/hono-api/error-taxonomy.test.js.map +0 -1
- package/build/implementations/http/hono-api/index.d.ts +0 -151
- package/build/implementations/http/hono-api/index.js +0 -344
- package/build/implementations/http/hono-api/index.js.map +0 -1
- package/build/implementations/http/hono-api/index.test.js +0 -992
- package/build/implementations/http/hono-api/index.test.js.map +0 -1
- package/build/implementations/http/hono-api/types.d.ts +0 -13
- package/build/implementations/http/hono-api/types.js.map +0 -1
- package/build/implementations/http/hono-rpc/error-taxonomy.test.js +0 -64
- package/build/implementations/http/hono-rpc/error-taxonomy.test.js.map +0 -1
- package/build/implementations/http/hono-rpc/index.d.ts +0 -130
- package/build/implementations/http/hono-rpc/index.js +0 -209
- package/build/implementations/http/hono-rpc/index.js.map +0 -1
- package/build/implementations/http/hono-rpc/index.test.js +0 -828
- package/build/implementations/http/hono-rpc/index.test.js.map +0 -1
- package/build/implementations/http/hono-rpc/types.d.ts +0 -11
- package/build/implementations/http/hono-rpc/types.js +0 -2
- package/build/implementations/http/hono-rpc/types.js.map +0 -1
- package/build/implementations/http/hono-stream/error-taxonomy.test.js +0 -159
- package/build/implementations/http/hono-stream/error-taxonomy.test.js.map +0 -1
- package/build/implementations/http/hono-stream/index.d.ts +0 -171
- package/build/implementations/http/hono-stream/index.js +0 -415
- package/build/implementations/http/hono-stream/index.js.map +0 -1
- package/build/implementations/http/hono-stream/index.test.js +0 -1383
- package/build/implementations/http/hono-stream/index.test.js.map +0 -1
- package/build/implementations/http/hono-stream/types.d.ts +0 -15
- package/build/implementations/http/hono-stream/types.js +0 -2
- package/build/implementations/http/hono-stream/types.js.map +0 -1
- package/src/implementations/http/express-rpc/README.md +0 -280
- package/src/implementations/http/express-rpc/error-taxonomy.test.ts +0 -103
- package/src/implementations/http/express-rpc/index.test.ts +0 -957
- package/src/implementations/http/express-rpc/index.ts +0 -327
- package/src/implementations/http/express-rpc/types.ts +0 -16
- package/src/implementations/http/hono-api/README.md +0 -284
- package/src/implementations/http/hono-api/error-taxonomy.test.ts +0 -179
- package/src/implementations/http/hono-api/index.test.ts +0 -1341
- package/src/implementations/http/hono-api/index.ts +0 -519
- package/src/implementations/http/hono-api/types.ts +0 -16
- package/src/implementations/http/hono-rpc/README.md +0 -357
- package/src/implementations/http/hono-rpc/error-taxonomy.test.ts +0 -82
- package/src/implementations/http/hono-rpc/index.test.ts +0 -1107
- package/src/implementations/http/hono-rpc/index.ts +0 -320
- package/src/implementations/http/hono-rpc/types.ts +0 -16
- package/src/implementations/http/hono-stream/README.md +0 -559
- package/src/implementations/http/hono-stream/error-taxonomy.test.ts +0 -178
- package/src/implementations/http/hono-stream/index.test.ts +0 -1804
- package/src/implementations/http/hono-stream/index.ts +0 -622
- package/src/implementations/http/hono-stream/types.ts +0 -20
- /package/build/{implementations/http/express-rpc/error-taxonomy.test.d.ts → create-http-stream.test.d.ts} +0 -0
- /package/build/{implementations/http/express-rpc/index.test.d.ts → create-http.test.d.ts} +0 -0
- /package/build/{implementations/http/hono-api/error-taxonomy.test.d.ts → create-stream.test.d.ts} +0 -0
- /package/build/{implementations/http/hono-api/index.test.d.ts → create.test.d.ts} +0 -0
- /package/build/implementations/http/{hono-rpc/error-taxonomy.test.d.ts → error-dispatch.test.d.ts} +0 -0
- /package/build/implementations/http/{hono-rpc/index.test.d.ts → hono/handlers/http-stream.test.d.ts} +0 -0
- /package/build/implementations/http/{hono-stream/error-taxonomy.test.d.ts → hono/handlers/http.test.d.ts} +0 -0
- /package/build/implementations/http/{hono-stream/index.test.d.ts → hono/handlers/rpc.test.d.ts} +0 -0
- /package/build/implementations/http/{express-rpc → hono}/types.js +0 -0
- /package/build/{implementations/http/hono-api/types.js → types.js} +0 -0
package/build/index.js
CHANGED
|
@@ -1,231 +1,17 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
3
|
-
import {
|
|
1
|
+
import { makeCreate } from './create.js';
|
|
2
|
+
import { makeCreateStream } from './create-stream.js';
|
|
3
|
+
import { makeCreateHttp } from './create-http.js';
|
|
4
|
+
import { makeCreateHttpStream } from './create-http-stream.js';
|
|
4
5
|
export function Procedures(
|
|
5
6
|
/**
|
|
6
7
|
* Optionally provided builder to register Procedures
|
|
7
8
|
*/
|
|
8
9
|
builder) {
|
|
9
10
|
const procedures = new Map();
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
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
|
-
const userIterator = userGenerator[Symbol.asyncIterator]();
|
|
166
|
-
try {
|
|
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
|
-
// Preserve the original error class so HTTP builders' taxonomies and
|
|
186
|
-
// `onMidStreamError` callbacks see the actual thrown type — boxing
|
|
187
|
-
// user-defined errors inside ProcedureError defeats route-declared
|
|
188
|
-
// typed-error dispatch on the client. Augment the stack trace in
|
|
189
|
-
// place with the procedure's definition site when available.
|
|
190
|
-
if (definitionInfo.definedAt &&
|
|
191
|
-
error &&
|
|
192
|
-
typeof error.stack === 'string') {
|
|
193
|
-
const { file, line, column } = definitionInfo.definedAt;
|
|
194
|
-
error.stack =
|
|
195
|
-
`${error.stack}\n--- Procedure "${name}" defined at ---\n at ${file}:${line}:${column}`;
|
|
196
|
-
}
|
|
197
|
-
throw error;
|
|
198
|
-
}
|
|
199
|
-
finally {
|
|
200
|
-
// Propagate `.return()` to the user generator so its `finally`
|
|
201
|
-
// blocks (and any `signal`-driven cleanup) run when the consumer
|
|
202
|
-
// closes the stream early. No-op when iteration already completed.
|
|
203
|
-
try {
|
|
204
|
-
await userIterator.return?.(undefined);
|
|
205
|
-
}
|
|
206
|
-
catch {
|
|
207
|
-
// Swallow — cleanup must not mask the primary error path
|
|
208
|
-
}
|
|
209
|
-
abortController.abort('stream-completed');
|
|
210
|
-
}
|
|
211
|
-
},
|
|
212
|
-
};
|
|
213
|
-
procedures.set(name, registeredProcedure);
|
|
214
|
-
if (builder?.onCreate) {
|
|
215
|
-
builder.onCreate(registeredProcedure);
|
|
216
|
-
}
|
|
217
|
-
const info = {
|
|
218
|
-
name,
|
|
219
|
-
isStream: true,
|
|
220
|
-
...registeredProcedure.config,
|
|
221
|
-
};
|
|
222
|
-
// return so can be called directly (ie: int/unit tests)
|
|
223
|
-
return {
|
|
224
|
-
[name]: registeredProcedure.handler,
|
|
225
|
-
procedure: registeredProcedure.handler,
|
|
226
|
-
info,
|
|
227
|
-
};
|
|
228
|
-
}
|
|
11
|
+
const Create = makeCreate(procedures, builder);
|
|
12
|
+
const CreateStream = makeCreateStream(procedures, builder);
|
|
13
|
+
const CreateHttp = makeCreateHttp(procedures, builder);
|
|
14
|
+
const CreateHttpStream = makeCreateHttpStream(procedures, builder);
|
|
229
15
|
return {
|
|
230
16
|
/**
|
|
231
17
|
* Get all registered procedures
|
|
@@ -253,6 +39,8 @@ builder) {
|
|
|
253
39
|
},
|
|
254
40
|
Create,
|
|
255
41
|
CreateStream,
|
|
42
|
+
CreateHttp,
|
|
43
|
+
CreateHttpStream,
|
|
256
44
|
};
|
|
257
45
|
}
|
|
258
46
|
//# sourceMappingURL=index.js.map
|
package/build/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAuB9D,MAAM,UAAU,UAAU;AACxB;;GAEG;AACH,OAoBC;IAED,MAAM,UAAU,GAMZ,IAAI,GAAG,EAAE,CAAA;IAEb,MAAM,MAAM,GAAG,UAAU,CAA4B,UAAU,EAAE,OAAO,CAAC,CAAA;IACzE,MAAM,YAAY,GAAG,gBAAgB,CAA4B,UAAU,EAAE,OAAO,CAAC,CAAA;IACrF,MAAM,UAAU,GAAG,cAAc,CAAW,UAAU,EAAE,OAAO,CAAC,CAAA;IAChE,MAAM,gBAAgB,GAAG,oBAAoB,CAAW,UAAU,EAAE,OAAO,CAAC,CAAA;IAE5E,OAAO;QACL;;WAEG;QACH,aAAa,EAAE,GAAG,EAAE;YAClB,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAA;QACxC,CAAC;QAED;;WAEG;QACH,YAAY,EAAE,CAAC,IAAY,EAAE,EAAE;YAC7B,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC7B,CAAC;QAED;;WAEG;QACH,eAAe,EAAE,CAAC,IAAY,EAAE,EAAE;YAChC,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAChC,CAAC;QAED;;WAEG;QACH,KAAK,EAAE,GAAG,EAAE;YACV,UAAU,CAAC,KAAK,EAAE,CAAA;QACpB,CAAC;QAED,MAAM;QACN,YAAY;QACZ,UAAU;QACV,gBAAgB;KACjB,CAAA;AACH,CAAC"}
|