feat: add admin tracking events export

apps/admin-web/src/api/adminApiClient.ts

@@ -6,6 +6,8 @@ import type {
   AdminLoginResponse,
   AdminMeResponse,
   AdminOverviewResponse,
+  AdminTrackingEventListQuery,
+  AdminTrackingEventListResponse,
   AdminUpsertProfileInviteCodeRequest,
   AdminUpsertProfileRedeemCodeRequest,
   AdminUpsertProfileTaskConfigRequest,
@@ -135,6 +137,16 @@ export function debugAdminHttp(token: string, payload: AdminDebugHttpRequest) {
   });
 }
 
+export function listAdminTrackingEvents(
+  token: string,
+  query: AdminTrackingEventListQuery = {},
+) {
+  return request<AdminTrackingEventListResponse>(
+    `/admin/api/tracking/events${buildQueryString(query)}`,
+    {token},
+  );
+}
+
 export function listProfileRedeemCodes(token: string) {
   return request<ProfileRedeemCodeAdminListResponse>(
     '/admin/api/profile/redeem-codes',
@@ -232,6 +244,30 @@ function buildRequestUrl(path: string) {
   return `${ADMIN_API_BASE_URL}${normalizedPath}`;
 }
 
+function buildQueryString(query: AdminTrackingEventListQuery) {
+  const params = new URLSearchParams();
+  appendQueryParam(params, 'eventKey', query.eventKey);
+  appendQueryParam(params, 'userId', query.userId);
+  appendQueryParam(params, 'scopeKind', query.scopeKind);
+  appendQueryParam(params, 'scopeId', query.scopeId);
+  if (typeof query.limit === 'number' && Number.isFinite(query.limit)) {
+    params.set('limit', String(query.limit));
+  }
+  const queryString = params.toString();
+  return queryString ? `?${queryString}` : '';
+}
+
+function appendQueryParam(
+  params: URLSearchParams,
+  key: string,
+  value: string | null | undefined,
+) {
+  const trimmed = value?.trim();
+  if (trimmed) {
+    params.set(key, trimmed);
+  }
+}
+
 function parseJsonResponse(responseText: string): unknown {
   if (!responseText.trim()) {
     return null;