Skip to content

chore: prepare v3.0.0-rc.1 #157

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
olliethedev merged 2 commits into from
Aug 21, 2026
Merged

chore: prepare v3.0.0-rc.1 #157

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c67e31c
ci: publish prereleases with npm next
olliethedev Aug 21, 2026
5f2266e
chore: prepare v3.0.0-rc.1
olliethedev Aug 21, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
131 changes: 112 additions & 19 deletions .github/workflows/release.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ on:
types: [published]

permissions:
contents: write
contents: read
id-token: write

jobs:
Expand All @@ -29,7 +29,7 @@ jobs:
- name: Update npm
run: npm install -g npm@latest

- run: pnpm install
- run: pnpm install --frozen-lockfile

- name: Copy README files to published packages
run: |
Expand All @@ -50,40 +50,133 @@ jobs:
- name: Build @btst/codegen
run: pnpm --filter "@btst/codegen" build --force

- name: Verify tag matches package version
working-directory: packages/stack
- name: Validate release metadata
id: release_metadata
env:
RELEASE_TAG: ${{ github.event.release.tag_name }}
GITHUB_PRERELEASE: ${{ github.event.release.prerelease }}
run: |
PKG_VERSION=$(node -p "require('./package.json').version")
if [ -n "${{ github.event.release.tag_name }}" ]; then
RAW_TAG="${{ github.event.release.tag_name }}"
else
RAW_TAG="${GITHUB_REF#refs/tags/}"
fi
TAG_VERSION="${RAW_TAG#v}"
if [ "$PKG_VERSION" != "$TAG_VERSION" ]; then
echo "Tag version ($TAG_VERSION) does not match package.json version ($PKG_VERSION)"
set -euo pipefail

STACK_VERSION=$(node -p "require('./packages/stack/package.json').version")
CODEGEN_VERSION=$(node -p "require('./packages/cli/package.json').version")
TAG_VERSION="${RELEASE_TAG#v}"

if [ "$STACK_VERSION" != "$TAG_VERSION" ]; then
echo "Tag version ($TAG_VERSION) does not match @btst/stack version ($STACK_VERSION)"
exit 1
fi

- name: Publish to npm
NPM_DIST_TAG=latest
if [[ "$STACK_VERSION" == *-* || "$CODEGEN_VERSION" == *-* || "$GITHUB_PRERELEASE" == "true" ]]; then
NPM_DIST_TAG=next
fi

echo "stack_version=$STACK_VERSION" >> "$GITHUB_OUTPUT"
echo "codegen_version=$CODEGEN_VERSION" >> "$GITHUB_OUTPUT"
echo "npm_dist_tag=$NPM_DIST_TAG" >> "$GITHUB_OUTPUT"
echo "Publishing @btst/stack@$STACK_VERSION and @btst/codegen@$CODEGEN_VERSION with dist-tag '$NPM_DIST_TAG'"

- name: Publish @btst/stack to npm
working-directory: packages/stack
run: npm publish --access public --provenance
env:
NPM_DIST_TAG: ${{ steps.release_metadata.outputs.npm_dist_tag }}
PKG_VERSION: ${{ steps.release_metadata.outputs.stack_version }}
run: |
set -euo pipefail

if npm view "@btst/stack@$PKG_VERSION" version >/dev/null 2>&1; then
echo "@btst/stack@$PKG_VERSION is already published; skipping."
exit 0
fi
npm publish --access public --provenance --tag "$NPM_DIST_TAG"

- name: Publish @btst/codegen to npm
working-directory: packages/cli
env:
NPM_DIST_TAG: ${{ steps.release_metadata.outputs.npm_dist_tag }}
PKG_VERSION: ${{ steps.release_metadata.outputs.codegen_version }}
run: |
PKG_VERSION=$(node -p "require('./package.json').version")
set -euo pipefail

if npm view "@btst/codegen@$PKG_VERSION" version >/dev/null 2>&1; then
echo "@btst/codegen@$PKG_VERSION is already published; skipping."
exit 0
fi
npm publish --access public --provenance
npm publish --access public --provenance --tag "$NPM_DIST_TAG"

- name: Verify published packages
env:
NPM_DIST_TAG: ${{ steps.release_metadata.outputs.npm_dist_tag }}
STACK_VERSION: ${{ steps.release_metadata.outputs.stack_version }}
CODEGEN_VERSION: ${{ steps.release_metadata.outputs.codegen_version }}
run: |
set -euo pipefail

