@supertst/api 0.4.0 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supertst/api",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "module": "src/index.ts",
   "type": "module",
   "files": [

package/src/index.ts

@@ -66,6 +66,47 @@ export interface GenerateQuestionsResponseDto {
   used_chain_of_thought: boolean;
 }
 
+export interface ReportIssueDto {
+  /**
+   * Question id_item identifier
+   * @format uuid
+   */
+  questionId: string;
+  /** Question flow where the issue was reported */
+  sessionType: "mission" | "practice" | "simulacro" | "diagnostico";
+  /**
+   * Current mission/practice/simulacro/diagnostico id
+   * @format uuid
+   */
+  sessionId: string;
+  /**
+   * Student issue description
+   * @minLength 1
+   * @maxLength 2000
+   */
+  message: string;
+  /**
+   * Optional issue category selected in UI
+   * @maxLength 120
+   */
+  issueCategory?: string;
+}
+
+export interface QuestionIssueReportResponseDto {
+  /** @format uuid */
+  id: string;
+  /** @format uuid */
+  userId: string;
+  /** @format uuid */
+  questionId: string;
+  sessionType: "mission" | "practice" | "simulacro" | "diagnostico";
+  /** @format uuid */
+  sessionId: string;
+  message: string;
+  issueCategory: object | null;
+  createdAt: string;
+}
+
 export interface RegisterDto {
   email: string;
   password: string;
@@ -689,6 +730,12 @@ export interface CreateUserDto {
    * @example "uuid-institution"
    */
   institution_id: string;
+  /**
+   * ID del salón (opcional)
+   * @format uuid
+   * @example "uuid-salon"
+   */
+  salon_id?: string;
   /**
    * ID del grado (opcional)
    * @format uuid
@@ -750,6 +797,29 @@ export interface BulkCreateUsersDto {
   institution_id: string;
 }
 
+export interface ResendInviteDto {
+  /**
+   * Correo del usuario destinatario
+   * @example "estudiante@example.com"
+   */
+  email?: string;
+  /**
+   * ID del usuario destinatario
+   * @format uuid
+   * @example "uuid-user"
+   */
+  user_id?: string;
+}
+
+export interface UpdateUserRoleDto {
+  /**
+   * ID del nuevo rol
+   * @format uuid
+   * @example "uuid-role"
+   */
+  role_id: string;
+}
+
 export interface CreateInstitucionDto {
   /** @example "Colegio San José" */
   name: string;
@@ -907,7 +977,7 @@ export interface ReviewItemDto {
   /** @example "Escriba un texto argumentativo sobre..." */
   enunciado: string;
   /** @example 0 */
-  indice_respuesta: number;
+  indice_respuesta?: object | null;
   /** @example "uuid-clasificacion" */
   id_clasificacion?: string;
   /** Question metadata */
@@ -1104,7 +1174,7 @@ export namespace V1 {
     imagen_svg?: string | null,
     imagen_alt?: string | null,
 
-},
+} | null,
     items?: ({
   /** @format uuid *\/
     id_item?: string,
@@ -1130,7 +1200,7 @@ export namespace V1 {
     imagen_svg?: string | null,
     imagen_alt?: string | null,
 
-},
+} | null,
     id_clasificacion?: string,
 
 })[],
@@ -1143,6 +1213,8 @@ export namespace V1 {
     export type RequestParams = {};
     export type RequestQuery = {
       id_clasificacion: string;
+      ai_generated?: boolean;
+      validated_by_ai?: boolean;
     };
     export type RequestBody = never;
     export type RequestHeaders = {};
@@ -1158,7 +1230,7 @@ export namespace V1 {
           imagen_url?: string | null;
           imagen_svg?: string | null;
           imagen_alt?: string | null;
-        };
+        } | null;
         items?: {
           /** @format uuid */
           id_item?: string;
@@ -1182,7 +1254,7 @@ export namespace V1 {
             imagen_url?: string | null;
             imagen_svg?: string | null;
             imagen_alt?: string | null;
-          };
+          } | null;
           id_clasificacion?: string;
         }[];
       }[];
@@ -1221,7 +1293,7 @@ export namespace V1 {
     imagen_svg?: string | null,
     imagen_alt?: string | null,
 
-},
+} | null,
     imagenes?: ({
     url?: string,
     alt?: string | null,
@@ -1255,7 +1327,7 @@ export namespace V1 {
     imagen_svg?: string | null,
     imagen_alt?: string | null,
 
-},
+} | null,
     group_info?: {
     total_questions?: number,
     current_question_index?: number,
@@ -1271,7 +1343,7 @@ export namespace V1 {
 
 })[],
 
-},
+} | null,
 
 },
 
