academe-kit 0.2.0 → 0.2.3

package/dist/types/services/InstitutionService.d.ts

@@ -461,6 +461,65 @@ export declare function createInstitutionService(apiClient: AcademeApiClient): {
             };
         };
     }, `${string}/${string}`>>;
+    getUsers(institutionId: string, options?: {
+        classroomId?: string;
+        isStudent?: boolean;
+        isActive?: boolean;
+        hasCertificates?: boolean;
+        hasGuardian?: boolean;
+        search?: string;
+        page?: number;
+        limit?: number;
+    }): Promise<import("openapi-fetch").FetchResponse<{
+        parameters: {
+            query?: {
+                classroomId?: string;
+                isStudent?: boolean;
+                isActive?: boolean;
+                hasCertificates?: boolean;
+                hasGuardian?: boolean;
+                search?: string;
+                page?: number;
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                institutionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InstitutionUserListResponse"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            500: components["responses"]["ServerError"];
+        };
+    }, {
+        params: {
+            path: {
+                institutionId: string;
+            };
+            query: {
+                classroomId?: string;
+                isStudent?: boolean;
+                isActive?: boolean;
+                hasCertificates?: boolean;
+                hasGuardian?: boolean;
+                search?: string;
+                page?: number;
+                limit?: number;
+            } | undefined;
+        };
+    }, `${string}/${string}`>>;
     getRegistrations(institutionId: string): Promise<import("openapi-fetch").FetchResponse<{
         parameters: {
             query?: never;

package/dist/types/services/ShiftService.d.ts

@@ -124,7 +124,7 @@ export declare function createShiftService(apiClient: AcademeApiClient): {
         };
     }, {
         body: {
-            name: "morning" | "afternoon" | "night";
+            name: "manh\u00E3" | "tarde" | "noite";
         };
     }, `${string}/${string}`>>;
     /**
@@ -169,7 +169,7 @@ export declare function createShiftService(apiClient: AcademeApiClient): {
             };
         };
         body: {
-            name?: "morning" | "afternoon" | "night";
+            name?: "manh\u00E3" | "tarde" | "noite";
         };
     }, `${string}/${string}`>>;
     /**

package/dist/types/types/academe-api.d.ts

@@ -2942,6 +2942,105 @@ export interface paths {
         };
         trace?: never;
     };
+    "/institutions/{institutionId}/groups/users": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get all users of all groups in an institution
+         * @description Retrieve all users from all groups associated with a specific institution.
+         *     Returns a map where keys are group IDs and values are arrays of users in each group.
+         *     This is more efficient than calling /groups/{id}/users multiple times.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Institution ID */
+                    institutionId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Users grouped by group ID */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "status": "success",
+                         *       "data": {
+                         *         "group-uuid-1": [
+                         *           {
+                         *             "id": "user-uuid-1",
+                         *             "firstName": "John",
+                         *             "lastName": "Doe",
+                         *             "email": "john@example.com",
+                         *             "assignedAt": "2024-01-15T10:30:00Z"
+                         *           },
+                         *           {
+                         *             "id": "user-uuid-2",
+                         *             "firstName": "Jane",
+                         *             "lastName": "Smith",
+                         *             "email": "jane@example.com",
+                         *             "assignedAt": "2024-01-16T14:20:00Z"
+                         *           }
+                         *         ],
+                         *         "group-uuid-2": [
+                         *           {
+                         *             "id": "user-uuid-3",
+                         *             "firstName": "Bob",
+                         *             "lastName": "Wilson",
+                         *             "email": "bob@example.com",
+                         *             "assignedAt": "2024-01-17T09:15:00Z"
+                         *           }
+                         *         ]
+                         *       }
+                         *     }
+                         */
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            /** @description Map of group IDs to arrays of users */
+                            data?: {
+                                [key: string]: {
+                                    /** Format: uuid */
+                                    id?: string;
+                                    firstName?: string;
+                                    lastName?: string;
+                                    email?: string;
+                                    document?: string;
+                                    phone?: string;
+                                    isActive?: boolean;
+                                    /** Format: date-time */
+                                    assignedAt?: string;
+                                    /** Format: uuid */
+                                    assignedBy?: string;
+                                }[];
+                            };
+                        };
+                    };
+                };
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/institutions/{institutionId}/registrations": {
         parameters: {
             query?: never;
@@ -3476,6 +3575,69 @@ export interface paths {
         };
         trace?: never;
     };
