@meetkai/mka1 0.54.45 → 0.54.46

package/src/models/components/analyticsvisitorsearchresponse.ts

@@ -0,0 +1,78 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  AnalyticsVisitor,
+  AnalyticsVisitor$inboundSchema,
+  AnalyticsVisitor$Outbound,
+  AnalyticsVisitor$outboundSchema,
+} from "./analyticsvisitor.js";
+
+export type AnalyticsVisitorSearchResponse = {
+  /**
+   * Matching visitors, most recently active first. Visitors with the same last_seen are ordered by distinct_id, descending.
+   */
+  visitors: Array<AnalyticsVisitor>;
+  /**
+   * Cursor for the next page, or null when there are no more rows. It continues the sequence at the snapshot its first page took.
+   */
+  nextCursor: string | null;
+};
+
+/** @internal */
+export const AnalyticsVisitorSearchResponse$inboundSchema: z.ZodType<
+  AnalyticsVisitorSearchResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  visitors: z.array(AnalyticsVisitor$inboundSchema),
+  next_cursor: z.nullable(z.string()),
+}).transform((v) => {
+  return remap$(v, {
+    "next_cursor": "nextCursor",
+  });
+});
+/** @internal */
+export type AnalyticsVisitorSearchResponse$Outbound = {
+  visitors: Array<AnalyticsVisitor$Outbound>;
+  next_cursor: string | null;
+};
+
+/** @internal */
+export const AnalyticsVisitorSearchResponse$outboundSchema: z.ZodType<
+  AnalyticsVisitorSearchResponse$Outbound,
+  z.ZodTypeDef,
+  AnalyticsVisitorSearchResponse
+> = z.object({
+  visitors: z.array(AnalyticsVisitor$outboundSchema),
+  nextCursor: z.nullable(z.string()),
+}).transform((v) => {
+  return remap$(v, {
+    nextCursor: "next_cursor",
+  });
+});
+
+export function analyticsVisitorSearchResponseToJSON(
+  analyticsVisitorSearchResponse: AnalyticsVisitorSearchResponse,
+): string {
+  return JSON.stringify(
+    AnalyticsVisitorSearchResponse$outboundSchema.parse(
+      analyticsVisitorSearchResponse,
+    ),
+  );
+}
+export function analyticsVisitorSearchResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<AnalyticsVisitorSearchResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AnalyticsVisitorSearchResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AnalyticsVisitorSearchResponse' from JSON`,
+  );
+}

package/src/models/components/index.ts

@@ -33,6 +33,8 @@ export * from "./analyticscapturerequest.js";
 export * from "./analyticscaptureresponse.js";
 export * from "./analyticscreatedcapturekey.js";
 export * from "./analyticsevent.js";
+export * from "./analyticseventsearchrequest.js";
+export * from "./analyticseventsearchresponse.js";
 export * from "./analyticskeycreate.js";
 export * from "./analyticskeylist.js";
 export * from "./analyticsproject.js";
@@ -41,6 +43,9 @@ export * from "./analyticsprojectlist.js";
 export * from "./analyticsprojectupdate.js";
 export * from "./analyticsqueryrequest.js";
 export * from "./analyticsqueryresponse.js";
+export * from "./analyticsvisitor.js";
+export * from "./analyticsvisitorsearchrequest.js";
+export * from "./analyticsvisitorsearchresponse.js";
 export * from "./appendagenttrialsrequest.js";
 export * from "./authorizeintent.js";
 export * from "./autochunkingstrategy.js";

package/src/models/operations/analyticseventssearch.ts