@@ -1313,7 +1385,7 @@ export namespace V1 {
             imagen_url?: string | null;
             imagen_svg?: string | null;
             imagen_alt?: string | null;
-          };
+          } | null;
           imagenes?: {
             url?: string;
             alt?: string | null;
@@ -1342,7 +1414,7 @@ export namespace V1 {
             imagen_url?: string | null;
             imagen_svg?: string | null;
             imagen_alt?: string | null;
-          };
+          } | null;
           group_info?: {
             total_questions?: number;
             current_question_index?: number;
@@ -1355,7 +1427,7 @@ export namespace V1 {
             order_in_group?: number;
             is_current?: boolean;
           }[];
-        };
+        } | null;
       };
     };
   }
@@ -1516,6 +1588,26 @@ export namespace V1 {
     };
   }
 
+  /**
+   * No description
+   * @tags Question Issue Reports
+   * @name CreateReport
+   * @summary Report an issue found while answering a question
+   * @request POST:/v1/student/questions/report-issue
+   * @secure
+   * @response `201` `QuestionIssueReportResponseDto` Question issue report created successfully
+   * @response `400` `void` Invalid payload
+   * @response `401` `void` Unauthorized
+   * @response `404` `void` Question or authenticated user not found
+   */
+  export namespace CreateReport {
+    export type RequestParams = {};
+    export type RequestQuery = {};
+    export type RequestBody = ReportIssueDto;
+    export type RequestHeaders = {};
+    export type ResponseBody = QuestionIssueReportResponseDto;
+  }
+
   /**
    * @description Usa el parámetro `only` para solicitar solo las listas específicas (ej. `competencias,grados`).
    * @tags trainer
@@ -1905,7 +1997,7 @@ export namespace V1 {
   /** @format date-time *\/
     updated_at?: string,
 
-})[],
+})[] | null,
 
 },
   /** @example "Registration successful. Please check your email to confirm your account." *\/
@@ -1995,16 +2087,18 @@ export namespace V1 {
             }[]
           | null;
         /** MFA factors enrollados */
-        factors?: {
-          id?: string;
-          factor_type?: "totp" | "phone" | "webauthn";
-          status?: "verified" | "unverified";
-          friendly_name?: string | null;
-          /** @format date-time */
-          created_at?: string;
-          /** @format date-time */
-          updated_at?: string;
-        }[];
+        factors?:
+          | {
+              id?: string;
+              factor_type?: "totp" | "phone" | "webauthn";
+              status?: "verified" | "unverified";
+              friendly_name?: string | null;
+              /** @format date-time */
+              created_at?: string;
+              /** @format date-time */
+              updated_at?: string;
+            }[]
+          | null;
       };
       /** @example "Registration successful. Please check your email to confirm your account." */
       message?: string;
@@ -2109,7 +2203,7 @@ export namespace V1 {
   /** @format date-time *\/
     updated_at?: string,
 
-})[],
+})[] | null,
 
 },
 
@@ -2201,16 +2295,18 @@ export namespace V1 {
             }[]
           | null;
         /** MFA factors enrollados */
-        factors?: {
-          id?: string;
-          factor_type?: "totp" | "phone" | "webauthn";
-          status?: "verified" | "unverified";
-          friendly_name?: string | null;
-          /** @format date-time */
-          created_at?: string;
-          /** @format date-time */
-          updated_at?: string;
-        }[];
+        factors?:
+          | {
+              id?: string;
+              factor_type?: "totp" | "phone" | "webauthn";
+              status?: "verified" | "unverified";
+              friendly_name?: string | null;
+              /** @format date-time */
+              created_at?: string;
+              /** @format date-time */
+              updated_at?: string;
+            }[]
+          | null;
       };
     };
   }
@@ -2311,7 +2407,7 @@ export namespace V1 {
   /** @format date-time *\/
     updated_at?: string,
 
-})[],
+})[] | null,
 
 },
 
@@ -2401,16 +2497,18 @@ export namespace V1 {
             }[]
           | null;
         /** MFA factors enrollados */
-        factors?: {
-          id?: string;
-          factor_type?: "totp" | "phone" | "webauthn";
-          status?: "verified" | "unverified";
-          friendly_name?: string | null;
-          /** @format date-time */
-          created_at?: string;
-          /** @format date-time */
-          updated_at?: string;
-        }[];
+        factors?:
+          | {
+              id?: string;
+              factor_type?: "totp" | "phone" | "webauthn";
+              status?: "verified" | "unverified";
+              friendly_name?: string | null;
+              /** @format date-time */
+              created_at?: string;
+              /** @format date-time */
+              updated_at?: string;
+            }[]
+          | null;
       };
     };
   }
