@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
package/dist/ir/slots.js
ADDED
|
@@ -0,0 +1,245 @@
|
|
|
1
|
+
import { schemaToIR } from "./schema.js";
|
|
2
|
+
import { compareCodeUnits } from "../emit/shared/lang.js";
|
|
3
|
+
/** Splits an OpenAPI path template into literal text and `{param}` pieces. */
|
|
4
|
+
export function parseOpenApiPath(path) {
|
|
5
|
+
const out = [];
|
|
6
|
+
let last = 0;
|
|
7
|
+
for (const match of path.matchAll(/\{([^{}]+)\}/g)) {
|
|
8
|
+
if (match.index > last)
|
|
9
|
+
out.push({ kind: "literal", text: path.slice(last, match.index) });
|
|
10
|
+
out.push({ kind: "param", name: match[1] });
|
|
11
|
+
last = match.index + match[0].length;
|
|
12
|
+
}
|
|
13
|
+
if (last < path.length)
|
|
14
|
+
out.push({ kind: "literal", text: path.slice(last) });
|
|
15
|
+
return out;
|
|
16
|
+
}
|
|
17
|
+
/** The path template's parameter names, once each, in order. */
|
|
18
|
+
export function openApiPathParams(path) {
|
|
19
|
+
return [...new Set(parseOpenApiPath(path).flatMap((seg) => (seg.kind === "param" ? [seg.name] : [])))];
|
|
20
|
+
}
|
|
21
|
+
/** Every request body an operation declares, preferred first. */
|
|
22
|
+
export function bodiesOf(op) {
|
|
23
|
+
return op.bodies ?? (op.body === undefined ? [] : [op.body]);
|
|
24
|
+
}
|
|
25
|
+
/** A parameter, body or response object with its component `$ref` followed; `undefined` for a dangling one. */
|
|
26
|
+
function deref(value, components, depth = 0) {
|
|
27
|
+
const object = value;
|
|
28
|
+
if (typeof object?.$ref !== "string" || depth > 16)
|
|
29
|
+
return object;
|
|
30
|
+
const [root, section, name] = object.$ref.replace(/^#\//, "").split("/");
|
|
31
|
+
const target = root === "components" && section !== undefined && Object.hasOwn(components, section)
|
|
32
|
+
? components[section]
|
|
33
|
+
: undefined;
|
|
34
|
+
return deref(target !== undefined && name !== undefined && Object.hasOwn(target, name) ? target[name] : undefined, components, depth + 1);
|
|
35
|
+
}
|
|
36
|
+
/** `schema` followed through refs, read from `components`, and nullables, for shape checks only. */
|
|
37
|
+
function shallow(schema, components, depth = 0) {
|
|
38
|
+
if (depth > 16)
|
|
39
|
+
return { kind: "unknown" };
|
|
40
|
+
if (schema.kind === "nullable")
|
|
41
|
+
return shallow(schema.inner, components, depth + 1);
|
|
42
|
+
if (schema.kind !== "ref")
|
|
43
|
+
return schema;
|
|
44
|
+
const schemas = components.schemas ?? {};
|
|
45
|
+
const target = Object.hasOwn(schemas, schema.name) ? schemas[schema.name] : undefined;
|
|
46
|
+
return shallow(schemaToIR(target), components, depth + 1);
|
|
47
|
+
}
|
|
48
|
+
const STRING = { kind: "scalar", type: "string" };
|
|
49
|
+
function paramOf(p) {
|
|
50
|
+
const schema = p.schema;
|
|
51
|
+
const param = {
|
|
52
|
+
name: String(p.name),
|
|
53
|
+
required: p.in === "path" || p.required === true,
|
|
54
|
+
schema: schema === undefined ? STRING : schemaToIR(schema),
|
|
55
|
+
};
|
|
56
|
+
if (typeof p.description === "string")
|
|
57
|
+
param.description = p.description;
|
|
58
|
+
if (p["x-honey-wildcard"] === true)
|
|
59
|
+
param.wildcard = true;
|
|
60
|
+
if (schema?.default !== undefined)
|
|
61
|
+
param.default = schema.default;
|
|
62
|
+
return param;
|
|
63
|
+
}
|
|
64
|
+
/** An operation's parameters, the path item's applying unless the operation declares the same name and place. */
|
|
65
|
+
export function paramsOf(path, op, item, components) {
|
|
66
|
+
const declared = (op.parameters ?? [])
|
|
67
|
+
.map((p) => deref(p, components))
|
|
68
|
+
.filter((p) => p !== undefined);
|
|
69
|
+
for (const p of (item.parameters ?? []).map((q) => deref(q, components))) {
|
|
70
|
+
if (p !== undefined && !declared.some((d) => d.name === p.name && d.in === p.in))
|
|
71
|
+
declared.push(p);
|
|
72
|
+
}
|
|
73
|
+
const by = (place) => declared.filter((p) => p.in === place).map(paramOf);
|
|
74
|
+
const pathParams = by("path");
|
|
75
|
+
/* path params in template order; one the template lacks cannot be sent, one it has but nobody declared is a string */
|
|
76
|
+
const params = {
|
|
77
|
+
header: by("header"),
|
|
78
|
+
path: openApiPathParams(path).map((name) => pathParams.find((p) => p.name === name) ?? { name, required: true, schema: STRING }),
|
|
79
|
+
query: by("query"),
|
|
80
|
+
};
|
|
81
|
+
const cookie = by("cookie");
|
|
82
|
+
if (cookie.length > 0)
|
|
83
|
+
params.cookie = cookie;
|
|
84
|
+
return params;
|
|
85
|
+
}
|
|
86
|
+
/* JSON first, then the structured kinds; other JSON-like types next, then the rest as listed */
|
|
87
|
+
const PREFERENCE = [
|
|
88
|
+
"application/json",
|
|
89
|
+
"application/x-www-form-urlencoded",
|
|
90
|
+
"multipart/form-data",
|
|
91
|
+
"application/octet-stream",
|
|
92
|
+
];
|
|
93
|
+
const essenceOf = (type) => type.split(";")[0].trim().toLowerCase();
|
|
94
|
+
function rank(type) {
|
|
95
|
+
const essence = essenceOf(type);
|
|
96
|
+
const at = PREFERENCE.indexOf(essence);
|
|
97
|
+
if (at >= 0)
|
|
98
|
+
return at;
|
|
99
|
+
return essence.endsWith("+json") ? PREFERENCE.length : PREFERENCE.length + 1;
|
|
100
|
+
}
|
|
101
|
+
/** `content`'s media types in preference order; ties keep the order the document lists them in. */
|
|
102
|
+
function ordered(content) {
|
|
103
|
+
return Object.keys(content)
|
|
104
|
+
.map((type, at) => ({ at, rank: rank(type), type }))
|
|
105
|
+
.sort((a, b) => a.rank - b.rank || a.at - b.at)
|
|
106
|
+
.map(({ type }) => type);
|
|
107
|
+
}
|
|
108
|
+
/** A multipart form's parts, read from its IR: a binary field, or a list of them, is a file. */
|
|
109
|
+
function partsOf(form, components) {
|
|
110
|
+
const object = shallow(form, components);
|
|
111
|
+
if (object.kind !== "object")
|
|
112
|
+
return [];
|
|
113
|
+
return object.fields.map(({ name, schema }) => {
|
|
114
|
+
const resolved = shallow(schema, components);
|
|
115
|
+
const items = resolved.kind === "array" ? shallow(resolved.items, components) : undefined;
|
|
116
|
+
const file = resolved.kind === "binary" || items?.kind === "binary";
|
|
117
|
+
return { name, schema, type: file ? "file" : "text" };
|
|
118
|
+
});
|
|
119
|
+
}
|
|
120
|
+
function bodyOf(type, media, required, components) {
|
|
121
|
+
const schema = media?.schema;
|
|
122
|
+
const essence = essenceOf(type);
|
|
123
|
+
if (essence === "application/octet-stream")
|
|
124
|
+
return { contentType: "application/octet-stream", kind: "stream", required };
|
|
125
|
+
const ir = schemaToIR(schema);
|
|
126
|
+
const parts = essence === "multipart/form-data" ? partsOf(ir, components) : [];
|
|
127
|
+
if (parts.some((part) => part.type === "file")) {
|
|
128
|
+
return { contentType: "multipart/form-data", kind: "multipart", parts, required, schema: ir };
|
|
129
|
+
}
|
|
130
|
+
return { contentType: type, kind: "raw", required, schema: ir };
|
|
131
|
+
}
|
|
132
|
+
/* a urlencoded form cannot carry a file, so a multipart one with a file part ranks just above it */
|
|
133
|
+
const weight = (body) => body.kind === "multipart" ? rank("application/x-www-form-urlencoded") - 0.5 : rank(body.contentType);
|
|
134
|
+
/** Every request body the operation declares, preferred first. */
|
|
135
|
+
export function requestBodies(op, components) {
|
|
136
|
+
const requestBody = deref(op.requestBody, components);
|
|
137
|
+
const content = (requestBody?.content ?? {});
|
|
138
|
+
return ordered(content)
|
|
139
|
+
.map((type) => bodyOf(type, content[type], requestBody?.required === true, components))
|
|
140
|
+
.sort((a, b) => weight(a) - weight(b));
|
|
141
|
+
}
|
|
142
|
+
/** A response's declared headers (A2), refs followed, in code-unit order; none when it declares none. */
|
|
143
|
+
function responseHeaders(response, components) {
|
|
144
|
+
const declared = Object.entries((response?.headers ?? {})).sort(([a], [b]) => compareCodeUnits(a, b));
|
|
145
|
+
if (declared.length === 0)
|
|
146
|
+
return undefined;
|
|
147
|
+
return declared.map(([name, raw]) => {
|
|
148
|
+
const header = deref(raw, components);
|
|
149
|
+
return { name, required: header?.required === true, schema: schemaToIR(header?.schema) };
|
|
150
|
+
});
|
|
151
|
+
}
|
|
152
|
+
/** The responses by status, each with its preferred media type's schema; and whether any streams events. */
|
|
153
|
+
export function responsesOf(op, components) {
|
|
154
|
+
const responses = {};
|
|
155
|
+
let sse = false;
|
|
156
|
+
for (const [status, raw] of Object.entries((op.responses ?? {}))) {
|
|
157
|
+
const response = deref(raw, components);
|
|
158
|
+
const content = (response?.content ?? {});
|
|
159
|
+
const type = ordered(content)[0];
|
|
160
|
+
const out = { status };
|
|
161
|
+
if (type !== undefined) {
|
|
162
|
+
if (Object.keys(content).some((key) => essenceOf(key) === "text/event-stream"))
|
|
163
|
+
sse = true;
|
|
164
|
+
out.contentType = type;
|
|
165
|
+
const schema = content[type]?.schema;
|
|
166
|
+
if (schema !== undefined)
|
|
167
|
+
out.schema = schemaToIR(schema);
|
|
168
|
+
out.contents = ordered(content).map((contentType) => {
|
|
169
|
+
const each = content[contentType]?.schema;
|
|
170
|
+
return each === undefined ? { contentType } : { contentType, schema: schemaToIR(each) };
|
|
171
|
+
});
|
|
172
|
+
}
|
|
173
|
+
if (response?.["x-honey-error"] === true)
|
|
174
|
+
out.error = true;
|
|
175
|
+
const headers = responseHeaders(response, components);
|
|
176
|
+
if (headers !== undefined)
|
|
177
|
+
out.headers = headers;
|
|
178
|
+
responses[status] = out;
|
|
179
|
+
}
|
|
180
|
+
return { responses, sse };
|
|
181
|
+
}
|
|
182
|
+
/** The honey extensions: each only when it is literally `true`; invalidation targets as strings. */
|
|
183
|
+
export function extensionsOf(op, sse) {
|
|
184
|
+
const out = {};
|
|
185
|
+
if (op["x-websocket"] === true)
|
|
186
|
+
out.websocket = true;
|
|
187
|
+
if (op["x-realtime"] === true)
|
|
188
|
+
out.realtime = true;
|
|
189
|
+
if (sse)
|
|
190
|
+
out.sse = true;
|
|
191
|
+
if (op["x-deprecated"] === true || op.deprecated === true)
|
|
192
|
+
out.deprecated = true;
|
|
193
|
+
if (op["x-idempotency-key"] === true)
|
|
194
|
+
out.idempotencyKey = true;
|
|
195
|
+
if (op["x-mcp"] === true)
|
|
196
|
+
out.mcp = true;
|
|
197
|
+
if (typeof op["x-honey-route"] === "string")
|
|
198
|
+
out.route = op["x-honey-route"];
|
|
199
|
+
const invalidate = op["x-invalidate"];
|
|
200
|
+
if (Array.isArray(invalidate))
|
|
201
|
+
out.invalidates = invalidate.filter((target) => typeof target === "string");
|
|
202
|
+
const errors = declaredErrors(op["x-honey-errors"]);
|
|
203
|
+
if (errors !== undefined)
|
|
204
|
+
out.errors = errors;
|
|
205
|
+
return out;
|
|
206
|
+
}
|
|
207
|
+
/** `x-honey-errors` as the IR reads it: each key with a numeric or null status, its schema when it has one. */
|
|
208
|
+
function declaredErrors(raw) {
|
|
209
|
+
if (raw === null || typeof raw !== "object" || Array.isArray(raw))
|
|
210
|
+
return undefined;
|
|
211
|
+
const out = {};
|
|
212
|
+
for (const [key, entry] of Object.entries(raw)) {
|
|
213
|
+
const { schema, status } = (entry ?? {});
|
|
214
|
+
if (status !== null && typeof status !== "number")
|
|
215
|
+
continue;
|
|
216
|
+
out[key] =
|
|
217
|
+
schema !== null && typeof schema === "object" ? { schema: schemaToIR(schema), status } : { status };
|
|
218
|
+
}
|
|
219
|
+
return Object.keys(out).length > 0 ? out : undefined;
|
|
220
|
+
}
|
|
221
|
+
/**
|
|
222
|
+
* The Standard Webhooks event the webhook `name` declares through `x-honey-webhook`, from its JSON
|
|
223
|
+
* body's `{ type, timestamp, data }` envelope; none when unmarked. gen reads documents it did not
|
|
224
|
+
* write: a marked webhook it could not verify into a typed event is refused, never emitted half.
|
|
225
|
+
*/
|
|
226
|
+
export function eventOf(name, op, components) {
|
|
227
|
+
const marker = op["x-honey-webhook"];
|
|
228
|
+
if (marker === undefined)
|
|
229
|
+
return undefined;
|
|
230
|
+
const refuse = (reason) => new Error(`x-honey-webhook on webhook ${JSON.stringify(name)}: ${reason}`);
|
|
231
|
+
if (marker !== "standard-webhooks")
|
|
232
|
+
throw refuse(`${JSON.stringify(marker)} is not standard-webhooks`);
|
|
233
|
+
const content = deref(op.requestBody, components)?.content;
|
|
234
|
+
const envelope = deref(content?.["application/json"]?.schema, components);
|
|
235
|
+
const properties = (envelope?.properties ?? {});
|
|
236
|
+
const required = Array.isArray(envelope?.required) ? envelope.required : [];
|
|
237
|
+
const type = properties.type?.const;
|
|
238
|
+
if (typeof type !== "string" ||
|
|
239
|
+
properties.data === undefined ||
|
|
240
|
+
!["type", "timestamp", "data"].every((key) => required.includes(key)))
|
|
241
|
+
throw refuse("the body is not a { type, timestamp, data } envelope");
|
|
242
|
+
if (type !== name)
|
|
243
|
+
throw refuse(`the envelope's type const is ${JSON.stringify(type)}, not the webhook's name`);
|
|
244
|
+
return { data: schemaToIR(properties.data), type };
|
|
245
|
+
}
|
|
@@ -0,0 +1,176 @@
|
|
|
1
|
+
// Code generated by honey. DO NOT EDIT.
|
|
2
|
+
|
|
3
|
+
package cli
|
|
4
|
+
|
|
5
|
+
import (
|
|
6
|
+
"encoding/json"
|
|
7
|
+
"io"
|
|
8
|
+
"net/url"
|
|
9
|
+
"os"
|
|
10
|
+
"path/filepath"
|
|
11
|
+
"strings"
|
|
12
|
+
)
|
|
13
|
+
|
|
14
|
+
// Data declares --data: the body as given, @file to read it from a file, - to read standard input.
|
|
15
|
+
func (p *Params) Data(usage string) {
|
|
16
|
+
p.cmd.Flags().String("data", "", usage+": the body itself, @file to read a file, or - for standard input")
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
// raw is --data's bytes, read from where it names; false when it was not given.
|
|
20
|
+
func (p *Params) raw() ([]byte, bool, error) {
|
|
21
|
+
if !p.cmd.Flags().Changed("data") {
|
|
22
|
+
return nil, false, nil
|
|
23
|
+
}
|
|
24
|
+
given, _ := p.cmd.Flags().GetString("data")
|
|
25
|
+
switch {
|
|
26
|
+
case given == "-":
|
|
27
|
+
raw, err := io.ReadAll(p.cmd.InOrStdin())
|
|
28
|
+
return raw, true, err
|
|
29
|
+
case strings.HasPrefix(given, "@"):
|
|
30
|
+
raw, err := os.ReadFile(given[1:])
|
|
31
|
+
if err != nil {
|
|
32
|
+
return nil, false, Usage("--data: %v", err)
|
|
33
|
+
}
|
|
34
|
+
return raw, true, nil
|
|
35
|
+
}
|
|
36
|
+
return []byte(given), true, nil
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
// missing refuses a call with no body when the operation requires one.
|
|
40
|
+
func (p *Params) missing(required bool) error {
|
|
41
|
+
if required {
|
|
42
|
+
return Usage("%s needs a body: --data, or the body's own flags", p.cmd.CommandPath())
|
|
43
|
+
}
|
|
44
|
+
return nil
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
// JSON decodes the JSON body into dst: --data's object, then each body flag given (by flag name, to
|
|
48
|
+
// its key) over that key. Nothing given leaves dst as it is.
|
|
49
|
+
func (p *Params) JSON(dst any, required bool, fields map[string]string) error {
|
|
50
|
+
raw, given, err := p.raw()
|
|
51
|
+
if err != nil {
|
|
52
|
+
return err
|
|
53
|
+
}
|
|
54
|
+
object := map[string]json.RawMessage{}
|
|
55
|
+
if given && len(fields) > 0 {
|
|
56
|
+
if err := json.Unmarshal(raw, &object); err != nil {
|
|
57
|
+
return Usage("--data: %v", err)
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
for flag, key := range fields {
|
|
61
|
+
if values := p.Values(flag); len(values) > 0 {
|
|
62
|
+
object[key], given = p.fieldJSON(flag, values), true
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
if !given {
|
|
66
|
+
return p.missing(required)
|
|
67
|
+
}
|
|
68
|
+
if len(fields) > 0 {
|
|
69
|
+
raw, _ = json.Marshal(object)
|
|
70
|
+
}
|
|
71
|
+
if err := json.Unmarshal(raw, dst); err != nil {
|
|
72
|
+
return Usage("--data: %v", err)
|
|
73
|
+
}
|
|
74
|
+
return nil
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
// fieldJSON is a body flag's values as their JSON: a string quoted, any other kind its literal, a
|
|
78
|
+
// list an array of those.
|
|
79
|
+
func (p *Params) fieldJSON(flag string, values []string) json.RawMessage {
|
|
80
|
+
v := p.cmd.Flags().Lookup(flag).Value.(*value)
|
|
81
|
+
one := func(raw string) json.RawMessage {
|
|
82
|
+
if v.kind == "string" {
|
|
83
|
+
quoted, _ := json.Marshal(raw)
|
|
84
|
+
return quoted
|
|
85
|
+
}
|
|
86
|
+
return json.RawMessage(raw)
|
|
87
|
+
}
|
|
88
|
+
if !v.list {
|
|
89
|
+
return one(values[0])
|
|
90
|
+
}
|
|
91
|
+
items := make([]json.RawMessage, len(values))
|
|
92
|
+
for i, raw := range values {
|
|
93
|
+
items[i] = one(raw)
|
|
94
|
+
}
|
|
95
|
+
array, _ := json.Marshal(items)
|
|
96
|
+
return array
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
// Text is the text body: --data's bytes.
|
|
100
|
+
func (p *Params) Text(required bool) (string, error) {
|
|
101
|
+
raw, given, err := p.raw()
|
|
102
|
+
if err == nil && !given {
|
|
103
|
+
err = p.missing(required)
|
|
104
|
+
}
|
|
105
|
+
return string(raw), err
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
// Reader is the binary body, streamed: standard input, the file --data names, or --data's own bytes.
|
|
109
|
+
func (p *Params) Reader(required bool) (io.Reader, error) {
|
|
110
|
+
if !p.cmd.Flags().Changed("data") {
|
|
111
|
+
return nil, p.missing(required)
|
|
112
|
+
}
|
|
113
|
+
given, _ := p.cmd.Flags().GetString("data")
|
|
114
|
+
switch {
|
|
115
|
+
case given == "-":
|
|
116
|
+
return p.cmd.InOrStdin(), nil
|
|
117
|
+
case strings.HasPrefix(given, "@"):
|
|
118
|
+
file, err := os.Open(given[1:])
|
|
119
|
+
if err != nil {
|
|
120
|
+
return nil, Usage("--data: %v", err)
|
|
121
|
+
}
|
|
122
|
+
return file, nil
|
|
123
|
+
}
|
|
124
|
+
return strings.NewReader(given), nil
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
// Form is the form body: --data as a query string (a=1&b=2), then each body flag given over its key.
|
|
128
|
+
func (p *Params) Form(required bool, fields map[string]string) (url.Values, error) {
|
|
129
|
+
raw, given, err := p.raw()
|
|
130
|
+
if err != nil {
|
|
131
|
+
return nil, err
|
|
132
|
+
}
|
|
133
|
+
form, err := url.ParseQuery(string(raw))
|
|
134
|
+
if err != nil {
|
|
135
|
+
return nil, Usage("--data: %v", err)
|
|
136
|
+
}
|
|
137
|
+
for flag, key := range fields {
|
|
138
|
+
if values := p.Values(flag); len(values) > 0 {
|
|
139
|
+
form[key], given = values, true
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
if !given {
|
|
143
|
+
return form, p.missing(required)
|
|
144
|
+
}
|
|
145
|
+
return form, nil
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
// Upload is one file a file part sends: its name and its bytes, streamed as read. Its media type
|
|
149
|
+
// is left to the SDK (application/octet-stream).
|
|
150
|
+
type Upload struct {
|
|
151
|
+
Filename string
|
|
152
|
+
Data io.Reader
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
// FileFlag declares --name, the path of a file a part sends (- for standard input), repeatable
|
|
156
|
+
// when list.
|
|
157
|
+
func (p *Params) FileFlag(name string, list bool, usage string) {
|
|
158
|
+
p.Flag(name, "file", list, false, usage)
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
// Files opens each file --name was given, in order; none when it was not given.
|
|
162
|
+
func (p *Params) Files(name string) ([]Upload, error) {
|
|
163
|
+
var uploads []Upload
|
|
164
|
+
for _, path := range p.Values(name) {
|
|
165
|
+
if path == "-" {
|
|
166
|
+
uploads = append(uploads, Upload{Filename: "stdin", Data: p.cmd.InOrStdin()})
|
|
167
|
+
continue
|
|
168
|
+
}
|
|
169
|
+
file, err := os.Open(path)
|
|
170
|
+
if err != nil {
|
|
171
|
+
return nil, Usage("--%s: %v", name, err)
|
|
172
|
+
}
|
|
173
|
+
uploads = append(uploads, Upload{Filename: filepath.Base(path), Data: file})
|
|
174
|
+
}
|
|
175
|
+
return uploads, nil
|
|
176
|
+
}
|
|
@@ -0,0 +1,243 @@
|
|
|
1
|
+
// Code generated by honey. DO NOT EDIT.
|
|
2
|
+
|
|
3
|
+
package cli
|
|
4
|
+
|
|
5
|
+
import (
|
|
6
|
+
"bytes"
|
|
7
|
+
"errors"
|
|
8
|
+
"fmt"
|
|
9
|
+
"io"
|
|
10
|
+
"io/fs"
|
|
11
|
+
"os"
|
|
12
|
+
"path/filepath"
|
|
13
|
+
"strings"
|
|
14
|
+
"time"
|
|
15
|
+
|
|
16
|
+
"github.com/pelletier/go-toml/v2"
|
|
17
|
+
"github.com/spf13/cobra"
|
|
18
|
+
"github.com/spf13/pflag"
|
|
19
|
+
)
|
|
20
|
+
|
|
21
|
+
// Config is one run's settings, each from its flag, else its environment variable, else the
|
|
22
|
+
// config file, else its default.
|
|
23
|
+
type Config struct {
|
|
24
|
+
APIKey string
|
|
25
|
+
BaseURL string
|
|
26
|
+
Headers map[string]string
|
|
27
|
+
Timeout time.Duration
|
|
28
|
+
Verbose bool
|
|
29
|
+
Quiet bool
|
|
30
|
+
// Redirect is which redirects a call follows: same-origin (the default) or follow
|
|
31
|
+
Redirect string
|
|
32
|
+
|
|
33
|
+
log io.Writer
|
|
34
|
+
secrets []string
|
|
35
|
+
// each setting's source, by its config file key: flag, env, file or default
|
|
36
|
+
sources map[string]string
|
|
37
|
+
// the API's default base URL, the target when no setting names one
|
|
38
|
+
server string
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
// saved is the config file: TOML, an unknown key a usage error.
|
|
42
|
+
type saved struct {
|
|
43
|
+
APIKey string `toml:"api_key"`
|
|
44
|
+
BaseURL string `toml:"base_url"`
|
|
45
|
+
Timeout string `toml:"timeout"`
|
|
46
|
+
Verbose *bool `toml:"verbose"`
|
|
47
|
+
Quiet *bool `toml:"quiet"`
|
|
48
|
+
Redirect string `toml:"redirect"`
|
|
49
|
+
Headers map[string]string `toml:"headers"`
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
// the root annotations holding the environment variables' prefix and the API's default base URL
|
|
53
|
+
const (
|
|
54
|
+
envPrefixKey = "honey.envPrefix"
|
|
55
|
+
serverKey = "honey.server"
|
|
56
|
+
)
|
|
57
|
+
|
|
58
|
+
// globalFlags declares the flags every command takes.
|
|
59
|
+
func globalFlags(root *cobra.Command, app App) {
|
|
60
|
+
env := func(key string) string { return "$" + app.EnvPrefix + "_" + key }
|
|
61
|
+
f := root.PersistentFlags()
|
|
62
|
+
f.String("api-key", "", "the API key ("+env("API_KEY")+")")
|
|
63
|
+
f.String("base-url", "", "the API's base URL ("+env("BASE_URL")+")")
|
|
64
|
+
f.String("config", "", "the config file ("+env("CONFIG")+"; default ~/.config/"+app.Name+"/config.toml)")
|
|
65
|
+
f.Duration("timeout", 0, "bound each call; 0 for 30s ("+env("TIMEOUT")+")")
|
|
66
|
+
f.Bool("verbose", false, "log each request and response to stderr, secrets redacted ("+env("VERBOSE")+")")
|
|
67
|
+
f.BoolP("quiet", "q", false, "no target line on a terminal's stderr ("+env("QUIET")+")")
|
|
68
|
+
f.String("redirect", "", "same-origin (the default) or follow, which also follows a cross-origin redirect without the credentials ("+env("REDIRECT")+")")
|
|
69
|
+
f.StringArray("header", nil, `send a header, "Name: value" (repeatable)`)
|
|
70
|
+
root.Annotations = map[string]string{envPrefixKey: app.EnvPrefix, serverKey: app.Server}
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
// Settings resolves the run's settings for c.
|
|
74
|
+
func Settings(c *cobra.Command) (Config, error) {
|
|
75
|
+
root := c.Root()
|
|
76
|
+
prefix := root.Annotations[envPrefixKey]
|
|
77
|
+
flags := c.Flags()
|
|
78
|
+
file, err := readConfig(flags, prefix, root.Name(), c.ErrOrStderr())
|
|
79
|
+
if err != nil {
|
|
80
|
+
return Config{}, err
|
|
81
|
+
}
|
|
82
|
+
cfg := Config{log: c.ErrOrStderr(), sources: map[string]string{}, server: root.Annotations[serverKey]}
|
|
83
|
+
cfg.APIKey, cfg.sources["api_key"] = pick(flags, "api-key", prefix+"_API_KEY", file.APIKey)
|
|
84
|
+
cfg.BaseURL, cfg.sources["base_url"] = pick(flags, "base-url", prefix+"_BASE_URL", file.BaseURL)
|
|
85
|
+
if cfg.Timeout, cfg.sources["timeout"], err = timeout(flags, prefix, file.Timeout); err != nil {
|
|
86
|
+
return Config{}, err
|
|
87
|
+
}
|
|
88
|
+
if cfg.Verbose, cfg.sources["verbose"], err = boolSetting(flags, "verbose", prefix, file.Verbose); err != nil {
|
|
89
|
+
return Config{}, err
|
|
90
|
+
}
|
|
91
|
+
if cfg.Quiet, cfg.sources["quiet"], err = boolSetting(flags, "quiet", prefix, file.Quiet); err != nil {
|
|
92
|
+
return Config{}, err
|
|
93
|
+
}
|
|
94
|
+
cfg.Redirect, cfg.sources["redirect"] = pick(flags, "redirect", prefix+"_REDIRECT", file.Redirect)
|
|
95
|
+
switch cfg.Redirect {
|
|
96
|
+
case "":
|
|
97
|
+
cfg.Redirect = "same-origin"
|
|
98
|
+
case "same-origin", "follow":
|
|
99
|
+
default:
|
|
100
|
+
return Config{}, Usage("redirect %q: want same-origin or follow", cfg.Redirect)
|
|
101
|
+
}
|
|
102
|
+
if cfg.Headers, cfg.sources["headers"], err = headers(flags, file.Headers); err != nil {
|
|
103
|
+
return Config{}, err
|
|
104
|
+
}
|
|
105
|
+
cfg.secrets = secretsOf(cfg)
|
|
106
|
+
return cfg, nil
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
// redirectOf is the run's redirect setting, resolved again where an error is reported (the config
|
|
110
|
+
// file's warnings are not repeated).
|
|
111
|
+
func redirectOf(c *cobra.Command) string {
|
|
112
|
+
prefix := c.Root().Annotations[envPrefixKey]
|
|
113
|
+
file, _ := readConfig(c.Flags(), prefix, c.Root().Name(), io.Discard)
|
|
114
|
+
redirect, _ := pick(c.Flags(), "redirect", prefix+"_REDIRECT", file.Redirect)
|
|
115
|
+
return redirect
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
// pick is a string setting and its source: its flag when given, else its environment variable
|
|
119
|
+
// when set, else the file's, else none.
|
|
120
|
+
func pick(flags *pflag.FlagSet, name, env, file string) (string, string) {
|
|
121
|
+
if flags.Changed(name) {
|
|
122
|
+
value, _ := flags.GetString(name)
|
|
123
|
+
return value, "flag"
|
|
124
|
+
}
|
|
125
|
+
if value := os.Getenv(env); value != "" {
|
|
126
|
+
return value, "env"
|
|
127
|
+
}
|
|
128
|
+
if file != "" {
|
|
129
|
+
return file, "file"
|
|
130
|
+
}
|
|
131
|
+
return "", "default"
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
func timeout(flags *pflag.FlagSet, prefix, file string) (time.Duration, string, error) {
|
|
135
|
+
if flags.Changed("timeout") {
|
|
136
|
+
d, err := flags.GetDuration("timeout")
|
|
137
|
+
return d, "flag", err
|
|
138
|
+
}
|
|
139
|
+
raw, from, source := os.Getenv(prefix+"_TIMEOUT"), "$"+prefix+"_TIMEOUT", "env"
|
|
140
|
+
if raw == "" {
|
|
141
|
+
raw, from, source = file, "the config file's timeout", "file"
|
|
142
|
+
}
|
|
143
|
+
if raw == "" {
|
|
144
|
+
return 0, "default", nil
|
|
145
|
+
}
|
|
146
|
+
d, err := time.ParseDuration(raw)
|
|
147
|
+
if err != nil {
|
|
148
|
+
return 0, "", Usage("%s: %q is not a duration (30s, 1m)", from, raw)
|
|
149
|
+
}
|
|
150
|
+
return d, source, nil
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
// boolSetting is the boolean setting name and its source: its flag, $<PREFIX>_<NAME>, the file's.
|
|
154
|
+
func boolSetting(flags *pflag.FlagSet, name, prefix string, file *bool) (bool, string, error) {
|
|
155
|
+
if flags.Changed(name) {
|
|
156
|
+
on, err := flags.GetBool(name)
|
|
157
|
+
return on, "flag", err
|
|
158
|
+
}
|
|
159
|
+
env := prefix + "_" + strings.ToUpper(name)
|
|
160
|
+
if raw := os.Getenv(env); raw != "" {
|
|
161
|
+
on, err := parseBool(raw)
|
|
162
|
+
if err != nil {
|
|
163
|
+
return false, "", Usage("$%s: %q is not true or false", env, raw)
|
|
164
|
+
}
|
|
165
|
+
return on, "env", nil
|
|
166
|
+
}
|
|
167
|
+
if file != nil {
|
|
168
|
+
return *file, "file", nil
|
|
169
|
+
}
|
|
170
|
+
return false, "default", nil
|
|
171
|
+
}
|
|
172
|
+
|
|
173
|
+
func parseBool(raw string) (bool, error) {
|
|
174
|
+
switch strings.ToLower(raw) {
|
|
175
|
+
case "1", "true", "yes", "on":
|
|
176
|
+
return true, nil
|
|
177
|
+
case "0", "false", "no", "off":
|
|
178
|
+
return false, nil
|
|
179
|
+
}
|
|
180
|
+
return false, errors.New("not a boolean")
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
// headers is the file's headers, each --header over the one of its name, and their source: flag
|
|
184
|
+
// when any --header is given, else file when the file holds any.
|
|
185
|
+
func headers(flags *pflag.FlagSet, file map[string]string) (map[string]string, string, error) {
|
|
186
|
+
out := map[string]string{}
|
|
187
|
+
source := "default"
|
|
188
|
+
for name, value := range file {
|
|
189
|
+
out[name], source = value, "file"
|
|
190
|
+
}
|
|
191
|
+
given, _ := flags.GetStringArray("header")
|
|
192
|
+
for _, header := range given {
|
|
193
|
+
name, value, ok := strings.Cut(header, ":")
|
|
194
|
+
if !ok || strings.TrimSpace(name) == "" {
|
|
195
|
+
return nil, "", Usage("--header %q: want \"Name: value\"", header)
|
|
196
|
+
}
|
|
197
|
+
out[strings.TrimSpace(name)], source = strings.TrimSpace(value), "flag"
|
|
198
|
+
}
|
|
199
|
+
return out, source, nil
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
// readConfig reads the config file: --config, else $<PREFIX>_CONFIG (each must exist), else the
|
|
203
|
+
// user config dir's <name>/config.toml when there is one.
|
|
204
|
+
func readConfig(flags *pflag.FlagSet, prefix, name string, stderr io.Writer) (saved, error) {
|
|
205
|
+
path, explicit := configPath(flags, prefix, name)
|
|
206
|
+
if path == "" {
|
|
207
|
+
return saved{}, nil
|
|
208
|
+
}
|
|
209
|
+
raw, err := os.ReadFile(path)
|
|
210
|
+
if errors.Is(err, fs.ErrNotExist) && !explicit {
|
|
211
|
+
return saved{}, nil
|
|
212
|
+
}
|
|
213
|
+
if err != nil {
|
|
214
|
+
return saved{}, Usage("config file %s: %v", path, err)
|
|
215
|
+
}
|
|
216
|
+
var file saved
|
|
217
|
+
decoder := toml.NewDecoder(bytes.NewReader(raw))
|
|
218
|
+
decoder.DisallowUnknownFields()
|
|
219
|
+
if err := decoder.Decode(&file); err != nil {
|
|
220
|
+
return saved{}, Usage("config file %s: %v", path, err)
|
|
221
|
+
}
|
|
222
|
+
if info, err := os.Stat(path); err == nil && file.APIKey != "" && info.Mode().Perm()&0o077 != 0 {
|
|
223
|
+
fmt.Fprintf(stderr, "%s: warning: %s holds an API key and others can read it; chmod 600 it\n", name, path)
|
|
224
|
+
}
|
|
225
|
+
return file, nil
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
func configPath(flags *pflag.FlagSet, prefix, name string) (string, bool) {
|
|
229
|
+
if flags.Changed("config") {
|
|
230
|
+
path, _ := flags.GetString("config")
|
|
231
|
+
return path, true
|
|
232
|
+
}
|
|
233
|
+
if path := os.Getenv(prefix + "_CONFIG"); path != "" {
|
|
234
|
+
return path, true
|
|
235
|
+
}
|
|
236
|
+
if dir := os.Getenv("XDG_CONFIG_HOME"); dir != "" {
|
|
237
|
+
return filepath.Join(dir, name, "config.toml"), false
|
|
238
|
+
}
|
|
239
|
+
if home, err := os.UserHomeDir(); err == nil {
|
|
240
|
+
return filepath.Join(home, ".config", name, "config.toml"), false
|
|
241
|
+
}
|
|
242
|
+
return "", false
|
|
243
|
+
}
|