@@ -0,0 +1,72 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as components from "../components/index.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type AnalyticsEventsSearchRequest = {
+  /**
+   * ID of the analytics project.
+   */
+  id: string;
+  analyticsEventSearchRequest: components.AnalyticsEventSearchRequest;
+};
+
+/** @internal */
+export const AnalyticsEventsSearchRequest$inboundSchema: z.ZodType<
+  AnalyticsEventsSearchRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  AnalyticsEventSearchRequest:
+    components.AnalyticsEventSearchRequest$inboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    "AnalyticsEventSearchRequest": "analyticsEventSearchRequest",
+  });
+});
+/** @internal */
+export type AnalyticsEventsSearchRequest$Outbound = {
+  id: string;
+  AnalyticsEventSearchRequest: components.AnalyticsEventSearchRequest$Outbound;
+};
+
+/** @internal */
+export const AnalyticsEventsSearchRequest$outboundSchema: z.ZodType<
+  AnalyticsEventsSearchRequest$Outbound,
+  z.ZodTypeDef,
+  AnalyticsEventsSearchRequest
+> = z.object({
+  id: z.string(),
+  analyticsEventSearchRequest:
+    components.AnalyticsEventSearchRequest$outboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    analyticsEventSearchRequest: "AnalyticsEventSearchRequest",
+  });
+});
+
+export function analyticsEventsSearchRequestToJSON(
+  analyticsEventsSearchRequest: AnalyticsEventsSearchRequest,
+): string {
+  return JSON.stringify(
+    AnalyticsEventsSearchRequest$outboundSchema.parse(
+      analyticsEventsSearchRequest,
+    ),
+  );
+}
+export function analyticsEventsSearchRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<AnalyticsEventsSearchRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AnalyticsEventsSearchRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AnalyticsEventsSearchRequest' from JSON`,
+  );
+}

package/src/models/operations/analyticsvisitorssearch.ts

@@ -0,0 +1,73 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as components from "../components/index.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type AnalyticsVisitorsSearchRequest = {
+  /**
+   * ID of the analytics project.
+   */
+  id: string;
+  analyticsVisitorSearchRequest: components.AnalyticsVisitorSearchRequest;
+};
+
+/** @internal */
+export const AnalyticsVisitorsSearchRequest$inboundSchema: z.ZodType<
+  AnalyticsVisitorsSearchRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  AnalyticsVisitorSearchRequest:
+    components.AnalyticsVisitorSearchRequest$inboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    "AnalyticsVisitorSearchRequest": "analyticsVisitorSearchRequest",
+  });
+});
+/** @internal */
+export type AnalyticsVisitorsSearchRequest$Outbound = {
+  id: string;
+  AnalyticsVisitorSearchRequest:
+    components.AnalyticsVisitorSearchRequest$Outbound;
+};
+
+/** @internal */
+export const AnalyticsVisitorsSearchRequest$outboundSchema: z.ZodType<
+  AnalyticsVisitorsSearchRequest$Outbound,
+  z.ZodTypeDef,
+  AnalyticsVisitorsSearchRequest
+> = z.object({
+  id: z.string(),
+  analyticsVisitorSearchRequest:
+    components.AnalyticsVisitorSearchRequest$outboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    analyticsVisitorSearchRequest: "AnalyticsVisitorSearchRequest",
+  });
+});
+
+export function analyticsVisitorsSearchRequestToJSON(
+  analyticsVisitorsSearchRequest: AnalyticsVisitorsSearchRequest,
+): string {
+  return JSON.stringify(
+    AnalyticsVisitorsSearchRequest$outboundSchema.parse(
+      analyticsVisitorsSearchRequest,
+    ),
+  );
+}
+export function analyticsVisitorsSearchRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<AnalyticsVisitorsSearchRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AnalyticsVisitorsSearchRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AnalyticsVisitorsSearchRequest' from JSON`,
+  );
+}

package/src/models/operations/index.ts

@@ -7,6 +7,7 @@ export * from "./activateagentconnector.js";
 export * from "./addmodelcatalogorgaccess.js";
 export * from "./addteammember.js";
 export * from "./analyticscapture.js";
+export * from "./analyticseventssearch.js";
 export * from "./analyticskeyscreate.js";
 export * from "./analyticskeyslist.js";
 export * from "./analyticskeysrevoke.js";