@@ -2508,7 +2606,7 @@ export namespace V1 {
   /** @format date-time *\/
     updated_at?: string,
 
-})[],
+})[] | null,
 
 },
 
@@ -2594,16 +2692,18 @@ export namespace V1 {
             }[]
           | null;
         /** MFA factors enrollados */
-        factors?: {
-          id?: string;
-          factor_type?: "totp" | "phone" | "webauthn";
-          status?: "verified" | "unverified";
-          friendly_name?: string | null;
-          /** @format date-time */
-          created_at?: string;
-          /** @format date-time */
-          updated_at?: string;
-        }[];
+        factors?:
+          | {
+              id?: string;
+              factor_type?: "totp" | "phone" | "webauthn";
+              status?: "verified" | "unverified";
+              friendly_name?: string | null;
+              /** @format date-time */
+              created_at?: string;
+              /** @format date-time */
+              updated_at?: string;
+            }[]
+          | null;
       };
     };
   }
@@ -2963,14 +3063,14 @@ export namespace V1 {
 
 })[],
 
-},
+} | null,
   /**
    * Tabla en formato Markdown. null si no aplica.
    * @example null
    *\/
     tabla_markdown?: string | null,
 
-},
+} | null,
   /** Preguntas del grupo *\/
     items?: ({
   /**
@@ -3012,7 +3112,7 @@ export namespace V1 {
   /** Representación visual del enunciado de la pregunta (misma estructura que representacion_visual_id_estimulo) *\/
     representacion_visual_enunciado?: object | null,
 
-},
+} | null,
   /** Representación visual del enunciado de la pregunta, ya extraída al nivel superior. *\/
     representacion_visual_enunciado?: {
     tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
@@ -3023,7 +3123,7 @@ export namespace V1 {
     imagen_svg?: string | null,
     imagen_alt?: string | null,
 
-},
+} | null,
   /** Imágenes directas de la pregunta. Array vacío si no tiene imágenes. *\/
     imagenes?: ({
   /** URL de la imagen *\/
@@ -3176,13 +3276,13 @@ export namespace V1 {
               /** @example "Meta mensual" */
               label?: string;
             }[];
-          };
+          } | null;
           /**
            * Tabla en formato Markdown. null si no aplica.
            * @example null
            */
           tabla_markdown?: string | null;
