Adding deprecated comments

x-pack/plugins/security_solution/common/endpoint/types/index.ts

@@ -278,6 +278,7 @@ export interface SafeResolverRelatedEvents {
 
 /**
  * Response structure for the events route.
+ * `nextEvent` will be set to null when at the time of querying there were no more results to retrieve from ES.
  */
 export interface ResolverPaginatedEvents {
   events: SafeResolverEvent[];

x-pack/plugins/security_solution/server/endpoint/routes/resolver.ts

@@ -29,6 +29,7 @@ export function registerResolverRoutes(router: IRouter, endpointAppContext: Endp
   // this route will be removed in favor of the one below
   router.post(
     {
+      // @deprecated use `/resolver/events` instead
       path: '/api/endpoint/resolver/{id}/events',
       validate: validateRelatedEvents,
       options: { authRequired: true },

x-pack/plugins/security_solution/server/endpoint/routes/resolver/queries/related_events.test.ts

@@ -3,6 +3,9 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
+/**
+ * @deprecated use the `events.ts` file's query instead
+ */
 import { EventsQuery } from './related_events';
 import { PaginationBuilder } from '../utils/pagination';
 import { legacyEventIndexPattern } from './legacy_event_index_pattern';

x-pack/plugins/security_solution/server/endpoint/routes/resolver/queries/related_events.ts

@@ -3,6 +3,9 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
+/**
+ * @deprecated use the `events.ts` file's query instead
+ */
 import { SearchResponse } from 'elasticsearch';
 import { esKuery } from '../../../../../../../../src/plugins/data/server';
 import { SafeResolverEvent } from '../../../../../common/endpoint/types';

x-pack/plugins/security_solution/server/endpoint/routes/resolver/related_events.ts

@@ -4,6 +4,9 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
+/**
+ * @deprecated use the `resolver/events` route and handler instead
+ */
 import { TypeOf } from '@kbn/config-schema';
 import { RequestHandler, Logger } from 'kibana/server';
 import { eventsIndexPattern, alertsIndexPattern } from '../../../../common/endpoint/constants';

x-pack/plugins/security_solution/server/endpoint/routes/resolver/utils/events_query_handler.ts

@@ -3,7 +3,9 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-
+/**
+ * @deprecated msearch functionality for querying events will be removed shortly
+ */
 import { SearchResponse } from 'elasticsearch';
 import { ILegacyScopedClusterClient } from 'kibana/server';
 import { SafeResolverRelatedEvents, SafeResolverEvent } from '../../../../../common/endpoint/types';