Add nightly and pre-release support to publish workflow

Author: clavery

.github/workflows/publish.yml

@@ -5,6 +5,17 @@ on:
     tags:
       - 'v[0-9]+.[0-9]+.[0-9]+' # Stable releases: v1.0.0, v2.1.3
       - 'v[0-9]+.[0-9]+.[0-9]+-*' # Pre-releases: v1.0.0-beta.1, v1.0.0-rc.1
+  schedule:
+    - cron: '0 2 * * 1-5' # Weekdays at 2 AM UTC (Mon-Fri)
+  workflow_dispatch:
+    inputs:
+      release_type:
+        description: 'Release type'
+        required: true
+        default: 'nightly'
+        type: choice
+        options:
+          - nightly
 
 jobs:
   publish:
@@ -17,7 +28,27 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
+      - name: Determine release type
+        id: release-type
+        run: |
+          if [[ "${{ github.event_name }}" == "push" && "${{ github.ref_type }}" == "tag" ]]; then
+            echo "type=stable" >> $GITHUB_OUTPUT
+            # Pre-release versions (v1.0.0-beta.1) publish to @next, stable to @latest
+            if [[ "$GITHUB_REF_NAME" =~ ^v[0-9]+\.[0-9]+\.[0-9]+-.+ ]]; then
+              echo "tag=next" >> $GITHUB_OUTPUT
+              echo "prerelease=true" >> $GITHUB_OUTPUT
+            else
+              echo "tag=latest" >> $GITHUB_OUTPUT
+              echo "prerelease=false" >> $GITHUB_OUTPUT
+            fi
+          else
+            echo "type=nightly" >> $GITHUB_OUTPUT
+            echo "tag=nightly" >> $GITHUB_OUTPUT
+            echo "prerelease=false" >> $GITHUB_OUTPUT
+          fi
+
       - name: Validate tag matches package version
+        if: steps.release-type.outputs.type == 'stable'
         run: |
           TAG_VERSION="${GITHUB_REF_NAME#v}"
           PKG_VERSION=$(node -p "require('./packages/b2c-tooling-sdk/package.json').version")
@@ -39,6 +70,10 @@ jobs:
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
 
+      - name: Create snapshot versions
+        if: steps.release-type.outputs.type == 'nightly'
+        run: pnpm changeset version --snapshot nightly
+
       - name: Build packages
         run: pnpm run build
 
@@ -47,11 +82,12 @@ jobs:
 
       - name: Publish to npm
         run: |
-          pnpm --filter @salesforce/b2c-tooling-sdk publish --access public --no-git-checks
-          pnpm --filter @salesforce/b2c-cli publish --access public --no-git-checks
-          pnpm --filter @salesforce/b2c-dx-mcp publish --access public --no-git-checks
+          pnpm --filter @salesforce/b2c-tooling-sdk publish --access public --no-git-checks --tag ${{ steps.release-type.outputs.tag }}
+          pnpm --filter @salesforce/b2c-cli publish --access public --no-git-checks --tag ${{ steps.release-type.outputs.tag }}
+          pnpm --filter @salesforce/b2c-dx-mcp publish --access public --no-git-checks --tag ${{ steps.release-type.outputs.tag }}
 
       - name: Extract changelog for release
+        if: steps.release-type.outputs.type == 'stable'
         run: |
           VERSION="${GITHUB_REF_NAME#v}"
 
@@ -79,6 +115,12 @@ jobs:
           } > /tmp/release-notes.md
 
       - name: Create GitHub Release
-        run: gh release create "$GITHUB_REF_NAME" --notes-file /tmp/release-notes.md
+        if: steps.release-type.outputs.type == 'stable'
+        run: |
+          PRERELEASE_FLAG=""
+          if [[ "${{ steps.release-type.outputs.prerelease }}" == "true" ]]; then
+            PRERELEASE_FLAG="--prerelease"
+          fi
+          gh release create "$GITHUB_REF_NAME" --notes-file /tmp/release-notes.md $PRERELEASE_FLAG
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

PUBLISHING.md

@@ -9,6 +9,27 @@ The project uses:
 - **[npm Trusted Publishers](https://docs.npmjs.com/trusted-publishers)** with OIDC for secure, tokenless publishing
 - **Two-workflow architecture** separating version management from publishing
 
+## Release Types
+
+| Type | npm Tag | Trigger | GitHub Release |
+|------|---------|---------|----------------|
+| **Stable** (`1.0.0`) | `@latest` | Git tag `v1.0.0` | Release |
+| **Pre-release** (`1.0.0-beta.1`) | `@next` | Git tag `v1.0.0-beta.1` | Pre-release |
+| **Nightly** (`0.0.1-nightly-20250113`) | `@nightly` | Scheduled (weekdays) or manual | None |
+
+### Installing Different Versions
+
+```bash
+# Stable release (default)
+npm install @salesforce/b2c-cli
+
+# Pre-release (beta, preview, rc)
+npm install @salesforce/b2c-cli@next
+
+# Nightly snapshot
+npm install @salesforce/b2c-cli@nightly
+```
+
 ## Published Packages
 
 Only these three packages are published to npm:
@@ -38,8 +59,11 @@ The publish workflow explicitly filters to only these three packages using `--fi
 
 ### Workflow 2: `publish.yml` - npm Publishing
 
-- **Trigger**: Push of version tags (`v1.0.0`, `v1.0.0-beta.1`, etc.)
-- **Purpose**: Publishes packages to npm and creates GitHub Release
+- **Triggers**:
+  - Push of version tags (`v1.0.0`, `v1.0.0-beta.1`, etc.) - stable/pre-releases
+  - Schedule (weekdays at 2 AM UTC) - nightly snapshots
+  - Manual `workflow_dispatch` - on-demand nightly
+- **Purpose**: Publishes packages to npm and creates GitHub Releases (for tag-based releases)
 - **Permissions**: `contents: write`, `id-token: write` (for OIDC)
 - **Security**: Uses npm OIDC trusted publishers - no npm token required
 
@@ -94,7 +118,39 @@ When ready to release:
    - Validate the tag matches package versions
    - Build and test all packages
    - Publish to npm via OIDC
-   - Create a GitHub Release with auto-generated notes
+   - Create a GitHub Release with aggregated changelogs
+
+### Pre-releases (Beta, Preview, RC)
+
+For pre-release versions, use changesets pre-release mode:
+
+```bash
+# Enter pre-release mode
+pnpm changeset pre enter beta
+
+# Continue normal workflow: create changesets, merge version PR
+# Versions will be like 1.0.0-beta.0, 1.0.0-beta.1, etc.
+
+# Exit pre-release mode when ready for stable
+pnpm changeset pre exit
+```
+
+Pre-release tags (`v1.0.0-beta.1`) publish to `@next` and create GitHub Pre-releases.
+
+### Nightly Releases
+
+Nightly releases run automatically on weekdays at 2 AM UTC. They can also be triggered manually:
+
+1. Go to **Actions** → **Publish to npm** workflow
+2. Click **Run workflow**
+3. Select `nightly` and click **Run workflow**
+
+Nightly versions use changesets snapshot format: `0.0.1-nightly-20250113`
+
+**Notes:**
+- Nightly releases do NOT create GitHub releases
+- They publish to the `@nightly` npm tag
+- Each nightly overwrites the previous `@nightly` tag
 
 ## Changeset Configuration