-        };
+        } | null;
         /** Preguntas del grupo */
         items?: {
           /**
@@ -3223,7 +3323,7 @@ export namespace V1 {
             representacion_visual_contexto?: object | null;
             /** Representación visual del enunciado de la pregunta (misma estructura que representacion_visual_id_estimulo) */
             representacion_visual_enunciado?: object | null;
-          };
+          } | null;
           /** Representación visual del enunciado de la pregunta, ya extraída al nivel superior. */
           representacion_visual_enunciado?: {
             tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia";
@@ -3233,7 +3333,7 @@ export namespace V1 {
             imagen_url?: string | null;
             imagen_svg?: string | null;
             imagen_alt?: string | null;
-          };
+          } | null;
           /** Imágenes directas de la pregunta. Array vacío si no tiene imágenes. */
           imagenes?: {
             /** URL de la imagen */
@@ -3605,6 +3705,64 @@ export namespace V1 {
 
   /**
  * No description
+ * @tags student
+ * @name GetMateriasWithComponentes
+ * @summary Listar materias con sus selectores por tipo de institución
+ * @request GET:/v1/student/materias-componentes
+ * @secure
+ * @response `200` `{
+    ok?: boolean,
+    data?: ({
+  /** @format uuid *\/
+    id_materia?: string,
+  /** @example "Matemáticas" *\/
+    nombre?: string,
+    image_url?: string | null,
+    institution_type?: "SCHOOL" | "UNIVERSITY",
+    componentes?: ({
+  /** @format uuid *\/
+    id_componente?: string,
+  /** @example "Interpretación y representación" *\/
+    nombre?: string,
+    selector_name?: string | null,
+
+})[],
+
+})[],
+
+}` Lista de materias con selectores
+ * @response `401` `void` Invalid API key
+*/
+  export namespace GetMateriasWithComponentes {
+    export type RequestParams = {};
+    export type RequestQuery = {
+      /** Institution type */
+      institution_type: "SCHOOL" | "UNIVERSITY";
+    };
+    export type RequestBody = never;
+    export type RequestHeaders = {};
+    export type ResponseBody = {
+      ok?: boolean;
+      data?: {
+        /** @format uuid */
+        id_materia?: string;
+        /** @example "Matemáticas" */
+        nombre?: string;
+        image_url?: string | null;
+        institution_type?: "SCHOOL" | "UNIVERSITY";
+        componentes?: {
+          /** @format uuid */
+          id_componente?: string;
+          /** @example "Interpretación y representación" */
+          nombre?: string;
+          selector_name?: string | null;
+        }[];
+      }[];
+    };
+  }
+
+  /**
+ * No description
  * @tags trainer
  * @name CreateConfiguracion
  * @summary Crear configuración de simulacro
@@ -3896,7 +4054,7 @@ export namespace V1 {
   /** @example "DÉCIMO GRADO" *\/
     descripcion_larga?: string | null,
 
-},
+} | null,
     instituciones?: {
   /** @format uuid *\/
     id?: string,
@@ -3957,7 +4115,7 @@ export namespace V1 {
             nombre?: string;
             /** @example "DÉCIMO GRADO" */
             descripcion_larga?: string | null;
-          };
+          } | null;
           instituciones?: {
             /** @format uuid */
             id?: string;
@@ -4421,7 +4579,7 @@ export namespace V1 {
     imagen_svg?: string | null,
     imagen_alt?: string | null,
 
-},
+} | null,
     items?: ({
   /** @format uuid *\/
     id_item?: string,
@@ -4439,7 +4597,7 @@ export namespace V1 {
     imagen_svg?: string | null,
     imagen_alt?: string | null,
 
-},
+} | null,
     imagenes?: ({
     url?: string,
     alt?: string,
@@ -4504,7 +4662,7 @@ export namespace V1 {
             imagen_url?: string | null;
             imagen_svg?: string | null;
             imagen_alt?: string | null;
-          };
+          } | null;
           items?: {
             /** @format uuid */
             id_item?: string;
@@ -4526,7 +4684,7 @@ export namespace V1 {
               imagen_url?: string | null;
               imagen_svg?: string | null;
               imagen_alt?: string | null;
-            };
+            } | null;
             imagenes?: {
               url?: string;
               alt?: string;
@@ -5386,7 +5544,7 @@ export namespace V1 {
     imagen_alt?: string | null,
     imagen_svg?: string | null,
 
-},
+} | null,
     items?: ({
   /** @format uuid *\/
     id_item?: string,
@@ -5402,7 +5560,7 @@ export namespace V1 {
     imagen_alt?: string | null,
     imagen_svg?: string | null,
 
-},
+} | null,
     imagenes?: ({
     url?: string,
     alt?: string,
@@ -5470,7 +5628,7 @@ export namespace V1 {
           imagen_url?: string | null;
           imagen_alt?: string | null;
           imagen_svg?: string | null;
-        };
+        } | null;
         items?: {
           /** @format uuid */
           id_item?: string;
@@ -5485,7 +5643,7 @@ export namespace V1 {
             imagen_url?: string | null;
             imagen_alt?: string | null;
             imagen_svg?: string | null;
-          };
+          } | null;
           imagenes?: {
             url?: string;
             alt?: string;
@@ -5568,7 +5726,7 @@ export namespace V1 {
 
 },
 
-}>,
+}> | null,
     progreso?: {
   /** @example 72.5 *\/
     promedio_actual?: number | null,
@@ -5643,7 +5801,7 @@ export namespace V1 {
             ambiguedad_alta?: boolean;
           };
         }
-      >;
+      > | null;
       progreso?: {
         /** @example 72.5 */
         promedio_actual?: number | null;
@@ -6514,16 +6672,37 @@ export namespace V1 {
   export namespace ResendInvite {
     export type RequestParams = {};
     export type RequestQuery = {};
-    export type RequestBody = {
-      /**
-       * @format email
-       * @example "estudiante@example.com"
-       */
-      email: string;
+    export type RequestBody = ResendInviteDto;
+    export type RequestHeaders = {};
+    export type ResponseBody = {
+      ok?: boolean;
     };
+  }
+
+  /**
+ * No description
+ * @tags admin
+ * @name UpdateUserRole
+ * @summary Cambiar el rol de un usuario
+ * @request PATCH:/v1/admin/users/{targetUserId}/role
+ * @secure
+ * @response `200` `{
+    ok?: boolean,
+    data?: object,
+
+}` Usuario actualizado con relaciones de rol e institución
+*/
+  export namespace UpdateUserRole {
+    export type RequestParams = {
+      /** User ID to update */
+      targetUserId: string;
+    };
+    export type RequestQuery = {};
+    export type RequestBody = UpdateUserRoleDto;
     export type RequestHeaders = {};
     export type ResponseBody = {
       ok?: boolean;
+      data?: object;
     };
   }
 
@@ -6783,7 +6962,7 @@ export namespace V1 {
     imagen_svg?: string | null,
     imagen_alt?: string | null,
 
-},
+} | null,
     items?: ({
   /** @format uuid *\/
     id_item?: string,
@@ -6802,7 +6981,7 @@ export namespace V1 {
     imagen_svg?: string | null,
     imagen_alt?: string | null,
 
-},
+} | null,
     imagenes?: (object)[],
   /** Opciones sin es_correcta ni explicacion. Incluye id_item del parent. *\/
     opciones?: ({
@@ -6869,7 +7048,7 @@ export namespace V1 {
           imagen_url?: string | null;
           imagen_svg?: string | null;
           imagen_alt?: string | null;
-        };
+        } | null;
         items?: {
           /** @format uuid */
           id_item?: string;
@@ -6887,7 +7066,7 @@ export namespace V1 {
             imagen_url?: string | null;
             imagen_svg?: string | null;
             imagen_alt?: string | null;
-          };
+          } | null;
           imagenes?: object[];
           /** Opciones sin es_correcta ni explicacion. Incluye id_item del parent. */
           opciones?: {
@@ -7511,7 +7690,7 @@ export class Api<
     imagen_svg?: string | null,
     imagen_alt?: string | null,
 
-},
+} | null,
     items?: ({
   /** @format uuid *\/
     id_item?: string,
@@ -7537,7 +7716,7 @@ export class Api<
     imagen_svg?: string | null,
     imagen_alt?: string | null,
 
-},
+} | null,
     id_clasificacion?: string,
 
 })[],
@@ -7549,6 +7728,8 @@ export class Api<
     getQuestionsByClasificacion: (
       query: {
         id_clasificacion: string;
+        ai_generated?: boolean;
+        validated_by_ai?: boolean;
       },
       params: RequestParams = {},
     ) =>
@@ -7570,7 +7751,7 @@ export class Api<
               imagen_url?: string | null;
               imagen_svg?: string | null;
               imagen_alt?: string | null;
-            };
+            } | null;
             items?: {
               /** @format uuid */
               id_item?: string;
@@ -7599,7 +7780,7 @@ export class Api<
                 imagen_url?: string | null;
                 imagen_svg?: string | null;
                 imagen_alt?: string | null;
-              };
+              } | null;
               id_clasificacion?: string;
             }[];
           }[];
@@ -7646,7 +7827,7 @@ export class Api<
     imagen_svg?: string | null,
     imagen_alt?: string | null,
 
-},
+} | null,
     imagenes?: ({
     url?: string,
     alt?: string | null,
@@ -7680,7 +7861,7 @@ export class Api<
     imagen_svg?: string | null,
     imagen_alt?: string | null,
 
-},
+} | null,
     group_info?: {
     total_questions?: number,
     current_question_index?: number,
@@ -7696,7 +7877,7 @@ export class Api<
 
 })[],
 