read_expected_version() {
local package_spec="$1"
local expected_version="$2"
local published_version=""

for attempt in {1..12}; do
published_version=$(npm view "$package_spec" version 2>/dev/null || true)
if [ "$published_version" = "$expected_version" ]; then
printf '%s\n' "$published_version"
return 0
fi
echo "Waiting for $package_spec to resolve to $expected_version (attempt $attempt/12)" >&2
sleep 10
done

echo "$package_spec resolves to ${published_version:-nothing}, expected $expected_version" >&2
return 1
}

PUBLISHED_STACK_VERSION=$(read_expected_version "@btst/stack@$NPM_DIST_TAG" "$STACK_VERSION")
PUBLISHED_CODEGEN_VERSION=$(read_expected_version "@btst/codegen@$NPM_DIST_TAG" "$CODEGEN_VERSION")
STACK_INTEGRITY=$(npm view "@btst/stack@$STACK_VERSION" dist.integrity)
CODEGEN_INTEGRITY=$(npm view "@btst/codegen@$CODEGEN_VERSION" dist.integrity)

if [ "$PUBLISHED_STACK_VERSION" != "$STACK_VERSION" ]; then
echo "@btst/stack@$NPM_DIST_TAG resolves to $PUBLISHED_STACK_VERSION, expected $STACK_VERSION"
exit 1
fi
if [ "$PUBLISHED_CODEGEN_VERSION" != "$CODEGEN_VERSION" ]; then
echo "@btst/codegen@$NPM_DIST_TAG resolves to $PUBLISHED_CODEGEN_VERSION, expected $CODEGEN_VERSION"
exit 1
fi
if [ -z "$STACK_INTEGRITY" ] || [ -z "$CODEGEN_INTEGRITY" ]; then
echo "Published package integrity metadata is missing"
exit 1
fi

LATEST_SUMMARY=""
if [ "$NPM_DIST_TAG" = "next" ]; then
STACK_LATEST_VERSION=$(npm view "@btst/stack@latest" version)
if [ "$STACK_LATEST_VERSION" = "$STACK_VERSION" ] || [[ "$STACK_LATEST_VERSION" == *-* ]]; then
echo "Prerelease publication must leave @btst/stack@latest on a stable version; found $STACK_LATEST_VERSION"
exit 1
fi
LATEST_SUMMARY="@btst/stack@latest remains at $STACK_LATEST_VERSION"
fi

{
echo "### npm release"
echo ""
echo "| Package | Version | Dist-tag | Integrity |"
echo "| --- | --- | --- | --- |"
echo "| @btst/stack | $STACK_VERSION | $NPM_DIST_TAG | \`$STACK_INTEGRITY\` |"
echo "| @btst/codegen | $CODEGEN_VERSION | $NPM_DIST_TAG | \`$CODEGEN_INTEGRITY\` |"
if [ -n "$LATEST_SUMMARY" ]; then
echo ""
echo "$LATEST_SUMMARY"
fi
} >> "$GITHUB_STEP_SUMMARY"

- name: Upload npm logs on failure
if: failure()
uses: actions/upload-artifact@v4
uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
with:
name: npm-debug-logs
path: /home/runner/.npm/_logs/
retention-days: 7

2 changes: 1 addition & 1 deletion packages/cli/package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@btst/codegen",
"version": "0.1.3",
"version": "0.2.0-rc.1",

@chatgpt-codex-connector chatgpt-codex-connector Bot Aug 21, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Pin prerelease codegen to the prerelease stack channel

When someone runs npx @btst/codegen@next init in a fresh project while latest still points to v2, this RC's installInitDependencies installs the bare spec @btst/stack (packages/cli/src/utils/package-installer.ts:37-45). npm's bundled npm-install documentation states that a bare <name> uses the latest tag, so the v3-generated templates are paired with the stable v2 stack rather than 3.0.0-rc.1 and can fail against the breaking v3 API changes. Make the prerelease CLI install @btst/stack@next or otherwise propagate its release channel.

Useful? React with 👍 / 👎.

"description": "BTST project scaffolding and CLI passthrough commands.",
"repository": {
"type": "git",
Expand Down
2 changes: 1 addition & 1 deletion packages/stack/package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@btst/stack",
"version": "3.0.0",
"version": "3.0.0-rc.1",
"description": "A composable, plugin-based library for building full-stack applications.",
"repository": {
"type": "git",
Expand Down
Loading