chore: convert server/lib/plugins files from JS to TS

packages/data-context/src/data/ProjectConfigIpc.ts

@@ -24,7 +24,7 @@ import { TagStream } from '@packages/stderr-filtering'
 // NOTE: need the file:// prefix to avoid https://nodejs.org/api/errors.html#err_unsupported_esm_url_scheme on windows
 const tsx = os.platform() === 'win32' ? `file://${toPosix(require.resolve('tsx'))}` : toPosix(require.resolve('tsx'))
 
-export type IpcHandler = (ipc: ProjectConfigIpc) => void
+export type PluginIpcHandler = (ipc: ProjectConfigIpc) => void
 
 /**
  * If running as root on Linux, no-sandbox must be passed or Chrome will not start
@@ -194,7 +194,7 @@ export class ProjectConfigIpc extends EventEmitter {
     })
   }
 
-  async callSetupNodeEventsWithConfig (testingType: TestingType, config: FullConfig, handlers: IpcHandler[]): Promise<SetupNodeEventsReply> {
+  async callSetupNodeEventsWithConfig (testingType: TestingType, config: FullConfig, handlers: PluginIpcHandler[]): Promise<SetupNodeEventsReply> {
     for (const handler of handlers) {
       handler(this)
     }

packages/data-context/src/data/ProjectConfigManager.ts

@@ -1,5 +1,5 @@
 import { CypressError, getError } from '@packages/errors'
-import { DebugData, IpcHandler, LoadConfigReply, ProjectConfigIpc, SetupNodeEventsReply } from './ProjectConfigIpc'
+import { DebugData, PluginIpcHandler, LoadConfigReply, ProjectConfigIpc, SetupNodeEventsReply } from './ProjectConfigIpc'
 import assert from 'assert'
 import type { AllModeOptions, FullConfig, TestingType } from '@packages/types'
 import debugLib from 'debug'
@@ -34,7 +34,7 @@ type ProjectConfigManagerOptions = {
   ctx: DataContext
   configFile: string | false
   projectRoot: string
-  handlers: IpcHandler[]
+  handlers: PluginIpcHandler[]
   hasCypressEnvFile: boolean
   eventRegistrar: EventRegistrar
   onError: (cypressError: CypressError) => void

packages/data-context/src/util/pluginHandlers.ts

@@ -1,12 +1,12 @@
-import type { IpcHandler } from '../data'
+import type { PluginIpcHandler } from '../data'
 
-let pluginHandlers: IpcHandler[] = []
+let pluginHandlers: PluginIpcHandler[] = []
 
 export const getServerPluginHandlers = () => {
   return pluginHandlers
 }
 
-export const registerServerPluginHandler = (handler: IpcHandler) => {
+export const registerServerPluginHandler = (handler: PluginIpcHandler) => {
   pluginHandlers.push(handler)
 }
 

packages/server/lib/controllers/spec.ts

@@ -4,6 +4,7 @@ import { get as errorsGet } from '../errors'
 import preprocessor from '../plugins/preprocessor'
 import type { Cfg } from '../project-base'
 import type { Request, Response } from 'express'
+import type { PreprocessorError } from '@packages/types'
 
 const debug = Debug('cypress:server:controllers:spec')
 
@@ -49,7 +50,7 @@ export = {
     })
     .catch({ code: 'ECONNABORTED' }, ignoreECONNABORTED)
     .catch({ code: 'EPIPE' }, ignoreEPIPE)
-    .catch((err: any) => {
+    .catch((err: PreprocessorError) => {
       debug(`preprocessor error for spec '%s': %s`, spec, err.stack)
 
       if (!config.isTextTerminal) {

packages/server/lib/plugins/dev-server.ts

@@ -0,0 +1,60 @@
+import '../cwd'
+
+import { EventEmitter } from 'events'
+import debug from 'debug'
+import * as plugins from '../plugins'
+import type { FullConfig, SpecWithRelativeRoot, PluginIpcHandler } from '@packages/types'
+
+const debugFn = debug('cypress:ct:dev-server')
+
+const baseEmitter = new EventEmitter()
+
+interface SpecsChangedOptions {
+  neededForJustInTimeCompile?: boolean
+}
+
+interface SpecsChangedData {
+  specs: SpecWithRelativeRoot[]
+  options?: SpecsChangedOptions
+}
+
+interface CompileSuccessData {
+  specFile?: string
+}
+
+plugins.registerHandler((ipc: PluginIpcHandler) => {
+  baseEmitter.on('dev-server:specs:changed', (specsAndOptions: SpecsChangedData) => {
+    ipc.send('dev-server:specs:changed', specsAndOptions)
+  })
+
+  ipc.on('dev-server:compile:success', ({ specFile }: CompileSuccessData = {}) => {
+    baseEmitter.emit('dev-server:compile:success', { specFile })
+  })
+})
+
+// for simpler stubbing from unit tests
+interface DevServerAPI {
+  emitter: EventEmitter
+  start: (options: { specs: Cypress.Spec[], config: FullConfig }) => Promise<Cypress.ResolvedDevServerConfig>
+  updateSpecs: (specs: SpecWithRelativeRoot[], options?: SpecsChangedOptions) => void
+  close: () => void
+}
+
+const API: DevServerAPI = {
+  emitter: baseEmitter,
+
+  start ({ specs, config }: { specs: Cypress.Spec[], config: FullConfig }) {
+    return plugins.execute('dev-server:start', { specs, config })
+  },
+
+  updateSpecs (specs: SpecWithRelativeRoot[], options?: SpecsChangedOptions) {
+    baseEmitter.emit('dev-server:specs:changed', { specs, options })
+  },
+
+  close () {
+    debugFn('close dev-server')
+    baseEmitter.removeAllListeners()
+  },
+}
+
+export default API