@athos-sdk/api-types 2.0.1 → 2.1.0

package/dist/index.d.mts

@@ -28,6 +28,25 @@ declare enum ExpertRole {
 interface SuccessResponse {
     success: true;
 }
+/** Query params for paginated list endpoints (page, limit) */
+interface PaginationQuery {
+    page?: number;
+    limit?: number;
+}
+/** Meta object in paginated list responses */
+interface PaginationMeta {
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrev: boolean;
+}
+/** Response shape for paginated list endpoints */
+interface PaginatedResponse<T> {
+    data: T[];
+    meta: PaginationMeta;
+}
 /** Media record (e.g. profile image, gym image) */
 interface Media {
     id: string;
@@ -172,6 +191,10 @@ interface ChallengeOccurrence {
     endDate: string;
     imageId: string | null;
 }
+/** Challenge with occurrences (e.g. GET /challenges paginated list) */
+interface ChallengeWithOccurrences extends Challenge {
+    occurrences: ChallengeOccurrence[];
+}
 /** Occurrence with challenge and participations (e.g. GET /challenges/me/active) */
 interface ChallengeOccurrenceWithDetails extends ChallengeOccurrence {
     challenge: Challenge;
@@ -265,28 +288,6 @@ interface CheckIn {
     checkedInAt: string;
 }
 
-/** POST /bookings (member) */
-interface CreateBookingDto {
-    expertId: string;
-    startAt: string;
-    endAt: string;
-}
-/** POST /bookings/status (expert) */
-interface UpdateBookingStatusDto {
-    bookingId: string;
-    status: BookingStatus;
-}
-/** Booking entity */
-interface Booking {
-    id: string;
-    memberId: string;
-    expertId: string;
-    startAt: string;
-    endAt: string;
-    status: BookingStatus;
-    createdAt: string;
-}
-
 /** Single availability slot (day + time range) */
 interface AvailabilitySlotDto {
     dayOfWeek: number;
@@ -338,6 +339,40 @@ interface ExpertAvailabilityResponse {
     exceptions: ExpertAvailabilityException[];
 }
 
+/** POST /bookings (member) */
+interface CreateBookingDto {
+    expertId: string;
+    startAt: string;
+    endAt: string;
+}
+/** POST /bookings/status (expert) */
+interface UpdateBookingStatusDto {
+    bookingId: string;
+    status: BookingStatus;
+}
+/** Booking entity */
+interface Booking {
+    id: string;
+    memberId: string;
+    expertId: string;
+    startAt: string;
+    endAt: string;
+    status: BookingStatus;
+    createdAt: string;
+}
+/** Booking with expert (e.g. GET /bookings/me/member) */
+interface BookingWithExpert extends Booking {
+    expert: Expert & {
+        user: User;
+    };
+}
+/** Booking with member (e.g. GET /bookings/me/expert) */
+interface BookingWithMember extends Booking {
+    member: Member & {
+        user: User;
+    };
+}
+
 /** PATCH /admin/gym */
 interface UpdateGymDto {
     name?: string;
@@ -394,6 +429,11 @@ interface StaffWithUser extends Staff {
 interface ExpertWithUser extends Expert {
     user: User;
 }
+/** Booking with member and expert (e.g. GET /admin/bookings) */
+interface BookingWithMemberAndExpert extends Booking {
+    member: MemberWithUser;
+    expert: ExpertWithUser;
+}
 
 /** Notification entity */
 interface Notification {
@@ -551,12 +591,13 @@ declare const apiRoutes: {
         readonly create: RouteDef<"POST", CreateCheckInDto, CheckIn>;
     };
     readonly leaderboards: {
-        readonly list: RouteDef<"GET", void, LeaderboardWithEntries[]>;
+        readonly list: RouteDef<"GET", void, PaginatedResponse<LeaderboardWithEntries>>;
         readonly create: RouteDef<"POST", CreateLeaderboardDto, Leaderboard>;
         readonly submitEntry: RouteDef<"POST", SubmitEntryDto, unknown>;
         readonly reviewEntry: RouteDef<"POST", ReviewEntryDto, SuccessResponse>;
     };
     readonly challenges: {
+        readonly list: RouteDef<"GET", void, PaginatedResponse<ChallengeWithOccurrences>>;
         readonly create: RouteDef<"POST", CreateChallengeDto, Challenge>;
         readonly createOccurrence: RouteDef<"POST", CreateOccurrenceDto, ChallengeOccurrence>;
         readonly meActive: RouteDef<"GET", void, ChallengeOccurrenceWithDetails[]>;
@@ -566,15 +607,15 @@ declare const apiRoutes: {
     readonly bookings: {
         readonly create: RouteDef<"POST", CreateBookingDto, Booking>;
         readonly updateStatus: RouteDef<"POST", UpdateBookingStatusDto, Booking>;
-        readonly meMember: RouteDef<"GET", void, Booking[]>;
-        readonly meExpert: RouteDef<"GET", void, Booking[]>;
+        readonly meMember: RouteDef<"GET", void, PaginatedResponse<BookingWithExpert>>;
+        readonly meExpert: RouteDef<"GET", void, PaginatedResponse<BookingWithMember>>;
     };
     readonly rewards: {
-        readonly list: RouteDef<"GET", void, Reward[]>;
+        readonly list: RouteDef<"GET", void, PaginatedResponse<Reward>>;
         readonly me: RouteDef<"GET", void, MemberReward[]>;
     };
     readonly experts: {
-        readonly list: RouteDef<"GET", void, Expert[]>;
+        readonly list: RouteDef<"GET", void, PaginatedResponse<Expert>>;
         readonly me: RouteDef<"GET", void, Expert>;
         readonly availability: (id: string) => RouteDef<"GET", void, ExpertAvailabilityResponse>;
         readonly meAvailability: RouteDef<"POST", SetAvailabilityDto, ExpertAvailability[]>;
@@ -595,18 +636,19 @@ declare const apiRoutes: {
         readonly summary: RouteDef<"GET", void, AdminSummaryResponse>;
         readonly gym: RouteDef<"GET", void, Gym>;
         readonly updateGym: RouteDef<"PATCH", UpdateGymDto, Gym>;
-        readonly members: RouteDef<"GET", void, MemberWithUser[]>;
+        readonly members: RouteDef<"GET", void, PaginatedResponse<MemberWithUser>>;
         readonly createMember: RouteDef<"POST", AddMemberDto, MemberWithUser>;
-        readonly rewards: RouteDef<"GET", void, Reward[]>;
+        readonly rewards: RouteDef<"GET", void, PaginatedResponse<Reward>>;
         readonly createReward: RouteDef<"POST", CreateRewardDto, Reward>;
         readonly updateReward: (id: string) => RouteDef<"PATCH", UpdateRewardDto, Reward>;
         readonly deleteReward: (id: string) => RouteDef<"DELETE", void, SuccessResponse>;
-        readonly staff: RouteDef<"GET", void, StaffWithUser[]>;
+        readonly staff: RouteDef<"GET", void, PaginatedResponse<StaffWithUser>>;
         readonly createStaff: RouteDef<"POST", AddStaffDto, StaffWithUser>;
         readonly deleteStaff: (userId: string) => RouteDef<"DELETE", void, SuccessResponse>;
         readonly disableStaff: (userId: string) => RouteDef<"PATCH", void, SuccessResponse>;
         readonly enableStaff: (userId: string) => RouteDef<"PATCH", void, SuccessResponse>;
-        readonly experts: RouteDef<"GET", void, ExpertWithUser[]>;
+        readonly experts: RouteDef<"GET", void, PaginatedResponse<ExpertWithUser>>;
+        readonly bookings: RouteDef<"GET", void, PaginatedResponse<BookingWithMemberAndExpert>>;
         readonly createExpert: RouteDef<"POST", AddExpertDto, ExpertWithUser>;
         readonly deleteExpert: (userId: string) => RouteDef<"DELETE", void, SuccessResponse>;
         readonly disableExpert: (userId: string) => RouteDef<"PATCH", void, SuccessResponse>;
@@ -670,4 +712,4 @@ declare function createApi(client: AthosHttpClient, baseUrl?: string): {
     request<R extends RouteDef<HttpMethod, unknown, unknown>>(route: R, body?: RequestBody<R>): Promise<ResponseBody<R>>;
 };
 
-export { type Activity, type AddExpertDto, type AddMemberDto, type AddStaffDto, type AdminSummaryResponse, type AthosHttpClient, type AuthResponse, type AvailabilitySlotDto, type Booking, BookingStatus, type Challenge, type ChallengeOccurrence, type ChallengeOccurrenceWithDetails, type ChallengeParticipation, ChallengeVerificationType, type CheckIn, type CompleteChallengeDto, type CreateBookingDto, type CreateChallengeDto, type CreateCheckInDto, type CreateLeaderboardDto, type CreateOccurrenceDto, type CreateRewardDto, type Expert, type ExpertAvailability, type ExpertAvailabilityException, type ExpertAvailabilityResponse, ExpertRole, type ExpertWithUser, type GetMeResponse, type Gym, type HttpMethod, type JoinChallengeDto, type JoinGymDto, type Leaderboard, type LeaderboardEntry, LeaderboardEntryStatus, type LeaderboardWithEntries, type Level, type LoginDto, type Media, type Member, type MemberReward, type MemberStatsResponse, type MemberWithGym, type MemberWithUser, type Notification, ROUTES, type RegisterDto, type RegisterResponse, type RequestBody, type ResponseBody, type ReviewEntryDto, type Reward, type RouteDef, type RouteMethod, type RoutePath, type Routes, type SetAvailabilityDto, type SetAvailabilityExceptionDto, type Staff, type StaffWithUser, type SubmitEntryDto, type SuccessResponse, type UpdateBookingStatusDto, type UpdateGymDto, type UpdateMemberProfileDto, type UpdateRewardDto, type User, type UserWithRoles, apiRoutes, createApi, request };
+export { type Activity, type AddExpertDto, type AddMemberDto, type AddStaffDto, type AdminSummaryResponse, type AthosHttpClient, type AuthResponse, type AvailabilitySlotDto, type Booking, BookingStatus, type BookingWithExpert, type BookingWithMember, type BookingWithMemberAndExpert, type Challenge, type ChallengeOccurrence, type ChallengeOccurrenceWithDetails, type ChallengeParticipation, ChallengeVerificationType, type ChallengeWithOccurrences, type CheckIn, type CompleteChallengeDto, type CreateBookingDto, type CreateChallengeDto, type CreateCheckInDto, type CreateLeaderboardDto, type CreateOccurrenceDto, type CreateRewardDto, type Expert, type ExpertAvailability, type ExpertAvailabilityException, type ExpertAvailabilityResponse, ExpertRole, type ExpertWithUser, type GetMeResponse, type Gym, type HttpMethod, type JoinChallengeDto, type JoinGymDto, type Leaderboard, type LeaderboardEntry, LeaderboardEntryStatus, type LeaderboardWithEntries, type Level, type LoginDto, type Media, type Member, type MemberReward, type MemberStatsResponse, type MemberWithGym, type MemberWithUser, type Notification, type PaginatedResponse, type PaginationMeta, type PaginationQuery, ROUTES, type RegisterDto, type RegisterResponse, type RequestBody, type ResponseBody, type ReviewEntryDto, type Reward, type RouteDef, type RouteMethod, type RoutePath, type Routes, type SetAvailabilityDto, type SetAvailabilityExceptionDto, type Staff, type StaffWithUser, type SubmitEntryDto, type SuccessResponse, type UpdateBookingStatusDto, type UpdateGymDto, type UpdateMemberProfileDto, type UpdateRewardDto, type User, type UserWithRoles, apiRoutes, createApi, request };

package/dist/index.d.ts

@@ -28,6 +28,25 @@ declare enum ExpertRole {
 interface SuccessResponse {
     success: true;
 }
+/** Query params for paginated list endpoints (page, limit) */
+interface PaginationQuery {
+    page?: number;
+    limit?: number;
+}
+/** Meta object in paginated list responses */
+interface PaginationMeta {
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrev: boolean;
+}
+/** Response shape for paginated list endpoints */
+interface PaginatedResponse<T> {
+    data: T[];
+    meta: PaginationMeta;
+}
 /** Media record (e.g. profile image, gym image) */
 interface Media {
     id: string;
@@ -172,6 +191,10 @@ interface ChallengeOccurrence {
     endDate: string;
     imageId: string | null;
 }
+/** Challenge with occurrences (e.g. GET /challenges paginated list) */
+interface ChallengeWithOccurrences extends Challenge {
+    occurrences: ChallengeOccurrence[];
+}
 /** Occurrence with challenge and participations (e.g. GET /challenges/me/active) */
 interface ChallengeOccurrenceWithDetails extends ChallengeOccurrence {
     challenge: Challenge;
@@ -265,28 +288,6 @@ interface CheckIn {
     checkedInAt: string;
 }
 
-/** POST /bookings (member) */
-interface CreateBookingDto {
-    expertId: string;
-    startAt: string;
-    endAt: string;
-}
-/** POST /bookings/status (expert) */
-interface UpdateBookingStatusDto {
-    bookingId: string;
-    status: BookingStatus;
-}
-/** Booking entity */
-interface Booking {
-    id: string;
-    memberId: string;
-    expertId: string;
-    startAt: string;
-    endAt: string;
-    status: BookingStatus;
-    createdAt: string;
-}
-
 /** Single availability slot (day + time range) */
 interface AvailabilitySlotDto {
     dayOfWeek: number;
@@ -338,6 +339,40 @@ interface ExpertAvailabilityResponse {
     exceptions: ExpertAvailabilityException[];
 }
 
+/** POST /bookings (member) */
+interface CreateBookingDto {
+    expertId: string;
+    startAt: string;
+    endAt: string;
+}
+/** POST /bookings/status (expert) */
+interface UpdateBookingStatusDto {
+    bookingId: string;
+    status: BookingStatus;
+}
+/** Booking entity */
+interface Booking {
+    id: string;
+    memberId: string;
+    expertId: string;
+    startAt: string;
+    endAt: string;
+    status: BookingStatus;
+    createdAt: string;
+}
+/** Booking with expert (e.g. GET /bookings/me/member) */
+interface BookingWithExpert extends Booking {
+    expert: Expert & {
+        user: User;
+    };
+}
+/** Booking with member (e.g. GET /bookings/me/expert) */
+interface BookingWithMember extends Booking {
+    member: Member & {
+        user: User;
+    };
+}
+
 /** PATCH /admin/gym */
 interface UpdateGymDto {
     name?: string;
@@ -394,6 +429,11 @@ interface StaffWithUser extends Staff {
 interface ExpertWithUser extends Expert {
     user: User;
 }
+/** Booking with member and expert (e.g. GET /admin/bookings) */
+interface BookingWithMemberAndExpert extends Booking {
+    member: MemberWithUser;
+    expert: ExpertWithUser;
+}
 
 /** Notification entity */
 interface Notification {
@@ -551,12 +591,13 @@ declare const apiRoutes: {
         readonly create: RouteDef<"POST", CreateCheckInDto, CheckIn>;
     };
     readonly leaderboards: {
-        readonly list: RouteDef<"GET", void, LeaderboardWithEntries[]>;
+        readonly list: RouteDef<"GET", void, PaginatedResponse<LeaderboardWithEntries>>;
         readonly create: RouteDef<"POST", CreateLeaderboardDto, Leaderboard>;
         readonly submitEntry: RouteDef<"POST", SubmitEntryDto, unknown>;
         readonly reviewEntry: RouteDef<"POST", ReviewEntryDto, SuccessResponse>;
     };
     readonly challenges: {
+        readonly list: RouteDef<"GET", void, PaginatedResponse<ChallengeWithOccurrences>>;
         readonly create: RouteDef<"POST", CreateChallengeDto, Challenge>;
         readonly createOccurrence: RouteDef<"POST", CreateOccurrenceDto, ChallengeOccurrence>;
         readonly meActive: RouteDef<"GET", void, ChallengeOccurrenceWithDetails[]>;
@@ -566,15 +607,15 @@ declare const apiRoutes: {
     readonly bookings: {
         readonly create: RouteDef<"POST", CreateBookingDto, Booking>;
         readonly updateStatus: RouteDef<"POST", UpdateBookingStatusDto, Booking>;
-        readonly meMember: RouteDef<"GET", void, Booking[]>;
-        readonly meExpert: RouteDef<"GET", void, Booking[]>;
+        readonly meMember: RouteDef<"GET", void, PaginatedResponse<BookingWithExpert>>;
+        readonly meExpert: RouteDef<"GET", void, PaginatedResponse<BookingWithMember>>;
     };
     readonly rewards: {
-        readonly list: RouteDef<"GET", void, Reward[]>;
+        readonly list: RouteDef<"GET", void, PaginatedResponse<Reward>>;
         readonly me: RouteDef<"GET", void, MemberReward[]>;
     };
     readonly experts: {
-        readonly list: RouteDef<"GET", void, Expert[]>;
+        readonly list: RouteDef<"GET", void, PaginatedResponse<Expert>>;
         readonly me: RouteDef<"GET", void, Expert>;
         readonly availability: (id: string) => RouteDef<"GET", void, ExpertAvailabilityResponse>;
         readonly meAvailability: RouteDef<"POST", SetAvailabilityDto, ExpertAvailability[]>;
@@ -595,18 +636,19 @@ declare const apiRoutes: {
         readonly summary: RouteDef<"GET", void, AdminSummaryResponse>;
         readonly gym: RouteDef<"GET", void, Gym>;
         readonly updateGym: RouteDef<"PATCH", UpdateGymDto, Gym>;
-        readonly members: RouteDef<"GET", void, MemberWithUser[]>;
+        readonly members: RouteDef<"GET", void, PaginatedResponse<MemberWithUser>>;
         readonly createMember: RouteDef<"POST", AddMemberDto, MemberWithUser>;
-        readonly rewards: RouteDef<"GET", void, Reward[]>;
+        readonly rewards: RouteDef<"GET", void, PaginatedResponse<Reward>>;
         readonly createReward: RouteDef<"POST", CreateRewardDto, Reward>;
         readonly updateReward: (id: string) => RouteDef<"PATCH", UpdateRewardDto, Reward>;
         readonly deleteReward: (id: string) => RouteDef<"DELETE", void, SuccessResponse>;
-        readonly staff: RouteDef<"GET", void, StaffWithUser[]>;
+        readonly staff: RouteDef<"GET", void, PaginatedResponse<StaffWithUser>>;
         readonly createStaff: RouteDef<"POST", AddStaffDto, StaffWithUser>;
         readonly deleteStaff: (userId: string) => RouteDef<"DELETE", void, SuccessResponse>;
         readonly disableStaff: (userId: string) => RouteDef<"PATCH", void, SuccessResponse>;
         readonly enableStaff: (userId: string) => RouteDef<"PATCH", void, SuccessResponse>;
-        readonly experts: RouteDef<"GET", void, ExpertWithUser[]>;
+        readonly experts: RouteDef<"GET", void, PaginatedResponse<ExpertWithUser>>;
+        readonly bookings: RouteDef<"GET", void, PaginatedResponse<BookingWithMemberAndExpert>>;
         readonly createExpert: RouteDef<"POST", AddExpertDto, ExpertWithUser>;
         readonly deleteExpert: (userId: string) => RouteDef<"DELETE", void, SuccessResponse>;
         readonly disableExpert: (userId: string) => RouteDef<"PATCH", void, SuccessResponse>;
@@ -670,4 +712,4 @@ declare function createApi(client: AthosHttpClient, baseUrl?: string): {
     request<R extends RouteDef<HttpMethod, unknown, unknown>>(route: R, body?: RequestBody<R>): Promise<ResponseBody<R>>;
 };
 
-export { type Activity, type AddExpertDto, type AddMemberDto, type AddStaffDto, type AdminSummaryResponse, type AthosHttpClient, type AuthResponse, type AvailabilitySlotDto, type Booking, BookingStatus, type Challenge, type ChallengeOccurrence, type ChallengeOccurrenceWithDetails, type ChallengeParticipation, ChallengeVerificationType, type CheckIn, type CompleteChallengeDto, type CreateBookingDto, type CreateChallengeDto, type CreateCheckInDto, type CreateLeaderboardDto, type CreateOccurrenceDto, type CreateRewardDto, type Expert, type ExpertAvailability, type ExpertAvailabilityException, type ExpertAvailabilityResponse, ExpertRole, type ExpertWithUser, type GetMeResponse, type Gym, type HttpMethod, type JoinChallengeDto, type JoinGymDto, type Leaderboard, type LeaderboardEntry, LeaderboardEntryStatus, type LeaderboardWithEntries, type Level, type LoginDto, type Media, type Member, type MemberReward, type MemberStatsResponse, type MemberWithGym, type MemberWithUser, type Notification, ROUTES, type RegisterDto, type RegisterResponse, type RequestBody, type ResponseBody, type ReviewEntryDto, type Reward, type RouteDef, type RouteMethod, type RoutePath, type Routes, type SetAvailabilityDto, type SetAvailabilityExceptionDto, type Staff, type StaffWithUser, type SubmitEntryDto, type SuccessResponse, type UpdateBookingStatusDto, type UpdateGymDto, type UpdateMemberProfileDto, type UpdateRewardDto, type User, type UserWithRoles, apiRoutes, createApi, request };
+export { type Activity, type AddExpertDto, type AddMemberDto, type AddStaffDto, type AdminSummaryResponse, type AthosHttpClient, type AuthResponse, type AvailabilitySlotDto, type Booking, BookingStatus, type BookingWithExpert, type BookingWithMember, type BookingWithMemberAndExpert, type Challenge, type ChallengeOccurrence, type ChallengeOccurrenceWithDetails, type ChallengeParticipation, ChallengeVerificationType, type ChallengeWithOccurrences, type CheckIn, type CompleteChallengeDto, type CreateBookingDto, type CreateChallengeDto, type CreateCheckInDto, type CreateLeaderboardDto, type CreateOccurrenceDto, type CreateRewardDto, type Expert, type ExpertAvailability, type ExpertAvailabilityException, type ExpertAvailabilityResponse, ExpertRole, type ExpertWithUser, type GetMeResponse, type Gym, type HttpMethod, type JoinChallengeDto, type JoinGymDto, type Leaderboard, type LeaderboardEntry, LeaderboardEntryStatus, type LeaderboardWithEntries, type Level, type LoginDto, type Media, type Member, type MemberReward, type MemberStatsResponse, type MemberWithGym, type MemberWithUser, type Notification, type PaginatedResponse, type PaginationMeta, type PaginationQuery, ROUTES, type RegisterDto, type RegisterResponse, type RequestBody, type ResponseBody, type ReviewEntryDto, type Reward, type RouteDef, type RouteMethod, type RoutePath, type Routes, type SetAvailabilityDto, type SetAvailabilityExceptionDto, type Staff, type StaffWithUser, type SubmitEntryDto, type SuccessResponse, type UpdateBookingStatusDto, type UpdateGymDto, type UpdateMemberProfileDto, type UpdateRewardDto, type User, type UserWithRoles, apiRoutes, createApi, request };

package/dist/index.js

@@ -210,6 +210,10 @@ var leaderboards = {
   })
 };
 var challenges = {
+  list: defineRoute({
+    method: "GET",
+    path: "/challenges"
+  }),
   create: defineRoute({
     method: "POST",
     path: "/challenges"
@@ -368,6 +372,10 @@ var admin = {
     method: "GET",
     path: "/admin/experts"
   }),
+  bookings: defineRoute({
+    method: "GET",
+    path: "/admin/bookings"
+  }),
   createExpert: defineRoute({
     method: "POST",
     path: "/admin/experts"

package/dist/index.mjs

@@ -177,6 +177,10 @@ var leaderboards = {
   })
 };
 var challenges = {
+  list: defineRoute({
+    method: "GET",
+    path: "/challenges"
+  }),
   create: defineRoute({
     method: "POST",
     path: "/challenges"
@@ -335,6 +339,10 @@ var admin = {
     method: "GET",
     path: "/admin/experts"
   }),
+  bookings: defineRoute({
+    method: "GET",
+    path: "/admin/bookings"
+  }),
   createExpert: defineRoute({
     method: "POST",
     path: "/admin/experts"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@athos-sdk/api-types",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description": "Shared API request and response types for Athos backend, admin dashboard, and mobile app",
   "license": "MIT",
   "main": "dist/index.js",