@hablala/api-contract 0.10.0 → 0.11.0

package/dist/index.d.ts

@@ -264,6 +264,26 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/invitations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Invitar a un operador por email (bootstrap del equipo, credencial de máquina)
+         * @description Crea una invitación por **email** con un rol opcional (`{"invitation": {"email": "…", "role_id": "role_…"}}`). Al aceptarla, la persona queda como miembro de la organización y podrá iniciar sesión como operador (member session `mem_…`). La org sale del token (org-less), como el resto de la superficie de máquina. Requiere el permiso `invitations:create` (preset `team_admin`).
+         */
+        post: operations["post /v1/invitations"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/invitations/accept": {
         parameters: {
             query?: never;
@@ -1107,6 +1127,26 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/members": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Dar de alta un operador directo (sin invitación)
+         * @description Crea al operador y su membresía ACTIVA al instante. Devuelve un `passwordSetupToken` para que la persona fije su contraseña (no se comparte ninguna contraseña generada). Requiere `organization_memberships:create` (preset `team_admin`).
+         */
+        post: operations["post /v1/members"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/members/me": {
         parameters: {
             query?: never;
@@ -4285,6 +4325,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/roles": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Listar los roles de la organización (para asignar al invitar) */
+        get: operations["get /v1/roles"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/sso/callback": {
         parameters: {
             query?: never;
@@ -8095,6 +8152,40 @@ interface components {
             /** @description Destino de la subida. */
             url: string;
         };
+        /**
+         * ProvisionMemberInput
+         * @description Datos para dar de alta un operador DIRECTO (sin invitación por email): queda miembro activo al instante y establece su contraseña por el link de set-password de la respuesta.
+         */
+        ProvisionMemberInput: {
+            /**
+             * Format: email
+             * @description Email del operador. Si ya existe un usuario con ese email, se reutiliza.
+             */
+            email: string;
+            /** @description Nombre del rol a asignar (p. ej. `operator`). Opcional. */
+            role?: string | null;
+        };
+        /** ProvisionMemberRequest */
+        ProvisionMemberRequest: {
+            member: components["schemas"]["ProvisionMemberInput"];
+        };
+        /**
+         * ProvisionMemberResponse
+         * @description El operador dado de alta. `passwordSetupToken` es el token de un solo uso con el que la persona establece SU contraseña (nunca se le comparte una contraseña generada). `userCreated` indica si el usuario nació con esta alta o ya existía (en cuyo caso su contraseña no se toca).
+         */
+        ProvisionMemberResponse: {
+            data: {
+                displayName?: string | null;
+                email?: string | null;
+                /** @description Id de la membresía (`mbr_…`). */
+                id: string;
+                /** @description Token de set-password (un solo uso). Entrégaselo a la persona para que fije su contraseña vía el flujo de reset. NO es una contraseña. */
+                passwordSetupToken: string;
+                roles: string[];
+                /** @description `true` si el usuario nació con esta alta; `false` si ya existía. */
+                userCreated: boolean;
+            };
+        };
         /**
          * PublicOrganization
          * @description Identidad PÚBLICA del tenant (la org del token) — el paralelo horizontal del `shop`/`brand` de Shopify. Deja al cliente pintar su chrome (nombre, logo) y conocer su `endUserObjectSlug` sin hardcodear la marca. NUNCA incluye la PII legal del negocio.
@@ -9616,6 +9707,49 @@ interface operations {
             };
         };
     };
+    "post /v1/invitations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Datos de la invitación */
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["InvitationRequest"];
+            };
+        };
+        responses: {
+            /** @description Invitación creada */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InvitationResponse"];
+                };
+            };
+            /** @description Sin permiso */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Error de validación */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     "post /v1/invitations/accept": {
         parameters: {
             query?: never;
@@ -11236,6 +11370,49 @@ interface operations {
             };
         };
     };
+    "post /v1/members": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Datos del operador */
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["ProvisionMemberRequest"];
+            };
+        };
+        responses: {
+            /** @description Operador dado de alta */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProvisionMemberResponse"];
+                };
+            };
+            /** @description Sin permiso */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Error de validación */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     "get /v1/members/me": {
         parameters: {
             query?: never;
@@ -20353,6 +20530,35 @@ interface operations {
             };
         };
     };
