@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,208 @@
|
|
|
1
|
+
// Code generated by honey. DO NOT EDIT.
|
|
2
|
+
|
|
3
|
+
package sdk
|
|
4
|
+
|
|
5
|
+
import (
|
|
6
|
+
"context"
|
|
7
|
+
"errors"
|
|
8
|
+
"math/rand/v2"
|
|
9
|
+
"net/http"
|
|
10
|
+
"time"
|
|
11
|
+
)
|
|
12
|
+
|
|
13
|
+
// openChain tries the proven transport first, then the rest in order, each with the current
|
|
14
|
+
// resume cursor. The first that opens becomes the connection and the proven transport. Once ctx
|
|
15
|
+
// ends it tries no further transport: one that opens lazily (long-poll) would otherwise succeed.
|
|
16
|
+
// The chain fails with its last transient failure, else its most specific refusal; a 401 restarts it once.
|
|
17
|
+
func (r *ResumableConnection) openChain(ctx context.Context) error {
|
|
18
|
+
r.mu.Lock()
|
|
19
|
+
proven := r.provenIdx
|
|
20
|
+
opts := r.opts
|
|
21
|
+
r.mu.Unlock()
|
|
22
|
+
order := make([]int, 0, len(r.transports))
|
|
23
|
+
if proven >= 0 && proven < len(r.transports) {
|
|
24
|
+
order = append(order, proven)
|
|
25
|
+
}
|
|
26
|
+
for i := range r.transports {
|
|
27
|
+
if i != proven {
|
|
28
|
+
order = append(order, i)
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
var transient, refusal error
|
|
32
|
+
refreshed := false
|
|
33
|
+
for n := 0; n < len(order); n++ {
|
|
34
|
+
i := order[n]
|
|
35
|
+
if err := ctx.Err(); err != nil {
|
|
36
|
+
return wrapTransportError(ctx, err)
|
|
37
|
+
}
|
|
38
|
+
c, err := r.transports[i].Connect(ctx, r.url, &opts)
|
|
39
|
+
if status(err) == http.StatusUnauthorized && !refreshed && opts.refresh != nil && opts.refresh(ctx) {
|
|
40
|
+
refreshed, n, transient, refusal = true, -1, nil, nil /* the chain anew, with the refreshed token */
|
|
41
|
+
continue
|
|
42
|
+
}
|
|
43
|
+
if err != nil {
|
|
44
|
+
if !refused(err) {
|
|
45
|
+
transient = err
|
|
46
|
+
} else if refusal == nil || refusalRank[status(err)] > refusalRank[status(refusal)] {
|
|
47
|
+
refusal = err
|
|
48
|
+
}
|
|
49
|
+
continue
|
|
50
|
+
}
|
|
51
|
+
r.mu.Lock()
|
|
52
|
+
if r.closed {
|
|
53
|
+
r.mu.Unlock()
|
|
54
|
+
_ = c.Close()
|
|
55
|
+
return ErrConnectionClosed
|
|
56
|
+
}
|
|
57
|
+
r.conn, r.provenIdx, r.state = c, i, StateConnected
|
|
58
|
+
r.mu.Unlock()
|
|
59
|
+
return nil
|
|
60
|
+
}
|
|
61
|
+
if transient != nil {
|
|
62
|
+
return transient
|
|
63
|
+
}
|
|
64
|
+
return refusal
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
// advance moves the resume cursor past a delivered value: the connection's own event ID when it
|
|
68
|
+
// tracks one (SSE), else the payload's id or last_event_id, and the payload's reconnect_token.
|
|
69
|
+
func (r *ResumableConnection) advance(conn TransportConn, v any) {
|
|
70
|
+
id, token := payloadCursor(v)
|
|
71
|
+
if cc, ok := conn.(cursorConn); ok {
|
|
72
|
+
if sid := cc.lastEventID(); sid != "" {
|
|
73
|
+
id = sid
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
r.mu.Lock()
|
|
77
|
+
advanceCursor(&r.opts, id, token)
|
|
78
|
+
r.mu.Unlock()
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
func (r *ResumableConnection) maxAttempts() int {
|
|
82
|
+
switch {
|
|
83
|
+
case r.opts.MaxReconnectAttempts < 0:
|
|
84
|
+
return -1
|
|
85
|
+
case r.opts.MaxReconnectAttempts == 0:
|
|
86
|
+
return defaultReconnectAttempts
|
|
87
|
+
}
|
|
88
|
+
return r.opts.MaxReconnectAttempts
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
// backoff is the delay before reconnect attempt n (1-based): exponential from the base delay,
|
|
92
|
+
// capped, with jitter so clients do not reconnect in lockstep.
|
|
93
|
+
func (r *ResumableConnection) backoff(n int) time.Duration {
|
|
94
|
+
d := defaultReconnectDelay
|
|
95
|
+
if r.opts.ReconnectDelayMs > 0 {
|
|
96
|
+
d = time.Duration(r.opts.ReconnectDelayMs) * time.Millisecond
|
|
97
|
+
}
|
|
98
|
+
for i := 1; i < n && d < maxReconnectDelay; i++ {
|
|
99
|
+
d *= 2
|
|
100
|
+
}
|
|
101
|
+
d = min(d, maxReconnectDelay)
|
|
102
|
+
half := d / 2
|
|
103
|
+
return half + time.Duration(rand.Int64N(int64(half)+1))
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
func (r *ResumableConnection) fail(err error) {
|
|
107
|
+
select {
|
|
108
|
+
case r.errs <- err:
|
|
109
|
+
default:
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
// readLoop pumps Recv into Events. A transport error reconnects through the whole chain (the
|
|
114
|
+
// proven transport is forgotten) with backoff; exhaustion is sent on Errors and ends the loop.
|
|
115
|
+
// Close cuts every wait short.
|
|
116
|
+
func (r *ResumableConnection) readLoop(done chan struct{}) {
|
|
117
|
+
defer func() {
|
|
118
|
+
r.mu.Lock()
|
|
119
|
+
conn := r.conn
|
|
120
|
+
r.conn, r.running, r.state = nil, false, StateDisconnected
|
|
121
|
+
r.mu.Unlock()
|
|
122
|
+
if conn != nil {
|
|
123
|
+
_ = conn.Close()
|
|
124
|
+
}
|
|
125
|
+
close(done)
|
|
126
|
+
}()
|
|
127
|
+
attempts := 0 /* consecutive failed reconnects; a delivered event resets it */
|
|
128
|
+
for {
|
|
129
|
+
r.mu.Lock()
|
|
130
|
+
conn := r.conn
|
|
131
|
+
r.mu.Unlock()
|
|
132
|
+
if conn == nil {
|
|
133
|
+
return
|
|
134
|
+
}
|
|
135
|
+
v, err := conn.Recv(r.ctx)
|
|
136
|
+
if err == nil {
|
|
137
|
+
select {
|
|
138
|
+
case r.events <- v:
|
|
139
|
+
r.advance(conn, v)
|
|
140
|
+
attempts = 0
|
|
141
|
+
case <-r.ctx.Done():
|
|
142
|
+
return
|
|
143
|
+
}
|
|
144
|
+
continue
|
|
145
|
+
}
|
|
146
|
+
if r.ctx.Err() != nil || !r.reconnect(conn, err, &attempts) {
|
|
147
|
+
return
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
// reconnect drops the failed connection and reopens the chain with backoff, counting into
|
|
153
|
+
// attempts; it reports false when attempts ran out or the connection closed (Close ends the
|
|
154
|
+
// transport before its ctx, so a read can fail first).
|
|
155
|
+
func (r *ResumableConnection) reconnect(failed TransportConn, err error, attempts *int) bool {
|
|
156
|
+
if refused(err) {
|
|
157
|
+
_ = failed.Close()
|
|
158
|
+
r.fail(err)
|
|
159
|
+
return false
|
|
160
|
+
}
|
|
161
|
+
r.mu.Lock()
|
|
162
|
+
if r.closed {
|
|
163
|
+
r.mu.Unlock()
|
|
164
|
+
return false
|
|
165
|
+
}
|
|
166
|
+
r.state, r.conn, r.provenIdx = StateReconnecting, nil, -1
|
|
167
|
+
r.mu.Unlock()
|
|
168
|
+
_ = failed.Close()
|
|
169
|
+
limit := r.maxAttempts()
|
|
170
|
+
for {
|
|
171
|
+
*attempts++
|
|
172
|
+
if limit >= 0 && *attempts > limit {
|
|
173
|
+
r.fail(err)
|
|
174
|
+
return false
|
|
175
|
+
}
|
|
176
|
+
select {
|
|
177
|
+
case <-time.After(r.backoff(*attempts)):
|
|
178
|
+
case <-r.ctx.Done():
|
|
179
|
+
return false
|
|
180
|
+
}
|
|
181
|
+
openCtx, cancel := context.WithTimeout(r.ctx, openTimeout)
|
|
182
|
+
err = r.openChain(openCtx)
|
|
183
|
+
cancel()
|
|
184
|
+
if err == nil {
|
|
185
|
+
return true
|
|
186
|
+
}
|
|
187
|
+
if errors.Is(err, ErrConnectionClosed) {
|
|
188
|
+
return false
|
|
189
|
+
}
|
|
190
|
+
if refused(err) {
|
|
191
|
+
r.fail(err)
|
|
192
|
+
return false
|
|
193
|
+
}
|
|
194
|
+
}
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
func status(err error) int {
|
|
198
|
+
var ce *ClientError
|
|
199
|
+
if errors.As(err, &ce) {
|
|
200
|
+
return ce.StatusCode
|
|
201
|
+
}
|
|
202
|
+
return 0
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
// refusalRank ranks the statuses no retry changes, most specific highest; any other failure is transient.
|
|
206
|
+
var refusalRank = map[int]int{401: 6, 403: 5, 422: 4, 400: 3, 410: 2, 404: 1, 405: 1}
|
|
207
|
+
|
|
208
|
+
func refused(err error) bool { return refusalRank[status(err)] > 0 }
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
// Code generated by honey. DO NOT EDIT.
|
|
2
|
+
|
|
3
|
+
package sdk
|
|
4
|
+
|
|
5
|
+
import (
|
|
6
|
+
"errors"
|
|
7
|
+
"net/http"
|
|
8
|
+
"net/url"
|
|
9
|
+
"slices"
|
|
10
|
+
"strconv"
|
|
11
|
+
"strings"
|
|
12
|
+
)
|
|
13
|
+
|
|
14
|
+
// RedirectPolicy picks which redirects a client follows.
|
|
15
|
+
type RedirectPolicy string
|
|
16
|
+
|
|
17
|
+
const (
|
|
18
|
+
// RedirectSameOrigin follows redirects that stay on the request's origin. A cross-origin
|
|
19
|
+
// redirect is returned unfollowed, as an error for its 3xx status. The zero value means this.
|
|
20
|
+
RedirectSameOrigin RedirectPolicy = "same-origin"
|
|
21
|
+
// RedirectFollow also follows cross-origin redirects. Such a hop carries only the safe headers
|
|
22
|
+
// and never replays a body.
|
|
23
|
+
RedirectFollow RedirectPolicy = "follow"
|
|
24
|
+
)
|
|
25
|
+
|
|
26
|
+
const maxRedirects = 10
|
|
27
|
+
|
|
28
|
+
// crossOriginSafeHeaders are the only headers a request carries to another origin (H18.10). An
|
|
29
|
+
// allowlist, so a header added later never leaks by default.
|
|
30
|
+
var crossOriginSafeHeaders = []string{"Accept", "Accept-Language", "User-Agent"}
|
|
31
|
+
|
|
32
|
+
// http1 is DefaultTransport's settings offering HTTP/1.1 alone (its clone's ALPN list starts with h2).
|
|
33
|
+
var http1 = func() *http.Transport {
|
|
34
|
+
t := http.DefaultTransport.(*http.Transport).Clone()
|
|
35
|
+
t.Protocols = new(http.Protocols)
|
|
36
|
+
t.Protocols.SetHTTP1(true)
|
|
37
|
+
t.TLSClientConfig.NextProtos = []string{"http/1.1"}
|
|
38
|
+
return t
|
|
39
|
+
}()
|
|
40
|
+
|
|
41
|
+
// redirectClient is a copy of base (a fresh client when nil; http1 when it names no Transport) whose
|
|
42
|
+
// CheckRedirect applies policy and strips a cross-origin hop first, then defers to base's own
|
|
43
|
+
// CheckRedirect, so no client escapes it.
|
|
44
|
+
func redirectClient(base *http.Client, policy RedirectPolicy) *http.Client {
|
|
45
|
+
c := &http.Client{}
|
|
46
|
+
if base != nil {
|
|
47
|
+
*c = *base
|
|
48
|
+
}
|
|
49
|
+
if c.Transport == nil {
|
|
50
|
+
c.Transport = http1
|
|
51
|
+
}
|
|
52
|
+
next := c.CheckRedirect
|
|
53
|
+
c.CheckRedirect = func(req *http.Request, via []*http.Request) error {
|
|
54
|
+
if err := checkRedirect(req, via, policy); err != nil {
|
|
55
|
+
return err
|
|
56
|
+
}
|
|
57
|
+
if next != nil {
|
|
58
|
+
return next(req, via)
|
|
59
|
+
}
|
|
60
|
+
if len(via) >= maxRedirects {
|
|
61
|
+
return errors.New("honey: stopped after " + strconv.Itoa(maxRedirects) + " redirects")
|
|
62
|
+
}
|
|
63
|
+
return nil
|
|
64
|
+
}
|
|
65
|
+
return c
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
// transportClient holds a realtime transport's client to the redirect rule: a nil client becomes
|
|
69
|
+
// a same-origin one, and any other is wrapped so a cross-origin hop is stripped.
|
|
70
|
+
func transportClient(c *http.Client) *http.Client {
|
|
71
|
+
if c == nil {
|
|
72
|
+
return redirectClient(nil, RedirectSameOrigin)
|
|
73
|
+
}
|
|
74
|
+
return redirectClient(c, RedirectFollow)
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
// checkRedirect refuses a redirect the policy does not follow and strips a hop that has left the
|
|
78
|
+
// first request's origin down to the safe headers. Go copies the first request's headers onto
|
|
79
|
+
// every hop, so every hop after leaving the origin is stripped again.
|
|
80
|
+
func checkRedirect(req *http.Request, via []*http.Request, policy RedirectPolicy) error {
|
|
81
|
+
if !leftOrigin(req, via) {
|
|
82
|
+
return nil
|
|
83
|
+
}
|
|
84
|
+
if policy != RedirectFollow || (req.Body != nil && req.Body != http.NoBody) {
|
|
85
|
+
return http.ErrUseLastResponse
|
|
86
|
+
}
|
|
87
|
+
for name := range req.Header {
|
|
88
|
+
if !slices.Contains(crossOriginSafeHeaders, http.CanonicalHeaderKey(name)) {
|
|
89
|
+
delete(req.Header, name)
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
return nil
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
// leftOrigin reports whether req or any hop before it is on another origin than the first request.
|
|
96
|
+
func leftOrigin(req *http.Request, via []*http.Request) bool {
|
|
97
|
+
first := via[0].URL
|
|
98
|
+
if !sameOrigin(first, req.URL) {
|
|
99
|
+
return true
|
|
100
|
+
}
|
|
101
|
+
for _, hop := range via[1:] {
|
|
102
|
+
if !sameOrigin(first, hop.URL) {
|
|
103
|
+
return true
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
return false
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
// sameOrigin compares scheme, host and port, a default port spelled out or not.
|
|
110
|
+
func sameOrigin(a, b *url.URL) bool {
|
|
111
|
+
return strings.EqualFold(a.Scheme, b.Scheme) && strings.EqualFold(a.Hostname(), b.Hostname()) &&
|
|
112
|
+
portOf(a) == portOf(b)
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
func portOf(u *url.URL) string {
|
|
116
|
+
if p := u.Port(); p != "" {
|
|
117
|
+
return p
|
|
118
|
+
}
|
|
119
|
+
switch strings.ToLower(u.Scheme) {
|
|
120
|
+
case "https", "wss":
|
|
121
|
+
return "443"
|
|
122
|
+
}
|
|
123
|
+
return "80"
|
|
124
|
+
}
|
|
@@ -0,0 +1,222 @@
|
|
|
1
|
+
// Code generated by honey. DO NOT EDIT.
|
|
2
|
+
|
|
3
|
+
package sdk
|
|
4
|
+
|
|
5
|
+
import (
|
|
6
|
+
"bytes"
|
|
7
|
+
"context"
|
|
8
|
+
"errors"
|
|
9
|
+
"fmt"
|
|
10
|
+
"io"
|
|
11
|
+
"net/http"
|
|
12
|
+
"time"
|
|
13
|
+
)
|
|
14
|
+
|
|
15
|
+
// call is one operation invocation as a generated method assembles it.
|
|
16
|
+
type call struct {
|
|
17
|
+
method string
|
|
18
|
+
path string // expanded and escaped
|
|
19
|
+
operation string // `METHOD /path/template`, the name OnLog sees
|
|
20
|
+
query queryList
|
|
21
|
+
headers map[string]string // declared header params, Accept, Idempotency-Key
|
|
22
|
+
body requestBody
|
|
23
|
+
protocols []string // WebSocket subprotocols
|
|
24
|
+
|
|
25
|
+
stale *StaleTracker
|
|
26
|
+
invalidates []string // declared invalidation targets, `METHOD /template`
|
|
27
|
+
params map[string]string // path params, to expand templated targets
|
|
28
|
+
meta *RequestMeta
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
// requestResult is a buffered answer: its body after the OnResponse hooks, the response, and
|
|
32
|
+
// whether the body ran past the cap.
|
|
33
|
+
type requestResult struct {
|
|
34
|
+
body []byte
|
|
35
|
+
status int
|
|
36
|
+
resp *http.Response
|
|
37
|
+
over bool
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
// exchange is one call in flight: the client settings, this call's overrides and the call; a
|
|
41
|
+
// stream's 2xx body is left unread for the caller.
|
|
42
|
+
type exchange struct {
|
|
43
|
+
cfg Config
|
|
44
|
+
rc requestConfig
|
|
45
|
+
c *call
|
|
46
|
+
stream bool
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
// ErrResponseTooLarge is a *DecodeError's cause when a 2xx body exceeds Config.MaxResponseBytes.
|
|
50
|
+
var ErrResponseTooLarge = errors.New("honey: response body exceeds MaxResponseBytes")
|
|
51
|
+
|
|
52
|
+
// doRequest sends c and buffers its answer (run), honoring the call's timeout and the stale
|
|
53
|
+
// tracker. A ctx already done sends nothing: OnLog sees only its error. A 2xx past the cap is a
|
|
54
|
+
// *DecodeError.
|
|
55
|
+
func doRequest(ctx context.Context, cfg Config, c *call, opts []RequestOption) (*requestResult, error) {
|
|
56
|
+
x := &exchange{cfg: cfg, rc: newRequestConfig(cfg, opts), c: c}
|
|
57
|
+
if ctx.Err() != nil {
|
|
58
|
+
err := wrapTransportError(ctx, ctx.Err())
|
|
59
|
+
emitLog(cfg, errorEntry(c.operation, time.Now(), err))
|
|
60
|
+
return nil, err
|
|
61
|
+
}
|
|
62
|
+
if x.rc.timeout > 0 {
|
|
63
|
+
var cancel context.CancelFunc
|
|
64
|
+
ctx, cancel = context.WithTimeout(ctx, x.rc.timeout)
|
|
65
|
+
defer cancel()
|
|
66
|
+
}
|
|
67
|
+
c.meta = c.stale.begin(c)
|
|
68
|
+
result, err := x.run(ctx)
|
|
69
|
+
if err != nil {
|
|
70
|
+
return nil, err
|
|
71
|
+
}
|
|
72
|
+
c.stale.settle(c)
|
|
73
|
+
if result.over {
|
|
74
|
+
return nil, &DecodeError{result.resp, ErrResponseTooLarge}
|
|
75
|
+
}
|
|
76
|
+
return result, nil
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
// run is every call's exchange: it injects auth and merges headers, runs the hooks in declaration
|
|
80
|
+
// order, retries once with OnAuthExpired's token on a 401, and turns a non-2xx status into a typed
|
|
81
|
+
// error. OnLog sees request_start, then response_received for the final response, and error on
|
|
82
|
+
// any failure; an auth retry does not log twice.
|
|
83
|
+
func (x *exchange) run(ctx context.Context) (result *requestResult, err error) {
|
|
84
|
+
start := time.Now()
|
|
85
|
+
defer func() {
|
|
86
|
+
if err != nil {
|
|
87
|
+
emitLog(x.cfg, errorEntry(x.c.operation, start, err))
|
|
88
|
+
}
|
|
89
|
+
}()
|
|
90
|
+
emitLog(x.cfg, LogEntry{Level: "debug", Event: "request_start", Operation: x.c.operation})
|
|
91
|
+
if result, err = x.sendWithAuth(ctx); err != nil {
|
|
92
|
+
return nil, err
|
|
93
|
+
}
|
|
94
|
+
status := result.status
|
|
95
|
+
level := "info"
|
|
96
|
+
if status >= 400 {
|
|
97
|
+
level = "warn"
|
|
98
|
+
}
|
|
99
|
+
emitLog(x.cfg, LogEntry{Level: level, Event: "response_received", Operation: x.c.operation, DurationMs: time.Since(start).Milliseconds(), Status: &status})
|
|
100
|
+
x.rc.deliver(result.resp, result.body)
|
|
101
|
+
if err = raiseForStatus(result.resp, result.body); err != nil {
|
|
102
|
+
return nil, err
|
|
103
|
+
}
|
|
104
|
+
return result, nil
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
// sendWithAuth sends once, and once more with a refreshed token when a replayable request got 401.
|
|
108
|
+
func (x *exchange) sendWithAuth(ctx context.Context) (*requestResult, error) {
|
|
109
|
+
token := x.cfg.auth.current(x.cfg)
|
|
110
|
+
result, err := x.send(ctx, token, false)
|
|
111
|
+
if err != nil || result.status != http.StatusUnauthorized || x.cfg.OnAuthExpired == nil || !x.c.body.replayable() {
|
|
112
|
+
return result, err
|
|
113
|
+
}
|
|
114
|
+
fresh, err := x.cfg.auth.refresh(ctx, x.cfg, token)
|
|
115
|
+
if err != nil {
|
|
116
|
+
return nil, fmt.Errorf("honey: OnAuthExpired failed: %w", err)
|
|
117
|
+
}
|
|
118
|
+
if fresh == "" {
|
|
119
|
+
return result, nil
|
|
120
|
+
}
|
|
121
|
+
return x.send(ctx, fresh, true)
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
// send sends once and runs the OnResponse hooks on the answer, its body read first so they may
|
|
125
|
+
// replace it. A stream's 2xx body stays unread (the hooks see a nil Body, and one they set is
|
|
126
|
+
// ignored); of an error body a stream reads at most 64 KiB, a failed read leaving it nil. A body
|
|
127
|
+
// past the cap is nil.
|
|
128
|
+
func (x *exchange) send(ctx context.Context, token string, retry bool) (*requestResult, error) {
|
|
129
|
+
req, err := x.newRequest(ctx, token, retry)
|
|
130
|
+
if err != nil {
|
|
131
|
+
return nil, err
|
|
132
|
+
}
|
|
133
|
+
client, limit := x.cfg.HTTPClient, x.cfg.MaxResponseBytes
|
|
134
|
+
if x.stream {
|
|
135
|
+
client, limit = streamClient(x.cfg), 64<<10
|
|
136
|
+
}
|
|
137
|
+
resp, err := client.Do(req)
|
|
138
|
+
if err != nil {
|
|
139
|
+
return nil, wrapTransportError(ctx, err)
|
|
140
|
+
}
|
|
141
|
+
unread := x.stream && resp.StatusCode >= 200 && resp.StatusCode < 300
|
|
142
|
+
var body []byte
|
|
143
|
+
if !unread {
|
|
144
|
+
body, err = readBody(resp.Body, limit)
|
|
145
|
+
resp.Body.Close()
|
|
146
|
+
if err != nil && !x.stream && err != ErrResponseTooLarge {
|
|
147
|
+
return nil, wrapTransportError(ctx, err)
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
over := err == ErrResponseTooLarge
|
|
151
|
+
rc := &ResponseContext{Status: resp.StatusCode, Headers: resp.Header, Body: body, IsRetry: retry}
|
|
152
|
+
rc.Selector, rc.IsStale, rc.InvalidatedBy = x.c.meta.stale()
|
|
153
|
+
if err := runHooks("OnResponse", x.cfg.OnResponse, rc); err != nil {
|
|
154
|
+
resp.Body.Close()
|
|
155
|
+
return nil, err
|
|
156
|
+
}
|
|
157
|
+
if unread {
|
|
158
|
+
return &requestResult{status: resp.StatusCode, resp: resp}, nil
|
|
159
|
+
}
|
|
160
|
+
return &requestResult{rc.Body, resp.StatusCode, withBody(resp, rc.Body), over}, nil
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
// newRequest builds the outgoing request after the OnRequest hooks ran.
|
|
164
|
+
func (x *exchange) newRequest(ctx context.Context, token string, retry bool) (*http.Request, error) {
|
|
165
|
+
c := x.c
|
|
166
|
+
fullURL, err := buildURL(x.rc.baseURL, c.path, c.query)
|
|
167
|
+
if err != nil {
|
|
168
|
+
return nil, fmt.Errorf("honey: build URL: %w", err)
|
|
169
|
+
}
|
|
170
|
+
/* a Reader body streams as is; RequestContext.Body stays nil so no hook reads a one-shot reader */
|
|
171
|
+
payload, err := c.body.bytes()
|
|
172
|
+
if err != nil {
|
|
173
|
+
return nil, err
|
|
174
|
+
}
|
|
175
|
+
headers := withRequestID(mergeHeaders(x.cfg, token, c.body.mediaType(), c.headers, x.rc.headers))
|
|
176
|
+
rc := &RequestContext{Method: c.method, URL: fullURL, Path: c.path, Headers: headers, Body: payload, IsRetry: retry}
|
|
177
|
+
rc.Selector, rc.IsStale, rc.InvalidatedBy = c.meta.stale()
|
|
178
|
+
if err := runHooks("OnRequest", x.cfg.OnRequest, rc); err != nil {
|
|
179
|
+
return nil, err
|
|
180
|
+
}
|
|
181
|
+
var reader io.Reader
|
|
182
|
+
if c.body.reader != nil {
|
|
183
|
+
reader = c.body.reader
|
|
184
|
+
} else if rc.Body != nil {
|
|
185
|
+
reader = bytes.NewReader(rc.Body)
|
|
186
|
+
}
|
|
187
|
+
req, err := http.NewRequestWithContext(ctx, rc.Method, rc.URL, reader)
|
|
188
|
+
if err != nil {
|
|
189
|
+
return nil, fmt.Errorf("honey: build request: %w", err)
|
|
190
|
+
}
|
|
191
|
+
req.Header = rc.Headers
|
|
192
|
+
return req, nil
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
// wrapTransportError names a failed exchange: a timeout or cancel wraps ctx's cause (so errors.Is
|
|
196
|
+
// matches context.DeadlineExceeded or context.Canceled), anything else the redacted cause.
|
|
197
|
+
func wrapTransportError(ctx context.Context, err error) error {
|
|
198
|
+
switch ctxErr := context.Cause(ctx); {
|
|
199
|
+
case errors.Is(ctxErr, context.DeadlineExceeded):
|
|
200
|
+
return fmt.Errorf("honey: request timed out: %w", ctxErr)
|
|
201
|
+
case errors.Is(ctxErr, context.Canceled):
|
|
202
|
+
return fmt.Errorf("honey: request canceled: %w", ctxErr)
|
|
203
|
+
case ctxErr != nil:
|
|
204
|
+
return fmt.Errorf("honey: context error: %w", ctxErr)
|
|
205
|
+
}
|
|
206
|
+
return fmt.Errorf("honey: http do: %w", redactURL(err))
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
// readBody reads r up to limit bytes; a negative limit reads all.
|
|
210
|
+
func readBody(r io.Reader, limit int64) ([]byte, error) {
|
|
211
|
+
if limit < 0 {
|
|
212
|
+
return io.ReadAll(r)
|
|
213
|
+
}
|
|
214
|
+
body, err := io.ReadAll(io.LimitReader(r, limit+1))
|
|
215
|
+
if err != nil {
|
|
216
|
+
return nil, err
|
|
217
|
+
}
|
|
218
|
+
if int64(len(body)) > limit {
|
|
219
|
+
return nil, ErrResponseTooLarge
|
|
220
|
+
}
|
|
221
|
+
return body, nil
|
|
222
|
+
}
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
// Code generated by honey. DO NOT EDIT.
|
|
2
|
+
|
|
3
|
+
package sdk
|
|
4
|
+
|
|
5
|
+
import (
|
|
6
|
+
"encoding/json"
|
|
7
|
+
"errors"
|
|
8
|
+
"iter"
|
|
9
|
+
"net/http"
|
|
10
|
+
)
|
|
11
|
+
|
|
12
|
+
// Result is a Client.Safe() method's answer. Ok: Data is the normal method's. Else Err is the
|
|
13
|
+
// error it returns for the answer, an error status (*ClientError or its per-status type) or a
|
|
14
|
+
// *DecodeError, and Data is the zero value. Response is the answer's. No answer (never sent, a
|
|
15
|
+
// refused or dropped connection, a timeout, a cancel) is the method's error.
|
|
16
|
+
type Result[T any] struct {
|
|
17
|
+
Data T
|
|
18
|
+
Err error
|
|
19
|
+
Response *http.Response
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
// Ok reports whether the call answered its data.
|
|
23
|
+
func (r Result[T]) Ok() bool { return r.Err == nil }
|
|
24
|
+
|
|
25
|
+
// DecodeError is a 2xx whose body did not decode, or ran past Config.MaxResponseBytes (Err is
|
|
26
|
+
// then ErrResponseTooLarge, the Body empty).
|
|
27
|
+
type DecodeError struct {
|
|
28
|
+
Response *http.Response
|
|
29
|
+
Err error
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
func (e *DecodeError) Error() string { return "honey: decode response: " + e.Err.Error() }
|
|
33
|
+
|
|
34
|
+
// Unwrap returns the parse error, or ErrResponseTooLarge.
|
|
35
|
+
func (e *DecodeError) Unwrap() error { return e.Err }
|
|
36
|
+
|
|
37
|
+
// decodeJSON decodes a JSON success body into a *T; an empty body gives the zero value.
|
|
38
|
+
func decodeJSON[T any](result *requestResult) (*T, error) {
|
|
39
|
+
var out T
|
|
40
|
+
if len(result.body) > 0 {
|
|
41
|
+
if err := json.Unmarshal(result.body, &out); err != nil {
|
|
42
|
+
return nil, &DecodeError{result.resp, err}
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
return &out, nil
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
// safeCall is a Client.Safe() call: its response and, for a stream, whether it opened and how.
|
|
49
|
+
type safeCall struct {
|
|
50
|
+
resp *http.Response
|
|
51
|
+
sent bool
|
|
52
|
+
err error
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
// with is reqOpts reporting to s.
|
|
56
|
+
func (s *safeCall) with(reqOpts []RequestOption) []RequestOption {
|
|
57
|
+
return append([]RequestOption{func(rc *requestConfig) { rc.safe = s }}, reqOpts...)
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
// safeOf is the Result of a normal method's return: an answer's error in Err, any other the error.
|
|
61
|
+
func safeOf[T any](data T, err error, s *safeCall) (Result[T], error) {
|
|
62
|
+
var ce *ClientError
|
|
63
|
+
var de *DecodeError
|
|
64
|
+
switch {
|
|
65
|
+
case err == nil:
|
|
66
|
+
return Result[T]{Data: data, Response: s.resp}, nil
|
|
67
|
+
case errors.As(err, &ce):
|
|
68
|
+
return Result[T]{Err: err, Response: ce.Response}, nil
|
|
69
|
+
case errors.As(err, &de):
|
|
70
|
+
return Result[T]{Err: err, Response: de.Response}, nil
|
|
71
|
+
}
|
|
72
|
+
return Result[T]{}, err
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
// safeOpen is the Result of a stream opened on the call (Data ranges once); one never sent
|
|
76
|
+
// yields its error, the error.
|
|
77
|
+
func safeOpen[T any](seq iter.Seq2[T, error], s *safeCall) (Result[iter.Seq2[T, error]], error) {
|
|
78
|
+
err := s.err
|
|
79
|
+
if !s.sent {
|
|
80
|
+
for _, failed := range seq {
|
|
81
|
+
err = failed
|
|
82
|
+
break
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
return safeOf(seq, err, s)
|
|
86
|
+
}
|