@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,13 @@
|
|
|
1
|
+
// @generated by honey. DO NOT EDIT.
|
|
2
|
+
//! Optional nullable fields: absent, null and a value are three states (`Option<Option<T>>`).
|
|
3
|
+
|
|
4
|
+
/// Reads a present field as `Some(None)` for null and `Some(Some(v))` for a value; with
|
|
5
|
+
/// `#[serde(default)]` an absent field stays `None`.
|
|
6
|
+
#[doc(hidden)]
|
|
7
|
+
pub fn deserialize<'de, D, T>(deserializer: D) -> Result<Option<Option<T>>, D::Error>
|
|
8
|
+
where
|
|
9
|
+
D: serde::Deserializer<'de>,
|
|
10
|
+
T: serde::Deserialize<'de>,
|
|
11
|
+
{
|
|
12
|
+
<Option<T> as serde::Deserialize>::deserialize(deserializer).map(Some)
|
|
13
|
+
}
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
// @generated by honey. DO NOT EDIT.
|
|
2
|
+
//! Path templates: `{name}` anywhere in a segment and a whole `:name` segment, each value encoded
|
|
3
|
+
//! like JavaScript's `encodeURIComponent`, so every SDK language sends the same path bytes.
|
|
4
|
+
|
|
5
|
+
use crate::errors::Error;
|
|
6
|
+
|
|
7
|
+
/// `s` encoded like `encodeURIComponent`: everything but `A-Z a-z 0-9 - _ . ! ~ * ' ( )`.
|
|
8
|
+
pub(crate) fn escape_segment(s: &str) -> String {
|
|
9
|
+
const HEX: &[u8; 16] = b"0123456789ABCDEF";
|
|
10
|
+
let mut out = String::with_capacity(s.len());
|
|
11
|
+
for &b in s.as_bytes() {
|
|
12
|
+
if b.is_ascii_alphanumeric() || b"-_.!~*'()".contains(&b) {
|
|
13
|
+
out.push(b as char);
|
|
14
|
+
} else {
|
|
15
|
+
out.push('%');
|
|
16
|
+
out.push(HEX[(b >> 4) as usize] as char);
|
|
17
|
+
out.push(HEX[(b & 0x0f) as usize] as char);
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
out
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
/// One value, encoded; `""`, `.` and `..` are refused: each would change the path's shape.
|
|
24
|
+
fn segment_value(name: &str, value: &str) -> Result<String, Error> {
|
|
25
|
+
if value.is_empty() || value == "." || value == ".." {
|
|
26
|
+
return Err(Error::PathParam(format!(
|
|
27
|
+
"{name:?} is empty, \".\" or \"..\", which no path segment can be"
|
|
28
|
+
)));
|
|
29
|
+
}
|
|
30
|
+
Ok(escape_segment(value))
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/// The placeholder at the start of `rest` (`{name}`), as its name and its length.
|
|
34
|
+
fn braced(rest: &str) -> Option<(&str, usize)> {
|
|
35
|
+
let close = rest.find('}')?;
|
|
36
|
+
let name = &rest[1..close];
|
|
37
|
+
(!name.is_empty() && !name.contains(['{', '/'])).then_some((name, close + 1))
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/// `template` with each placeholder filled from `params`, its value encoded.
|
|
41
|
+
pub(crate) fn expand_path(template: &str, params: &[(&str, &str)]) -> Result<String, Error> {
|
|
42
|
+
let value = |name: &str| {
|
|
43
|
+
let found = params.iter().find(|(k, _)| *k == name).map(|(_, v)| *v);
|
|
44
|
+
let v = found.ok_or_else(|| Error::PathParam(format!("{name:?} is missing")))?;
|
|
45
|
+
segment_value(name, v)
|
|
46
|
+
};
|
|
47
|
+
let mut out = String::with_capacity(template.len());
|
|
48
|
+
for (i, segment) in template.split('/').enumerate() {
|
|
49
|
+
if i > 0 {
|
|
50
|
+
out.push('/');
|
|
51
|
+
}
|
|
52
|
+
if let Some(name) = colon_name(segment) {
|
|
53
|
+
out.push_str(&value(name)?);
|
|
54
|
+
continue;
|
|
55
|
+
}
|
|
56
|
+
let mut rest = segment;
|
|
57
|
+
while let Some(open) = rest.find('{') {
|
|
58
|
+
out.push_str(&rest[..open]);
|
|
59
|
+
match braced(&rest[open..]) {
|
|
60
|
+
Some((name, len)) => {
|
|
61
|
+
out.push_str(&value(name)?);
|
|
62
|
+
rest = &rest[open + len..];
|
|
63
|
+
}
|
|
64
|
+
None => {
|
|
65
|
+
out.push('{');
|
|
66
|
+
rest = &rest[open + 1..];
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
out.push_str(rest);
|
|
71
|
+
}
|
|
72
|
+
Ok(out)
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/// The name of a whole `:name` segment (an identifier); a colon inside a segment is literal.
|
|
76
|
+
pub(crate) fn colon_name(segment: &str) -> Option<&str> {
|
|
77
|
+
let name = segment.strip_prefix(':')?;
|
|
78
|
+
let mut chars = name.chars();
|
|
79
|
+
let first = chars.next()?;
|
|
80
|
+
let ident = (first.is_ascii_alphabetic() || first == '_')
|
|
81
|
+
&& chars.all(|c| c.is_ascii_alphanumeric() || c == '_');
|
|
82
|
+
ident.then_some(name)
|
|
83
|
+
}
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
// @generated by honey. DO NOT EDIT.
|
|
2
|
+
//! Query, header and form values, the way every SDK language writes them: a string as it is, a
|
|
3
|
+
//! boolean as `true`/`false`, a number like JavaScript's `Number#toString`, a list repeated (or
|
|
4
|
+
//! joined with `,` in a header), anything else as JSON; an absent value (`None`) is not sent.
|
|
5
|
+
|
|
6
|
+
use serde_json::Value;
|
|
7
|
+
|
|
8
|
+
/// `v` as JavaScript's `Number#toString` writes it: the shortest digits that read back, fixed
|
|
9
|
+
/// notation for `1e-6 <= |v| < 1e21`, else `<mantissa>e±<exp>`.
|
|
10
|
+
pub(crate) fn format_f64(v: f64) -> String {
|
|
11
|
+
if v.is_nan() {
|
|
12
|
+
return "NaN".into();
|
|
13
|
+
}
|
|
14
|
+
if v.is_infinite() {
|
|
15
|
+
return if v > 0.0 { "Infinity" } else { "-Infinity" }.into();
|
|
16
|
+
}
|
|
17
|
+
if v == 0.0 {
|
|
18
|
+
return "0".into();
|
|
19
|
+
}
|
|
20
|
+
let sci = format!("{v:e}");
|
|
21
|
+
let (mantissa, exp) = sci.split_once('e').unwrap_or((sci.as_str(), "0"));
|
|
22
|
+
let exp: i32 = exp.parse().unwrap_or(0);
|
|
23
|
+
let (sign, mantissa) = match mantissa.strip_prefix('-') {
|
|
24
|
+
Some(m) => ("-", m),
|
|
25
|
+
None => ("", mantissa),
|
|
26
|
+
};
|
|
27
|
+
if !(1e-6..1e21).contains(&v.abs()) {
|
|
28
|
+
let exp_sign = if exp > 0 { "+" } else { "-" };
|
|
29
|
+
return format!("{sign}{mantissa}e{exp_sign}{}", exp.abs());
|
|
30
|
+
}
|
|
31
|
+
let digits: String = mantissa.chars().filter(|c| *c != '.').collect();
|
|
32
|
+
let n = digits.len() as i32;
|
|
33
|
+
let body = if exp >= n - 1 {
|
|
34
|
+
format!("{digits}{}", "0".repeat((exp - (n - 1)) as usize))
|
|
35
|
+
} else if exp >= 0 {
|
|
36
|
+
let (int, frac) = digits.split_at((exp + 1) as usize);
|
|
37
|
+
format!("{int}.{frac}")
|
|
38
|
+
} else {
|
|
39
|
+
format!("0.{}{digits}", "0".repeat((-exp - 1) as usize))
|
|
40
|
+
};
|
|
41
|
+
format!("{sign}{body}")
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/// A scalar's text; `None` for null.
|
|
45
|
+
fn scalar(value: &Value) -> Option<String> {
|
|
46
|
+
match value {
|
|
47
|
+
Value::Null => None,
|
|
48
|
+
Value::String(s) => Some(s.clone()),
|
|
49
|
+
Value::Bool(b) => Some(b.to_string()),
|
|
50
|
+
Value::Number(n) if n.is_f64() => n.as_f64().map(format_f64),
|
|
51
|
+
other => Some(other.to_string()),
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/// The texts `value` is sent as: one per list item, none for null or an empty object.
|
|
56
|
+
pub(crate) fn texts(value: &Value) -> Vec<String> {
|
|
57
|
+
match value {
|
|
58
|
+
Value::Object(members) if members.is_empty() => Vec::new(),
|
|
59
|
+
Value::Array(items) => items.iter().filter_map(scalar).collect(),
|
|
60
|
+
other => scalar(other).into_iter().collect(),
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
/// `value` serialized, or the serializer's error as text.
|
|
65
|
+
pub(crate) fn to_value<T: serde::Serialize + ?Sized>(value: &T) -> Result<Value, String> {
|
|
66
|
+
serde_json::to_value(value).map_err(|e| e.to_string())
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
/// The fields of a serialized object as `(key, text)` pairs in key order, a list repeating its key.
|
|
70
|
+
pub(crate) fn object_pairs(value: &Value) -> Vec<(String, String)> {
|
|
71
|
+
let Value::Object(map) = value else {
|
|
72
|
+
return Vec::new();
|
|
73
|
+
};
|
|
74
|
+
map.iter()
|
|
75
|
+
.flat_map(|(k, v)| texts(v).into_iter().map(move |t| (k.clone(), t)))
|
|
76
|
+
.collect()
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
/// `pairs` as an `application/x-www-form-urlencoded` body.
|
|
80
|
+
pub(crate) fn form_encode(pairs: &[(String, String)]) -> String {
|
|
81
|
+
url::form_urlencoded::Serializer::new(String::new())
|
|
82
|
+
.extend_pairs(pairs)
|
|
83
|
+
.finish()
|
|
84
|
+
}
|
|
@@ -0,0 +1,182 @@
|
|
|
1
|
+
// @generated by honey. DO NOT EDIT.
|
|
2
|
+
//! A realtime operation's answer: a connection over a chain of transports (WebSocket, then SSE,
|
|
3
|
+
//! then long-poll by default) that reconnects after a drop and resumes from the last message it
|
|
4
|
+
//! delivered. The call's `cancel_on` bounds the open and ends an open connection quietly.
|
|
5
|
+
|
|
6
|
+
use std::marker::PhantomData;
|
|
7
|
+
|
|
8
|
+
use serde::Serialize;
|
|
9
|
+
use serde::de::DeserializeOwned;
|
|
10
|
+
use serde_json::Value;
|
|
11
|
+
|
|
12
|
+
use crate::call::Signal;
|
|
13
|
+
use crate::config::Client;
|
|
14
|
+
use crate::errors::Error;
|
|
15
|
+
use crate::transport::{Transport, TransportConn, TransportKind, TransportOpts};
|
|
16
|
+
use crate::transport_longpoll::LongpollTransport;
|
|
17
|
+
use crate::transport_sse::SseTransport;
|
|
18
|
+
use crate::transport_ws::WsTransport;
|
|
19
|
+
use crate::ws::canceled;
|
|
20
|
+
|
|
21
|
+
/// Where a realtime connection is in its life.
|
|
22
|
+
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
|
23
|
+
pub enum ConnectionState {
|
|
24
|
+
/// open over a transport
|
|
25
|
+
Connected,
|
|
26
|
+
/// dropped, and opening the chain again
|
|
27
|
+
Reconnecting,
|
|
28
|
+
/// closed, or given up after its reconnect attempts
|
|
29
|
+
Disconnected,
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
/// A realtime connection: `recv` reads the next message as `E`, reconnecting through the chain
|
|
33
|
+
/// after a drop, the advanced cursor resuming it. Reconnects back off exponentially from the
|
|
34
|
+
/// reconnect delay (an SSE `retry` the server sent, else `reconnect_delay_ms`, else 1 s; capped at
|
|
35
|
+
/// 30 s, with jitter) for up to `max_reconnect_attempts` (5 when `None`). Dropping it closes the
|
|
36
|
+
/// transport.
|
|
37
|
+
pub struct ResumableConnection<E = Value> {
|
|
38
|
+
pub(crate) url: String,
|
|
39
|
+
pub(crate) transports: Vec<Box<dyn Transport>>,
|
|
40
|
+
pub(crate) opts: TransportOpts,
|
|
41
|
+
pub(crate) conn: Option<Box<dyn TransportConn>>,
|
|
42
|
+
pub(crate) current: Option<usize>,
|
|
43
|
+
pub(crate) proven: Option<usize>,
|
|
44
|
+
pub(crate) state: ConnectionState,
|
|
45
|
+
pub(crate) attempts: u32,
|
|
46
|
+
pub(crate) retry: Option<u64>,
|
|
47
|
+
pub(crate) failure: Option<Error>,
|
|
48
|
+
pub(crate) cancel: Option<Signal>,
|
|
49
|
+
pub(crate) events: PhantomData<fn() -> E>,
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
impl<E: DeserializeOwned> ResumableConnection<E> {
|
|
53
|
+
/// Opens `url` over the first of `transports` that opens, in order, with `opts`' cursor.
|
|
54
|
+
pub async fn connect(
|
|
55
|
+
url: impl Into<String>,
|
|
56
|
+
opts: TransportOpts,
|
|
57
|
+
transports: Vec<Box<dyn Transport>>,
|
|
58
|
+
) -> Result<Self, Error> {
|
|
59
|
+
let mut rc = ResumableConnection {
|
|
60
|
+
url: url.into(),
|
|
61
|
+
transports,
|
|
62
|
+
opts,
|
|
63
|
+
conn: None,
|
|
64
|
+
current: None,
|
|
65
|
+
proven: None,
|
|
66
|
+
state: ConnectionState::Disconnected,
|
|
67
|
+
attempts: 0,
|
|
68
|
+
retry: None,
|
|
69
|
+
failure: None,
|
|
70
|
+
cancel: None,
|
|
71
|
+
events: PhantomData,
|
|
72
|
+
};
|
|
73
|
+
rc.bounded_open().await?;
|
|
74
|
+
Ok(rc)
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/// Opens `url` over the default chain, each transport dialing with `client`'s configuration.
|
|
78
|
+
pub async fn connect_with_defaults(
|
|
79
|
+
client: &Client,
|
|
80
|
+
url: impl Into<String>,
|
|
81
|
+
opts: TransportOpts,
|
|
82
|
+
) -> Result<Self, Error> {
|
|
83
|
+
let chain: Vec<Box<dyn Transport>> = vec![
|
|
84
|
+
Box::new(WsTransport::new(client)),
|
|
85
|
+
Box::new(SseTransport::new(client)),
|
|
86
|
+
Box::new(LongpollTransport::new(client)),
|
|
87
|
+
];
|
|
88
|
+
Self::connect(url, opts, chain).await
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
/// The next message; after a drop it reconnects first. `None` once closed or the call's
|
|
92
|
+
/// `cancel_on` fired. Giving up returns the last failure once, then `None`. Cancel-safe: a
|
|
93
|
+
/// dropped `recv` loses no delivered message.
|
|
94
|
+
pub async fn recv(&mut self) -> Option<Result<E, Error>> {
|
|
95
|
+
let signal = self.cancel.clone();
|
|
96
|
+
let read = tokio::select! {
|
|
97
|
+
biased;
|
|
98
|
+
() = canceled(signal) => None,
|
|
99
|
+
read = self.read() => Some(read),
|
|
100
|
+
};
|
|
101
|
+
match read {
|
|
102
|
+
Some(read) => read,
|
|
103
|
+
None => {
|
|
104
|
+
/* canceled: the connection ends quietly, with nothing left to report */
|
|
105
|
+
let _ = self.close().await;
|
|
106
|
+
None
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
async fn read(&mut self) -> Option<Result<E, Error>> {
|
|
112
|
+
loop {
|
|
113
|
+
if self.state == ConnectionState::Disconnected {
|
|
114
|
+
return None;
|
|
115
|
+
}
|
|
116
|
+
let Some(conn) = self.conn.as_mut() else {
|
|
117
|
+
if let Err(e) = self.reconnect().await {
|
|
118
|
+
return Some(Err(e));
|
|
119
|
+
}
|
|
120
|
+
continue;
|
|
121
|
+
};
|
|
122
|
+
match conn.recv().await {
|
|
123
|
+
Some(Ok(message)) => return Some(self.deliver(message)),
|
|
124
|
+
failed => {
|
|
125
|
+
let e = failed.and_then(Result::err).unwrap_or(Error::Closed);
|
|
126
|
+
self.dropped(e);
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
/// Sends `message` as JSON on the open transport (an SSE or long-poll one POSTs it).
|
|
133
|
+
pub async fn send<T: Serialize + ?Sized>(&mut self, message: &T) -> Result<(), Error> {
|
|
134
|
+
let text = serde_json::to_string(message).map_err(Error::decode)?;
|
|
135
|
+
self.send_text(&text).await
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
/// Sends `text` as it is on the open transport (an SSE or long-poll one POSTs it).
|
|
139
|
+
pub async fn send_text(&mut self, text: &str) -> Result<(), Error> {
|
|
140
|
+
match self.conn.as_mut() {
|
|
141
|
+
Some(conn) => conn.send(text).await,
|
|
142
|
+
None => Err(Error::Closed),
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
impl<E> ResumableConnection<E> {
|
|
148
|
+
/// Where the connection is in its life.
|
|
149
|
+
pub fn state(&self) -> ConnectionState {
|
|
150
|
+
self.state
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
/// The transport the connection is open over now.
|
|
154
|
+
pub fn transport(&self) -> Option<TransportKind> {
|
|
155
|
+
self.current.map(|i| self.transports[i].kind())
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
/// The transport that last opened, tried first on the next open.
|
|
159
|
+
pub fn proven_transport(&self) -> Option<TransportKind> {
|
|
160
|
+
self.proven.map(|i| self.transports[i].kind())
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
/// The resume cursor's event id: the last delivered message's, else the caller's.
|
|
164
|
+
pub fn last_event_id(&self) -> Option<&str> {
|
|
165
|
+
self.opts.last_event_id.as_deref()
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
/// The resume cursor's reconnect token: the last delivered message's, else the caller's.
|
|
169
|
+
pub fn reconnect_token(&self) -> Option<&str> {
|
|
170
|
+
self.opts.reconnect_token.as_deref()
|
|
171
|
+
}
|
|
172
|
+
|
|
173
|
+
/// Closes the transport; `recv` then reads `None`. Closing again does nothing.
|
|
174
|
+
pub async fn close(&mut self) -> Result<(), Error> {
|
|
175
|
+
self.state = ConnectionState::Disconnected;
|
|
176
|
+
self.current = None;
|
|
177
|
+
match self.conn.take() {
|
|
178
|
+
Some(mut conn) => conn.close().await,
|
|
179
|
+
None => Ok(()),
|
|
180
|
+
}
|
|
181
|
+
}
|
|
182
|
+
}
|
|
@@ -0,0 +1,177 @@
|
|
|
1
|
+
// @generated by honey. DO NOT EDIT.
|
|
2
|
+
//! A realtime connection's life: opening the chain (the proven transport first), advancing the cursor
|
|
3
|
+
//! past each delivered message, and reconnecting after a drop with backoff; and the operation's run,
|
|
4
|
+
//! which opens the connection before the call resolves.
|
|
5
|
+
|
|
6
|
+
use std::collections::hash_map::RandomState;
|
|
7
|
+
use std::hash::BuildHasher;
|
|
8
|
+
use std::sync::{Arc, PoisonError};
|
|
9
|
+
use std::time::Duration;
|
|
10
|
+
|
|
11
|
+
use serde::de::DeserializeOwned;
|
|
12
|
+
use serde_json::Value;
|
|
13
|
+
|
|
14
|
+
use crate::call::{Overrides, Run};
|
|
15
|
+
use crate::config::Inner;
|
|
16
|
+
use crate::errors::Error;
|
|
17
|
+
use crate::exchange::url_of;
|
|
18
|
+
use crate::realtime::{ConnectionState, ResumableConnection};
|
|
19
|
+
use crate::request::RequestSpec;
|
|
20
|
+
use crate::transport::{
|
|
21
|
+
Dial, Route, Transport, TransportMessage, TransportOpts, advance, payload_cursor,
|
|
22
|
+
};
|
|
23
|
+
use crate::transport_longpoll::LongpollTransport;
|
|
24
|
+
use crate::transport_sse::SseTransport;
|
|
25
|
+
use crate::transport_ws::WsTransport;
|
|
26
|
+
|
|
27
|
+
const DEFAULT_ATTEMPTS: u32 = 5;
|
|
28
|
+
const DEFAULT_DELAY_MS: u64 = 1000;
|
|
29
|
+
const MAX_DELAY_MS: u64 = 30_000;
|
|
30
|
+
/// The most one reconnect's open of the chain may take.
|
|
31
|
+
const OPEN_TIMEOUT: Duration = Duration::from_secs(30);
|
|
32
|
+
|
|
33
|
+
/// A failure's weight: a transient one 7 (retried), else its refusal's rank.
|
|
34
|
+
fn weight(e: &Error) -> u8 {
|
|
35
|
+
match e.status() {
|
|
36
|
+
Some(401) => 6,
|
|
37
|
+
Some(403) => 5,
|
|
38
|
+
Some(422) => 4,
|
|
39
|
+
Some(400) => 3,
|
|
40
|
+
Some(410) => 2,
|
|
41
|
+
Some(404 | 405) => 1,
|
|
42
|
+
_ => 7,
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
impl<E: DeserializeOwned> ResumableConnection<E> {
|
|
47
|
+
/// Opens the chain, the proven transport first, once more after a refreshed 401; else the heaviest failure.
|
|
48
|
+
pub(crate) async fn open(&mut self) -> Result<(), Error> {
|
|
49
|
+
let proven = self.proven;
|
|
50
|
+
let rest = (0..self.transports.len()).filter(|&i| Some(i) != proven);
|
|
51
|
+
let order: Vec<usize> = proven.into_iter().chain(rest).collect();
|
|
52
|
+
let mut refreshed = false;
|
|
53
|
+
'chain: loop {
|
|
54
|
+
let mut best: Option<Error> = None;
|
|
55
|
+
for &i in &order {
|
|
56
|
+
let e = match self.transports[i].connect(&self.url, &self.opts).await {
|
|
57
|
+
Ok(conn) => {
|
|
58
|
+
(self.conn, self.current, self.proven) = (Some(conn), Some(i), Some(i));
|
|
59
|
+
self.state = ConnectionState::Connected;
|
|
60
|
+
return Ok(());
|
|
61
|
+
}
|
|
62
|
+
Err(e) => e,
|
|
63
|
+
};
|
|
64
|
+
if e.status() == Some(401) && !refreshed {
|
|
65
|
+
refreshed = true;
|
|
66
|
+
if self.transports[i].refresh().await? {
|
|
67
|
+
continue 'chain;
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
if best.as_ref().is_none_or(|b| weight(&e) > weight(b)) {
|
|
71
|
+
best = Some(e);
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
return Err(best.unwrap_or_else(|| Error::Config("no transport to open".into())));
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
/// `open`, bounded by 30 s.
|
|
79
|
+
pub(crate) async fn bounded_open(&mut self) -> Result<(), Error> {
|
|
80
|
+
tokio::time::timeout(OPEN_TIMEOUT, self.open())
|
|
81
|
+
.await
|
|
82
|
+
.unwrap_or(Err(Error::Timeout))
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
/// A delivered message as `E`, the cursor advanced past it (its SSE id, else the payload's), an
|
|
86
|
+
/// SSE `retry` kept as the next reconnect's delay.
|
|
87
|
+
pub(crate) fn deliver(&mut self, message: TransportMessage) -> Result<E, Error> {
|
|
88
|
+
self.attempts = 0;
|
|
89
|
+
let value = serde_json::from_str(&message.text).unwrap_or(Value::String(message.text));
|
|
90
|
+
let (id, token) = payload_cursor(&value);
|
|
91
|
+
advance(&mut self.opts, message.id.or(id), token);
|
|
92
|
+
self.retry = message.retry.or(self.retry);
|
|
93
|
+
serde_json::from_value(value).map_err(Error::decode)
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
/// The open transport failed or ended with `e`: drop it, and reconnect the whole chain next.
|
|
97
|
+
pub(crate) fn dropped(&mut self, e: Error) {
|
|
98
|
+
(self.conn, self.current, self.proven) = (None, None, None);
|
|
99
|
+
self.state = ConnectionState::Reconnecting;
|
|
100
|
+
self.failure = Some(e);
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
/// Reopens the chain after a backoff, until it opens or the attempts run out (then the last
|
|
104
|
+
/// failure, the connection given up). Cancel-safe: an attempt counts once its dial starts.
|
|
105
|
+
pub(crate) async fn reconnect(&mut self) -> Result<(), Error> {
|
|
106
|
+
let limit = self.opts.max_reconnect_attempts.unwrap_or(DEFAULT_ATTEMPTS);
|
|
107
|
+
loop {
|
|
108
|
+
if self.attempts >= limit || self.failure.as_ref().is_some_and(|e| weight(e) < 7) {
|
|
109
|
+
self.state = ConnectionState::Disconnected;
|
|
110
|
+
return Err(self.failure.take().unwrap_or(Error::Closed));
|
|
111
|
+
}
|
|
112
|
+
tokio::time::sleep(self.backoff(self.attempts + 1)).await;
|
|
113
|
+
self.attempts += 1;
|
|
114
|
+
match self.bounded_open().await {
|
|
115
|
+
Ok(()) => return Ok(()),
|
|
116
|
+
Err(e) => self.failure = Some(e),
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
/// The delay before reconnect attempt `n` (1-based): doubling from the base, capped, then a
|
|
122
|
+
/// random point in its upper half, so clients do not reconnect in lockstep.
|
|
123
|
+
fn backoff(&self, n: u32) -> Duration {
|
|
124
|
+
let base = self
|
|
125
|
+
.retry
|
|
126
|
+
.or(self.opts.reconnect_delay_ms)
|
|
127
|
+
.unwrap_or(DEFAULT_DELAY_MS);
|
|
128
|
+
let d = base.saturating_mul(1 << (n - 1).min(16)).min(MAX_DELAY_MS);
|
|
129
|
+
let half = d / 2;
|
|
130
|
+
let jitter = RandomState::new().hash_one(n) % (half + 1);
|
|
131
|
+
Duration::from_millis(half + jitter)
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
/// A realtime operation: opens the connection over the default chain before the call resolves,
|
|
136
|
+
/// each dial sending the call's path, query and headers with its overrides (and its own
|
|
137
|
+
/// `X-Request-Id` unless one is set); its answer is the one the opening transport dialed.
|
|
138
|
+
pub(crate) fn connect<E: DeserializeOwned + Send + 'static>(
|
|
139
|
+
opts: TransportOpts,
|
|
140
|
+
) -> Run<ResumableConnection<E>> {
|
|
141
|
+
Box::new(
|
|
142
|
+
move |inner: Arc<Inner>, mut spec: RequestSpec, mut ov: Overrides| {
|
|
143
|
+
Box::pin(async move {
|
|
144
|
+
if let Some(e) = spec.take_failure() {
|
|
145
|
+
return Err(e.into());
|
|
146
|
+
}
|
|
147
|
+
let url = url_of(&inner, &spec, &ov)?;
|
|
148
|
+
/* the connection holds the signal: no dial ends on it behind the connection's back */
|
|
149
|
+
let cancel = ov.cancel.take();
|
|
150
|
+
let route = Route {
|
|
151
|
+
template: spec.template,
|
|
152
|
+
path: spec.path,
|
|
153
|
+
query: spec.query,
|
|
154
|
+
headers: spec.headers,
|
|
155
|
+
};
|
|
156
|
+
let dial = Dial {
|
|
157
|
+
inner,
|
|
158
|
+
ov,
|
|
159
|
+
route: Some(route),
|
|
160
|
+
opened: Arc::default(),
|
|
161
|
+
sent: Arc::default(),
|
|
162
|
+
};
|
|
163
|
+
let opened = Arc::clone(&dial.opened);
|
|
164
|
+
let chain: Vec<Box<dyn Transport>> = vec![
|
|
165
|
+
Box::new(WsTransport(dial.clone())),
|
|
166
|
+
Box::new(SseTransport(dial.clone())),
|
|
167
|
+
Box::new(LongpollTransport(dial)),
|
|
168
|
+
];
|
|
169
|
+
let mut rc = ResumableConnection::connect(url.as_str(), opts, chain).await?;
|
|
170
|
+
rc.cancel = cancel;
|
|
171
|
+
/* each default transport keeps the answer it opened with */
|
|
172
|
+
let raw = opened.lock().unwrap_or_else(PoisonError::into_inner).take();
|
|
173
|
+
Ok((rc, raw.ok_or(Error::Closed)?))
|
|
174
|
+
})
|
|
175
|
+
},
|
|
176
|
+
)
|
|
177
|
+
}
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
// @generated by honey. DO NOT EDIT.
|
|
2
|
+
//! Which redirects a call follows (R3), and the following itself. The SDK's HTTP client never follows
|
|
3
|
+
//! one on its own (`redirect::Policy::none()`), whatever `http_builder` sets, so this is the only rule:
|
|
4
|
+
//! hop by hop, a hop to another origin stripped to the safe headers and never given a body.
|
|
5
|
+
|
|
6
|
+
use reqwest::header::{CONTENT_TYPE, HeaderMap, LOCATION};
|
|
7
|
+
use reqwest::{Method, Url};
|
|
8
|
+
|
|
9
|
+
use crate::body::Content;
|
|
10
|
+
use crate::errors::Error;
|
|
11
|
+
|
|
12
|
+
/// The most redirects one call follows; the next one is the answer.
|
|
13
|
+
const MAX_REDIRECTS: usize = 10;
|
|
14
|
+
|
|
15
|
+
/// The only headers a request carries to another origin (H18.10): an allowlist, so a header added
|
|
16
|
+
/// later never leaks by default.
|
|
17
|
+
const CROSS_ORIGIN_SAFE: [&str; 3] = ["accept", "accept-language", "user-agent"];
|
|
18
|
+
|
|
19
|
+
/// Which redirects a call follows. Under any policy a hop to another origin carries only `Accept`,
|
|
20
|
+
/// `Accept-Language` and `User-Agent`, and no body.
|
|
21
|
+
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
|
|
22
|
+
pub enum RedirectPolicy {
|
|
23
|
+
/// Follow a redirect that stays on the request's origin; return any other as the answer.
|
|
24
|
+
#[default]
|
|
25
|
+
SameOrigin,
|
|
26
|
+
/// Follow every redirect, up to 10.
|
|
27
|
+
Follow,
|
|
28
|
+
/// Follow none: a 3xx is the answer.
|
|
29
|
+
Manual,
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
/// One request of a call's chain.
|
|
33
|
+
pub(crate) struct Hop {
|
|
34
|
+
pub(crate) method: Method,
|
|
35
|
+
pub(crate) url: Url,
|
|
36
|
+
pub(crate) headers: HeaderMap,
|
|
37
|
+
pub(crate) body: Option<Content>,
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/// Where `response` redirects `url` to: a 3xx with a `Location` that resolves to an http(s) URL.
|
|
41
|
+
fn target_of(response: &reqwest::Response, url: &Url) -> Option<Url> {
|
|
42
|
+
if !matches!(response.status().as_u16(), 301 | 302 | 303 | 307 | 308) {
|
|
43
|
+
return None;
|
|
44
|
+
}
|
|
45
|
+
let location = response.headers().get(LOCATION)?.to_str().ok()?;
|
|
46
|
+
let target = url.join(location).ok()?;
|
|
47
|
+
matches!(target.scheme(), "http" | "https").then_some(target)
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
/// The hop after `hop` to `target` for a `status` redirect, or `None` when it must be the answer;
|
|
51
|
+
/// `spent` when `hop` sent a stream, which cannot be sent again.
|
|
52
|
+
fn next(mut hop: Hop, status: u16, target: Url, cross: bool, spent: bool) -> Option<Hop> {
|
|
53
|
+
let to_get = if status == 303 {
|
|
54
|
+
hop.method != Method::HEAD
|
|
55
|
+
} else {
|
|
56
|
+
status != 307 && status != 308 && hop.method == Method::POST
|
|
57
|
+
};
|
|
58
|
+
if to_get {
|
|
59
|
+
hop.method = Method::GET;
|
|
60
|
+
hop.body = None;
|
|
61
|
+
hop.headers.remove(CONTENT_TYPE);
|
|
62
|
+
}
|
|
63
|
+
/* a body never goes to another origin, and a stream cannot be sent again */
|
|
64
|
+
if !to_get && (spent || (cross && hop.body.is_some())) {
|
|
65
|
+
return None;
|
|
66
|
+
}
|
|
67
|
+
if cross {
|
|
68
|
+
let mut kept = HeaderMap::new();
|
|
69
|
+
for name in CROSS_ORIGIN_SAFE {
|
|
70
|
+
if let Some(value) = hop.headers.get(name) {
|
|
71
|
+
kept.insert(name, value.clone());
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
hop.headers = kept;
|
|
75
|
+
}
|
|
76
|
+
hop.url = target;
|
|
77
|
+
Some(hop)
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
/// Sends `hop` on `http`, following redirects as `policy` says: the final answer and its URL.
|
|
81
|
+
pub(crate) async fn send_following(
|
|
82
|
+
http: &reqwest::Client,
|
|
83
|
+
policy: RedirectPolicy,
|
|
84
|
+
mut hop: Hop,
|
|
85
|
+
) -> Result<(reqwest::Response, Url), Error> {
|
|
86
|
+
let origin = hop.url.origin();
|
|
87
|
+
let mut followed = 0;
|
|
88
|
+
loop {
|
|
89
|
+
let request = http
|
|
90
|
+
.request(hop.method.clone(), hop.url.clone())
|
|
91
|
+
.headers(hop.headers.clone());
|
|
92
|
+
let (request, spent) = match hop.body.take() {
|
|
93
|
+
Some(Content::Bytes(b)) => {
|
|
94
|
+
hop.body = Some(Content::Bytes(b.clone()));
|
|
95
|
+
(request.body(b), false)
|
|
96
|
+
}
|
|
97
|
+
Some(Content::Stream(s)) => (request.body(s), true),
|
|
98
|
+
None => (request, false),
|
|
99
|
+
};
|
|
100
|
+
let response = request.send().await.map_err(Error::from_reqwest)?;
|
|
101
|
+
let target = match policy {
|
|
102
|
+
RedirectPolicy::Manual => None,
|
|
103
|
+
_ if followed == MAX_REDIRECTS => None,
|
|
104
|
+
_ => target_of(&response, &hop.url),
|
|
105
|
+
};
|
|
106
|
+
let Some(target) = target else {
|
|
107
|
+
return Ok((response, hop.url));
|
|
108
|
+
};
|
|
109
|
+
let cross = target.origin() != origin;
|
|
110
|
+
if cross && policy != RedirectPolicy::Follow {
|
|
111
|
+
return Ok((response, hop.url));
|
|
112
|
+
}
|
|
113
|
+
let status = response.status().as_u16();
|
|
114
|
+
let url = hop.url.clone();
|
|
115
|
+
match next(hop, status, target, cross, spent) {
|
|
116
|
+
Some(after) => hop = after,
|
|
117
|
+
None => return Ok((response, url)),
|
|
118
|
+
}
|
|
119
|
+
followed += 1;
|
|
120
|
+
}
|
|
121
|
+
}
|