@workerstack/clients 0.0.0-stage → 1.0.0-rc.23
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +619 -2
- package/bin/honey-clients.js +94 -0
- package/dist/cli.d.ts +102 -0
- package/dist/cli.js +190 -0
- package/dist/emit/cli/channels.d.ts +73 -0
- package/dist/emit/cli/channels.js +197 -0
- package/dist/emit/cli/commands.d.ts +27 -0
- package/dist/emit/cli/commands.js +187 -0
- package/dist/emit/cli/discovery.d.ts +35 -0
- package/dist/emit/cli/discovery.js +202 -0
- package/dist/emit/cli/flags.d.ts +59 -0
- package/dist/emit/cli/flags.js +186 -0
- package/dist/emit/cli/index.d.ts +1 -0
- package/dist/emit/cli/index.js +1 -0
- package/dist/emit/cli/install.d.ts +37 -0
- package/dist/emit/cli/install.js +88 -0
- package/dist/emit/cli/layout.d.ts +23 -0
- package/dist/emit/cli/layout.js +118 -0
- package/dist/emit/cli/module.d.ts +30 -0
- package/dist/emit/cli/module.js +186 -0
- package/dist/emit/cli/release.d.ts +40 -0
- package/dist/emit/cli/release.js +183 -0
- package/dist/emit/cli/skills.d.ts +11 -0
- package/dist/emit/cli/skills.js +56 -0
- package/dist/emit/csharp/errors.d.ts +7 -0
- package/dist/emit/csharp/errors.js +69 -0
- package/dist/emit/csharp/index.d.ts +1 -0
- package/dist/emit/csharp/index.js +1 -0
- package/dist/emit/csharp/json.d.ts +13 -0
- package/dist/emit/csharp/json.js +113 -0
- package/dist/emit/csharp/realtime.d.ts +10 -0
- package/dist/emit/csharp/realtime.js +33 -0
- package/dist/emit/csharp/sdk-answer.d.ts +48 -0
- package/dist/emit/csharp/sdk-answer.js +85 -0
- package/dist/emit/csharp/sdk-body.d.ts +10 -0
- package/dist/emit/csharp/sdk-body.js +87 -0
- package/dist/emit/csharp/sdk-client.d.ts +32 -0
- package/dist/emit/csharp/sdk-client.js +177 -0
- package/dist/emit/csharp/sdk-csproj.d.ts +36 -0
- package/dist/emit/csharp/sdk-csproj.js +136 -0
- package/dist/emit/csharp/sdk-doc.d.ts +12 -0
- package/dist/emit/csharp/sdk-doc.js +35 -0
- package/dist/emit/csharp/sdk-method.d.ts +26 -0
- package/dist/emit/csharp/sdk-method.js +187 -0
- package/dist/emit/csharp/sdk-plan.d.ts +38 -0
- package/dist/emit/csharp/sdk-plan.js +1 -0
- package/dist/emit/csharp/sdk.d.ts +40 -0
- package/dist/emit/csharp/sdk.js +105 -0
- package/dist/emit/csharp/sse.d.ts +18 -0
- package/dist/emit/csharp/sse.js +29 -0
- package/dist/emit/csharp/transport.d.ts +11 -0
- package/dist/emit/csharp/transport.js +67 -0
- package/dist/emit/csharp/types-enum.d.ts +19 -0
- package/dist/emit/csharp/types-enum.js +63 -0
- package/dist/emit/csharp/types-names.d.ts +33 -0
- package/dist/emit/csharp/types-names.js +182 -0
- package/dist/emit/csharp/types-record.d.ts +25 -0
- package/dist/emit/csharp/types-record.js +65 -0
- package/dist/emit/csharp/types-union.d.ts +27 -0
- package/dist/emit/csharp/types-union.js +113 -0
- package/dist/emit/csharp/types.d.ts +36 -0
- package/dist/emit/csharp/types.js +126 -0
- package/dist/emit/csharp/ws.d.ts +20 -0
- package/dist/emit/csharp/ws.js +14 -0
- package/dist/emit/go/errors.d.ts +7 -0
- package/dist/emit/go/errors.js +44 -0
- package/dist/emit/go/http.d.ts +11 -0
- package/dist/emit/go/http.js +50 -0
- package/dist/emit/go/index.d.ts +1 -0
- package/dist/emit/go/index.js +1 -0
- package/dist/emit/go/module-path.d.ts +2 -0
- package/dist/emit/go/module-path.js +27 -0
- package/dist/emit/go/sdk-answer.d.ts +28 -0
- package/dist/emit/go/sdk-answer.js +41 -0
- package/dist/emit/go/sdk-body.d.ts +24 -0
- package/dist/emit/go/sdk-body.js +76 -0
- package/dist/emit/go/sdk-client.d.ts +29 -0
- package/dist/emit/go/sdk-client.js +141 -0
- package/dist/emit/go/sdk-method.d.ts +68 -0
- package/dist/emit/go/sdk-method.js +172 -0
- package/dist/emit/go/sdk-mirror.d.ts +23 -0
- package/dist/emit/go/sdk-mirror.js +97 -0
- package/dist/emit/go/sdk-opts.d.ts +55 -0
- package/dist/emit/go/sdk-opts.js +100 -0
- package/dist/emit/go/sdk.d.ts +26 -0
- package/dist/emit/go/sdk.js +111 -0
- package/dist/emit/go/sse.d.ts +16 -0
- package/dist/emit/go/sse.js +26 -0
- package/dist/emit/go/types-codec.d.ts +15 -0
- package/dist/emit/go/types-codec.js +171 -0
- package/dist/emit/go/types-names.d.ts +14 -0
- package/dist/emit/go/types-names.js +64 -0
- package/dist/emit/go/types-struct.d.ts +29 -0
- package/dist/emit/go/types-struct.js +65 -0
- package/dist/emit/go/types-union.d.ts +17 -0
- package/dist/emit/go/types-union.js +84 -0
- package/dist/emit/go/types.d.ts +32 -0
- package/dist/emit/go/types.js +177 -0
- package/dist/emit/go/ws.d.ts +12 -0
- package/dist/emit/go/ws.js +70 -0
- package/dist/emit/java/gradle.d.ts +57 -0
- package/dist/emit/java/gradle.js +221 -0
- package/dist/emit/java/index.d.ts +2 -0
- package/dist/emit/java/index.js +2 -0
- package/dist/emit/java/json.d.ts +13 -0
- package/dist/emit/java/json.js +84 -0
- package/dist/emit/java/layout-ast.d.ts +146 -0
- package/dist/emit/java/layout-ast.js +102 -0
- package/dist/emit/java/layout-decl.d.ts +20 -0
- package/dist/emit/java/layout-decl.js +155 -0
- package/dist/emit/java/layout-doc.d.ts +55 -0
- package/dist/emit/java/layout-doc.js +166 -0
- package/dist/emit/java/layout-dot.d.ts +18 -0
- package/dist/emit/java/layout-dot.js +127 -0
- package/dist/emit/java/layout-strings.d.ts +8 -0
- package/dist/emit/java/layout-strings.js +76 -0
- package/dist/emit/java/layout-types.d.ts +11 -0
- package/dist/emit/java/layout-types.js +95 -0
- package/dist/emit/java/layout-visitor.d.ts +38 -0
- package/dist/emit/java/layout-visitor.js +232 -0
- package/dist/emit/java/layout.d.ts +61 -0
- package/dist/emit/java/layout.js +121 -0
- package/dist/emit/java/models-enum.d.ts +17 -0
- package/dist/emit/java/models-enum.js +51 -0
- package/dist/emit/java/models-names.d.ts +29 -0
- package/dist/emit/java/models-names.js +97 -0
- package/dist/emit/java/models-record.d.ts +24 -0
- package/dist/emit/java/models-record.js +79 -0
- package/dist/emit/java/models-union.d.ts +27 -0
- package/dist/emit/java/models-union.js +86 -0
- package/dist/emit/java/models.d.ts +28 -0
- package/dist/emit/java/models.js +118 -0
- package/dist/emit/java/realtime.d.ts +50 -0
- package/dist/emit/java/realtime.js +69 -0
- package/dist/emit/java/sdk-client.d.ts +66 -0
- package/dist/emit/java/sdk-client.js +207 -0
- package/dist/emit/java/sdk-decl.d.ts +11 -0
- package/dist/emit/java/sdk-decl.js +63 -0
- package/dist/emit/java/sdk-errors.d.ts +13 -0
- package/dist/emit/java/sdk-errors.js +141 -0
- package/dist/emit/java/sdk-headers.d.ts +12 -0
- package/dist/emit/java/sdk-headers.js +74 -0
- package/dist/emit/java/sdk-mirror.d.ts +14 -0
- package/dist/emit/java/sdk-mirror.js +107 -0
- package/dist/emit/java/sdk-models.d.ts +16 -0
- package/dist/emit/java/sdk-models.js +68 -0
- package/dist/emit/java/sdk-op.d.ts +57 -0
- package/dist/emit/java/sdk-op.js +216 -0
- package/dist/emit/java/sdk-params.d.ts +38 -0
- package/dist/emit/java/sdk-params.js +133 -0
- package/dist/emit/java/sdk-plan.d.ts +52 -0
- package/dist/emit/java/sdk-plan.js +1 -0
- package/dist/emit/java/sdk-record.d.ts +16 -0
- package/dist/emit/java/sdk-record.js +99 -0
- package/dist/emit/java/sdk.d.ts +49 -0
- package/dist/emit/java/sdk.js +216 -0
- package/dist/emit/java/sse.d.ts +35 -0
- package/dist/emit/java/sse.js +57 -0
- package/dist/emit/java/ws.d.ts +27 -0
- package/dist/emit/java/ws.js +31 -0
- package/dist/emit/mcp/annotations.d.ts +15 -0
- package/dist/emit/mcp/annotations.js +15 -0
- package/dist/emit/mcp/files.d.ts +18 -0
- package/dist/emit/mcp/files.js +42 -0
- package/dist/emit/mcp/index.d.ts +3 -0
- package/dist/emit/mcp/index.js +3 -0
- package/dist/emit/mcp/literal.d.ts +2 -0
- package/dist/emit/mcp/literal.js +33 -0
- package/dist/emit/mcp/mounted.d.ts +21 -0
- package/dist/emit/mcp/mounted.js +89 -0
- package/dist/emit/mcp/output-schema.d.ts +18 -0
- package/dist/emit/mcp/output-schema.js +38 -0
- package/dist/emit/mcp/registry.d.ts +23 -0
- package/dist/emit/mcp/registry.js +83 -0
- package/dist/emit/mcp/runtime.d.ts +10 -0
- package/dist/emit/mcp/runtime.js +47 -0
- package/dist/emit/mcp/schema.d.ts +19 -0
- package/dist/emit/mcp/schema.js +88 -0
- package/dist/emit/mcp/server.d.ts +30 -0
- package/dist/emit/mcp/server.js +246 -0
- package/dist/emit/mcp/tools.d.ts +51 -0
- package/dist/emit/mcp/tools.js +153 -0
- package/dist/emit/python/errors.d.ts +8 -0
- package/dist/emit/python/errors.js +68 -0
- package/dist/emit/python/index.d.ts +1 -0
- package/dist/emit/python/index.js +1 -0
- package/dist/emit/python/realtime.d.ts +10 -0
- package/dist/emit/python/realtime.js +33 -0
- package/dist/emit/python/sdk-answer.d.ts +49 -0
- package/dist/emit/python/sdk-answer.js +89 -0
- package/dist/emit/python/sdk-body.d.ts +11 -0
- package/dist/emit/python/sdk-body.js +40 -0
- package/dist/emit/python/sdk-client.d.ts +36 -0
- package/dist/emit/python/sdk-client.js +163 -0
- package/dist/emit/python/sdk-doc.d.ts +9 -0
- package/dist/emit/python/sdk-doc.js +32 -0
- package/dist/emit/python/sdk-imports.d.ts +14 -0
- package/dist/emit/python/sdk-imports.js +38 -0
- package/dist/emit/python/sdk-method.d.ts +29 -0
- package/dist/emit/python/sdk-method.js +183 -0
- package/dist/emit/python/sdk-plan.d.ts +33 -0
- package/dist/emit/python/sdk-plan.js +1 -0
- package/dist/emit/python/sdk-pyproject.d.ts +27 -0
- package/dist/emit/python/sdk-pyproject.js +103 -0
- package/dist/emit/python/sdk.d.ts +22 -0
- package/dist/emit/python/sdk.js +154 -0
- package/dist/emit/python/sse.d.ts +12 -0
- package/dist/emit/python/sse.js +23 -0
- package/dist/emit/python/transport.d.ts +15 -0
- package/dist/emit/python/transport.js +60 -0
- package/dist/emit/python/types-dict.d.ts +31 -0
- package/dist/emit/python/types-dict.js +45 -0
- package/dist/emit/python/types-names.d.ts +16 -0
- package/dist/emit/python/types-names.js +52 -0
- package/dist/emit/python/types-union.d.ts +32 -0
- package/dist/emit/python/types-union.js +46 -0
- package/dist/emit/python/types.d.ts +36 -0
- package/dist/emit/python/types.js +128 -0
- package/dist/emit/python/ws.d.ts +14 -0
- package/dist/emit/python/ws.js +16 -0
- package/dist/emit/rust/errors.d.ts +7 -0
- package/dist/emit/rust/errors.js +107 -0
- package/dist/emit/rust/http.d.ts +13 -0
- package/dist/emit/rust/http.js +67 -0
- package/dist/emit/rust/index.d.ts +1 -0
- package/dist/emit/rust/index.js +1 -0
- package/dist/emit/rust/realtime.d.ts +11 -0
- package/dist/emit/rust/realtime.js +29 -0
- package/dist/emit/rust/sdk-body.d.ts +19 -0
- package/dist/emit/rust/sdk-body.js +53 -0
- package/dist/emit/rust/sdk-cargo.d.ts +43 -0
- package/dist/emit/rust/sdk-cargo.js +178 -0
- package/dist/emit/rust/sdk-client.d.ts +25 -0
- package/dist/emit/rust/sdk-client.js +108 -0
- package/dist/emit/rust/sdk-method.d.ts +15 -0
- package/dist/emit/rust/sdk-method.js +119 -0
- package/dist/emit/rust/sdk-opts.d.ts +58 -0
- package/dist/emit/rust/sdk-opts.js +117 -0
- package/dist/emit/rust/sdk-plan.d.ts +33 -0
- package/dist/emit/rust/sdk-plan.js +1 -0
- package/dist/emit/rust/sdk.d.ts +23 -0
- package/dist/emit/rust/sdk.js +111 -0
- package/dist/emit/rust/sse.d.ts +19 -0
- package/dist/emit/rust/sse.js +20 -0
- package/dist/emit/rust/types-enum.d.ts +13 -0
- package/dist/emit/rust/types-enum.js +62 -0
- package/dist/emit/rust/types-names.d.ts +19 -0
- package/dist/emit/rust/types-names.js +66 -0
- package/dist/emit/rust/types-struct.d.ts +21 -0
- package/dist/emit/rust/types-struct.js +59 -0
- package/dist/emit/rust/types-union.d.ts +24 -0
- package/dist/emit/rust/types-union.js +97 -0
- package/dist/emit/rust/types.d.ts +34 -0
- package/dist/emit/rust/types.js +105 -0
- package/dist/emit/rust/ws.d.ts +21 -0
- package/dist/emit/rust/ws.js +20 -0
- package/dist/emit/shared/escape.d.ts +55 -0
- package/dist/emit/shared/escape.js +144 -0
- package/dist/emit/shared/format.d.ts +24 -0
- package/dist/emit/shared/format.js +23 -0
- package/dist/emit/shared/gofmt.d.ts +3 -0
- package/dist/emit/shared/gofmt.js +26 -0
- package/dist/emit/shared/lang.d.ts +60 -0
- package/dist/emit/shared/lang.js +233 -0
- package/dist/emit/shared/literals.d.ts +4 -0
- package/dist/emit/shared/literals.js +31 -0
- package/dist/emit/shared/metadata.d.ts +106 -0
- package/dist/emit/shared/metadata.js +130 -0
- package/dist/emit/shared/mirror.d.ts +22 -0
- package/dist/emit/shared/mirror.js +26 -0
- package/dist/emit/shared/ruff.d.ts +3 -0
- package/dist/emit/shared/ruff.js +31 -0
- package/dist/emit/shared/rustfmt.d.ts +3 -0
- package/dist/emit/shared/rustfmt.js +32 -0
- package/dist/emit/shared/status-keys.d.ts +7 -0
- package/dist/emit/shared/status-keys.js +67 -0
- package/dist/emit/shared/type-emitter.d.ts +19 -0
- package/dist/emit/shared/type-emitter.js +100 -0
- package/dist/emit/ts/app-client.d.ts +4 -0
- package/dist/emit/ts/app-client.js +68 -0
- package/dist/emit/ts/http.d.ts +20 -0
- package/dist/emit/ts/http.js +74 -0
- package/dist/emit/ts/package.d.ts +36 -0
- package/dist/emit/ts/package.js +126 -0
- package/dist/emit/ts/route-tree.d.ts +68 -0
- package/dist/emit/ts/route-tree.js +240 -0
- package/dist/emit/ts/sdk-types-preamble.d.ts +14 -0
- package/dist/emit/ts/sdk-types-preamble.js +123 -0
- package/dist/emit/ts/sdk-types.d.ts +13 -0
- package/dist/emit/ts/sdk-types.js +213 -0
- package/dist/emit/ts/sdk.d.ts +21 -0
- package/dist/emit/ts/sdk.js +173 -0
- package/dist/emit/ts/service-map.d.ts +40 -0
- package/dist/emit/ts/service-map.js +171 -0
- package/dist/emit/ts/tanstack-query.d.ts +12 -0
- package/dist/emit/ts/tanstack-query.js +156 -0
- package/dist/emit/ts/type-gen.d.ts +26 -0
- package/dist/emit/ts/type-gen.js +255 -0
- package/dist/emit/ts/webhooks.d.ts +19 -0
- package/dist/emit/ts/webhooks.js +81 -0
- package/dist/extract/chain.d.ts +34 -0
- package/dist/extract/chain.js +84 -0
- package/dist/extract/extract.d.ts +41 -0
- package/dist/extract/extract.js +191 -0
- package/dist/extract/serialize.d.ts +34 -0
- package/dist/extract/serialize.js +295 -0
- package/dist/extract/walk.d.ts +47 -0
- package/dist/extract/walk.js +109 -0
- package/dist/gen/args.d.ts +28 -0
- package/dist/gen/args.js +133 -0
- package/dist/gen/formatters.d.ts +62 -0
- package/dist/gen/formatters.js +146 -0
- package/dist/gen/process.d.ts +13 -0
- package/dist/gen/process.js +35 -0
- package/dist/gen/shipped.d.ts +17 -0
- package/dist/gen/shipped.js +55 -0
- package/dist/gen/targets.d.ts +93 -0
- package/dist/gen/targets.js +171 -0
- package/dist/gen/write.d.ts +33 -0
- package/dist/gen/write.js +118 -0
- package/dist/index.d.ts +13 -0
- package/dist/index.js +15 -0
- package/dist/ir/build.d.ts +37 -0
- package/dist/ir/build.js +152 -0
- package/dist/ir/load.d.ts +11 -0
- package/dist/ir/load.js +112 -0
- package/dist/ir/model.d.ts +206 -0
- package/dist/ir/model.js +5 -0
- package/dist/ir/resolve-refs.d.ts +11 -0
- package/dist/ir/resolve-refs.js +66 -0
- package/dist/ir/resource-tree.d.ts +9 -0
- package/dist/ir/resource-tree.js +53 -0
- package/dist/ir/route-tree-intern.d.ts +18 -0
- package/dist/ir/route-tree-intern.js +174 -0
- package/dist/ir/schema.d.ts +11 -0
- package/dist/ir/schema.js +192 -0
- package/dist/ir/sdk-model.d.ts +86 -0
- package/dist/ir/sdk-model.js +204 -0
- package/dist/ir/slots.d.ts +42 -0
- package/dist/ir/slots.js +245 -0
- package/dist/runtime/cli/body.go +176 -0
- package/dist/runtime/cli/config.go +243 -0
- package/dist/runtime/cli/discovery.go +147 -0
- package/dist/runtime/cli/format.go +174 -0
- package/dist/runtime/cli/log.go +117 -0
- package/dist/runtime/cli/output.go +247 -0
- package/dist/runtime/cli/params.go +197 -0
- package/dist/runtime/cli/run.go +226 -0
- package/dist/runtime/cli/socket.go +60 -0
- package/dist/runtime/cli/stream.go +217 -0
- package/dist/runtime/cli/target.go +117 -0
- package/dist/runtime/csharp/Adapters.cs +183 -0
- package/dist/runtime/csharp/Auth.cs +56 -0
- package/dist/runtime/csharp/Body.cs +135 -0
- package/dist/runtime/csharp/Config.cs +161 -0
- package/dist/runtime/csharp/Envelope.cs +149 -0
- package/dist/runtime/csharp/Errors.cs +194 -0
- package/dist/runtime/csharp/Events.cs +155 -0
- package/dist/runtime/csharp/Exchange.cs +247 -0
- package/dist/runtime/csharp/Handler.cs +103 -0
- package/dist/runtime/csharp/Hooks.cs +128 -0
- package/dist/runtime/csharp/Invalidation.cs +102 -0
- package/dist/runtime/csharp/Json.cs +144 -0
- package/dist/runtime/csharp/Log.cs +48 -0
- package/dist/runtime/csharp/Operation.cs +33 -0
- package/dist/runtime/csharp/Path.cs +65 -0
- package/dist/runtime/csharp/Query.cs +72 -0
- package/dist/runtime/csharp/Realtime.cs +118 -0
- package/dist/runtime/csharp/RealtimeLoop.cs +236 -0
- package/dist/runtime/csharp/Redirect.cs +53 -0
- package/dist/runtime/csharp/Result.cs +57 -0
- package/dist/runtime/csharp/Sse.cs +122 -0
- package/dist/runtime/csharp/Stale.cs +151 -0
- package/dist/runtime/csharp/Transport.cs +143 -0
- package/dist/runtime/csharp/TransportLongPoll.cs +63 -0
- package/dist/runtime/csharp/TransportSse.cs +54 -0
- package/dist/runtime/csharp/TransportWs.cs +40 -0
- package/dist/runtime/csharp/Wire.cs +109 -0
- package/dist/runtime/csharp/Ws.cs +300 -0
- package/dist/runtime/csharp/WsDial.cs +127 -0
- package/dist/runtime/go/auth.go +127 -0
- package/dist/runtime/go/body.go +129 -0
- package/dist/runtime/go/config.go +75 -0
- package/dist/runtime/go/errors.go +185 -0
- package/dist/runtime/go/export.go +37 -0
- package/dist/runtime/go/hooks.go +53 -0
- package/dist/runtime/go/invalidation.go +112 -0
- package/dist/runtime/go/log.go +92 -0
- package/dist/runtime/go/nullable.go +64 -0
- package/dist/runtime/go/options.go +118 -0
- package/dist/runtime/go/path.go +156 -0
- package/dist/runtime/go/query.go +147 -0
- package/dist/runtime/go/realtime.go +239 -0
- package/dist/runtime/go/realtime_loop.go +208 -0
- package/dist/runtime/go/redirect.go +124 -0
- package/dist/runtime/go/request.go +222 -0
- package/dist/runtime/go/result.go +86 -0
- package/dist/runtime/go/sse.go +186 -0
- package/dist/runtime/go/stale.go +229 -0
- package/dist/runtime/go/stream.go +105 -0
- package/dist/runtime/go/transport.go +242 -0
- package/dist/runtime/go/transport_longpoll.go +121 -0
- package/dist/runtime/go/transport_sse.go +175 -0
- package/dist/runtime/go/ws.go +205 -0
- package/dist/runtime/java/Answer.java +107 -0
- package/dist/runtime/java/ApiException.java +110 -0
- package/dist/runtime/java/BinaryBody.java +36 -0
- package/dist/runtime/java/Body.java +105 -0
- package/dist/runtime/java/Call.java +23 -0
- package/dist/runtime/java/CallLog.java +51 -0
- package/dist/runtime/java/ClientConfig.java +233 -0
- package/dist/runtime/java/ConnectionState.java +12 -0
- package/dist/runtime/java/Credential.java +58 -0
- package/dist/runtime/java/Deadline.java +38 -0
- package/dist/runtime/java/Decode.java +181 -0
- package/dist/runtime/java/Envelope.java +141 -0
- package/dist/runtime/java/ErrorEnvelope.java +23 -0
- package/dist/runtime/java/EventStream.java +129 -0
- package/dist/runtime/java/Exchange.java +62 -0
- package/dist/runtime/java/FilePart.java +5 -0
- package/dist/runtime/java/Flight.java +306 -0
- package/dist/runtime/java/HoneyException.java +14 -0
- package/dist/runtime/java/Hooks.java +47 -0
- package/dist/runtime/java/Hops.java +133 -0
- package/dist/runtime/java/InvalidationConfig.java +73 -0
- package/dist/runtime/java/Json.java +23 -0
- package/dist/runtime/java/Keepalive.java +60 -0
- package/dist/runtime/java/LogEntry.java +14 -0
- package/dist/runtime/java/LongPollAdapter.java +68 -0
- package/dist/runtime/java/Operation.java +21 -0
- package/dist/runtime/java/Opt.java +121 -0
- package/dist/runtime/java/Pump.java +160 -0
- package/dist/runtime/java/RawResponse.java +48 -0
- package/dist/runtime/java/Realtime.java +152 -0
- package/dist/runtime/java/RealtimeLoop.java +371 -0
- package/dist/runtime/java/RedirectPolicy.java +13 -0
- package/dist/runtime/java/Redirects.java +126 -0
- package/dist/runtime/java/RequestContext.java +78 -0
- package/dist/runtime/java/RequestHook.java +9 -0
- package/dist/runtime/java/RequestOptions.java +91 -0
- package/dist/runtime/java/ResponseContext.java +70 -0
- package/dist/runtime/java/ResponseHook.java +12 -0
- package/dist/runtime/java/Result.java +32 -0
- package/dist/runtime/java/ResumableConnection.java +165 -0
- package/dist/runtime/java/SdkException.java +11 -0
- package/dist/runtime/java/Socket.java +301 -0
- package/dist/runtime/java/Sse.java +171 -0
- package/dist/runtime/java/SseAdapter.java +61 -0
- package/dist/runtime/java/SseEvent.java +10 -0
- package/dist/runtime/java/StaleMeta.java +16 -0
- package/dist/runtime/java/StaleTracker.java +287 -0
- package/dist/runtime/java/Transport.java +16 -0
- package/dist/runtime/java/TransportAdapter.java +14 -0
- package/dist/runtime/java/TransportConnection.java +15 -0
- package/dist/runtime/java/TransportKind.java +12 -0
- package/dist/runtime/java/TransportMessage.java +9 -0
- package/dist/runtime/java/TransportOptions.java +138 -0
- package/dist/runtime/java/TypedWebSocket.java +83 -0
- package/dist/runtime/java/UrlPath.java +49 -0
- package/dist/runtime/java/UrlQuery.java +99 -0
- package/dist/runtime/java/WsAdapter.java +52 -0
- package/dist/runtime/java/WsClose.java +47 -0
- package/dist/runtime/java/WsDial.java +148 -0
- package/dist/runtime/java/WsMessage.java +18 -0
- package/dist/runtime/mcp/call.ts +167 -0
- package/dist/runtime/mcp/files.ts +183 -0
- package/dist/runtime/mcp/guard.ts +176 -0
- package/dist/runtime/mcp/http.ts +159 -0
- package/dist/runtime/mcp/jsonrpc.ts +50 -0
- package/dist/runtime/mcp/listen.ts +76 -0
- package/dist/runtime/mcp/mount.ts +123 -0
- package/dist/runtime/mcp/protocol.ts +219 -0
- package/dist/runtime/mcp/reader.ts +57 -0
- package/dist/runtime/mcp/result.ts +85 -0
- package/dist/runtime/mcp/stdio.ts +79 -0
- package/dist/runtime/mcp/stream.ts +62 -0
- package/dist/runtime/python/__init__.py +2 -0
- package/dist/runtime/python/auth.py +67 -0
- package/dist/runtime/python/body.py +83 -0
- package/dist/runtime/python/config.py +139 -0
- package/dist/runtime/python/errors.py +213 -0
- package/dist/runtime/python/events.py +152 -0
- package/dist/runtime/python/exchange.py +298 -0
- package/dist/runtime/python/hooks.py +86 -0
- package/dist/runtime/python/invalidation.py +57 -0
- package/dist/runtime/python/log.py +60 -0
- package/dist/runtime/python/operation.py +25 -0
- package/dist/runtime/python/path.py +41 -0
- package/dist/runtime/python/query.py +48 -0
- package/dist/runtime/python/realtime.py +244 -0
- package/dist/runtime/python/redirect.py +93 -0
- package/dist/runtime/python/result.py +58 -0
- package/dist/runtime/python/send_async.py +189 -0
- package/dist/runtime/python/send_sync.py +105 -0
- package/dist/runtime/python/sse.py +81 -0
- package/dist/runtime/python/stale.py +94 -0
- package/dist/runtime/python/transport.py +157 -0
- package/dist/runtime/python/transport_longpoll.py +60 -0
- package/dist/runtime/python/transport_sse.py +60 -0
- package/dist/runtime/python/transport_ws.py +57 -0
- package/dist/runtime/python/ws.py +276 -0
- package/dist/runtime/rust/Cargo.lock +1763 -0
- package/dist/runtime/rust/answer.rs +120 -0
- package/dist/runtime/rust/auth.rs +80 -0
- package/dist/runtime/rust/body.rs +150 -0
- package/dist/runtime/rust/call.rs +200 -0
- package/dist/runtime/rust/config.rs +254 -0
- package/dist/runtime/rust/envelope.rs +84 -0
- package/dist/runtime/rust/errors.rs +235 -0
- package/dist/runtime/rust/events.rs +177 -0
- package/dist/runtime/rust/exchange.rs +287 -0
- package/dist/runtime/rust/hooks.rs +63 -0
- package/dist/runtime/rust/invalidation.rs +84 -0
- package/dist/runtime/rust/log.rs +88 -0
- package/dist/runtime/rust/nullable.rs +13 -0
- package/dist/runtime/rust/path.rs +83 -0
- package/dist/runtime/rust/query.rs +84 -0
- package/dist/runtime/rust/realtime.rs +182 -0
- package/dist/runtime/rust/realtime_loop.rs +177 -0
- package/dist/runtime/rust/redirect.rs +121 -0
- package/dist/runtime/rust/request.rs +178 -0
- package/dist/runtime/rust/result.rs +101 -0
- package/dist/runtime/rust/sse.rs +104 -0
- package/dist/runtime/rust/stale.rs +209 -0
- package/dist/runtime/rust/transport.rs +221 -0
- package/dist/runtime/rust/transport_longpoll.rs +108 -0
- package/dist/runtime/rust/transport_sse.rs +91 -0
- package/dist/runtime/rust/transport_ws.rs +75 -0
- package/dist/runtime/rust/ws.rs +322 -0
- package/dist/runtime/ts/app-types.ts +200 -0
- package/dist/runtime/ts/app.ts +104 -0
- package/dist/runtime/ts/config.ts +124 -0
- package/dist/runtime/ts/defaults.ts +48 -0
- package/dist/runtime/ts/error.ts +113 -0
- package/dist/runtime/ts/hooks.ts +92 -0
- package/dist/runtime/ts/http.ts +228 -0
- package/dist/runtime/ts/media-type.ts +36 -0
- package/dist/runtime/ts/path.ts +152 -0
- package/dist/runtime/ts/realtime-connection.ts +296 -0
- package/dist/runtime/ts/realtime-transports.ts +149 -0
- package/dist/runtime/ts/realtime.ts +293 -0
- package/dist/runtime/ts/redirect-policy.ts +17 -0
- package/dist/runtime/ts/redirects.ts +74 -0
- package/dist/runtime/ts/request.ts +239 -0
- package/dist/runtime/ts/response.ts +219 -0
- package/dist/runtime/ts/sdk-realtime.ts +10 -0
- package/dist/runtime/ts/sdk-sse.ts +55 -0
- package/dist/runtime/ts/sdk-ws.ts +21 -0
- package/dist/runtime/ts/sdk.ts +242 -0
- package/dist/runtime/ts/sse.ts +175 -0
- package/dist/runtime/ts/stale.ts +137 -0
- package/dist/runtime/ts/stream.ts +87 -0
- package/dist/runtime/ts/webhook.ts +116 -0
- package/dist/runtime/ts/ws.ts +155 -0
- package/dist/runtime/ts-tanstack-query/invalidate.ts +152 -0
- package/dist/runtime/ts-tanstack-query/query.ts +261 -0
- package/package.json +84 -5
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
const SCALARS = ["boolean", "integer", "null", "number", "string"];
|
|
2
|
+
const lastSegment = (ref) => ref.split("/").pop();
|
|
3
|
+
/** Whether `schema` admits null: `nullable`, a null in its type list, or a null variant. */
|
|
4
|
+
function isNullable(schema) {
|
|
5
|
+
if (schema.nullable === true)
|
|
6
|
+
return true;
|
|
7
|
+
if (Array.isArray(schema.type) && schema.type.includes("null"))
|
|
8
|
+
return true;
|
|
9
|
+
const variants = (schema.anyOf ?? schema.oneOf);
|
|
10
|
+
return variants?.some((variant) => variant.type === "null") === true;
|
|
11
|
+
}
|
|
12
|
+
/** The schema `schema` makes nullable; never wrapped twice. */
|
|
13
|
+
function nullableOf(schema) {
|
|
14
|
+
let inner;
|
|
15
|
+
/* only a type list that holds null is stripped; a flag beside any other list drops the flag below */
|
|
16
|
+
if (Array.isArray(schema.type) && schema.type.includes("null")) {
|
|
17
|
+
const rest = schema.type.filter((type) => type !== "null");
|
|
18
|
+
inner = schemaToIR({ ...schema, type: rest.length === 1 ? rest[0] : rest });
|
|
19
|
+
}
|
|
20
|
+
else if (schema.anyOf !== undefined || schema.oneOf !== undefined) {
|
|
21
|
+
const key = schema.anyOf === undefined ? "oneOf" : "anyOf";
|
|
22
|
+
const rest = schema[key].filter((variant) => variant.type !== "null");
|
|
23
|
+
inner = rest.length === 0 ? { kind: "unknown" } : variantsOf(schema, key, rest);
|
|
24
|
+
}
|
|
25
|
+
else {
|
|
26
|
+
const { nullable: _flag, ...rest } = schema;
|
|
27
|
+
inner = schemaToIR(rest);
|
|
28
|
+
}
|
|
29
|
+
return inner.kind === "nullable" ? inner : { inner, kind: "nullable" };
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* `variants`, the ones `schema` lists under `key`, as one schema. A sole variant is the value itself: it is read
|
|
33
|
+
* with the keys `schema` states beside the list, the variant's own winning, as a narrowed type list or a stripped
|
|
34
|
+
* nullable flag keeps them; annotations such as a description are left where they are read, on the field or the
|
|
35
|
+
* parameter that holds `schema`. More variants are their union.
|
|
36
|
+
*/
|
|
37
|
+
function variantsOf(schema, key, variants) {
|
|
38
|
+
if (variants.length !== 1)
|
|
39
|
+
return { kind: "union", variants: variants.map(schemaToIR) };
|
|
40
|
+
const { [key]: _list, ...beside } = schema;
|
|
41
|
+
return schemaToIR({ ...beside, ...variants[0] });
|
|
42
|
+
}
|
|
43
|
+
/** A union, or with no discriminator, its sole variant (`variantsOf`). */
|
|
44
|
+
function unionOf(schema) {
|
|
45
|
+
const key = schema.oneOf === undefined ? "anyOf" : "oneOf";
|
|
46
|
+
const raw = schema.discriminator;
|
|
47
|
+
if (raw === undefined)
|
|
48
|
+
return variantsOf(schema, key, schema[key]);
|
|
49
|
+
const variants = schema[key].map(schemaToIR);
|
|
50
|
+
const discriminator = { propertyName: raw.propertyName };
|
|
51
|
+
const mapping = raw.mapping && Object.entries(raw.mapping).map(([value, ref]) => [value, lastSegment(ref)]);
|
|
52
|
+
if (mapping)
|
|
53
|
+
discriminator.mapping = Object.fromEntries(mapping);
|
|
54
|
+
return { discriminator, kind: "union", variants };
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* A string or integer enum as a scalar; a mixed one as a union of consts; `null` when it is neither. A null is never
|
|
58
|
+
* one of its values: it makes an untyped enum the nullable of its other values, a typed one is already nullable by its
|
|
59
|
+
* type or admits no null at all, and a null alone is the null type.
|
|
60
|
+
*/
|
|
61
|
+
function enumOf(schema) {
|
|
62
|
+
const given = schema.enum;
|
|
63
|
+
if (given.includes(null)) {
|
|
64
|
+
const rest = given.filter((value) => value !== null);
|
|
65
|
+
if (rest.length === 0)
|
|
66
|
+
return { kind: "scalar", type: "null" };
|
|
67
|
+
const inner = enumOf({ ...schema, enum: rest });
|
|
68
|
+
return schema.type !== undefined || inner === null ? inner : { inner, kind: "nullable" };
|
|
69
|
+
}
|
|
70
|
+
const values = given;
|
|
71
|
+
if (values.length === 0)
|
|
72
|
+
return null;
|
|
73
|
+
const all = (test) => schema.type === undefined && values.every(test);
|
|
74
|
+
if (schema.type === "string" || all((value) => typeof value === "string"))
|
|
75
|
+
return { enum: values, kind: "scalar", type: "string" };
|
|
76
|
+
if (schema.type === "integer" || all(Number.isInteger))
|
|
77
|
+
return { enum: values, kind: "scalar", type: "integer" };
|
|
78
|
+
return values.every(literal) ? { kind: "union", variants: values.map((value) => ({ kind: "const", value })) } : null;
|
|
79
|
+
}
|
|
80
|
+
function objectOf(schema) {
|
|
81
|
+
const properties = (schema.properties ?? {});
|
|
82
|
+
const required = new Set(schema.required ?? []);
|
|
83
|
+
const fields = Object.entries(properties).map(([name, property]) => {
|
|
84
|
+
const field = { name, required: required.has(name), schema: schemaToIR(property) };
|
|
85
|
+
if (typeof property.description === "string")
|
|
86
|
+
field.description = property.description;
|
|
87
|
+
return field;
|
|
88
|
+
});
|
|
89
|
+
const ap = schema.additionalProperties;
|
|
90
|
+
if (ap === undefined)
|
|
91
|
+
return { fields, kind: "object" };
|
|
92
|
+
const additional = ap === false ? false : ap === true ? { kind: "unknown" } : schemaToIR(ap);
|
|
93
|
+
return { additional, fields, kind: "object" };
|
|
94
|
+
}
|
|
95
|
+
const isSchema = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
|
|
96
|
+
/**
|
|
97
|
+
* A tuple, as 2020-12 (`prefixItems`, then `items` for the rest) or draft-07 (`items` as a list,
|
|
98
|
+
* then `additionalItems`) writes it. Without a rest schema it is closed: zod leaves `items: false`
|
|
99
|
+
* out of a closed tuple. `minItems` below the length makes an optional tail.
|
|
100
|
+
*/
|
|
101
|
+
function tupleOf(schema) {
|
|
102
|
+
const modern = Array.isArray(schema.prefixItems);
|
|
103
|
+
const fixed = (modern ? schema.prefixItems : schema.items);
|
|
104
|
+
if (!Array.isArray(fixed))
|
|
105
|
+
return null;
|
|
106
|
+
const tuple = { items: fixed.map(schemaToIR), kind: "tuple" };
|
|
107
|
+
const rest = modern ? schema.items : schema.additionalItems;
|
|
108
|
+
if (isSchema(rest))
|
|
109
|
+
tuple.rest = schemaToIR(rest);
|
|
110
|
+
if (typeof schema.minItems === "number" && schema.minItems < fixed.length)
|
|
111
|
+
tuple.required = schema.minItems;
|
|
112
|
+
return tuple;
|
|
113
|
+
}
|
|
114
|
+
const literal = (value) => typeof value === "string" || typeof value === "number" || typeof value === "boolean";
|
|
115
|
+
function constOf(schema) {
|
|
116
|
+
const value = schema.const;
|
|
117
|
+
if (!literal(value))
|
|
118
|
+
return null;
|
|
119
|
+
const typed = SCALARS.includes(schema.type) && schema.type !== "null";
|
|
120
|
+
return typed ? { kind: "const", type: schema.type, value } : { kind: "const", value };
|
|
121
|
+
}
|
|
122
|
+
/* the constraint keywords a value carries (bit 19 c), each read when the spec states it with its JSON type */
|
|
123
|
+
const BOUNDS = ["minLength", "maxLength", "minimum", "maximum", "exclusiveMinimum", "exclusiveMaximum"];
|
|
124
|
+
function scalarOf(schema) {
|
|
125
|
+
if (!SCALARS.includes(schema.type))
|
|
126
|
+
return null;
|
|
127
|
+
const scalar = { kind: "scalar", type: schema.type };
|
|
128
|
+
if (typeof schema.format === "string")
|
|
129
|
+
scalar.format = schema.format;
|
|
130
|
+
if (Array.isArray(schema.enum))
|
|
131
|
+
scalar.enum = schema.enum;
|
|
132
|
+
for (const bound of BOUNDS)
|
|
133
|
+
if (typeof schema[bound] === "number")
|
|
134
|
+
scalar[bound] = schema[bound];
|
|
135
|
+
if (typeof schema.pattern === "string")
|
|
136
|
+
scalar.pattern = schema.pattern;
|
|
137
|
+
return scalar;
|
|
138
|
+
}
|
|
139
|
+
function arrayOf(schema) {
|
|
140
|
+
const array = {
|
|
141
|
+
items: schemaToIR(schema.items),
|
|
142
|
+
kind: "array",
|
|
143
|
+
};
|
|
144
|
+
if (typeof schema.minItems === "number")
|
|
145
|
+
array.minItems = schema.minItems;
|
|
146
|
+
if (typeof schema.maxItems === "number")
|
|
147
|
+
array.maxItems = schema.maxItems;
|
|
148
|
+
return array;
|
|
149
|
+
}
|
|
150
|
+
/* the order matters: a ref before anything it might also say, const before type, nullability before unions */
|
|
151
|
+
const READERS = [
|
|
152
|
+
(schema) => (typeof schema.$ref === "string" ? { kind: "ref", name: lastSegment(schema.$ref) } : null),
|
|
153
|
+
(schema) => (Array.isArray(schema.allOf) ? { kind: "allOf", parts: schema.allOf.map(schemaToIR) } : null),
|
|
154
|
+
constOf,
|
|
155
|
+
(schema) => (isNullable(schema) ? nullableOf(schema) : null),
|
|
156
|
+
(schema) => Array.isArray(schema.type) && schema.type.length > 1
|
|
157
|
+
? { kind: "union", variants: schema.type.map((type) => schemaToIR({ ...schema, type })) }
|
|
158
|
+
: null,
|
|
159
|
+
(schema) => (Array.isArray(schema.oneOf) || Array.isArray(schema.anyOf) ? unionOf(schema) : null),
|
|
160
|
+
(schema) => (Array.isArray(schema.enum) ? enumOf(schema) : null),
|
|
161
|
+
(schema) => schema.format === "binary" && (schema.type === "string" || schema.type === undefined) ? { kind: "binary" } : null,
|
|
162
|
+
tupleOf,
|
|
163
|
+
(schema) => (schema.type === "array" ? arrayOf(schema) : null),
|
|
164
|
+
(schema) => schema.type === "object" || schema.properties !== undefined || schema.additionalProperties !== undefined
|
|
165
|
+
? objectOf(schema)
|
|
166
|
+
: null,
|
|
167
|
+
scalarOf,
|
|
168
|
+
];
|
|
169
|
+
/** What a typed value of `schema` is in the IR, read in a fixed order; anything unreadable is `unknown`. */
|
|
170
|
+
export function schemaToIR(schema) {
|
|
171
|
+
if (schema === undefined)
|
|
172
|
+
return { kind: "unknown" };
|
|
173
|
+
for (const read of READERS) {
|
|
174
|
+
const ir = read(schema);
|
|
175
|
+
if (ir !== null)
|
|
176
|
+
return ir;
|
|
177
|
+
}
|
|
178
|
+
return { kind: "unknown" };
|
|
179
|
+
}
|
|
180
|
+
/** Follows `ref` nodes to their component; an unknown or endless one is `unknown`. */
|
|
181
|
+
export function irResolver(schemas) {
|
|
182
|
+
return (schema) => {
|
|
183
|
+
let at = schema;
|
|
184
|
+
for (let hops = 0; at.kind === "ref"; hops++) {
|
|
185
|
+
const next = Object.hasOwn(schemas, at.name) ? schemas[at.name] : undefined;
|
|
186
|
+
if (next === undefined || hops === 32)
|
|
187
|
+
return { kind: "unknown" };
|
|
188
|
+
at = next;
|
|
189
|
+
}
|
|
190
|
+
return at;
|
|
191
|
+
};
|
|
192
|
+
}
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
import { type IR, type IRMultipartPart, type IROperation, type IRParam, type IRSchema } from "./model.ts";
|
|
2
|
+
import { type IRPathSegment } from "./slots.ts";
|
|
3
|
+
export type SdkBody = {
|
|
4
|
+
kind: "json";
|
|
5
|
+
contentType: string;
|
|
6
|
+
schema: IRSchema;
|
|
7
|
+
required: boolean;
|
|
8
|
+
} | {
|
|
9
|
+
kind: "form";
|
|
10
|
+
contentType: string;
|
|
11
|
+
schema: IRSchema;
|
|
12
|
+
required: boolean;
|
|
13
|
+
} | {
|
|
14
|
+
kind: "multipart";
|
|
15
|
+
contentType: string;
|
|
16
|
+
parts: IRMultipartPart[];
|
|
17
|
+
required: boolean;
|
|
18
|
+
} | {
|
|
19
|
+
kind: "binary";
|
|
20
|
+
contentType: string;
|
|
21
|
+
required: boolean;
|
|
22
|
+
} | {
|
|
23
|
+
kind: "text";
|
|
24
|
+
contentType: string;
|
|
25
|
+
required: boolean;
|
|
26
|
+
};
|
|
27
|
+
export type SdkResponseKind = "binary" | "json" | "none" | "text";
|
|
28
|
+
export type SdkSuccess = {
|
|
29
|
+
kind: SdkResponseKind;
|
|
30
|
+
status: string;
|
|
31
|
+
contentType?: string;
|
|
32
|
+
schema?: IRSchema;
|
|
33
|
+
};
|
|
34
|
+
export type SdkStream = "realtime" | "sse" | "ws" | null;
|
|
35
|
+
export type SdkOp = {
|
|
36
|
+
ir: IROperation;
|
|
37
|
+
id: string;
|
|
38
|
+
/** the id's dotted segments */
|
|
39
|
+
segments: string[];
|
|
40
|
+
method: string;
|
|
41
|
+
path: string;
|
|
42
|
+
pathSegments: IRPathSegment[];
|
|
43
|
+
pathParams: IRParam[];
|
|
44
|
+
/** in code-unit order by name */
|
|
45
|
+
query: IRParam[];
|
|
46
|
+
headers: IRParam[];
|
|
47
|
+
body?: SdkBody;
|
|
48
|
+
success: SdkSuccess;
|
|
49
|
+
/** the schema of its events' `data`, when its event stream declares one that is not a string (`sseEventSchema`) */
|
|
50
|
+
events?: IRSchema;
|
|
51
|
+
/** the 4xx and 5xx statuses it declares, ascending */
|
|
52
|
+
errorStatuses: number[];
|
|
53
|
+
stream: SdkStream;
|
|
54
|
+
idempotent: boolean;
|
|
55
|
+
invalidates: string[];
|
|
56
|
+
summary: string;
|
|
57
|
+
description: string;
|
|
58
|
+
deprecated: boolean;
|
|
59
|
+
};
|
|
60
|
+
export type SdkModel = {
|
|
61
|
+
ir: IR;
|
|
62
|
+
ops: SdkOp[];
|
|
63
|
+
opsById: Map<string, SdkOp>;
|
|
64
|
+
/** the component schema names, in code-unit order */
|
|
65
|
+
schemaNames: string[];
|
|
66
|
+
/** follows refs to their component; an unknown one is `unknown` */
|
|
67
|
+
resolve: (schema: IRSchema) => IRSchema;
|
|
68
|
+
};
|
|
69
|
+
/** A media type's essence: `Application/JSON; charset=utf-8` → `application/json`. */
|
|
70
|
+
export declare function mediaEssence(contentType: string): string;
|
|
71
|
+
export declare function isJsonMedia(contentType: string): boolean;
|
|
72
|
+
export declare function isTextMedia(contentType: string): boolean;
|
|
73
|
+
/**
|
|
74
|
+
* The schema an SSE op declares for its events' `data`, when it is not a string: such events are
|
|
75
|
+
* JSON (core JSON-encodes an object `data`) and the client parses them.
|
|
76
|
+
*/
|
|
77
|
+
export declare function sseEventSchema(op: IROperation, resolve: (schema: IRSchema) => IRSchema): IRSchema | undefined;
|
|
78
|
+
/** The SDK model of `ir` (built with `deriveOperationIds`, so every operation has an id). */
|
|
79
|
+
export declare function sdkModel(ir: IR): SdkModel;
|
|
80
|
+
/** The component schemas on a by-value cycle, direct or mutual: such a reference needs a pointer or a `Box`. */
|
|
81
|
+
export declare function valueCycleSchemas(schemas: Record<string, IRSchema>): Set<string>;
|
|
82
|
+
/** honey's error envelope (`success: false`, an `error_key` enum, one `status`): its keys and status, else `null`. */
|
|
83
|
+
export declare function irErrorEnvelope(schema: IRSchema, resolve: (schema: IRSchema) => IRSchema): {
|
|
84
|
+
keys: string[];
|
|
85
|
+
status: number;
|
|
86
|
+
} | null;
|
|
@@ -0,0 +1,204 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* One request model for the Go, Rust, Python and Go CLI emitters, read from the IR alone: method,
|
|
3
|
+
* query, headers, body and answer handling are decided once here for regular, SSE, WebSocket and
|
|
4
|
+
* realtime calls alike, instead of in each emitter.
|
|
5
|
+
*/
|
|
6
|
+
import { compareCodeUnits } from "../emit/shared/lang.js";
|
|
7
|
+
import { irResolver } from "./schema.js";
|
|
8
|
+
import { parseOpenApiPath } from "./slots.js";
|
|
9
|
+
/** A media type's essence: `Application/JSON; charset=utf-8` → `application/json`. */
|
|
10
|
+
export function mediaEssence(contentType) {
|
|
11
|
+
return contentType.split(";")[0].trim().toLowerCase();
|
|
12
|
+
}
|
|
13
|
+
export function isJsonMedia(contentType) {
|
|
14
|
+
const essence = mediaEssence(contentType);
|
|
15
|
+
return essence === "application/json" || essence.endsWith("+json");
|
|
16
|
+
}
|
|
17
|
+
export function isTextMedia(contentType) {
|
|
18
|
+
const essence = mediaEssence(contentType);
|
|
19
|
+
const [type, subtype] = essence.split("/");
|
|
20
|
+
return (type === "text" && subtype !== undefined) || essence === "application/xml" || essence.endsWith("+xml");
|
|
21
|
+
}
|
|
22
|
+
function kindOf(contentType) {
|
|
23
|
+
if (contentType === undefined || mediaEssence(contentType) === "text/event-stream")
|
|
24
|
+
return "none";
|
|
25
|
+
if (isJsonMedia(contentType))
|
|
26
|
+
return "json";
|
|
27
|
+
return isTextMedia(contentType) ? "text" : "binary";
|
|
28
|
+
}
|
|
29
|
+
/** The answer a call returns: the lowest 2xx with a body, else the lowest 2xx, else a JSON 2XX or default. */
|
|
30
|
+
function successOf(op) {
|
|
31
|
+
const codes = Object.keys(op.responses)
|
|
32
|
+
.filter((status) => /^2[0-9]{2}$/.test(status))
|
|
33
|
+
.sort((a, b) => Number(a) - Number(b));
|
|
34
|
+
const status = codes.find((code) => op.responses[code]?.contentType !== undefined) ?? codes[0];
|
|
35
|
+
if (status === undefined) {
|
|
36
|
+
const fallback = op.responses["2XX"] ?? op.responses.default;
|
|
37
|
+
if (fallback?.contentType === undefined || !isJsonMedia(fallback.contentType)) {
|
|
38
|
+
return { kind: Object.keys(op.responses).length === 0 ? "json" : "none", status: "200" };
|
|
39
|
+
}
|
|
40
|
+
const out = { contentType: fallback.contentType, kind: "json", status: fallback.status };
|
|
41
|
+
if (fallback.schema !== undefined)
|
|
42
|
+
out.schema = fallback.schema;
|
|
43
|
+
return out;
|
|
44
|
+
}
|
|
45
|
+
const response = op.responses[status];
|
|
46
|
+
const kind = status === "204" || status === "205" ? "none" : kindOf(response.contentType);
|
|
47
|
+
const out = { kind, status };
|
|
48
|
+
if (response.contentType !== undefined)
|
|
49
|
+
out.contentType = response.contentType;
|
|
50
|
+
if (response.schema !== undefined && kind === "json")
|
|
51
|
+
out.schema = response.schema;
|
|
52
|
+
return out;
|
|
53
|
+
}
|
|
54
|
+
/** What a call sends: JSON, a form, multipart parts (a text-only multipart's fields as text parts), text or bytes. */
|
|
55
|
+
function bodyOf(op, resolve) {
|
|
56
|
+
const body = op.body;
|
|
57
|
+
if (body === undefined)
|
|
58
|
+
return undefined;
|
|
59
|
+
const { contentType, required } = body;
|
|
60
|
+
if (body.kind === "stream")
|
|
61
|
+
return { contentType, kind: "binary", required };
|
|
62
|
+
if (body.kind === "multipart")
|
|
63
|
+
return { contentType, kind: "multipart", parts: body.parts, required };
|
|
64
|
+
if (isJsonMedia(contentType))
|
|
65
|
+
return { contentType, kind: "json", required, schema: body.schema };
|
|
66
|
+
const essence = mediaEssence(contentType);
|
|
67
|
+
if (essence === "application/x-www-form-urlencoded")
|
|
68
|
+
return { contentType, kind: "form", required, schema: body.schema };
|
|
69
|
+
if (essence === "multipart/form-data") {
|
|
70
|
+
const form = resolve(body.schema);
|
|
71
|
+
const parts = form.kind === "object" ? form.fields.map(({ name, schema }) => ({ name, schema, type: "text" })) : [];
|
|
72
|
+
return { contentType, kind: "multipart", parts, required };
|
|
73
|
+
}
|
|
74
|
+
return { contentType, kind: isTextMedia(contentType) ? "text" : "binary", required };
|
|
75
|
+
}
|
|
76
|
+
function streamOf(op) {
|
|
77
|
+
const { realtime, sse, websocket } = op.extensions;
|
|
78
|
+
if (realtime === true)
|
|
79
|
+
return "realtime";
|
|
80
|
+
if (websocket === true)
|
|
81
|
+
return "ws";
|
|
82
|
+
return sse === true ? "sse" : null;
|
|
83
|
+
}
|
|
84
|
+
/* a string-typed schema: a scalar string, or a string const or enum */
|
|
85
|
+
const isStringSchema = (schema) => (schema.kind === "scalar" && schema.type === "string") ||
|
|
86
|
+
(schema.kind === "const" && typeof schema.value === "string");
|
|
87
|
+
/**
|
|
88
|
+
* The schema an SSE op declares for its events' `data`, when it is not a string: such events are
|
|
89
|
+
* JSON (core JSON-encodes an object `data`) and the client parses them.
|
|
90
|
+
*/
|
|
91
|
+
export function sseEventSchema(op, resolve) {
|
|
92
|
+
const response = Object.values(op.responses).find(({ contentType }) => contentType !== undefined && mediaEssence(contentType) === "text/event-stream");
|
|
93
|
+
if (response?.schema === undefined)
|
|
94
|
+
return undefined;
|
|
95
|
+
const resolved = resolve(response.schema);
|
|
96
|
+
return resolved.kind === "unknown" || isStringSchema(resolved) ? undefined : response.schema;
|
|
97
|
+
}
|
|
98
|
+
function opOf(op, resolve) {
|
|
99
|
+
const errorStatuses = Object.keys(op.responses)
|
|
100
|
+
.filter((status) => /^[0-9]{3}$/.test(status) && Number(status) >= 400)
|
|
101
|
+
.map(Number)
|
|
102
|
+
.sort((a, b) => a - b);
|
|
103
|
+
const out = {
|
|
104
|
+
deprecated: op.extensions.deprecated === true,
|
|
105
|
+
description: op.description ?? "",
|
|
106
|
+
errorStatuses,
|
|
107
|
+
headers: op.params.header,
|
|
108
|
+
id: op.id,
|
|
109
|
+
idempotent: op.extensions.idempotencyKey === true,
|
|
110
|
+
invalidates: op.extensions.invalidates ?? [],
|
|
111
|
+
ir: op,
|
|
112
|
+
method: op.method,
|
|
113
|
+
path: op.path,
|
|
114
|
+
pathParams: op.params.path,
|
|
115
|
+
pathSegments: parseOpenApiPath(op.path),
|
|
116
|
+
query: [...op.params.query].sort((a, b) => compareCodeUnits(a.name, b.name)),
|
|
117
|
+
segments: op.id.split("."),
|
|
118
|
+
stream: streamOf(op),
|
|
119
|
+
success: successOf(op),
|
|
120
|
+
summary: op.summary ?? "",
|
|
121
|
+
};
|
|
122
|
+
const body = bodyOf(op, resolve);
|
|
123
|
+
if (body !== undefined)
|
|
124
|
+
out.body = body;
|
|
125
|
+
const events = sseEventSchema(op, resolve);
|
|
126
|
+
if (events !== undefined)
|
|
127
|
+
out.events = events;
|
|
128
|
+
return out;
|
|
129
|
+
}
|
|
130
|
+
/** The SDK model of `ir` (built with `deriveOperationIds`, so every operation has an id). */
|
|
131
|
+
export function sdkModel(ir) {
|
|
132
|
+
const resolve = irResolver(ir.schemas);
|
|
133
|
+
const ops = ir.operations.map((op) => opOf(op, resolve));
|
|
134
|
+
return {
|
|
135
|
+
ir,
|
|
136
|
+
ops,
|
|
137
|
+
opsById: new Map(ops.map((op) => [op.id, op])),
|
|
138
|
+
resolve,
|
|
139
|
+
schemaNames: Object.keys(ir.schemas).sort(compareCodeUnits),
|
|
140
|
+
};
|
|
141
|
+
}
|
|
142
|
+
/** The refs `schema` holds by value: through fields, allOf, nullable and union variants, not through containers. */
|
|
143
|
+
function valueRefs(schema) {
|
|
144
|
+
if (schema.kind === "ref")
|
|
145
|
+
return [schema.name];
|
|
146
|
+
if (schema.kind === "object")
|
|
147
|
+
return schema.fields.flatMap(({ schema: field }) => valueRefs(field));
|
|
148
|
+
if (schema.kind === "allOf")
|
|
149
|
+
return schema.parts.flatMap(valueRefs);
|
|
150
|
+
if (schema.kind === "union")
|
|
151
|
+
return schema.variants.flatMap(valueRefs);
|
|
152
|
+
return schema.kind === "nullable" ? valueRefs(schema.inner) : [];
|
|
153
|
+
}
|
|
154
|
+
/** The component schemas on a by-value cycle, direct or mutual: such a reference needs a pointer or a `Box`. */
|
|
155
|
+
export function valueCycleSchemas(schemas) {
|
|
156
|
+
const edges = new Map(Object.entries(schemas).map(([name, schema]) => [name, valueRefs(schema)]));
|
|
157
|
+
const cyclic = new Set();
|
|
158
|
+
for (const start of edges.keys()) {
|
|
159
|
+
const seen = new Set();
|
|
160
|
+
const stack = [...edges.get(start)];
|
|
161
|
+
while (stack.length > 0) {
|
|
162
|
+
const at = stack.pop();
|
|
163
|
+
if (at === start) {
|
|
164
|
+
cyclic.add(start);
|
|
165
|
+
break;
|
|
166
|
+
}
|
|
167
|
+
if (seen.has(at))
|
|
168
|
+
continue;
|
|
169
|
+
seen.add(at);
|
|
170
|
+
stack.push(...(edges.get(at) ?? []));
|
|
171
|
+
}
|
|
172
|
+
}
|
|
173
|
+
return cyclic;
|
|
174
|
+
}
|
|
175
|
+
const isString = (schema) => schema?.kind === "scalar" && schema.type === "string";
|
|
176
|
+
/** Whether `envelope` has the envelope's fixed shape: `success: false`, a message, a status key and its field list. */
|
|
177
|
+
function envelopeShape(envelope, field, resolve) {
|
|
178
|
+
const success = field(envelope, "success");
|
|
179
|
+
if (success?.kind !== "const" || success.value !== false)
|
|
180
|
+
return false;
|
|
181
|
+
if (!isString(field(envelope, "message")) || !isString(field(envelope, "status_key")))
|
|
182
|
+
return false;
|
|
183
|
+
const fields = field(envelope, "fields");
|
|
184
|
+
const list = fields?.kind === "object" && fields.additional ? resolve(fields.additional) : undefined;
|
|
185
|
+
const item = list?.kind === "array" ? resolve(list.items) : undefined;
|
|
186
|
+
return ["error_key", "message", "path"].every((name) => isString(field(item, name)));
|
|
187
|
+
}
|
|
188
|
+
/** honey's error envelope (`success: false`, an `error_key` enum, one `status`): its keys and status, else `null`. */
|
|
189
|
+
export function irErrorEnvelope(schema, resolve) {
|
|
190
|
+
const field = (object, name) => {
|
|
191
|
+
const found = object?.kind === "object" ? object.fields.find((f) => f.name === name) : undefined;
|
|
192
|
+
return found === undefined ? undefined : resolve(found.schema);
|
|
193
|
+
};
|
|
194
|
+
const envelope = resolve(schema);
|
|
195
|
+
if (!envelopeShape(envelope, field, resolve))
|
|
196
|
+
return null;
|
|
197
|
+
const status = field(envelope, "status");
|
|
198
|
+
const key = field(envelope, "error_key");
|
|
199
|
+
if (status?.kind !== "scalar" || status.enum?.length !== 1 || typeof status.enum[0] !== "number")
|
|
200
|
+
return null;
|
|
201
|
+
if (key?.kind !== "scalar" || key.enum === undefined || key.enum.length === 0)
|
|
202
|
+
return null;
|
|
203
|
+
return key.enum.every((k) => typeof k === "string") ? { keys: key.enum, status: status.enum[0] } : null;
|
|
204
|
+
}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* One operation's slots in the IR: its parameters by where they travel, its request bodies in
|
|
3
|
+
* preference order, its responses by status, and the honey extensions it carries (realtime, SSE,
|
|
4
|
+
* websocket, invalidation…), and for a Standard Webhooks event, its type and data. Component `$ref`s on
|
|
5
|
+
* parameters, bodies, responses and an event's envelope are followed.
|
|
6
|
+
*/
|
|
7
|
+
import { type IRBody, type IROperation, type IROperationExtensions, type IRResponse, type IRWebhookEvent } from "./model.ts";
|
|
8
|
+
type Json = Record<string, unknown>;
|
|
9
|
+
/** The document's `components`, by section then name. */
|
|
10
|
+
export type Components = Readonly<Record<string, Readonly<Record<string, unknown>>>>;
|
|
11
|
+
/** A path template's pieces: literal text and `{param}` names. */
|
|
12
|
+
export type IRPathSegment = {
|
|
13
|
+
kind: "literal";
|
|
14
|
+
text: string;
|
|
15
|
+
} | {
|
|
16
|
+
kind: "param";
|
|
17
|
+
name: string;
|
|
18
|
+
};
|
|
19
|
+
/** Splits an OpenAPI path template into literal text and `{param}` pieces. */
|
|
20
|
+
export declare function parseOpenApiPath(path: string): IRPathSegment[];
|
|
21
|
+
/** The path template's parameter names, once each, in order. */
|
|
22
|
+
export declare function openApiPathParams(path: string): string[];
|
|
23
|
+
/** Every request body an operation declares, preferred first. */
|
|
24
|
+
export declare function bodiesOf(op: IROperation): IRBody[];
|
|
25
|
+
/** An operation's parameters, the path item's applying unless the operation declares the same name and place. */
|
|
26
|
+
export declare function paramsOf(path: string, op: Json, item: Json, components: Components): IROperation["params"];
|
|
27
|
+
/** Every request body the operation declares, preferred first. */
|
|
28
|
+
export declare function requestBodies(op: Json, components: Components): IRBody[];
|
|
29
|
+
/** The responses by status, each with its preferred media type's schema; and whether any streams events. */
|
|
30
|
+
export declare function responsesOf(op: Json, components: Components): {
|
|
31
|
+
responses: Record<string, IRResponse>;
|
|
32
|
+
sse: boolean;
|
|
33
|
+
};
|
|
34
|
+
/** The honey extensions: each only when it is literally `true`; invalidation targets as strings. */
|
|
35
|
+
export declare function extensionsOf(op: Json, sse: boolean): IROperationExtensions;
|
|
36
|
+
/**
|
|
37
|
+
* The Standard Webhooks event the webhook `name` declares through `x-honey-webhook`, from its JSON
|
|
38
|
+
* body's `{ type, timestamp, data }` envelope; none when unmarked. gen reads documents it did not
|
|
39
|
+
* write: a marked webhook it could not verify into a typed event is refused, never emitted half.
|
|
40
|
+
*/
|
|
41
|
+
export declare function eventOf(name: string, op: Json, components: Components): IRWebhookEvent | undefined;
|
|
42
|
+
export {};
|