chore: use cloud validations for packages/server api request/response types

[cacieprins]

• Closes

Additional details

System tests currently fetch typescript definitions and example payloads for API endpoints when they run. This ensures our api calls are supported properly by the server.

This adds the same functionality to packages/server, so we can make sure our api functions use up-to-date typedefs from Cypress Cloud

Steps to test

How has the user experience changed?

PR Tasks

• [NA] Have tests been added/updated?
• [NA] Has a PR for user-facing changes been opened in cypress-documentation?
• [NA] Have API changes been updated in the type definitions?

---

Note

Fetches Cloud validation typings during install/build and updates server Cloud API to use them with tightened types and small flow tweaks.

• Server
  • Cloud validations:
    • Add scripts/sync-cloud-validations.sh to fetch lib/validations/cloudValidations.d.ts (ETag-based); wire via postinstall, build-prod, check-ts, and new scripts sync-cloud-validations/ensure-cloud-validations.
    • Ignore lib/validations/** in .gitignore and ESLint.
  • Cloud API typing:
    • Replace custom request/response interfaces with ../../validations/cloudValidations types in lib/cloud/api/index.ts and lib/cloud/api/create_instance.ts; add explicit method return types.
    • Gate capture protocol setup to e2e/component testing types.
    • postInstanceTests, postInstanceResults, updateInstanceStdout, updateInstanceArtifacts, createInstance now use validated request/response types.
  • User API:
    • Make getBaseLoginUrl async and read dashboardAuthUrl from getAuthUrls() result.
  • Record mode:
    • Refactor _postInstanceTests to async/await with centralized error handling; onTestsReceived handles SPEC: SKIP and error paths without invoking the callback.
• Tooling:
  • @tooling/v8-snapshot build ensures typedefs by invoking server ensure-cloud-validations.
• Deps/Scripts:
  • Add zod; update npm scripts accordingly.

^{Written by Cursor Bugbot for commit dfe3934. This will update automatically on new commits. Configure here.}

[cypress]

cypress    Run #67000

Run Properties:   Failed #67000  •  dfe3934bb1: do not lint server validations

Project	cypress
Branch Review	chore/use-api-typedefs
Run status	Failed #67000
Run duration	19m 34s
Commit	dfe3934bb1: do not lint server validations
Committer	Cacie Prins
View all properties for this run ↗︎

---

Test results
Failures	1
Flaky	14
Pending	1102
Skipped	4
Passing	26748
View all changes introduced in this branch ↗︎

---

Warning

Partial Report: The results for the Application Quality reports may be incomplete.

UI Coverage  45.2%
Untested elements	189
Tested elements	160

Accessibility  98%
Failed rules	4 critical   8 serious   2 moderate   2 minor
Failed elements	101

---

Tests for review

  src/gql-components/error/BaseError.cy.tsx • 1 failed test • frontend-shared-ct

View Output

Test		Artifacts
An uncaught error was detected outside of a test		Test Replay

  commands/actions/selectFile.cy.ts • 1 flaky test • 5x-driver-electron

View Output

Test		Artifacts
... > throws with aliased intercepts		Test Replay

  issues/28527.cy.ts • 1 flaky test • 5x-driver-electron

View Output

Test		Artifacts
issue 28527 > fails and then retries and verifies about:blank is not displayed		Test Replay Screenshots

  e2e/origin/config_env.cy.ts • 1 flaky test • 5x-driver-inject-document-domain-chrome

View Output

Test		Artifacts
cy.origin- Cypress.config() > serializable > overwrites different values in secondary if one exists in the primary		Test Replay

  commands/files.cy.js • 1 flaky test • 5x-driver-firefox

View Output

Test		Artifacts
src/cy/commands/files > #readFile > retries to read when ENOENT		</td> </tr></table>   commands/net_stubbing.cy.ts • 1 flaky test • 5x-driver-firefox View Output Test Artifacts ... > stops waiting when an xhr request is canceled </td> </tr></table> The first 5 flaky specs are shown, see all 13 specs in Cypress Cloud.

[AtofStryker]

do we no longer need this logic?

[cacieprins]

It's still there, just without the boolean flag. This "hanging" behavior is further down in the catch block that BugBot is complaining about.

[AtofStryker]

if we are doing this at the package level, do we still need to call it in CI after the build? Would be nice to get rid of this https://github.com/cypress-io/cypress/blob/develop/.circleci/src/pipeline/@pipeline.yml#L201

[cacieprins]

That's a fully separate cloud validations download, combining them was out of scope for this