chore(express): scaffold batched OpenAPI generation

- Add a cumulative OpenAPI batch entrypoint for Express routes
- Add the initial /api/v1/ping endpoint specification
- Configure the docs updater for the openapi-express service
- Target api-docs/services/openapi-express.yaml
- Keep the workflow manual until the first batch is reviewed
- Support adding additional endpoints incrementally in later PRs

Ticket: WCI-1581

Author: Charan-Ratlan

.github/workflows/update-api-docs.yaml

@@ -0,0 +1,26 @@
+---
+name: Update BitGo Express API docs
+
+# Kept manual until the first OpenAPI batch is added to openapi-index.ts.
+on:
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  generate-and-update-api-docs:
+    uses: BitGo/gha-dev-portal-updater/.github/workflows/generate-and-update.yml@645bcc9d1e669f5b53eebc0121eede056569ca1a # v5.38.0
+    with:
+      target-repo: api-docs
+      service-name: platform-express
+      types-package-path: ./modules/express
+      api-spec-file: src/typedRoutes/api/openapi-index.ts
+      api-spec-title: BitGo Express API
+      codec-config-file: ./modules/express/openapi-generator.rc.js
+      remote-working-directory: ''
+    secrets: inherit

modules/express/src/typedRoutes/api/openapi-index.ts

@@ -0,0 +1,14 @@
+import { apiSpec } from '@api-ts/io-ts-http';
+import { PostWalletSweep } from './v2/walletSweep';
+
+/**
+ * Cumulative OpenAPI batch entrypoint.
+ *
+ * Add approved route specs here as they are introduced. Keep previously added
+ * routes in this object so generated/openapi-express.yaml remains cumulative.
+ */
+export const ExpressOpenApiSpec = apiSpec({
+  'express.wallet.sweep': {
+    post: PostWalletSweep,
+  },
+});

modules/express/src/typedRoutes/api/v2/walletSweep.ts

@@ -1,5 +1,5 @@
 import * as t from 'io-ts';
-import { httpRoute, httpRequest, optional } from '@api-ts/io-ts-http';
+import { httpRoute, httpRequest, optional, type HttpRoute } from '@api-ts/io-ts-http';
 import { BitgoExpressError } from '../../schemas/error';
 import { SendManyResponse } from './sendmany';
 
@@ -55,7 +55,7 @@ export const WalletSweepBody = {
  * @operationId express.wallet.sweep
  * @tag Express
  */
-export const PostWalletSweep = httpRoute({
+export const PostWalletSweep: HttpRoute<'post'> = httpRoute({
   path: '/api/v2/{coin}/wallet/{id}/sweep',
   method: 'POST',
   request: httpRequest({