@utilia-os/sdk-js 1.7.0 → 2.1.0

package/dist/index.d.mts

@@ -102,10 +102,25 @@ interface LoginUrlResult {
     /** Valor de state para protección CSRF */
     state: string;
 }
+/**
+ * Opciones OIDC extendidas aceptadas por getLoginUrl() y loginWithPopup().
+ */
+interface OidcAuthorizationOptions {
+    /** Parámetro `prompt` de OIDC Core 1.0 §3.1.2.1. */
+    prompt?: 'none' | 'login' | 'consent' | 'select_account';
+    /** Sugerencia de email o identificador de usuario para el login. */
+    loginHint?: string;
+    /** Nonce para prevenir replay attacks en el ID token. */
+    nonce?: string;
+    /** Resource Indicator (RFC 8707) del token resultante. */
+    resource?: string;
+    /** Tiempo máximo en segundos desde la última autenticación activa. */
+    maxAge?: number;
+}
 /**
  * Opciones para inicio de sesión OAuth mediante ventana emergente
  */
-interface PopupLoginOptions {
+interface PopupLoginOptions extends OidcAuthorizationOptions {
     /** Parámetro state personalizado para protección CSRF */
     state?: string;
     /** Scopes a solicitar */
@@ -116,6 +131,35 @@ interface PopupLoginOptions {
     height?: number;
     /** Tiempo límite en milisegundos antes de rechazar (por defecto: 300000 = 5 min) */
     timeout?: number;
+    /** Tema de la pantalla de consentimiento: 'light' o 'dark'. Si no se indica, usa la preferencia del usuario. */
+    theme?: 'light' | 'dark';
+}
+/**
+ * Respuesta de introspección de token (RFC 7662 §2.2).
+ */
+interface IntrospectResponse {
+    active: boolean;
+    scope?: string;
+    client_id?: string;
+    username?: string;
+    token_type?: string;
+    exp?: number;
+    iat?: number;
+    sub?: string;
+    aud?: string;
+    iss?: string;
+}
+/**
+ * Datos de una aplicación OAuth autorizada por el usuario.
+ */
+interface AuthorizedApp {
+    clientId: string;
+    clientName: string;
+    clientUri: string | null;
+    logoUri: string | null;
+    scope: string;
+    authorizedAt: string;
+    lastUsedAt: string | null;
 }
 
 /**
@@ -139,12 +183,26 @@ interface UtiliaSDKConfig {
 interface RequestConfig {
     headers?: Record<string, string>;
     params?: Record<string, unknown>;
+    /**
+     * Tipo esperado de la respuesta. Util para descargas binarias (PDF, CSV).
+     * Internamente mapea al `responseType` de Axios.
+     */
+    responseType?: 'json' | 'arraybuffer' | 'blob' | 'text';
 }
 
 /**
  * Servicio OAuth 2.1 con PKCE para el SDK de UTILIA OS
  */
 
+/**
+ * Opciones comunes para construir la URL de autorización.
+ */
+interface AuthorizationUrlOptions extends OidcAuthorizationOptions {
+    state?: string;
+    scopes?: string[];
+    /** Tema de la pantalla de consentimiento: 'light' o 'dark'. */
+    theme?: 'light' | 'dark';
+}
 /**
  * Servicio que gestiona el flujo OAuth 2.1 con PKCE
  */
@@ -155,6 +213,8 @@ declare class OAuthService {
     private readonly http;
     /** Estado PKCE en memoria como fallback cuando el storage no soporta pendingState */
     private _pendingState;
+    /** Promesa de refresco en curso para deduplicar llamadas concurrentes. */
+    private _refreshInFlight;
     constructor(baseURL: string, config: OAuthConfig);
     /**
      * Genera la URL de autorización OAuth con PKCE y almacena el estado
@@ -162,26 +222,20 @@ declare class OAuthService {
      *
      * Este es el método recomendado para la mayoría de los casos.
      *
-     * @param options - Opciones adicionales (state personalizado, scopes)
+     * @param options - Opciones adicionales (state personalizado, scopes, parámetros OIDC)
      * @returns URL de autorización lista para redirigir al usuario
      */
-    getAuthorizationUrl(options?: {
-        state?: string;
-        scopes?: string[];
-    }): Promise<string>;
+    getAuthorizationUrl(options?: AuthorizationUrlOptions): Promise<string>;
     /**
      * Genera la URL de inicio de sesión OAuth con PKCE.
      *
      * Método de control manual: devuelve codeVerifier y state que el desarrollador
      * debe gestionar. Para un flujo automático, usar getAuthorizationUrl() en su lugar.
      *
-     * @param options - Opciones adicionales (state personalizado, scopes)
-     * @returns URL de autorización, code_verifier y state
+     * Soporta los parámetros OIDC Core 1.0 §3.1.2.1: prompt, loginHint, nonce,
+     * maxAge y el Resource Indicator (RFC 8707) mediante el campo resource.
      */
-    getLoginUrl(options?: {
-        state?: string;
-        scopes?: string[];
-    }): Promise<LoginUrlResult>;
+    getLoginUrl(options?: AuthorizationUrlOptions): Promise<LoginUrlResult>;
     /**
      * Abre una ventana emergente para inicio de sesión OAuth y devuelve tokens al completarse.
      *
@@ -203,7 +257,13 @@ declare class OAuthService {
      */
     handleCallback(code: string, codeVerifier?: string, callbackState?: string): Promise<OAuthTokens>;
     /**
-     * Refresca el token de acceso usando el refresh_token
+     * Refresca el token de acceso usando el refresh_token.
+     *
+     * Deduplica peticiones concurrentes mediante una promesa cacheada: si dos
+     * llamadas entran a la vez, comparten la misma petición HTTP. Esto es
+     * imprescindible porque el backend implementa rotación de refresh tokens con
+     * detección de reuso; dos refresh concurrentes con el mismo token producirían
+     * una invalidación inmediata de toda la cadena.
      *
      * @returns Nuevos tokens OAuth
      * @throws Error si no hay refresh_token disponible
@@ -216,12 +276,39 @@ declare class OAuthService {
      */
     getUserInfo(): Promise<OAuthUserInfo>;
     /**
-     * Revoca el token actual
+     * Revoca el token actual almacenado y limpia el storage.
      *
-     * @param tokenType - Tipo de token a revocar ('access_token' | 'refresh_token').
+     * @param tokenType - Tipo de token a revocar (`access_token` o `refresh_token`).
      *                     Por defecto revoca el access_token.
      */
     revokeToken(tokenType?: 'access_token' | 'refresh_token'): Promise<void>;
+    /**
+     * Revoca un token arbitrario contra el endpoint `/oauth/revoke` (RFC 7009).
+     * A diferencia de `revokeToken()`, no toca el almacenamiento local.
+     *
+     * @param token - Token a revocar (access token o refresh token).
+     * @param tokenTypeHint - Pista opcional sobre el tipo de token.
+     */
+    revoke(token: string, tokenTypeHint?: 'access_token' | 'refresh_token'): Promise<void>;
+    /**
+     * Introspecciona un token contra `/oauth/introspect` (RFC 7662).
+     * Requiere que el cliente esté autenticado (client_secret o public con PKCE).
+     *
+     * @param token - Token a introspeccionar.
+     * @param tokenTypeHint - Pista opcional sobre el tipo de token.
+     * @returns Estado y metadatos del token.
+     */
+    introspect(token: string, tokenTypeHint?: 'access_token' | 'refresh_token'): Promise<IntrospectResponse>;
+    /**
+     * Lista las aplicaciones OAuth autorizadas por el usuario actual.
+     * Requiere un access token válido.
+     */
+    getAuthorizedApps(): Promise<AuthorizedApp[]>;
+    /**
+     * Revoca el acceso de una aplicación OAuth concreta del usuario actual.
+     * Todos los tokens emitidos para esa aplicación quedan invalidados.
+     */
+    revokeApp(clientId: string): Promise<void>;
     /**
      * Obtiene un access token válido, refrescándolo automáticamente si ha expirado
      *
@@ -731,6 +818,877 @@ interface ErrorStats {
     }>;
 }
 
+/**
+ * Tipos relacionados con presupuestos (CRM Budgets)
+ *
+ * Expuestos por la API REST bajo `/api/crm/budgets` y `/api/crm/budget-templates`.
+ */
+
+/** Estado del presupuesto. */
+type BudgetStatus = 'DRAFT' | 'SENT' | 'APPROVED' | 'REJECTED' | 'EXPIRED' | 'CANCELLED';
+/** Tipo de linea en el presupuesto. */
+type BudgetItemType = 'ITEM' | 'SERVICE' | 'SECTION_HEADER';
+/** Tipo semantico de seccion. */
+type BudgetSectionType = 'INTRO' | 'INFO' | 'SCOPE' | 'TIMELINE' | 'COSTS' | 'PAYMENT' | 'CUSTOM' | 'RICH_HTML';
+/** Posicion de la seccion respecto a la tabla de items. */
+type BudgetSectionPosition = 'BEFORE_ITEMS' | 'AFTER_ITEMS';
+/** Metodo de pago propuesto. */
+type PaymentMethod = 'TRANSFER' | 'CASH' | 'CARD' | 'CHECK' | 'OTHER';
+/** Quien aprueba o rechaza un presupuesto. */
+type ApproverType = 'INTERNAL' | 'CLIENT';
+/** Operaciones soportadas por el endpoint de masivos. */
+type BulkBudgetOperation = 'delete' | 'cancel' | 'change-status';
+/** Orden ascendente o descendente. */
+type SortOrder = 'asc' | 'desc';
+/** DTO para anyadir un item al presupuesto. */
+interface CreateBudgetItemInput {
+    /** UUID opcional. Se genera si no se indica. */
+    id?: string;
+    /** Tipo de linea. Por defecto ITEM. */
+    type?: BudgetItemType;
+    /** Nombre visible en el PDF. */
+    name: string;
+    /** Descripcion detallada (acepta texto plano). */
+    description?: string;
+    /** Codigo interno del item. */
+    code?: string;
+    /** Cantidad (por defecto 1). */
+    quantity: number;
+    /** Precio unitario sin impuestos. */
+    unitPrice: number;
+    /** Descuento aplicado al item en porcentaje (0-100). */
+    discount?: number;
+    /** Tasa impositiva del item en porcentaje (IVA/IGIC). */
+    taxRate?: number;
+    /** Coste interno (no visible para el cliente). */
+    internalCost?: number;
+    /** Orden de aparicion. */
+    order?: number;
+    /** Metadatos adicionales. */
+    metadata?: Record<string, unknown>;
+}
+/** DTO parcial para actualizar un item existente. */
+type UpdateBudgetItemInput = Partial<Omit<CreateBudgetItemInput, 'id'>>;
+/** Item de presupuesto devuelto por la API. */
+interface BudgetItem {
+    id: string;
+    budgetId: string;
+    type: BudgetItemType;
+    name: string;
+    description?: string | null;
+    code?: string | null;
+    quantity: number;
+    unitPrice: number;
+    discount: number;
+    taxRate: number;
+    /** Subtotal calculado: quantity * unitPrice - descuento. */
+    subtotal: number;
+    /** Coste interno; solo presente si el usuario tiene permiso. */
+    internalCost?: number | null;
+    order: number;
+    metadata?: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Pareja id + order para reordenar items. */
+interface BudgetItemOrder {
+    id: string;
+    order: number;
+}
+interface ReorderItemsInput {
+    items: BudgetItemOrder[];
+}
+/** DTO para anyadir una seccion al presupuesto. */
+interface CreateBudgetSectionInput {
+    id?: string;
+    /** Tipo semantico. Por defecto CUSTOM. */
+    type?: BudgetSectionType;
+    /** Posicion respecto a los items. Por defecto BEFORE_ITEMS. */
+    position?: BudgetSectionPosition;
+    /** Titulo visible de la seccion. */
+    title: string;
+    /** Contenido HTML/Markdown. En RICH_HTML se renderiza como imagen en el PDF. */
+    content?: string;
+    order?: number;
+    metadata?: Record<string, unknown>;
+}
+type UpdateBudgetSectionInput = Partial<Omit<CreateBudgetSectionInput, 'id'>>;
+interface BudgetSection {
+    id: string;
+    budgetId: string;
+    type: BudgetSectionType;
+    position: BudgetSectionPosition;
+    title: string;
+    content?: string | null;
+    order: number;
+    metadata?: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ReorderSectionsInput {
+    /** UUIDs de las secciones en el nuevo orden deseado. */
+    sectionIds: string[];
+}
+interface BudgetApproval {
+    id: string;
+    budgetId: string;
+    action: 'APPROVED' | 'REJECTED';
+    approverType: ApproverType;
+    approverId?: string | null;
+    approverName?: string | null;
+    approverEmail?: string | null;
+    reason?: string | null;
+    comments?: string | null;
+    createdAt: string;
+}
+interface BudgetAttachment {
+    id: string;
+    budgetId: string;
+    fileId: string;
+    name: string;
+    description?: string | null;
+    mimeType: string;
+    size: number;
+    url?: string;
+    uploadedById: string;
+    createdAt: string;
+}
+/** Cliente relacionado (subconjunto expuesto en presupuestos). */
+interface BudgetClientRef {
+    id: string;
+    name: string;
+    email?: string | null;
+    taxId?: string | null;
+}
+interface BudgetProjectRef {
+    id: string;
+    name: string;
+}
+interface BudgetOpportunityRef {
+    id: string;
+    title: string;
+}
+interface BudgetUserRef {
+    id: string;
+    name: string;
+    email?: string | null;
+}
+/** Listado de presupuesto (version resumida). */
+interface BudgetListItem {
+    id: string;
+    code: string;
+    title: string;
+    status: BudgetStatus;
+    currency: string;
+    issueDate: string;
+    validUntil: string;
+    total: number;
+    version: number;
+    tags: string[];
+    client?: BudgetClientRef | null;
+    project?: BudgetProjectRef | null;
+    opportunity?: BudgetOpportunityRef | null;
+    createdBy?: BudgetUserRef | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Presupuesto completo con items, secciones y aprobaciones. */
+interface Budget extends BudgetListItem {
+    description?: string | null;
+    taxRate: number;
+    discount: number;
+    discountPercent: number;
+    subtotal: number;
+    taxAmount: number;
+    internalCost?: number | null;
+    profit?: number | null;
+    profitMargin?: number | null;
+    paymentMethod?: PaymentMethod | null;
+    paymentTerms?: string | null;
+    termsAndConditions?: string | null;
+    notes?: string | null;
+    includeAcceptanceSection: boolean;
+    metadata?: Record<string, unknown> | null;
+    items: BudgetItem[];
+    sections: BudgetSection[];
+    approvals?: BudgetApproval[];
+    attachments?: BudgetAttachment[];
+    previousVersionId?: string | null;
+    nextVersionId?: string | null;
+}
+interface CreateBudgetInput {
+    /** Codigo. Si se omite, se autogenera segun la configuracion. */
+    code?: string;
+    /** Codigo ISO 4217 de la moneda (3 letras mayus). */
+    currency?: string;
+    /** Titulo visible para el cliente. */
+    title: string;
+    /** Descripcion general. */
+    description?: string;
+    /** UUID del cliente destinatario. */
+    clientId: string;
+    /** UUID del proyecto CRM asociado. */
+    projectId?: string;
+    /** UUID de la oportunidad comercial asociada. */
+    opportunityId?: string;
+    /** Fecha de emision (ISO 8601). Por defecto hoy. */
+    issueDate?: string;
+    /** Fecha de validez (ISO 8601). Obligatoria. */
+    validUntil: string;
+    /** Tasa impositiva global (0-100). */
+    taxRate?: number;
+    /** Descuento absoluto. */
+    discount?: number;
+    /** Descuento porcentual (0-100). */
+    discountPercent?: number;
+    /** Coste interno global (no visible al cliente). */
+    internalCost?: number;
+    /** Metodo de pago propuesto. */
+    paymentMethod?: PaymentMethod;
+    /** Condiciones de pago en texto libre. */
+    paymentTerms?: string;
+    /** Terminos y condiciones. Acepta Markdown. */
+    termsAndConditions?: string;
+    /** Notas internas. */
+    notes?: string;
+    /** Incluir seccion de aceptacion en el PDF generado. */
+    includeAcceptanceSection?: boolean;
+    /** Etiquetas para categorizar. */
+    tags?: string[];
+    /** Metadatos adicionales. */
+    metadata?: Record<string, unknown>;
+    /** Estado inicial. Por defecto DRAFT. */
+    status?: BudgetStatus;
+    /** Lista de items a crear junto al presupuesto. */
+    items?: CreateBudgetItemInput[];
+    /** Lista de secciones a crear junto al presupuesto. */
+    sections?: CreateBudgetSectionInput[];
+}
+type UpdateBudgetInput = Partial<Omit<CreateBudgetInput, 'clientId'>> & {
+    clientId?: string;
+};
+/** Filtros para listar presupuestos. */
+interface BudgetFilters {
+    page?: number;
+    limit?: number;
+    /** Busqueda libre por codigo, titulo o descripcion. */
+    search?: string;
+    /** Uno o varios estados. */
+    status?: BudgetStatus | BudgetStatus[];
+    clientId?: string;
+    projectId?: string;
+    opportunityId?: string;
+    createdById?: string;
+    version?: number;
+    /** Rango de fechas de emision. */
+    fromDate?: string;
+    toDate?: string;
+    /** Rango de fechas de validez. */
+    validFromDate?: string;
+    validToDate?: string;
+    /** Rango de importes. */
+    minAmount?: number;
+    maxAmount?: number;
+    tags?: string[];
+    sortBy?: string;
+    sortOrder?: SortOrder;
+}
+interface BudgetListResponse {
+    data: BudgetListItem[];
+    pagination: PaginationMeta;
+}
+interface SendBudgetInput {
+    /** Destinatarios principales (To). */
+    emails: string[];
+    /** Asunto del correo. */
+    subject?: string;
+    /** Mensaje personalizado en el cuerpo. */
+    message?: string;
+    /** Direcciones CC. */
+    cc?: string[];
+    /** Direcciones BCC. */
+    bcc?: string[];
+    /** Incluir adjuntos del presupuesto ademas del PDF. */
+    includeAttachments?: boolean;
+}
+interface ApproveBudgetInput {
+    /** Comentarios adicionales. */
+    comments?: string;
+    /** Crear automaticamente un proyecto. */
+    createProject?: boolean;
+    /** Quien aprueba. */
+    approverType?: ApproverType;
+    /** Nombre del contacto del cliente que aprueba (si approverType es CLIENT). */
+    clientApproverName?: string;
+    /** Correo del contacto del cliente que aprueba. */
+    clientApproverEmail?: string;
+}
+interface RejectBudgetInput {
+    /** Motivo del rechazo. Obligatorio. */
+    reason: string;
+    /** Comentarios adicionales. */
+    comments?: string;
+    approverType?: ApproverType;
+    clientApproverName?: string;
+    clientApproverEmail?: string;
+}
+interface ChangeStatusInput {
+    status: BudgetStatus;
+    reason?: string;
+}
+interface ConvertToProjectInput {
+    name: string;
+    startDate: string;
+    estimatedEndDate?: string;
+    description?: string;
+    /** Convertir items en tareas (por defecto true). */
+    copyItemsAsTasks?: boolean;
+}
+interface ConvertToInvoiceInput {
+    /** Emitir la factura directamente (ISSUED) en lugar de DRAFT. */
+    issueDirectly?: boolean;
+    /** Metodo de pago (hereda si se omite). */
+    paymentMethod?: PaymentMethod;
+    /** Condiciones de pago (hereda si se omite). */
+    paymentTerms?: string;
+    /** Fecha de vencimiento. */
+    dueDate?: string;
+    /** Notas visibles. */
+    notes?: string;
+    /** Notas internas no visibles para el cliente. */
+    internalNotes?: string;
+}
+interface DuplicateBudgetInput {
+    /** Cliente destino. Si se omite, conserva el del original. */
+    targetClientId?: string;
+    /** Titulo del duplicado. */
+    title?: string;
+    /** Resetear a DRAFT (por defecto true). */
+    resetStatus?: boolean;
+    /** Copiar registros de adjuntos. */
+    includeAttachments?: boolean;
+}
+interface BulkBudgetOptions {
+    /** Nuevo estado (obligatorio cuando la operacion es change-status). */
+    newStatus?: BudgetStatus;
+}
+interface BulkBudgetInput {
+    operation: BulkBudgetOperation;
+    ids: string[];
+    options?: BulkBudgetOptions;
+}
+interface BulkBudgetResultItem {
+    id: string;
+    success: boolean;
+    error?: string;
+}
+interface BulkBudgetResult {
+    success: number;
+    failed: number;
+    results: BulkBudgetResultItem[];
+}
+interface BudgetHistoryEntry {
+    id: string;
+    budgetId: string;
+    version: number;
+    action: string;
+    actorId?: string | null;
+    actorName?: string | null;
+    changes?: Record<string, unknown> | null;
+    createdAt: string;
+}
+interface NextCodeResponse {
+    code: string;
+}
+interface CheckCodeResponse {
+    exists: boolean;
+}
+interface BudgetPdfUrlResponse {
+    url: string;
+}
+interface UploadedBudgetImage {
+    url: string;
+}
+interface GenerateItemsAiInput {
+    /** Texto en lenguaje natural (minimo 10 caracteres). */
+    text: string;
+}
+interface AiGeneratedItem {
+    name: string;
+    description?: string;
+    quantity: number;
+    unitPrice: number;
+    taxRate?: number;
+    type?: BudgetItemType;
+}
+interface AiGeneratedSection {
+    type: BudgetSectionType;
+    position: BudgetSectionPosition;
+    title: string;
+    content: string;
+}
+interface GenerateItemsAiJob {
+    jobId: string;
+}
+interface GenerateCompleteAiResult {
+    sections: AiGeneratedSection[];
+    items: AiGeneratedItem[];
+    suggestedTitle?: string;
+    suggestedPaymentTerms?: string;
+    suggestedTermsAndConditions?: string;
+}
+interface GenerateSectionsAiResult {
+    sections: AiGeneratedSection[];
+}
+type BudgetExportFormat = 'csv';
+/**
+ * Eventos de webhook emitidos por el modulo de presupuestos.
+ * Formato UPPER_SNAKE coherente con el resto de eventos de la plataforma.
+ */
+type BudgetWebhookEvent = 'BUDGET_CREATED' | 'BUDGET_UPDATED' | 'BUDGET_SENT' | 'BUDGET_APPROVED' | 'BUDGET_REJECTED' | 'BUDGET_CANCELLED' | 'BUDGET_EXPIRED' | 'BUDGET_DUPLICATED' | 'BUDGET_CONVERTED_TO_PROJECT' | 'BUDGET_CONVERTED_TO_INVOICE';
+/**
+ * Lista completa de eventos de webhook de presupuestos.
+ * Util para registrar todos los eventos al configurar una app externa.
+ */
+declare const BUDGET_WEBHOOK_EVENTS: readonly BudgetWebhookEvent[];
+
+/**
+ * Tipos relacionados con plantillas de presupuesto.
+ *
+ * Expuestos por la API REST bajo `/api/crm/budget-templates`.
+ */
+
+/**
+ * Estructura sugerida de una seccion dentro de `sectionsJson` de la plantilla.
+ * El backend acepta `unknown[]` pero esta es la estructura recomendada.
+ */
+interface BudgetTemplateSectionJson {
+    type: BudgetSectionType;
+    position: BudgetSectionPosition;
+    title: string;
+    content?: string;
+    order?: number;
+}
+/**
+ * Estructura sugerida de un item dentro de `itemsJson` de la plantilla.
+ */
+interface BudgetTemplateItemJson {
+    type?: BudgetItemType;
+    name: string;
+    description?: string;
+    code?: string;
+    quantity: number;
+    unitPrice: number;
+    taxRate?: number;
+    discount?: number;
+    order?: number;
+}
+/** Plantilla de presupuesto. */
+interface BudgetTemplate {
+    id: string;
+    name: string;
+    description?: string | null;
+    icon?: string | null;
+    defaultTitle?: string | null;
+    defaultValidDays?: number | null;
+    defaultTaxRate?: number | null;
+    defaultPaymentTerms?: string | null;
+    defaultTermsAndConditions?: string | null;
+    includeAcceptanceSection: boolean;
+    /** Secciones de la plantilla. */
+    sectionsJson: BudgetTemplateSectionJson[];
+    /** Items de la plantilla. */
+    itemsJson: BudgetTemplateItemJson[];
+    /** Plantilla del sistema (inmutable). */
+    isSystemDefault: boolean;
+    /** Activa / archivada. */
+    isActive: boolean;
+    createdById?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** DTO para crear una plantilla personalizada. */
+interface CreateBudgetTemplateInput {
+    name: string;
+    description?: string;
+    icon?: string;
+    defaultTitle?: string;
+    defaultValidDays?: number;
+    defaultTaxRate?: number;
+    defaultPaymentTerms?: string;
+    defaultTermsAndConditions?: string;
+    includeAcceptanceSection?: boolean;
+    sectionsJson?: BudgetTemplateSectionJson[];
+    itemsJson?: BudgetTemplateItemJson[];
+}
+/** DTO parcial para actualizar una plantilla. */
+type UpdateBudgetTemplateInput = Partial<CreateBudgetTemplateInput>;
+/** DTO para guardar un presupuesto existente como plantilla. */
+interface CreateTemplateFromBudgetInput {
+    name: string;
+    description?: string;
+    icon?: string;
+}
+/** DTO para crear un presupuesto aplicando una plantilla. */
+interface ApplyTemplateInput {
+    clientId: string;
+    opportunityId?: string;
+    /** Titulo personalizado. Si se omite, se usa `defaultTitle` de la plantilla. */
+    title?: string;
+}
+
+/**
+ * Tipos del servicio de comentarios de presupuesto.
+ *
+ * Los comentarios soportan dos visibilidades:
+ *   - `INTERNAL`: solo visible para el equipo.
+ *   - `CLIENT`: visible también en el portal del cliente.
+ *
+ * Un comentario puede provenir de un usuario interno (`authorKind = 'INTERNAL'`)
+ * o de un usuario del portal cliente (`authorKind = 'PORTAL'`). La autoría es
+ * exclusiva: exactamente uno de `authorId` / `portalAuthorId` está presente.
+ */
+/** Visibilidades admitidas para un comentario. */
+type BudgetCommentVisibility = 'INTERNAL' | 'CLIENT';
+/** Origen de la autoría del comentario. */
+type BudgetCommentAuthorKind = 'INTERNAL' | 'PORTAL';
+/** Datos del autor interno cuando el comentario lo escribe un usuario del equipo. */
+interface BudgetCommentAuthor {
+    id: string;
+    firstName?: string | null;
+    lastName?: string | null;
+    avatar?: string | null;
+}
+/** Datos del autor desde el portal cliente. */
+interface BudgetCommentPortalAuthor {
+    id: string;
+    firstName?: string | null;
+    lastName?: string | null;
+    avatarUrl?: string | null;
+}
+/**
+ * Comentario de presupuesto. El `body` puede venir como string plano o como
+ * objeto con versión Markdown y plain text (según cómo lo serialice el
+ * backend).
+ */
+interface BudgetComment {
+    id: string;
+    budgetId: string;
+    authorId?: string | null;
+    author?: BudgetCommentAuthor | null;
+    portalAuthorId?: string | null;
+    portalAuthor?: BudgetCommentPortalAuthor | null;
+    authorKind?: BudgetCommentAuthorKind;
+    visibility: BudgetCommentVisibility;
+    body: string | {
+        markdown: string;
+        plainText: string;
+    };
+    mentionedUserIds?: string[];
+    createdAt: string;
+    editedAt?: string | null;
+    updatedAt?: string;
+}
+/**
+ * Entrada para crear un comentario.
+ *
+ * Si se envía `clientOperationId`, el backend puede deduplicar la operación
+ * en batch (ver `bulkCreate`).
+ */
+interface CreateBudgetCommentInput {
+    body: string;
+    visibility?: BudgetCommentVisibility;
+    mentionedUserIds?: string[];
+    clientOperationId?: string;
+}
+/** Entrada para editar un comentario existente. */
+interface UpdateBudgetCommentInput {
+    body: string;
+}
+/**
+ * Filtros para listar comentarios. `ALL` es azúcar local del SDK: se mapea a
+ * "sin filtro de visibilidad" en el query.
+ */
+interface ListBudgetCommentsFilter {
+    visibility?: BudgetCommentVisibility | 'ALL';
+    authorId?: string;
+    mentionedUserId?: string;
+    cursor?: string;
+    limit?: number;
+    since?: string;
+    until?: string;
+    /** Número de página (1-indexado) cuando el endpoint usa paginación offset. */
+    page?: number;
+}
+/**
+ * Información de paginación del listado de comentarios.
+ *
+ * El backend actual devuelve paginación offset (`page`, `limit`, `total`,
+ * `totalPages`). Se conservan también los campos por cursor para compatibilidad
+ * futura si el servicio migrara a paginación por cursor.
+ */
+interface BudgetCommentPageInfo {
+    page?: number;
+    limit?: number;
+    total?: number;
+    totalPages?: number;
+    nextCursor?: string | null;
+    hasMore?: boolean;
+    pageSize?: number;
+}
+/** Respuesta paginada del listado de comentarios. */
+interface BudgetCommentListResponse {
+    data: BudgetComment[];
+    pageInfo: BudgetCommentPageInfo;
+}
+/** Detalle de un fallo individual en una operación batch. */
+interface BudgetCommentBulkFailure {
+    index: number;
+    clientOperationId?: string;
+    code: string;
+    message: string;
+}
+/** Resultado de `bulkCreate` en modo saga (tolerante a fallos parciales). */
+interface BudgetCommentBulkResult {
+    succeeded: BudgetComment[];
+    failed: BudgetCommentBulkFailure[];
+    summary: {
+        total: number;
+        ok: number;
+        failed: number;
+    };
+}
+/** Elemento del timeline: comentario o evento de historial. */
+type BudgetTimelineItem = {
+    kind: 'COMMENT';
+    at: string;
+    comment: BudgetComment;
+} | {
+    kind: 'EVENT';
+    at: string;
+    event: Record<string, unknown>;
+};
+/** Filtros para `getTimeline`. */
+interface BudgetTimelineFilter {
+    cursor?: string;
+    limit?: number;
+    since?: string;
+    until?: string;
+}
+/** Respuesta del timeline unificado. */
+interface BudgetTimelineResponse {
+    items: BudgetTimelineItem[];
+    pageInfo: {
+        nextCursor?: string | null;
+        hasMore: boolean;
+        pageSize?: number;
+    };
+}
+
+/**
+ * Tipos del servicio de firmas electrónicas de presupuesto.
+ *
+ * El flujo de firma usa magic links (tokens de un solo uso, SHA-256 en BD,
+ * snapshot del hash del documento al emitir). Un token vivo evoluciona por los
+ * estados ACTIVE → CONSUMED | REVOKED | EXPIRED.
+ */
+/**
+ * Estado agregado del proceso de firma para un presupuesto.
+ * Pensado para representar el estado en la UI, no un enum de la BD.
+ */
+type SignatureStatus = 'NOT_SENT' | 'PENDING_SIGNATURE' | 'SIGNED' | 'REJECTED' | 'EXPIRED';
+/** Estado de un magic link concreto. */
+type SigningLinkStatus = 'ACTIVE' | 'CONSUMED' | 'REVOKED' | 'EXPIRED';
+/**
+ * Firma electrónica registrada. `hashVersion` indica qué algoritmo de
+ * serialización canónica se usó (1 = legado, 2 = extendido con descuentos,
+ * impuestos, secciones, notas, términos).
+ */
+interface BudgetSignature {
+    id: string;
+    budgetId: string;
+    budgetApprovalId?: string;
+    signerName: string;
+    signerEmail: string;
+    signedAt: string;
+    documentHash: string;
+    hashVersion: number;
+    /**
+     * IP del firmante enmascarada (por ejemplo `***.***.x.xx`). Nunca se
+     * devuelve la IP en claro por el endpoint público.
+     */
+    ipAddressMasked?: string | null;
+    userAgent?: string | null;
+    signatureFileId?: string;
+    signingTokenId?: string | null;
+}
+/**
+ * Resultado de verificar la integridad de una firma. Si `valid === false`,
+ * el documento ha cambiado después de la firma y la UI debe avisar al usuario.
+ */
+interface BudgetSignatureVerification {
+    valid: boolean;
+    expectedHash: string;
+    actualHash: string;
+    hashVersion: number;
+    signedAt: string;
+    signerName: string;
+    signerEmail: string;
+    ipAddressMasked?: string | null;
+    userAgent?: string | null;
+    signingTokenId?: string | null;
+}
+/** Entrada para generar un magic link de firma. */
+interface SigningLinkRequest {
+    signerEmail: string;
+    signerName?: string;
+    /** Rango admitido: 1 a 168 horas (7 días). Por defecto 72 h. */
+    expiresInHours?: number;
+    /** Si es `true`, el backend envía el correo con el enlace al firmante. */
+    sendEmail?: boolean;
+}
+/**
+ * Respuesta de `generateSigningLink`. `signingUrl` puede ser `null` cuando se
+ * reutiliza un token vivo existente (idempotencia por email) ya que el raw
+ * token original no es recuperable.
+ */
+interface SigningLinkResponse {
+    tokenId: string;
+    signingUrl: string | null;
+    expiresAt: string;
+    /** `true` si el backend devolvió un token preexistente sin crear uno nuevo. */
+    reused?: boolean;
+}
+/** Proyección segura de un token activo devuelta al listar. */
+interface SigningLinkSummary {
+    tokenId: string;
+    status?: SigningLinkStatus;
+    signerEmail: string;
+    signerName?: string | null;
+    createdAt: string;
+    expiresAt: string;
+    consumedAt?: string | null;
+    revokedAt?: string | null;
+    sentTo?: string | null;
+    createdBy?: {
+        id: string;
+        firstName?: string | null;
+        lastName?: string | null;
+    } | null;
+}
+/** Filtros para `listSigningLinks`. */
+interface ListSigningLinksFilter {
+    includeRevoked?: boolean;
+    includeExpired?: boolean;
+    cursor?: string;
+    limit?: number;
+}
+/** Respuesta al revocar un magic link. */
+interface RevokeSigningLinkResponse {
+    tokenId: string;
+    revokedAt: string;
+    /** `true` si el token ya había sido revocado previamente. */
+    alreadyRevoked?: boolean;
+}
+/** Tipos de eventos registrados en el audit trail legal. */
+type SignerAuditEventKind = 'ISSUED' | 'VIEWED' | 'PDF_DOWNLOADED' | 'APPROVED' | 'REJECTED' | 'EXPIRED' | 'REVOKED' | 'FAILED';
+/** Evento individual del audit trail. */
+interface SignerAuditEvent {
+    id: string;
+    event: SignerAuditEventKind;
+    at: string;
+    tokenId?: string | null;
+    actorUserId?: string | null;
+    ipAddress?: string | null;
+    userAgent?: string | null;
+    meta?: Record<string, unknown> | null;
+}
+/** Filtros para `getAuditTrail`. */
+interface AuditTrailFilter {
+    tokenId?: string;
+    cursor?: string;
+    limit?: number;
+}
+/** Respuesta paginada del audit trail. */
+interface AuditTrailResponse {
+    items: SignerAuditEvent[];
+    nextCursor?: string | null;
+}
+
+/**
+ * Tipos relacionados con la configuración de la organización.
+ *
+ * Reflejan el DTO `OrganizationPublicSettingsResponseDto` del backend
+ * (`apps/backend/src/modules/organization-settings/dto/organization-public-settings-response.dto.ts`).
+ */
+/**
+ * Canal de contacto dinámico (email, teléfono, URL, etc.) configurado por la
+ * organización.
+ */
+interface OrganizationContactChannel {
+    /** Etiqueta legible (ej: "Soporte", "RRHH", "Comercial"). */
+    label: string;
+    /** Valor del canal (email, teléfono, URL). */
+    value: string;
+    /** Tipo de canal. Valores habituales: "email", "phone", "url". */
+    type: string;
+}
+/**
+ * Datos públicos de la organización devueltos por
+ * `GET /organization-settings/public`.
+ *
+ * Son los campos que cualquier usuario autenticado puede leer para renderizar
+ * branding, contacto y valores por defecto de facturación. No incluye
+ * metadatos internos (id, createdAt, updatedAt, updatedById) ni los emails
+ * legacy (ya transformados a `contactChannels`).
+ */
+interface OrganizationPublicSettings {
+    companyName: string | null;
+    companyLegalName: string | null;
+    companyType: string | null;
+    taxId: string | null;
+    taxRegime: string | null;
+    companyRegistryNumber: string | null;
+    legalRepresentative: string | null;
+    legalAddressStreet: string | null;
+    legalAddressCity: string | null;
+    legalAddressPostalCode: string | null;
+    legalAddressCountry: string | null;
+    operationalAddressName: string | null;
+    operationalAddressStreet: string | null;
+    operationalAddressCity: string | null;
+    operationalAddressPostalCode: string | null;
+    operationalAddressCountry: string | null;
+    emailGeneral: string | null;
+    phone: string | null;
+    website: string | null;
+    contactChannels: OrganizationContactChannel[] | null;
+    bankName: string | null;
+    bankIban: string | null;
+    bankSwift: string | null;
+    bankPaymentMethod: string | null;
+    bankAccountHolder: string | null;
+    defaultCurrency: string | null;
+    defaultPaymentTermsDays: number | null;
+    /** Nombre del impuesto por defecto (IVA, IGIC, VAT, TVA, MwSt, etc.). */
+    defaultTaxName: string | null;
+    /** Tasa por defecto en porcentaje (21 = 21 %). */
+    defaultTaxRate: number | null;
+    /** Código ISO 3166-1 alfa-2 del país principal (ES, FR, US, etc.). */
+    country: string | null;
+    invoicePrefix: string | null;
+    invoiceLegalFooter: string | null;
+    timezone: string | null;
+    brandPrimaryColor: string | null;
+    brandSecondaryColor: string | null;
+    signatureImageUrl: string | null;
+    documentSignerRole: string | null;
+    logoUrl: string | null;
+    logoDarkBgUrl: string | null;
+    logoWidth: number | null;
+    budgetBrandConfig: Record<string, unknown> | null;
+}
+
 /**
  * Servicio de errores del sistema
  * Maneja todas las operaciones relacionadas con el reporte y consulta de errores
@@ -1451,6 +2409,429 @@ declare class AiService {
     private sleep;
 }
 
+/**
+ * Servicio de presupuestos (CRM Budgets).
+ *
+ * Cubre el CRUD completo, items, secciones, acciones (send/approve/reject/
+ * cancel/duplicate/convert), adjuntos, historial, exportacion, operaciones
+ * masivas y generacion asistida por IA.
+ */
+
+/**
+ * Opciones para la suscripcion SSE al job de generacion de items con IA.
+ */
+interface StreamAiJobOptions {
+    /** Callback para cada evento de progreso. */
+    onProgress?: (data: {
+        status: string;
+        progress: number;
+    }) => void;
+    /** Callback cuando el job se completa con exito. */
+    onComplete?: (data: {
+        items: AiGeneratedItem[];
+    }) => void;
+    /** Callback en caso de error. */
+    onError?: (error: Error) => void;
+}
+/** Handle devuelto por streamGenerateItemsStatus para cerrar la conexion. */
+interface StreamAiJobHandle {
+    close: () => void;
+}
+declare class BudgetsService {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: UtiliaClient);
+    /**
+     * Listar presupuestos aplicando filtros.
+     *
+     * @example
+     * ```typescript
+     * const page = await sdk.budgets.list({ status: 'SENT', page: 1, limit: 20 });
+     * console.log(page.data, page.pagination.total);
+     * ```
+     */
+    list(filters?: BudgetFilters): Promise<BudgetListResponse>;
+    /** Obtener el detalle completo de un presupuesto por UUID. */
+    get(id: string): Promise<Budget>;
+    /**
+     * Crear un nuevo presupuesto.
+     * Puede incluir items y secciones en la misma peticion.
+     */
+    create(data: CreateBudgetInput): Promise<Budget>;
+    /** Actualizar un presupuesto (solo en estado DRAFT salvo excepciones). */
+    update(id: string, data: UpdateBudgetInput): Promise<Budget>;
+    /** Soft delete (puede recuperarse). */
+    delete(id: string): Promise<{
+        message: string;
+    }>;
+    /**
+     * Eliminar de forma permanente.
+     * Solo disponible para SUPER_ADMIN en la organizacion origen.
+     */
+    deletePermanent(id: string): Promise<{
+        message: string;
+    }>;
+    /** Duplicar un presupuesto sin encadenarlo como nueva version. */
+    duplicate(id: string, options?: DuplicateBudgetInput): Promise<Budget>;
+    /** Crear una nueva version DRAFT del presupuesto, incrementando el contador. */
+    createVersion(id: string): Promise<Budget>;
+    /** Historial de versiones y cambios. */
+    getHistory(id: string): Promise<BudgetHistoryEntry[]>;
+    /** Presupuestos de un cliente. */
+    listByClient(clientId: string): Promise<BudgetListItem[]>;
+    /** Presupuestos de un proyecto. */
+    listByProject(projectId: string): Promise<BudgetListItem[]>;
+    /** Presupuestos de una oportunidad. */
+    listByOpportunity(opportunityId: string): Promise<BudgetListItem[]>;
+    /** Anyadir un item al presupuesto. */
+    addItem(budgetId: string, data: CreateBudgetItemInput): Promise<BudgetItem>;
+    /** Actualizar un item. */
+    updateItem(budgetId: string, itemId: string, data: UpdateBudgetItemInput): Promise<BudgetItem>;
+    /** Eliminar un item. */
+    removeItem(budgetId: string, itemId: string): Promise<{
+        message: string;
+    }>;
+    /** Aplicar un nuevo orden a los items del presupuesto. */
+    reorderItems(budgetId: string, data: ReorderItemsInput): Promise<{
+        message: string;
+    }>;
+    /** Listar secciones del presupuesto ordenadas por posicion y orden. */
+    listSections(budgetId: string): Promise<BudgetSection[]>;
+    /** Anyadir una seccion al presupuesto. */
+    addSection(budgetId: string, data: CreateBudgetSectionInput): Promise<BudgetSection>;
+    /** Actualizar una seccion existente. */
+    updateSection(budgetId: string, sectionId: string, data: UpdateBudgetSectionInput): Promise<BudgetSection>;
+    /** Eliminar una seccion. */
+    removeSection(budgetId: string, sectionId: string): Promise<{
+        message: string;
+    }>;
+    /** Reordenar secciones. */
+    reorderSections(budgetId: string, data: ReorderSectionsInput): Promise<{
+        message: string;
+    }>;
+    /** Enviar el presupuesto por correo al cliente. */
+    send(id: string, data: SendBudgetInput): Promise<Budget>;
+    /** Aprobar el presupuesto. */
+    approve(id: string, data?: ApproveBudgetInput): Promise<Budget>;
+    /** Rechazar el presupuesto. El motivo (reason) es obligatorio. */
+    reject(id: string, data: RejectBudgetInput): Promise<Budget>;
+    /** Cancelar el presupuesto. */
+    cancel(id: string): Promise<Budget>;
+    /**
+     * Cambiar el estado del presupuesto directamente (uso administrativo).
+     * Restringido a SUPER_ADMIN en el backend.
+     */
+    changeStatus(id: string, status: BudgetStatus, reason?: string): Promise<Budget>;
+    /** Convertir un presupuesto aprobado en un proyecto CRM. */
+    convertToProject(id: string, options: ConvertToProjectInput): Promise<{
+        projectId: string;
+    }>;
+    /** Convertir un presupuesto aprobado en factura. */
+    convertToInvoice(id: string, options?: ConvertToInvoiceInput): Promise<{
+        invoiceId: string;
+    }>;
+    /**
+     * Generar el PDF del presupuesto para descarga.
+     * Devuelve un Blob. Si el consumidor necesita una URL, usa `URL.createObjectURL`.
+     */
+    generatePdf(id: string): Promise<Blob>;
+    /**
+     * Visualizar el PDF del presupuesto (Content-Disposition inline).
+     * Devuelve un Blob.
+     */
+    viewPdf(id: string): Promise<Blob>;
+    /**
+     * Construir la URL del PDF del presupuesto (util para <iframe>, <embed>, etc.).
+     * Incluye las credenciales en query string para funcionar en etiquetas HTML
+     * que no pueden anyadir headers personalizados.
+     */
+    getPdfUrl(id: string): string;
+    /** Listar adjuntos del presupuesto. */
+    getAttachments(budgetId: string): Promise<BudgetAttachment[]>;
+    /**
+     * Subir un adjunto al presupuesto.
+     *
+     * @param budgetId - UUID del presupuesto
+     * @param file - Archivo a subir (File o Blob)
+     * @param meta - Nombre visible y descripcion opcionales
+     */
+    uploadAttachment(budgetId: string, file: File | Blob, meta?: {
+        name?: string;
+        description?: string;
+    }): Promise<BudgetAttachment>;
+    /** Eliminar un adjunto del presupuesto. */
+    deleteAttachment(budgetId: string, attachmentId: string): Promise<{
+        message: string;
+    }>;
+    /**
+     * Subir una imagen para el editor WYSIWYG.
+     * La imagen no aparece como adjunto en el File Manager: solo devuelve la URL
+     * para incrustarla en el contenido del presupuesto.
+     */
+    uploadEditorImage(budgetId: string, file: File | Blob): Promise<UploadedBudgetImage>;
+    /** Proximo codigo sugerido segun la configuracion de numeracion. */
+    getNextCode(): Promise<NextCodeResponse>;
+    /** Comprobar si un codigo ya esta en uso. */
+    checkCode(code: string, excludeId?: string): Promise<CheckCodeResponse>;
+    /** Estadisticas agregadas (totales, tasa aprobacion, etc.). */
+    getStats(filters?: BudgetFilters): Promise<Record<string, unknown>>;
+    /** Ejecutar una operacion masiva (delete / cancel / change-status). */
+    bulk(operation: BulkBudgetOperation, ids: string[], options?: BulkBudgetOptions): Promise<BulkBudgetResult>;
+    /**
+     * Exportar el listado filtrado en el formato indicado.
+     * De momento solo se soporta `csv`. Devuelve un Blob.
+     */
+    export(filters?: BudgetFilters, format?: BudgetExportFormat): Promise<Blob>;
+    /**
+     * Encolar un job asincrono para generar items del presupuesto a partir
+     * de un texto en lenguaje natural. Devuelve el `jobId` para seguir el
+     * progreso vía `streamGenerateItemsStatus`.
+     */
+    generateItemsWithAi(data: GenerateItemsAiInput): Promise<GenerateItemsAiJob>;
+    /**
+     * Suscribirse al progreso (SSE) del job de generacion de items con IA.
+     * Requiere EventSource en el entorno.
+     */
+    streamGenerateItemsStatus(jobId: string, options?: StreamAiJobOptions): StreamAiJobHandle;
+    /**
+     * Generar un presupuesto completo (secciones + items) a partir de un texto.
+     * Devuelve la estructura sugerida sin crear el presupuesto.
+     */
+    generateCompleteWithAi(data: GenerateItemsAiInput): Promise<GenerateCompleteAiResult>;
+    /** Generar unicamente secciones sugeridas para un presupuesto existente. */
+    generateSectionsWithAi(data: GenerateItemsAiInput): Promise<GenerateSectionsAiResult>;
+    /**
+     * Convierte los filtros a un objeto plano apto para query string.
+     * Aplana arrays en formato coma-separado (patron del backend).
+     */
+    private serializeFilters;
+    /**
+     * Descargar una respuesta binaria (PDF, CSV) respetando el auth del cliente.
+     * Usa `buildSseUrl` para añadir las credenciales en la URL cuando la ruta
+     * no pueda llevarlas en headers (p. ej. etiquetas `<a href>`).
+     */
+    private fetchBinary;
+}
+
+/**
+ * Servicio de plantillas de presupuesto (CRM Budget Templates).
+ *
+ * Las plantillas aceleran la creacion de presupuestos reutilizando
+ * secciones e items predefinidos. Se distinguen:
+ *   - Plantillas del sistema (`isSystemDefault: true`), inmutables.
+ *   - Plantillas personalizadas del usuario.
+ */
+
+declare class BudgetTemplatesService {
+    private readonly client;
+    private readonly basePath;
+    private readonly budgetsPath;
+    constructor(client: UtiliaClient);
+    /**
+     * Listar plantillas activas.
+     * Las plantillas del sistema aparecen primero, seguidas de las
+     * personalizadas ordenadas por fecha de creacion descendente.
+     */
+    list(): Promise<BudgetTemplate[]>;
+    /** Obtener el detalle de una plantilla por UUID. */
+    get(id: string): Promise<BudgetTemplate>;
+    /** Crear una plantilla personalizada. */
+    create(data: CreateBudgetTemplateInput): Promise<BudgetTemplate>;
+    /** Actualizar una plantilla personalizada (las del sistema son inmutables). */
+    update(id: string, data: UpdateBudgetTemplateInput): Promise<BudgetTemplate>;
+    /** Archivar (soft delete) una plantilla personalizada. */
+    delete(id: string): Promise<{
+        message: string;
+    }>;
+    /**
+     * Crear una plantilla personalizada copiando items y secciones de un
+     * presupuesto existente.
+     */
+    createFromBudget(budgetId: string, data: CreateTemplateFromBudgetInput): Promise<BudgetTemplate>;
+    /**
+     * Crear un presupuesto DRAFT aplicando una plantilla.
+     * Copia los items/secciones de la plantilla y asigna cliente/oportunidad.
+     */
+    applyTemplate(templateId: string, data: ApplyTemplateInput): Promise<Budget>;
+}
+
+/**
+ * Servicio de comentarios de presupuesto.
+ *
+ * Cubre el CRUD completo, la creación masiva tolerante a fallos y el timeline
+ * unificado (comentarios + eventos del historial). La capa de permisos es
+ * responsabilidad del backend: el SDK se limita a enviar la petición con la
+ * visibilidad solicitada.
+ */
+
+declare class BudgetCommentsService {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: UtiliaClient);
+    /**
+     * Listar comentarios del presupuesto.
+     *
+     * @param budgetId - UUID del presupuesto.
+     * @param filter - Filtros de visibilidad, paginación y rango de fechas.
+     *
+     * @example
+     * ```typescript
+     * const page = await sdk.budgetComments.list(budgetId, { visibility: 'CLIENT', page: 1, limit: 20 });
+     * page.data.forEach(c => console.log(c.body));
+     * ```
+     */
+    list(budgetId: string, filter?: ListBudgetCommentsFilter): Promise<BudgetCommentListResponse>;
+    /**
+     * Obtener un comentario por su ID.
+     *
+     * Nota: el backend actual no expone `GET /comments/:commentId` a nivel de
+     * REST. El SDK lo emula filtrando localmente el resultado del listado. Si
+     * en el futuro se añade un endpoint dedicado, este método se puede migrar
+     * sin romper la firma.
+     */
+    get(budgetId: string, commentId: string): Promise<BudgetComment>;
+    /**
+     * Crear un comentario en el presupuesto.
+     *
+     * La visibilidad (INTERNAL / CLIENT) debe ser compatible con los permisos
+     * del usuario autenticado. Las menciones solo tienen efecto en comentarios
+     * internos.
+     */
+    create(budgetId: string, input: CreateBudgetCommentInput): Promise<BudgetComment>;
+    /** Actualizar el cuerpo de un comentario. Solo autor o SUPER_ADMIN. */
+    update(budgetId: string, commentId: string, input: UpdateBudgetCommentInput): Promise<BudgetComment>;
+    /** Eliminar un comentario. Solo autor o SUPER_ADMIN. */
+    remove(budgetId: string, commentId: string): Promise<{
+        message: string;
+    }>;
+    /**
+     * Creación masiva tolerante a fallos (saga).
+     *
+     * Nota: a día de hoy, el backend expone el bulk únicamente a través de la
+     * herramienta MCP `crm_budget_comments.bulk_create`. Para consumirlo desde
+     * REST, el SDK llama secuencialmente a `create` y agrega el resultado,
+     * respetando el contrato del método. Sustituir cuando exista un endpoint
+     * REST dedicado.
+     */
+    bulkCreate(budgetId: string, items: CreateBudgetCommentInput[], options?: {
+        idempotencyKey?: string;
+    }): Promise<BudgetCommentBulkResult>;
+    /**
+     * Devuelve el timeline unificado: comentarios + eventos de historial del
+     * presupuesto ordenados cronológicamente descendente.
+     *
+     * Nota: el backend expone esta vista agregada a través de la herramienta MCP
+     * `crm_budget_comments.get_timeline`. Hasta que se habilite un endpoint REST
+     * dedicado, el SDK devuelve los comentarios paginados y un `items` sólo con
+     * kind `COMMENT`. Se marca como follow-up.
+     */
+    getTimeline(budgetId: string, filter?: BudgetTimelineFilter): Promise<BudgetTimelineResponse>;
+    private serializeListFilter;
+    private serializeTimelineFilter;
+    private normalizeBulkResult;
+    private mapErrorCode;
+}
+
+/**
+ * Servicio de firmas electrónicas de presupuesto.
+ *
+ * Gestiona:
+ *   - Magic links de firma (generar, listar, revocar).
+ *   - Consulta y verificación de firmas registradas.
+ *   - Descarga del certificado legal en PDF.
+ *   - Audit trail de eventos.
+ *
+ * El SDK no consume el flujo público del firmante (`/public/budgets/sign/:token`),
+ * ya que ese flujo no usa autenticación y se accede desde el frontend público
+ * `/sign/[token]`.
+ */
+
+declare class BudgetSignaturesService {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: UtiliaClient);
+    /** Listar todas las firmas asociadas al presupuesto. */
+    list(budgetId: string): Promise<BudgetSignature[]>;
+    /** Obtener el detalle de una firma concreta. */
+    get(budgetId: string, signatureId: string): Promise<BudgetSignature>;
+    /**
+     * Verificar la integridad de una firma. Recalcula el hash del documento con
+     * la versión (`hashVersion`) con la que se firmó originalmente y lo compara.
+     *
+     * Si `valid === false`, el documento ha sido modificado después de firmar.
+     */
+    verify(budgetId: string, signatureId: string): Promise<BudgetSignatureVerification>;
+    /**
+     * Descargar el certificado legal de una firma como Blob.
+     *
+     * Ideal para consumidores que necesiten guardar el PDF localmente o abrirlo
+     * con `URL.createObjectURL`.
+     */
+    downloadCertificate(budgetId: string, signatureId: string): Promise<Blob>;
+    /**
+     * Construir la URL del certificado (útil para `<iframe>` o enlaces directos).
+     * Incluye las credenciales en query string cuando el SDK usa API key.
+     */
+    getCertificateUrl(budgetId: string, signatureId: string): string;
+    /**
+     * Generar un magic link de firma. El endpoint es idempotente para la tupla
+     * (budgetId, signerEmail): si ya existe un token vivo se devuelve con
+     * `reused: true` y `signingUrl: null` (el raw token original no se
+     * recupera).
+     */
+    generateSigningLink(budgetId: string, input: SigningLinkRequest): Promise<SigningLinkResponse>;
+    /**
+     * Listar los magic links vivos del presupuesto (no usados, no revocados y no
+     * expirados). Los filtros `includeRevoked`/`includeExpired` se reservan para
+     * cuando el backend exponga la vista extendida.
+     */
+    listSigningLinks(budgetId: string, filter?: ListSigningLinksFilter): Promise<SigningLinkSummary[]>;
+    /** Revocar un magic link. Idempotente: llamarla dos veces no falla. */
+    revokeSigningLink(budgetId: string, tokenId: string): Promise<RevokeSigningLinkResponse>;
+    /**
+     * Audit trail paginado por cursor de los eventos de firma del presupuesto
+     * (emisión, visualización, descarga de PDF, aprobación, rechazo,
+     * expiración, revocación, fallos).
+     */
+    getAuditTrail(budgetId: string, filter?: AuditTrailFilter): Promise<SignerAuditEvent[]>;
+    private serializeSigningLinksFilter;
+    private serializeAuditFilter;
+}
+
+/**
+ * Servicio de configuración de organización.
+ *
+ * Expone los datos públicos de la organización a consumidores externos
+ * (portal de cliente, integraciones, agentes IA) sin exponer metadatos
+ * internos. Los datos devueltos incluyen branding, valores fiscales por
+ * defecto y preferencias regionales que son útiles durante el onboarding
+ * o para auto-rellenar formularios.
+ */
+
+declare class OrganizationSettingsService {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: UtiliaClient);
+    /**
+     * Obtener los datos públicos de la organización.
+     *
+     * Incluye identidad corporativa, branding, configuración de facturación
+     * (moneda, impuesto por defecto, país) y canales de contacto.
+     *
+     * @returns Configuración pública de la organización.
+     *
+     * @example
+     * ```typescript
+     * const settings = await sdk.organizationSettings.getPublicSettings();
+     * console.log(settings.defaultCurrency); // "EUR"
+     * console.log(settings.defaultTaxName);  // "IVA"
+     * console.log(settings.defaultTaxRate);  // 21
+     * console.log(settings.country);         // "ES"
+     * ```
+     */
+    getPublicSettings(): Promise<OrganizationPublicSettings>;
+}
+
 /**
  * Codigos de error del SDK
  */
@@ -1634,6 +3015,11 @@ declare const SDK_LIMITS: {
  * - `tickets`: Operaciones con tickets de soporte
  * - `users`: Operaciones con usuarios externos
  * - `ai`: Funcionalidades de IA (transcripción, sugerencias)
+ * - `budgets`: Presupuestos CRM (CRUD, items, secciones, flujo, IA, PDF)
+ * - `budgetTemplates`: Plantillas de presupuesto reutilizables
+ * - `budgetComments`: Comentarios internos y dirigidos al cliente de presupuestos
+ * - `budgetSignatures`: Firma electrónica con magic link, verificación y certificado
+ * - `organizationSettings`: Datos públicos de la organización (branding, fiscal, contacto)
  */
 declare class UtiliaSDK {
     private readonly _client;
@@ -1647,6 +3033,16 @@ declare class UtiliaSDK {
     readonly users: UsersService;
     /** Servicio de IA para transcripción y sugerencias */
     readonly ai: AiService;
+    /** Servicio de presupuestos CRM */
+    readonly budgets: BudgetsService;
+    /** Servicio de plantillas de presupuesto CRM */
+    readonly budgetTemplates: BudgetTemplatesService;
+    /** Servicio de comentarios de presupuesto (INTERNAL / CLIENT) */
+    readonly budgetComments: BudgetCommentsService;
+    /** Servicio de firmas electrónicas y magic links de presupuesto */
+    readonly budgetSignatures: BudgetSignaturesService;
+    /** Servicio de configuración pública de la organización */
+    readonly organizationSettings: OrganizationSettingsService;
     /**
      * Crea una nueva instancia del SDK
      *
@@ -1684,4 +3080,4 @@ declare class UtiliaSDK {
     get oauth(): OAuthService;
 }
 
-export { type AddMessageInput, type AiJobStatus, type AiSuggestInput, type AiSuggestions, type AiUserAction, type CreateTicketInput, type CreateTicketUser, type CreatedMessage, type CreatedTicket, ErrorCode, type ErrorFilters, type ErrorHttpMethod, type ErrorSeverity, type ErrorStats, type ExternalUser, type FileQuota, FileTokenStorage, type GetSuggestionsOptions, type IdentifyUserInput, type LoginUrlResult, MemoryTokenStorage, type MessageAuthor, type OAuthConfig, OAuthService, type OAuthTokens, type OAuthUserInfo, type PKCEChallenge, type PaginatedResponse, type PaginationMeta, type PendingOAuthState, type PopupLoginOptions, type ReportErrorInput, type ReportedError, type RequestConfig, SDK_LIMITS, type SseEvent, type StreamSuggestionsHandle, type StreamSuggestionsOptions, type StreamTranscriptionOptions, type SystemError, type TicketAttachment, type TicketCategory, type TicketContext, type TicketDetail, type TicketFilters, type TicketListItem, type TicketMessage, type TicketPriority, type TicketReporter, type TicketStatus, type TokenStorage, type TrackAiActionInput, type TranscriptionJobStatus, type UnreadCount, type UploadFileOptions, type UploadedFile, UtiliaSDK, type UtiliaSDKConfig, UtiliaSDKError, base64UrlEncode, generateCodeChallenge, generateCodeVerifier };
+export { type AddMessageInput, type AiGeneratedItem, type AiGeneratedSection, type AiJobStatus, type AiSuggestInput, type AiSuggestions, type AiUserAction, type ApplyTemplateInput, type ApproveBudgetInput, type ApproverType, type AuditTrailFilter, type AuditTrailResponse, type AuthorizedApp, BUDGET_WEBHOOK_EVENTS, type Budget, type BudgetApproval, type BudgetAttachment, type BudgetClientRef, type BudgetComment, type BudgetCommentAuthor, type BudgetCommentAuthorKind, type BudgetCommentBulkFailure, type BudgetCommentBulkResult, type BudgetCommentListResponse, type BudgetCommentPageInfo, type BudgetCommentPortalAuthor, type BudgetCommentVisibility, type BudgetExportFormat, type BudgetFilters, type BudgetHistoryEntry, type BudgetItem, type BudgetItemOrder, type BudgetItemType, type BudgetListItem, type BudgetListResponse, type BudgetOpportunityRef, type BudgetPdfUrlResponse, type BudgetProjectRef, type BudgetSection, type BudgetSectionPosition, type BudgetSectionType, type BudgetSignature, type BudgetSignatureVerification, type BudgetStatus, type BudgetTemplate, type BudgetTemplateItemJson, type BudgetTemplateSectionJson, type BudgetTimelineFilter, type BudgetTimelineItem, type BudgetTimelineResponse, type BudgetUserRef, type BudgetWebhookEvent, type BulkBudgetInput, type BulkBudgetOperation, type BulkBudgetOptions, type BulkBudgetResult, type BulkBudgetResultItem, type ChangeStatusInput, type CheckCodeResponse, type ConvertToInvoiceInput, type ConvertToProjectInput, type CreateBudgetCommentInput, type CreateBudgetInput, type CreateBudgetItemInput, type CreateBudgetSectionInput, type CreateBudgetTemplateInput, type CreateTemplateFromBudgetInput, type CreateTicketInput, type CreateTicketUser, type CreatedMessage, type CreatedTicket, type DuplicateBudgetInput, ErrorCode, type ErrorFilters, type ErrorHttpMethod, type ErrorSeverity, type ErrorStats, type ExternalUser, type FileQuota, FileTokenStorage, type GenerateCompleteAiResult, type GenerateItemsAiInput, type GenerateItemsAiJob, type GenerateSectionsAiResult, type GetSuggestionsOptions, type IdentifyUserInput, type IntrospectResponse, type ListBudgetCommentsFilter, type ListSigningLinksFilter, type LoginUrlResult, MemoryTokenStorage, type MessageAuthor, type NextCodeResponse, type OAuthConfig, OAuthService, type OAuthTokens, type OAuthUserInfo, type OidcAuthorizationOptions, type OrganizationContactChannel, type OrganizationPublicSettings, type PKCEChallenge, type PaginatedResponse, type PaginationMeta, type PaymentMethod, type PendingOAuthState, type PopupLoginOptions, type RejectBudgetInput, type ReorderItemsInput, type ReorderSectionsInput, type ReportErrorInput, type ReportedError, type RequestConfig, type RevokeSigningLinkResponse, SDK_LIMITS, type SendBudgetInput, type SignatureStatus, type SignerAuditEvent, type SignerAuditEventKind, type SigningLinkRequest, type SigningLinkResponse, type SigningLinkStatus, type SigningLinkSummary, type SortOrder, type SseEvent, type StreamSuggestionsHandle, type StreamSuggestionsOptions, type StreamTranscriptionOptions, type SystemError, type TicketAttachment, type TicketCategory, type TicketContext, type TicketDetail, type TicketFilters, type TicketListItem, type TicketMessage, type TicketPriority, type TicketReporter, type TicketStatus, type TokenStorage, type TrackAiActionInput, type TranscriptionJobStatus, type UnreadCount, type UpdateBudgetCommentInput, type UpdateBudgetInput, type UpdateBudgetItemInput, type UpdateBudgetSectionInput, type UpdateBudgetTemplateInput, type UploadFileOptions, type UploadedBudgetImage, type UploadedFile, UtiliaSDK, type UtiliaSDKConfig, UtiliaSDKError, base64UrlEncode, generateCodeChallenge, generateCodeVerifier };