@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,124 @@
|
|
|
1
|
+
export type HeadersContext = {
|
|
2
|
+
method: string
|
|
3
|
+
path: string
|
|
4
|
+
}
|
|
5
|
+
|
|
6
|
+
type HeadersRecord = Record<string, string | undefined>
|
|
7
|
+
|
|
8
|
+
export type HeadersInit = ((ctx: HeadersContext) => HeadersRecord | Promise<HeadersRecord>) | HeadersRecord
|
|
9
|
+
|
|
10
|
+
/** What the SDK knows of a read's staleness, handed to the request and response hooks. */
|
|
11
|
+
export type RequestMeta = {
|
|
12
|
+
invalidatedBy: string[]
|
|
13
|
+
isStale: boolean
|
|
14
|
+
selector: string
|
|
15
|
+
seqSnapshot: number
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
export type OnRequestContext = {
|
|
19
|
+
body?: BodyInit | undefined
|
|
20
|
+
headers: Headers
|
|
21
|
+
invalidatedBy?: string[] | undefined
|
|
22
|
+
isStale?: boolean | undefined
|
|
23
|
+
method: string
|
|
24
|
+
/** the operation's path template, as the document spells it (`/items/{id}`), never the filled-in URL */
|
|
25
|
+
path: string
|
|
26
|
+
selector?: string | undefined
|
|
27
|
+
state: Record<string, unknown>
|
|
28
|
+
url: string
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
export type OnResponseContext = {
|
|
32
|
+
invalidatedBy?: string[]
|
|
33
|
+
isRetry: boolean
|
|
34
|
+
isStale?: boolean
|
|
35
|
+
method: string
|
|
36
|
+
/** the operation's path template, as the document spells it (`/items/{id}`), never the filled-in URL */
|
|
37
|
+
path: string
|
|
38
|
+
readonly request: Request
|
|
39
|
+
response: Response
|
|
40
|
+
/**
|
|
41
|
+
* Send the request once more and resolve with the new response, whatever its status. On a
|
|
42
|
+
* request that is itself a retry, it resolves with the current response (one retry max).
|
|
43
|
+
*/
|
|
44
|
+
retry: () => Promise<Response>
|
|
45
|
+
selector?: string
|
|
46
|
+
state: Record<string, unknown>
|
|
47
|
+
url: string
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
/**
|
|
51
|
+
* - `same-origin` (default): follow redirects that stay on the base URL's origin; a cross-origin
|
|
52
|
+
* redirect is returned unfollowed (a non-2xx result). In browsers, which hide redirect targets
|
|
53
|
+
* from script, the platform follows and applies CORS to the target.
|
|
54
|
+
* - `follow`: also follow cross-origin redirects. Such a hop carries only `Accept`,
|
|
55
|
+
* `Accept-Language` and `User-Agent` (no credentials, auth header, configured, per-call or
|
|
56
|
+
* `onRequest` header) and never replays a body.
|
|
57
|
+
* - `manual` / `error`: passed to `fetch`.
|
|
58
|
+
*/
|
|
59
|
+
export type RedirectPolicy = "error" | "follow" | "manual" | "same-origin"
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* One `onLog` entry: what happened to which operation and how long it took. `operation` is `METHOD` and the
|
|
63
|
+
* path template, the same spelling a hook's `ctx.path` carries (`GET /items/{id}`).
|
|
64
|
+
*/
|
|
65
|
+
export type LogEntry = {
|
|
66
|
+
duration_ms: number
|
|
67
|
+
error?: unknown
|
|
68
|
+
event: "error" | "hook_executed" | "request_start" | "response_received"
|
|
69
|
+
level: "debug" | "error" | "info" | "warn"
|
|
70
|
+
operation: string
|
|
71
|
+
status?: number
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
export type AuthExpiredContext = {
|
|
75
|
+
/** The token the 401 rejected (read from the auth header), so concurrent 401s can share one refresh. */
|
|
76
|
+
rejectedToken: string | null
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
export type ClientConfig = {
|
|
80
|
+
/** The header for `onAuthExpired`'s token: unset, the API's scheme's; set, its prefix is yours (unset: none). */
|
|
81
|
+
authHeaderName?: string
|
|
82
|
+
/** That header's prefix; set alone, the scheme's header keeps it. */
|
|
83
|
+
authHeaderPrefix?: string
|
|
84
|
+
/** Absolute `http(s):` / `ws(s):` URL, or a same-origin path such as `"/api"`. */
|
|
85
|
+
baseURL: string
|
|
86
|
+
buildSearchParams?: (query: Record<string, unknown>) => URLSearchParams
|
|
87
|
+
credentials?: RequestCredentials
|
|
88
|
+
/** Defaults to the environment `fetch`, bound so it is safe to call in browsers. */
|
|
89
|
+
fetch?: typeof fetch
|
|
90
|
+
headers?: HeadersInit
|
|
91
|
+
/** The most characters of a server's error message a ClientError carries. Default 512. */
|
|
92
|
+
maxErrorMessageChars?: number
|
|
93
|
+
/**
|
|
94
|
+
* The most bytes a response body may hold, decoded, before its read is refused with a ClientError and the body
|
|
95
|
+
* cancelled: it is read in the chunks it arrives in, never whole. Default 100 MiB. Streams are bounded by their
|
|
96
|
+
* own per-event caps instead.
|
|
97
|
+
*/
|
|
98
|
+
maxResponseBytes?: number
|
|
99
|
+
mode?: RequestMode
|
|
100
|
+
/**
|
|
101
|
+
* Called on a 401. Return a fresh token to retry the request once with it (and use it for later
|
|
102
|
+
* requests); return null or "" to give up. Concurrent 401s share one call. Requests whose body
|
|
103
|
+
* is a stream are not retried.
|
|
104
|
+
*/
|
|
105
|
+
onAuthExpired?: (ctx: AuthExpiredContext) => Promise<string | null | undefined> | string | null | undefined
|
|
106
|
+
/** Called at each exchange's start, its answer and its failure (v0's entry shape). */
|
|
107
|
+
onLog?: (entry: LogEntry) => void
|
|
108
|
+
onReconnected?: () => void
|
|
109
|
+
onReconnecting?: (attempt: number, transport: string) => void
|
|
110
|
+
onRequest?: Array<(ctx: OnRequestContext) => Promise<void> | void>
|
|
111
|
+
onResponse?: Array<(ctx: OnResponseContext) => Promise<Response | undefined> | Response | undefined>
|
|
112
|
+
/** Redirect handling; see `RedirectPolicy`. Default `"same-origin"`. */
|
|
113
|
+
redirect?: RedirectPolicy
|
|
114
|
+
/** Send an `x-request-id` header on every request. Default `true`; `false` avoids a CORS preflight. */
|
|
115
|
+
requestId?: boolean
|
|
116
|
+
sortSearchParams?: boolean
|
|
117
|
+
/** The most UTF-8 bytes one event-stream line may hold before the stream errors. Default 1 MiB. */
|
|
118
|
+
sseMaxLineBytes?: number
|
|
119
|
+
/** The most UTF-8 bytes one event's data may hold, its joining newlines counted. Default 8 MiB. */
|
|
120
|
+
sseMaxEventBytes?: number
|
|
121
|
+
state?: Record<string, unknown>
|
|
122
|
+
/** Milliseconds for a whole request, including reading the body; a stream's only up to its headers. */
|
|
123
|
+
timeout?: number
|
|
124
|
+
}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/** Absolute client bases: http(s) and ws(s). Case-insensitive per WHATWG. */
|
|
2
|
+
const ABSOLUTE_CLIENT_URL = /^(?:https?|wss?):\/\//i
|
|
3
|
+
|
|
4
|
+
export function invalidBaseURLError(baseURL: string): Error {
|
|
5
|
+
return new Error(
|
|
6
|
+
`Invalid baseURL ${JSON.stringify(baseURL)}: expected an absolute http(s): or ws(s): URL. Path-only values such as "/api" resolve against location.origin in browsers.`,
|
|
7
|
+
)
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* Honor `config.fetch` as-is. If omitted, bind the environment fetch so storing it on a client
|
|
12
|
+
* field does not throw `Illegal invocation` in browsers.
|
|
13
|
+
*/
|
|
14
|
+
export function bindDefaultFetch(custom?: typeof fetch): typeof fetch {
|
|
15
|
+
if (custom) return custom
|
|
16
|
+
const nativeFetch = globalThis.fetch
|
|
17
|
+
return typeof nativeFetch === "function" ? nativeFetch.bind(globalThis) : (nativeFetch as typeof fetch)
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
function currentLocationOrigin(): string | undefined {
|
|
21
|
+
let origin: unknown
|
|
22
|
+
try {
|
|
23
|
+
origin = globalThis.location?.origin
|
|
24
|
+
} catch {
|
|
25
|
+
/* a sandboxed location that throws on read: there is no origin to resolve against */
|
|
26
|
+
return undefined
|
|
27
|
+
}
|
|
28
|
+
if (typeof origin !== "string" || origin === "" || origin === "null") return undefined
|
|
29
|
+
if (!ABSOLUTE_CLIENT_URL.test(origin)) return undefined
|
|
30
|
+
return origin
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* Parse `baseURL`. Absolute `http(s):` / `ws(s):` URLs are unchanged. Path-only values such as
|
|
35
|
+
* `/api` resolve against `location.origin` when present.
|
|
36
|
+
*/
|
|
37
|
+
export function parseClientBaseURL(baseURL: string): URL {
|
|
38
|
+
if (ABSOLUTE_CLIENT_URL.test(baseURL)) return new URL(baseURL)
|
|
39
|
+
const origin = currentLocationOrigin()
|
|
40
|
+
if (origin !== undefined) {
|
|
41
|
+
try {
|
|
42
|
+
return new URL(baseURL, origin)
|
|
43
|
+
} catch {
|
|
44
|
+
throw invalidBaseURLError(baseURL)
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
throw invalidBaseURLError(baseURL)
|
|
48
|
+
}
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
export type ClientErrorInit<TBody = unknown> = {
|
|
2
|
+
body: TBody
|
|
3
|
+
cause?: unknown
|
|
4
|
+
message: string
|
|
5
|
+
response: Response
|
|
6
|
+
status: number
|
|
7
|
+
}
|
|
8
|
+
|
|
9
|
+
/** A non-2xx answer: its status, the parsed body (JSON when it parses, else text) and the response. */
|
|
10
|
+
export class ClientError<TBody = unknown> extends Error {
|
|
11
|
+
readonly body: TBody
|
|
12
|
+
readonly response: Response
|
|
13
|
+
readonly status: number
|
|
14
|
+
|
|
15
|
+
constructor(init: ClientErrorInit<TBody>) {
|
|
16
|
+
super(init.message, init)
|
|
17
|
+
/* V8 only, and not in every lib: read it as optional so the runtime compiles anywhere */
|
|
18
|
+
;(Error as { captureStackTrace?: (target: object, ctor?: unknown) => void }).captureStackTrace?.(this, new.target)
|
|
19
|
+
this.name = "ClientError"
|
|
20
|
+
this.body = init.body
|
|
21
|
+
this.response = init.response
|
|
22
|
+
this.status = init.status
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
export class BadRequestError<TBody = unknown> extends ClientError<TBody> {
|
|
27
|
+
override name = "BadRequestError"
|
|
28
|
+
}
|
|
29
|
+
export class UnauthorizedError<TBody = unknown> extends ClientError<TBody> {
|
|
30
|
+
override name = "UnauthorizedError"
|
|
31
|
+
}
|
|
32
|
+
export class ForbiddenError<TBody = unknown> extends ClientError<TBody> {
|
|
33
|
+
override name = "ForbiddenError"
|
|
34
|
+
}
|
|
35
|
+
export class NotFoundError<TBody = unknown> extends ClientError<TBody> {
|
|
36
|
+
override name = "NotFoundError"
|
|
37
|
+
}
|
|
38
|
+
export class ConflictError<TBody = unknown> extends ClientError<TBody> {
|
|
39
|
+
override name = "ConflictError"
|
|
40
|
+
}
|
|
41
|
+
export class UnprocessableEntityError<TBody = unknown> extends ClientError<TBody> {
|
|
42
|
+
override name = "UnprocessableEntityError"
|
|
43
|
+
}
|
|
44
|
+
export class RateLimitError<TBody = unknown> extends ClientError<TBody> {
|
|
45
|
+
override name = "RateLimitError"
|
|
46
|
+
}
|
|
47
|
+
export class InternalServerError<TBody = unknown> extends ClientError<TBody> {
|
|
48
|
+
override name = "InternalServerError"
|
|
49
|
+
}
|
|
50
|
+
export class BadGatewayError<TBody = unknown> extends ClientError<TBody> {
|
|
51
|
+
override name = "BadGatewayError"
|
|
52
|
+
}
|
|
53
|
+
export class ServiceUnavailableError<TBody = unknown> extends ClientError<TBody> {
|
|
54
|
+
override name = "ServiceUnavailableError"
|
|
55
|
+
}
|
|
56
|
+
export class GatewayTimeoutError<TBody = unknown> extends ClientError<TBody> {
|
|
57
|
+
override name = "GatewayTimeoutError"
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/** A 2xx whose body is no value of its operation: the text (null past the size cap), the parse error its cause. */
|
|
61
|
+
export class DecodeError extends ClientError<string | null> {
|
|
62
|
+
/* a literal, so a declared error with a string body never reads as one */
|
|
63
|
+
override readonly name = "DecodeError"
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
const STATUS_ERRORS: Readonly<Record<number, new (init: ClientErrorInit) => ClientError>> = {
|
|
67
|
+
400: BadRequestError,
|
|
68
|
+
401: UnauthorizedError,
|
|
69
|
+
403: ForbiddenError,
|
|
70
|
+
404: NotFoundError,
|
|
71
|
+
409: ConflictError,
|
|
72
|
+
422: UnprocessableEntityError,
|
|
73
|
+
429: RateLimitError,
|
|
74
|
+
500: InternalServerError,
|
|
75
|
+
502: BadGatewayError,
|
|
76
|
+
503: ServiceUnavailableError,
|
|
77
|
+
504: GatewayTimeoutError,
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
/** The most specific error class for a status: `UnauthorizedError` for 401, `ClientError` otherwise. */
|
|
81
|
+
export function clientErrorFor<TBody>(init: ClientErrorInit<TBody>): ClientError<TBody> {
|
|
82
|
+
const Cls = (Object.hasOwn(STATUS_ERRORS, init.status) ? STATUS_ERRORS[init.status] : undefined) ?? ClientError
|
|
83
|
+
return new Cls(init) as ClientError<TBody>
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
export function isClientError<T = unknown>(e: unknown): e is ClientError<T> {
|
|
87
|
+
return e instanceof ClientError
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
/** A request with no answer; the platform error is its `cause`. */
|
|
91
|
+
export class APIConnectionError extends Error {
|
|
92
|
+
override name = "APIConnectionError"
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/** A send or body read with no answer as APIConnectionError, its cause the platform's; an abort's as it is (f2). */
|
|
96
|
+
export function noAnswer(cause: unknown, url: unknown, init?: RequestInit): unknown {
|
|
97
|
+
if (init?.signal?.aborted) return cause
|
|
98
|
+
const { origin, pathname } = new URL(String(url))
|
|
99
|
+
return new APIConnectionError(`${init?.method} ${origin}${pathname}: the connection failed`, { cause })
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
/** A fetch failure as APIConnectionError; an abort's as it is. */
|
|
103
|
+
export function connectionErrors(fetch: typeof globalThis.fetch): typeof globalThis.fetch {
|
|
104
|
+
if (typeof fetch !== "function") return fetch
|
|
105
|
+
/* asserted, as Bun's fetch type also names `preconnect` */
|
|
106
|
+
return (async (input, init) => {
|
|
107
|
+
try {
|
|
108
|
+
return await fetch(input, init)
|
|
109
|
+
} catch (cause) {
|
|
110
|
+
throw noAnswer(cause, input, init)
|
|
111
|
+
}
|
|
112
|
+
}) as typeof globalThis.fetch
|
|
113
|
+
}
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
import type { ClientConfig, LogEntry, OnRequestContext, OnResponseContext, RequestMeta } from "./config.ts"
|
|
2
|
+
import { isReplayable } from "./request.ts"
|
|
3
|
+
|
|
4
|
+
/** Where a response hook runs: the request as sent, its answer, and how to send it again. */
|
|
5
|
+
export type ResponseAt = {
|
|
6
|
+
init: RequestInit
|
|
7
|
+
isRetry: boolean
|
|
8
|
+
meta: RequestMeta | undefined
|
|
9
|
+
method: string
|
|
10
|
+
path: string
|
|
11
|
+
response: Response
|
|
12
|
+
retry: () => Promise<Response>
|
|
13
|
+
state: Record<string, unknown>
|
|
14
|
+
url: URL
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* `init` as a `Request` can take it: a body that cannot be sent twice is left out, never set to
|
|
19
|
+
* `undefined`, which `RequestInit` does not declare.
|
|
20
|
+
*/
|
|
21
|
+
function replayable(init: RequestInit): RequestInit {
|
|
22
|
+
if (isReplayable(init.body)) return init
|
|
23
|
+
const { body: _body, ...rest } = init
|
|
24
|
+
return rest
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
/** `ctx` with the read's stale view, when the SDK tracks one. */
|
|
28
|
+
function withMeta<T extends object>(ctx: T, meta: RequestMeta | undefined): T {
|
|
29
|
+
if (meta) Object.assign(ctx, { invalidatedBy: meta.invalidatedBy, isStale: meta.isStale, selector: meta.selector })
|
|
30
|
+
return ctx
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/** Let each `onRequest` hook see the request and change it; resolves to the body it now sends. */
|
|
34
|
+
export async function runRequestHooks(
|
|
35
|
+
hooks: NonNullable<ClientConfig["onRequest"]>,
|
|
36
|
+
ctx: OnRequestContext,
|
|
37
|
+
meta: RequestMeta | undefined,
|
|
38
|
+
): Promise<BodyInit | undefined> {
|
|
39
|
+
withMeta(ctx, meta)
|
|
40
|
+
for (const hook of hooks) await hook(ctx)
|
|
41
|
+
return ctx.body
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/** Let each `onResponse` hook see the answer and replace it. */
|
|
45
|
+
export async function runResponseHooks(
|
|
46
|
+
hooks: NonNullable<ClientConfig["onResponse"]>,
|
|
47
|
+
at: ResponseAt,
|
|
48
|
+
): Promise<Response> {
|
|
49
|
+
let request: Request | undefined
|
|
50
|
+
const { init } = at
|
|
51
|
+
const ctx: OnResponseContext = {
|
|
52
|
+
isRetry: at.isRetry,
|
|
53
|
+
method: at.method,
|
|
54
|
+
path: at.path,
|
|
55
|
+
get request() {
|
|
56
|
+
/* built on demand: constructing a Request per response is not free */
|
|
57
|
+
request ??= new Request(at.url.toString(), replayable(init))
|
|
58
|
+
return request
|
|
59
|
+
},
|
|
60
|
+
response: at.response,
|
|
61
|
+
retry: () => (at.isRetry ? Promise.resolve(ctx.response) : at.retry()),
|
|
62
|
+
state: at.state,
|
|
63
|
+
url: at.url.toString(),
|
|
64
|
+
}
|
|
65
|
+
withMeta(ctx, at.meta)
|
|
66
|
+
for (const hook of hooks) {
|
|
67
|
+
const result = await hook(ctx)
|
|
68
|
+
if (result instanceof Response) ctx.response = result
|
|
69
|
+
}
|
|
70
|
+
return ctx.response
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
/** The `onLog` entries of one exchange: its start now, then its answer or its failure, each with its duration. */
|
|
74
|
+
export function exchangeLog(
|
|
75
|
+
onLog: ((entry: LogEntry) => void) | undefined,
|
|
76
|
+
operation: string,
|
|
77
|
+
): { answered: (response: Response) => void; failed: (error: unknown) => void } {
|
|
78
|
+
const start = Date.now()
|
|
79
|
+
onLog?.({ duration_ms: 0, event: "request_start", level: "debug", operation })
|
|
80
|
+
const took = () => Date.now() - start
|
|
81
|
+
return {
|
|
82
|
+
answered: (response) => {
|
|
83
|
+
const level = response.status >= 400 ? "warn" : "info"
|
|
84
|
+
onLog?.({ duration_ms: took(), event: "response_received", level, operation, status: response.status })
|
|
85
|
+
},
|
|
86
|
+
failed: (error) => {
|
|
87
|
+
const status = (error as { status?: unknown } | null)?.status
|
|
88
|
+
const entry: LogEntry = { duration_ms: took(), error, event: "error", level: "error", operation }
|
|
89
|
+
onLog?.(typeof status === "number" ? { ...entry, status } : entry)
|
|
90
|
+
},
|
|
91
|
+
}
|
|
92
|
+
}
|
|
@@ -0,0 +1,228 @@
|
|
|
1
|
+
import type { ClientConfig, HeadersContext, RequestMeta } from "./config.ts"
|
|
2
|
+
import { bindDefaultFetch, parseClientBaseURL } from "./defaults.ts"
|
|
3
|
+
import { connectionErrors, noAnswer } from "./error.ts"
|
|
4
|
+
import { exchangeLog, runRequestHooks, runResponseHooks } from "./hooks.ts"
|
|
5
|
+
import { interpolatePath } from "./path.ts"
|
|
6
|
+
import { fetchFollowing } from "./redirects.ts"
|
|
7
|
+
import {
|
|
8
|
+
defaultSearchParams,
|
|
9
|
+
encodeBody,
|
|
10
|
+
headersOf,
|
|
11
|
+
isReplayable,
|
|
12
|
+
type RequestKind,
|
|
13
|
+
type RequestOptions,
|
|
14
|
+
requestInit,
|
|
15
|
+
requestSignal,
|
|
16
|
+
} from "./request.ts"
|
|
17
|
+
import { type Answer, finishRequest, type Reading, type Sent } from "./response.ts"
|
|
18
|
+
|
|
19
|
+
/** One request, ready to send: where, with what, and the hooks' view of it. */
|
|
20
|
+
type Prepared = { body: BodyInit | undefined; headers: Headers; url: URL }
|
|
21
|
+
|
|
22
|
+
/** One call: its method, path template and options; `refreshes: false` leaves a 401 to the realtime loop. */
|
|
23
|
+
export type Call = { method: string; opts: RequestOptions; path: string; refreshes?: false | undefined }
|
|
24
|
+
|
|
25
|
+
/** The realtime loop's refresh key, exported by the SDK under no name. */
|
|
26
|
+
export const REFRESH_AUTH: unique symbol = /* @__PURE__ */ Symbol("honey.refreshAuth")
|
|
27
|
+
|
|
28
|
+
/** The send and the config, for the stream functions beside the client. */
|
|
29
|
+
export const SEND: unique symbol = /* @__PURE__ */ Symbol("honey.send")
|
|
30
|
+
export const CONFIG: unique symbol = /* @__PURE__ */ Symbol("honey.config")
|
|
31
|
+
|
|
32
|
+
/** One operation of a generated SDK: the call, how it is read, and its stale view for the hooks. */
|
|
33
|
+
export type Operation = Call & {
|
|
34
|
+
/** the non-JSON media type the operation declares, read as that type; null when it declares no body */
|
|
35
|
+
declared?: string | null | undefined
|
|
36
|
+
meta?: RequestMeta | undefined
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
/** Ignore a failed cancel: the body is being discarded either way. */
|
|
40
|
+
const discard = (response: Response) =>
|
|
41
|
+
response.body?.cancel().catch(() => {
|
|
42
|
+
/* discarded */
|
|
43
|
+
})
|
|
44
|
+
|
|
45
|
+
export class HTTPClient {
|
|
46
|
+
readonly #config: ClientConfig
|
|
47
|
+
readonly #fetch: typeof fetch
|
|
48
|
+
#base: URL | undefined
|
|
49
|
+
#token: string | null = null
|
|
50
|
+
#refreshing: Promise<string | null> | null = null
|
|
51
|
+
|
|
52
|
+
readonly #disposal: AbortSignal | undefined
|
|
53
|
+
|
|
54
|
+
/** `disposal` aborts every request in flight and refuses later ones (a generated SDK's `dispose()`). */
|
|
55
|
+
constructor(config: ClientConfig, disposal?: AbortSignal) {
|
|
56
|
+
this.#config = config
|
|
57
|
+
this.#fetch = connectionErrors(bindDefaultFetch(config.fetch))
|
|
58
|
+
this.#disposal = disposal
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/** The base URL, parsed once; a per-call base (C2) is parsed for that call. */
|
|
62
|
+
#baseFor(opts: RequestOptions): URL {
|
|
63
|
+
if (opts.baseURL !== undefined) return parseClientBaseURL(opts.baseURL)
|
|
64
|
+
this.#base ??= parseClientBaseURL(this.#config.baseURL)
|
|
65
|
+
return this.#base
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
get #authName(): string {
|
|
69
|
+
return this.#config.authHeaderName ?? "Authorization"
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
get #authPrefix(): string {
|
|
73
|
+
return this.#config.authHeaderPrefix ?? (this.#config.authHeaderName === undefined ? "Bearer " : "")
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
#query(search: Record<string, unknown>): URLSearchParams {
|
|
77
|
+
const params = (this.#config.buildSearchParams ?? defaultSearchParams)(search)
|
|
78
|
+
if (this.#config.sortSearchParams) params.sort()
|
|
79
|
+
return params
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
/** Resolve `path` against the base URL, keeping the base path and query, and assert it stays there. */
|
|
83
|
+
#url(path: string, opts: RequestOptions): URL {
|
|
84
|
+
const resolved = interpolatePath(path, opts.params)
|
|
85
|
+
const base = this.#baseFor(opts)
|
|
86
|
+
const basePath = base.pathname.endsWith("/") ? base.pathname : `${base.pathname}/`
|
|
87
|
+
const url = new URL(base.href)
|
|
88
|
+
url.pathname = `${basePath}${resolved.startsWith("/") ? resolved.slice(1) : resolved}`
|
|
89
|
+
url.hash = ""
|
|
90
|
+
/* params are validated, so this only fires on a malformed template; never send it anywhere else */
|
|
91
|
+
if (url.origin !== base.origin || !url.pathname.startsWith(basePath.slice(0, -1))) {
|
|
92
|
+
throw new Error(`Request path ${JSON.stringify(path)} resolves outside the base URL`)
|
|
93
|
+
}
|
|
94
|
+
if (opts.search) for (const [k, v] of this.#query(opts.search).entries()) url.searchParams.append(k, v)
|
|
95
|
+
return url
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
async #headers(opts: RequestOptions, ctx: HeadersContext): Promise<Headers> {
|
|
99
|
+
const configured = this.#config.headers
|
|
100
|
+
const resolved = typeof configured === "function" ? await configured(ctx) : configured
|
|
101
|
+
/* a refreshed token replaces the configured one; per-call headers still win */
|
|
102
|
+
const auth = this.#token === null ? {} : { [this.#authName]: `${this.#authPrefix}${this.#token}` }
|
|
103
|
+
return headersOf([resolved ?? {}, auth, opts.headers ?? {}], opts.cookies, this.#config.requestId !== false)
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/** Share one `onAuthExpired` call between concurrent 401s; reuse a token another request already got. */
|
|
107
|
+
#refresh(rejectedToken: string | null): Promise<string | null> {
|
|
108
|
+
if (this.#token !== null && rejectedToken !== this.#token) return Promise.resolve(this.#token)
|
|
109
|
+
if (this.#refreshing) return this.#refreshing
|
|
110
|
+
const hook = this.#config.onAuthExpired
|
|
111
|
+
if (!hook) return Promise.resolve(null)
|
|
112
|
+
this.#refreshing = Promise.resolve()
|
|
113
|
+
.then(() => hook({ rejectedToken }))
|
|
114
|
+
.then((token) => {
|
|
115
|
+
this.#token = typeof token === "string" && token.length > 0 ? token : null
|
|
116
|
+
return this.#token
|
|
117
|
+
})
|
|
118
|
+
.finally(() => {
|
|
119
|
+
this.#refreshing = null
|
|
120
|
+
})
|
|
121
|
+
return this.#refreshing
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
/** @internal */
|
|
125
|
+
get [CONFIG](): ClientConfig {
|
|
126
|
+
return this.#config
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
/** @internal One request sent: its hooks run, its auth refreshed, its redirects followed. */
|
|
130
|
+
[SEND](call: Call, kind: RequestKind, meta?: RequestMeta): Promise<Sent> {
|
|
131
|
+
return this.#send(call, kind, meta)
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
/** @internal The client's one shared refresh; whether a new token is in place. */
|
|
135
|
+
async [REFRESH_AUTH](): Promise<boolean> {
|
|
136
|
+
return (await this.#refresh(this.#token)) !== null
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
/** Build the request and let the `onRequest` hooks see and change it. */
|
|
140
|
+
async #prepare({ method, opts, path }: Call, kind: RequestKind, meta?: RequestMeta) {
|
|
141
|
+
const url = this.#url(path, opts)
|
|
142
|
+
const headers = await this.#headers(opts, { method, path })
|
|
143
|
+
if (kind === "stream") {
|
|
144
|
+
headers.set("accept", "text/event-stream")
|
|
145
|
+
if (opts.lastEventId) headers.set("last-event-id", opts.lastEventId)
|
|
146
|
+
}
|
|
147
|
+
const prepared: Prepared = { body: encodeBody(opts, headers), headers, url }
|
|
148
|
+
if (!this.#config.onRequest) return prepared
|
|
149
|
+
const ctx = { body: prepared.body, headers, method, path, state: this.#config.state ?? {}, url: url.toString() }
|
|
150
|
+
prepared.body = await runRequestHooks(this.#config.onRequest, ctx, meta)
|
|
151
|
+
return prepared
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
/** Send, following redirects; on a 401 with a refresh hook, retry once with the fresh token. */
|
|
155
|
+
async #transmit(url: URL, init: RequestInit, isRetry: boolean): Promise<Response> {
|
|
156
|
+
const options = { origin: url.origin, policy: this.#config.redirect ?? "same-origin" }
|
|
157
|
+
const response = await fetchFollowing(this.#fetch, url, init, options)
|
|
158
|
+
if (response.status !== 401 || !this.#config.onAuthExpired || isRetry || !isReplayable(init.body)) return response
|
|
159
|
+
const sent = (init.headers as Headers).get(this.#authName)
|
|
160
|
+
const rejected = sent?.startsWith(this.#authPrefix) ? sent.slice(this.#authPrefix.length) : (sent ?? null)
|
|
161
|
+
const token = await this.#refresh(rejected)
|
|
162
|
+
if (token === null) return response
|
|
163
|
+
const headers = new Headers(init.headers)
|
|
164
|
+
headers.set(this.#authName, `${this.#authPrefix}${token}`)
|
|
165
|
+
init.headers = headers
|
|
166
|
+
await discard(response)
|
|
167
|
+
return fetchFollowing(this.#fetch, url, { ...init }, options)
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
/** Build, send and post-process one request: hooks, auth refresh, redirects. */
|
|
171
|
+
async #send(call: Call, kind: RequestKind, meta?: RequestMeta, isRetry = false): Promise<Sent> {
|
|
172
|
+
const { method, opts, path } = call
|
|
173
|
+
const { body, headers, url } = await this.#prepare(call, kind, meta)
|
|
174
|
+
const timeout = opts.timeout ?? this.#config.timeout
|
|
175
|
+
const { done, exemptFromTimeout, signal } = requestSignal([opts.signal, this.#disposal], timeout)
|
|
176
|
+
const cleanups: Array<() => void> = [done]
|
|
177
|
+
const finish = () => {
|
|
178
|
+
for (const fn of cleanups.splice(0)) fn()
|
|
179
|
+
}
|
|
180
|
+
const init = requestInit({ body, headers, method, signal }, this.#config)
|
|
181
|
+
const log = exchangeLog(this.#config.onLog, `${method.toUpperCase()} ${path}`)
|
|
182
|
+
try {
|
|
183
|
+
signal?.throwIfAborted()
|
|
184
|
+
let response = await this.#transmit(url, init, isRetry || call.refreshes === false)
|
|
185
|
+
log.answered(response)
|
|
186
|
+
if (this.#config.onResponse) {
|
|
187
|
+
const retry = async () => {
|
|
188
|
+
const again = await this.#send(call, kind, meta, true)
|
|
189
|
+
cleanups.push(again.done)
|
|
190
|
+
return again.response
|
|
191
|
+
}
|
|
192
|
+
const state = this.#config.state ?? {}
|
|
193
|
+
const at = { init, isRetry, meta, method, path, response, retry, state, url }
|
|
194
|
+
response = await runResponseHooks(this.#config.onResponse, at)
|
|
195
|
+
}
|
|
196
|
+
return { done: finish, exemptFromTimeout, failed: (cause) => noAnswer(cause, url, init), response }
|
|
197
|
+
} catch (e) {
|
|
198
|
+
finish()
|
|
199
|
+
log.failed(e)
|
|
200
|
+
throw e
|
|
201
|
+
}
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
#reading(method: string, opts: RequestOptions): Reading {
|
|
205
|
+
return { limits: this.#config, method, raw: opts.raw }
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
/** The parsed body; a non-2xx throws its ClientError (a per-status subclass). */
|
|
209
|
+
async request(method: string, path: string, opts: RequestOptions, meta?: RequestMeta): Promise<unknown> {
|
|
210
|
+
return (await this.requestOperation({ meta, method, opts, path })).data
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
/** One REST operation's answer, read as `op` says: parsed, or raw. */
|
|
214
|
+
async requestOperation(op: Operation): Promise<Answer> {
|
|
215
|
+
const sent = await this.#send(op, "rest", op.meta)
|
|
216
|
+
return finishRequest(sent, { ...this.#reading(op.method, op.opts), declared: op.declared })
|
|
217
|
+
}
|
|
218
|
+
|
|
219
|
+
buildUrl(path: string, opts: RequestOptions): string {
|
|
220
|
+
return this.#url(path, opts).toString()
|
|
221
|
+
}
|
|
222
|
+
|
|
223
|
+
buildPath(path: string, opts: RequestOptions): string {
|
|
224
|
+
const resolved = interpolatePath(path, opts.params)
|
|
225
|
+
const qs = opts.search ? this.#query(opts.search).toString() : ""
|
|
226
|
+
return qs ? `${resolved}?${qs}` : resolved
|
|
227
|
+
}
|
|
228
|
+
}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
/** A `Content-Type`, read as far as the client needs it: its essence, type and structured suffix. */
|
|
2
|
+
export type MediaType = {
|
|
3
|
+
/** `type/subtype`, lowercased, without parameters */
|
|
4
|
+
essence: string
|
|
5
|
+
/** the structured-syntax suffix (`json` for `application/vnd.api+json`), or `null` */
|
|
6
|
+
suffix: string | null
|
|
7
|
+
type: string
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
/* RFC 9110 token characters */
|
|
11
|
+
const MEDIA_TOKEN = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+$/
|
|
12
|
+
|
|
13
|
+
/** `value` as a media type; `null` when it is missing or not `token/token`. */
|
|
14
|
+
export function parseMediaType(value: string | null | undefined): MediaType | null {
|
|
15
|
+
if (value === null || value === undefined) return null
|
|
16
|
+
const semi = value.indexOf(";")
|
|
17
|
+
const head = (semi === -1 ? value : value.slice(0, semi)).trim()
|
|
18
|
+
const slash = head.indexOf("/")
|
|
19
|
+
if (slash === -1) return null
|
|
20
|
+
const type = head.slice(0, slash).toLowerCase()
|
|
21
|
+
const subtype = head.slice(slash + 1).toLowerCase()
|
|
22
|
+
if (!MEDIA_TOKEN.test(type) || !MEDIA_TOKEN.test(subtype)) return null
|
|
23
|
+
const plus = subtype.lastIndexOf("+")
|
|
24
|
+
const suffix = plus > 0 && plus < subtype.length - 1 ? subtype.slice(plus + 1) : null
|
|
25
|
+
return { essence: `${type}/${subtype}`, suffix, type }
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
/** JSON bodies: `application/json` and any `+json` type. */
|
|
29
|
+
export function isJsonMediaType(mt: MediaType | null): boolean {
|
|
30
|
+
return mt !== null && (mt.essence === "application/json" || mt.suffix === "json")
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/** Text-like bodies: `text/*`, `application/xml`, and any `+xml` type. */
|
|
34
|
+
export function isTextMediaType(mt: MediaType | null): boolean {
|
|
35
|
+
return mt !== null && (mt.type === "text" || mt.essence === "application/xml" || mt.suffix === "xml")
|
|
36
|
+
}
|