@workerstack/clients 0.0.0-stage → 1.0.0-rc.24
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 +135 -5
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
// Code generated by honey. DO NOT EDIT.
|
|
2
|
+
|
|
3
|
+
package sdk
|
|
4
|
+
|
|
5
|
+
import (
|
|
6
|
+
"context"
|
|
7
|
+
"net/http"
|
|
8
|
+
"time"
|
|
9
|
+
)
|
|
10
|
+
|
|
11
|
+
// Config holds the client-wide settings. Per-call RequestOptions override BaseURL, Timeout and
|
|
12
|
+
// headers for one call without changing it.
|
|
13
|
+
//
|
|
14
|
+
// Timeout bounds a whole regular request, body included, and an SSE stream up to its headers;
|
|
15
|
+
// WebSocket and realtime are not bounded by it. Zero means 30s; a negative value disables it.
|
|
16
|
+
//
|
|
17
|
+
// Redirect picks which redirects are followed (RedirectSameOrigin by default). Under any policy, a
|
|
18
|
+
// hop to another origin carries only Accept, Accept-Language and User-Agent. A caller-supplied
|
|
19
|
+
// HTTPClient is cloned and held to the same rule; headers its own Transport adds are the caller's,
|
|
20
|
+
// and reach every hop.
|
|
21
|
+
//
|
|
22
|
+
// MaxResponseBytes caps a buffered response body. Zero means 100 MiB; a negative value disables
|
|
23
|
+
// the cap.
|
|
24
|
+
//
|
|
25
|
+
// WSKeepalive is a WebSocket's ping interval and pong wait: zero means 20s, negative none.
|
|
26
|
+
//
|
|
27
|
+
// AuthHeaderName and AuthHeaderPrefix are a pair: leave both empty for the API's scheme; set the
|
|
28
|
+
// name and the prefix is yours (empty means none); set only the prefix to keep the scheme's header.
|
|
29
|
+
type Config struct {
|
|
30
|
+
BaseURL string
|
|
31
|
+
BearerToken string
|
|
32
|
+
Headers map[string]string
|
|
33
|
+
Timeout time.Duration
|
|
34
|
+
Invalidation *InvalidationConfig
|
|
35
|
+
OnAuthExpired func(context.Context) (string, error)
|
|
36
|
+
HTTPClient *http.Client
|
|
37
|
+
Redirect RedirectPolicy
|
|
38
|
+
AuthHeaderName string
|
|
39
|
+
AuthHeaderPrefix string
|
|
40
|
+
OnRequest []func(*RequestContext) error
|
|
41
|
+
OnResponse []func(*ResponseContext) error
|
|
42
|
+
OnLog func(LogEntry)
|
|
43
|
+
MaxResponseBytes int64
|
|
44
|
+
WSKeepalive time.Duration
|
|
45
|
+
|
|
46
|
+
auth *authState
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
const (
|
|
50
|
+
defaultTimeout = 30 * time.Second
|
|
51
|
+
defaultMaxResponseBytes = 100 << 20
|
|
52
|
+
maxErrorMessageRunes = 512
|
|
53
|
+
)
|
|
54
|
+
|
|
55
|
+
// prepareConfig fills the defaults and wraps the HTTP client in the redirect policy. NewClient
|
|
56
|
+
// calls it once.
|
|
57
|
+
func prepareConfig(cfg Config) Config {
|
|
58
|
+
cfg.HTTPClient = redirectClient(cfg.HTTPClient, cfg.Redirect)
|
|
59
|
+
if cfg.Timeout == 0 {
|
|
60
|
+
cfg.Timeout = defaultTimeout
|
|
61
|
+
}
|
|
62
|
+
if cfg.MaxResponseBytes == 0 {
|
|
63
|
+
cfg.MaxResponseBytes = defaultMaxResponseBytes
|
|
64
|
+
}
|
|
65
|
+
cfg.auth = &authState{token: cfg.BearerToken}
|
|
66
|
+
return cfg
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
// streamClient is the configured client without its overall timeout: an http.Client Timeout also
|
|
70
|
+
// bounds body reads, which would cut every stream.
|
|
71
|
+
func streamClient(cfg Config) *http.Client {
|
|
72
|
+
c := *cfg.HTTPClient
|
|
73
|
+
c.Timeout = 0
|
|
74
|
+
return &c
|
|
75
|
+
}
|
|
@@ -0,0 +1,185 @@
|
|
|
1
|
+
// Code generated by honey. DO NOT EDIT.
|
|
2
|
+
|
|
3
|
+
package sdk
|
|
4
|
+
|
|
5
|
+
import (
|
|
6
|
+
"encoding/json"
|
|
7
|
+
"net/http"
|
|
8
|
+
"strconv"
|
|
9
|
+
"strings"
|
|
10
|
+
"unicode"
|
|
11
|
+
"unicode/utf8"
|
|
12
|
+
)
|
|
13
|
+
|
|
14
|
+
// APIError is implemented by every error for a non-2xx answer: *ClientError and the per-status
|
|
15
|
+
// types that embed it.
|
|
16
|
+
type APIError interface {
|
|
17
|
+
error
|
|
18
|
+
Status() int
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
// ErrorKey is a honey error key. A declared key is a constant that is itself an error, so
|
|
22
|
+
// errors.Is(err, ErrItemNotFound) matches any *ClientError carrying that key.
|
|
23
|
+
type ErrorKey string
|
|
24
|
+
|
|
25
|
+
func (k ErrorKey) Error() string { return string(k) }
|
|
26
|
+
|
|
27
|
+
// FieldError is one problem with one input field.
|
|
28
|
+
type FieldError struct {
|
|
29
|
+
ErrorKey string `json:"error_key"`
|
|
30
|
+
Message string `json:"message"`
|
|
31
|
+
Path string `json:"path"`
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
// ErrorEnvelope is honey's error body. Members it does not name, or that have another type than
|
|
35
|
+
// the envelope's, are kept raw in Extra.
|
|
36
|
+
type ErrorEnvelope struct {
|
|
37
|
+
Status int `json:"status,omitempty"`
|
|
38
|
+
ErrorKey string `json:"error_key,omitempty"`
|
|
39
|
+
StatusKey string `json:"status_key,omitempty"`
|
|
40
|
+
Message string `json:"message,omitempty"`
|
|
41
|
+
Fields map[string][]FieldError `json:"fields,omitempty"`
|
|
42
|
+
Extra map[string]json.RawMessage `json:"-"`
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
// ClientError is a non-2xx answer: its status, honey error key, a sanitized message, the parsed
|
|
46
|
+
// envelope, the raw body and the response (its Body re-readable). Reach it with errors.As:
|
|
47
|
+
//
|
|
48
|
+
// var ce *ClientError
|
|
49
|
+
// if errors.As(err, &ce) { ... }
|
|
50
|
+
//
|
|
51
|
+
// The known statuses come as a per-status type embedding it (var nf *NotFoundError; errors.As(err, &nf)).
|
|
52
|
+
type ClientError struct {
|
|
53
|
+
StatusCode int
|
|
54
|
+
Key ErrorKey
|
|
55
|
+
Message string
|
|
56
|
+
Envelope ErrorEnvelope
|
|
57
|
+
Body []byte
|
|
58
|
+
Response *http.Response
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
func (e *ClientError) Error() string {
|
|
62
|
+
head := "HTTP " + strconv.Itoa(e.StatusCode)
|
|
63
|
+
if e.Message == "" {
|
|
64
|
+
return head
|
|
65
|
+
}
|
|
66
|
+
return head + ": " + e.Message
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
// Status returns the HTTP status code.
|
|
70
|
+
func (e *ClientError) Status() int { return e.StatusCode }
|
|
71
|
+
|
|
72
|
+
// Is matches an ErrorKey equal to the error's key.
|
|
73
|
+
func (e *ClientError) Is(target error) bool {
|
|
74
|
+
k, ok := target.(ErrorKey)
|
|
75
|
+
return ok && k != "" && k == e.Key
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
// DecodeBody decodes the raw error body into v, for a declared per-key schema.
|
|
79
|
+
func (e *ClientError) DecodeBody(v any) error { return json.Unmarshal(e.Body, v) }
|
|
80
|
+
|
|
81
|
+
// The per-status errors, one for each status the TypeScript SDK names. Each embeds *ClientError
|
|
82
|
+
// and unwraps to it, so errors.As reaches either the status type or the base.
|
|
83
|
+
type (
|
|
84
|
+
BadRequestError struct{ *ClientError }
|
|
85
|
+
UnauthorizedError struct{ *ClientError }
|
|
86
|
+
ForbiddenError struct{ *ClientError }
|
|
87
|
+
NotFoundError struct{ *ClientError }
|
|
88
|
+
ConflictError struct{ *ClientError }
|
|
89
|
+
UnprocessableEntityError struct{ *ClientError }
|
|
90
|
+
RateLimitError struct{ *ClientError }
|
|
91
|
+
InternalServerError struct{ *ClientError }
|
|
92
|
+
BadGatewayError struct{ *ClientError }
|
|
93
|
+
ServiceUnavailableError struct{ *ClientError }
|
|
94
|
+
GatewayTimeoutError struct{ *ClientError }
|
|
95
|
+
)
|
|
96
|
+
|
|
97
|
+
func (e *BadRequestError) Unwrap() error { return e.ClientError }
|
|
98
|
+
func (e *UnauthorizedError) Unwrap() error { return e.ClientError }
|
|
99
|
+
func (e *ForbiddenError) Unwrap() error { return e.ClientError }
|
|
100
|
+
func (e *NotFoundError) Unwrap() error { return e.ClientError }
|
|
101
|
+
func (e *ConflictError) Unwrap() error { return e.ClientError }
|
|
102
|
+
func (e *UnprocessableEntityError) Unwrap() error { return e.ClientError }
|
|
103
|
+
func (e *RateLimitError) Unwrap() error { return e.ClientError }
|
|
104
|
+
func (e *InternalServerError) Unwrap() error { return e.ClientError }
|
|
105
|
+
func (e *BadGatewayError) Unwrap() error { return e.ClientError }
|
|
106
|
+
func (e *ServiceUnavailableError) Unwrap() error { return e.ClientError }
|
|
107
|
+
func (e *GatewayTimeoutError) Unwrap() error { return e.ClientError }
|
|
108
|
+
|
|
109
|
+
// raiseForStatus returns nil for a 2xx response, else the most specific error for its status: a
|
|
110
|
+
// per-status type for a known one, *ClientError for any other.
|
|
111
|
+
func raiseForStatus(resp *http.Response, body []byte) error {
|
|
112
|
+
if resp.StatusCode >= 200 && resp.StatusCode < 300 {
|
|
113
|
+
return nil
|
|
114
|
+
}
|
|
115
|
+
env, message := parseEnvelope(body)
|
|
116
|
+
e := &ClientError{StatusCode: resp.StatusCode, Key: ErrorKey(env.ErrorKey), Message: sanitizeMessage(message), Envelope: env, Body: body, Response: withBody(resp, body)}
|
|
117
|
+
switch e.StatusCode {
|
|
118
|
+
case 400:
|
|
119
|
+
return &BadRequestError{e}
|
|
120
|
+
case 401:
|
|
121
|
+
return &UnauthorizedError{e}
|
|
122
|
+
case 403:
|
|
123
|
+
return &ForbiddenError{e}
|
|
124
|
+
case 404:
|
|
125
|
+
return &NotFoundError{e}
|
|
126
|
+
case 409:
|
|
127
|
+
return &ConflictError{e}
|
|
128
|
+
case 422:
|
|
129
|
+
return &UnprocessableEntityError{e}
|
|
130
|
+
case 429:
|
|
131
|
+
return &RateLimitError{e}
|
|
132
|
+
case 500:
|
|
133
|
+
return &InternalServerError{e}
|
|
134
|
+
case 502:
|
|
135
|
+
return &BadGatewayError{e}
|
|
136
|
+
case 503:
|
|
137
|
+
return &ServiceUnavailableError{e}
|
|
138
|
+
case 504:
|
|
139
|
+
return &GatewayTimeoutError{e}
|
|
140
|
+
}
|
|
141
|
+
return e
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
// parseEnvelope reads honey's envelope from a JSON object body, and the message to show: the
|
|
145
|
+
// envelope's string message when it has one, else the body text.
|
|
146
|
+
func parseEnvelope(body []byte) (ErrorEnvelope, string) {
|
|
147
|
+
var env ErrorEnvelope
|
|
148
|
+
var members map[string]json.RawMessage
|
|
149
|
+
if json.Unmarshal(body, &members) != nil || members == nil {
|
|
150
|
+
return env, string(body)
|
|
151
|
+
}
|
|
152
|
+
known := map[string]any{"status": &env.Status, "error_key": &env.ErrorKey, "status_key": &env.StatusKey, "message": &env.Message, "fields": &env.Fields}
|
|
153
|
+
for name, raw := range members {
|
|
154
|
+
if dst, ok := known[name]; ok && json.Unmarshal(raw, dst) == nil {
|
|
155
|
+
continue
|
|
156
|
+
}
|
|
157
|
+
if env.Extra == nil {
|
|
158
|
+
env.Extra = map[string]json.RawMessage{}
|
|
159
|
+
}
|
|
160
|
+
env.Extra[name] = raw
|
|
161
|
+
}
|
|
162
|
+
if _, ok := members["message"]; ok && env.Extra["message"] == nil {
|
|
163
|
+
return env, env.Message
|
|
164
|
+
}
|
|
165
|
+
return env, string(body)
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
// sanitizeMessage drops control characters and invalid UTF-8 and caps the text at 512 runes, so a
|
|
169
|
+
// hostile server cannot fill logs or drive a terminal.
|
|
170
|
+
func sanitizeMessage(text string) string {
|
|
171
|
+
var b strings.Builder
|
|
172
|
+
n := 0
|
|
173
|
+
for _, r := range text {
|
|
174
|
+
if n >= maxErrorMessageRunes {
|
|
175
|
+
b.WriteString("…")
|
|
176
|
+
break
|
|
177
|
+
}
|
|
178
|
+
if r == utf8.RuneError || unicode.IsControl(r) {
|
|
179
|
+
continue
|
|
180
|
+
}
|
|
181
|
+
b.WriteRune(r)
|
|
182
|
+
n++
|
|
183
|
+
}
|
|
184
|
+
return b.String()
|
|
185
|
+
}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
// Code generated by honey. DO NOT EDIT.
|
|
2
|
+
|
|
3
|
+
package sdk
|
|
4
|
+
|
|
5
|
+
import (
|
|
6
|
+
"context"
|
|
7
|
+
"iter"
|
|
8
|
+
"net/http"
|
|
9
|
+
)
|
|
10
|
+
|
|
11
|
+
// The Honey* functions expose the SDK's URL, SSE and error handling to the generated CLI, so both
|
|
12
|
+
// send byte-identical requests and read answers the same way.
|
|
13
|
+
|
|
14
|
+
// HoneyExpandPath fills a path template with escaped values and refuses "", "." and "..".
|
|
15
|
+
func HoneyExpandPath(template string, params map[string]string) (string, error) {
|
|
16
|
+
return expandPath(template, params)
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
// HoneyBuildURL joins base and an escaped path (keeping the base path) and appends the query pairs
|
|
20
|
+
// in order.
|
|
21
|
+
func HoneyBuildURL(baseURL, path string, query [][2]string) (string, error) {
|
|
22
|
+
q := make(queryList, 0, len(query))
|
|
23
|
+
for _, p := range query {
|
|
24
|
+
q = append(q, queryPair{key: p[0], value: p[1]})
|
|
25
|
+
}
|
|
26
|
+
return buildURL(baseURL, path, q)
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
// HoneyParseSSEStream yields the events of an SSE response and closes its body.
|
|
30
|
+
func HoneyParseSSEStream(ctx context.Context, resp *http.Response) iter.Seq2[SSEEvent[string], error] {
|
|
31
|
+
return parseSSEStream(ctx, resp)
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
// HoneyRaiseForStatus returns the typed error for a non-2xx response, or nil.
|
|
35
|
+
func HoneyRaiseForStatus(resp *http.Response, body []byte) error {
|
|
36
|
+
return raiseForStatus(resp, body)
|
|
37
|
+
}
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
// Code generated by honey. DO NOT EDIT.
|
|
2
|
+
|
|
3
|
+
package sdk
|
|
4
|
+
|
|
5
|
+
import (
|
|
6
|
+
"fmt"
|
|
7
|
+
"net/http"
|
|
8
|
+
)
|
|
9
|
+
|
|
10
|
+
// RequestContext is what each OnRequest hook sees, in declaration order. A hook may change
|
|
11
|
+
// Method, URL, Headers or Body; the request is built from the result. Body is nil for a streamed
|
|
12
|
+
// io.Reader body. Selector, IsStale and InvalidatedBy are set only when invalidation is on.
|
|
13
|
+
type RequestContext struct {
|
|
14
|
+
Method string
|
|
15
|
+
URL string
|
|
16
|
+
Path string
|
|
17
|
+
Headers http.Header
|
|
18
|
+
Body []byte
|
|
19
|
+
IsRetry bool
|
|
20
|
+
Selector string
|
|
21
|
+
IsStale bool
|
|
22
|
+
InvalidatedBy []string
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
// ResponseContext is what each OnResponse hook sees. A hook may replace Body before the SDK
|
|
26
|
+
// decodes it; Status is for reading only.
|
|
27
|
+
type ResponseContext struct {
|
|
28
|
+
Status int
|
|
29
|
+
Headers http.Header
|
|
30
|
+
Body []byte
|
|
31
|
+
IsRetry bool
|
|
32
|
+
Selector string
|
|
33
|
+
IsStale bool
|
|
34
|
+
InvalidatedBy []string
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
// runHooks runs hooks on rc in declaration order; the first error ends them, wrapped as phase's.
|
|
38
|
+
func runHooks[C any](phase string, hooks []func(C) error, rc C) error {
|
|
39
|
+
for _, hook := range hooks {
|
|
40
|
+
if err := hook(rc); err != nil {
|
|
41
|
+
return fmt.Errorf("honey: %s hook: %w", phase, err)
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
return nil
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
// stale is m's fields as a hook context holds them; zero for a nil m.
|
|
48
|
+
func (m *RequestMeta) stale() (string, bool, []string) {
|
|
49
|
+
if m == nil {
|
|
50
|
+
return "", false, nil
|
|
51
|
+
}
|
|
52
|
+
return m.Selector, m.IsStale, m.InvalidatedBy
|
|
53
|
+
}
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
// Code generated by honey. DO NOT EDIT.
|
|
2
|
+
|
|
3
|
+
package sdk
|
|
4
|
+
|
|
5
|
+
import (
|
|
6
|
+
"fmt"
|
|
7
|
+
"regexp"
|
|
8
|
+
"strings"
|
|
9
|
+
"sync"
|
|
10
|
+
)
|
|
11
|
+
|
|
12
|
+
// InvalidationConfig turns on stale tracking. StaleTime is in milliseconds; <= 0 disables the
|
|
13
|
+
// tracker. StaleMaxEntries caps the tracked selectors (default 1000), and MaxSourcesPerTarget the
|
|
14
|
+
// mutations recorded per selector (default 16).
|
|
15
|
+
type InvalidationConfig struct {
|
|
16
|
+
StaleTime int64
|
|
17
|
+
StaleMaxEntries int
|
|
18
|
+
MaxSourcesPerTarget int
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
// RequestMeta is a request's staleness snapshot, as the hook contexts see it.
|
|
22
|
+
type RequestMeta struct {
|
|
23
|
+
Selector string
|
|
24
|
+
IsStale bool
|
|
25
|
+
InvalidatedBy []string
|
|
26
|
+
SeqSnapshot uint64
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
/* placeholderRe matches `{name}` (any name without braces or slashes) and a `:name` segment. A
|
|
30
|
+
* colon inside a segment (`/ops/1:cancel`) is literal. */
|
|
31
|
+
var placeholderRe = regexp.MustCompile(`\{([^{}/]+)\}|(^|/):([a-zA-Z_][a-zA-Z0-9_]*)`)
|
|
32
|
+
|
|
33
|
+
/* patternRegexCache holds the compiled matcher per pattern; patterns come from the spec, so it is bounded. */
|
|
34
|
+
var patternRegexCache sync.Map /* map[string]*regexp.Regexp */
|
|
35
|
+
|
|
36
|
+
func compilePattern(pattern string) *regexp.Regexp {
|
|
37
|
+
if cached, ok := patternRegexCache.Load(pattern); ok {
|
|
38
|
+
return cached.(*regexp.Regexp)
|
|
39
|
+
}
|
|
40
|
+
var b strings.Builder
|
|
41
|
+
b.WriteByte('^')
|
|
42
|
+
last := 0
|
|
43
|
+
for _, m := range placeholderRe.FindAllStringIndex(pattern, -1) {
|
|
44
|
+
start := m[0]
|
|
45
|
+
if pattern[start] == '/' {
|
|
46
|
+
start++ /* keep the segment slash literal */
|
|
47
|
+
}
|
|
48
|
+
b.WriteString(regexp.QuoteMeta(pattern[last:start]))
|
|
49
|
+
b.WriteString(`[^/]+`)
|
|
50
|
+
last = m[1]
|
|
51
|
+
}
|
|
52
|
+
b.WriteString(regexp.QuoteMeta(pattern[last:]))
|
|
53
|
+
b.WriteByte('$')
|
|
54
|
+
actual, _ := patternRegexCache.LoadOrStore(pattern, regexp.MustCompile(b.String()))
|
|
55
|
+
return actual.(*regexp.Regexp)
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
func pathHasPlaceholders(path string) bool {
|
|
59
|
+
return placeholderRe.MatchString(path)
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
// pathMatchesPattern reports whether concretePath matches pattern, whose `{name}` and `:name`
|
|
63
|
+
// placeholders each match one segment.
|
|
64
|
+
func pathMatchesPattern(concretePath, pattern string) bool {
|
|
65
|
+
return concretePath == pattern || compilePattern(pattern).MatchString(concretePath)
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
// interpolatePath fills the `{name}` and `:name` placeholders of template from params, or fails
|
|
69
|
+
// naming the first one params lacks.
|
|
70
|
+
func interpolatePath(template string, params map[string]string) (string, error) {
|
|
71
|
+
var missing string
|
|
72
|
+
out := placeholderRe.ReplaceAllStringFunc(template, func(match string) string {
|
|
73
|
+
groups := placeholderRe.FindStringSubmatch(match)
|
|
74
|
+
key, prefix := groups[1], ""
|
|
75
|
+
if key == "" {
|
|
76
|
+
prefix, key = groups[2], groups[3]
|
|
77
|
+
}
|
|
78
|
+
val, ok := params[key]
|
|
79
|
+
if !ok {
|
|
80
|
+
if missing == "" {
|
|
81
|
+
missing = key
|
|
82
|
+
}
|
|
83
|
+
return match
|
|
84
|
+
}
|
|
85
|
+
return prefix + escapePathSegment(val)
|
|
86
|
+
})
|
|
87
|
+
if missing != "" {
|
|
88
|
+
return "", fmt.Errorf("honey: missing path param %q", missing)
|
|
89
|
+
}
|
|
90
|
+
return out, nil
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
// resolveTargets expands templated `METHOD /path/{x}` invalidation targets into concrete selectors
|
|
94
|
+
// with params. A target whose placeholders cannot all be filled stays a pattern, so it marks every
|
|
95
|
+
// instance stale (TypeScript parity).
|
|
96
|
+
func resolveTargets(targets []string, params map[string]string) []string {
|
|
97
|
+
out := make([]string, 0, len(targets))
|
|
98
|
+
for _, entry := range targets {
|
|
99
|
+
method, template, ok := strings.Cut(entry, " ")
|
|
100
|
+
if !ok || !pathHasPlaceholders(template) {
|
|
101
|
+
out = append(out, entry)
|
|
102
|
+
continue
|
|
103
|
+
}
|
|
104
|
+
concrete, err := interpolatePath(template, params)
|
|
105
|
+
if err != nil {
|
|
106
|
+
out = append(out, entry)
|
|
107
|
+
continue
|
|
108
|
+
}
|
|
109
|
+
out = append(out, method+" "+concrete)
|
|
110
|
+
}
|
|
111
|
+
return out
|
|
112
|
+
}
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
// Code generated by honey. DO NOT EDIT.
|
|
2
|
+
|
|
3
|
+
package sdk
|
|
4
|
+
|
|
5
|
+
import (
|
|
6
|
+
"errors"
|
|
7
|
+
"net/url"
|
|
8
|
+
"strconv"
|
|
9
|
+
"strings"
|
|
10
|
+
"time"
|
|
11
|
+
)
|
|
12
|
+
|
|
13
|
+
// LogEntry is what Config.OnLog receives. The SDK never formats, levels or persists it. No entry's
|
|
14
|
+
// text carries a path value, header value or query: Operation is "METHOD /template", and Err (the
|
|
15
|
+
// "error" event's failure) names it in place of the URL. Status is nil when no response arrived.
|
|
16
|
+
type LogEntry struct {
|
|
17
|
+
Level string `json:"level"`
|
|
18
|
+
Event string `json:"event"`
|
|
19
|
+
Operation string `json:"operation"`
|
|
20
|
+
DurationMs int64 `json:"duration_ms"`
|
|
21
|
+
Status *int `json:"status,omitempty"`
|
|
22
|
+
Err error `json:"-"`
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
// emitLog calls OnLog, recovering a panic so a faulty logger cannot break the request.
|
|
26
|
+
func emitLog(cfg Config, entry LogEntry) {
|
|
27
|
+
if cfg.OnLog == nil {
|
|
28
|
+
return
|
|
29
|
+
}
|
|
30
|
+
defer func() {
|
|
31
|
+
_ = recover()
|
|
32
|
+
}()
|
|
33
|
+
cfg.OnLog(entry)
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
func errorEntry(operation string, start time.Time, err error) LogEntry {
|
|
37
|
+
entry := LogEntry{Level: "error", Event: "error", Operation: operation, DurationMs: time.Since(start).Milliseconds(), Err: templated(err, operation)}
|
|
38
|
+
var apiErr APIError
|
|
39
|
+
if errors.As(err, &apiErr) {
|
|
40
|
+
status := apiErr.Status()
|
|
41
|
+
entry.Status = &status
|
|
42
|
+
}
|
|
43
|
+
return entry
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
// redactedError keeps an error's chain for errors.Is and errors.As, but its text names the request
|
|
47
|
+
// URL without query, userinfo or fragment, so a logged error never carries a credential.
|
|
48
|
+
type redactedError struct {
|
|
49
|
+
msg string
|
|
50
|
+
err error
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
func (e *redactedError) Error() string { return e.msg }
|
|
54
|
+
|
|
55
|
+
func (e *redactedError) Unwrap() error { return e.err }
|
|
56
|
+
|
|
57
|
+
// redactURL rewrites the text of an error that wraps a *url.Error to name the redacted URL.
|
|
58
|
+
func redactURL(err error) error {
|
|
59
|
+
var ue *url.Error
|
|
60
|
+
if !errors.As(err, &ue) {
|
|
61
|
+
return err
|
|
62
|
+
}
|
|
63
|
+
safe := redactedURL(ue.URL)
|
|
64
|
+
if safe == ue.URL {
|
|
65
|
+
return err
|
|
66
|
+
}
|
|
67
|
+
msg := strings.ReplaceAll(err.Error(), strconv.Quote(ue.URL), strconv.Quote(safe))
|
|
68
|
+
return &redactedError{msg: strings.ReplaceAll(msg, ue.URL, safe), err: err}
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
func redactedURL(raw string) string {
|
|
72
|
+
u, err := url.Parse(raw)
|
|
73
|
+
if err != nil {
|
|
74
|
+
return "(url redacted)"
|
|
75
|
+
}
|
|
76
|
+
u.User = nil
|
|
77
|
+
u.RawQuery = ""
|
|
78
|
+
u.ForceQuery = false
|
|
79
|
+
u.Fragment = ""
|
|
80
|
+
u.RawFragment = ""
|
|
81
|
+
return u.String()
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
// templated names operation in place of the request in the text of an error wrapping a *url.Error
|
|
85
|
+
// (its URL as wrapTransportError left it), so a logged error carries no path value.
|
|
86
|
+
func templated(err error, operation string) error {
|
|
87
|
+
var ue *url.Error
|
|
88
|
+
if !errors.As(err, &ue) {
|
|
89
|
+
return err
|
|
90
|
+
}
|
|
91
|
+
return &redactedError{msg: strings.ReplaceAll(err.Error(), ue.Op+" "+strconv.Quote(redactedURL(ue.URL)), operation), err: err}
|
|
92
|
+
}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
// Code generated by honey. DO NOT EDIT.
|
|
2
|
+
|
|
3
|
+
package sdk
|
|
4
|
+
|
|
5
|
+
import (
|
|
6
|
+
"bytes"
|
|
7
|
+
"encoding/json"
|
|
8
|
+
)
|
|
9
|
+
|
|
10
|
+
// Nullable is an optional field that may also be null. Its zero value is "absent": the key is left
|
|
11
|
+
// out of the request (the field carries `omitzero`). NullOf sends an explicit null, Some a value.
|
|
12
|
+
// Decoding sets it from the response: absent stays absent, null becomes null.
|
|
13
|
+
type Nullable[T any] struct {
|
|
14
|
+
value T
|
|
15
|
+
set bool
|
|
16
|
+
null bool
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
// Some is a present, non-null value.
|
|
20
|
+
func Some[T any](v T) Nullable[T] {
|
|
21
|
+
return Nullable[T]{value: v, set: true}
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
// NullOf is an explicit null.
|
|
25
|
+
func NullOf[T any]() Nullable[T] {
|
|
26
|
+
return Nullable[T]{set: true, null: true}
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
// IsZero reports an absent field; encoding/json leaves it out under `omitzero`.
|
|
30
|
+
func (n Nullable[T]) IsZero() bool {
|
|
31
|
+
return !n.set
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
// IsNull reports an explicit null.
|
|
35
|
+
func (n Nullable[T]) IsNull() bool {
|
|
36
|
+
return n.set && n.null
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
// Get returns the value and whether there is one (false for absent and for null).
|
|
40
|
+
func (n Nullable[T]) Get() (T, bool) {
|
|
41
|
+
return n.value, n.set && !n.null
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
// MarshalJSON encodes null for an explicit null (an absent field is left out by omitzero).
|
|
45
|
+
func (n Nullable[T]) MarshalJSON() ([]byte, error) {
|
|
46
|
+
if !n.set || n.null {
|
|
47
|
+
return []byte("null"), nil
|
|
48
|
+
}
|
|
49
|
+
return json.Marshal(n.value)
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
// UnmarshalJSON sets a present value or an explicit null.
|
|
53
|
+
func (n *Nullable[T]) UnmarshalJSON(data []byte) error {
|
|
54
|
+
if bytes.Equal(bytes.TrimSpace(data), []byte("null")) {
|
|
55
|
+
*n = NullOf[T]()
|
|
56
|
+
return nil
|
|
57
|
+
}
|
|
58
|
+
var v T
|
|
59
|
+
if err := json.Unmarshal(data, &v); err != nil {
|
|
60
|
+
return err
|
|
61
|
+
}
|
|
62
|
+
*n = Some(v)
|
|
63
|
+
return nil
|
|
64
|
+
}
|