-},
+} | null,
 
 },
 
@@ -7734,7 +7915,7 @@ export class Api<
                 imagen_url?: string | null;
                 imagen_svg?: string | null;
                 imagen_alt?: string | null;
-              };
+              } | null;
               imagenes?: {
                 url?: string;
                 alt?: string | null;
@@ -7768,7 +7949,7 @@ export class Api<
                 imagen_url?: string | null;
                 imagen_svg?: string | null;
                 imagen_alt?: string | null;
-              };
+              } | null;
               group_info?: {
                 total_questions?: number;
                 current_question_index?: number;
@@ -7781,7 +7962,7 @@ export class Api<
                 order_in_group?: number;
                 is_current?: boolean;
               }[];
-            };
+            } | null;
           };
         },
         any
@@ -7984,6 +8165,30 @@ export class Api<
         ...params,
       }),
 
+    /**
+     * No description
+     *
+     * @tags Question Issue Reports
+     * @name CreateReport
+     * @summary Report an issue found while answering a question
+     * @request POST:/v1/student/questions/report-issue
+     * @secure
+     * @response `201` `QuestionIssueReportResponseDto` Question issue report created successfully
+     * @response `400` `void` Invalid payload
+     * @response `401` `void` Unauthorized
+     * @response `404` `void` Question or authenticated user not found
+     */
+    createReport: (data: ReportIssueDto, params: RequestParams = {}) =>
+      this.request<QuestionIssueReportResponseDto, void>({
+        path: `/v1/student/questions/report-issue`,
+        method: "POST",
+        body: data,
+        secure: true,
+        type: ContentType.Json,
+        format: "json",
+        ...params,
+      }),
+
     /**
      * @description Usa el parámetro `only` para solicitar solo las listas específicas (ej. `competencias,grados`).
      *
@@ -8407,7 +8612,7 @@ export class Api<
   /** @format date-time *\/
     updated_at?: string,
 
-})[],
+})[] | null,
 
 },
   /** @example "Registration successful. Please check your email to confirm your account." *\/
@@ -8494,16 +8699,18 @@ export class Api<
                 }[]
               | null;
             /** MFA factors enrollados */