+    "get /v1/roles": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Roles */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RolesResponse"];
+                };
+            };
+            /** @description Sin permiso */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     "post /v1/sso/callback": {
         parameters: {
             query?: never;

package/openapi.json

@@ -10529,6 +10529,111 @@
         "x-struct": "Elixir.HablalaApiWeb.Schemas.PresignResult",
         "x-validate": null
       },
+      "ProvisionMemberInput": {
+        "description": "Datos para dar de alta un operador DIRECTO (sin invitación por email): queda miembro activo al instante y establece su contraseña por el link de set-password de la respuesta.",
+        "properties": {
+          "email": {
+            "description": "Email del operador. Si ya existe un usuario con ese email, se reutiliza.",
+            "format": "email",
+            "type": "string",
+            "x-struct": null,
+            "x-validate": null
+          },
+          "role": {
+            "description": "Nombre del rol a asignar (p. ej. `operator`). Opcional.",
+            "nullable": true,
+            "type": "string",
+            "x-struct": null,
+            "x-validate": null
+          }
+        },
+        "required": [
+          "email"
+        ],
+        "title": "ProvisionMemberInput",
+        "type": "object",
+        "x-struct": "Elixir.HablalaApiWeb.Schemas.ProvisionMemberInput",
+        "x-validate": null
+      },
+      "ProvisionMemberRequest": {
+        "properties": {
+          "member": {
+            "$ref": "#/components/schemas/ProvisionMemberInput"
+          }
+        },
+        "required": [
+          "member"
+        ],
+        "title": "ProvisionMemberRequest",
+        "type": "object",
+        "x-struct": "Elixir.HablalaApiWeb.Schemas.ProvisionMemberRequest",
+        "x-validate": null
+      },
+      "ProvisionMemberResponse": {
+        "description": "El operador dado de alta. `passwordSetupToken` es el token de un solo uso con el que la persona establece SU contraseña (nunca se le comparte una contraseña generada). `userCreated` indica si el usuario nació con esta alta o ya existía (en cuyo caso su contraseña no se toca).",
+        "properties": {
+          "data": {
+            "properties": {
+              "displayName": {
+                "nullable": true,
+                "type": "string",
+                "x-struct": null,
+                "x-validate": null
+              },
+              "email": {
+                "nullable": true,
+                "type": "string",
+                "x-struct": null,
+                "x-validate": null
+              },
+              "id": {
+                "description": "Id de la membresía (`mbr_…`).",
+                "type": "string",
+                "x-struct": null,
+                "x-validate": null
+              },
+              "passwordSetupToken": {
+                "description": "Token de set-password (un solo uso). Entrégaselo a la persona para que fije su contraseña vía el flujo de reset. NO es una contraseña.",
+                "type": "string",
+                "x-struct": null,
+                "x-validate": null
+              },
+              "roles": {
+                "items": {
+                  "type": "string",
+                  "x-struct": null,
+                  "x-validate": null
+                },
+                "type": "array",
+                "x-struct": null,
+                "x-validate": null
+              },
+              "userCreated": {
+                "description": "`true` si el usuario nació con esta alta; `false` si ya existía.",
+                "type": "boolean",
+                "x-struct": null,
+                "x-validate": null
+              }
+            },
+            "required": [
+              "id",
+              "roles",
+              "passwordSetupToken",
+              "userCreated"
+            ],
+            "type": "object",
+            "x-struct": null,
+            "x-validate": null
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "title": "ProvisionMemberResponse",
+        "type": "object",
+        "x-struct": "Elixir.HablalaApiWeb.Schemas.ProvisionMemberResponse",
+        "x-validate": null
+      },
       "PublicOrganization": {
         "description": "Identidad PÚBLICA del tenant (la org del token) — el paralelo horizontal del `shop`/`brand` de Shopify. Deja al cliente pintar su chrome (nombre, logo) y conocer su `endUserObjectSlug` sin hardcodear la marca. NUNCA incluye la PII legal del negocio.",
         "properties": {
@@ -14528,6 +14633,61 @@
         ]
       }
     },
+    "/v1/invitations": {
+      "post": {
+        "callbacks": {},
+        "description": "Crea una invitación por **email** con un rol opcional (`{\"invitation\": {\"email\": \"…\", \"role_id\": \"role_…\"}}`). Al aceptarla, la persona queda como miembro de la organización y podrá iniciar sesión como operador (member session `mem_…`). La org sale del token (org-less), como el resto de la superficie de máquina. Requiere el permiso `invitations:create` (preset `team_admin`).",
+        "operationId": "post /v1/invitations",
+        "parameters": [],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/InvitationRequest"
+              }
+            }
+          },
+          "description": "Datos de la invitación",
+          "required": false
+        },
+        "responses": {
+          "201": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InvitationResponse"
+                }
+              }
+            },
+            "description": "Invitación creada"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            },
+            "description": "Sin permiso"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            },
+            "description": "Error de validación"
+          }
+        },
+        "summary": "Invitar a un operador por email (bootstrap del equipo, credencial de máquina)",
+        "tags": [
+          "invitations"
+        ]
+      }
+    },
     "/v1/invitations/accept": {
       "post": {
         "callbacks": {},
@@ -16965,6 +17125,61 @@
         ]
       }
     },
