next-build tests

.github/workflows/set-tugboat-tests-pending.yml

@@ -28,6 +28,7 @@ jobs:
             va/tests/cypress
             va/tests/phpunit
             va/tests/content-build-gql
+            va/tests/next-build
             va/tests/status-error
           )
           for test_name in "${test_names[@]}"; do

composer.json

@@ -402,6 +402,7 @@
         "va:test:check-node-revision-logs": "Check the node revision log fields.",
         "va:test:check-taxonomy-revision-logs": "Check the taxonomy revision log fields.",
         "va:test:content-build-gql": "Run GraphQL export to test content-build.",
+        "va:test:next-build": "Test Next Build's use of JSON:API and Decoupled Router.",
         "va:test:cypress": "Run Cypress tests.",
         "va:test:cypress-ci": "Run Cypress tests with CI-specific functionality.",
         "va:test:cypress-interactive": "Run Cypress tests interactively (on host web browser).",
@@ -555,6 +556,12 @@
             "! ./scripts/should-run-directly.sh || ./tests/scripts/content-build-gql.sh",
             "./scripts/should-run-directly.sh || ddev composer va:test:content-build-gql --"
         ],
+        "va:test:next-build": [
+            "# Test Next Build's use of JSON:API and Decoupled Router.",
+            "# Auto-detects env from CMS_ENVIRONMENT_TYPE, or pass env name to override (e.g., tugboat)",
+            "! ./scripts/should-run-directly.sh || ./tests/scripts/next-build.sh \"$@\"",
+            "./scripts/should-run-directly.sh || ddev composer va:test:next-build -- \"$@\""
+        ],
         "va:test:cypress": [
             "# Run Cypress tests.",
             "! ./scripts/should-run-directly.sh || ./tests/scripts/cypress-tests.sh",

tests.yml

@@ -48,6 +48,12 @@ tasks:
           CONTEXT: va/tests/content-build-gql
           DESCRIPTION: 'Ensure that the content build graphql queries succeed'
 
+      - task: set-check-status
+        vars:
+          STATUS: pending
+          CONTEXT: va/tests/next-build
+          DESCRIPTION: 'Ensure that Next Build JSON:API and Decoupled Router queries succeed'
+
   va/tests/cypress:
     desc: Accessibility and Behavioral tests with Cypress
     # See also `composer va:test:cypress-parallel` in composer.json
@@ -75,6 +81,12 @@ tasks:
     cmds:
       - ./tests/scripts/ci-wrapper.sh content-build-gql 'va:test:content-build-gql'
 
+  va/tests/next-build:
+    desc: Ensure that Next Build JSON:API and Decoupled Router queries succeed
+    # See also `composer va:test:next-build` in composer.json
+    cmds:
+      - ./tests/scripts/ci-wrapper.sh next-build 'va:test:next-build'
+
   set-check-status:
     cmds:
       - |
@@ -88,4 +100,5 @@ tasks:
       - va/tests/cypress
       - va/tests/phpunit
       - va/tests/content-build-gql
+      - va/tests/next-build
       - va/tests/status-error

tests/scripts/next-build.sh

@@ -0,0 +1,225 @@
+#!/usr/bin/env bash
+# Tests Next Build's use of JSON:API and the Decoupled Router.
+#
+# Usage: next-build.sh [env-name]
+#   env-name: Optional environment name (e.g., tugboat, dev, staging, prod)
+#             Maps to next/envs/.env.{env-name}
+#             If not provided, auto-detects from CMS_ENVIRONMENT_TYPE
+
+set -eo pipefail
+
+# Number of pages to test per content type during export test
+EXPORT_TEST_PAGES_PER_CONTENT_TYPE=3
+
+# Pages that should always be tested (e.g., known edge cases, previously failing pages)
+ALWAYS_TEST_PAGES=(
+  /salt-lake-city-health-care/news-releases/new-data-shows-veterans-increased-use-of-online-va
+)
+
+export NVM_DIR="$HOME/.nvm"
+[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
+source ~/.bashrc
+
+repo_root="$(git rev-parse --show-toplevel)"
+# shellcheck source=/dev/null
+source "${repo_root}/.env"
+
+# Determine APP_ENV: use argument if provided, otherwise auto-detect from CMS_ENVIRONMENT_TYPE
+if [ -n "${1:-}" ]; then
+  if [ "$1" = "local" ]; then
+    APP_ENV="example"
+  else
+    APP_ENV="$1"
+  fi
+else
+  # Auto-detect based on CMS_ENVIRONMENT_TYPE
+  case "${CMS_ENVIRONMENT_TYPE:-}" in
+    tugboat) APP_ENV="tugboat" ;;
+    prod)    APP_ENV="prod" ;;
+    staging) APP_ENV="staging" ;;
+    dev)     APP_ENV="dev" ;;
+    *)       APP_ENV="" ;;  # Fall back to env-loader defaults
+  esac
+fi
+
+if [ -n "${APP_ENV}" ]; then
+  echo "Using APP_ENV: ${APP_ENV}"
+fi
+
+DRUPAL_ADDRESS="${DRUPAL_ADDRESS:-${DRUSH_OPTIONS_URI:-http://localhost}}"
+FAILURES=0
+
+# Generic HTTP test helper - returns body on stdout, exits non-zero on failure
+http_get() {
+  local url="$1"
+  local response body http_code
+  response=$(curl -gsS -w '\n%{http_code}' "$url" 2>&1) || return 1
+  http_code="${response##*$'\n'}"
+  body="${response%$'\n'*}"
+
+  if [[ "$http_code" != 200 ]]; then
+    echo "HTTP $http_code: $url" >&2
+    return 1
+  fi
+  printf '%s' "$body"
+}
+
+run_test() {
+  local name="$1"; shift
+  echo
+  echo "Test: $name starting..."
+
+  $@
+  exit_code=$?
+
+  echo
+
+  if [ "$exit_code" = "0" ]; then
+    echo "[PASSED $name]"
+    return 0
+  else
+    echo "[FAILED $name]"
+    ((FAILURES++))
+    return 1
+  fi
+}
+
+# Test assertions
+assert_json_path() {
+  local body="$1" path="$2"
+  jq -e "$path" <<<"$body" >/dev/null
+}
+
+# Get sample paths from a content type via JSON:API
+# Returns path aliases (one per line) on stdout
+get_sample_paths() {
+  local content_type="$1"
+  local limit="${EXPORT_TEST_PAGES_PER_CONTENT_TYPE:-1}"
+  local body
+  body=$(http_get "${DRUPAL_ADDRESS}/jsonapi/node/${content_type}?page[limit]=${limit}&filter[status]=1" 2>/dev/null) || return 0
+  jq -r '.data[].attributes.path.alias // empty' <<<"$body" 2>/dev/null
+}
+
+# Get enabled content types from the env file
+get_enabled_content_types() {
+  local env_file="${repo_root}/next/envs/.env.${APP_ENV:-example}"
+  if [[ ! -f "$env_file" ]]; then
+    echo "Warning: env file not found: $env_file" >&2
+    return
+  fi
+  # Parse FEATURE_NEXT_BUILD_CONTENT_*=true, extract content type, convert to lowercase
+  grep -E '^FEATURE_NEXT_BUILD_CONTENT_[A-Z_]+=true' "$env_file" \
+    | sed 's/^FEATURE_NEXT_BUILD_CONTENT_//; s/=true$//' \
+    | tr '[:upper:]' '[:lower:]'
+}
+
+# Build sample paths for all enabled content types
+build_sample_paths() {
+  local paths=()
+  local content_types
+  mapfile -t content_types < <(get_enabled_content_types)
+
+  # Include always-test pages first
+  if [[ ${#ALWAYS_TEST_PAGES[@]} -gt 0 ]]; then
+    echo "Adding ${#ALWAYS_TEST_PAGES[@]} always-test page(s)..." >&2
+    paths+=("${ALWAYS_TEST_PAGES[@]}")
+  fi
+
+  echo "Gathering ${EXPORT_TEST_PAGES_PER_CONTENT_TYPE} sample path(s) for ${#content_types[@]} content types from .env.${APP_ENV:-example}..." >&2
+  for ct in "${content_types[@]}"; do
+    local ct_paths
+    mapfile -t ct_paths < <(get_sample_paths "$ct")
+    if [[ ${#ct_paths[@]} -gt 0 ]]; then
+      paths+=("${ct_paths[@]}")
+      echo "  ${ct}: ${#ct_paths[@]} path(s)" >&2
+    else
+      echo "  ${ct}: (no content found)" >&2
+    fi
+  done
+
+  echo "Total paths to build: ${#paths[@]}" >&2
+
+  # Join with semicolons
+  local IFS=';'
+  echo "${paths[*]}"
+}
+
+router_get_uuid() {
+  local path="$1"
+  local body
+  body=$(http_get "${DRUPAL_ADDRESS}/router/translate-path?path=$(jq -rn --arg p "$path" '$p|@uri')") || return 1
+  assert_json_path "$body" '.jsonapi.individual' || return 1
+  jq -r '.entity.uuid' <<<"$body"
+}
+
+router_has_uuid() {
+  local uuid
+  uuid=$(router_get_uuid "$1") || return 1
+  [[ -n "$uuid" && "$uuid" != "null" ]]
+
+  printf "$uuid... "
+}
+
+jsonapi_has_data() {
+  local endpoint="$1"
+  local body
+  body=$(http_get "${DRUPAL_ADDRESS}${endpoint}") || return 1
+
+  echo $body | jq -rj '.data[0].id'
+  printf '... '
+
+  assert_json_path "$body" '.data[0].id'
+}
+
+router_to_jsonapi_flow() {
+  local path="$1" content_type="$2"
+  local uuid jsonapi_body
+
+  uuid=$(router_get_uuid "$path") || return 1
+  [[ -n "$uuid" && "$uuid" != "null" ]] || return 1
+
+  jsonapi_body=$(http_get "${DRUPAL_ADDRESS}/jsonapi/node/${content_type}/${uuid}") || return 1
+  [[ "$(jq -r '.data.id' <<<"$jsonapi_body")" == "$uuid" ]]
+}
+
+next_build() (
+  set -e
+
+  cd ./next
+  # silence nvm install stderr which outputs when the node version is already installed
+  nvm install 2>/dev/null
+  nvm use
+
+  # Build sample pages per content type (configurable via EXPORT_TEST_PAGES_PER_CONTENT_TYPE)
+  export SSG_CHERRY_PICKED_PATHS
+  SSG_CHERRY_PICKED_PATHS=$(build_sample_paths)
+  echo "Building paths: ${SSG_CHERRY_PICKED_PATHS}"
+  APP_ENV="${APP_ENV}" BUILD_OPTION=static yarn export --no-USE_REDIS
+)
+
+echo "Testing against: ${DRUPAL_ADDRESS}"
+echo ""
+
+# Router tests
+run_test "Router: VAMC system page"        router_has_uuid "/boston-health-care"
+run_test "Router: Event listing"           router_has_uuid "/boston-health-care/events"
+run_test "Router: Story listing"           router_has_uuid "/boston-health-care/stories"
+run_test "Router: Locations listing"       router_has_uuid "/boston-health-care/locations"
+
+# JSON:API tests
+run_test "JSON:API: VAMC system nodes"     jsonapi_has_data "/jsonapi/node/health_care_region_page?page[limit]=1"
+run_test "JSON:API: Event listing nodes"   jsonapi_has_data "/jsonapi/node/event_listing?page[limit]=1"
+run_test "JSON:API: Story listing nodes"   jsonapi_has_data "/jsonapi/node/story_listing?page[limit]=1"
+
+# Full flow tests
+run_test "Flow: VAMC system"               router_to_jsonapi_flow "/boston-health-care" "health_care_region_page"
+run_test "Flow: Event listing"             router_to_jsonapi_flow "/boston-health-care/events" "event_listing"
+
+# Next-build test (ensure next-build is not broken in this environment)
+run_test "Build: next-build"               next_build
+
+echo ""
+echo "Failures: $FAILURES"
+
+exit $((FAILURES > 0))