Add user traits endpoints and refactor analytics API structure

- Introduced new user traits endpoints: `fetchUserTraitKeys`, `fetchUserTraitValues`, and `fetchUserTraitValueUsers` to enhance user data retrieval capabilities.
- Updated the analytics API structure by moving user-related functions to a dedicated `users` directory for better organization.
- Removed deprecated `getUserInfo`, `getUsers`, and `getUserSessionCount` files, streamlining the codebase.
- Enhanced the `UsersPage` component with a new tabbed interface for better user experience in viewing user data and traits.

Author: goldflag

client/src/api/analytics/endpoints/index.ts

@@ -142,6 +142,19 @@ export type {
   SessionReplaysParams,
 } from "./sessionReplay";
 
+// User Traits endpoints
+export { fetchUserTraitKeys, fetchUserTraitValues, fetchUserTraitValueUsers } from "./userTraits";
+export type {
+  TraitKey,
+  TraitKeysResponse,
+  TraitValue,
+  TraitValuesResponse,
+  TraitValuesParams,
+  TraitValueUser,
+  TraitValueUsersResponse,
+  TraitValueUsersParams,
+} from "./userTraits";
+
 // Export endpoints
 export { exportPdfReport } from "./export";
 export type { ExportPdfParams } from "./export";

client/src/api/analytics/endpoints/userTraits.ts

@@ -0,0 +1,92 @@
+import { authedFetch } from "../../utils";
+
+export interface TraitKey {
+  key: string;
+  userCount: number;
+}
+
+export interface TraitKeysResponse {
+  keys: TraitKey[];
+}
+
+export interface TraitValue {
+  value: string;
+  userCount: number;
+}
+
+export interface TraitValuesResponse {
+  values: TraitValue[];
+  total: number;
+  hasMore: boolean;
+}
+
+export interface TraitValuesParams {
+  key: string;
+  limit?: number;
+  offset?: number;
+}
+
+/**
+ * Fetch all trait keys for a site
+ * GET /api/sites/:siteId/user-traits/keys
+ */
+export async function fetchUserTraitKeys(site: string | number): Promise<TraitKeysResponse> {
+  return authedFetch<TraitKeysResponse>(`/sites/${site}/user-traits/keys`);
+}
+
+/**
+ * Fetch trait values for a given key
+ * GET /api/sites/:siteId/user-traits/values
+ */
+export async function fetchUserTraitValues(
+  site: string | number,
+  params: TraitValuesParams
+): Promise<TraitValuesResponse> {
+  return authedFetch<TraitValuesResponse>(`/sites/${site}/user-traits/values`, {
+    key: params.key,
+    limit: params.limit,
+    offset: params.offset,
+  });
+}
+
+export interface TraitValueUser {
+  user_id: string;
+  identified_user_id: string;
+  traits: Record<string, unknown> | null;
+  country: string;
+  region: string;
+  city: string;
+  browser: string;
+  operating_system: string;
+  device_type: string;
+  sessions: number;
+}
+
+export interface TraitValueUsersResponse {
+  users: TraitValueUser[];
+  total: number;
+  hasMore: boolean;
+}
+
+export interface TraitValueUsersParams {
+  key: string;
+  value: string;
+  limit?: number;
+  offset?: number;
+}
+
+/**
+ * Fetch users that have a specific trait key+value
+ * GET /api/sites/:siteId/user-traits/users
+ */
+export async function fetchUserTraitValueUsers(
+  site: string | number,
+  params: TraitValueUsersParams
+): Promise<TraitValueUsersResponse> {
+  return authedFetch<TraitValueUsersResponse>(`/sites/${site}/user-traits/users`, {
+    key: params.key,
+    value: params.value,
+    limit: params.limit,
+    offset: params.offset,
+  });
+}

client/src/api/analytics/hooks/useGetUserTraits.ts

@@ -0,0 +1,65 @@
+import { useInfiniteQuery, useQuery } from "@tanstack/react-query";
+import { useStore } from "../../../lib/store";
+import {
+  fetchUserTraitKeys,
+  fetchUserTraitValues,
+  fetchUserTraitValueUsers,
+  TraitKeysResponse,
+  TraitValuesResponse,
+  TraitValueUsersResponse,
+} from "../endpoints";
+
+export function useGetUserTraitKeys() {
+  const { site } = useStore();
+
+  return useQuery<TraitKeysResponse>({
+    queryKey: ["user-trait-keys", site],
+    queryFn: () => fetchUserTraitKeys(site),
+    enabled: !!site,
+  });
+}
+
+export function useGetUserTraitValues(key: string | null) {
+  const { site } = useStore();
+  const limit = 1000;
+
+  return useInfiniteQuery<TraitValuesResponse>({
+    queryKey: ["user-trait-values", site, key],
+    queryFn: async ({ pageParam = 0 }) => {
+      return fetchUserTraitValues(site, {
+        key: key!,
+        limit,
+        offset: pageParam as number,
+      });
+    },
+    initialPageParam: 0,
+    getNextPageParam: (lastPage, allPages) => {
+      const totalFetched = allPages.reduce((acc, page) => acc + page.values.length, 0);
+      return lastPage.hasMore ? totalFetched : undefined;
+    },
+    enabled: !!site && !!key,
+  });
+}
+
+export function useGetUserTraitValueUsers(key: string | null, value: string | null) {
+  const { site } = useStore();
+  const limit = 50;
+
+  return useInfiniteQuery<TraitValueUsersResponse>({
+    queryKey: ["user-trait-value-users", site, key, value],
+    queryFn: async ({ pageParam = 0 }) => {
+      return fetchUserTraitValueUsers(site, {
+        key: key!,
+        value: value!,
+        limit,
+        offset: pageParam as number,
+      });
+    },
+    initialPageParam: 0,
+    getNextPageParam: (lastPage, allPages) => {
+      const totalFetched = allPages.reduce((acc, page) => acc + page.users.length, 0);
+      return lastPage.hasMore ? totalFetched : undefined;
+    },
+    enabled: !!site && !!key && value !== null,
+  });
+}