+    "/institutions/{institutionId}/users": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List all users from an institution
+         * @description Retrieve a paginated list of all users registered in an institution with advanced filtering options
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Filter by classroom (institution_classroom_id) */
+                    classroomId?: string;
+                    /** @description Filter by student status (true = students only, false = non-students only) */
+                    isStudent?: boolean;
+                    /** @description Filter by user active status */
+                    isActive?: boolean;
+                    /** @description Filter users with certificates (true) or without (false) */
+                    hasCertificates?: boolean;
+                    /** @description Filter users with guardian (true) or without (false) */
+                    hasGuardian?: boolean;
+                    /** @description Search by email, first name, last name, or full name (case-insensitive) */
+                    search?: string;
+                    /** @description Page number */
+                    page?: number;
+                    /** @description Items per page */
+                    limit?: number;
+                };
+                header?: never;
+                path: {
+                    /** @description Institution ID */
+                    institutionId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description List of users from the institution */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["InstitutionUserListResponse"];
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/organizations": {
         parameters: {
             query?: never;
@@ -4882,7 +5044,7 @@ export interface paths {
         };
         /**
          * List all shifts
-         * @description Retrieve a list of all institution shifts (morning, afternoon, night)
+         * @description Retrieve a list of all institution shifts (manhã, tarde, noite)
          */
         get: {
             parameters: {
@@ -5859,6 +6021,115 @@ export interface components {
             updatedAt?: string;
             guardian?: components["schemas"]["Guardian"];
         };
+        /** @description User with institution registration details (returned by GET /institutions/{institutionId}/users) */
+        InstitutionUser: {
+            /**
+             * Format: uuid
+             * @description Keycloak User ID
+             */
+            id?: string;
+            /** @example John */
+            firstName?: string;
+            /** @example Doe */
+            lastName?: string;
+            /**
+             * Format: email
+             * @example john.doe@example.com
+             */
+            email?: string;
+            /** @example +5511999999999 */
+            phone?: string | null;
+            /** @example 12345678901 */
+            document?: string | null;
+            /** @enum {string|null} */
+            gender?: "male" | "female" | "other" | null;
+            /**
+             * @description Indicates if the user is active
+             * @example true
+             */
+            isActive?: boolean;
+            /** Format: date-time */
+            birthdate?: string | null;
+            /** Format: date-time */
+            createdAt?: string;
+            /** Format: date-time */
+            updatedAt?: string;
+            /**
+             * @description Number of certificates the user has
+             * @example 5
+             */
+            certificatesCount?: number;
+            /** @description User's guardian associations */
+            userGuardians?: {
+                /** Format: uuid */
+                id?: string;
+                guardian?: {
+                    /** Format: uuid */
+                    id?: string;
+                    /** @example Maria Silva */
+                    name?: string;
+                    /**
+                     * Format: email
+                     * @example maria@example.com
+                     */
+                    email?: string;
+                    /** @example +5511999999999 */
+                    phone?: string | null;
+                };
+            }[];
+            /** @description User's registration info in the institution */
+            institutionRegistration?: {
+                /** Format: uuid */
+                id?: string;
+                /**
+                 * @description Indicates if the user is registered as a student
+                 * @example true
+                 */
+                isStudent?: boolean;
+                /**
+                 * @description Indicates if the registration is active
+                 * @example true
+                 */
+                isActive?: boolean;
+                /** @description Classroom assignment details */
+                institutionClassroom?: {
+                    /** Format: uuid */
+                    id?: string;
+                    classroom?: {
+                        /** Format: uuid */
+                        id?: string;
+                        /** @example 9º Ano A */
+                        name?: string;
+                        /** @description Grade level information */
+                        serie?: {
+                            /** Format: uuid */
+                            id?: string;
+                            /**
+                             * @description Grade level value (1-12)
+                             * @example 9
+                             */
+                            value?: number;
+                        } | null;
+                        /** @description Shift information (manhã, tarde, noite) */
+                        shift?: {
+                            /** Format: uuid */
+                            id?: string;
+                            /**
+                             * @example manhã
+                             * @enum {string}
+                             */
+                            name?: "manhã" | "tarde" | "noite";
+                        } | null;
+                    } | null;
+                } | null;
+            };
+        };
+        InstitutionUserListResponse: {
+            /** @example success */
+            status?: string;
+            data?: components["schemas"]["InstitutionUser"][];
+            meta?: components["schemas"]["PaginationMeta"];
+        };
         InstitutionRegistration: {
             /** Format: uuid */
             id?: string;
@@ -6155,7 +6426,7 @@ export interface components {
             createdAt?: string;
             /** Format: date-time */
             updatedAt?: string;
-            /** @description Shift information (morning, afternoon, night) */
+            /** @description Shift information (manhã, tarde, noite) */
             shift?: components["schemas"]["Shift"];
             /** @description Serie/grade level information */
             serie?: components["schemas"]["Serie"];
@@ -6670,17 +6941,17 @@ export interface components {
         };
         CreateShiftDto: {
             /**
-             * @example morning
+             * @example manhã
              * @enum {string}
              */
-            name: "morning" | "afternoon" | "night";
+            name: "manhã" | "tarde" | "noite";
         };
         UpdateShiftDto: {
             /**
-             * @example morning
+             * @example manhã
              * @enum {string}
              */
-            name?: "morning" | "afternoon" | "night";
+            name?: "manhã" | "tarde" | "noite";
         };
         AssignGuardianToUserDto: {
             /** Format: uuid */

package/dist/types/types/index.d.ts

@@ -3,6 +3,7 @@ export type User = components['schemas']['User'];
 export type Institution = components['schemas']['Institution'];
 export type Classroom = components['schemas']['Classroom'];
 export type InstitutionClassroom = components['schemas']['InstitutionClassroom'];
+export type InstitutionUser = components['schemas']['InstitutionUser'];
 export type Organization = components['schemas']['Organization'];
 export type Serie = components['schemas']['Serie'];
 export type Shift = components['schemas']['Shift'];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "academe-kit",
-  "version": "0.2.0",
+  "version": "0.2.3",
   "type": "module",
   "description": "A React component library with Tailwind CSS and Storybook",
   "main": "dist/index.js",