@hablala/api-contract 0.6.0 → 0.7.0

package/dist/index.d.ts

@@ -1040,8 +1040,8 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Pedir una URL de subida prefirmada (adjunto personal)
-         * @description Como el presign de organización, pero el blob se namespacea por usuario. El cliente hace `PUT` a `uploadUrl` y referencia `fileUrl` en los adjuntos del mensaje.
+         * Pedir un sobre de subida prefirmado (adjunto personal)
+         * @description Como el presign de organización, pero el blob se namespacea por usuario. Devuelve un sobre auto-descriptivo (`method`/`url`/`fields`/`headers`); el cliente sube según `method` y referencia `fileUrl` en los adjuntos del mensaje.
          */
         post: operations["HablalaApiWeb.Me.UploadController.presign"];
         delete?: never;
@@ -1138,7 +1138,7 @@ interface paths {
         put?: never;
         /**
          * Canjear un grant por un access token (RFC 6749/8628)
-         * @description `grant_type=authorization_code` (loopback + PKCE) o `grant_type=urn:ietf:params:oauth:grant-type:device_code` (polling del device flow). El `access_token` devuelto es un `hpat_…` normal; guárdalo, no se puede recuperar.
+         * @description `grant_type=authorization_code` (loopback + PKCE) o `grant_type=urn:ietf:params:oauth:grant-type:device_code` (polling del device flow). El `access_token` devuelto es un `mat_…` normal; guárdalo, no se puede recuperar.
          */
         post: operations["HablalaApiWeb.Oauth.TokenController.create"];
         delete?: never;
@@ -1241,6 +1241,26 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/objects/{object_slug}/records/trash": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Listar los records borrados (soft) del objeto — la Papelera
+         * @description Lista los records SOFT-DELETED del objeto (`deleted_at IS NOT NULL`), para restaurarlos. Misma lectura gobernada que `POST /query` (RBAC + ABAC por fila + field_mask + paginación keyset), sobre el otro lado de `deleted_at`. Gate RBAC: `records:delete`.
+         */
+        get: operations["HablalaApiWeb.Machine.RecordController.trash"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/objects/{object_slug}/records/{id}": {
         parameters: {
             query?: never;
@@ -1261,6 +1281,26 @@ interface paths {
         patch: operations["HablalaApiWeb.Machine.RecordController.update (2)"];
         trace?: never;
     };
+    "/v1/objects/{object_slug}/records/{record_id}/dependencies": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Preview de dependencias de un record (impacto de borrarlo, sin borrar)
+         * @description Devuelve cuántos edges se desvincularían y qué referencias core BLOQUEARÍAN el borrado (restrict-on-delete), sin mutar nada. Alimenta la confirmación dependent-aware de la UI. Misma fuente que el guard del borrado real, así que preview y borrado no divergen. Gate `records:delete` + ABAC de escritura por fila.
+         */
+        get: operations["HablalaApiWeb.Machine.RecordController.dependencies"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/objects/{object_slug}/records/{record_id}/events": {
         parameters: {
             query?: never;
@@ -1408,7 +1448,7 @@ interface paths {
         put?: never;
         /**
          * Crear un access token
-         * @description Emite una credencial de máquina (`hpat_…`) con la que un agente (Claude Code) o un script CI escribe el modelo de datos 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).
+         * @description Emite una credencial de máquina (`mat_…`) con la que un agente (Claude Code) o un script CI escribe el modelo de datos 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;
@@ -1524,8 +1564,8 @@ interface paths {
         get: operations["HablalaApiWeb.PublicApi.ApiKeyController.index"];
         put?: never;
         /**
-         * Crear una API key
-         * @description Emite una credencial read-only para la Data API. La respuesta incluye el secreto en claro UNA sola vez (`token`); guárdalo, no se puede recuperar. `kind`: public (client-side) o private (server-side).
+         * Crear un par de API keys
+         * @description Emite el **par** de API keys del canal público en una operación: una **publishable** (`pk_`, client-side) y una **secret** (`sk_`, server-side). La respuesta incluye el secreto en claro de AMBAS una sola vez (`publishable.token`/`secret.token`); guárdalos, no se pueden recuperar. Es el flujo del panel: se muestran completos para copiar/pegar en el `.env` de la app cliente. `name` por defecto "Default".
          */
         post: operations["HablalaApiWeb.PublicApi.ApiKeyController.create"];
         delete?: never;
@@ -1554,6 +1594,26 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/organizations/{organization_id}/api-keys/{id}/rotate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Rotar una API key
+         * @description Rota la key (modelo Stripe *roll*): emite un reemplazo del mismo tipo y nombre y revoca la original de inmediato. La respuesta incluye el nuevo secreto en claro UNA sola vez (`token`); guárdalo. Las requests que usaban la key vieja dejan de autenticar.
+         */
+        post: operations["HablalaApiWeb.PublicApi.ApiKeyController.rotate"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/organizations/{organization_id}/appointments": {
         parameters: {
             query?: never;
@@ -2623,7 +2683,7 @@ interface paths {
         put?: never;
         /**
          * Aprobar un login del CLI (device flow)
-         * @description El consent: fija la organización del path y los permisos elegidos (intersectados con los del aprobador) en el grant. El CLI que sondea recibirá su `hpat_…` en el siguiente poll.
+         * @description El consent: fija la organización del path y los permisos elegidos (intersectados con los del aprobador) en el grant. El CLI que sondea recibirá su `mat_…` en el siguiente poll.
          */
         post: operations["HablalaApiWeb.Oauth.GrantController.approve"];
         delete?: never;
@@ -2726,6 +2786,26 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/organizations/{organization_id}/objects/{object_slug}/records/trash": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Listar los records borrados (soft) del objeto — la Papelera
+         * @description Lista los records SOFT-DELETED del objeto (`deleted_at IS NOT NULL`), para restaurarlos. Misma lectura gobernada que `POST /query` (RBAC + ABAC por fila + field_mask + paginación keyset), sobre el otro lado de `deleted_at`. Gate RBAC: `records:delete`.
+         */
+        get: operations["HablalaApiWeb.Data.RecordController.trash"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/organizations/{organization_id}/objects/{object_slug}/records/{id}": {
         parameters: {
             query?: never;
@@ -2746,6 +2826,26 @@ interface paths {
         patch: operations["HablalaApiWeb.Data.RecordController.update (2)"];
         trace?: never;
     };
+    "/v1/organizations/{organization_id}/objects/{object_slug}/records/{record_id}/dependencies": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Preview de dependencias de un record (impacto de borrarlo, sin borrar)
+         * @description Devuelve cuántos edges se desvincularían y qué referencias core BLOQUEARÍAN el borrado (restrict-on-delete), sin mutar nada. Alimenta la confirmación dependent-aware de la UI. Misma fuente que el guard del borrado real, así que preview y borrado no divergen. Gate `records:delete` + ABAC de escritura por fila.
+         */
+        get: operations["HablalaApiWeb.Data.RecordController.dependencies"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/organizations/{organization_id}/objects/{object_slug}/records/{record_id}/events": {
         parameters: {
             query?: never;
@@ -3268,8 +3368,8 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Pedir una URL de subida prefirmada
-         * @description Devuelve una URL prefirmada para subir un archivo directo al object storage. El cliente hace `PUT` del blob a `uploadUrl` y luego referencia `fileUrl` en los adjuntos del mensaje. (El camino personal usa `HablalaApiWeb.Me.UploadController` en `/v1/me/uploads/presign`.)
+         * Pedir un sobre de subida prefirmado
+         * @description Devuelve un sobre auto-descriptivo para subir un archivo directo al object storage. Según `method`: `POST` → form multipart con `fields` + el archivo como campo `file` (S3/R2 POST policy, con tope de tamaño firmado en el borde); `PUT` → PUT del blob a `url` con `headers` (adaptador local de dev). Luego se referencia `fileUrl`. (El camino personal usa `HablalaApiWeb.Me.UploadController` en `/v1/me/uploads/presign`.)
          */
         post: operations["HablalaApiWeb.UploadController.presign"];
         delete?: never;
@@ -3461,6 +3561,26 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/public/me/checkout": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Checkout nativo (crear un pedido)
+         * @description Crea un pedido atómicamente: valida stock por variante, numera (#1001), crea el `order` (source = web, financial_status = pending) + sus renglones con snapshots de precio, y decrementa el inventario. Autenticado por end-user session token; el comprador sale de la sesión (no del cuerpo). Idempotente vía el header `Idempotency-Key`.
+         */
+        post: operations["HablalaApiWeb.PublicApi.CheckoutController.create"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/public/me/objects/{object_slug}/records": {
         parameters: {
             query?: never;
@@ -3613,6 +3733,26 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/public/variants/availability": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Disponibilidad de compra de variantes (Public API)
+         * @description Dado un lote de ids de `product_variant`, devuelve por variante si es comprable (activa y con stock > 0) — el booleano del badge "Agotado". Autenticado por API key. Se expone el booleano derivado, no el conteo de stock.
+         */
+        post: operations["HablalaApiWeb.PublicApi.AvailabilityController.create"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/push-tokens": {
         parameters: {
             query?: never;
@@ -4132,7 +4272,7 @@ interface components {
     schemas: {
         /**
          * AccessToken
-         * @description Metadatos de un access token de máquina (`hpat_…`): la credencial con la que un agente (Claude Code) o un script CI escribe el modelo de datos por HTTP. El secreto en claro NO se incluye aquí — solo se devuelve una vez, al crearlo.
+         * @description Metadatos de un access token de máquina (`mat_…`): la credencial con la que un agente (Claude Code) o un script CI escribe el modelo de datos por HTTP. El secreto en claro NO se incluye aquí — solo se devuelve una vez, al crearlo.
          */
         AccessToken: {
             /** @description ¿Ni revocado ni expirado? */
@@ -4148,7 +4288,7 @@ interface components {
             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`. */
+            /** @description Primeros caracteres del secreto (no secreto), p. ej. `mat_a1b2`. */
             prefix?: string | null;
             /** Format: date-time */
             revokedAt?: string | null;
@@ -4173,7 +4313,7 @@ interface components {
             prefix?: string | null;
             /** Format: date-time */
             revokedAt?: string | null;
-            /** @description El secreto en claro (`hpat_…`). Solo en esta respuesta. */
+            /** @description El secreto en claro (`mat_…`). Solo en esta respuesta. */
             token: string;
             /** Format: date-time */
             updatedAt?: string;
@@ -4208,8 +4348,8 @@ interface components {
              * @description Caducidad opcional (ISO 8601). Omitir = no caduca.
              */
             expiresAt?: string;
-            /** @description Etiqueta para identificarlo en el panel. */
-            name: string;
+            /** @description Etiqueta opcional para el panel. Por defecto: "Default". */
+            name?: string;
             /** @description Permisos RBAC (`recurso:accion`) crudos, p. ej. `["objects:create", "objects:read"]`. Vía avanzada (CI/scripts); la UI usa `preset` en su lugar. */
             permissions?: string[];
             /** @description Clave de un preset de permisos (ver `GET .../access-tokens/presets`), p. ej. `"objects_builder"`. La vía que usa la UI. Si viene, gana sobre `permissions`. */
@@ -4429,6 +4569,8 @@ interface components {
                  */
                 mode?: "authoritative" | "additive";
             };
+            /** @description Los verticales instalables sobre el core horizontal (p. ej. `commerce`, `crm`). El server materializa sus objects (seeded, con su `package`) desde su definición propia; el manifiesto solo declara los NOMBRES. Instalar es idempotente; declarar no desinstala. */
+            packages?: string[];
             policies?: components["schemas"]["ManifestPolicy"][] | {
                 items: components["schemas"]["ManifestPolicy"][];
                 /**
@@ -4666,9 +4808,21 @@ interface components {
         ApiKeyCreatedResponse: {
             data: components["schemas"]["ApiKeyCreated"];
         };
+        /**
+         * ApiKeyPairCreated
+         * @description El par de API keys recién creado: la publishable (`pk_`) y la secret (`sk_`), cada una con su secreto en claro (`token`) presente UNA sola vez. Guárdalos: no se pueden recuperar.
+         */
+        ApiKeyPairCreated: {
+            publishable: components["schemas"]["ApiKeyCreated"];
+            secret: components["schemas"]["ApiKeyCreated"];
+        };
+        /** ApiKeyPairCreatedResponse */
+        ApiKeyPairCreatedResponse: {
+            data: components["schemas"]["ApiKeyPairCreated"];
+        };
         /**
          * ApiKeyRequest
-         * @description Datos para emitir una API key. Todos opcionales (kind por defecto: publishable).
+         * @description Datos para emitir el par de API keys. Todos opcionales: `name` por defecto "Default" (lo comparten ambas keys del par). `kind` solo aplica a la vía avanzada de una sola key.
          */
         ApiKeyRequest: {
             /**
@@ -4677,11 +4831,11 @@ interface components {
              */
             expiresAt?: string;
             /**
-             * @description Por defecto: publishable.
+             * @description Solo vía avanzada (una key). Por defecto: publishable.
              * @enum {string}
              */
             kind?: "publishable" | "secret";
-            /** @description Etiqueta para identificarla en el panel. */
+            /** @description Etiqueta opcional para el panel. Por defecto: "Default". */
             name?: string;
         };
         /** ApiKeysResponse */
@@ -4881,6 +5035,16 @@ interface components {
         AvailabilityRequest: {
             availability: components["schemas"]["AvailabilityInput"];
         };
+        /**
+         * AvailabilityResponse
+         * @description Disponibilidad de compra por variante (patrón Shopify `availableForSale`): un mapa id-público → booleano. `true` = comprable (activa y con stock). Se expone el booleano derivado, no el conteo de stock (mínima exposición).
+         */
+        AvailabilityResponse: {
+            /** @description Mapa `variantId` (`rec_…`) → `true`/`false` (comprable). */
+            availability: {
+                [key: string]: boolean;
+            };
+        };
         /**
          * BanMemberRequest
          * @description Banea a un miembro del grupo (bloqueo, estilo Telegram). Sin `until` = ban permanente; con `until` = ban temporal que expira en esa fecha.
@@ -5050,6 +5214,25 @@ interface components {
                 topic?: string;
             };
         };
+        /**
+         * CheckoutItem
+         * @description Un artículo del checkout: qué variante comprar y cuántas unidades.
+         */
+        CheckoutItem: {
+            /** @description Unidades a comprar (≥ 1). */
+            quantity: number;
+            /** @description Id público (`rec_…`) del `product_variant`. */
+            variantId: string;
+        };
+        /**
+         * CheckoutRequest
+         * @description Checkout nativo: los artículos del carrito + la moneda. El pedido se ata al usuario final identificado por la sesión (`sess_…`), no a un cliente enviado por el cuerpo.
+         */
+        CheckoutRequest: {
+            /** @description Código ISO 4217 (MXN, USD, EUR). */
+            currency: string;
+            items: components["schemas"]["CheckoutItem"][];
+        };
         /**
          * ContactContent
          * @description Payload de un mensaje `contact` (compartir contacto, estilo WhatsApp). El cliente pinta una tarjeta con acción 'Agregar a contactos'. `vcard` es el vCard crudo opcional (fuente de verdad para importar); `name`/`phones` son la vista renderizable.
@@ -5511,6 +5694,26 @@ interface components {
         EventsResponse: {
             data: components["schemas"]["Event"][];
         };
+        /**
+         * FileEnvelope
+         * @description Un archivo dentro del valor de un atributo `data_type: file` (siempre un array de estos, aun para un solo archivo). Solo `url` es obligatoria; el resto es metadata para renderizar sin un HEAD por archivo. La `url` DEBE ser del storage de la plataforma (subida por el flujo de upload prefirmado) — una URL externa se rechaza.
+         */
+        FileEnvelope: {
+            /** @description Placeholder BlurHash de la imagen (preview borroso instantáneo). Null si no es imagen. */
+            blurhash?: string | null;
+            content_type?: string | null;
+            /** @description Duración del medio en milisegundos (audio/video). Permite pintar el reproductor sin descargar. */
+            duration_ms?: number | null;
+            filename?: string | null;
+            /** @description Alto en px. */
+            height?: number | null;
+            /** @description Tamaño en bytes. */
+            size?: number | null;
+            /** @description URL permanente del blob en el object storage (la que devuelve el presign). */
+            url: string;
+            /** @description Ancho en px (para reservar el aspect-ratio y evitar layout shift). */
+            width?: number | null;
+        };
         /** Friend */
         Friend: {
             displayName?: string | null;
@@ -5626,13 +5829,15 @@ interface components {
         };
         /**
          * GraphNode
-         * @description Un nodo del grafo de datos: un record, con su object, su título y su grado.
+         * @description Un nodo del grafo de datos: un record, con su object, su título, su imagen representativa y su grado.
          */
         GraphNode: {
             /** @description Nº de aristas incidentes al nodo (grado). El cliente lo usa para el tamaño. */
             degree: number;
             /** @description Id público del record (`rec_…`). */
             id: string;
+            /** @description URL de la imagen representativa del record (primer atributo file de tipo imagen, respetando el field_mask), o null. El cliente la pinta como avatar del nodo; sin ella, el nodo es el círculo tintado por object. */
+            imageUrl?: string | null;
             /** @description Slug del object del record (para color/navegación). */
             objectSlug: string;
             /** @description Título legible del record (atributo name/nombre/title…), recortado por field_mask. */
@@ -6664,7 +6869,7 @@ interface components {
         };
         /**
          * OauthGrantApproveRequest
-         * @description Aprobación del consent: qué permisos tendrá el token (mismas reglas que emitir un `hpat_` en el panel: `preset` gana, y todo se intersecta con los permisos del aprobador).
+         * @description Aprobación del consent: qué permisos tendrá el token (mismas reglas que emitir un `mat_` en el panel: `preset` gana, y todo se intersecta con los permisos del aprobador).
          */
         OauthGrantApproveRequest: {
             /** @description Permisos crudos `recurso:accion` (vía avanzada). */
@@ -6695,10 +6900,10 @@ interface components {
         };
         /**
          * OauthTokenResponse
-         * @description Éxito del token endpoint (RFC 6749 §5.1): el `access_token` es un `hpat_…` normal (la misma credencial que emite el panel), mostrado UNA sola vez.
+         * @description Éxito del token endpoint (RFC 6749 §5.1): el `access_token` es un `mat_…` normal (la misma credencial que emite el panel), mostrado UNA sola vez.
          */
         OauthTokenResponse: {
-            /** @description El secreto `hpat_…` en claro. */
+            /** @description El secreto `mat_…` en claro. */
             access_token: string;
             /** @description Permisos concedidos, separados por espacio (RFC 6749 §3.3). */
             scope?: string;
@@ -6758,6 +6963,25 @@ interface components {
         ObjectsResponse: {
             data: components["schemas"]["Object"][];
         };
+        /**
+         * OrderLineItem
+         * @description Un renglón del pedido: la variante comprada con snapshots de título/sku/precio (el catálogo puede cambiar después). `id` + `properties` como cualquier record del diccionario.
+         */
+        OrderLineItem: {
+            id: string;
+            /** @description Valores del renglón por slug: `variant_ref`, `product_ref`, `title`, `sku`, `quantity`, `unit_price` (centavos), `line_total` (centavos). */
+            properties: Record<string, never>;
+        };
+        /**
+         * OrderResponse
+         * @description El pedido recién creado por el checkout, con sus renglones. `properties` trae el `order_number` (#1001), `financial_status` (nace `pending`), `fulfillment_status` (nace `unfulfilled`), `total_amount` (centavos), `currency` y `customer`.
+         */
+        OrderResponse: {
+            id: string;
+            lineItems: components["schemas"]["OrderLineItem"][];
+            /** @description Valores del pedido por slug (order_number, financial_status, total_amount…). */
+            properties: Record<string, never>;
+        };
         /** Organization */
         Organization: {
             /** @description Icono de la organización; `null` usa el fallback de iniciales. */
@@ -7011,6 +7235,8 @@ interface components {
             /** @description MIME type del archivo (p. ej. `image/png`). */
             contentType?: string;
             filename: string;
+            /** @description Tope de bytes que el servidor FIRMA en el borde (POST policy `content-length-range`): un cuerpo mayor se rechaza con 413, sin confiar en el cliente. Tómalo del `max_size_bytes` del atributo `file`. */
+            maxSize?: number | null;
             /**
              * @description Uso del archivo. `avatar` restringe el `contentType` a imágenes (perfil de usuario / icono de org). Omitir para adjuntos genéricos.
              * @enum {string|null}
@@ -7021,20 +7247,48 @@ interface components {
         PresignResponse: {
             data: components["schemas"]["PresignResult"];
         };
-        /** PresignResult */
+        /**
+         * PresignResult
+         * @description Sobre de subida auto-descriptivo. El cliente OBEDECE `method`: `POST` → arma un form multipart con TODOS los `fields` y añade el archivo como el campo `file` al final, luego hace POST a `url`; `PUT` → hace PUT del blob crudo a `url` con `headers`. En ambos, `fileUrl` es la URL final del blob.
+         */
         PresignResult: {
-            /** @description URL final del blob; va en el `attachment` del mensaje. */
+            /** @description Campos del form multipart a enviar ANTES del archivo (POST policy: `key`, `Content-Type`, `Policy`, firma…). Vacío cuando `method` es `PUT`. */
+            fields?: {
+                [key: string]: string;
+            };
+            /** @description URL final del blob; va en el `attachment` del mensaje o el atributo `file`. */
             fileUrl: string;
-            /** @description Cabeceras que el cliente debe enviar en el PUT. */
-            headers?: Record<string, never>;
-            /** @enum {string} */
-            method: "PUT";
-            /** @description Destino del PUT del blob. */
-            uploadUrl: string;
+            /** @description Cabeceras que el cliente envía en el `PUT`. Vacío cuando `method` es `POST`. */
+            headers?: {
+                [key: string]: string;
+            };
+            /**
+             * @description Cómo subir: `POST` (form multipart, POST policy) o `PUT` (blob directo).
+             * @enum {string}
+             */
+            method: "POST" | "PUT";
+            /** @description Destino de la subida. */
+            url: string;
+        };
+        /**
+         * 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.
+         */
+        PublicOrganization: {
+            /** @description Logo/icono de la marca (el "server icon" del tenant), o `null`. */
+            avatarUrl?: string | null;
+            /** @description ID público de la organización. */
+            id: string;
+            /** @description Nombre visible de la marca. */
+            name: string;
+            settings: components["schemas"]["ManifestSettings"];
+            /** @description Slug estable de la organización. */
+            slug: string;
         };
         /** PublicSchema */
         PublicSchema: {
             objects: components["schemas"]["PublicSchemaObject"][];
+            organization: components["schemas"]["PublicOrganization"];
             relationships: components["schemas"]["PublicSchemaRelationship"][];
         };
         /**
@@ -7204,7 +7458,10 @@ interface components {
             /** Format: date-time */
             insertedAt?: string;
             objectId?: string;
-            properties: Record<string, never>;
+            /** @description Mapa slug→valor. El valor de un atributo `data_type: file` es un array de `FileEnvelope`; el resto de tipos son escalares/arrays/objetos según el `data_type` del atributo. */
+            properties: {
+                [key: string]: components["schemas"]["FileEnvelope"][] | string | number | boolean | string[] | Record<string, never>;
+            };
             /** @description Labels de los records referenciados por las columnas `reference`: un mapa id-público-destino (`rec_…`) → `{label, objectSlug}` del record enlazado (su primary field + su object slug para enlazar a la ficha). Presente solo si el record tiene references resueltas. Homogéneo con `QueryResultRow.referenceLabels`. */
             referenceLabels?: {
                 [key: string]: {
@@ -7215,9 +7472,27 @@ interface components {
             /** Format: date-time */
             updatedAt?: string;
         };
+        /**
+         * RecordDependencies
+         * @description Preview del impacto de borrar un record, SIN borrarlo (confirmación dependent-aware, patrón Salesforce/Notion). `edgeCount` = relaciones del grafo que se desvincularían (el vecino sobrevive). `blockers` = referencias core activas que IMPEDIRÍAN el borrado (restrict-on-delete); `deletable: false` si hay alguna.
+         */
+        RecordDependencies: {
+            data: {
+                /** @description Referencias core activas que bloquean; vacía si se puede borrar. */
+                blockers: {
+                    count: number;
+                    /** @description Etiqueta legible (p. ej. "facturas sin cerrar"). */
+                    label: string;
+                }[];
+                /** @description `false` si algún blocker impediría el borrado. */
+                deletable: boolean;
+                /** @description Aristas del grafo (ambos extremos) que se romperían al borrar. */
+                edgeCount: number;
+            };
+        };
         /** RecordInput */
         RecordInput: {
-            /** @description Mapa slug→valor validado contra el diccionario. Un atributo `reference` acepta el id público del record destino (`"rec_…"`) o, como azúcar de DX, una **referencia por clave de negocio**: `{"$ref": {"<attr>": <valor>}}`, donde `<attr>` es un atributo único del objeto destino (p. ej. `{"$ref": {"sku": "DRM-VITC-30"}}`). Se resuelve al `rec_…` en el servidor — útil para sincronizar por external id sin conocer el id de Hablalá (patrón Salesforce/Airtable). */
+            /** @description Mapa slug→valor validado contra el diccionario. Un atributo `reference` acepta el id público del record destino (`"rec_…"`) o, como azúcar de DX, una **referencia por clave de negocio**: `{"$ref": {"<attr>": <valor>}}`, donde `<attr>` es un atributo único del objeto destino (p. ej. `{"$ref": {"sku": "DRM-VITC-30"}}`). Se resuelve al `rec_…` en el servidor — útil para sincronizar por external id sin conocer el id de Hablalá (patrón Salesforce/Airtable). Un atributo `data_type: file` toma un array de `FileEnvelope`: la `url` de cada archivo debe venir del flujo de upload prefirmado (una URL externa se rechaza). */
             properties: Record<string, never>;
         };
         /** RecordRequest */
@@ -7652,6 +7927,13 @@ interface components {
         UsernameAvailableResponse: {
             data: components["schemas"]["UsernameAvailability"];
         };
+        /**
+         * VariantAvailabilityRequest
+         * @description Los ids públicos (`rec_…`) de las variantes cuya disponibilidad de compra se consulta (una llamada resuelve toda una página de catálogo).
+         */
+        VariantAvailabilityRequest: {
+            variantIds: string[];
+        };
         /** VerificationRejectRequest */
         VerificationRejectRequest: {
             /** @description Motivo legible del rechazo (se muestra al negocio). */
@@ -9825,7 +10107,7 @@ interface operations {
             };
         };
         responses: {
-            /** @description URL prefirmada */
+            /** @description Sobre de subida prefirmado */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -10379,6 +10661,49 @@ interface operations {
             };
         };
     };
+    "HablalaApiWeb.Machine.RecordController.trash": {
+        parameters: {
+            query?: {
+                limit?: number;
+                cursor?: string;
+            };
+            header?: never;
+            path: {
+                object_slug: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Records borrados */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["QueryResultResponse"];
+                };
+            };
+            /** @description Sin permiso */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Objeto desconocido */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     "HablalaApiWeb.Machine.RecordController.show": {
         parameters: {
             query?: never;
@@ -10569,6 +10894,47 @@ interface operations {
             };
         };
     };
+    "HablalaApiWeb.Machine.RecordController.dependencies": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                object_slug: string;
+                record_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Dependencias */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RecordDependencies"];
+                };
+            };
+            /** @description Sin permiso ABAC sobre este record */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description No encontrado (o de otro objeto) */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     "HablalaApiWeb.Machine.EventController.index": {
         parameters: {
             query?: never;
@@ -11311,20 +11677,20 @@ interface operations {
             };
             cookie?: never;
         };
-        /** @description Datos del token */
+        /** @description Datos del par */
         requestBody?: {
             content: {
                 "application/json": components["schemas"]["ApiKeyRequest"];
             };
         };
         responses: {
-            /** @description Token creado (con secreto) */
+            /** @description Par creado (con secretos) */
             201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ApiKeyCreatedResponse"];
+                    "application/json": components["schemas"]["ApiKeyPairCreatedResponse"];
                 };
             };
             /** @description Sin permiso */
@@ -11377,6 +11743,38 @@ interface operations {
             };
         };
     };
+    "HablalaApiWeb.PublicApi.ApiKeyController.rotate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                organization_id: string;
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Key rotada (nuevo secreto) */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiKeyCreatedResponse"];
+                };
+            };
+            /** @description Sin permiso */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     "HablalaApiWeb.Scheduling.AppointmentController.index": {
         parameters: {
             query?: {
@@ -14573,6 +14971,50 @@ interface operations {
             };
         };
     };
+    "HablalaApiWeb.Data.RecordController.trash": {
+        parameters: {
+            query?: {
+                limit?: number;
+                cursor?: string;
+            };
+            header?: never;
+            path: {
+                organization_id: string;
+                object_slug: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Records borrados */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["QueryResultResponse"];
+                };
+            };
+            /** @description Sin permiso */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Objeto desconocido */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     "HablalaApiWeb.Data.RecordController.show": {
         parameters: {
             query?: never;
@@ -14767,6 +15209,48 @@ interface operations {
             };
         };
     };
+    "HablalaApiWeb.Data.RecordController.dependencies": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                organization_id: string;
+                object_slug: string;
+                record_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Dependencias */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RecordDependencies"];
+                };
+            };
+            /** @description Sin permiso ABAC sobre este record */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description No encontrado (o de otro objeto) */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     "HablalaApiWeb.Data.EventController.index": {
         parameters: {
             query?: never;
@@ -16349,7 +16833,7 @@ interface operations {
             };
         };
         responses: {
-            /** @description URL prefirmada */
+            /** @description Sobre de subida prefirmado */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -17021,6 +17505,70 @@ interface operations {
             };
         };
     };
+    "HablalaApiWeb.PublicApi.CheckoutController.create": {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Clave de idempotencia (estándar Stripe): dos envíos con la misma → un pedido. */
+                "Idempotency-Key"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Artículos del carrito + moneda */
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["CheckoutRequest"];
+            };
+        };
+        responses: {
+            /** @description Pedido creado */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OrderResponse"];
+                };
+            };
+            /** @description Sesión anónima o token inválido */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description El ABAC no permite crear pedidos */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Sin stock suficiente para una variante */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Carrito inválido */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     "HablalaApiWeb.PublicApi.RecordController.create (2)": {
         parameters: {
             query?: never;
@@ -17589,6 +18137,49 @@ interface operations {
             };
         };
     };
+    "HablalaApiWeb.PublicApi.AvailabilityController.create": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Ids de variante */
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["VariantAvailabilityRequest"];
+            };
+        };
+        responses: {
+            /** @description Disponibilidad por variante */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AvailabilityResponse"];
+                };
+            };
+            /** @description Token inválido */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Petición inválida */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     "HablalaApiWeb.Notifications.PushTokenController.create": {
         parameters: {
             query?: never;