@supertst/api 0.1.0 → 0.3.0

package/README.md

@@ -5,48 +5,17 @@ SDK client generated from the Supertest API schema.
 ## Install
 
 ```bash
-bun install
+npm install @supertst/api
 ```
 
-## Generate `src/index.ts`
+## Usage
 
-Regenerate the SDK from the remote OpenAPI schema:
+See [`SDK_GUIDE.md`](./SDK_GUIDE.md).
 
-```bash
-bun run generate
-```
-
-This command runs `src/generate.ts` and overwrites `src/index.ts`.
-
-## Publish flow
-
-Publishing is automated with GitHub Actions on every push to `main`.
+## Next.js 16
 
-Versioning is manual. Before pushing a new release to `main`, update `version` in `package.json`.
+See [`NEXTJS_APP_ROUTER_GUIDE.md`](./NEXTJS_APP_ROUTER_GUIDE.md).
 
-Example:
+## Next.js Caching
 
-```json
-{
-  "version": "0.1.1"
-}
-```
-
-Then push to `main` and GitHub Actions will run:
-
-```bash
-bun publish --access public --tolerate-republish
-```
-
-If that exact version already exists on npm, the workflow will not fail because it uses `--tolerate-republish`.
-
-## Commits
-
-Commits no longer control versioning.
-
-Use any clear commit message you want, for example:
-
-```bash
-git commit -m "update sdk generation workflow"
-git commit -m "fix publish action"
-```
+See [`NEXTJS_CACHE_COMPONENTS_GUIDE.md`](./NEXTJS_CACHE_COMPONENTS_GUIDE.md).

package/package.json

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

package/src/index.ts

@@ -890,7 +890,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 */
@@ -3252,6 +3252,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
@@ -3640,14 +3698,21 @@ export namespace V1 {
     export type RequestQuery = {
       /**
        * Página (default 1)
+       * @min 1
+       * @default 1
        * @example 1
        */
       page?: number;
       /**
        * Resultados por página (default 50)
+       * @min 1
+       * @max 100
+       * @default 50
        * @example 50
        */
       perPage?: number;
+      /** Orden primario del leaderboard (default score) */
+      sortBy?: "score" | "xp";
     };
     export type RequestBody = never;
     export type RequestHeaders = {};
@@ -9302,6 +9367,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
@@ -9716,14 +9848,21 @@ export class Api<
       query?: {
         /**
          * Página (default 1)
+         * @min 1
+         * @default 1
          * @example 1
          */
         page?: number;
         /**
          * Resultados por página (default 50)
+         * @min 1
+         * @max 100
+         * @default 50
          * @example 50
          */
         perPage?: number;
+        /** Orden primario del leaderboard (default score) */
+        sortBy?: "score" | "xp";
       },
       params: RequestParams = {},
     ) =>