Puzzles/add dcr base page pipeline

[gustavo-olmedo]

What does this change?

Adds the base DCR puzzles-page pipeline.

The new POST /PuzzlesPage endpoint:

• Validates the Frontend page payload and puzzles blueprint recursively.
• Checks for the exact puzzles-new-hub:variant participation.
• Renders the Guardian masthead, Puzzles & Games heading and footer.
• Returns the rendered HTML and prefetch headers to Frontend.
• Returns 404 without invoking the renderer when the experiment is off.

It also adds the puzzles-page types, shared experiment helper, development and production routes, render function, base page components and unit tests.

The blueprint-driven directory and final visual design will be implemented in the following tickets.

Why?

The Frontend /puzzles route added in the previous tickets needs a dedicated DCR endpoint.

Frontend builds the puzzles-page payload and sends it to POST /PuzzlesPage. DCR validates the data, applies the experiment guard, renders the base HTML document and returns it to Frontend.

This establishes a safe foundation for the following puzzles layout, styling and interaction work.

How has this change been tested?

Automated tests

Added Jest tests covering:

• Minimal and complete valid payloads.
• Rows, nested containers, items and archives.
• Card variants, cadence metadata, colours and desktop spans.
• Navigation targets, filter references and duplicate stable IDs.
• Variant, control, absent, malformed, unknown-group and unrelated experiment participations.
• Invalid-payload rejection.
• Proof that the renderer is not called when the experiment is off.
• Page title, description, canonical URL and Guardian configuration.
• Navigation extraction and ad-free/ad-enabled inputs.

The focused Jest tests and TypeScript checks pass.

Manual testing

Deployed to CODE and verified that:

• /puzzles returns the DCR-rendered base page for puzzles-new-hub:variant.
• The page contains the Guardian masthead, Puzzles & Games heading and footer.
• Experiment-off requests do not render the puzzles page.
• Ad-free users do not receive the header ad.

Screenshots

Not applicable. This PR establishes the page contract and rendering pipeline. The final blueprint-driven visual layout is covered by the following tickets.

[github-actions]

Deploy build 30749 of dotcom:rendering-all to CODE

All deployment options

• Deploy build 30749 of dotcom:rendering-all to CODE
• Deploy parts of build 30749 to CODE by previewing it first
• What's on CODE right now?

---

From guardian/actions-riff-raff.

[github-actions]

🚀 Image pushed to AWS ECR

Image digest: sha256:c2e972555658e482ba17292958b80a21abd663880d766e41f2978a041a55fc83

🐛 Run the image locally

The following can be used to run the image locally:

# Refer to image using the immutable digest. Find alternatives below.
IMAGE_IDENTIFIER="@sha256:c2e972555658e482ba17292958b80a21abd663880d766e41f2978a041a55fc83"

# Refer to image using branch tag
# IMAGE_IDENTIFIER=":branch-puzzles-add-dcr-base-page-pipeline"

# Refer to image using build tag
# IMAGE_IDENTIFIER=":build-30749"

# Refer to image via the GitHub commit SHA tag
# IMAGE_IDENTIFIER=":sha-428128cc38de993c768063f7a9f5d112364be290"

# Set environment variables for the AWS CLI
AWS_PROFILE="<A_PROFILE_FROM_JANUS>"
AWS_DEFAULT_REGION="eu-west-1"

IMAGE_ACCOUNT_ID=$(aws ssm get-parameter --name /organisation/accounts/deployTools --query "Parameter.Value" --output text)
REGISTRY="${IMAGE_ACCOUNT_ID}.dkr.ecr.${AWS_DEFAULT_REGION}.amazonaws.com"
IMAGE="${REGISTRY}/guardian/dotcom-rendering${IMAGE_IDENTIFIER}"

# Login to AWS ECR https://docs.aws.amazon.com/AmazonECR/latest/userguide/registry_auth.html
aws ecr get-login-password | docker login --username AWS --password-stdin $REGISTRY

# Pull the image
docker pull $IMAGE

# Run the image. You'll likely need to set additional flags. See https://docs.docker.com/reference/cli/docker/container/run.
docker run $IMAGE

---

From guardian/actions-publish-image.

[github-actions]

Deploy build 2983 of dotcom:ab-testing to CODE

All deployment options

• Deploy build 2983 of dotcom:ab-testing to CODE
• Deploy parts of build 2983 to CODE by previewing it first
• What's on CODE right now?

---

From guardian/actions-riff-raff.

[github-actions]

Hello 👋! When you're ready to run Chromatic, please apply the run_chromatic label to this PR.

You will need to reapply the label each time you want to run Chromatic.

Click here to see the Chromatic project.

[gu-prout]

Seen on PROD (merged by @gustavo-olmedo 8 minutes and 53 seconds ago) Please check your changes!