-            factors?: {
-              id?: string;
-              factor_type?: "totp" | "phone" | "webauthn";
-              status?: "verified" | "unverified";
-              friendly_name?: string | null;
-              /** @format date-time */
-              created_at?: string;
-              /** @format date-time */
-              updated_at?: string;
-            }[];
+            factors?:
+              | {
+                  id?: string;
+                  factor_type?: "totp" | "phone" | "webauthn";
+                  status?: "verified" | "unverified";
+                  friendly_name?: string | null;
+                  /** @format date-time */
+                  created_at?: string;
+                  /** @format date-time */
+                  updated_at?: string;
+                }[]
+              | null;
           };
           /** @example "Registration successful. Please check your email to confirm your account." */
           message?: string;
@@ -8617,7 +8824,7 @@ export class Api<
   /** @format date-time *\/
     updated_at?: string,
 
-})[],
+})[] | null,
 
 },
 
@@ -8706,16 +8913,18 @@ export class Api<
                 }[]
               | null;
             /** MFA factors enrollados */
-            factors?: {
-              id?: string;
-              factor_type?: "totp" | "phone" | "webauthn";
-              status?: "verified" | "unverified";
-              friendly_name?: string | null;
-              /** @format date-time */
-              created_at?: string;
-              /** @format date-time */
-              updated_at?: string;
-            }[];
+            factors?:
+              | {
+                  id?: string;
+                  factor_type?: "totp" | "phone" | "webauthn";
+                  status?: "verified" | "unverified";
+                  friendly_name?: string | null;
+                  /** @format date-time */
+                  created_at?: string;
+                  /** @format date-time */
+                  updated_at?: string;
+                }[]
+              | null;
           };
         },
         any
@@ -8825,7 +9034,7 @@ export class Api<
   /** @format date-time *\/
     updated_at?: string,
 
-})[],
+})[] | null,
 
 },
 
@@ -8912,16 +9121,18 @@ export class Api<
                 }[]
               | null;
             /** MFA factors enrollados */
-            factors?: {
-              id?: string;
-              factor_type?: "totp" | "phone" | "webauthn";
-              status?: "verified" | "unverified";
-              friendly_name?: string | null;
-              /** @format date-time */
-              created_at?: string;
-              /** @format date-time */
-              updated_at?: string;
-            }[];
+            factors?:
+              | {
+                  id?: string;
+                  factor_type?: "totp" | "phone" | "webauthn";
+                  status?: "verified" | "unverified";
+                  friendly_name?: string | null;
+                  /** @format date-time */
+                  created_at?: string;
+                  /** @format date-time */
+                  updated_at?: string;
+                }[]
+              | null;
           };
         },
         any
@@ -9028,7 +9239,7 @@ export class Api<
   /** @format date-time *\/
     updated_at?: string,
 
-})[],
+})[] | null,
 
 },
 
@@ -9111,16 +9322,18 @@ export class Api<
                 }[]
               | null;
             /** MFA factors enrollados */
-            factors?: {
-              id?: string;
-              factor_type?: "totp" | "phone" | "webauthn";
-              status?: "verified" | "unverified";
-              friendly_name?: string | null;
-              /** @format date-time */
-              created_at?: string;
-              /** @format date-time */
-              updated_at?: string;
-            }[];
+            factors?:
+              | {
+                  id?: string;
+                  factor_type?: "totp" | "phone" | "webauthn";
+                  status?: "verified" | "unverified";
+                  friendly_name?: string | null;
+                  /** @format date-time */
+                  created_at?: string;
+                  /** @format date-time */
+                  updated_at?: string;
+                }[]
+              | null;
           };
         },
         any
@@ -9535,14 +9748,14 @@ export class Api<
 
 })[],
 
