@hablala/api-contract 0.1.2 → 0.1.3

package/dist/index.d.ts

@@ -43,6 +43,46 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/invite-links/accept": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Canjear un link de invitación
+         * @description Canjea el secreto de un workspace invite link para unirse a la organización con el rol configurado en el link. A diferencia de la invitación por email, no requiere email-match: el link es el secreto.
+         */
+        post: operations["HablalaApiWeb.Orgs.InviteLinkController.accept"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/invite-links/preview": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Previsualizar un link de invitación
+         * @description Devuelve la organización (nombre + icono) a la que lleva un workspace invite link, sin consumirlo ni requerir sesión. Sirve para mostrar a dónde te unes en `/join` antes de confirmar. Siempre 200: el `status` del cuerpo distingue `valid` de `invalid`.
+         */
+        get: operations["HablalaApiWeb.Orgs.InviteLinkController.preview"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/organizations": {
         parameters: {
             query?: never;
@@ -81,6 +121,50 @@ interface paths {
         patch: operations["HablalaApiWeb.Orgs.OrganizationController.update (2)"];
         trace?: never;
     };
+    "/v1/organizations/{organization_id}/access-tokens": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Listar access tokens
+         * @description Los access tokens de máquina de la organización (solo metadatos; el secreto no se recupera).
+         */
+        get: operations["HablalaApiWeb.AccessTokens.TokenController.index"];
+        put?: never;
+        /**
+         * Crear un access token
+         * @description Emite una credencial de máquina (`hpat_…`) con la que un agente (Claude Code / Lá) o un script CI escribe la ontología por HTTP. La respuesta incluye el secreto en claro UNA sola vez (`token`); guárdalo, no se puede recuperar. Los permisos se intersectan con los del creador (un token nunca puede más que quien lo emite).
+         */
+        post: operations["HablalaApiWeb.AccessTokens.TokenController.create"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/organizations/{organization_id}/access-tokens/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Revocar un access token
+         * @description Revoca la credencial (irreversible). Las requests que la usen dejan de autenticar.
+         */
+        delete: operations["HablalaApiWeb.AccessTokens.TokenController.delete"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/organizations/{organization_id}/conversations": {
         parameters: {
             query?: never;
@@ -363,6 +447,26 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/organizations/{organization_id}/invitations/bulk": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Invitar a varios emails a la vez
+         * @description Crea (o reenvía) invitaciones para una lista de emails, todos con el mismo rol opcional. No es todo-o-nada: cada email se procesa aparte y su resultado se refleja por separado (`sent` / `already` / `invalid`).
+         */
+        post: operations["HablalaApiWeb.Orgs.InvitationController.bulk"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/organizations/{organization_id}/invitations/{id}": {
         parameters: {
             query?: never;
@@ -381,6 +485,47 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/organizations/{organization_id}/invite-link": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Obtener el link de invitación de la org
+         * @description Devuelve el link activo, creándolo si no existe (lazy). El secreto en claro (`url`) solo viaja cuando se acaba de crear; en llamadas siguientes se devuelve el link sin el claro (que no se puede recuperar).
+         */
+        get: operations["HablalaApiWeb.Orgs.InviteLinkController.show"];
+        put?: never;
+        post?: never;
+        /** Revocar el link de invitación */
+        delete: operations["HablalaApiWeb.Orgs.InviteLinkController.delete"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/organizations/{organization_id}/invite-link/rotate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Rotar el link de invitación
+         * @description Revoca el link activo (si hay) y crea uno nuevo. El secreto anterior deja de canjear al instante; el nuevo claro (`url`) viaja en la respuesta.
+         */
+        post: operations["HablalaApiWeb.Orgs.InviteLinkController.rotate"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/organizations/{organization_id}/memberships": {
         parameters: {
             query?: never;
@@ -1162,6 +1307,77 @@ interface paths {
 }
 interface components {
     schemas: {
+        /**
+         * AccessToken
+         * @description Metadatos de un access token de máquina (`hpat_…`): la credencial con la que un agente (Claude Code / Lá) o un script CI escribe la ontología por HTTP. El secreto en claro NO se incluye aquí — solo se devuelve una vez, al crearlo.
+         */
+        AccessToken: {
+            /** @description ¿Ni revocado ni expirado? */
+            active: boolean;
+            /** Format: date-time */
+            expiresAt?: string | null;
+            id: string;
+            /** Format: date-time */
+            insertedAt?: string;
+            /** Format: date-time */
+            lastUsedAt?: string | null;
+            /** @description Etiqueta para el panel (p. ej. "CI deploy"). */
+            name: string;
+            /** @description Permisos RBAC del token (`recurso:accion`), su propio scope (mínimo privilegio). */
+            permissions: string[];
+            /** @description Primeros caracteres del secreto (no secreto), p. ej. `hpat_a1b2`. */
+            prefix?: string | null;
+            /** Format: date-time */
+            revokedAt?: string | null;
+            /** Format: date-time */
+            updatedAt?: string;
+        };
+        /**
+         * AccessTokenCreated
+         * @description El token recién creado, con el secreto en claro (`token`) presente UNA sola vez. Guárdalo: no se puede recuperar después.
+         */
+        AccessTokenCreated: {
+            active?: boolean;
+            /** Format: date-time */
+            expiresAt?: string | null;
+            id: string;
+            /** Format: date-time */
+            insertedAt?: string;
+            /** Format: date-time */
+            lastUsedAt?: string | null;
+            name: string;
+            permissions: string[];
+            prefix?: string | null;
+            /** Format: date-time */
+            revokedAt?: string | null;
+            /** @description El secreto en claro (`hpat_…`). Solo en esta respuesta. */
+            token: string;
+            /** Format: date-time */
+            updatedAt?: string;
+        };
+        /** AccessTokenCreatedResponse */
+        AccessTokenCreatedResponse: {
+            data: components["schemas"]["AccessTokenCreated"];
+        };
+        /**
+         * AccessTokenRequest
+         * @description Datos para emitir un access token. Los permisos se intersectan con los del creador (privilege de-escalation): un token nunca puede más que quien lo emite.
+         */
+        AccessTokenRequest: {
+            /**
+             * Format: date-time
+             * @description Caducidad opcional (ISO 8601). Omitir = no caduca.
+             */
+            expiresAt?: string;
+            /** @description Etiqueta para identificarlo en el panel. */
+            name: string;
+            /** @description Permisos RBAC (`recurso:accion`), p. ej. `["objects:create", "objects:read"]`. */
+            permissions: string[];
+        };
+        /** AccessTokensResponse */
+        AccessTokensResponse: {
+            data: components["schemas"]["AccessToken"][];
+        };
         /**
          * AddMemberRequest
          * @description Añade un usuario del tenant a una conversación (invitar a un canal).
@@ -1231,6 +1447,30 @@ interface components {
         AttributesResponse: {
             data: components["schemas"]["Attribute"][];
         };
+        /**
+         * BulkInvitationRequest
+         * @description Invita a varios emails a la vez, todos con el mismo rol opcional.
+         */
+        BulkInvitationRequest: {
+            /** @description Lista de emails a invitar. Duplicados y vacíos se ignoran. */
+            emails: string[];
+            /** @description Rol que recibirán los invitados (opcional; id público `role_…`). */
+            role_id?: string | null;
+        };
+        /**
+         * BulkInvitationResponse
+         * @description Un resultado por email de entrada, en el mismo orden.
+         */
+        BulkInvitationResponse: {
+            data: {
+                email: string;
+                /**
+                 * @description `sent` (invitación creada/reenviada), `already` (ya es miembro), `invalid` (email mal formado o falló al persistir).
+                 * @enum {string}
+                 */
+                status: "sent" | "already" | "invalid";
+            }[];
+        };
         /** ChannelRequest */
         ChannelRequest: {
             channel: {
@@ -1479,6 +1719,58 @@ interface components {
         InvitationsResponse: {
             data: components["schemas"]["Invitation"][];
         };
+        /**
+         * InviteLink
+         * @description Workspace invite link de una organización. El secreto en claro (`token`/`url`) solo está presente al crearlo o rotarlo; en un `show` posterior es `null`.
+         */
+        InviteLink: {
+            /**
+             * Format: date-time
+             * @description Caducidad opcional; `null` = no caduca.
+             */
+            expiresAt?: string | null;
+            id: string;
+            /** Format: date-time */
+            insertedAt?: string;
+            /** @description Primeros caracteres del secreto (`invl_a1b2…`), para mostrar sin el claro. */
+            prefix?: string | null;
+            /** @description Rol con el que entra quien canjea el link. */
+            role?: {
+                id?: string;
+                name?: string;
+            } | null;
+            /** @description Secreto en claro (`invl_…`). Presente SOLO al crear/rotar. */
+            token?: string | null;
+            /** Format: date-time */
+            updatedAt?: string;
+            /** @description URL compartible (`/join?token=…`). Presente SOLO al crear/rotar. */
+            url?: string | null;
+        };
+        /** InviteLinkAcceptRequest */
+        InviteLinkAcceptRequest: {
+            /** @description Secreto del link (`invl_…`) a canjear. */
+            token: string;
+        };
+        /**
+         * InviteLinkPreviewResponse
+         * @description Datos públicos de un invite link para mostrar a qué organización lleva.
+         */
+        InviteLinkPreviewResponse: {
+            data: {
+                /** @description Icono del workspace; `null` usa el fallback de iniciales. */
+                organizationAvatarUrl?: string | null;
+                organizationName?: string | null;
+                /**
+                 * @description `valid` (se puede unir) o `invalid` (revocado/caducado/inexistente).
+                 * @enum {string}
+                 */
+                status: "valid" | "invalid";
+            };
+        };
+        /** InviteLinkResponse */
+        InviteLinkResponse: {
+            data: components["schemas"]["InviteLink"];
+        };
         /**
          * LogicalQueryRequest
          * @description Consulta lógica con slugs del diccionario. Ver docs/04-query-engine.
@@ -2356,6 +2648,71 @@ interface operations {
             };
         };
     };
+    "HablalaApiWeb.Orgs.InviteLinkController.accept": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Secreto del link */
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["InviteLinkAcceptRequest"];
+            };
+        };
+        responses: {
+            /** @description Membresía creada */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MembershipResponse"];
+                };
+            };
+            /** @description Link inválido, revocado o caducado */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Ya eres miembro */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "HablalaApiWeb.Orgs.InviteLinkController.preview": {
+        parameters: {
+            query: {
+                token: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Datos del link */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InviteLinkPreviewResponse"];
+                };
+            };
+        };
+    };
     "HablalaApiWeb.Orgs.OrganizationController.index": {
         parameters: {
             query?: never;
@@ -2533,6 +2890,103 @@ interface operations {
             };
         };
     };
+    "HablalaApiWeb.AccessTokens.TokenController.index": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                organization_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Tokens */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AccessTokensResponse"];
+                };
+            };
+        };
+    };
+    "HablalaApiWeb.AccessTokens.TokenController.create": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                organization_id: string;
+            };
+            cookie?: never;
+        };
+        /** @description Datos del token */
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["AccessTokenRequest"];
+            };
+        };
+        responses: {
+            /** @description Token creado (con secreto) */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AccessTokenCreatedResponse"];
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
+    "HablalaApiWeb.AccessTokens.TokenController.delete": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                organization_id: string;
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Revocado */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Sin permiso */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     "HablalaApiWeb.Messaging.ConversationController.index": {
         parameters: {
             query?: never;
@@ -3321,6 +3775,51 @@ interface operations {
             };
         };
     };
+    "HablalaApiWeb.Orgs.InvitationController.bulk": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                organization_id: string;
+            };
+            cookie?: never;
+        };
+        /** @description Emails a invitar */
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["BulkInvitationRequest"];
+            };
+        };
+        responses: {
+            /** @description Resultado por email */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BulkInvitationResponse"];
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
     "HablalaApiWeb.Orgs.InvitationController.show": {
         parameters: {
             query?: never;
@@ -3383,6 +3882,97 @@ interface operations {
             };
         };
     };
+    "HablalaApiWeb.Orgs.InviteLinkController.show": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                organization_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Link de invitación */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InviteLinkResponse"];
+                };
+            };
+            /** @description Sin permiso */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "HablalaApiWeb.Orgs.InviteLinkController.delete": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                organization_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Revocado (idempotente: sin link activo también responde 204) */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Sin permiso */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "HablalaApiWeb.Orgs.InviteLinkController.rotate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                organization_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Link rotado */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InviteLinkResponse"];
+                };
+            };
+            /** @description Sin permiso */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     "HablalaApiWeb.Orgs.MembershipController.index": {
         parameters: {
             query?: never;