@workerstack/clients 0.0.0-stage → 1.0.0-rc.23
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +619 -2
- package/bin/honey-clients.js +94 -0
- package/dist/cli.d.ts +102 -0
- package/dist/cli.js +190 -0
- package/dist/emit/cli/channels.d.ts +73 -0
- package/dist/emit/cli/channels.js +197 -0
- package/dist/emit/cli/commands.d.ts +27 -0
- package/dist/emit/cli/commands.js +187 -0
- package/dist/emit/cli/discovery.d.ts +35 -0
- package/dist/emit/cli/discovery.js +202 -0
- package/dist/emit/cli/flags.d.ts +59 -0
- package/dist/emit/cli/flags.js +186 -0
- package/dist/emit/cli/index.d.ts +1 -0
- package/dist/emit/cli/index.js +1 -0
- package/dist/emit/cli/install.d.ts +37 -0
- package/dist/emit/cli/install.js +88 -0
- package/dist/emit/cli/layout.d.ts +23 -0
- package/dist/emit/cli/layout.js +118 -0
- package/dist/emit/cli/module.d.ts +30 -0
- package/dist/emit/cli/module.js +186 -0
- package/dist/emit/cli/release.d.ts +40 -0
- package/dist/emit/cli/release.js +183 -0
- package/dist/emit/cli/skills.d.ts +11 -0
- package/dist/emit/cli/skills.js +56 -0
- package/dist/emit/csharp/errors.d.ts +7 -0
- package/dist/emit/csharp/errors.js +69 -0
- package/dist/emit/csharp/index.d.ts +1 -0
- package/dist/emit/csharp/index.js +1 -0
- package/dist/emit/csharp/json.d.ts +13 -0
- package/dist/emit/csharp/json.js +113 -0
- package/dist/emit/csharp/realtime.d.ts +10 -0
- package/dist/emit/csharp/realtime.js +33 -0
- package/dist/emit/csharp/sdk-answer.d.ts +48 -0
- package/dist/emit/csharp/sdk-answer.js +85 -0
- package/dist/emit/csharp/sdk-body.d.ts +10 -0
- package/dist/emit/csharp/sdk-body.js +87 -0
- package/dist/emit/csharp/sdk-client.d.ts +32 -0
- package/dist/emit/csharp/sdk-client.js +177 -0
- package/dist/emit/csharp/sdk-csproj.d.ts +36 -0
- package/dist/emit/csharp/sdk-csproj.js +136 -0
- package/dist/emit/csharp/sdk-doc.d.ts +12 -0
- package/dist/emit/csharp/sdk-doc.js +35 -0
- package/dist/emit/csharp/sdk-method.d.ts +26 -0
- package/dist/emit/csharp/sdk-method.js +187 -0
- package/dist/emit/csharp/sdk-plan.d.ts +38 -0
- package/dist/emit/csharp/sdk-plan.js +1 -0
- package/dist/emit/csharp/sdk.d.ts +40 -0
- package/dist/emit/csharp/sdk.js +105 -0
- package/dist/emit/csharp/sse.d.ts +18 -0
- package/dist/emit/csharp/sse.js +29 -0
- package/dist/emit/csharp/transport.d.ts +11 -0
- package/dist/emit/csharp/transport.js +67 -0
- package/dist/emit/csharp/types-enum.d.ts +19 -0
- package/dist/emit/csharp/types-enum.js +63 -0
- package/dist/emit/csharp/types-names.d.ts +33 -0
- package/dist/emit/csharp/types-names.js +182 -0
- package/dist/emit/csharp/types-record.d.ts +25 -0
- package/dist/emit/csharp/types-record.js +65 -0
- package/dist/emit/csharp/types-union.d.ts +27 -0
- package/dist/emit/csharp/types-union.js +113 -0
- package/dist/emit/csharp/types.d.ts +36 -0
- package/dist/emit/csharp/types.js +126 -0
- package/dist/emit/csharp/ws.d.ts +20 -0
- package/dist/emit/csharp/ws.js +14 -0
- package/dist/emit/go/errors.d.ts +7 -0
- package/dist/emit/go/errors.js +44 -0
- package/dist/emit/go/http.d.ts +11 -0
- package/dist/emit/go/http.js +50 -0
- package/dist/emit/go/index.d.ts +1 -0
- package/dist/emit/go/index.js +1 -0
- package/dist/emit/go/module-path.d.ts +2 -0
- package/dist/emit/go/module-path.js +27 -0
- package/dist/emit/go/sdk-answer.d.ts +28 -0
- package/dist/emit/go/sdk-answer.js +41 -0
- package/dist/emit/go/sdk-body.d.ts +24 -0
- package/dist/emit/go/sdk-body.js +76 -0
- package/dist/emit/go/sdk-client.d.ts +29 -0
- package/dist/emit/go/sdk-client.js +141 -0
- package/dist/emit/go/sdk-method.d.ts +68 -0
- package/dist/emit/go/sdk-method.js +172 -0
- package/dist/emit/go/sdk-mirror.d.ts +23 -0
- package/dist/emit/go/sdk-mirror.js +97 -0
- package/dist/emit/go/sdk-opts.d.ts +55 -0
- package/dist/emit/go/sdk-opts.js +100 -0
- package/dist/emit/go/sdk.d.ts +26 -0
- package/dist/emit/go/sdk.js +111 -0
- package/dist/emit/go/sse.d.ts +16 -0
- package/dist/emit/go/sse.js +26 -0
- package/dist/emit/go/types-codec.d.ts +15 -0
- package/dist/emit/go/types-codec.js +171 -0
- package/dist/emit/go/types-names.d.ts +14 -0
- package/dist/emit/go/types-names.js +64 -0
- package/dist/emit/go/types-struct.d.ts +29 -0
- package/dist/emit/go/types-struct.js +65 -0
- package/dist/emit/go/types-union.d.ts +17 -0
- package/dist/emit/go/types-union.js +84 -0
- package/dist/emit/go/types.d.ts +32 -0
- package/dist/emit/go/types.js +177 -0
- package/dist/emit/go/ws.d.ts +12 -0
- package/dist/emit/go/ws.js +70 -0
- package/dist/emit/java/gradle.d.ts +57 -0
- package/dist/emit/java/gradle.js +221 -0
- package/dist/emit/java/index.d.ts +2 -0
- package/dist/emit/java/index.js +2 -0
- package/dist/emit/java/json.d.ts +13 -0
- package/dist/emit/java/json.js +84 -0
- package/dist/emit/java/layout-ast.d.ts +146 -0
- package/dist/emit/java/layout-ast.js +102 -0
- package/dist/emit/java/layout-decl.d.ts +20 -0
- package/dist/emit/java/layout-decl.js +155 -0
- package/dist/emit/java/layout-doc.d.ts +55 -0
- package/dist/emit/java/layout-doc.js +166 -0
- package/dist/emit/java/layout-dot.d.ts +18 -0
- package/dist/emit/java/layout-dot.js +127 -0
- package/dist/emit/java/layout-strings.d.ts +8 -0
- package/dist/emit/java/layout-strings.js +76 -0
- package/dist/emit/java/layout-types.d.ts +11 -0
- package/dist/emit/java/layout-types.js +95 -0
- package/dist/emit/java/layout-visitor.d.ts +38 -0
- package/dist/emit/java/layout-visitor.js +232 -0
- package/dist/emit/java/layout.d.ts +61 -0
- package/dist/emit/java/layout.js +121 -0
- package/dist/emit/java/models-enum.d.ts +17 -0
- package/dist/emit/java/models-enum.js +51 -0
- package/dist/emit/java/models-names.d.ts +29 -0
- package/dist/emit/java/models-names.js +97 -0
- package/dist/emit/java/models-record.d.ts +24 -0
- package/dist/emit/java/models-record.js +79 -0
- package/dist/emit/java/models-union.d.ts +27 -0
- package/dist/emit/java/models-union.js +86 -0
- package/dist/emit/java/models.d.ts +28 -0
- package/dist/emit/java/models.js +118 -0
- package/dist/emit/java/realtime.d.ts +50 -0
- package/dist/emit/java/realtime.js +69 -0
- package/dist/emit/java/sdk-client.d.ts +66 -0
- package/dist/emit/java/sdk-client.js +207 -0
- package/dist/emit/java/sdk-decl.d.ts +11 -0
- package/dist/emit/java/sdk-decl.js +63 -0
- package/dist/emit/java/sdk-errors.d.ts +13 -0
- package/dist/emit/java/sdk-errors.js +141 -0
- package/dist/emit/java/sdk-headers.d.ts +12 -0
- package/dist/emit/java/sdk-headers.js +74 -0
- package/dist/emit/java/sdk-mirror.d.ts +14 -0
- package/dist/emit/java/sdk-mirror.js +107 -0
- package/dist/emit/java/sdk-models.d.ts +16 -0
- package/dist/emit/java/sdk-models.js +68 -0
- package/dist/emit/java/sdk-op.d.ts +57 -0
- package/dist/emit/java/sdk-op.js +216 -0
- package/dist/emit/java/sdk-params.d.ts +38 -0
- package/dist/emit/java/sdk-params.js +133 -0
- package/dist/emit/java/sdk-plan.d.ts +52 -0
- package/dist/emit/java/sdk-plan.js +1 -0
- package/dist/emit/java/sdk-record.d.ts +16 -0
- package/dist/emit/java/sdk-record.js +99 -0
- package/dist/emit/java/sdk.d.ts +49 -0
- package/dist/emit/java/sdk.js +216 -0
- package/dist/emit/java/sse.d.ts +35 -0
- package/dist/emit/java/sse.js +57 -0
- package/dist/emit/java/ws.d.ts +27 -0
- package/dist/emit/java/ws.js +31 -0
- package/dist/emit/mcp/annotations.d.ts +15 -0
- package/dist/emit/mcp/annotations.js +15 -0
- package/dist/emit/mcp/files.d.ts +18 -0
- package/dist/emit/mcp/files.js +42 -0
- package/dist/emit/mcp/index.d.ts +3 -0
- package/dist/emit/mcp/index.js +3 -0
- package/dist/emit/mcp/literal.d.ts +2 -0
- package/dist/emit/mcp/literal.js +33 -0
- package/dist/emit/mcp/mounted.d.ts +21 -0
- package/dist/emit/mcp/mounted.js +89 -0
- package/dist/emit/mcp/output-schema.d.ts +18 -0
- package/dist/emit/mcp/output-schema.js +38 -0
- package/dist/emit/mcp/registry.d.ts +23 -0
- package/dist/emit/mcp/registry.js +83 -0
- package/dist/emit/mcp/runtime.d.ts +10 -0
- package/dist/emit/mcp/runtime.js +47 -0
- package/dist/emit/mcp/schema.d.ts +19 -0
- package/dist/emit/mcp/schema.js +88 -0
- package/dist/emit/mcp/server.d.ts +30 -0
- package/dist/emit/mcp/server.js +246 -0
- package/dist/emit/mcp/tools.d.ts +51 -0
- package/dist/emit/mcp/tools.js +153 -0
- package/dist/emit/python/errors.d.ts +8 -0
- package/dist/emit/python/errors.js +68 -0
- package/dist/emit/python/index.d.ts +1 -0
- package/dist/emit/python/index.js +1 -0
- package/dist/emit/python/realtime.d.ts +10 -0
- package/dist/emit/python/realtime.js +33 -0
- package/dist/emit/python/sdk-answer.d.ts +49 -0
- package/dist/emit/python/sdk-answer.js +89 -0
- package/dist/emit/python/sdk-body.d.ts +11 -0
- package/dist/emit/python/sdk-body.js +40 -0
- package/dist/emit/python/sdk-client.d.ts +36 -0
- package/dist/emit/python/sdk-client.js +163 -0
- package/dist/emit/python/sdk-doc.d.ts +9 -0
- package/dist/emit/python/sdk-doc.js +32 -0
- package/dist/emit/python/sdk-imports.d.ts +14 -0
- package/dist/emit/python/sdk-imports.js +38 -0
- package/dist/emit/python/sdk-method.d.ts +29 -0
- package/dist/emit/python/sdk-method.js +183 -0
- package/dist/emit/python/sdk-plan.d.ts +33 -0
- package/dist/emit/python/sdk-plan.js +1 -0
- package/dist/emit/python/sdk-pyproject.d.ts +27 -0
- package/dist/emit/python/sdk-pyproject.js +103 -0
- package/dist/emit/python/sdk.d.ts +22 -0
- package/dist/emit/python/sdk.js +154 -0
- package/dist/emit/python/sse.d.ts +12 -0
- package/dist/emit/python/sse.js +23 -0
- package/dist/emit/python/transport.d.ts +15 -0
- package/dist/emit/python/transport.js +60 -0
- package/dist/emit/python/types-dict.d.ts +31 -0
- package/dist/emit/python/types-dict.js +45 -0
- package/dist/emit/python/types-names.d.ts +16 -0
- package/dist/emit/python/types-names.js +52 -0
- package/dist/emit/python/types-union.d.ts +32 -0
- package/dist/emit/python/types-union.js +46 -0
- package/dist/emit/python/types.d.ts +36 -0
- package/dist/emit/python/types.js +128 -0
- package/dist/emit/python/ws.d.ts +14 -0
- package/dist/emit/python/ws.js +16 -0
- package/dist/emit/rust/errors.d.ts +7 -0
- package/dist/emit/rust/errors.js +107 -0
- package/dist/emit/rust/http.d.ts +13 -0
- package/dist/emit/rust/http.js +67 -0
- package/dist/emit/rust/index.d.ts +1 -0
- package/dist/emit/rust/index.js +1 -0
- package/dist/emit/rust/realtime.d.ts +11 -0
- package/dist/emit/rust/realtime.js +29 -0
- package/dist/emit/rust/sdk-body.d.ts +19 -0
- package/dist/emit/rust/sdk-body.js +53 -0
- package/dist/emit/rust/sdk-cargo.d.ts +43 -0
- package/dist/emit/rust/sdk-cargo.js +178 -0
- package/dist/emit/rust/sdk-client.d.ts +25 -0
- package/dist/emit/rust/sdk-client.js +108 -0
- package/dist/emit/rust/sdk-method.d.ts +15 -0
- package/dist/emit/rust/sdk-method.js +119 -0
- package/dist/emit/rust/sdk-opts.d.ts +58 -0
- package/dist/emit/rust/sdk-opts.js +117 -0
- package/dist/emit/rust/sdk-plan.d.ts +33 -0
- package/dist/emit/rust/sdk-plan.js +1 -0
- package/dist/emit/rust/sdk.d.ts +23 -0
- package/dist/emit/rust/sdk.js +111 -0
- package/dist/emit/rust/sse.d.ts +19 -0
- package/dist/emit/rust/sse.js +20 -0
- package/dist/emit/rust/types-enum.d.ts +13 -0
- package/dist/emit/rust/types-enum.js +62 -0
- package/dist/emit/rust/types-names.d.ts +19 -0
- package/dist/emit/rust/types-names.js +66 -0
- package/dist/emit/rust/types-struct.d.ts +21 -0
- package/dist/emit/rust/types-struct.js +59 -0
- package/dist/emit/rust/types-union.d.ts +24 -0
- package/dist/emit/rust/types-union.js +97 -0
- package/dist/emit/rust/types.d.ts +34 -0
- package/dist/emit/rust/types.js +105 -0
- package/dist/emit/rust/ws.d.ts +21 -0
- package/dist/emit/rust/ws.js +20 -0
- package/dist/emit/shared/escape.d.ts +55 -0
- package/dist/emit/shared/escape.js +144 -0
- package/dist/emit/shared/format.d.ts +24 -0
- package/dist/emit/shared/format.js +23 -0
- package/dist/emit/shared/gofmt.d.ts +3 -0
- package/dist/emit/shared/gofmt.js +26 -0
- package/dist/emit/shared/lang.d.ts +60 -0
- package/dist/emit/shared/lang.js +233 -0
- package/dist/emit/shared/literals.d.ts +4 -0
- package/dist/emit/shared/literals.js +31 -0
- package/dist/emit/shared/metadata.d.ts +106 -0
- package/dist/emit/shared/metadata.js +130 -0
- package/dist/emit/shared/mirror.d.ts +22 -0
- package/dist/emit/shared/mirror.js +26 -0
- package/dist/emit/shared/ruff.d.ts +3 -0
- package/dist/emit/shared/ruff.js +31 -0
- package/dist/emit/shared/rustfmt.d.ts +3 -0
- package/dist/emit/shared/rustfmt.js +32 -0
- package/dist/emit/shared/status-keys.d.ts +7 -0
- package/dist/emit/shared/status-keys.js +67 -0
- package/dist/emit/shared/type-emitter.d.ts +19 -0
- package/dist/emit/shared/type-emitter.js +100 -0
- package/dist/emit/ts/app-client.d.ts +4 -0
- package/dist/emit/ts/app-client.js +68 -0
- package/dist/emit/ts/http.d.ts +20 -0
- package/dist/emit/ts/http.js +74 -0
- package/dist/emit/ts/package.d.ts +36 -0
- package/dist/emit/ts/package.js +126 -0
- package/dist/emit/ts/route-tree.d.ts +68 -0
- package/dist/emit/ts/route-tree.js +240 -0
- package/dist/emit/ts/sdk-types-preamble.d.ts +14 -0
- package/dist/emit/ts/sdk-types-preamble.js +123 -0
- package/dist/emit/ts/sdk-types.d.ts +13 -0
- package/dist/emit/ts/sdk-types.js +213 -0
- package/dist/emit/ts/sdk.d.ts +21 -0
- package/dist/emit/ts/sdk.js +173 -0
- package/dist/emit/ts/service-map.d.ts +40 -0
- package/dist/emit/ts/service-map.js +171 -0
- package/dist/emit/ts/tanstack-query.d.ts +12 -0
- package/dist/emit/ts/tanstack-query.js +156 -0
- package/dist/emit/ts/type-gen.d.ts +26 -0
- package/dist/emit/ts/type-gen.js +255 -0
- package/dist/emit/ts/webhooks.d.ts +19 -0
- package/dist/emit/ts/webhooks.js +81 -0
- package/dist/extract/chain.d.ts +34 -0
- package/dist/extract/chain.js +84 -0
- package/dist/extract/extract.d.ts +41 -0
- package/dist/extract/extract.js +191 -0
- package/dist/extract/serialize.d.ts +34 -0
- package/dist/extract/serialize.js +295 -0
- package/dist/extract/walk.d.ts +47 -0
- package/dist/extract/walk.js +109 -0
- package/dist/gen/args.d.ts +28 -0
- package/dist/gen/args.js +133 -0
- package/dist/gen/formatters.d.ts +62 -0
- package/dist/gen/formatters.js +146 -0
- package/dist/gen/process.d.ts +13 -0
- package/dist/gen/process.js +35 -0
- package/dist/gen/shipped.d.ts +17 -0
- package/dist/gen/shipped.js +55 -0
- package/dist/gen/targets.d.ts +93 -0
- package/dist/gen/targets.js +171 -0
- package/dist/gen/write.d.ts +33 -0
- package/dist/gen/write.js +118 -0
- package/dist/index.d.ts +13 -0
- package/dist/index.js +15 -0
- package/dist/ir/build.d.ts +37 -0
- package/dist/ir/build.js +152 -0
- package/dist/ir/load.d.ts +11 -0
- package/dist/ir/load.js +112 -0
- package/dist/ir/model.d.ts +206 -0
- package/dist/ir/model.js +5 -0
- package/dist/ir/resolve-refs.d.ts +11 -0
- package/dist/ir/resolve-refs.js +66 -0
- package/dist/ir/resource-tree.d.ts +9 -0
- package/dist/ir/resource-tree.js +53 -0
- package/dist/ir/route-tree-intern.d.ts +18 -0
- package/dist/ir/route-tree-intern.js +174 -0
- package/dist/ir/schema.d.ts +11 -0
- package/dist/ir/schema.js +192 -0
- package/dist/ir/sdk-model.d.ts +86 -0
- package/dist/ir/sdk-model.js +204 -0
- package/dist/ir/slots.d.ts +42 -0
- package/dist/ir/slots.js +245 -0
- package/dist/runtime/cli/body.go +176 -0
- package/dist/runtime/cli/config.go +243 -0
- package/dist/runtime/cli/discovery.go +147 -0
- package/dist/runtime/cli/format.go +174 -0
- package/dist/runtime/cli/log.go +117 -0
- package/dist/runtime/cli/output.go +247 -0
- package/dist/runtime/cli/params.go +197 -0
- package/dist/runtime/cli/run.go +226 -0
- package/dist/runtime/cli/socket.go +60 -0
- package/dist/runtime/cli/stream.go +217 -0
- package/dist/runtime/cli/target.go +117 -0
- package/dist/runtime/csharp/Adapters.cs +183 -0
- package/dist/runtime/csharp/Auth.cs +56 -0
- package/dist/runtime/csharp/Body.cs +135 -0
- package/dist/runtime/csharp/Config.cs +161 -0
- package/dist/runtime/csharp/Envelope.cs +149 -0
- package/dist/runtime/csharp/Errors.cs +194 -0
- package/dist/runtime/csharp/Events.cs +155 -0
- package/dist/runtime/csharp/Exchange.cs +247 -0
- package/dist/runtime/csharp/Handler.cs +103 -0
- package/dist/runtime/csharp/Hooks.cs +128 -0
- package/dist/runtime/csharp/Invalidation.cs +102 -0
- package/dist/runtime/csharp/Json.cs +144 -0
- package/dist/runtime/csharp/Log.cs +48 -0
- package/dist/runtime/csharp/Operation.cs +33 -0
- package/dist/runtime/csharp/Path.cs +65 -0
- package/dist/runtime/csharp/Query.cs +72 -0
- package/dist/runtime/csharp/Realtime.cs +118 -0
- package/dist/runtime/csharp/RealtimeLoop.cs +236 -0
- package/dist/runtime/csharp/Redirect.cs +53 -0
- package/dist/runtime/csharp/Result.cs +57 -0
- package/dist/runtime/csharp/Sse.cs +122 -0
- package/dist/runtime/csharp/Stale.cs +151 -0
- package/dist/runtime/csharp/Transport.cs +143 -0
- package/dist/runtime/csharp/TransportLongPoll.cs +63 -0
- package/dist/runtime/csharp/TransportSse.cs +54 -0
- package/dist/runtime/csharp/TransportWs.cs +40 -0
- package/dist/runtime/csharp/Wire.cs +109 -0
- package/dist/runtime/csharp/Ws.cs +300 -0
- package/dist/runtime/csharp/WsDial.cs +127 -0
- package/dist/runtime/go/auth.go +127 -0
- package/dist/runtime/go/body.go +129 -0
- package/dist/runtime/go/config.go +75 -0
- package/dist/runtime/go/errors.go +185 -0
- package/dist/runtime/go/export.go +37 -0
- package/dist/runtime/go/hooks.go +53 -0
- package/dist/runtime/go/invalidation.go +112 -0
- package/dist/runtime/go/log.go +92 -0
- package/dist/runtime/go/nullable.go +64 -0
- package/dist/runtime/go/options.go +118 -0
- package/dist/runtime/go/path.go +156 -0
- package/dist/runtime/go/query.go +147 -0
- package/dist/runtime/go/realtime.go +239 -0
- package/dist/runtime/go/realtime_loop.go +208 -0
- package/dist/runtime/go/redirect.go +124 -0
- package/dist/runtime/go/request.go +222 -0
- package/dist/runtime/go/result.go +86 -0
- package/dist/runtime/go/sse.go +186 -0
- package/dist/runtime/go/stale.go +229 -0
- package/dist/runtime/go/stream.go +105 -0
- package/dist/runtime/go/transport.go +242 -0
- package/dist/runtime/go/transport_longpoll.go +121 -0
- package/dist/runtime/go/transport_sse.go +175 -0
- package/dist/runtime/go/ws.go +205 -0
- package/dist/runtime/java/Answer.java +107 -0
- package/dist/runtime/java/ApiException.java +110 -0
- package/dist/runtime/java/BinaryBody.java +36 -0
- package/dist/runtime/java/Body.java +105 -0
- package/dist/runtime/java/Call.java +23 -0
- package/dist/runtime/java/CallLog.java +51 -0
- package/dist/runtime/java/ClientConfig.java +233 -0
- package/dist/runtime/java/ConnectionState.java +12 -0
- package/dist/runtime/java/Credential.java +58 -0
- package/dist/runtime/java/Deadline.java +38 -0
- package/dist/runtime/java/Decode.java +181 -0
- package/dist/runtime/java/Envelope.java +141 -0
- package/dist/runtime/java/ErrorEnvelope.java +23 -0
- package/dist/runtime/java/EventStream.java +129 -0
- package/dist/runtime/java/Exchange.java +62 -0
- package/dist/runtime/java/FilePart.java +5 -0
- package/dist/runtime/java/Flight.java +306 -0
- package/dist/runtime/java/HoneyException.java +14 -0
- package/dist/runtime/java/Hooks.java +47 -0
- package/dist/runtime/java/Hops.java +133 -0
- package/dist/runtime/java/InvalidationConfig.java +73 -0
- package/dist/runtime/java/Json.java +23 -0
- package/dist/runtime/java/Keepalive.java +60 -0
- package/dist/runtime/java/LogEntry.java +14 -0
- package/dist/runtime/java/LongPollAdapter.java +68 -0
- package/dist/runtime/java/Operation.java +21 -0
- package/dist/runtime/java/Opt.java +121 -0
- package/dist/runtime/java/Pump.java +160 -0
- package/dist/runtime/java/RawResponse.java +48 -0
- package/dist/runtime/java/Realtime.java +152 -0
- package/dist/runtime/java/RealtimeLoop.java +371 -0
- package/dist/runtime/java/RedirectPolicy.java +13 -0
- package/dist/runtime/java/Redirects.java +126 -0
- package/dist/runtime/java/RequestContext.java +78 -0
- package/dist/runtime/java/RequestHook.java +9 -0
- package/dist/runtime/java/RequestOptions.java +91 -0
- package/dist/runtime/java/ResponseContext.java +70 -0
- package/dist/runtime/java/ResponseHook.java +12 -0
- package/dist/runtime/java/Result.java +32 -0
- package/dist/runtime/java/ResumableConnection.java +165 -0
- package/dist/runtime/java/SdkException.java +11 -0
- package/dist/runtime/java/Socket.java +301 -0
- package/dist/runtime/java/Sse.java +171 -0
- package/dist/runtime/java/SseAdapter.java +61 -0
- package/dist/runtime/java/SseEvent.java +10 -0
- package/dist/runtime/java/StaleMeta.java +16 -0
- package/dist/runtime/java/StaleTracker.java +287 -0
- package/dist/runtime/java/Transport.java +16 -0
- package/dist/runtime/java/TransportAdapter.java +14 -0
- package/dist/runtime/java/TransportConnection.java +15 -0
- package/dist/runtime/java/TransportKind.java +12 -0
- package/dist/runtime/java/TransportMessage.java +9 -0
- package/dist/runtime/java/TransportOptions.java +138 -0
- package/dist/runtime/java/TypedWebSocket.java +83 -0
- package/dist/runtime/java/UrlPath.java +49 -0
- package/dist/runtime/java/UrlQuery.java +99 -0
- package/dist/runtime/java/WsAdapter.java +52 -0
- package/dist/runtime/java/WsClose.java +47 -0
- package/dist/runtime/java/WsDial.java +148 -0
- package/dist/runtime/java/WsMessage.java +18 -0
- package/dist/runtime/mcp/call.ts +167 -0
- package/dist/runtime/mcp/files.ts +183 -0
- package/dist/runtime/mcp/guard.ts +176 -0
- package/dist/runtime/mcp/http.ts +159 -0
- package/dist/runtime/mcp/jsonrpc.ts +50 -0
- package/dist/runtime/mcp/listen.ts +76 -0
- package/dist/runtime/mcp/mount.ts +123 -0
- package/dist/runtime/mcp/protocol.ts +219 -0
- package/dist/runtime/mcp/reader.ts +57 -0
- package/dist/runtime/mcp/result.ts +85 -0
- package/dist/runtime/mcp/stdio.ts +79 -0
- package/dist/runtime/mcp/stream.ts +62 -0
- package/dist/runtime/python/__init__.py +2 -0
- package/dist/runtime/python/auth.py +67 -0
- package/dist/runtime/python/body.py +83 -0
- package/dist/runtime/python/config.py +139 -0
- package/dist/runtime/python/errors.py +213 -0
- package/dist/runtime/python/events.py +152 -0
- package/dist/runtime/python/exchange.py +298 -0
- package/dist/runtime/python/hooks.py +86 -0
- package/dist/runtime/python/invalidation.py +57 -0
- package/dist/runtime/python/log.py +60 -0
- package/dist/runtime/python/operation.py +25 -0
- package/dist/runtime/python/path.py +41 -0
- package/dist/runtime/python/query.py +48 -0
- package/dist/runtime/python/realtime.py +244 -0
- package/dist/runtime/python/redirect.py +93 -0
- package/dist/runtime/python/result.py +58 -0
- package/dist/runtime/python/send_async.py +189 -0
- package/dist/runtime/python/send_sync.py +105 -0
- package/dist/runtime/python/sse.py +81 -0
- package/dist/runtime/python/stale.py +94 -0
- package/dist/runtime/python/transport.py +157 -0
- package/dist/runtime/python/transport_longpoll.py +60 -0
- package/dist/runtime/python/transport_sse.py +60 -0
- package/dist/runtime/python/transport_ws.py +57 -0
- package/dist/runtime/python/ws.py +276 -0
- package/dist/runtime/rust/Cargo.lock +1763 -0
- package/dist/runtime/rust/answer.rs +120 -0
- package/dist/runtime/rust/auth.rs +80 -0
- package/dist/runtime/rust/body.rs +150 -0
- package/dist/runtime/rust/call.rs +200 -0
- package/dist/runtime/rust/config.rs +254 -0
- package/dist/runtime/rust/envelope.rs +84 -0
- package/dist/runtime/rust/errors.rs +235 -0
- package/dist/runtime/rust/events.rs +177 -0
- package/dist/runtime/rust/exchange.rs +287 -0
- package/dist/runtime/rust/hooks.rs +63 -0
- package/dist/runtime/rust/invalidation.rs +84 -0
- package/dist/runtime/rust/log.rs +88 -0
- package/dist/runtime/rust/nullable.rs +13 -0
- package/dist/runtime/rust/path.rs +83 -0
- package/dist/runtime/rust/query.rs +84 -0
- package/dist/runtime/rust/realtime.rs +182 -0
- package/dist/runtime/rust/realtime_loop.rs +177 -0
- package/dist/runtime/rust/redirect.rs +121 -0
- package/dist/runtime/rust/request.rs +178 -0
- package/dist/runtime/rust/result.rs +101 -0
- package/dist/runtime/rust/sse.rs +104 -0
- package/dist/runtime/rust/stale.rs +209 -0
- package/dist/runtime/rust/transport.rs +221 -0
- package/dist/runtime/rust/transport_longpoll.rs +108 -0
- package/dist/runtime/rust/transport_sse.rs +91 -0
- package/dist/runtime/rust/transport_ws.rs +75 -0
- package/dist/runtime/rust/ws.rs +322 -0
- package/dist/runtime/ts/app-types.ts +200 -0
- package/dist/runtime/ts/app.ts +104 -0
- package/dist/runtime/ts/config.ts +124 -0
- package/dist/runtime/ts/defaults.ts +48 -0
- package/dist/runtime/ts/error.ts +113 -0
- package/dist/runtime/ts/hooks.ts +92 -0
- package/dist/runtime/ts/http.ts +228 -0
- package/dist/runtime/ts/media-type.ts +36 -0
- package/dist/runtime/ts/path.ts +152 -0
- package/dist/runtime/ts/realtime-connection.ts +296 -0
- package/dist/runtime/ts/realtime-transports.ts +149 -0
- package/dist/runtime/ts/realtime.ts +293 -0
- package/dist/runtime/ts/redirect-policy.ts +17 -0
- package/dist/runtime/ts/redirects.ts +74 -0
- package/dist/runtime/ts/request.ts +239 -0
- package/dist/runtime/ts/response.ts +219 -0
- package/dist/runtime/ts/sdk-realtime.ts +10 -0
- package/dist/runtime/ts/sdk-sse.ts +55 -0
- package/dist/runtime/ts/sdk-ws.ts +21 -0
- package/dist/runtime/ts/sdk.ts +242 -0
- package/dist/runtime/ts/sse.ts +175 -0
- package/dist/runtime/ts/stale.ts +137 -0
- package/dist/runtime/ts/stream.ts +87 -0
- package/dist/runtime/ts/webhook.ts +116 -0
- package/dist/runtime/ts/ws.ts +155 -0
- package/dist/runtime/ts-tanstack-query/invalidate.ts +152 -0
- package/dist/runtime/ts-tanstack-query/query.ts +261 -0
- package/package.json +84 -5
|
@@ -0,0 +1,287 @@
|
|
|
1
|
+
// @generated by honey. DO NOT EDIT.
|
|
2
|
+
package honey.runtime;
|
|
3
|
+
|
|
4
|
+
import java.util.ArrayList;
|
|
5
|
+
import java.util.Collections;
|
|
6
|
+
import java.util.HashSet;
|
|
7
|
+
import java.util.LinkedHashMap;
|
|
8
|
+
import java.util.List;
|
|
9
|
+
import java.util.Map;
|
|
10
|
+
import java.util.Set;
|
|
11
|
+
|
|
12
|
+
/**
|
|
13
|
+
* A client's stale view (contract 47 section 5.7): a 2xx mutation marks its {@code x-invalidate}
|
|
14
|
+
* targets stale for the stale time, and a read through one reports it and clears it. Off without a
|
|
15
|
+
* config or at a zero stale time. The clock is monotonic. Entries sit in mark order, so the lapse
|
|
16
|
+
* and the eviction read from the front; an exact key is one hash probe and only the placeholder
|
|
17
|
+
* targets are scanned, which is C#'s lookup.
|
|
18
|
+
*/
|
|
19
|
+
final class StaleTracker {
|
|
20
|
+
private final long window;
|
|
21
|
+
private final int maxEntries;
|
|
22
|
+
private final int maxSources;
|
|
23
|
+
private final Map<String, Entry> entries = new LinkedHashMap<>();
|
|
24
|
+
private final Set<String> patterns = new HashSet<>();
|
|
25
|
+
private long seq;
|
|
26
|
+
|
|
27
|
+
StaleTracker(InvalidationConfig config) {
|
|
28
|
+
this.window = config == null ? 0 : config.staleTime().toNanos();
|
|
29
|
+
this.maxEntries = config == null ? 1 : Math.max(config.staleMaxEntries(), 1);
|
|
30
|
+
this.maxSources = config == null ? 1 : Math.max(config.maxSourcesPerTarget(), 1);
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/** The read's stale view before it is sent: its selector, and the mutations that stale it. */
|
|
34
|
+
synchronized StaleMeta begin(String method, String path) {
|
|
35
|
+
if (window <= 0) {
|
|
36
|
+
return StaleMeta.NONE;
|
|
37
|
+
}
|
|
38
|
+
String selector = method + " " + path;
|
|
39
|
+
expire();
|
|
40
|
+
List<String> by = new ArrayList<>();
|
|
41
|
+
for (String key : readBy(selector)) {
|
|
42
|
+
for (String source : entries.get(key).by) {
|
|
43
|
+
if (!by.contains(source)) {
|
|
44
|
+
by.add(source);
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
return new StaleMeta(selector, !by.isEmpty(), by, seq);
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/**
|
|
52
|
+
* Settles a call's answer: a 2xx marks {@code targets} (none marks nothing), and a read that was
|
|
53
|
+
* stale clears the stale targets it named that were marked before it began.
|
|
54
|
+
*/
|
|
55
|
+
synchronized void settle(StaleMeta meta, String[] targets, Map<String, String> values) {
|
|
56
|
+
if (window <= 0) {
|
|
57
|
+
return;
|
|
58
|
+
}
|
|
59
|
+
if (targets.length > 0) {
|
|
60
|
+
mark(meta, targets, values);
|
|
61
|
+
}
|
|
62
|
+
if (meta.isStale()) {
|
|
63
|
+
for (String key : readBy(meta.selector())) {
|
|
64
|
+
if (entries.get(key).seq <= meta.seq()) {
|
|
65
|
+
drop(key);
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
private void mark(StaleMeta meta, String[] targets, Map<String, String> values) {
|
|
72
|
+
seq++;
|
|
73
|
+
long until = System.nanoTime() + window;
|
|
74
|
+
for (String target : targets) {
|
|
75
|
+
String key = keyOf(target, values);
|
|
76
|
+
Entry entry = entries.remove(key);
|
|
77
|
+
if (entry == null) {
|
|
78
|
+
entry = new Entry();
|
|
79
|
+
}
|
|
80
|
+
entry.seq = seq;
|
|
81
|
+
entry.until = until;
|
|
82
|
+
if (!entry.by.contains(meta.selector()) && entry.by.size() < maxSources) {
|
|
83
|
+
entry.by.add(meta.selector());
|
|
84
|
+
}
|
|
85
|
+
entries.put(key, entry);
|
|
86
|
+
if (hasPlaceholders(key.substring(key.indexOf(' ') + 1))) {
|
|
87
|
+
patterns.add(key);
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
if (entries.size() > maxEntries) {
|
|
91
|
+
expire();
|
|
92
|
+
while (entries.size() > Math.max(maxEntries / 2, 1)) {
|
|
93
|
+
drop(firstKey());
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/**
|
|
99
|
+
* The sorted keys a selector reads: every placeholder target that matches it, and its exact key
|
|
100
|
+
* when marked.
|
|
101
|
+
*/
|
|
102
|
+
private List<String> readBy(String selector) {
|
|
103
|
+
int space = selector.indexOf(' ');
|
|
104
|
+
String method = selector.substring(0, space);
|
|
105
|
+
String path = selector.substring(space + 1);
|
|
106
|
+
List<String> keys = new ArrayList<>();
|
|
107
|
+
for (String key : patterns) {
|
|
108
|
+
if (key.startsWith(method + " ") && matches(path, key.substring(method.length() + 1))) {
|
|
109
|
+
keys.add(key);
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
if (entries.containsKey(selector) && !keys.contains(selector)) {
|
|
113
|
+
keys.add(selector);
|
|
114
|
+
}
|
|
115
|
+
Collections.sort(keys);
|
|
116
|
+
return keys;
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
private void expire() {
|
|
120
|
+
long now = System.nanoTime();
|
|
121
|
+
while (!entries.isEmpty()) {
|
|
122
|
+
String oldest = firstKey();
|
|
123
|
+
if (now - entries.get(oldest).until < 0) {
|
|
124
|
+
break;
|
|
125
|
+
}
|
|
126
|
+
drop(oldest);
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
private void drop(String key) {
|
|
131
|
+
entries.remove(key);
|
|
132
|
+
patterns.remove(key);
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
private String firstKey() {
|
|
136
|
+
return entries.keySet().iterator().next();
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
/**
|
|
140
|
+
* A target as its key: its path's placeholders filled from {@code values}, or the target as it is
|
|
141
|
+
* when none fill.
|
|
142
|
+
*/
|
|
143
|
+
private static String keyOf(String target, Map<String, String> values) {
|
|
144
|
+
int space = target.indexOf(' ');
|
|
145
|
+
if (space < 0) {
|
|
146
|
+
return target;
|
|
147
|
+
}
|
|
148
|
+
String path = expand(target.substring(space + 1), values);
|
|
149
|
+
return path == null ? target : target.substring(0, space) + " " + path;
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
private static String expand(String template, Map<String, String> values) {
|
|
153
|
+
List<String> segments = new ArrayList<>();
|
|
154
|
+
for (String segment : template.split("/", -1)) {
|
|
155
|
+
String colon = colonName(segment);
|
|
156
|
+
if (colon != null) {
|
|
157
|
+
String value = valueOf(colon, values);
|
|
158
|
+
if (value == null) {
|
|
159
|
+
return null;
|
|
160
|
+
}
|
|
161
|
+
segments.add(value);
|
|
162
|
+
continue;
|
|
163
|
+
}
|
|
164
|
+
String text = expandSegment(segment, values);
|
|
165
|
+
if (text == null) {
|
|
166
|
+
return null;
|
|
167
|
+
}
|
|
168
|
+
segments.add(text);
|
|
169
|
+
}
|
|
170
|
+
return String.join("/", segments);
|
|
171
|
+
}
|
|
172
|
+
|
|
173
|
+
/** One segment's braces filled; null when a named value is missing. */
|
|
174
|
+
private static String expandSegment(String segment, Map<String, String> values) {
|
|
175
|
+
StringBuilder text = new StringBuilder();
|
|
176
|
+
String part = segment;
|
|
177
|
+
for (int open = part.indexOf('{'); open >= 0; open = part.indexOf('{')) {
|
|
178
|
+
int close = part.indexOf('}', open);
|
|
179
|
+
String name = close < 0 ? "" : part.substring(open + 1, close);
|
|
180
|
+
if (name.isEmpty() || name.contains("{")) {
|
|
181
|
+
text.append(part, 0, open + 1);
|
|
182
|
+
part = part.substring(open + 1);
|
|
183
|
+
continue;
|
|
184
|
+
}
|
|
185
|
+
String value = valueOf(name, values);
|
|
186
|
+
if (value == null) {
|
|
187
|
+
return null;
|
|
188
|
+
}
|
|
189
|
+
text.append(part, 0, open).append(value);
|
|
190
|
+
part = part.substring(close + 1);
|
|
191
|
+
}
|
|
192
|
+
return text.append(part).toString();
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
/** A named value as one encoded segment; null when it is absent or not a segment. */
|
|
196
|
+
private static String valueOf(String name, Map<String, String> values) {
|
|
197
|
+
String value = values.get(name);
|
|
198
|
+
if (value == null || value.isEmpty() || value.equals(".") || value.equals("..")) {
|
|
199
|
+
return null;
|
|
200
|
+
}
|
|
201
|
+
StringBuilder encoded = new StringBuilder();
|
|
202
|
+
UrlQuery.escape(encoded, value, "-_.!~*'()");
|
|
203
|
+
return encoded.toString();
|
|
204
|
+
}
|
|
205
|
+
|
|
206
|
+
private static boolean hasPlaceholders(String path) {
|
|
207
|
+
for (String part : path.split("/", -1)) {
|
|
208
|
+
if (colonName(part) != null || (part.contains("{") && part.contains("}"))) {
|
|
209
|
+
return true;
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
return false;
|
|
213
|
+
}
|
|
214
|
+
|
|
215
|
+
private static boolean matches(String path, String pattern) {
|
|
216
|
+
if (path.equals(pattern)) {
|
|
217
|
+
return true;
|
|
218
|
+
}
|
|
219
|
+
String[] got = path.split("/", -1);
|
|
220
|
+
String[] want = pattern.split("/", -1);
|
|
221
|
+
if (got.length != want.length) {
|
|
222
|
+
return false;
|
|
223
|
+
}
|
|
224
|
+
for (int i = 0; i < got.length; i++) {
|
|
225
|
+
boolean same =
|
|
226
|
+
colonName(want[i]) != null ? !got[i].isEmpty() : segmentMatches(got[i], want[i]);
|
|
227
|
+
if (!same) {
|
|
228
|
+
return false;
|
|
229
|
+
}
|
|
230
|
+
}
|
|
231
|
+
return true;
|
|
232
|
+
}
|
|
233
|
+
|
|
234
|
+
private static boolean segmentMatches(String text, String pattern) {
|
|
235
|
+
int open = pattern.indexOf('{');
|
|
236
|
+
int close = open < 0 ? -1 : pattern.indexOf('}', open);
|
|
237
|
+
if (close < 0) {
|
|
238
|
+
return text.equals(pattern);
|
|
239
|
+
}
|
|
240
|
+
String head = pattern.substring(0, open);
|
|
241
|
+
String rest = pattern.substring(close + 1);
|
|
242
|
+
if (!text.startsWith(head)) {
|
|
243
|
+
return false;
|
|
244
|
+
}
|
|
245
|
+
String tail = text.substring(head.length());
|
|
246
|
+
for (int i = 1; i <= tail.length(); i++) {
|
|
247
|
+
if (segmentMatches(tail.substring(i), rest)) {
|
|
248
|
+
return true;
|
|
249
|
+
}
|
|
250
|
+
}
|
|
251
|
+
return false;
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
/** The name of a {@code :name} segment, or null. */
|
|
255
|
+
private static String colonName(String part) {
|
|
256
|
+
if (part.length() < 2
|
|
257
|
+
|| part.charAt(0) != ':'
|
|
258
|
+
|| !(isLetter(part.charAt(1)) || part.charAt(1) == '_')) {
|
|
259
|
+
return null;
|
|
260
|
+
}
|
|
261
|
+
for (int i = 1; i < part.length(); i++) {
|
|
262
|
+
char c = part.charAt(i);
|
|
263
|
+
if (!(isLetter(c) || isDigit(c) || c == '_')) {
|
|
264
|
+
return null;
|
|
265
|
+
}
|
|
266
|
+
}
|
|
267
|
+
return part.substring(1);
|
|
268
|
+
}
|
|
269
|
+
|
|
270
|
+
private static boolean isLetter(char c) {
|
|
271
|
+
return (c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z');
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
private static boolean isDigit(char c) {
|
|
275
|
+
return c >= '0' && c <= '9';
|
|
276
|
+
}
|
|
277
|
+
|
|
278
|
+
/**
|
|
279
|
+
* One stale key: the last mark's sequence and its lapse instant (monotonic), and the mutations
|
|
280
|
+
* that marked it.
|
|
281
|
+
*/
|
|
282
|
+
private static final class Entry {
|
|
283
|
+
long seq;
|
|
284
|
+
long until;
|
|
285
|
+
final List<String> by = new ArrayList<>();
|
|
286
|
+
}
|
|
287
|
+
}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
// @generated by honey. DO NOT EDIT.
|
|
2
|
+
package honey.runtime;
|
|
3
|
+
|
|
4
|
+
import java.net.URI;
|
|
5
|
+
import java.net.http.HttpClient;
|
|
6
|
+
|
|
7
|
+
/** The HTTP transport: one client, built once, which never follows a redirect on its own. */
|
|
8
|
+
final class Transport {
|
|
9
|
+
private final URI baseUrl;
|
|
10
|
+
private final HttpClient http;
|
|
11
|
+
|
|
12
|
+
Transport(URI baseUrl) {
|
|
13
|
+
this.baseUrl = baseUrl;
|
|
14
|
+
this.http = HttpClient.newBuilder().followRedirects(HttpClient.Redirect.NEVER).build();
|
|
15
|
+
}
|
|
16
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
// @generated by honey. DO NOT EDIT.
|
|
2
|
+
package honey.runtime;
|
|
3
|
+
|
|
4
|
+
/** A transport a realtime connection opens over: one of a call's defaults, or a caller's own. */
|
|
5
|
+
public interface TransportAdapter {
|
|
6
|
+
/** The adapter's name. */
|
|
7
|
+
String name();
|
|
8
|
+
|
|
9
|
+
/** What it opens. */
|
|
10
|
+
TransportKind kind();
|
|
11
|
+
|
|
12
|
+
/** Opens a connection to {@code url} resuming from {@code options}' cursor. */
|
|
13
|
+
TransportConnection connect(String url, TransportOptions options);
|
|
14
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
// @generated by honey. DO NOT EDIT.
|
|
2
|
+
package honey.runtime;
|
|
3
|
+
|
|
4
|
+
/** One open transport; a receive answering null means it ended. */
|
|
5
|
+
public interface TransportConnection extends AutoCloseable {
|
|
6
|
+
/** The next message; null once the transport ended. */
|
|
7
|
+
TransportMessage receive();
|
|
8
|
+
|
|
9
|
+
/** Sends {@code text} over the transport. */
|
|
10
|
+
void send(String text);
|
|
11
|
+
|
|
12
|
+
/** Closes the transport. */
|
|
13
|
+
@Override
|
|
14
|
+
void close();
|
|
15
|
+
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
// @generated by honey. DO NOT EDIT.
|
|
2
|
+
package honey.runtime;
|
|
3
|
+
|
|
4
|
+
/** What a realtime connection opens over. */
|
|
5
|
+
public enum TransportKind {
|
|
6
|
+
/** A WebSocket. */
|
|
7
|
+
WS,
|
|
8
|
+
/** A server-sent event stream. */
|
|
9
|
+
SSE,
|
|
10
|
+
/** One GET per message. */
|
|
11
|
+
LONG_POLL
|
|
12
|
+
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
// @generated by honey. DO NOT EDIT.
|
|
2
|
+
package honey.runtime;
|
|
3
|
+
|
|
4
|
+
import java.time.Duration;
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* One message as a transport read it: its text, and an SSE event's id and retry (null when unset).
|
|
8
|
+
*/
|
|
9
|
+
public record TransportMessage(String text, String id, Duration retry) {}
|
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
// @generated by honey. DO NOT EDIT.
|
|
2
|
+
package honey.runtime;
|
|
3
|
+
|
|
4
|
+
import java.time.Duration;
|
|
5
|
+
import java.util.List;
|
|
6
|
+
import tools.jackson.databind.JsonNode;
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* A realtime connection's resume cursor, advanced past each message it delivers, its subprotocols
|
|
10
|
+
* and its reconnect policy.
|
|
11
|
+
*/
|
|
12
|
+
public final class TransportOptions {
|
|
13
|
+
private volatile String lastEventId;
|
|
14
|
+
private volatile String reconnectToken;
|
|
15
|
+
private final List<String> protocols;
|
|
16
|
+
private final int maxReconnectAttempts;
|
|
17
|
+
private final Duration reconnectDelay;
|
|
18
|
+
|
|
19
|
+
private TransportOptions(Builder b) {
|
|
20
|
+
this.lastEventId = b.lastEventId;
|
|
21
|
+
this.reconnectToken = b.reconnectToken;
|
|
22
|
+
this.protocols = b.protocols == null ? List.of() : List.copyOf(b.protocols);
|
|
23
|
+
this.maxReconnectAttempts = b.maxReconnectAttempts == null ? 5 : b.maxReconnectAttempts;
|
|
24
|
+
this.reconnectDelay = b.reconnectDelay == null ? Duration.ofSeconds(1) : b.reconnectDelay;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
public static Builder builder() {
|
|
28
|
+
return new Builder();
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
static TransportOptions of(
|
|
32
|
+
String lastEventId,
|
|
33
|
+
String reconnectToken,
|
|
34
|
+
List<String> protocols,
|
|
35
|
+
java.lang.Integer maxReconnectAttempts,
|
|
36
|
+
Duration reconnectDelay) {
|
|
37
|
+
return builder()
|
|
38
|
+
.lastEventId(lastEventId)
|
|
39
|
+
.reconnectToken(reconnectToken)
|
|
40
|
+
.protocols(protocols)
|
|
41
|
+
.maxReconnectAttempts(maxReconnectAttempts)
|
|
42
|
+
.reconnectDelay(reconnectDelay)
|
|
43
|
+
.build();
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
/** The last event id delivered: sent as last_event_id, or as Last-Event-ID on an event stream. */
|
|
47
|
+
public String lastEventId() {
|
|
48
|
+
return lastEventId;
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/** The last reconnect token delivered: sent as reconnect_token. */
|
|
52
|
+
public String reconnectToken() {
|
|
53
|
+
return reconnectToken;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/** The subprotocols a WebSocket dial offers. */
|
|
57
|
+
public List<String> protocols() {
|
|
58
|
+
return protocols;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/** The reconnects in a row before the connection gives up. */
|
|
62
|
+
public int maxReconnectAttempts() {
|
|
63
|
+
return maxReconnectAttempts;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/** The first reconnect's base delay, doubled per attempt up to 30 s; an SSE retry replaces it. */
|
|
67
|
+
public Duration reconnectDelay() {
|
|
68
|
+
return reconnectDelay;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/**
|
|
72
|
+
* Past a delivered message: its SSE id, else the payload's id or last_event_id (a string or an
|
|
73
|
+
* integer), and its reconnect_token.
|
|
74
|
+
*/
|
|
75
|
+
void advance(String id, JsonNode payload) {
|
|
76
|
+
JsonNode found = payload != null && payload.isObject() ? payload : null;
|
|
77
|
+
String cursor = id == null || id.isEmpty() ? cursorOf(found) : id;
|
|
78
|
+
if (cursor != null && !cursor.isEmpty()) {
|
|
79
|
+
lastEventId = cursor;
|
|
80
|
+
}
|
|
81
|
+
JsonNode token = found == null ? null : found.get("reconnect_token");
|
|
82
|
+
if (token != null && token.isString() && !token.asString().isEmpty()) {
|
|
83
|
+
reconnectToken = token.asString();
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
private static String cursorOf(JsonNode found) {
|
|
88
|
+
JsonNode at =
|
|
89
|
+
found == null ? null : found.has("id") ? found.get("id") : found.get("last_event_id");
|
|
90
|
+
if (at == null) {
|
|
91
|
+
return null;
|
|
92
|
+
}
|
|
93
|
+
if (at.isString()) {
|
|
94
|
+
return at.asString();
|
|
95
|
+
}
|
|
96
|
+
return at.isIntegralNumber() && at.canConvertToLong() ? String.valueOf(at.asLong()) : null;
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
/** A builder: every field optional; protocols none, 5 attempts and 1 s by default. */
|
|
100
|
+
public static final class Builder {
|
|
101
|
+
private String lastEventId;
|
|
102
|
+
private String reconnectToken;
|
|
103
|
+
private List<String> protocols;
|
|
104
|
+
private java.lang.Integer maxReconnectAttempts;
|
|
105
|
+
private Duration reconnectDelay;
|
|
106
|
+
|
|
107
|
+
private Builder() {}
|
|
108
|
+
|
|
109
|
+
public Builder lastEventId(String value) {
|
|
110
|
+
this.lastEventId = value;
|
|
111
|
+
return this;
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
public Builder reconnectToken(String value) {
|
|
115
|
+
this.reconnectToken = value;
|
|
116
|
+
return this;
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
public Builder protocols(List<String> value) {
|
|
120
|
+
this.protocols = value;
|
|
121
|
+
return this;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
public Builder maxReconnectAttempts(java.lang.Integer value) {
|
|
125
|
+
this.maxReconnectAttempts = value;
|
|
126
|
+
return this;
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
public Builder reconnectDelay(Duration value) {
|
|
130
|
+
this.reconnectDelay = value;
|
|
131
|
+
return this;
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
public TransportOptions build() {
|
|
135
|
+
return new TransportOptions(this);
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
}
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
// @generated by honey. DO NOT EDIT.
|
|
2
|
+
package honey.runtime;
|
|
3
|
+
|
|
4
|
+
import java.nio.ByteBuffer;
|
|
5
|
+
import java.util.function.Consumer;
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* An open WebSocket. {@link #receive()} reads the next whole message: nothing reads in the
|
|
9
|
+
* background, so a socket no one receives from asks the server for nothing more, and onMessage
|
|
10
|
+
* fires as receive delivers a message, on the receiving thread. The socket's end, the server's
|
|
11
|
+
* close (echoed with its code and reason), a drop, a message over 16 MiB (closed 1008), a keepalive
|
|
12
|
+
* ping unanswered for 20 s, or {@link #close()}, fires exactly one of onClosed or onError, once; a
|
|
13
|
+
* throwing handler is ignored. An interrupt of the reading thread closes it 1000. Close it, or open
|
|
14
|
+
* it in try-with-resources. Its dial runs no onRequest or onResponse hook, and a refused
|
|
15
|
+
* handshake's 401 is its error, with no onAuthExpired refresh.
|
|
16
|
+
*/
|
|
17
|
+
public final class TypedWebSocket implements AutoCloseable {
|
|
18
|
+
private final Socket socket;
|
|
19
|
+
|
|
20
|
+
TypedWebSocket(Socket socket) {
|
|
21
|
+
this.socket = socket;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
/** The next whole message, null once the socket ended; an end's error is thrown once. */
|
|
25
|
+
public WsMessage receive() {
|
|
26
|
+
return socket.receive();
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
/** Sends {@code text} as one text message. */
|
|
30
|
+
public void send(String text) {
|
|
31
|
+
socket.send(ws -> ws.sendText(text, true));
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/** Sends {@code data} as one binary message. */
|
|
35
|
+
public void send(byte[] data) {
|
|
36
|
+
socket.send(ws -> ws.sendBinary(ByteBuffer.wrap(data), true));
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
/** Sends {@code value} as its JSON text, through the SDK's mapper. */
|
|
40
|
+
public void sendJson(Object value) {
|
|
41
|
+
send(Json.MAPPER.writeValueAsString(value));
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/** Closes 1000 with no reason; on an ended socket it does nothing. */
|
|
45
|
+
@Override
|
|
46
|
+
public void close() {
|
|
47
|
+
close(1000, "");
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
/**
|
|
51
|
+
* Closes with {@code status} and {@code reason}, cut to 123 UTF-8 bytes; a close during a send in
|
|
52
|
+
* flight aborts the socket. On an ended socket it does nothing.
|
|
53
|
+
*/
|
|
54
|
+
public void close(int status, String reason) {
|
|
55
|
+
socket.close(status, reason);
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/** The server's close, null unless the server closed the socket. */
|
|
59
|
+
public WsClose closedBy() {
|
|
60
|
+
return socket.closedBy;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/** The subprotocol the server chose, null for none. */
|
|
64
|
+
public String subprotocol() {
|
|
65
|
+
String chosen = socket.ws.getSubprotocol();
|
|
66
|
+
return chosen == null || chosen.isEmpty() ? null : chosen;
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
/** Runs {@code handler} on each message as receive delivers it. */
|
|
70
|
+
public void onMessage(Consumer<WsMessage> handler) {
|
|
71
|
+
socket.onMessage.add(handler);
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/** Runs {@code handler} once when the socket closes cleanly. */
|
|
75
|
+
public void onClosed(Consumer<WsClose> handler) {
|
|
76
|
+
socket.onClosed.add(handler);
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
/** Runs {@code handler} once when the socket ends in an error. */
|
|
80
|
+
public void onError(Consumer<java.lang.Exception> handler) {
|
|
81
|
+
socket.onError.add(handler);
|
|
82
|
+
}
|
|
83
|
+
}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
// @generated by honey. DO NOT EDIT.
|
|
2
|
+
package honey.runtime;
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* Expands a path template: each param one percent-encoded segment, refused when no segment can hold
|
|
6
|
+
* it.
|
|
7
|
+
*/
|
|
8
|
+
final class UrlPath {
|
|
9
|
+
private UrlPath() {}
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* {@code template} with each {@code {name}} replaced by its value from {@code values}, in {@code
|
|
13
|
+
* names} order.
|
|
14
|
+
*/
|
|
15
|
+
static String expand(String template, String[] names, String[] values) {
|
|
16
|
+
StringBuilder path = new StringBuilder();
|
|
17
|
+
int from = 0;
|
|
18
|
+
for (int open = template.indexOf('{'); open >= 0; open = template.indexOf('{', from)) {
|
|
19
|
+
int close = template.indexOf('}', open + 1);
|
|
20
|
+
if (close < 0) {
|
|
21
|
+
break;
|
|
22
|
+
}
|
|
23
|
+
String name = template.substring(open + 1, close);
|
|
24
|
+
if (name.isEmpty() || name.contains("{")) {
|
|
25
|
+
path.append(template, from, open + 1);
|
|
26
|
+
from = open + 1;
|
|
27
|
+
continue;
|
|
28
|
+
}
|
|
29
|
+
path.append(template, from, open);
|
|
30
|
+
UrlQuery.escape(path, value(name, names, values), "-_.!~*'()");
|
|
31
|
+
from = close + 1;
|
|
32
|
+
}
|
|
33
|
+
return path.append(template.substring(from)).toString();
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
private static String value(String name, String[] names, String[] values) {
|
|
37
|
+
String value = null;
|
|
38
|
+
for (int i = 0; i < names.length; i++) {
|
|
39
|
+
if (names[i].equals(name)) {
|
|
40
|
+
value = values[i];
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
if (value == null || value.isEmpty() || value.equals(".") || value.equals("..")) {
|
|
44
|
+
throw new PathParamException(
|
|
45
|
+
"path param " + name + ": \"" + value + "\" is not a path segment");
|
|
46
|
+
}
|
|
47
|
+
return value;
|
|
48
|
+
}
|
|
49
|
+
}
|