-},
+} | null,
   /**
    * Tabla en formato Markdown. null si no aplica.
    * @example null
    *\/
     tabla_markdown?: string | null,
 
-},
+} | null,
   /** Preguntas del grupo *\/
     items?: ({
   /**
@@ -9584,7 +9797,7 @@ export class Api<
   /** Representación visual del enunciado de la pregunta (misma estructura que representacion_visual_id_estimulo) *\/
     representacion_visual_enunciado?: object | null,
 
-},
+} | null,
   /** Representación visual del enunciado de la pregunta, ya extraída al nivel superior. *\/
     representacion_visual_enunciado?: {
     tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
@@ -9595,7 +9808,7 @@ export class Api<
     imagen_svg?: string | null,
     imagen_alt?: string | null,
 
-},
+} | null,
   /** Imágenes directas de la pregunta. Array vacío si no tiene imágenes. *\/
     imagenes?: ({
   /** URL de la imagen *\/
@@ -9745,13 +9958,13 @@ export class Api<
                   /** @example "Meta mensual" */
                   label?: string;
                 }[];
-              };
+              } | null;
               /**
                * Tabla en formato Markdown. null si no aplica.
                * @example null
                */
               tabla_markdown?: string | null;
-            };
+            } | null;
             /** Preguntas del grupo */
             items?: {
               /**
@@ -9792,7 +10005,7 @@ export class Api<
                 representacion_visual_contexto?: object | null;
                 /** Representación visual del enunciado de la pregunta (misma estructura que representacion_visual_id_estimulo) */
                 representacion_visual_enunciado?: object | null;
-              };
+              } | null;
               /** Representación visual del enunciado de la pregunta, ya extraída al nivel superior. */
               representacion_visual_enunciado?: {
                 tipo?:
@@ -9807,7 +10020,7 @@ export class Api<
                 imagen_url?: string | null;
                 imagen_svg?: string | null;
                 imagen_alt?: string | null;
-              };
+              } | null;
               /** Imágenes directas de la pregunta. Array vacío si no tiene imágenes. */
               imagenes?: {
                 /** URL de la imagen */
@@ -10236,6 +10449,73 @@ export class Api<
     /**
  * No description
  *
+ * @tags student
+ * @name GetMateriasWithComponentes
+ * @summary Listar materias con sus selectores por tipo de institución
+ * @request GET:/v1/student/materias-componentes
+ * @secure
+ * @response `200` `{
+    ok?: boolean,
+    data?: ({
+  /** @format uuid *\/
+    id_materia?: string,
+  /** @example "Matemáticas" *\/
+    nombre?: string,
+    image_url?: string | null,
+    institution_type?: "SCHOOL" | "UNIVERSITY",
+    componentes?: ({
+  /** @format uuid *\/
+    id_componente?: string,
+  /** @example "Interpretación y representación" *\/
+    nombre?: string,
+    selector_name?: string | null,
+
+})[],
+
+})[],
+
+}` Lista de materias con selectores
+ * @response `401` `void` Invalid API key
+ */
+    getMateriasWithComponentes: (
+      query: {
+        /** Institution type */
+        institution_type: "SCHOOL" | "UNIVERSITY";
+      },
+      params: RequestParams = {},
+    ) =>
+      this.request<
+        {
+          ok?: boolean;
+          data?: {
+            /** @format uuid */
+            id_materia?: string;
+            /** @example "Matemáticas" */
+            nombre?: string;
+            image_url?: string | null;
+            institution_type?: "SCHOOL" | "UNIVERSITY";
+            componentes?: {
+              /** @format uuid */
+              id_componente?: string;
+              /** @example "Interpretación y representación" */
+              nombre?: string;
+              selector_name?: string | null;
+            }[];
+          }[];
+        },
+        void
+      >({
+        path: `/v1/student/materias-componentes`,
+        method: "GET",
+        query: query,
+        secure: true,
+        format: "json",
+        ...params,
+      }),
+
+    /**
+ * No description
+ *
  * @tags trainer
  * @name CreateConfiguracion
  * @summary Crear configuración de simulacro
@@ -10549,7 +10829,7 @@ export class Api<
   /** @example "DÉCIMO GRADO" *\/
     descripcion_larga?: string | null,
 
-},
+} | null,
     instituciones?: {
   /** @format uuid *\/
     id?: string,
@@ -10607,7 +10887,7 @@ export class Api<
                 nombre?: string;
                 /** @example "DÉCIMO GRADO" */
                 descripcion_larga?: string | null;
-              };
+              } | null;
               instituciones?: {
                 /** @format uuid */
                 id?: string;
@@ -11113,7 +11393,7 @@ export class Api<
     imagen_svg?: string | null,
     imagen_alt?: string | null,
 
-},
+} | null,
     items?: ({
   /** @format uuid *\/
     id_item?: string,
@@ -11131,7 +11411,7 @@ export class Api<
     imagen_svg?: string | null,
     imagen_alt?: string | null,
 
-},
+} | null,
     imagenes?: ({
     url?: string,
     alt?: string,
@@ -11192,7 +11472,7 @@ export class Api<
                 imagen_url?: string | null;
                 imagen_svg?: string | null;
                 imagen_alt?: string | null;
-              };
+              } | null;
               items?: {
                 /** @format uuid */
                 id_item?: string;
@@ -11214,7 +11494,7 @@ export class Api<
                   imagen_url?: string | null;
                   imagen_svg?: string | null;
                   imagen_alt?: string | null;
-                };
+                } | null;
                 imagenes?: {
                   url?: string;
                   alt?: string;
@@ -12149,7 +12429,7 @@ export class Api<
     imagen_alt?: string | null,
     imagen_svg?: string | null,
 
-},
+} | null,
     items?: ({
   /** @format uuid *\/
     id_item?: string,
@@ -12165,7 +12445,7 @@ export class Api<
     imagen_alt?: string | null,
     imagen_svg?: string | null,
 
-},
+} | null,
     imagenes?: ({
     url?: string,
     alt?: string,
@@ -12235,7 +12515,7 @@ export class Api<
               imagen_url?: string | null;
               imagen_alt?: string | null;
               imagen_svg?: string | null;
-            };
+            } | null;
             items?: {
               /** @format uuid */
               id_item?: string;
@@ -12255,7 +12535,7 @@ export class Api<
                 imagen_url?: string | null;
                 imagen_alt?: string | null;
                 imagen_svg?: string | null;
-              };
+              } | null;
               imagenes?: {
                 url?: string;
                 alt?: string;
@@ -12346,7 +12626,7 @@ export class Api<
 
 },
 
