mirror of
https://github.com/koala73/worldmonitor.git
synced 2026-04-25 17:14:57 +02:00
* feat(proto): generate unified worldmonitor.openapi.yaml bundle Adds a third protoc-gen-openapiv3 invocation that merges every service into a single docs/api/worldmonitor.openapi.yaml spanning all 68 RPCs, using the new bundle support shipped in sebuf 0.11.0 (SebastienMelki/sebuf#158). Per-service YAML/JSON files are untouched and continue to back the Mintlify docs in docs/docs.json. The bundle runs with strategy: all and bundle_only=true so only the aggregate file is emitted, avoiding duplicate-output conflicts with the existing per-service generator. Requires protoc-gen-openapiv3 >= v0.11.0 locally: go install github.com/SebastienMelki/sebuf/cmd/protoc-gen-openapiv3@v0.11.0 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * docs(proto): bump sebuf to v0.11.0 and document unified OpenAPI bundle - Makefile: SEBUF_VERSION v0.7.0 → v0.11.0 (required for bundle support). - proto/buf.gen.yaml: point bundle_server at https://api.worldmonitor.app. - CONTRIBUTING.md: new "OpenAPI Output" section covering per-service specs vs the unified worldmonitor.openapi.yaml bundle, plus a note that all three sebuf plugins must be installed from the pinned version. - AGENTS.md: clarify that `make generate` also produces the unified spec and requires sebuf v0.11.0. - CHANGELOG.md: Unreleased entry announcing the bundle and version bump. Also regenerates the bundle with the updated server URL. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * chore(codegen): regenerate TS client/server with sebuf v0.11.0 Mechanical output of the bumped protoc-gen-ts-client and protoc-gen-ts-server. Two behavioral improvements roll in from sebuf: - Proto enum fields now use the proper `*_UNSPECIFIED` sentinel in default-value checks instead of the empty string, so generated query-string serializers correctly omit enum params only when they actually equal the proto default. - `repeated string` query params now serialize via `forEach(v => params.append(...))` instead of being coerced through `String(req.field)`, matching the existing `parseStringArray()` contract on the server side. All files also drop the `// @ts-nocheck` header that earlier sebuf versions emitted — 0.11.0 output type-checks cleanly under our tsconfig. No hand edits. Reproduce with `make install-plugins && make generate`. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * fix(proto): bump sebuf v0.11.0 → v0.11.1, realign tests with repeated-param wire format - Bump SEBUF_VERSION to v0.11.1, pulling in the OpenAPI fix for repeated scalar query params (SebastienMelki/sebuf#161). `repeated string` fields now emit `type: array` + `items.type: string` + `style: form` + `explode: true` instead of `type: string`, so SDK generators consuming the unified bundle produce correct array clients. - Regenerate all 12 OpenAPI specs (unified bundle + Aviation, Economic, Infrastructure, Market, Trade per-service). TS client/server codegen is byte-identical to v0.11.0 — only the OpenAPI emitter was out of sync. - Update three tests that asserted the pre-v0.11 comma-joined wire format (`symbols=AAPL,MSFT`) to match the current repeated-param form (`symbols=AAPL&symbols=MSFT`) produced by `params.append(...)`: - tests/market-service-symbol-casing.test.mjs (2 cases: getAll) - tests/stock-analysis-history.test.mts - tests/stock-backtest.test.mts Locally: test:data 6619/6619 pass, typecheck clean, lint exit 0. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * Apply suggestions from code review Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com> --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com> Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>
48 lines
1.3 KiB
YAML
48 lines
1.3 KiB
YAML
version: v2
|
|
|
|
# Managed mode - automatically manages go_package options required by Go-based protoc plugins
|
|
managed:
|
|
enabled: true
|
|
override:
|
|
- file_option: go_package_prefix
|
|
value: github.com/worldmonitor/proto
|
|
- file_option: go_package_prefix
|
|
module: buf.build/bufbuild/protovalidate
|
|
value: ""
|
|
# sebuf protos are now vendored locally (no BSR module override needed)
|
|
|
|
plugins:
|
|
- local: protoc-gen-ts-client
|
|
out: ../src/generated/client
|
|
opt:
|
|
- paths=source_relative
|
|
|
|
- local: protoc-gen-ts-server
|
|
out: ../src/generated/server
|
|
opt:
|
|
- paths=source_relative
|
|
|
|
- local: protoc-gen-openapiv3
|
|
out: ../docs/api
|
|
|
|
- local: protoc-gen-openapiv3
|
|
out: ../docs/api
|
|
opt:
|
|
- format=json
|
|
|
|
# Unified bundle spanning all WorldMonitor services (sebuf >= 0.11.0).
|
|
# Emits docs/api/worldmonitor.openapi.yaml alongside the per-service files.
|
|
- local: protoc-gen-openapiv3
|
|
out: ../docs/api
|
|
strategy: all
|
|
opt:
|
|
- bundle=true
|
|
- bundle_only=true
|
|
- bundle_output=worldmonitor.openapi.yaml
|
|
- bundle_title=WorldMonitor API
|
|
- bundle_version=1.0.0
|
|
- bundle_description=Unified OpenAPI bundle spanning all WorldMonitor services.
|
|
- bundle_server=https://api.worldmonitor.app
|
|
- bundle_contact_name=WorldMonitor
|
|
- bundle_contact_email=support@worldmonitor.app
|