@workerstack/clients 1.0.0-rc.29 → 1.0.0-rc.31
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/README.md +548 -35
- package/assets/installers/examples/github.config.ts +17 -19
- package/assets/installers/examples/goreleaser.config.ts +16 -18
- package/assets/installers/examples/raw.config.ts +13 -15
- package/bin/clients.js +88 -68
- package/bin/installgen.js +18 -13
- package/dist/cli.d.ts +4 -4
- package/dist/cli.js +20 -12
- package/dist/emit/cli/channels.d.ts +2 -2
- package/dist/emit/cli/channels.js +18 -13
- package/dist/emit/cli/commands.d.ts +1 -1
- package/dist/emit/cli/commands.js +14 -8
- package/dist/emit/cli/discovery.d.ts +0 -6
- package/dist/emit/cli/discovery.js +9 -7
- package/dist/emit/cli/flags.d.ts +1 -3
- package/dist/emit/cli/flags.js +11 -5
- package/dist/emit/cli/install.d.ts +0 -8
- package/dist/emit/cli/install.js +3 -3
- package/dist/emit/cli/layout.d.ts +1 -1
- package/dist/emit/cli/layout.js +13 -10
- package/dist/emit/cli/module.d.ts +6 -6
- package/dist/emit/cli/module.js +10 -10
- package/dist/emit/cli/release.d.ts +0 -11
- package/dist/emit/cli/release.js +4 -4
- package/dist/emit/cli/skills.js +3 -3
- package/dist/emit/csharp/errors.js +4 -4
- package/dist/emit/csharp/json.js +8 -8
- package/dist/emit/csharp/realtime.js +3 -3
- package/dist/emit/csharp/sdk-answer.js +4 -4
- package/dist/emit/csharp/sdk-body.js +8 -6
- package/dist/emit/csharp/sdk-client.d.ts +3 -3
- package/dist/emit/csharp/sdk-client.js +2 -2
- package/dist/emit/csharp/sdk-csproj.d.ts +7 -9
- package/dist/emit/csharp/sdk-csproj.js +10 -10
- package/dist/emit/csharp/sdk-doc.js +1 -1
- package/dist/emit/csharp/sdk-method.d.ts +18 -2
- package/dist/emit/csharp/sdk-method.js +24 -9
- package/dist/emit/csharp/sdk-plan.js +0 -1
- package/dist/emit/csharp/sdk.js +7 -4
- package/dist/emit/csharp/sse.d.ts +0 -2
- package/dist/emit/csharp/sse.js +7 -7
- package/dist/emit/csharp/transport.js +7 -7
- package/dist/emit/csharp/types-enum.js +3 -1
- package/dist/emit/csharp/types-messages.js +3 -3
- package/dist/emit/csharp/types-names.js +10 -12
- package/dist/emit/csharp/types-record.js +3 -3
- package/dist/emit/csharp/types-union.d.ts +1 -1
- package/dist/emit/csharp/types.d.ts +0 -1
- package/dist/emit/csharp/types.js +3 -3
- package/dist/emit/csharp/ws.js +2 -2
- package/dist/emit/go/errors.js +1 -1
- package/dist/emit/go/http.js +2 -2
- package/dist/emit/go/module-path.js +2 -2
- package/dist/emit/go/sdk-answer.js +1 -1
- package/dist/emit/go/sdk-body.js +11 -7
- package/dist/emit/go/sdk-client.js +1 -1
- package/dist/emit/go/sdk-method.d.ts +9 -0
- package/dist/emit/go/sdk-method.js +12 -3
- package/dist/emit/go/sdk-mirror.js +2 -2
- package/dist/emit/go/sdk-opts.d.ts +0 -2
- package/dist/emit/go/sdk-opts.js +3 -3
- package/dist/emit/go/sdk.d.ts +1 -1
- package/dist/emit/go/sdk.js +12 -11
- package/dist/emit/go/sse.js +1 -1
- package/dist/emit/go/types-names.js +5 -0
- package/dist/emit/go/types-struct.d.ts +2 -1
- package/dist/emit/go/types-struct.js +1 -1
- package/dist/emit/go/types.js +9 -9
- package/dist/emit/go/ws.js +6 -6
- package/dist/emit/java/gradle.d.ts +7 -9
- package/dist/emit/java/gradle.js +8 -8
- package/dist/emit/java/json.js +1 -1
- package/dist/emit/java/layout-ast.js +1 -1
- package/dist/emit/java/layout-decl.js +5 -4
- package/dist/emit/java/layout-doc.js +13 -7
- package/dist/emit/java/layout-dot.js +1 -1
- package/dist/emit/java/layout-strings.js +4 -5
- package/dist/emit/java/layout-types.js +7 -5
- package/dist/emit/java/layout-visitor.js +4 -3
- package/dist/emit/java/layout.js +5 -4
- package/dist/emit/java/models-names.js +5 -4
- package/dist/emit/java/models-record.d.ts +0 -1
- package/dist/emit/java/models-record.js +3 -3
- package/dist/emit/java/models-union.d.ts +1 -1
- package/dist/emit/java/models-union.js +1 -1
- package/dist/emit/java/models.d.ts +1 -2
- package/dist/emit/java/models.js +25 -16
- package/dist/emit/java/realtime.d.ts +5 -17
- package/dist/emit/java/realtime.js +1 -1
- package/dist/emit/java/sdk-client.d.ts +6 -6
- package/dist/emit/java/sdk-client.js +2 -1
- package/dist/emit/java/sdk-decl.js +2 -2
- package/dist/emit/java/sdk-errors.js +1 -1
- package/dist/emit/java/sdk-headers.js +2 -2
- package/dist/emit/java/sdk-mirror.js +2 -2
- package/dist/emit/java/sdk-models.d.ts +1 -1
- package/dist/emit/java/sdk-models.js +7 -7
- package/dist/emit/java/sdk-op.d.ts +7 -11
- package/dist/emit/java/sdk-op.js +22 -10
- package/dist/emit/java/sdk-params.d.ts +5 -5
- package/dist/emit/java/sdk-params.js +3 -2
- package/dist/emit/java/sdk-plan.js +0 -1
- package/dist/emit/java/sdk.d.ts +1 -1
- package/dist/emit/java/sdk.js +21 -14
- package/dist/emit/java/sse.d.ts +2 -4
- package/dist/emit/java/sse.js +6 -6
- package/dist/emit/java/ws.d.ts +2 -2
- package/dist/emit/java/ws.js +3 -4
- package/dist/emit/mcp/annotations.js +8 -4
- package/dist/emit/mcp/files.js +9 -9
- package/dist/emit/mcp/mounted.js +2 -2
- package/dist/emit/mcp/output-schema.js +3 -3
- package/dist/emit/mcp/registry.d.ts +0 -2
- package/dist/emit/mcp/registry.js +5 -4
- package/dist/emit/mcp/runtime.js +2 -2
- package/dist/emit/mcp/schema.js +22 -11
- package/dist/emit/mcp/server.d.ts +7 -7
- package/dist/emit/mcp/server.js +7 -6
- package/dist/emit/mcp/tools.js +7 -6
- package/dist/emit/python/errors.js +3 -3
- package/dist/emit/python/realtime.js +2 -2
- package/dist/emit/python/sdk-answer.d.ts +3 -7
- package/dist/emit/python/sdk-answer.js +2 -2
- package/dist/emit/python/sdk-body.js +4 -5
- package/dist/emit/python/sdk-client.js +5 -5
- package/dist/emit/python/sdk-doc.js +2 -2
- package/dist/emit/python/sdk-method.d.ts +11 -0
- package/dist/emit/python/sdk-method.js +20 -5
- package/dist/emit/python/sdk-plan.js +0 -1
- package/dist/emit/python/sdk-pyproject.d.ts +0 -2
- package/dist/emit/python/sdk-pyproject.js +8 -8
- package/dist/emit/python/sdk.d.ts +1 -1
- package/dist/emit/python/sdk.js +12 -8
- package/dist/emit/python/sse.d.ts +0 -2
- package/dist/emit/python/sse.js +2 -2
- package/dist/emit/python/transport.js +4 -4
- package/dist/emit/python/types-dict.d.ts +2 -2
- package/dist/emit/python/types-dict.js +1 -1
- package/dist/emit/python/types-names.js +2 -2
- package/dist/emit/python/types-union.js +1 -1
- package/dist/emit/python/types.js +3 -3
- package/dist/emit/python/ws.d.ts +2 -5
- package/dist/emit/python/ws.js +4 -4
- package/dist/emit/rust/errors.js +3 -3
- package/dist/emit/rust/http.js +4 -4
- package/dist/emit/rust/realtime.js +2 -2
- package/dist/emit/rust/sdk-body.js +8 -5
- package/dist/emit/rust/sdk-cargo.d.ts +16 -18
- package/dist/emit/rust/sdk-cargo.js +12 -12
- package/dist/emit/rust/sdk-client.d.ts +1 -1
- package/dist/emit/rust/sdk-client.js +3 -3
- package/dist/emit/rust/sdk-method.d.ts +12 -1
- package/dist/emit/rust/sdk-method.js +12 -4
- package/dist/emit/rust/sdk-opts.d.ts +2 -1
- package/dist/emit/rust/sdk-opts.js +2 -2
- package/dist/emit/rust/sdk-plan.js +0 -1
- package/dist/emit/rust/sdk.d.ts +1 -1
- package/dist/emit/rust/sdk.js +9 -6
- package/dist/emit/rust/sse.d.ts +0 -5
- package/dist/emit/rust/sse.js +2 -2
- package/dist/emit/rust/types-names.js +3 -3
- package/dist/emit/rust/types-struct.js +1 -1
- package/dist/emit/rust/types-union.d.ts +1 -1
- package/dist/emit/rust/types.js +7 -5
- package/dist/emit/rust/ws.d.ts +0 -11
- package/dist/emit/rust/ws.js +5 -5
- package/dist/emit/shared/escape.js +17 -17
- package/dist/emit/shared/format.js +1 -1
- package/dist/emit/shared/gofmt.js +1 -1
- package/dist/emit/shared/lang.js +10 -10
- package/dist/emit/shared/literals.d.ts +5 -0
- package/dist/emit/shared/literals.js +8 -0
- package/dist/emit/shared/metadata.d.ts +0 -6
- package/dist/emit/shared/metadata.js +8 -7
- package/dist/emit/shared/ruff.js +1 -1
- package/dist/emit/shared/rustfmt.js +1 -1
- package/dist/emit/shared/type-emitter.js +37 -20
- package/dist/emit/shared/unknown-type.constants.d.ts +2 -0
- package/dist/emit/shared/unknown-type.constants.js +2 -0
- package/dist/emit/ts/http.d.ts +8 -2
- package/dist/emit/ts/http.js +51 -6
- package/dist/emit/ts/package.d.ts +14 -12
- package/dist/emit/ts/package.js +10 -8
- package/dist/emit/ts/route-tree.js +2 -2
- package/dist/emit/ts/sdk-types-preamble.d.ts +1 -1
- package/dist/emit/ts/sdk-types-preamble.js +12 -4
- package/dist/emit/ts/sdk-types.d.ts +0 -5
- package/dist/emit/ts/sdk-types.js +63 -19
- package/dist/emit/ts/sdk.d.ts +3 -1
- package/dist/emit/ts/sdk.js +44 -12
- package/dist/emit/ts/service-map.d.ts +7 -1
- package/dist/emit/ts/service-map.js +10 -1
- package/dist/emit/ts/single-flight-text.d.ts +3 -0
- package/dist/emit/ts/single-flight-text.js +38 -0
- package/dist/emit/ts/tanstack-query.d.ts +3 -2
- package/dist/emit/ts/tanstack-query.js +60 -35
- package/dist/emit/ts/type-gen.js +31 -18
- package/dist/emit/ts/webhooks.d.ts +0 -2
- package/dist/emit/ts/webhooks.js +3 -3
- package/dist/extract/chain.js +5 -4
- package/dist/extract/extract.js +5 -5
- package/dist/extract/serialize.d.ts +0 -2
- package/dist/extract/serialize.js +14 -15
- package/dist/extract/walk.js +15 -12
- package/dist/gen/args.js +9 -5
- package/dist/gen/formatters.js +5 -3
- package/dist/gen/process.js +2 -1
- package/dist/gen/shipped.js +2 -2
- package/dist/gen/switch-on.constants.d.ts +2 -0
- package/dist/gen/switch-on.constants.js +2 -0
- package/dist/gen/targets.d.ts +6 -7
- package/dist/gen/targets.js +11 -6
- package/dist/gen/write.js +4 -2
- package/dist/index.js +2 -2
- package/dist/installers/cli.d.ts +4 -4
- package/dist/installers/cli.js +24 -24
- package/dist/installers/commands/build.d.ts +4 -4
- package/dist/installers/commands/build.js +2 -3
- package/dist/installers/commands/check.d.ts +2 -2
- package/dist/installers/commands/check.js +11 -10
- package/dist/installers/commands/init.d.ts +2 -2
- package/dist/installers/commands/init.js +1 -2
- package/dist/installers/config/define-config.d.ts +16 -16
- package/dist/installers/config/define-config.js +1 -1
- package/dist/installers/config/hooks/bun.d.ts +6 -6
- package/dist/installers/config/hooks/node.js +1 -1
- package/dist/installers/config/load.d.ts +6 -8
- package/dist/installers/config/load.js +7 -8
- package/dist/installers/config/resolve.d.ts +1 -2
- package/dist/installers/config/resolve.js +28 -33
- package/dist/installers/config/types.d.ts +6 -6
- package/dist/installers/config/types.js +0 -1
- package/dist/installers/render/quote.js +3 -5
- package/dist/installers/render/render.d.ts +6 -6
- package/dist/installers/render/render.js +26 -26
- package/dist/installers/ui.d.ts +4 -4
- package/dist/installers/ui.js +3 -3
- package/dist/ir/build.d.ts +3 -3
- package/dist/ir/build.js +8 -5
- package/dist/ir/invalidate-reads.d.ts +17 -0
- package/dist/ir/invalidate-reads.js +104 -0
- package/dist/ir/load.d.ts +10 -0
- package/dist/ir/load.js +65 -18
- package/dist/ir/model.d.ts +2 -1
- package/dist/ir/model.js +0 -1
- package/dist/ir/read-method.constants.d.ts +2 -0
- package/dist/ir/read-method.constants.js +2 -0
- package/dist/ir/resolve-refs.js +2 -2
- package/dist/ir/resource-tree.js +2 -1
- package/dist/ir/route-tree-intern.js +1 -1
- package/dist/ir/schema.js +3 -3
- package/dist/ir/sdk-model.js +3 -3
- package/dist/ir/slots.js +13 -8
- package/dist/ir/streams.js +1 -1
- package/dist/release/bootstrap.d.ts +3 -3
- package/dist/release/bootstrap.js +7 -7
- package/dist/release/bump-args.js +4 -4
- package/dist/release/bump-command.d.ts +1 -1
- package/dist/release/bump-command.js +9 -10
- package/dist/release/bump.d.ts +5 -4
- package/dist/release/bump.js +2 -2
- package/dist/release/cli.d.ts +4 -4
- package/dist/release/cli.js +4 -4
- package/dist/release/codegen.js +1 -1
- package/dist/release/digest.js +5 -7
- package/dist/release/git.js +5 -8
- package/dist/release/load.js +4 -4
- package/dist/release/manifest.js +9 -10
- package/dist/release/oasdiff.d.ts +10 -15
- package/dist/release/oasdiff.js +5 -6
- package/dist/release/registries.d.ts +0 -11
- package/dist/release/registries.js +17 -17
- package/dist/release/release-state.d.ts +16 -13
- package/dist/release/release-workflow.js +5 -7
- package/dist/release/repo-settings.d.ts +2 -1
- package/dist/release/spec-gate.d.ts +0 -2
- package/dist/release/spec-gate.js +6 -10
- package/dist/release/sync-command.d.ts +2 -2
- package/dist/release/sync-command.js +1 -1
- package/dist/release/sync-tree.js +9 -13
- package/dist/release/sync.d.ts +6 -6
- package/dist/release/sync.js +12 -13
- package/dist/release/types.d.ts +22 -22
- package/dist/release/types.js +0 -1
- package/dist/release/version-files.d.ts +3 -4
- package/dist/release/version-files.js +4 -5
- package/dist/runtime/.oxfmtrc.jsonc +8 -0
- package/dist/runtime/csharp/Config.cs +9 -1
- package/dist/runtime/csharp/Exchange.cs +56 -4
- package/dist/runtime/csharp/Hooks.cs +9 -0
- package/dist/runtime/csharp/Operation.cs +6 -1
- package/dist/runtime/csharp/WsDial.cs +3 -1
- package/dist/runtime/go/config.go +5 -0
- package/dist/runtime/go/hooks.go +70 -0
- package/dist/runtime/go/request.go +6 -2
- package/dist/runtime/go/stream.go +4 -1
- package/dist/runtime/go/ws.go +3 -1
- package/dist/runtime/java/ClientConfig.java +11 -0
- package/dist/runtime/java/Flight.java +2 -12
- package/dist/runtime/java/Hooks.java +45 -0
- package/dist/runtime/java/InvalidateEvent.java +10 -0
- package/dist/runtime/java/InvalidateHook.java +12 -0
- package/dist/runtime/java/InvalidateTarget.java +7 -0
- package/dist/runtime/java/Operation.java +23 -3
- package/dist/runtime/java/Realtime.java +3 -1
- package/dist/runtime/java/WsDial.java +3 -0
- package/dist/runtime/mcp/files.ts +1 -1
- package/dist/runtime/mcp/http.ts +6 -2
- package/dist/runtime/mcp/listen.ts +1 -1
- package/dist/runtime/mcp/mount.ts +2 -2
- package/dist/runtime/mcp/protocol.ts +1 -1
- package/dist/runtime/python/config.py +8 -2
- package/dist/runtime/python/exchange.py +3 -1
- package/dist/runtime/python/hooks.py +110 -5
- package/dist/runtime/python/operation.py +2 -0
- package/dist/runtime/python/send_async.py +14 -2
- package/dist/runtime/python/send_sync.py +4 -2
- package/dist/runtime/python/ws.py +5 -1
- package/dist/runtime/rust/config.rs +6 -1
- package/dist/runtime/rust/exchange.rs +15 -3
- package/dist/runtime/rust/hooks.rs +127 -2
- package/dist/runtime/rust/log.rs +11 -3
- package/dist/runtime/rust/request.rs +17 -0
- package/dist/runtime/rust/ws.rs +9 -1
- package/dist/runtime/ts/config.ts +69 -0
- package/dist/runtime/ts/http.ts +12 -10
- package/dist/runtime/ts/request.ts +2 -0
- package/dist/runtime/ts/response.ts +7 -0
- package/dist/runtime/ts/sdk-invalidate.ts +82 -0
- package/dist/runtime/ts/sdk-single-flight.constants.ts +25 -0
- package/dist/runtime/ts/sdk-single-flight.ts +203 -0
- package/dist/runtime/ts/sdk-sse.ts +5 -1
- package/dist/runtime/ts/sdk-ws.ts +9 -3
- package/dist/runtime/ts/sdk.ts +55 -31
- package/dist/runtime/ts/single-flight-batch.ts +184 -0
- package/dist/runtime/ts/single-flight-body.ts +59 -0
- package/dist/runtime/ts/single-flight-run.ts +160 -0
- package/dist/runtime/ts/single-flight.constants.ts +31 -0
- package/dist/runtime/ts/single-flight.ts +158 -0
- package/dist/runtime/ts-tanstack-query/invalidate.ts +96 -92
- package/dist/runtime/ts-tanstack-query/query.ts +140 -170
- package/package.json +12 -17
- package/references/INDEX.md +31 -0
- package/references/cli.md +33 -0
- package/references/configuring.md +29 -0
- package/references/documentation.md +15 -0
- package/references/errors.md +23 -0
- package/references/flags.md +104 -0
- package/references/gates.md +46 -0
- package/references/generate.md +29 -0
- package/references/install-scripts.md +28 -0
- package/references/install.md +38 -0
- package/references/license.md +8 -0
- package/references/mcp.md +76 -0
- package/references/output.md +45 -0
- package/references/overview.md +14 -0
- package/references/release-tooling.md +34 -0
- package/references/release.md +305 -0
- package/references/sdks.md +393 -0
- package/references/start.md +22 -0
- package/references/tdd.md +16 -0
- package/dist/emit/cli/index.d.ts +0 -1
- package/dist/emit/cli/index.js +0 -1
- package/dist/emit/csharp/index.d.ts +0 -1
- package/dist/emit/csharp/index.js +0 -1
- package/dist/emit/go/index.d.ts +0 -1
- package/dist/emit/go/index.js +0 -1
- package/dist/emit/java/index.d.ts +0 -2
- package/dist/emit/java/index.js +0 -2
- package/dist/emit/mcp/index.d.ts +0 -3
- package/dist/emit/mcp/index.js +0 -3
- package/dist/emit/python/index.d.ts +0 -1
- package/dist/emit/python/index.js +0 -1
- package/dist/emit/rust/index.d.ts +0 -1
- package/dist/emit/rust/index.js +0 -1
|
@@ -1,21 +1,19 @@
|
|
|
1
|
-
import { defineConfig } from "@workerstack/clients/installers"
|
|
1
|
+
import { defineConfig } from "@workerstack/clients/installers";
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
* install.ps1
|
|
9
|
-
*/
|
|
3
|
+
// GitHub Releases. Assets live at releases/download/<tag>/; each release also uploads:
|
|
4
|
+
//
|
|
5
|
+
// version.txt "v1.2.3", read through the releases/latest/download/ redirect
|
|
6
|
+
// install.sh served from releases/latest/download/ too
|
|
7
|
+
// install.ps1
|
|
10
8
|
export default defineConfig({
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
})
|
|
9
|
+
assetPath: ({ tag, version, os, arch }) =>
|
|
10
|
+
`download/${tag}/my-cli_${version}_${os}_${arch}${os === "windows" ? ".zip" : ".tar.gz"}`,
|
|
11
|
+
baseUrl: "https://github.com/acme/my-cli/releases",
|
|
12
|
+
checksumsPath: ({ tag, version }) => `download/${tag}/my-cli_${version}_checksums.txt`,
|
|
13
|
+
latestPath: "latest/download/version.txt",
|
|
14
|
+
name: "my-cli",
|
|
15
|
+
scriptUrls: {
|
|
16
|
+
ps1: "https://github.com/acme/my-cli/releases/latest/download/install.ps1",
|
|
17
|
+
sh: "https://github.com/acme/my-cli/releases/latest/download/install.sh",
|
|
18
|
+
},
|
|
19
|
+
});
|
|
@@ -1,21 +1,19 @@
|
|
|
1
|
-
import { defineConfig, type Arch, type Os } from "@workerstack/clients/installers"
|
|
1
|
+
import { defineConfig, type Arch, type Os } from "@workerstack/clients/installers";
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
const osName: Record<Os, string> = { linux: "Linux", darwin: "Darwin", windows: "Windows" }
|
|
12
|
-
const archName: Record<Arch, string> = { amd64: "x86_64", arm64: "arm64" }
|
|
3
|
+
// GoReleaser's `goreleaser init` archive names, uploaded to your own host under the tag:
|
|
4
|
+
//
|
|
5
|
+
// v1.2.3/my-cli_Linux_x86_64.tar.gz
|
|
6
|
+
// v1.2.3/my-cli_Windows_arm64.zip
|
|
7
|
+
// v1.2.3/my-cli_1.2.3_checksums.txt
|
|
8
|
+
// latest "v1.2.3"
|
|
9
|
+
const osName: Record<Os, string> = { darwin: "Darwin", linux: "Linux", windows: "Windows" };
|
|
10
|
+
const archName: Record<Arch, string> = { amd64: "x86_64", arm64: "arm64" };
|
|
13
11
|
|
|
14
12
|
export default defineConfig({
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
})
|
|
13
|
+
assetPath: ({ tag, os, arch }) =>
|
|
14
|
+
`${tag}/my-cli_${osName[os]}_${archName[arch]}${os === "windows" ? ".zip" : ".tar.gz"}`,
|
|
15
|
+
baseUrl: "https://dl.example.com/my-cli",
|
|
16
|
+
checksumsPath: ({ tag, version }) => `${tag}/my-cli_${version}_checksums.txt`,
|
|
17
|
+
message: "Run `my-cli --help` to get started.",
|
|
18
|
+
name: "my-cli",
|
|
19
|
+
});
|
|
@@ -1,17 +1,15 @@
|
|
|
1
|
-
import { defineConfig } from "@workerstack/clients/installers"
|
|
1
|
+
import { defineConfig } from "@workerstack/clients/installers";
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
* latest "1.2.3"
|
|
10
|
-
*/
|
|
3
|
+
// Raw binaries on your own host:
|
|
4
|
+
//
|
|
5
|
+
// 1.2.3/my-cli-linux-amd64
|
|
6
|
+
// 1.2.3/my-cli-windows-amd64.exe
|
|
7
|
+
// 1.2.3/checksums.txt sha256sum output for every binary
|
|
8
|
+
// latest "1.2.3"
|
|
11
9
|
export default defineConfig({
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
})
|
|
10
|
+
assetPath: ({ version, os, arch }) => `${version}/my-cli-${os}-${arch}${os === "windows" ? ".exe" : ""}`,
|
|
11
|
+
baseUrl: "https://dl.example.com/my-cli",
|
|
12
|
+
checksumsPath: ({ version }) => `${version}/checksums.txt`,
|
|
13
|
+
name: "my-cli",
|
|
14
|
+
tagPrefix: "",
|
|
15
|
+
});
|
package/bin/clients.js
CHANGED
|
@@ -1,94 +1,114 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
// The clients bin (bit 17 phase h). A repository checkout (marked by tsconfig.json, which is not published)
|
|
3
|
-
// runs the TypeScript source
|
|
4
|
-
// dist/ never runs; an installed package runs the compiled JavaScript on any runtime (the tarball ships dist/,
|
|
5
|
-
|
|
6
|
-
import {
|
|
7
|
-
import {
|
|
8
|
-
import {
|
|
3
|
+
// runs the TypeScript source natively (on Bun under the backend-source condition, on Node by its type stripping), so a
|
|
4
|
+
// stale dist/ never runs; an installed package runs the compiled JavaScript on any runtime (the tarball ships dist/,
|
|
5
|
+
// not src/).
|
|
6
|
+
import { spawn } from "node:child_process";
|
|
7
|
+
import { existsSync } from "node:fs";
|
|
8
|
+
import { basename } from "node:path";
|
|
9
|
+
import { fileURLToPath } from "node:url";
|
|
9
10
|
|
|
10
|
-
const isBun = typeof globalThis.Bun !== "undefined"
|
|
11
|
-
const checkout = existsSync(new URL("../tsconfig.json", import.meta.url))
|
|
11
|
+
const isBun = typeof globalThis.Bun !== "undefined";
|
|
12
|
+
const checkout = existsSync(new URL("../tsconfig.json", import.meta.url));
|
|
12
13
|
|
|
13
14
|
// `bun run` and `bunx` start this file through its node shebang, while what they run is meant for Bun: hand over to
|
|
14
15
|
// the Bun that started us, which they name in npm_execpath. Once, never again in the child.
|
|
15
16
|
function invokingBun() {
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
17
|
+
if (isBun || process.env.CLIENTS_NO_BUN_HANDOFF === "1") return null;
|
|
18
|
+
|
|
19
|
+
if (!process.env.npm_config_user_agent?.startsWith("bun/")) return null;
|
|
20
|
+
const bun = process.env.npm_execpath;
|
|
21
|
+
|
|
22
|
+
if (!bun || !/^bunx?(\.exe)?$/.test(basename(bun)) || !existsSync(bun)) return null;
|
|
23
|
+
|
|
24
|
+
return bun;
|
|
21
25
|
}
|
|
22
26
|
|
|
23
27
|
// The handoff: Bun runs this file with our arguments and `env` over ours; a signal we get is passed on to it, and we
|
|
24
28
|
// end as it ended, its exit code or the same signal.
|
|
25
29
|
function handOff(bun, env) {
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
30
|
+
// Forwarders first: a signal landing as spawn returns would otherwise end this process by its default action,
|
|
31
|
+
// orphaning the child. A handler runs from the event loop, after this block, so `child` is set by then.
|
|
32
|
+
let child;
|
|
33
|
+
const forward = (signal) => child.kill(signal);
|
|
34
|
+
|
|
35
|
+
for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) process.on(signal, forward);
|
|
36
|
+
child = spawn(bun, [fileURLToPath(import.meta.url), ...process.argv.slice(2)], {
|
|
37
|
+
env: { ...process.env, ...env, CLIENTS_NO_BUN_HANDOFF: "1" },
|
|
38
|
+
stdio: "inherit",
|
|
39
|
+
});
|
|
40
|
+
child.on("error", (error) => {
|
|
41
|
+
console.error(`clients: could not start ${bun}: ${error.message}`);
|
|
42
|
+
process.exit(1);
|
|
43
|
+
});
|
|
44
|
+
child.on("exit", (code, signal) => {
|
|
45
|
+
if (signal) {
|
|
46
|
+
for (const each of ["SIGINT", "SIGTERM", "SIGHUP"]) process.off(each, forward);
|
|
47
|
+
process.kill(process.pid, signal);
|
|
48
|
+
|
|
49
|
+
return;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
process.exit(code ?? 1);
|
|
53
|
+
});
|
|
47
54
|
}
|
|
48
55
|
|
|
49
56
|
// A checkout on Bun runs under the backend-source condition: an --app module's checkout core then resolves to its
|
|
50
57
|
// source, never to an unbuilt or stale dist/ (bit 20). Set through BUN_OPTIONS when the caller did not, in the one
|
|
51
58
|
// handoff, so a watch's generation children inherit it; Bun reports BUN_OPTIONS' flags in execArgv, so a Bun started
|
|
52
59
|
// with it never hands off again.
|
|
53
|
-
const SOURCE_CONDITION = "--conditions=backend-source"
|
|
54
|
-
const unconditioned = isBun && checkout && !process.execArgv.includes(SOURCE_CONDITION)
|
|
60
|
+
const SOURCE_CONDITION = "--conditions=backend-source";
|
|
61
|
+
const unconditioned = isBun && checkout && !process.execArgv.includes(SOURCE_CONDITION);
|
|
62
|
+
|
|
55
63
|
// The hand-off's backstop: its child carries CLIENTS_BUN_HANDOFF, the depth of hand-offs before it. A child that would
|
|
56
64
|
// hand off again (the condition set but not in its execArgv) refuses instead of re-running itself without end.
|
|
57
|
-
const handOffDepth = Number(process.env.CLIENTS_BUN_HANDOFF ?? 0)
|
|
65
|
+
const handOffDepth = Number(process.env.CLIENTS_BUN_HANDOFF ?? 0);
|
|
66
|
+
|
|
58
67
|
const sourceEnv = checkout
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
68
|
+
? {
|
|
69
|
+
BUN_OPTIONS: `${process.env.BUN_OPTIONS ?? ""} ${SOURCE_CONDITION}`.trim(),
|
|
70
|
+
CLIENTS_BUN_HANDOFF: String(handOffDepth + 1),
|
|
71
|
+
}
|
|
72
|
+
: {};
|
|
64
73
|
|
|
74
|
+
/**
|
|
75
|
+
* The module to run: the source, or the build compiled from it, typed as the source.
|
|
76
|
+
*
|
|
77
|
+
* @returns {Promise<typeof import("../src/cli.ts")>}
|
|
78
|
+
*/
|
|
65
79
|
async function entry() {
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
+
if (checkout) {
|
|
81
|
+
// Node strips the source's types by default from 22.18
|
|
82
|
+
return import("../src/cli.ts");
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
try {
|
|
86
|
+
// typed as the source it compiles from, so lint reads the same types with or without a build
|
|
87
|
+
return /** @type {typeof import("../src/cli.ts")} */ (await import("../dist/cli.js"));
|
|
88
|
+
} catch (error) {
|
|
89
|
+
if (error?.code === "ERR_MODULE_NOT_FOUND" && String(error.url).endsWith("/dist/cli.js")) {
|
|
90
|
+
console.error("clients: dist/ is missing from this install. Reinstall it, or run it with Bun.");
|
|
91
|
+
process.exit(1);
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
throw error;
|
|
95
|
+
}
|
|
80
96
|
}
|
|
81
97
|
|
|
82
|
-
const bun = invokingBun()
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
98
|
+
const bun = invokingBun();
|
|
99
|
+
|
|
100
|
+
if (bun) {
|
|
101
|
+
handOff(bun, sourceEnv);
|
|
102
|
+
} else if (unconditioned && handOffDepth >= 1) {
|
|
103
|
+
console.error("clients: Bun hand-off loop: --conditions=backend-source not visible after re-exec");
|
|
104
|
+
process.exit(1);
|
|
105
|
+
} else if (unconditioned) {
|
|
106
|
+
handOff(process.execPath, sourceEnv);
|
|
107
|
+
} else {
|
|
108
|
+
const { main } = await entry();
|
|
109
|
+
const code = await main(process.argv.slice(2));
|
|
110
|
+
|
|
111
|
+
// an --app module may leave a timer or a socket open: the run is over once main returns, its output flushed
|
|
112
|
+
for (const stream of [process.stdout, process.stderr]) await new Promise((done) => stream.write("", done));
|
|
113
|
+
process.exit(code);
|
|
94
114
|
}
|
package/bin/installgen.js
CHANGED
|
@@ -1,19 +1,24 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
// The installgen bin. A repository checkout (marked by tsconfig.json, which is not published) runs the TypeScript
|
|
3
|
-
// source
|
|
4
|
-
//
|
|
5
|
-
import { existsSync } from "node:fs"
|
|
3
|
+
// source natively (Node by its type stripping), so a stale build never runs; an installed package runs the compiled
|
|
4
|
+
// JavaScript (the tarball ships it, not src/).
|
|
5
|
+
import { existsSync } from "node:fs";
|
|
6
6
|
|
|
7
|
-
const checkout = existsSync(new URL("../tsconfig.json", import.meta.url))
|
|
7
|
+
const checkout = existsSync(new URL("../tsconfig.json", import.meta.url));
|
|
8
8
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
9
|
+
/**
|
|
10
|
+
* The module to run: the source, or the build compiled from it, typed as the source.
|
|
11
|
+
*
|
|
12
|
+
* @returns {Promise<typeof import("../src/installers/cli.ts")>}
|
|
13
|
+
*/
|
|
14
|
+
function entry() {
|
|
15
|
+
// Node strips the source's types by default from 22.18
|
|
16
|
+
if (checkout) return import("../src/installers/cli.ts");
|
|
17
|
+
|
|
18
|
+
// typed as the source it compiles from, so lint reads the same types with or without a build
|
|
19
|
+
return /** @type {Promise<typeof import("../src/installers/cli.ts")>} */ (import("../dist/installers/cli.js"));
|
|
16
20
|
}
|
|
17
21
|
|
|
18
|
-
const { start } = await entry()
|
|
19
|
-
|
|
22
|
+
const { start } = await entry();
|
|
23
|
+
|
|
24
|
+
await start();
|
package/dist/cli.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { type Metadata, type PackageIdentity } from "./emit/shared/metadata.ts";
|
|
2
|
-
import { type Target, type TargetOptions } from "./gen/targets.ts";
|
|
3
2
|
import { type ReadFile } from "./gen/shipped.ts";
|
|
3
|
+
import { type Target, type TargetOptions } from "./gen/targets.ts";
|
|
4
4
|
/**
|
|
5
5
|
* What one run generates: its targets, and each target's options by name (a target whose options are left out
|
|
6
6
|
* takes its generator's defaults). The CLI parses `generate` into one of these; a consumer writes one by hand.
|
|
@@ -86,17 +86,17 @@ export declare function writeGenerated(run: GenerateRun & {
|
|
|
86
86
|
/** What a run takes beside its arguments: the environment, the directory paths resolve from, a watch's stop signal. */
|
|
87
87
|
export type RunOptions = {
|
|
88
88
|
/** The directory the spec, the app module and `--out` resolve from. Defaults to the process's. */
|
|
89
|
-
readonly cwd?: string;
|
|
89
|
+
readonly cwd?: string | undefined;
|
|
90
90
|
/**
|
|
91
91
|
* The environment formatters are looked up in, laid over the process's for each `--watch` child. Defaults to the
|
|
92
92
|
* process's.
|
|
93
93
|
*/
|
|
94
|
-
readonly env?: NodeJS.ProcessEnv;
|
|
94
|
+
readonly env?: NodeJS.ProcessEnv | undefined;
|
|
95
95
|
/**
|
|
96
96
|
* Stops a `--watch` run, which ends with 0 once the generation in progress finishes. Without it a watch never
|
|
97
97
|
* returns.
|
|
98
98
|
*/
|
|
99
|
-
readonly signal?: AbortSignal;
|
|
99
|
+
readonly signal?: AbortSignal | undefined;
|
|
100
100
|
};
|
|
101
101
|
/** Runs `clients <argv>`: the exit code it ends with (a watch ends only by `options.signal`). */
|
|
102
102
|
export declare function main(argv: readonly string[], io?: Io, options?: RunOptions): Promise<number>;
|
package/dist/cli.js
CHANGED
|
@@ -19,39 +19,47 @@ import { generateMcpServer } from "./emit/mcp/server.js";
|
|
|
19
19
|
import { generatePythonSdk } from "./emit/python/sdk.js";
|
|
20
20
|
import { generateRustSdk } from "./emit/rust/sdk.js";
|
|
21
21
|
import { formatFiles } from "./emit/shared/format.js";
|
|
22
|
+
import { checkedMetadata, shippedOf } from "./emit/shared/metadata.js";
|
|
22
23
|
import { generateSdkPackage } from "./emit/ts/package.js";
|
|
23
24
|
import { parseGenerate, usage, UsageError } from "./gen/args.js";
|
|
24
25
|
import { FORMATTERS, formatterFor, missingFormatter } from "./gen/formatters.js";
|
|
25
26
|
import { runCli } from "./gen/process.js";
|
|
26
|
-
import { appRef, loadAppDocument } from "./ir/load.js";
|
|
27
|
-
import { checkedMetadata, shippedOf } from "./emit/shared/metadata.js";
|
|
28
|
-
import { optionsFor } from "./gen/targets.js";
|
|
29
27
|
import { shippedFiles } from "./gen/shipped.js";
|
|
28
|
+
import { SWITCH_ON } from "./gen/switch-on.constants.js";
|
|
29
|
+
import { optionsFor } from "./gen/targets.js";
|
|
30
30
|
import { writeTarget } from "./gen/write.js";
|
|
31
|
+
import { appRef, loadAppDocument } from "./ir/load.js";
|
|
31
32
|
import { release } from "./release/cli.js";
|
|
32
33
|
/** One SDK target's generation: its files, its package's identity on each registry, and what it reports (a name it renamed). */
|
|
33
34
|
function sdkOf(target, document, options, metadata) {
|
|
34
35
|
switch (target) {
|
|
35
|
-
case "ts":
|
|
36
|
-
|
|
37
|
-
|
|
36
|
+
case "ts": {
|
|
37
|
+
// mapped key by key, never spread: `options` holds strings, and `singleFlight` and `tanstackQuery` are booleans —
|
|
38
|
+
// a spread under a cast would make "false" as truthy as "true"
|
|
38
39
|
return generateSdkPackage(document, {
|
|
39
40
|
name: options.name ?? "SDK",
|
|
40
41
|
...(options.packageName === undefined ? {} : { packageName: options.packageName }),
|
|
42
|
+
singleFlight: options.singleFlight === SWITCH_ON,
|
|
41
43
|
...(options.stem === undefined ? {} : { stem: options.stem }),
|
|
42
44
|
tanstackQuery: options.tanstackQuery === "true",
|
|
43
45
|
...(options.version === undefined ? {} : { version: options.version }),
|
|
44
46
|
}, metadata);
|
|
45
|
-
|
|
47
|
+
}
|
|
48
|
+
case "go": {
|
|
46
49
|
return generateGoSdk(document, options);
|
|
47
|
-
|
|
50
|
+
}
|
|
51
|
+
case "rust": {
|
|
48
52
|
return generateRustSdk(document, options, shippedOf(metadata));
|
|
49
|
-
|
|
53
|
+
}
|
|
54
|
+
case "python": {
|
|
50
55
|
return generatePythonSdk(document, options, metadata);
|
|
51
|
-
|
|
56
|
+
}
|
|
57
|
+
case "csharp": {
|
|
52
58
|
return generateCSharpSdk(document, options, shippedOf(metadata));
|
|
53
|
-
|
|
59
|
+
}
|
|
60
|
+
case "java": {
|
|
54
61
|
return generateJavaSdk(document, options);
|
|
62
|
+
}
|
|
55
63
|
}
|
|
56
64
|
}
|
|
57
65
|
/**
|
|
@@ -168,7 +176,7 @@ function watchSpec(run, argv, io, options) {
|
|
|
168
176
|
/** Runs `clients <argv>`: the exit code it ends with (a watch ends only by `options.signal`). */
|
|
169
177
|
export async function main(argv, io = PROCESS_IO, options = {}) {
|
|
170
178
|
try {
|
|
171
|
-
|
|
179
|
+
// release has subcommands of its own, each with its own --help
|
|
172
180
|
if (argv[0] === "release")
|
|
173
181
|
return await release(argv.slice(1), io, { env: options.env });
|
|
174
182
|
if (argv.length === 0 || argv[0] === "-h" || argv[0] === "--help" || argv.includes("--help")) {
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/** The Linux package formats nfpm builds. */
|
|
2
|
-
|
|
3
|
-
|
|
2
|
+
declare const PACKAGE_FORMATS: readonly ["deb", "rpm", "apk"];
|
|
3
|
+
type PackageFormat = (typeof PACKAGE_FORMATS)[number];
|
|
4
4
|
/** What a package manager shows about the CLI. */
|
|
5
5
|
type About = {
|
|
6
6
|
readonly description: string;
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
import { checked, HTTPS_URL, PERSON, refuse, SPDX_EXPRESSION } from "../shared/metadata.js";
|
|
9
9
|
import { q } from "./release.js";
|
|
10
10
|
/** The Linux package formats nfpm builds. */
|
|
11
|
-
|
|
11
|
+
const PACKAGE_FORMATS = ["deb", "rpm", "apk"];
|
|
12
12
|
/** The secret each channel's push reads, by the environment variable goreleaser's config names. */
|
|
13
13
|
export const SECRETS = {
|
|
14
14
|
aur: "AUR_SSH_KEY",
|
|
@@ -17,13 +17,13 @@ export const SECRETS = {
|
|
|
17
17
|
scoop: "SCOOP_BUCKET_TOKEN",
|
|
18
18
|
winget: "WINGET_TOKEN",
|
|
19
19
|
};
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
20
|
+
// a description: one line of printable text, at most 256 characters (winget's ShortDescription); a winget
|
|
21
|
+
// publisher: a name of letters, digits, spaces and `.,&'-`, at most 64 characters; a homepage, an install URL, a
|
|
22
|
+
// license and a maintainer take the grammars every target's package metadata shares (../shared/metadata.ts)
|
|
23
23
|
const DESCRIPTION = /^\P{Cc}{1,256}$/u;
|
|
24
24
|
const PUBLISHER = /^[A-Za-z0-9][A-Za-z0-9 .,&'-]{0,63}$/;
|
|
25
|
-
|
|
26
|
-
|
|
25
|
+
// a GitHub repository: its owner 1 to 39 letters, digits and single inner hyphens; its name 1 to 100 of letters,
|
|
26
|
+
// digits, `.`, `_` and `-`, not `.` or `..` and not ending in `.git`
|
|
27
27
|
export const REPO = /^[A-Za-z0-9](?:-?[A-Za-z0-9]){0,38}\/(?!\.\.?$)(?![\s\S]*\.git$)[A-Za-z0-9._-]{1,100}$/;
|
|
28
28
|
/** `owner/name` split, once REPO has checked it. */
|
|
29
29
|
const split = (repo) => {
|
|
@@ -93,7 +93,7 @@ export function resolvedRelease(options, repo) {
|
|
|
93
93
|
channels.push({ about: about("homebrew-tap"), kind: "homebrew", ...tap });
|
|
94
94
|
if (bucket !== undefined)
|
|
95
95
|
channels.push({ about: about("scoop-bucket"), kind: "scoop", ...bucket });
|
|
96
|
-
|
|
96
|
+
// winget needs both: the fork it pushes the manifests to, and the publisher they are filed under
|
|
97
97
|
if (fork === undefined && publisher !== undefined)
|
|
98
98
|
needed("winget-fork", undefined, "winget-publisher");
|
|
99
99
|
if (fork !== undefined) {
|
|
@@ -138,7 +138,7 @@ const aboutLines = ({ description, homepage, license }, descriptionKey = "descri
|
|
|
138
138
|
/** The goreleaser block for one channel of `bin`. */
|
|
139
139
|
export function channelBlock(bin, channel) {
|
|
140
140
|
switch (channel.kind) {
|
|
141
|
-
case "homebrew":
|
|
141
|
+
case "homebrew": {
|
|
142
142
|
return `# the Homebrew cask, pushed to the tap; the binaries are not notarized, so it clears macOS's quarantine flag
|
|
143
143
|
homebrew_casks:
|
|
144
144
|
- name: ${q(bin)}
|
|
@@ -150,19 +150,21 @@ ${pushTo(channel.owner, channel.name, SECRETS.homebrew, " ")}${aboutLines(cha
|
|
|
150
150
|
system_command "/usr/bin/xattr", args: ["-dr", "com.apple.quarantine", "#{staged_path}/${bin}"]
|
|
151
151
|
end
|
|
152
152
|
`;
|
|
153
|
-
|
|
153
|
+
}
|
|
154
|
+
case "scoop": {
|
|
154
155
|
return `# the Scoop manifest, pushed to the bucket
|
|
155
156
|
scoops:
|
|
156
157
|
- name: ${q(bin)}
|
|
157
158
|
skip_upload: auto
|
|
158
159
|
${pushTo(channel.owner, channel.name, SECRETS.scoop, " ")}${aboutLines(channel.about)}`;
|
|
159
|
-
|
|
160
|
+
}
|
|
161
|
+
case "winget": {
|
|
160
162
|
return `# the winget manifests, pushed to the fork and proposed to microsoft/winget-pkgs
|
|
161
163
|
winget:
|
|
162
164
|
- name: ${q(bin)}
|
|
163
165
|
skip_upload: auto
|
|
164
166
|
publisher: ${q(channel.publisher)}
|
|
165
|
-
package_identifier: ${q(`${channel.publisher.
|
|
167
|
+
package_identifier: ${q(`${channel.publisher.replaceAll(/[^A-Za-z0-9]/g, "")}.${bin}`)}
|
|
166
168
|
${aboutLines(channel.about, "short_description")} repository:
|
|
167
169
|
owner: ${q(channel.owner)}
|
|
168
170
|
name: ${q(channel.name)}
|
|
@@ -175,7 +177,8 @@ ${aboutLines(channel.about, "short_description")} repository:
|
|
|
175
177
|
name: winget-pkgs
|
|
176
178
|
branch: master
|
|
177
179
|
`;
|
|
178
|
-
|
|
180
|
+
}
|
|
181
|
+
case "aur": {
|
|
179
182
|
return `# the AUR ${bin}-bin package, pushed over SSH
|
|
180
183
|
aurs:
|
|
181
184
|
- name: ${q(`${bin}-bin`)}
|
|
@@ -184,7 +187,8 @@ ${aboutLines(channel.about)} maintainers: [${q(channel.about.maintainer)}]
|
|
|
184
187
|
private_key: "{{ .Env.${SECRETS.aur} }}"
|
|
185
188
|
git_url: ${q(`ssh://aur@aur.archlinux.org/${bin}-bin.git`)}
|
|
186
189
|
`;
|
|
187
|
-
|
|
190
|
+
}
|
|
191
|
+
case "packages": {
|
|
188
192
|
return `# Linux packages beside the archives, each named ${bin}_<os>_<arch>
|
|
189
193
|
nfpms:
|
|
190
194
|
- id: ${q(bin)}
|
|
@@ -193,5 +197,6 @@ nfpms:
|
|
|
193
197
|
formats: [${channel.formats.join(", ")}]
|
|
194
198
|
${aboutLines(channel.about)} maintainer: ${q(channel.about.maintainer)}
|
|
195
199
|
`;
|
|
200
|
+
}
|
|
196
201
|
}
|
|
197
202
|
}
|
|
@@ -10,7 +10,7 @@ import type { IR } from "../../ir/model.ts";
|
|
|
10
10
|
import type { SdkOp } from "../../ir/sdk-model.ts";
|
|
11
11
|
import type { GoCallPlan } from "../go/sdk-client.ts";
|
|
12
12
|
/** The root's own commands, each taken before an operation's. */
|
|
13
|
-
export declare const BUILT_INS: string[];
|
|
13
|
+
export declare const BUILT_INS: readonly string[];
|
|
14
14
|
/** A command node: a group of others, or one operation's command. */
|
|
15
15
|
export type CommandNode = {
|
|
16
16
|
readonly name: string;
|
|
@@ -41,7 +41,7 @@ export function commandTree(ops, plans) {
|
|
|
41
41
|
return named(rawTree(ops, plans), [], new NameScope(BUILT_INS), new NameScope(["Root", "newClient", "failed"]));
|
|
42
42
|
}
|
|
43
43
|
/** A named type of the SDK's, as package cmd spells it: `sdk.` before each exported name. */
|
|
44
|
-
const qualified = (type) => type.
|
|
44
|
+
const qualified = (type) => type.replaceAll(/(?<![\w.])([A-Z]\w*)/g, "sdk.$1");
|
|
45
45
|
/** A multipart body's statements: each file part from its opened files, each text part from its flag. */
|
|
46
46
|
function multipartLines(type, parts) {
|
|
47
47
|
const lines = [`\tvar body ${type}`];
|
|
@@ -67,18 +67,22 @@ function bodyLines(op, plan, flags) {
|
|
|
67
67
|
const fail = ["\tif err != nil {", "\t\treturn err", "\t}"];
|
|
68
68
|
switch (body.kind) {
|
|
69
69
|
case "json": {
|
|
70
|
-
|
|
70
|
+
// a pointer type decodes as well: json.Unmarshal allocates it, and an absent optional body stays nil
|
|
71
71
|
const read = `\tif err := p.JSON(&body, ${required}, ${map}); err != nil {`;
|
|
72
72
|
return [[`\tvar body ${qualified(plan.bodyType)}`, read, "\t\treturn err", "\t}"], ", body"];
|
|
73
73
|
}
|
|
74
|
-
case "form":
|
|
74
|
+
case "form": {
|
|
75
75
|
return [[`\tbody, err := p.Form(${required}, ${map})`, ...fail], ", body"];
|
|
76
|
-
|
|
76
|
+
}
|
|
77
|
+
case "text": {
|
|
77
78
|
return [[`\tbody, err := p.Text(${required})`, ...fail], ", body"];
|
|
78
|
-
|
|
79
|
+
}
|
|
80
|
+
case "multipart": {
|
|
79
81
|
return [multipartLines(qualified(plan.bodyType), flags.parts), ", body"];
|
|
80
|
-
|
|
82
|
+
}
|
|
83
|
+
default: {
|
|
81
84
|
return [[`\tbody, err := p.Reader(${required})`, ...fail], ", body"];
|
|
85
|
+
}
|
|
82
86
|
}
|
|
83
87
|
}
|
|
84
88
|
/** The check of one message type: an input line decoded as it, holding each field it requires. */
|
|
@@ -101,7 +105,7 @@ function linesChecked(sends) {
|
|
|
101
105
|
*/
|
|
102
106
|
function streamLines(call, stream, sends) {
|
|
103
107
|
const open = ["\tout, err := cli.OpenStream(c)", "\tif err != nil {", "\t\treturn err", "\t}", "\tdefer out.Close()"];
|
|
104
|
-
if (stream === "sse")
|
|
108
|
+
if (stream === "sse") {
|
|
105
109
|
return [
|
|
106
110
|
...open,
|
|
107
111
|
`\tfor event, err := range ${call} {`,
|
|
@@ -115,6 +119,7 @@ function streamLines(call, stream, sends) {
|
|
|
115
119
|
"\t}",
|
|
116
120
|
"\treturn out.Err()",
|
|
117
121
|
];
|
|
122
|
+
}
|
|
118
123
|
return [
|
|
119
124
|
...open,
|
|
120
125
|
`\tconn, err := ${call}`,
|
|
@@ -132,7 +137,7 @@ function callLines(call, plan) {
|
|
|
132
137
|
.map(goString)
|
|
133
138
|
.join(", ");
|
|
134
139
|
const answer = (data) => `\treturn cli.Print(c, cli.Answer{${data}Response: resp, Declared: []string{${declared}}})`;
|
|
135
|
-
if (plan.returns === "error")
|
|
140
|
+
if (plan.returns === "error") {
|
|
136
141
|
return [
|
|
137
142
|
"\tvar resp *http.Response",
|
|
138
143
|
`\tif err := ${call}; err != nil {`,
|
|
@@ -140,6 +145,7 @@ function callLines(call, plan) {
|
|
|
140
145
|
"\t}",
|
|
141
146
|
answer(""),
|
|
142
147
|
];
|
|
148
|
+
}
|
|
143
149
|
return [
|
|
144
150
|
"\tvar resp *http.Response",
|
|
145
151
|
`\tanswer, err := ${call}`,
|
|
@@ -10,12 +10,6 @@
|
|
|
10
10
|
import type { IRSchema } from "../../ir/model.ts";
|
|
11
11
|
import { type SdkModel } from "../../ir/sdk-model.ts";
|
|
12
12
|
import type { CommandNode } from "./commands.ts";
|
|
13
|
-
/** How deep a schema sketch shows objects: deeper ones are `{…}`. */
|
|
14
|
-
export declare const SKETCH_DEPTH = 3;
|
|
15
|
-
/** The longest summary an index line carries, in characters, `…` included. */
|
|
16
|
-
export declare const SUMMARY_MAX = 80;
|
|
17
|
-
/** The most values an index line spells out for an enum: more show as `<enum:N>` (the schema lists them all). */
|
|
18
|
-
export declare const ENUM_MAX = 6;
|
|
19
13
|
/** One API command as discovery shows it. */
|
|
20
14
|
export type Entry = {
|
|
21
15
|
readonly path: string;
|