-}>,
+}> | null,
     progreso?: {
   /** @example 72.5 *\/
     promedio_actual?: number | null,
@@ -12418,7 +12698,7 @@ export class Api<
                 ambiguedad_alta?: boolean;
               };
             }
-          >;
+          > | null;
           progreso?: {
             /** @example 72.5 */
             promedio_actual?: number | null;
@@ -13357,16 +13637,7 @@ export class Api<
 
 }` Invitación reenviada
  */
-    resendInvite: (
-      data: {
-        /**
-         * @format email
-         * @example "estudiante@example.com"
-         */
-        email: string;
-      },
-      params: RequestParams = {},
-    ) =>
+    resendInvite: (data: ResendInviteDto, params: RequestParams = {}) =>
       this.request<
         {
           ok?: boolean;
@@ -13386,6 +13657,41 @@ export class Api<
  * No description
  *
  * @tags admin
+ * @name UpdateUserRole
+ * @summary Cambiar el rol de un usuario
+ * @request PATCH:/v1/admin/users/{targetUserId}/role
+ * @secure
+ * @response `200` `{
+    ok?: boolean,
+    data?: object,
+
+}` Usuario actualizado con relaciones de rol e institución
+ */
+    updateUserRole: (
+      targetUserId: string,
+      data: UpdateUserRoleDto,
+      params: RequestParams = {},
+    ) =>
+      this.request<
+        {
+          ok?: boolean;
+          data?: object;
+        },
+        any
+      >({
+        path: `/v1/admin/users/${targetUserId}/role`,
+        method: "PATCH",
+        body: data,
+        secure: true,
+        type: ContentType.Json,
+        format: "json",
+        ...params,
+      }),
+
+    /**
+ * No description
+ *
+ * @tags admin
  * @name GetAllUsers
  * @summary Listar todos los usuarios con detalle completo (super_admin)
  * @request GET:/v1/admin/users/all
@@ -13679,7 +13985,7 @@ export class Api<
     imagen_svg?: string | null,
     imagen_alt?: string | null,
 
-},
+} | null,
     items?: ({
   /** @format uuid *\/
     id_item?: string,
@@ -13698,7 +14004,7 @@ export class Api<
     imagen_svg?: string | null,
     imagen_alt?: string | null,
 
-},
+} | null,
     imagenes?: (object)[],
   /** Opciones sin es_correcta ni explicacion. Incluye id_item del parent. *\/
     opciones?: ({
@@ -13767,7 +14073,7 @@ export class Api<
               imagen_url?: string | null;
               imagen_svg?: string | null;
               imagen_alt?: string | null;
-            };
+            } | null;
             items?: {
               /** @format uuid */
               id_item?: string;
@@ -13790,7 +14096,7 @@ export class Api<
                 imagen_url?: string | null;
                 imagen_svg?: string | null;
                 imagen_alt?: string | null;
-              };
+              } | null;
               imagenes?: object[];
               /** Opciones sin es_correcta ni explicacion. Incluye id_item del parent. */
               opciones?: {