From 10c37f84a125c5fe175aa75636ed596f31f9c6d4 Mon Sep 17 00:00:00 2001 From: lukasIO Date: Mon, 16 Nov 2026 11:39:21 +0100 Subject: [PATCH 1/8] Release with verwalter instead of changesets/action Add verwalter.toml and the four verwalter workflows (release PR, release, pre-release, changeset check). Remove the changesets/action job from CI, .changeset/config.json, the ci:publish script and the changesets devDependencies. Pending .changeset/*.md files carry over. Co-Authored-By: Claude Opus 5.5 --- .changeset/config.json | 15 -- .github/workflows/changeset-check.yml | 26 ++ .github/workflows/ci.yml | 48 +--- .github/workflows/pre-release.yml | 29 ++ .github/workflows/release-pr.yml | 34 +++ .github/workflows/release.yml | 89 ++++++ package.json | 3 - packages/livekit-server-sdk/package.json | 2 - pnpm-lock.yaml | 328 ----------------------- verwalter.toml | 15 ++ 10 files changed, 194 insertions(+), 395 deletions(-) delete mode 100644 .changeset/config.json create mode 100644 .github/workflows/changeset-check.yml create mode 100644 .github/workflows/pre-release.yml create mode 100644 .github/workflows/release-pr.yml create mode 100644 .github/workflows/release.yml create mode 100644 verwalter.toml diff --git a/.changeset/config.json b/.changeset/config.json deleted file mode 100644 index a80f9a1f..00000000 --- a/.changeset/config.json +++ /dev/null @@ -1,15 +0,0 @@ -{ - "$schema": "https://unpkg.com/@changesets/config@2.2.0/schema.json", - "changelog": [ - "@livekit/changesets-changelog-github", - { - "repo": "livekit/node-sdks" - } - ], - "commit": false, - "ignore": [], - "linked": [], - "access": "public", - "baseBranch": "main", - "updateInternalDependencies": "patch" -} diff --git a/.github/workflows/changeset-check.yml b/.github/workflows/changeset-check.yml new file mode 100644 index 00000000..36f8bdba --- /dev/null +++ b/.github/workflows/changeset-check.yml @@ -0,0 +1,26 @@ +# SPDX-FileCopyrightText: 2026 LiveKit, Inc. +# +# SPDX-License-Identifier: Apache-2.0 + +# Fails a contributor PR that changes a versioned package without a +# changeset, with a comment that links to a prefilled changeset file. +# The `internal` label skips the check. +name: Changeset check + +on: + pull_request: + types: [opened, synchronize, reopened, labeled, unlabeled] + branches: [main] + +permissions: + contents: read + pull-requests: write + +jobs: + check: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + - uses: livekit/verwalter@359985c1e5567b17ae84db0241fbb305c383f89e # v0.30.0 + with: + command: check diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 474a2a67..e789f7a0 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -5,9 +5,7 @@ env: CARGO_TERM_COLOR: always permissions: - id-token: write # Required for OIDC - contents: write # Required to create GH releases - pull-requests: write # Required to interact with PRs + contents: read on: workflow_dispatch: @@ -90,47 +88,3 @@ jobs: bun install (cd packages/livekit-server-sdk && EXPECT_BUN_RUNTIME=1 bun --bun run test) (cd packages/livekit-rtc && EXPECT_BUN_RUNTIME=1 bun --bun run test) - - build_and_release: - if: github.ref == 'refs/heads/main' - name: Build and release - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 - - - uses: pnpm/action-setup@fc06bc1257f339d1d5d8b3a19a8cae5388b55320 # v4.4.0 - - - name: Setup node - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0 - with: - node-version: 24 - cache: pnpm - - - name: Install dependencies - run: pnpm install - - - name: Build server SDK - run: pnpm --filter="livekit-server-sdk" build - - - name: Build rtc-node - run: pnpm --filter="@livekit/rtc-node" build - - - name: Create Release Pull Request or Publish to npm - id: changesets - uses: changesets/action@ae32849d5ba541f9ae29e40e22a623bc13562f51 # v2.1.2 - with: - publish-script: pnpm ci:publish - env: - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} - - - name: Build Server SDK Docs - if: steps.changesets.outputs.published == 'true' - run: pnpm --filter=livekit-server-sdk build-docs - - - name: S3 Upload Server SDK Docs - if: steps.changesets.outputs.published == 'true' - run: aws s3 cp packages/livekit-server-sdk/docs/ s3://livekit-docs/server-sdk-js --recursive - env: - AWS_ACCESS_KEY_ID: ${{ secrets.DOCS_DEPLOY_AWS_ACCESS_KEY }} - AWS_SECRET_ACCESS_KEY: ${{ secrets.DOCS_DEPLOY_AWS_API_SECRET }} - AWS_DEFAULT_REGION: 'us-east-1' diff --git a/.github/workflows/pre-release.yml b/.github/workflows/pre-release.yml new file mode 100644 index 00000000..fe6b3dc3 --- /dev/null +++ b/.github/workflows/pre-release.yml @@ -0,0 +1,29 @@ +# SPDX-FileCopyrightText: 2026 LiveKit, Inc. +# +# SPDX-License-Identifier: Apache-2.0 + +# On demand: open an rc PR from the branch the workflow is run on. The +# levels come from the changesets. Merging the PR tags 1.6.0-rc.1; the +# next run numbers rc.2. Changesets stay pending for the final release. +name: Pre-release PR + +on: + workflow_dispatch: + +permissions: + contents: write + pull-requests: write + +jobs: + pr: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + with: + fetch-depth: 0 # the tags number the rc + - uses: livekit/verwalter@359985c1e5567b17ae84db0241fbb305c383f89e # v0.30.0 + with: + command: pre-release + args: --target ${{ github.ref_name }} + app-client-id: ${{ secrets.VERWALTER_RELEASE_CLIENT_ID }} + app-private-key: ${{ secrets.VERWALTER_RELEASE_APP_KEY }} diff --git a/.github/workflows/release-pr.yml b/.github/workflows/release-pr.yml new file mode 100644 index 00000000..6094f2dc --- /dev/null +++ b/.github/workflows/release-pr.yml @@ -0,0 +1,34 @@ +# SPDX-FileCopyrightText: 2026 LiveKit, Inc. +# +# SPDX-License-Identifier: Apache-2.0 + +# Keeps one release PR open while changesets are pending. Runs on every +# push to main and regenerates the release branch from main. +name: Release PRs + +on: + push: + branches: [main] + +permissions: + contents: write + pull-requests: write + +concurrency: + group: release-prs + cancel-in-progress: true + +jobs: + pr: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + with: + fetch-depth: 0 # the commit that added a changeset gives its changelog line the PR and author + - uses: livekit/verwalter@359985c1e5567b17ae84db0241fbb305c383f89e # v0.30.0 + with: + command: pr + # A GitHub App token lets the release PRs trigger CI; the default + # github.token does not. Without these secrets, github.token is used. + app-client-id: ${{ secrets.VERWALTER_RELEASE_CLIENT_ID }} + app-private-key: ${{ secrets.VERWALTER_RELEASE_APP_KEY }} diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml new file mode 100644 index 00000000..e4a581f9 --- /dev/null +++ b/.github/workflows/release.yml @@ -0,0 +1,89 @@ +# SPDX-FileCopyrightText: 2026 LiveKit, Inc. +# +# SPDX-License-Identifier: Apache-2.0 + +# After a release PR merges: tag and create the GitHub releases, then +# publish to npm. The step that cannot be undone comes last. +name: Release + +on: + pull_request: + types: [closed] + branches: [main] + # Re-run by hand after a fix: `verwalter release` resumes from the + # current state and skips what is done. With `package`, that package + # is reported again even when complete, so the publish job runs for it. + workflow_dispatch: + inputs: + package: + description: Only this package; always reported to the publish job. + required: false + default: '' + +permissions: + contents: write + id-token: write # trusted publishing + +jobs: + release: + # Only a release PR the tool opened: the branch prefix alone would let + # any pushed `release/*` branch trigger a publish. + if: github.event_name == 'workflow_dispatch' || (github.event.pull_request.merged == true && startsWith(github.event.pull_request.head.ref, 'release/') && github.event.pull_request.user.login == 'verwalter-release[bot]' && contains(github.event.pull_request.body, '')) + runs-on: ubuntu-latest + outputs: + released: ${{ steps.verwalter.outputs.released }} + releases: ${{ steps.verwalter.outputs.releases }} + steps: + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + with: + # The merge commit itself: a push to main right after the merge + # must not move the tags. + ref: ${{ github.event.pull_request.merge_commit_sha || github.sha }} + fetch-depth: 0 + - id: verwalter + uses: livekit/verwalter@359985c1e5567b17ae84db0241fbb305c383f89e # v0.30.0 + with: + command: release + args: ${{ inputs.package && format('--package {0}', inputs.package) || '' }} + + publish: + needs: release + if: needs.release.outputs.released == 'true' || github.event_name == 'workflow_dispatch' + runs-on: ubuntu-latest + permissions: + contents: write # the tool flips draft releases after the publish + id-token: write # trusted publishing + steps: + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + with: + ref: ${{ github.event.pull_request.merge_commit_sha || github.sha }} + fetch-depth: 0 # tags decide what is published + - uses: pnpm/action-setup@fc06bc1257f339d1d5d8b3a19a8cae5388b55320 # v4.4.0 + # No registry-url: npm trusted publishing needs no token, and the + # placeholder token setup-node writes would make the publish fail. + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0 + with: + node-version: 24 # npm 11.5.1 or later is required for OIDC + cache: pnpm + - run: pnpm install + - name: Build server SDK + run: pnpm --filter="livekit-server-sdk" build + - name: Build rtc-node + run: pnpm --filter="@livekit/rtc-node" build + - uses: livekit/verwalter@359985c1e5567b17ae84db0241fbb305c383f89e # v0.30.0 + env: + GH_TOKEN: ${{ github.token }} + with: + command: publish + releases: ${{ needs.release.outputs.releases }} + + - name: Build Server SDK Docs + continue-on-error: true + run: pnpm --filter=livekit-server-sdk build-docs + - name: S3 Upload Server SDK Docs + continue-on-error: true + run: aws s3 cp packages/livekit-server-sdk/docs/ s3://livekit-docs/server-sdk-js --recursive + env: + AWS_ACCESS_KEY_ID: ${{ secrets.DOCS_DEPLOY_AWS_ACCESS_KEY }} + AWS_SECRET_ACCESS_KEY: ${{ secrets.DOCS_DEPLOY_AWS_API_SECRET }} + AWS_DEFAULT_REGION: 'us-east-1' diff --git a/package.json b/package.json index c48f76e1..a6eeb4de 100644 --- a/package.json +++ b/package.json @@ -8,7 +8,6 @@ "build": "turbo run build", "build:livekit-rtc": "turbo run build --filter=@livekit/rtc-node...", "build:artifacts": "turbo run artifacts --filter=@livekit/rtc-node...", - "ci:publish": "changeset publish", "api:check": "turbo run api:check", "api:update": "turbo run api:update", "format:check": "prettier --check \"**/src/**/*.{ts,tsx,md,json}\"", @@ -19,8 +18,6 @@ "test:watch": "vitest" }, "devDependencies": { - "@changesets/cli": "^3.0.0", - "@livekit/changesets-changelog-github": "^0.2.0", "@rushstack/heft": "^0.74.5", "@trivago/prettier-plugin-sort-imports": "^6.0.2", "@typescript-eslint/eslint-plugin": "^8.60.1", diff --git a/packages/livekit-server-sdk/package.json b/packages/livekit-server-sdk/package.json index 8e5e1b7f..111042fa 100644 --- a/packages/livekit-server-sdk/package.json +++ b/packages/livekit-server-sdk/package.json @@ -49,9 +49,7 @@ "jose": "^5.1.2" }, "devDependencies": { - "@changesets/cli": "^3.0.0", "@edge-runtime/vm": "^5.0.0", - "@livekit/changesets-changelog-github": "^0.2.0", "@types/node": "^20.10.1", "happy-dom": "^21.0.0", "prettier": "^3.0.0", diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index a238ca6c..86902a74 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -23,12 +23,6 @@ importers: .: devDependencies: - '@changesets/cli': - specifier: ^3.0.0 - version: 3.0.3 - '@livekit/changesets-changelog-github': - specifier: ^0.2.0 - version: 0.2.0 '@rushstack/heft': specifier: ^0.74.5 version: 0.74.5(@types/node@22.15.29) @@ -268,15 +262,9 @@ importers: specifier: ^5.1.2 version: 5.10.0 devDependencies: - '@changesets/cli': - specifier: ^3.0.0 - version: 3.0.3 '@edge-runtime/vm': specifier: ^5.0.0 version: 5.0.0 - '@livekit/changesets-changelog-github': - specifier: ^0.2.0 - version: 0.2.0 '@types/node': specifier: ^20.10.1 version: 20.19.11 @@ -344,82 +332,6 @@ packages: '@bufbuild/protobuf@1.10.1': resolution: {integrity: sha512-wJ8ReQbHxsAfXhrf9ixl0aYbZorRuOWpBNzm8pL8ftmSxQx/wnJD5Eg861NwJU/czy2VXFIebCeZnZrI9rktIQ==} - '@changesets/apply-release-plan@8.1.1': - resolution: {integrity: sha512-nk2Hbq3M9NeHMdaIRBDvawKrQJzXB9sGyBUE5yWnIKtvdcNCPj75zBekJYr0gTT2ecJH3eFeTrc8eisPImcv0Q==} - engines: {node: ^22.11 || ^24 || >=26} - - '@changesets/assemble-release-plan@7.0.0': - resolution: {integrity: sha512-oEW8BxdA604kGGtDSCiHr5w9Tv4UWe9I2k61IBNZzCOE1kbYaJj4v+lFQNgcEZFkUc2pV/+hASErGDvpJOZCTg==} - engines: {node: ^22.11 || ^24 || >=26} - - '@changesets/changelog-git@1.0.0': - resolution: {integrity: sha512-3Dst2Ime2Op5nd4XmWJLPIgp11ZFqJqSkVug9izK6TDcIV4YlhPS4ECbEVR+eGI0bk0r1ItogD4j2Oli87bJrA==} - engines: {node: ^22.11 || ^24 || >=26} - - '@changesets/cli@3.0.3': - resolution: {integrity: sha512-L1i67bMfkK6iC/kDejuNO4pFgTRcWIObsD6Qof2woP1I4M8tj17DGlcpRaTzTv1DYSP5EMwWdEtR8X0Pj5Jg3Q==} - engines: {node: ^22.11 || ^24 || >=26, npm: '>=10.9.0', pnpm: '>=10.0.0', yarn: '>=4.5.2'} - hasBin: true - - '@changesets/config@4.0.1': - resolution: {integrity: sha512-PxpxSQLQSLDjceAgRq+4FWlU+HflDIw03mmPVipxoQx9xrXFUjmqTy3SE+n/2t+DqPdpPiLWVr5NRiLZvjyLwg==} - engines: {node: ^22.11 || ^24 || >=26} - - '@changesets/errors@1.0.0': - resolution: {integrity: sha512-ElN/mEzn6zmETgjwf5MclCMa9ef59sAR0lfO8VSYIsiRvbC2FbLB/92EoYw10Sl0kGixxHFiJZUSv7dA+YpR8g==} - engines: {node: ^22.11 || ^24 || >=26} - - '@changesets/format@0.1.2': - resolution: {integrity: sha512-Caez5XtNXCFS/G5bwyav3wuXL0tMxVd2ZGbaumWbzN08tyzO21asCw7JZhNtVsAZDCvDRUzZN+Iit9SyRITSYA==} - engines: {node: ^22.11 || ^24 || >=26} - - '@changesets/get-dependents-graph@3.0.0': - resolution: {integrity: sha512-ji/t5wFA1zREKXRUePE6Qi+Qu2UgxCeSSGQrphezwvQZrp49B7sJ+8+wvM0tA7zPeSxYKCojDy3WWgrl+s+awg==} - engines: {node: ^22.11 || ^24 || >=26} - - '@changesets/get-github-info@1.0.0-next.3': - resolution: {integrity: sha512-HQXw3Kcz1hAdCQgGH4cWlKpJWcTeL8pWNJP4zDOR3igoHJQO31wzHhG29XPhxnDBK9wEdyI71Ft86KpXDOLv/Q==} - engines: {node: ^22.11 || ^24 || >=26} - - '@changesets/git@4.0.1': - resolution: {integrity: sha512-6vWpIAC4LkpmlqaIu37ViT5enyd9+uBwAiGqCGhASvkSHBgx4PrtTGXWTMFYpDmZbjgyonyVgMciPrW4MqtJsA==} - engines: {node: ^22.11 || ^24 || >=26} - - '@changesets/parse@1.0.0': - resolution: {integrity: sha512-P0iaMb9p9CRYZiTgAllEIF9AUMQHIy1G72tKlcIqJp61icZSsKQNiOPdxAMZG8m/DvZwt/oz5xEbTpike//dWg==} - engines: {node: ^22.11 || ^24 || >=26} - - '@changesets/pre@3.0.0': - resolution: {integrity: sha512-Zm/6YliV/a2oeWTqHJf6KxLrQwgcK1i/BRDl2m0EKZvbnxV5fG9QRhwJJGshjsZTUTS6dkfURQ2K6aAvgNw/3Q==} - engines: {node: ^22.11 || ^24 || >=26} - - '@changesets/read@1.0.1': - resolution: {integrity: sha512-nzvSC6RcTiWf/dsuwZFXpLzGGsRHYCL68U3uHV7srsulU93aVWY7u2GEJiDZ+4GIIElfaW5EqtKC0UHroY+LTQ==} - engines: {node: ^22.11 || ^24 || >=26} - - '@changesets/should-skip-package@1.0.0': - resolution: {integrity: sha512-pwqoJmbONn1XgXmZXPEExgAaT+HdZLjALFTDgIm+PnS5KeO2nLtzA2/Q+4aMFY14kFMuXKG30MObhvDzWgzDgg==} - engines: {node: ^22.11 || ^24 || >=26} - - '@changesets/types@6.1.0': - resolution: {integrity: sha512-rKQcJ+o1nKNgeoYRHKOS07tAMNd3YSN0uHaJOZYjBAgxfV7TUE7JE+z4BzZdQwb5hKaYbayKN5KrYV7ODb2rAA==} - - '@changesets/types@7.0.0': - resolution: {integrity: sha512-c5GoiQyt3pxiXjrWSNoP8/GRf4kG+VnKzovx1OQM8dYYALlSwgedmkPmJ+ZqGxqwg9D3Bkj85Uo4KLd5BN3A0w==} - engines: {node: ^22.11 || ^24 || >=26} - - '@changesets/write@1.0.1': - resolution: {integrity: sha512-q/ThtP9gcnEP6xlv7LrY26C2mHqdGBti/MmOVngt/M/oIGYkssmQGxPK9WzBNt2juVcH/vml2WQ+ra8LXYOTaA==} - engines: {node: ^22.11 || ^24 || >=26} - - '@clack/core@1.5.1': - resolution: {integrity: sha512-iHTrHA8MtVuLl2TfZySmcKv1qO2PoyC9Z7pfSDozEuV5vtY3/wcOPKJXlqJ5Oq2Cx5DDGQGAMVx6HZfRRoVEbQ==} - engines: {node: '>= 20.12.0'} - - '@clack/prompts@1.8.1': - resolution: {integrity: sha512-dlT1m5e/0yUL0kRNcQn7yGLVThkgbB0Ga/1AmfDDC/8ik6AIiSf2QLQO2zPYvefsHP0aFgxO93cVLCCfDp7kzQ==} - engines: {node: '>= 20.12.0'} - '@datastructures-js/deque@1.0.8': resolution: {integrity: sha512-PSBhJ2/SmeRPRHuBv7i/fHWIdSC3JTyq56qb+Rq0wjOagi0/fdV5/B/3Md5zFZus/W6OkSPMaxMKKMNMrSmubg==} @@ -1136,9 +1048,6 @@ packages: peerDependencies: jsep: ^0.4.0||^1.0.0 - '@livekit/changesets-changelog-github@0.2.0': - resolution: {integrity: sha512-HWgR0biITeIaLeBRIUpqYJ0Wacmx7JJjlqhiJtqYrGItqw0kRUe6tTB6vN0fU7tK1oh08hlgr3iYdGLNLNbrNQ==} - '@livekit/mutex@1.1.1': resolution: {integrity: sha512-EsshAucklmpuUAfkABPxJNhzj9v2sG7JuzFDL4ML1oJQSV14sqrpTYnsaOudMAw9yOaW53NU3QQTlUQoRs4czw==} @@ -1184,18 +1093,6 @@ packages: '@livekit/typed-emitter@3.0.0': resolution: {integrity: sha512-9bl0k4MgBPZu3Qu3R3xy12rmbW17e3bE9yf4YY85gJIQ3ezLEj/uzpKHWBsLaDoL5Mozz8QCgggwIBudYQWeQg==} - '@manypkg/find-root@3.1.0': - resolution: {integrity: sha512-BcSqCyKhBVZ5YkSzOiheMCV41kqAFptW6xGqYSTjkVTl9XQpr+pqHhwgGCOHQtjDCv7Is6EFyA14Sm5GVbVABA==} - engines: {node: '>=20.0.0'} - - '@manypkg/get-packages@3.1.0': - resolution: {integrity: sha512-0TbBVyvPrP7xGYBI/cP8UP+yl/z+HtbTttAD7FMAJgn/kXOTwh5/60TsqP9ZYY710forNfyV0N8P/IE/ujGZJg==} - engines: {node: '>=20.0.0'} - - '@manypkg/tools@2.1.2': - resolution: {integrity: sha512-6QEf6yqFbETdwGITKq57aYoPfX/3K8XFNwsAlx0C1M7o8cb79sv1M3w+tWuWvIcSbNqrLF7OD7YpZMVVz335hQ==} - engines: {node: '>=20.0.0'} - '@microsoft/tsdoc-config@0.17.1': resolution: {integrity: sha512-UtjIFe0C6oYgTnad4q1QP4qXwLhe6tIpNTRStJ2RZEPIkqQPREAwE5spzVxsdn9UaEMUqhh0AqSx3X4nWAKXWw==} @@ -1300,10 +1197,6 @@ packages: resolution: {integrity: sha512-SEeaJLb3qBNF/OaXnaR1NmmBbFYk1zC0ZH/52fATcRPLFg/p791YrcyFFy44Bo9sLaGuSuLp5Q6axbb/O+v/RA==} engines: {node: ^14.18.0 || >=16.0.0} - '@pnpm/deps.graph-sequencer@1100.0.1': - resolution: {integrity: sha512-pOr5+q1fLYKwFN3LAJuGZEnfXDcQ73zqgDHMtGy+K+uIoUqyY+6MeDCWFwfu+4EFuq76I5EPFofoNAI+Bmmq4A==} - engines: {node: '>=22.13'} - '@rollup/rollup-android-arm-eabi@4.64.12': resolution: {integrity: sha512-Z8lz+5UOiCJLonjeqwJlhUtHA/Sr6R1AidkccQxdWF0nigNzP81aLoU+udgOaGfL5s1uzFXzcux/pCwGAMu0lw==} cpu: [arm] @@ -2124,10 +2017,6 @@ packages: resolution: {integrity: sha512-b6Ilus+c3RrdDk+JhLKUAQfzzgLEPy6wcXqS7f/xe1EETvsDP6GORG7SFuOs6cID5YkqchW/LXZbX5bc8j7ZcQ==} engines: {node: '>=8'} - cac@7.1.0: - resolution: {integrity: sha512-LMDU/U2yA4IPIY8KT0NsNPWEYZvAMkbgyspxJ6btJaYV+WMDOHAZCmB0lsTObiHaRS1V/ztKAl7+TSkTqXyeoA==} - engines: {node: '>=20.19.0'} - call-bind-apply-helpers@1.0.2: resolution: {integrity: sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==} engines: {node: '>= 0.4'} @@ -2211,9 +2100,6 @@ packages: resolution: {integrity: sha512-BS8PfmtDGnrgYdOonGZQdLZslWIeCGFP9tpan0hi1Co2Zr2NKADsvGYA8XxuG/4UWgJ6Cjtv+YJnB6MM69QGlQ==} engines: {node: '>= 0.4'} - dataloader@2.2.3: - resolution: {integrity: sha512-y2krtASINtPFS1rSDjacrFgn1dcUuoREVabwlOGOe4SdxenREqwjwjElAdwvbGM7kgZz9a3KVicWR7vcz8rnzA==} - dateformat@4.6.3: resolution: {integrity: sha512-2P0p0pFGzHS5EMnhdxQi7aJN+iMheud0UhG4dlE1DLAlvL8JHjJJTX/CSm4JXwV0Ka5nGk3zC5mcb5bUQUxxMA==} @@ -2274,10 +2160,6 @@ packages: resolution: {integrity: sha512-ZmdL2rui+eB2YwhsWzjInR8LldtZHGDoQ1ugH85ppHKwpUHL7j7rN0Ti9NCnGiQbhaZ11FpR+7ao1dNsmduNUg==} engines: {node: '>=12'} - dotenv@8.6.0: - resolution: {integrity: sha512-IrPdXQsk2BbzvCBGBOTmmSH5SodmqZNt4ERAZDmW4CT+tL8VtvinqywuANaFu4bOMWki16nqf0e4oC0QIaDr/g==} - engines: {node: '>=10'} - dunder-proto@1.0.1: resolution: {integrity: sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==} engines: {node: '>= 0.4'} @@ -2573,15 +2455,6 @@ packages: fast-safe-stringify@2.1.1: resolution: {integrity: sha512-W+KJc2dmILlPplD/H4K9l9LcAHAfPtP6BY84uVLXQ6Evcz9Lcg33Y2z1IVblT6xdY54PXYVHEv+0Wpq8Io6zkA==} - fast-string-truncated-width@3.0.3: - resolution: {integrity: sha512-0jjjIEL6+0jag3l2XWWizO64/aZVtpiGE3t0Zgqxv0DPuxiMjvB3M24fCyhZUO4KomJQPj3LTSUnDP3GpdwC0g==} - - fast-string-width@3.0.2: - resolution: {integrity: sha512-gX8LrtNEI5hq8DVUfRQMbr5lpaS4nMIWV+7XEbXk2b8kiQIizgnlr12B4dA3ZEx3308ze0O4Q1R+cHts8kyUJg==} - - fast-wrap-ansi@0.2.2: - resolution: {integrity: sha512-7F2Fl+TjRSenLqlU3UjSH0iyqopqoZIu7eZVpEirP2g1GtWa2G/ecEmBdgz31+Mxr+ELclgg6sokpSFIQiZ02Q==} - fastq@1.20.1: resolution: {integrity: sha512-GGToxJ/w1x32s/D2EKND7kTil4n8OVk/9mycTc4VDza13lOvpUZTGX3mFSCtV9ksdGBVzvsyAVLM6mHFThxXxw==} @@ -2748,10 +2621,6 @@ packages: help-me@5.0.0: resolution: {integrity: sha512-7xgomUX6ADmcYzFik0HzAxh/73YlKR9bmFzf51CZwR+b6YtzU2m0u49hQCqV6SvlqIqsaxovfwdvbnsw3b/zpg==} - human-id@4.2.0: - resolution: {integrity: sha512-K3GbkIWqyvvlpfhBPlbEvD97TtqBpAYA4kt+cn2lD2x2HuohzZCibcA2nOlnJT6exqvJLggoB5nv2dNf192nEA==} - hasBin: true - ignore@5.1.9: resolution: {integrity: sha512-2zeMQpbKz5dhZ9IwL0gbxSW5w0NK/MSAMtNuhgIHEPmaU3vPdKPL0UdvUCXs5SS4JAwsBxysK5sFMW8ocFiVjQ==} engines: {node: '>= 4'} @@ -2772,9 +2641,6 @@ packages: resolution: {integrity: sha512-rKtvo6a868b5Hu3heneU+L4yEQ4jYKLtjpnPeUdK7h0yzXGmyBTypknlkCvHFBqfX9YlorEiMM6Dnq/5atfHkw==} engines: {node: '>=8'} - import-meta-resolve@4.2.0: - resolution: {integrity: sha512-Iqv2fzaTQN28s/FwZAoFq0ZSs/7hMAHJVX+w8PZl3cY19Pxk6jFFalxQoIfW2826i/fDLXv8IiEZRIT0lDuWcg==} - imurmurhash@0.1.4: resolution: {integrity: sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==} engines: {node: '>=0.8.19'} @@ -2959,9 +2825,6 @@ packages: resolution: {integrity: sha512-g1MWMLBiz8FKi1e4w0UyVL3w+iJceWAFBAaBnnGKOpNa5f8TLktkbre1+s6oICydWAm+HRUGTmI+//xv2hvXYA==} hasBin: true - jsonc-parser@3.3.1: - resolution: {integrity: sha512-HUgH65KyejrUFPvHFPbqOY0rsFip3Bo5wb4ngvdi1EpCYWUQDC5V+Y7mZws+DLkr4M//zQJoanu1SP+87Dv1oQ==} - jsonfile@6.2.1: resolution: {integrity: sha512-zwOTdL3rFQ/lRdBnntKVOX6k5cKJwEc1HdilT71BWEu7J41gXIB2MRp+vxduPSwZJPWBxEzv4yH1wYLJGUHX4Q==} @@ -2984,9 +2847,6 @@ packages: resolution: {integrity: sha512-MbjN408fEndfiQXbFQ1vnd+1NoLDsnQW41410oQBXiyXDMYH5z505juWa4KUE1LqxRC7DgOgZDbKLxHIwm27hA==} engines: {node: '>=0.10'} - launch-editor@2.14.2: - resolution: {integrity: sha512-NHJEb30MGBCkmZXLZwz25t37QR4aY03ZzPYUJXOJaOa92uWwExI9SBQUuIznBYc1xkD7cJNGX7oc3Nl3sq2kQQ==} - levn@0.4.1: resolution: {integrity: sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==} engines: {node: '>= 0.8.0'} @@ -3183,9 +3043,6 @@ packages: package-json-from-dist@1.0.1: resolution: {integrity: sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==} - package-manager-detector@1.9.0: - resolution: {integrity: sha512-zAMfbta9nPA8AKkA4WdmNAT8R8s6Dk0/xwPsqNnRidMFcLo1YkLuPDTgs2f64XdzS8vbLNnoJ+uUIkgbz7oRHA==} - parent-module@1.0.1: resolution: {integrity: sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==} engines: {node: '>=6'} @@ -3469,10 +3326,6 @@ packages: resolution: {integrity: sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==} engines: {node: '>=8'} - shell-quote@1.12.0: - resolution: {integrity: sha512-PcByqNyT/38F2kDNi006HAMRJaULuBzq/FOsw3qdZvX/GA9W/jamDaRskgHjubHiftXK5sIFxLNkvrXUwcof6Q==} - engines: {node: '>= 0.4'} - side-channel-list@1.0.1: resolution: {integrity: sha512-mjn/0bi/oUURjc5Xl7IaWi/OJJJumuoJFQJfDDyO46+hBWsfaVM65TBHq2eoZBhzl9EchxOijpkbRC8SVBQU0w==} engines: {node: '>= 0.4'} @@ -3496,9 +3349,6 @@ packages: resolution: {integrity: sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==} engines: {node: '>=14'} - sisteransi@1.0.5: - resolution: {integrity: sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==} - sonic-boom@4.2.1: resolution: {integrity: sha512-w6AxtubXa2wTXAUsZMMWERrsIRAdrK0Sc+FUytWvYAhBJLyuI4llrMIC1DtlNSdI99EI86KZum2MMq3EAZlF9Q==} @@ -3981,128 +3831,6 @@ snapshots: '@bufbuild/protobuf@1.10.1': {} - '@changesets/apply-release-plan@8.1.1': - dependencies: - '@changesets/config': 4.0.1 - '@changesets/format': 0.1.2 - '@changesets/git': 4.0.1 - '@changesets/should-skip-package': 1.0.0 - '@changesets/types': 7.0.0 - import-meta-resolve: 4.2.0 - jsonc-parser: 3.3.1 - semver: 7.8.5 - - '@changesets/assemble-release-plan@7.0.0': - dependencies: - '@changesets/errors': 1.0.0 - '@changesets/get-dependents-graph': 3.0.0 - '@changesets/should-skip-package': 1.0.0 - '@changesets/types': 7.0.0 - semver: 7.8.5 - - '@changesets/changelog-git@1.0.0': - dependencies: - '@changesets/types': 7.0.0 - - '@changesets/cli@3.0.3': - dependencies: - '@changesets/apply-release-plan': 8.1.1 - '@changesets/assemble-release-plan': 7.0.0 - '@changesets/changelog-git': 1.0.0 - '@changesets/config': 4.0.1 - '@changesets/errors': 1.0.0 - '@changesets/get-dependents-graph': 3.0.0 - '@changesets/git': 4.0.1 - '@changesets/pre': 3.0.0 - '@changesets/read': 1.0.1 - '@changesets/should-skip-package': 1.0.0 - '@changesets/types': 7.0.0 - '@changesets/write': 1.0.1 - '@clack/prompts': 1.8.1 - '@manypkg/get-packages': 3.1.0 - '@pnpm/deps.graph-sequencer': 1100.0.1 - cac: 7.1.0 - import-meta-resolve: 4.2.0 - launch-editor: 2.14.2 - package-manager-detector: 1.9.0 - semver: 7.8.5 - tinyexec: 1.3.1 - - '@changesets/config@4.0.1': - dependencies: - '@changesets/get-dependents-graph': 3.0.0 - '@changesets/should-skip-package': 1.0.0 - '@changesets/types': 7.0.0 - '@manypkg/get-packages': 3.1.0 - picomatch: 4.0.7 - - '@changesets/errors@1.0.0': {} - - '@changesets/format@0.1.2': - dependencies: - package-manager-detector: 1.9.0 - tinyexec: 1.3.1 - - '@changesets/get-dependents-graph@3.0.0': - dependencies: - '@changesets/types': 7.0.0 - semver: 7.8.5 - - '@changesets/get-github-info@1.0.0-next.3': - dependencies: - dataloader: 2.2.3 - - '@changesets/git@4.0.1': - dependencies: - '@changesets/errors': 1.0.0 - '@changesets/types': 7.0.0 - '@manypkg/get-packages': 3.1.0 - picomatch: 4.0.7 - tinyexec: 1.3.1 - - '@changesets/parse@1.0.0': - dependencies: - '@changesets/types': 7.0.0 - yaml: 2.9.1 - - '@changesets/pre@3.0.0': - dependencies: - '@changesets/errors': 1.0.0 - '@changesets/types': 7.0.0 - '@manypkg/get-packages': 3.1.0 - - '@changesets/read@1.0.1': - dependencies: - '@changesets/git': 4.0.1 - '@changesets/parse': 1.0.0 - '@changesets/types': 7.0.0 - - '@changesets/should-skip-package@1.0.0': - dependencies: - '@changesets/types': 7.0.0 - - '@changesets/types@6.1.0': {} - - '@changesets/types@7.0.0': {} - - '@changesets/write@1.0.1': - dependencies: - '@changesets/format': 0.1.2 - '@changesets/types': 7.0.0 - human-id: 4.2.0 - - '@clack/core@1.5.1': - dependencies: - fast-wrap-ansi: 0.2.2 - sisteransi: 1.0.5 - - '@clack/prompts@1.8.1': - dependencies: - '@clack/core': 1.5.1 - fast-string-width: 3.0.2 - fast-wrap-ansi: 0.2.2 - sisteransi: 1.0.5 - '@datastructures-js/deque@1.0.8': {} '@edge-runtime/primitives@6.0.0': {} @@ -4547,12 +4275,6 @@ snapshots: dependencies: jsep: 1.4.0 - '@livekit/changesets-changelog-github@0.2.0': - dependencies: - '@changesets/get-github-info': 1.0.0-next.3 - '@changesets/types': 6.1.0 - dotenv: 8.6.0 - '@livekit/mutex@1.1.1': {} '@livekit/protocol@1.53.0': @@ -4586,21 +4308,6 @@ snapshots: '@livekit/typed-emitter@3.0.0': {} - '@manypkg/find-root@3.1.0': - dependencies: - '@manypkg/tools': 2.1.2 - - '@manypkg/get-packages@3.1.0': - dependencies: - '@manypkg/find-root': 3.1.0 - '@manypkg/tools': 2.1.2 - - '@manypkg/tools@2.1.2': - dependencies: - jju: 1.4.0 - tinyglobby: 0.2.17 - yaml: 2.9.1 - '@microsoft/tsdoc-config@0.17.1': dependencies: '@microsoft/tsdoc': 0.15.1 @@ -4671,8 +4378,6 @@ snapshots: '@pkgr/core@0.3.6': {} - '@pnpm/deps.graph-sequencer@1100.0.1': {} - '@rollup/rollup-android-arm-eabi@4.64.12': optional: true @@ -5390,8 +5095,6 @@ snapshots: cac@6.7.14: {} - cac@7.1.0: {} - call-bind-apply-helpers@1.0.2: dependencies: es-errors: 1.3.0 @@ -5472,8 +5175,6 @@ snapshots: es-errors: 1.3.0 is-data-view: 1.0.2 - dataloader@2.2.3: {} - dateformat@4.6.3: {} debug@3.2.7: @@ -5517,8 +5218,6 @@ snapshots: dotenv@16.4.5: {} - dotenv@8.6.0: {} - dunder-proto@1.0.1: dependencies: call-bind-apply-helpers: 1.0.2 @@ -6037,16 +5736,6 @@ snapshots: fast-safe-stringify@2.1.1: {} - fast-string-truncated-width@3.0.3: {} - - fast-string-width@3.0.2: - dependencies: - fast-string-truncated-width: 3.0.3 - - fast-wrap-ansi@0.2.2: - dependencies: - fast-string-width: 3.0.2 - fastq@1.20.1: dependencies: reusify: 1.1.0 @@ -6231,8 +5920,6 @@ snapshots: help-me@5.0.0: {} - human-id@4.2.0: {} - ignore@5.1.9: {} ignore@5.3.2: {} @@ -6246,8 +5933,6 @@ snapshots: import-lazy@4.0.0: {} - import-meta-resolve@4.2.0: {} - imurmurhash@0.1.4: {} inflight@1.0.6: @@ -6428,8 +6113,6 @@ snapshots: dependencies: minimist: 1.2.8 - jsonc-parser@3.3.1: {} - jsonfile@6.2.1: dependencies: universalify: 2.0.1 @@ -6459,11 +6142,6 @@ snapshots: dependencies: language-subtag-registry: 0.3.23 - launch-editor@2.14.2: - dependencies: - picocolors: 1.1.1 - shell-quote: 1.12.0 - levn@0.4.1: dependencies: prelude-ls: 1.2.1 @@ -6671,8 +6349,6 @@ snapshots: package-json-from-dist@1.0.1: {} - package-manager-detector@1.9.0: {} - parent-module@1.0.1: dependencies: callsites: 3.1.0 @@ -7034,8 +6710,6 @@ snapshots: shebang-regex@3.0.0: {} - shell-quote@1.12.0: {} - side-channel-list@1.0.1: dependencies: es-errors: 1.3.0 @@ -7068,8 +6742,6 @@ snapshots: signal-exit@4.1.0: {} - sisteransi@1.0.5: {} - sonic-boom@4.2.1: dependencies: atomic-sleep: 1.0.0 diff --git a/verwalter.toml b/verwalter.toml new file mode 100644 index 00000000..3ddcf430 --- /dev/null +++ b/verwalter.toml @@ -0,0 +1,15 @@ +# SPDX-FileCopyrightText: 2026 LiveKit, Inc. +# +# SPDX-License-Identifier: Apache-2.0 + +[workspace] +members = ["packages/*"] + +[versioning] +files = ["package.json"] + +[release] +tag = "{package}@{version}" + +[publish] +registry = "npm" From e70e2738686cc78fcc74cea4eaee4f208783f08e Mon Sep 17 00:00:00 2001 From: lukasIO Date: Mon, 16 Nov 2026 13:28:19 +0100 Subject: [PATCH 2/8] Address review: rc releases, stale scripts, docs failures Run the release workflow for verwalter PRs on any base branch, so an rc PR from another branch is tagged and published. Remove the server SDK's changeset and ci:publish scripts. Let a failed docs build or upload fail the publish job. Co-Authored-By: Claude Opus 5.5 --- .github/workflows/release.yml | 7 ++++--- packages/livekit-server-sdk/package.json | 2 -- 2 files changed, 4 insertions(+), 5 deletions(-) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index e4a581f9..b59c524c 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -7,9 +7,10 @@ name: Release on: + # Any base branch: an rc PR from `pre-release` targets the branch it + # was run on. The bot and marker check on the job gates the run. pull_request: types: [closed] - branches: [main] # Re-run by hand after a fix: `verwalter release` resumes from the # current state and skips what is done. With `package`, that package # is reported again even when complete, so the publish job runs for it. @@ -77,11 +78,11 @@ jobs: command: publish releases: ${{ needs.release.outputs.releases }} + # A failure here fails the job. A re-run is safe: publish skips the + # versions that npm already has. - name: Build Server SDK Docs - continue-on-error: true run: pnpm --filter=livekit-server-sdk build-docs - name: S3 Upload Server SDK Docs - continue-on-error: true run: aws s3 cp packages/livekit-server-sdk/docs/ s3://livekit-docs/server-sdk-js --recursive env: AWS_ACCESS_KEY_ID: ${{ secrets.DOCS_DEPLOY_AWS_ACCESS_KEY }} diff --git a/packages/livekit-server-sdk/package.json b/packages/livekit-server-sdk/package.json index 111042fa..59eb026c 100644 --- a/packages/livekit-server-sdk/package.json +++ b/packages/livekit-server-sdk/package.json @@ -34,8 +34,6 @@ "build": "tsup --onSuccess \"tsc -p tsconfig.json --declaration --emitDeclarationOnly --skipLibCheck\"", "build:watch": "tsc --watch", "build-docs": "typedoc", - "changeset": "changeset", - "ci:publish": "pnpm build && changeset publish", "lint": "eslint src", "format": "prettier --write src", "format:check": "prettier --check src", From 65ccace223a98ab00ec17755bb826db2137a2fc8 Mon Sep 17 00:00:00 2001 From: lukasIO Date: Mon, 16 Nov 2026 13:32:39 +0100 Subject: [PATCH 3/8] Upload the server SDK docs only for a stable version An rc release must not replace the docs of the current stable release. Co-Authored-By: Claude Opus 5.5 --- .github/workflows/release.yml | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index b59c524c..1e12482b 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -78,11 +78,19 @@ jobs: command: publish releases: ${{ needs.release.outputs.releases }} + # The docs site holds one version: an rc must not replace it. + - name: Check for a stable server SDK version + id: docs + run: | + version=$(node -p "require('./packages/livekit-server-sdk/package.json').version") + if [[ "$version" != *-* ]]; then echo "stable=true" >> "$GITHUB_OUTPUT"; fi # A failure here fails the job. A re-run is safe: publish skips the # versions that npm already has. - name: Build Server SDK Docs + if: steps.docs.outputs.stable == 'true' run: pnpm --filter=livekit-server-sdk build-docs - name: S3 Upload Server SDK Docs + if: steps.docs.outputs.stable == 'true' run: aws s3 cp packages/livekit-server-sdk/docs/ s3://livekit-docs/server-sdk-js --recursive env: AWS_ACCESS_KEY_ID: ${{ secrets.DOCS_DEPLOY_AWS_ACCESS_KEY }} From d5e70d1dc73da53119911248c17acb6e7e0f1bc3 Mon Sep 17 00:00:00 2001 From: lukasIO Date: Tue, 17 Nov 2026 10:15:39 +0100 Subject: [PATCH 4/8] Release: docs in their own job, one publish at a time A docs failure no longer turns the publish job red after npm has the version. A publish job waits for a running one instead of publishing the same version twice. Co-Authored-By: Claude Opus 5.5 --- .github/workflows/release.yml | 31 ++++++++++++++++++++++++++++--- 1 file changed, 28 insertions(+), 3 deletions(-) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 1e12482b..4bf44c02 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -51,6 +51,12 @@ jobs: needs: release if: needs.release.outputs.released == 'true' || github.event_name == 'workflow_dispatch' runs-on: ubuntu-latest + # One publish at a time: a run by hand during the merge run waits. + # ponytail: one group for all releases, because the tag is not known + # before the release job. A third overlapping run cancels the waiting one. + concurrency: + group: npm-publish + cancel-in-progress: false permissions: contents: write # the tool flips draft releases after the publish id-token: write # trusted publishing @@ -78,17 +84,36 @@ jobs: command: publish releases: ${{ needs.release.outputs.releases }} + # Its own job: a docs failure is red, and the publish job stays green, + # so it is clear that the release is complete. A re-run is safe. + docs: + needs: publish + runs-on: ubuntu-latest + permissions: + contents: read + steps: + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + with: + ref: ${{ github.event.pull_request.merge_commit_sha || github.sha }} + - uses: pnpm/action-setup@fc06bc1257f339d1d5d8b3a19a8cae5388b55320 # v4.4.0 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0 + with: + node-version: 24 + cache: pnpm # The docs site holds one version: an rc must not replace it. - name: Check for a stable server SDK version id: docs run: | version=$(node -p "require('./packages/livekit-server-sdk/package.json').version") if [[ "$version" != *-* ]]; then echo "stable=true" >> "$GITHUB_OUTPUT"; fi - # A failure here fails the job. A re-run is safe: publish skips the - # versions that npm already has. + - if: steps.docs.outputs.stable == 'true' + run: pnpm install + # The build writes src/version.ts, which the docs need. - name: Build Server SDK Docs if: steps.docs.outputs.stable == 'true' - run: pnpm --filter=livekit-server-sdk build-docs + run: | + pnpm --filter=livekit-server-sdk build + pnpm --filter=livekit-server-sdk build-docs - name: S3 Upload Server SDK Docs if: steps.docs.outputs.stable == 'true' run: aws s3 cp packages/livekit-server-sdk/docs/ s3://livekit-docs/server-sdk-js --recursive From 59ed5484e34f297a9f78de7ecbc18fca6045c698 Mon Sep 17 00:00:00 2001 From: lukasIO Date: Tue, 17 Nov 2026 10:21:40 +0100 Subject: [PATCH 5/8] Release: guard source on runs by hand, narrow docs, queue publishes - Add a ref input for runs by hand. Before the build, fail when a package to publish differs from its release tag. - Upload the server SDK docs only when this run released a final server SDK version from main. - Keep every waiting publish run with queue: max. Co-Authored-By: Claude Opus 5.5 --- .github/workflows/release.yml | 67 +++++++++++++++++++++++++++-------- 1 file changed, 53 insertions(+), 14 deletions(-) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 4bf44c02..1490a942 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -11,11 +11,18 @@ on: # was run on. The bot and marker check on the job gates the run. pull_request: types: [closed] - # Re-run by hand after a fix: `verwalter release` resumes from the - # current state and skips what is done. With `package`, that package - # is reported again even when complete, so the publish job runs for it. + # A failed job is re-run with "Re-run failed jobs" on the run itself: + # that keeps the merge commit. Run by hand only for a fixed workflow + # file, with `ref` set to the release tag. `verwalter release` resumes + # from the current state and skips what is done. With `package`, that + # package is reported again even when complete, so the publish job and + # the docs job run for it. workflow_dispatch: inputs: + ref: + description: Commit or tag to release and publish. Set it to the release tag. Empty is the branch head. + required: false + default: '' package: description: Only this package; always reported to the publish job. required: false @@ -39,7 +46,7 @@ jobs: with: # The merge commit itself: a push to main right after the merge # must not move the tags. - ref: ${{ github.event.pull_request.merge_commit_sha || github.sha }} + ref: ${{ github.event.pull_request.merge_commit_sha || inputs.ref || github.sha }} fetch-depth: 0 - id: verwalter uses: livekit/verwalter@359985c1e5567b17ae84db0241fbb305c383f89e # v0.30.0 @@ -51,20 +58,46 @@ jobs: needs: release if: needs.release.outputs.released == 'true' || github.event_name == 'workflow_dispatch' runs-on: ubuntu-latest - # One publish at a time: a run by hand during the merge run waits. - # ponytail: one group for all releases, because the tag is not known - # before the release job. A third overlapping run cancels the waiting one. + # One publish at a time, in arrival order. A waiting publish checks out + # after the running one ends, so it sees the newer tag and picks the + # right npm dist-tag. `queue: max` keeps every waiting run: without it, + # a third run cancels the waiting one. concurrency: group: npm-publish cancel-in-progress: false + queue: max permissions: contents: write # the tool flips draft releases after the publish id-token: write # trusted publishing steps: - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 with: - ref: ${{ github.event.pull_request.merge_commit_sha || github.sha }} + ref: ${{ github.event.pull_request.merge_commit_sha || inputs.ref || github.sha }} fetch-depth: 0 # tags decide what is published + # verwalter checks only that the tag exists. A run by hand on a newer + # commit would publish other source under the tagged version. Check + # what this run publishes: in `releases` when it lists any, tagged, + # and not on npm yet. + - name: Make sure that each package to publish matches its release tag + env: + RELEASES: ${{ needs.release.outputs.releases }} + run: | + releases=${RELEASES:-[]} + for dir in packages/*/; do + name=$(node -p "require('./${dir}package.json').name") + tag="$name@$(node -p "require('./${dir}package.json').version")" + if [ "$(jq length <<< "$releases")" -gt 0 ] && ! jq -e --arg n "$name" 'any(.[]; .package == $n)' <<< "$releases" >/dev/null; then + continue + fi + git rev-parse -q --verify "refs/tags/$tag" >/dev/null || continue + if [ -n "$(npm view "$tag" version 2>/dev/null)" ]; then + continue + fi + if ! git diff --quiet "$tag" HEAD -- "$dir"; then + echo "::error::$dir differs from $tag. Start the run with ref=$tag." + exit 1 + fi + done - uses: pnpm/action-setup@fc06bc1257f339d1d5d8b3a19a8cae5388b55320 # v4.4.0 # No registry-url: npm trusted publishing needs no token, and the # placeholder token setup-node writes would make the publish fail. @@ -86,26 +119,32 @@ jobs: # Its own job: a docs failure is red, and the publish job stays green, # so it is clear that the release is complete. A re-run is safe. + # The docs site holds one version, the newest final server SDK release + # from main. An rc, another branch, or a release of rtc-node alone must + # not replace it. docs: - needs: publish + needs: [release, publish] + if: success() && (github.event.pull_request.base.ref == 'main' || github.ref == 'refs/heads/main') runs-on: ubuntu-latest permissions: contents: read steps: - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 with: - ref: ${{ github.event.pull_request.merge_commit_sha || github.sha }} + ref: ${{ github.event.pull_request.merge_commit_sha || inputs.ref || github.sha }} - uses: pnpm/action-setup@fc06bc1257f339d1d5d8b3a19a8cae5388b55320 # v4.4.0 - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0 with: node-version: 24 cache: pnpm - # The docs site holds one version: an rc must not replace it. - - name: Check for a stable server SDK version + - name: Check for a final server SDK release id: docs + env: + RELEASES: ${{ needs.release.outputs.releases }} run: | - version=$(node -p "require('./packages/livekit-server-sdk/package.json').version") - if [[ "$version" != *-* ]]; then echo "stable=true" >> "$GITHUB_OUTPUT"; fi + if jq -e 'any(.[]; .package == "livekit-server-sdk" and .prerelease == false)' <<< "${RELEASES:-[]}" >/dev/null; then + echo "stable=true" >> "$GITHUB_OUTPUT" + fi - if: steps.docs.outputs.stable == 'true' run: pnpm install # The build writes src/version.ts, which the docs need. From 10da6cd0f7bf6cbc9a3d0e46060d00fca3be5af3 Mon Sep 17 00:00:00 2001 From: lukasIO Date: Tue, 17 Nov 2026 14:50:43 +0100 Subject: [PATCH 6/8] Release: drop the source guard step The next verwalter release checks in publish that each package matches its tag (livekit/verwalter#105). Until then, a run by hand sets ref to the tag. Co-Authored-By: Claude Opus 5.5 --- .github/workflows/release.yml | 27 +++------------------------ 1 file changed, 3 insertions(+), 24 deletions(-) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 1490a942..226686ec 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -74,30 +74,9 @@ jobs: with: ref: ${{ github.event.pull_request.merge_commit_sha || inputs.ref || github.sha }} fetch-depth: 0 # tags decide what is published - # verwalter checks only that the tag exists. A run by hand on a newer - # commit would publish other source under the tagged version. Check - # what this run publishes: in `releases` when it lists any, tagged, - # and not on npm yet. - - name: Make sure that each package to publish matches its release tag - env: - RELEASES: ${{ needs.release.outputs.releases }} - run: | - releases=${RELEASES:-[]} - for dir in packages/*/; do - name=$(node -p "require('./${dir}package.json').name") - tag="$name@$(node -p "require('./${dir}package.json').version")" - if [ "$(jq length <<< "$releases")" -gt 0 ] && ! jq -e --arg n "$name" 'any(.[]; .package == $n)' <<< "$releases" >/dev/null; then - continue - fi - git rev-parse -q --verify "refs/tags/$tag" >/dev/null || continue - if [ -n "$(npm view "$tag" version 2>/dev/null)" ]; then - continue - fi - if ! git diff --quiet "$tag" HEAD -- "$dir"; then - echo "::error::$dir differs from $tag. Start the run with ref=$tag." - exit 1 - fi - done + # verwalter v0.30.0 checks only that the tag exists, not that the + # checkout matches it: set `ref` to the tag on a run by hand. The next + # verwalter release checks this in `publish` (livekit/verwalter#105). - uses: pnpm/action-setup@fc06bc1257f339d1d5d8b3a19a8cae5388b55320 # v4.4.0 # No registry-url: npm trusted publishing needs no token, and the # placeholder token setup-node writes would make the publish fail. From 8d3b36b66b371d2c0dc562c15dc916c5f4d878b8 Mon Sep 17 00:00:00 2001 From: lukasIO Date: Thu, 19 Nov 2026 13:05:41 +0100 Subject: [PATCH 7/8] Release: verwalter v0.31.0, verify the end state v0.31.0 checks in publish that each package matches its tag, so the note about v0.30.0 goes. A verify job runs status --check after the publish, as in the upstream example. Co-Authored-By: Claude Opus 5.5 --- .github/workflows/changeset-check.yml | 2 +- .github/workflows/pre-release.yml | 2 +- .github/workflows/release-pr.yml | 2 +- .github/workflows/release.yml | 25 ++++++++++++++++++++----- 4 files changed, 23 insertions(+), 8 deletions(-) diff --git a/.github/workflows/changeset-check.yml b/.github/workflows/changeset-check.yml index 36f8bdba..4bd780c8 100644 --- a/.github/workflows/changeset-check.yml +++ b/.github/workflows/changeset-check.yml @@ -21,6 +21,6 @@ jobs: runs-on: ubuntu-latest steps: - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 - - uses: livekit/verwalter@359985c1e5567b17ae84db0241fbb305c383f89e # v0.30.0 + - uses: livekit/verwalter@39e3d7c57c2b6d96cf2d4b7771f3ab199490faba # v0.31.0 with: command: check diff --git a/.github/workflows/pre-release.yml b/.github/workflows/pre-release.yml index fe6b3dc3..97e71e76 100644 --- a/.github/workflows/pre-release.yml +++ b/.github/workflows/pre-release.yml @@ -21,7 +21,7 @@ jobs: - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 with: fetch-depth: 0 # the tags number the rc - - uses: livekit/verwalter@359985c1e5567b17ae84db0241fbb305c383f89e # v0.30.0 + - uses: livekit/verwalter@39e3d7c57c2b6d96cf2d4b7771f3ab199490faba # v0.31.0 with: command: pre-release args: --target ${{ github.ref_name }} diff --git a/.github/workflows/release-pr.yml b/.github/workflows/release-pr.yml index 6094f2dc..84146d9a 100644 --- a/.github/workflows/release-pr.yml +++ b/.github/workflows/release-pr.yml @@ -25,7 +25,7 @@ jobs: - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 with: fetch-depth: 0 # the commit that added a changeset gives its changelog line the PR and author - - uses: livekit/verwalter@359985c1e5567b17ae84db0241fbb305c383f89e # v0.30.0 + - uses: livekit/verwalter@39e3d7c57c2b6d96cf2d4b7771f3ab199490faba # v0.31.0 with: command: pr # A GitHub App token lets the release PRs trigger CI; the default diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 226686ec..87d77a02 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -49,7 +49,7 @@ jobs: ref: ${{ github.event.pull_request.merge_commit_sha || inputs.ref || github.sha }} fetch-depth: 0 - id: verwalter - uses: livekit/verwalter@359985c1e5567b17ae84db0241fbb305c383f89e # v0.30.0 + uses: livekit/verwalter@39e3d7c57c2b6d96cf2d4b7771f3ab199490faba # v0.31.0 with: command: release args: ${{ inputs.package && format('--package {0}', inputs.package) || '' }} @@ -74,9 +74,6 @@ jobs: with: ref: ${{ github.event.pull_request.merge_commit_sha || inputs.ref || github.sha }} fetch-depth: 0 # tags decide what is published - # verwalter v0.30.0 checks only that the tag exists, not that the - # checkout matches it: set `ref` to the tag on a run by hand. The next - # verwalter release checks this in `publish` (livekit/verwalter#105). - uses: pnpm/action-setup@fc06bc1257f339d1d5d8b3a19a8cae5388b55320 # v4.4.0 # No registry-url: npm trusted publishing needs no token, and the # placeholder token setup-node writes would make the publish fail. @@ -89,7 +86,7 @@ jobs: run: pnpm --filter="livekit-server-sdk" build - name: Build rtc-node run: pnpm --filter="@livekit/rtc-node" build - - uses: livekit/verwalter@359985c1e5567b17ae84db0241fbb305c383f89e # v0.30.0 + - uses: livekit/verwalter@39e3d7c57c2b6d96cf2d4b7771f3ab199490faba # v0.31.0 env: GH_TOKEN: ${{ github.token }} with: @@ -98,6 +95,24 @@ jobs: # Its own job: a docs failure is red, and the publish job stays green, # so it is clear that the release is complete. A re-run is safe. + # The end state, asserted: `status --check` fails when a tag is not on + # the remote, a GitHub release is missing or still a draft, or npm does + # not have the version. A step that was skipped without an error ends here. + verify: + needs: publish + runs-on: ubuntu-latest + permissions: + contents: write # reads only. A draft release is visible only with write access + steps: + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + with: + ref: ${{ github.event.pull_request.merge_commit_sha || inputs.ref || github.sha }} + fetch-depth: 0 + - uses: livekit/verwalter@39e3d7c57c2b6d96cf2d4b7771f3ab199490faba # v0.31.0 + with: + command: status + args: --check + # The docs site holds one version, the newest final server SDK release # from main. An rc, another branch, or a release of rtc-node alone must # not replace it. From 4667e06926a05de8ff5f7a196900f126a3a3e057 Mon Sep 17 00:00:00 2001 From: lukasIO Date: Thu, 19 Nov 2026 13:12:15 +0100 Subject: [PATCH 8/8] Release: build before the tag A build job runs first and uploads the build output. A build that fails now stops the run before release creates any tag. publish and docs use that output instead of building after the tag. Co-Authored-By: Claude Opus 5.5 --- .github/workflows/release.yml | 58 ++++++++++++++++++++++++++++------- 1 file changed, 47 insertions(+), 11 deletions(-) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 87d77a02..39d60d24 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -33,11 +33,44 @@ permissions: id-token: write # trusted publishing jobs: - release: + # Build before the tag: a build that fails stops the run before + # anything is public. The publish and docs jobs use this build. + build: # Only a release PR the tool opened: the branch prefix alone would let # any pushed `release/*` branch trigger a publish. if: github.event_name == 'workflow_dispatch' || (github.event.pull_request.merged == true && startsWith(github.event.pull_request.head.ref, 'release/') && github.event.pull_request.user.login == 'verwalter-release[bot]' && contains(github.event.pull_request.body, '')) runs-on: ubuntu-latest + permissions: + contents: read + steps: + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + with: + ref: ${{ github.event.pull_request.merge_commit_sha || inputs.ref || github.sha }} + - uses: pnpm/action-setup@fc06bc1257f339d1d5d8b3a19a8cae5388b55320 # v4.4.0 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0 + with: + node-version: 24 + cache: pnpm + - run: pnpm install + - name: Build server SDK + run: pnpm --filter="livekit-server-sdk" build + - name: Build rtc-node + run: pnpm --filter="@livekit/rtc-node" build + # The build output, and the generated version file that both + # packages ship in `src`. + - uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2 + with: + name: build + if-no-files-found: error + path: | + packages/livekit-server-sdk/dist + packages/livekit-server-sdk/src/version.ts + packages/livekit-rtc/dist + packages/livekit-rtc/src/version.ts + + release: + needs: build + runs-on: ubuntu-latest outputs: released: ${{ steps.verwalter.outputs.released }} releases: ${{ steps.verwalter.outputs.releases }} @@ -82,10 +115,10 @@ jobs: node-version: 24 # npm 11.5.1 or later is required for OIDC cache: pnpm - run: pnpm install - - name: Build server SDK - run: pnpm --filter="livekit-server-sdk" build - - name: Build rtc-node - run: pnpm --filter="@livekit/rtc-node" build + - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2 + with: + name: build + path: packages - uses: livekit/verwalter@39e3d7c57c2b6d96cf2d4b7771f3ab199490faba # v0.31.0 env: GH_TOKEN: ${{ github.token }} @@ -93,8 +126,6 @@ jobs: command: publish releases: ${{ needs.release.outputs.releases }} - # Its own job: a docs failure is red, and the publish job stays green, - # so it is clear that the release is complete. A re-run is safe. # The end state, asserted: `status --check` fails when a tag is not on # the remote, a GitHub release is missing or still a draft, or npm does # not have the version. A step that was skipped without an error ends here. @@ -113,6 +144,8 @@ jobs: command: status args: --check + # Its own job: a docs failure is red, and the publish job stays green, + # so it is clear that the release is complete. A re-run is safe. # The docs site holds one version, the newest final server SDK release # from main. An rc, another branch, or a release of rtc-node alone must # not replace it. @@ -141,12 +174,15 @@ jobs: fi - if: steps.docs.outputs.stable == 'true' run: pnpm install - # The build writes src/version.ts, which the docs need. + # The build job's output has src/version.ts, which the docs need. + - if: steps.docs.outputs.stable == 'true' + uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2 + with: + name: build + path: packages - name: Build Server SDK Docs if: steps.docs.outputs.stable == 'true' - run: | - pnpm --filter=livekit-server-sdk build - pnpm --filter=livekit-server-sdk build-docs + run: pnpm --filter=livekit-server-sdk build-docs - name: S3 Upload Server SDK Docs if: steps.docs.outputs.stable == 'true' run: aws s3 cp packages/livekit-server-sdk/docs/ s3://livekit-docs/server-sdk-js --recursive