+    "/v1/members": {
+      "post": {
+        "callbacks": {},
+        "description": "Crea al operador y su membresía ACTIVA al instante. Devuelve un `passwordSetupToken` para que la persona fije su contraseña (no se comparte ninguna contraseña generada). Requiere `organization_memberships:create` (preset `team_admin`).",
+        "operationId": "post /v1/members",
+        "parameters": [],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ProvisionMemberRequest"
+              }
+            }
+          },
+          "description": "Datos del operador",
+          "required": false
+        },
+        "responses": {
+          "201": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProvisionMemberResponse"
+                }
+              }
+            },
+            "description": "Operador dado de alta"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            },
+            "description": "Sin permiso"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            },
+            "description": "Error de validación"
+          }
+        },
+        "summary": "Dar de alta un operador directo (sin invitación)",
+        "tags": [
+          "members"
+        ]
+      }
+    },
     "/v1/members/me": {
       "get": {
         "callbacks": {},
@@ -31818,6 +32033,39 @@
         ]
       }
     },
+    "/v1/roles": {
+      "get": {
+        "callbacks": {},
+        "operationId": "get /v1/roles",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RolesResponse"
+                }
+              }
+            },
+            "description": "Roles"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            },
+            "description": "Sin permiso"
+          }
+        },
+        "summary": "Listar los roles de la organización (para asignar al invitar)",
+        "tags": [
+          "roles"
+        ]
+      }
+    },
     "/v1/sso/callback": {
       "post": {
         "callbacks": {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hablala/api-contract",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "type": "module",
   "description": "Contrato tipado (OpenAPI → TypeScript) de la API de Hablalá — single source of truth generada desde el backend Elixir.",
   "license": "MIT",
@@ -47,8 +47,8 @@
     "openapi-typescript": "^7.4.0",
     "tsup": "^8.5.1",
     "typescript": "^5.7.2",
-    "@hablala/typescript-config": "0.0.0",
-    "@hablala/eslint-config": "0.0.0"
+    "@hablala/eslint-config": "0.0.0",
+    "@hablala/typescript-config": "0.0.0"
   },
   "scripts": {
     "generate": "openapi-typescript",