chore (draft): refactor server files to TypeScript

[AtofStryker]

• Closes

Additional details

Steps to test

How has the user experience changed?

PR Tasks

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

---

Note

Migrates server utilities and file server to TypeScript, updates random/env APIs and imports, integrates typed file server/HTTPS proxy, and adjusts tests accordingly.

• TypeScript Migration:
  • Convert file_server, util/env, and util/terminal-size from JS to TS; add typings for FileServer and HTTPS proxy Server.
  • Refactor util/file to TS File class with typed methods and noopFile; update call sites (cache.ts, saved_state.ts, tests) to import { File as FileUtil }.
• Import/API Alignment:
  • Replace default env import with * as env; in util/resolve.js use process.env directly.
  • Switch random helper to named id export and update usages across server (modes, run, cloud/auth, etc.).
  • In https-proxy/lib/index.ts, re-export type { Server }.
• Server Integration:
  • Replace JS file server with TS implementation; update server-base.ts to import * as fileServer, type cast _httpsProxy and _fileServer, and pass fileServerFolder as string.
  • Minor header/typing tweaks (e.g., set x-cypress-file-server-error to 'true', add @ts-expect-error notes).
• Behavioral/Utility Tweaks:
  • Ensure numeric interval in print-run.beginUploadActivityOutput via Number(UPLOAD_ACTIVITY_INTERVAL).
• Tests:
  • Update unit tests to TS imports and new File export; adjust random ID tests to use randomId.

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

[cypress]

cypress    Run #66908

Run Properties:   Failed #66908  •  18c1405b46: convert a handful of files to TypeScript

Project	cypress
Branch Review	chore/refactor_server_p2
Run status	Failed #66908
Run duration	43m 19s
Commit	18c1405b46: convert a handful of files to TypeScript
Committer	Bill Glesias
View all properties for this run ↗︎

---

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

---

Warning

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

UI Coverage  45.48%
Untested elements	188
Tested elements	161

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

---

Tests for review

  cypress/e2e/commands/files.cy.js • 1 failed test • 5x-driver-firefox

View Output

Test		Artifacts
src/cy/commands/files > #readFile > retries to read when ENOENT		</td> </tr></table>   commands/waiting.cy.js • 1 flaky test • 5x-driver-electron View Output Test Artifacts ... > errors > throws when waiting for 2nd response to route 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   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>   issues/28527.cy.ts • 1 flaky test • 5x-driver-firefox View Output Test Artifacts issue 28527 > fails and then retries and verifies about:blank is not displayed Screenshots   e2e/origin/config_env.cy.ts • 1 flaky test • 5x-driver-chrome View Output Test Artifacts cy.origin- Cypress.config() > serializable > overwrites different values in secondary if one exists in the primary Test Replay The first 5 flaky specs are shown, see all 10 specs in Cypress Cloud.