@@ -15,6 +16,7 @@ export * from "./analyticsprojectsget.js";
 export * from "./analyticsprojectslist.js";
 export * from "./analyticsprojectsupdate.js";
 export * from "./analyticsquery.js";
+export * from "./analyticsvisitorssearch.js";
 export * from "./appendagentevaltrials.js";
 export * from "./batchgetcompletionfeedback.js";
 export * from "./batchgetresponsefeedback.js";

package/src/react-query/analyticsEventsSearch.ts

@@ -0,0 +1,112 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { analyticsEventsSearch } from "../funcs/analyticsEventsSearch.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKError } from "../models/errors/sdkerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+import { useSDKContext } from "./_context.js";
+import { MutationHookOptions } from "./_types.js";
+
+export type AnalyticsEventsSearchMutationVariables = {
+  request: operations.AnalyticsEventsSearchRequest;
+  options?: RequestOptions;
+};
+
+export type AnalyticsEventsSearchMutationData =
+  components.AnalyticsEventSearchResponse;
+
+export type AnalyticsEventsSearchMutationError =
+  | errors.AnalyticsError
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Search events in a time range
+ *
+ * @remarks
+ * List individual events in a time range, newest first, with their properties. Optionally filter by event name, event properties, or one visitor's distinct_id. The range includes from and excludes to, and duplicate event IDs are returned once, so a search over a chart bucket's range with the same filters lists exactly the events that bucket counted. A page holds up to 100 events; pass next_cursor as cursor for the following page until it is null. The first page takes a snapshot from ClickHouse's clock before reading its rows and its cursor carries it, so every page of the sequence, the first included, reads only deliveries received at or before that snapshot and ages events out of retention as of it: no event repeats or is skipped, and events received after the snapshot, including a redelivery that revises a listed event, appear only when paging restarts without a cursor. One window blurs that boundary: ClickHouse stamps a receipt at whole seconds when an insert starts and commits its rows when it finishes, so a delivery stamped in or before the snapshot's second that commits after the first page was read is inside the sequence but missing from the first page; it joins from the next page, where an unlisted event it adds or moves ahead of the cursor is skipped and a listed event that a lower-hash redelivery moves behind the cursor repeats at its revised position. A cursor that does not decode, or one from another list, returns 400. A page whose events exceed the response size limit returns 413; request a smaller limit.
+ */
+export function useAnalyticsEventsSearchMutation(
+  options?: MutationHookOptions<
+    AnalyticsEventsSearchMutationData,
+    AnalyticsEventsSearchMutationError,
+    AnalyticsEventsSearchMutationVariables
+  >,
+): UseMutationResult<
+  AnalyticsEventsSearchMutationData,
+  AnalyticsEventsSearchMutationError,
+  AnalyticsEventsSearchMutationVariables
+> {
+  const client = useSDKContext();
+  return useMutation({
+    ...buildAnalyticsEventsSearchMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyAnalyticsEventsSearch(): MutationKey {
+  return ["@meetkai/mka1", "events", "search"];
+}
+
+export function buildAnalyticsEventsSearchMutation(
+  client$: SDKCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: AnalyticsEventsSearchMutationVariables,
+  ) => Promise<AnalyticsEventsSearchMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyAnalyticsEventsSearch(),
+    mutationFn: function analyticsEventsSearchMutationFn({
+      request,
+      options,
+    }): Promise<AnalyticsEventsSearchMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(analyticsEventsSearch(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/react-query/analyticsVisitorsSearch.ts

@@ -0,0 +1,112 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { analyticsVisitorsSearch } from "../funcs/analyticsVisitorsSearch.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKError } from "../models/errors/sdkerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+import { useSDKContext } from "./_context.js";
+import { MutationHookOptions } from "./_types.js";
+
+export type AnalyticsVisitorsSearchMutationVariables = {
+  request: operations.AnalyticsVisitorsSearchRequest;
+  options?: RequestOptions;
+};
+
+export type AnalyticsVisitorsSearchMutationData =
+  components.AnalyticsVisitorSearchResponse;
+
+export type AnalyticsVisitorsSearchMutationError =
+  | errors.AnalyticsError
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Search visitors in a time range
+ *
+ * @remarks
+ * List visitors with matching events in a time range, most recently active first. Each visitor is one distinct_id with the timestamps of its first and last matching event and its event count over the whole range, so for a range that receives no further events the number of visitors across all pages equals the unique_visitors query for the same range and filters. The range includes from and excludes to, and duplicate event IDs are counted once. A page holds up to 100 visitors; pass next_cursor as cursor for the following page until it is null. The first page takes a snapshot from ClickHouse's clock before reading its rows and its cursor carries it, so every page of the sequence, the first included, reads only deliveries received at or before that snapshot and ages events out of retention as of it: a visitor keeps the position, first_seen, last_seen and event_count the sequence started with, no visitor repeats or is skipped, and activity received after the snapshot appears only when paging restarts without a cursor. One window blurs that boundary: ClickHouse stamps a receipt at whole seconds when an insert starts and commits its rows when it finishes, so a delivery stamped in or before the snapshot's second that commits after the first page was read is inside the sequence but missing from the first page; it joins from the next page, where an unlisted visitor it adds or moves ahead of the cursor is skipped and a listed visitor whose winning delivery a lower-hash redelivery moves behind the cursor repeats with revised totals; a listed visitor's totals otherwise stay as listed. A cursor that does not decode, or one from another list, returns 400.
+ */
+export function useAnalyticsVisitorsSearchMutation(
+  options?: MutationHookOptions<
+    AnalyticsVisitorsSearchMutationData,
+    AnalyticsVisitorsSearchMutationError,
+    AnalyticsVisitorsSearchMutationVariables
+  >,
+): UseMutationResult<
+  AnalyticsVisitorsSearchMutationData,
+  AnalyticsVisitorsSearchMutationError,
+  AnalyticsVisitorsSearchMutationVariables
+> {
+  const client = useSDKContext();
+  return useMutation({
+    ...buildAnalyticsVisitorsSearchMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyAnalyticsVisitorsSearch(): MutationKey {
+  return ["@meetkai/mka1", "visitors", "search"];
+}
+
+export function buildAnalyticsVisitorsSearchMutation(
+  client$: SDKCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: AnalyticsVisitorsSearchMutationVariables,
+  ) => Promise<AnalyticsVisitorsSearchMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyAnalyticsVisitorsSearch(),
+    mutationFn: function analyticsVisitorsSearchMutationFn({
+      request,
+      options,
+    }): Promise<AnalyticsVisitorsSearchMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(analyticsVisitorsSearch(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/react-query/index.ts

@@ -33,6 +33,7 @@ export * from "./agentVersionsGetAgentVersion.js";
 export * from "./agentVersionsListAgentVersions.js";
 export * from "./agentVersionsRollbackAgentVersion.js";
 export * from "./analyticsCapture.js";
+export * from "./analyticsEventsSearch.js";
 export * from "./analyticsKeysCreate.js";
 export * from "./analyticsKeysList.js";
 export * from "./analyticsKeysRevoke.js";
@@ -42,6 +43,7 @@ export * from "./analyticsProjectsGet.js";
 export * from "./analyticsProjectsList.js";
 export * from "./analyticsProjectsUpdate.js";
 export * from "./analyticsQuery.js";
+export * from "./analyticsVisitorsSearch.js";
 export * from "./authApiKeyGetJwtFromKey.js";
 export * from "./authApiKeysCreate.js";
 export * from "./authApiKeysExchangeToken.js";

package/src/sdk/analytics.ts

@@ -8,8 +8,10 @@ import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as components from "../models/components/index.js";
 import * as operations from "../models/operations/index.js";
 import { unwrapAsync } from "../types/fp.js";
+import { Events } from "./events.js";
 import { Keys } from "./keys.js";
 import { Projects } from "./projects.js";
+import { Visitors } from "./visitors.js";
 
 export class Analytics extends ClientSDK {
   private _projects?: Projects;
@@ -22,6 +24,16 @@ export class Analytics extends ClientSDK {
     return (this._keys ??= new Keys(this._options));
   }
 
+  private _events?: Events;
+  get events(): Events {
+    return (this._events ??= new Events(this._options));
+  }
+
+  private _visitors?: Visitors;
+  get visitors(): Visitors {
+    return (this._visitors ??= new Visitors(this._options));
+  }
+
   /**
    * Durably accept a batch of events
    *

package/src/sdk/events.ts

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { analyticsEventsSearch } from "../funcs/analyticsEventsSearch.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Events extends ClientSDK {
+  /**
+   * Search events in a time range
+   *
+   * @remarks
+   * List individual events in a time range, newest first, with their properties. Optionally filter by event name, event properties, or one visitor's distinct_id. The range includes from and excludes to, and duplicate event IDs are returned once, so a search over a chart bucket's range with the same filters lists exactly the events that bucket counted. A page holds up to 100 events; pass next_cursor as cursor for the following page until it is null. The first page takes a snapshot from ClickHouse's clock before reading its rows and its cursor carries it, so every page of the sequence, the first included, reads only deliveries received at or before that snapshot and ages events out of retention as of it: no event repeats or is skipped, and events received after the snapshot, including a redelivery that revises a listed event, appear only when paging restarts without a cursor. One window blurs that boundary: ClickHouse stamps a receipt at whole seconds when an insert starts and commits its rows when it finishes, so a delivery stamped in or before the snapshot's second that commits after the first page was read is inside the sequence but missing from the first page; it joins from the next page, where an unlisted event it adds or moves ahead of the cursor is skipped and a listed event that a lower-hash redelivery moves behind the cursor repeats at its revised position. A cursor that does not decode, or one from another list, returns 400. A page whose events exceed the response size limit returns 413; request a smaller limit.
+   */
+  async search(
+    request: operations.AnalyticsEventsSearchRequest,
+    options?: RequestOptions,
+  ): Promise<components.AnalyticsEventSearchResponse> {
+    return unwrapAsync(analyticsEventsSearch(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/visitors.ts

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { analyticsVisitorsSearch } from "../funcs/analyticsVisitorsSearch.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Visitors extends ClientSDK {
+  /**
+   * Search visitors in a time range
+   *
+   * @remarks
+   * List visitors with matching events in a time range, most recently active first. Each visitor is one distinct_id with the timestamps of its first and last matching event and its event count over the whole range, so for a range that receives no further events the number of visitors across all pages equals the unique_visitors query for the same range and filters. The range includes from and excludes to, and duplicate event IDs are counted once. A page holds up to 100 visitors; pass next_cursor as cursor for the following page until it is null. The first page takes a snapshot from ClickHouse's clock before reading its rows and its cursor carries it, so every page of the sequence, the first included, reads only deliveries received at or before that snapshot and ages events out of retention as of it: a visitor keeps the position, first_seen, last_seen and event_count the sequence started with, no visitor repeats or is skipped, and activity received after the snapshot appears only when paging restarts without a cursor. One window blurs that boundary: ClickHouse stamps a receipt at whole seconds when an insert starts and commits its rows when it finishes, so a delivery stamped in or before the snapshot's second that commits after the first page was read is inside the sequence but missing from the first page; it joins from the next page, where an unlisted visitor it adds or moves ahead of the cursor is skipped and a listed visitor whose winning delivery a lower-hash redelivery moves behind the cursor repeats with revised totals; a listed visitor's totals otherwise stay as listed. A cursor that does not decode, or one from another list, returns 400.
+   */
+  async search(
+    request: operations.AnalyticsVisitorsSearchRequest,
+    options?: RequestOptions,
+  ): Promise<components.AnalyticsVisitorSearchResponse> {
+    return unwrapAsync(analyticsVisitorsSearch(
+      this,
+      request,
+      options,
+    ));
+  }
+}