Jenkinsfile

pipeline {
    agent {
        docker {
            image 'node:26-trixie' // node 26 lts & debian 13 based image with git client
        }
    }
    stages {
        stage('Install Dependencies') {
            when {
                expression {
                    // skip gh-pages branch builds
                    return env.BRANCH_NAME != 'gh-pages';
                }
            }
            steps {
                sh 'npm ci'
            }
        }
        stage('Validate') {
            when {
                expression {
                    return env.BRANCH_NAME != 'gh-pages';
                }
            }
            steps {
                sh 'npm test'
                sh 'npm run build'
                sh 'npm run lint:spec'
            }
        }
        stage('Build & Deploy Branch') {
            environment {
                // 'data team jenkins' credentials
                GH_TOKEN = credentials('b7544320-e084-4912-a1c5-b330585aa8ee')
                // shelljs 0.x prints circular dependency warnings on Node 26
                NODE_OPTIONS = '--no-warnings'
            }
            when {
                expression {
                    return env.BRANCH_NAME != 'master' && env.BRANCH_NAME != 'gh-pages';
                }
            }
            options {
                // every deploy clones gh-pages, adds its output and force-pushes the whole site,
                // so concurrent deploys from different branches would overwrite each other
                lock('api-docs-gh-pages')
            }
            steps {
                sh 'npm run deploy-branch'
            }
        }
        stage('Build & Deploy Main') {
            environment {
                // 'data team jenkins' credentials
                GH_TOKEN = credentials('b7544320-e084-4912-a1c5-b330585aa8ee')
                // shelljs 0.x prints circular dependency warnings on Node 26
                NODE_OPTIONS = '--no-warnings'
            }
            when {
                branch 'master'
            }
            options {
                lock('api-docs-gh-pages')
            }
            steps {
                sh 'npm run deploy'
            }
        }
    }
    post {
        always {
            cleanWs()
        }
    }
}