release_sdk_node_npm.yml

name: Publish SDK Node Package

on:
  workflow_dispatch:
    inputs:
      dry_run:
        description: "Dry run (do not actually publish to npm)"
        required: false
        type: boolean
        default: false

env:
  CARGO_TERM_COLOR: always
  SURFPOOL_WEB_UI_VERSION: 0.2.0-alpha.0

jobs:
  prepare_release:
    name: Prepare Release
    runs-on: ubuntu-latest
    outputs:
      version: ${{ steps.package.outputs.version }}
      publish_root: ${{ steps.package.outputs.publish_root }}
      publish_darwin_x64: ${{ steps.package.outputs.publish_darwin_x64 }}
      publish_darwin_arm64: ${{ steps.package.outputs.publish_darwin_arm64 }}
      publish_linux_x64_gnu: ${{ steps.package.outputs.publish_linux_x64_gnu }}
      should_publish: ${{ steps.package.outputs.should_publish }}
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Set up Node
        uses: actions/setup-node@v4
        with:
          node-version: 22.14.0
          registry-url: https://registry.npmjs.org

      - name: Ensure npm 11
        run: |
          npm install -g npm@^11.10.0
          npm --version

      - name: Read package version
        id: package
        working-directory: crates/sdk-node
        shell: bash
        run: |
          VERSION=$(node -p "require('./package.json').version")
          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
          SHOULD_PUBLISH=false

          for ENTRY in \
            "@solana/surfpool publish_root" \
            "@solana/surfpool-darwin-x64 publish_darwin_x64" \
            "@solana/surfpool-darwin-arm64 publish_darwin_arm64" \
            "@solana/surfpool-linux-x64-gnu publish_linux_x64_gnu"
          do
            PACKAGE_NAME="${ENTRY% *}"
            OUTPUT_NAME="${ENTRY#* }"

            if npm view "${PACKAGE_NAME}@${VERSION}" version --registry=https://registry.npmjs.org >/dev/null 2>&1; then
              echo "${OUTPUT_NAME}=false" >> "$GITHUB_OUTPUT"
              echo "${PACKAGE_NAME}@${VERSION} is already published"
            else
              echo "${OUTPUT_NAME}=true" >> "$GITHUB_OUTPUT"
              echo "${PACKAGE_NAME}@${VERSION} is ready to publish"
              SHOULD_PUBLISH=true
            fi
          done

          echo "should_publish=${SHOULD_PUBLISH}" >> "$GITHUB_OUTPUT"

  build_artifacts:
    name: Build (${{ matrix.name }})
    needs: prepare_release
    if: needs.prepare_release.outputs.should_publish == 'true'
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        include:
          - name: linux-x64
            os: ubuntu-22.04
            upload_metadata: true
            platform_dir: linux-x64-gnu
          - name: macos-x64
            os: macos-15-intel
            upload_metadata: false
            platform_dir: darwin-x64
          - name: macos-arm64
            os: macos-15
            upload_metadata: false
            platform_dir: darwin-arm64

    steps:
      - name: Install Linux dependencies
        if: runner.os == 'Linux'
        run: sudo apt-get update && sudo apt-get install -y libudev-dev clang libclang-dev

      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Set up Rust
        uses: dtolnay/rust-toolchain@stable

      - name: Cache Rust artifacts
        uses: Swatinem/rust-cache@v2
        with:
          prefix-key: v1-rust
          cache-bin: false
          workspaces: |
            . -> target

      - name: Set up Node
        uses: actions/setup-node@v4
        with:
          node-version: 22.14.0
          cache: npm
          cache-dependency-path: crates/sdk-node/package-lock.json

      - name: Install npm dependencies
        working-directory: crates/sdk-node
        run: npm ci

      - name: Build npm package
        working-directory: crates/sdk-node
        run: npm run build

      - name: Smoke test package
        working-directory: crates/sdk-node
        run: npm run smoke

      - name: Verify install from packed tarballs
        working-directory: crates/sdk-node
        shell: bash
        run: |
          set -euo pipefail
          npm run create-npm-dir
          # Place the freshly built binary into its platform package so `npm pack` includes it.
          cp surfpool-sdk/surfpool-sdk.*.node "npm/${{ matrix.platform_dir }}/"
          # Build TS so the root tarball ships dist/.
          npm run build:ts
          PACK_DIR="$(mktemp -d)"
          ROOT_TARBALL="$(npm pack --silent --pack-destination "$PACK_DIR")"
          ROOT_TARBALL_PATH="$PACK_DIR/$ROOT_TARBALL"
          pushd "npm/${{ matrix.platform_dir }}" >/dev/null
          PLATFORM_TARBALL="$(npm pack --silent --pack-destination "$PACK_DIR")"
          PLATFORM_TARBALL_PATH="$PACK_DIR/$PLATFORM_TARBALL"
          popd >/dev/null
          # Confirm the root's optionalDependencies reference the @solana/ scoped platform packages.
          node -e "
            const o = require('./package.json').optionalDependencies || {};
            const ok = Object.keys(o).every(k => k.startsWith('@solana/surfpool-'));
            if (!ok) { console.error('optionalDependencies missing @solana/ scope:', o); process.exit(1); }
          "
          INSTALL_DIR="$(mktemp -d)"
          pushd "$INSTALL_DIR" >/dev/null
          npm init -y >/dev/null
          npm install --no-audit --no-fund "$PLATFORM_TARBALL_PATH" "$ROOT_TARBALL_PATH"
          node -e "require('@solana/surfpool'); console.log('require @solana/surfpool OK');"
          # The kit peers are optional and not auto-installed; installing them
          # here validates the documented opt-in flow for the ./kit entry.
          npm install --no-audit --no-fund "@solana/kit@^8.0.0" "@solana/kit-plugin-rpc@^0.18.0" "@solana/kit-plugin-signer@^0.18.0"
          node -e "
            const kit = require('@solana/surfpool/kit');
            if (typeof kit.surfpool !== 'function') { throw new Error('missing surfpool export'); }
            console.log('require @solana/surfpool/kit OK');
          "
          node --input-type=module -e "
            import('@solana/surfpool/kit').then(kit => {
              if (typeof kit.surfpool !== 'function') { throw new Error('missing surfpool export'); }
              console.log('import @solana/surfpool/kit OK');
            });
          "
          popd >/dev/null

      - name: Upload native binary
        uses: actions/upload-artifact@v4
        with:
          name: sdk-node-${{ matrix.name }}-binary
          path: crates/sdk-node/surfpool-sdk/surfpool-sdk.*.node
          if-no-files-found: error

      - name: Upload package metadata
        if: matrix.upload_metadata
        uses: actions/upload-artifact@v4
        with:
          name: sdk-node-package-metadata
          path: |
            crates/sdk-node/surfpool-sdk/internal.js
            crates/sdk-node/surfpool-sdk/internal.d.ts
          if-no-files-found: error

  publish:
    name: Publish To npm
    needs:
      - prepare_release
      - build_artifacts
    if: needs.prepare_release.outputs.should_publish == 'true'
    runs-on: ubuntu-latest
    environment: release
    permissions:
      contents: read
      id-token: write
    steps:
      - name: Install Linux dependencies
        run: sudo apt-get update && sudo apt-get install -y libudev-dev clang libclang-dev

      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Set up Rust
        uses: dtolnay/rust-toolchain@stable

      - name: Set up Node
        uses: actions/setup-node@v4
        with:
          node-version: 22.14.0
          registry-url: https://registry.npmjs.org
          cache: npm
          cache-dependency-path: crates/sdk-node/package-lock.json

      - name: Ensure npm 11
        run: |
          npm install -g npm@^11.10.0
          npm --version

      - name: Install publish tooling
        working-directory: crates/sdk-node
        run: npm ci

      - name: Download native binaries
        uses: actions/download-artifact@v4
        with:
          pattern: sdk-node-*-binary
          path: crates/sdk-node/artifacts

      - name: Download package metadata
        uses: actions/download-artifact@v4
        with:
          name: sdk-node-package-metadata
          path: crates/sdk-node/surfpool-sdk

      - name: Create npm platform package directories
        working-directory: crates/sdk-node
        run: npm run create-npm-dir

      - name: Copy artifacts into npm platform packages
        working-directory: crates/sdk-node
        run: npm run artifacts

      - name: Build TypeScript wrapper
        working-directory: crates/sdk-node
        run: npm run build:ts

      - name: Pack root npm tarball
        working-directory: crates/sdk-node
        run: NPM_CONFIG_CACHE=$(mktemp -d) npm pack --dry-run

      - name: Pack platform npm tarballs
        working-directory: crates/sdk-node
        run: |
          cd npm/darwin-x64 && NPM_CONFIG_CACHE=$(mktemp -d) npm pack --dry-run
          cd ../darwin-arm64 && NPM_CONFIG_CACHE=$(mktemp -d) npm pack --dry-run
          cd ../linux-x64-gnu && NPM_CONFIG_CACHE=$(mktemp -d) npm pack --dry-run

      - name: Publish darwin-x64 package
        if: inputs.dry_run != true && needs.prepare_release.outputs.publish_darwin_x64 == 'true'
        working-directory: crates/sdk-node/npm/darwin-x64
        run: npm publish --access public --provenance

      - name: Publish darwin-arm64 package
        if: inputs.dry_run != true && needs.prepare_release.outputs.publish_darwin_arm64 == 'true'
        working-directory: crates/sdk-node/npm/darwin-arm64
        run: npm publish --access public --provenance

      - name: Publish linux-x64-gnu package
        if: inputs.dry_run != true && needs.prepare_release.outputs.publish_linux_x64_gnu == 'true'
        working-directory: crates/sdk-node/npm/linux-x64-gnu
        run: npm publish --access public --provenance

      - name: Dry run darwin-x64 publish
        if: inputs.dry_run == true && needs.prepare_release.outputs.publish_darwin_x64 == 'true'
        working-directory: crates/sdk-node/npm/darwin-x64
        run: npm publish --dry-run --access public

      - name: Dry run darwin-arm64 publish
        if: inputs.dry_run == true && needs.prepare_release.outputs.publish_darwin_arm64 == 'true'
        working-directory: crates/sdk-node/npm/darwin-arm64
        run: npm publish --dry-run --access public

      - name: Dry run linux-x64-gnu publish
        if: inputs.dry_run == true && needs.prepare_release.outputs.publish_linux_x64_gnu == 'true'
        working-directory: crates/sdk-node/npm/linux-x64-gnu
        run: npm publish --dry-run --access public

      - name: Publish root package
        if: inputs.dry_run != true && needs.prepare_release.outputs.publish_root == 'true'
        working-directory: crates/sdk-node
        run: npm publish --access public --provenance

      - name: Dry run root publish
        if: inputs.dry_run == true && needs.prepare_release.outputs.publish_root == 'true'
        working-directory: crates/sdk-node
        run: npm publish --dry-run --access public