@utilia-os/sdk-js 1.10.0 → 2.1.0

package/README.md

@@ -208,6 +208,116 @@ legacy (emailSupport, emailHr, etc.) no se exponen en esta respuesta; los
 emails legacy se transforman automáticamente a `contactChannels` por
 retrocompatibilidad.
 
+> **Breaking change en v2.0.0**: se ha eliminado el campo `businessActivity`
+> de `OrganizationPublicSettings`. La actividad económica ya no forma parte
+> de la configuración general de la organización; se ha migrado al modelo
+> `FiscalConfig.activityDesc`, disponible vía el endpoint
+> `finance/fiscal-config` (se añadirá un método dedicado al SDK en próximas
+> versiones). Si tu integración leía `settings.businessActivity`, debes
+> migrar a la nueva ubicación.
+
+## Comentarios y firmas de presupuestos
+
+Desde la versión 2.1.0, el SDK cubre los dos dominios centrales del flujo de
+aprobación de presupuestos: la conversación entre equipo y cliente y la firma
+electrónica con magic link.
+
+### Comentarios (`sdk.budgetComments`)
+
+Dos visibilidades: `INTERNAL` (solo equipo) y `CLIENT` (visible también en el
+portal del cliente). Las menciones con `mentionedUserIds` solo tienen efecto
+cuando la visibilidad es `INTERNAL`.
+
+```typescript
+import { UtiliaSDK } from '@utilia-os/sdk-js';
+
+const sdk = new UtiliaSDK({ baseURL: 'https://os.utilia.ai/api', apiKey: '...' });
+
+// Listar comentarios dirigidos al cliente
+const page = await sdk.budgetComments.list(budgetId, {
+  visibility: 'CLIENT',
+  page: 1,
+  limit: 20,
+});
+
+// Crear un comentario interno con menciones
+const comment = await sdk.budgetComments.create(budgetId, {
+  body: 'Revisar el descuento del item 2 antes de enviar al cliente.',
+  visibility: 'INTERNAL',
+  mentionedUserIds: ['6d1a4c6b-3f8b-4a0e-a0d1-b29f1f1c21cb'],
+});
+
+// Editar el propio comentario
+await sdk.budgetComments.update(budgetId, comment.id, {
+  body: 'Revisar descuento y condiciones de pago.',
+});
+
+// Crear varios comentarios en lote, tolerante a fallos
+const result = await sdk.budgetComments.bulkCreate(
+  budgetId,
+  [
+    { body: 'Primer comentario' },
+    { body: 'Segundo comentario', clientOperationId: 'op-2' },
+  ],
+  { idempotencyKey: 'migration-2026-04-17' },
+);
+console.log(result.summary); // { total: 2, ok: 2, failed: 0 }
+```
+
+### Firmas y magic link (`sdk.budgetSignatures`)
+
+El flujo completo cubre la emisión del magic link, el listado y revocación, la
+verificación de integridad de una firma ya registrada y la descarga del
+certificado legal.
+
+```typescript
+// Emitir un magic link (idempotente por email)
+const link = await sdk.budgetSignatures.generateSigningLink(budgetId, {
+  signerEmail: 'cliente@empresa.com',
+  signerName: 'María García',
+  expiresInHours: 72,
+  sendEmail: true,
+});
+
+if (!link.reused && link.signingUrl) {
+  console.log('Enviar al cliente:', link.signingUrl);
+}
+
+// Listar los magic links vivos
+const activeLinks = await sdk.budgetSignatures.listSigningLinks(budgetId);
+
+// Revocar un link
+await sdk.budgetSignatures.revokeSigningLink(budgetId, link.tokenId);
+
+// Verificar la integridad de una firma ya registrada
+const signatures = await sdk.budgetSignatures.list(budgetId);
+const verification = await sdk.budgetSignatures.verify(
+  budgetId,
+  signatures[0].id,
+);
+if (!verification.valid) {
+  console.warn('El documento ha cambiado después de la firma.');
+}
+
+// Descargar el certificado legal
+const pdf = await sdk.budgetSignatures.downloadCertificate(
+  budgetId,
+  signatures[0].id,
+);
+```
+
+### Audit trail
+
+Historial paginado de eventos del proceso de firma (emisión, visualización,
+descarga del PDF, aprobación, rechazo, expiración, revocación y fallos):
+
+```typescript
+const events = await sdk.budgetSignatures.getAuditTrail(budgetId, {
+  tokenId: link.tokenId,
+  limit: 100,
+});
+```
+
 ## OAuth y Sign In
 
 Desde la versión 1.6.0, el SDK incluye soporte nativo para OAuth 2.1 con PKCE. Esto permite implementar "Iniciar sesión con UTILIA" en tu aplicación:

package/dist/index.d.mts

@@ -1337,6 +1337,284 @@ interface ApplyTemplateInput {
     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.
  *
@@ -1372,7 +1650,6 @@ interface OrganizationPublicSettings {
     taxRegime: string | null;
     companyRegistryNumber: string | null;
     legalRepresentative: string | null;
-    businessActivity: string | null;
     legalAddressStreet: string | null;
     legalAddressCity: string | null;
     legalAddressPostalCode: string | null;
@@ -2378,6 +2655,149 @@ declare class BudgetTemplatesService {
     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.
  *
@@ -2597,6 +3017,8 @@ declare const SDK_LIMITS: {
  * - `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 {
@@ -2615,6 +3037,10 @@ declare class UtiliaSDK {
     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;
     /**
@@ -2654,4 +3080,4 @@ declare class UtiliaSDK {
     get oauth(): OAuthService;
 }
 
-export { type AddMessageInput, type AiGeneratedItem, type AiGeneratedSection, type AiJobStatus, type AiSuggestInput, type AiSuggestions, type AiUserAction, type ApplyTemplateInput, type ApproveBudgetInput, type ApproverType, type AuthorizedApp, BUDGET_WEBHOOK_EVENTS, type Budget, type BudgetApproval, type BudgetAttachment, type BudgetClientRef, 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 BudgetStatus, type BudgetTemplate, type BudgetTemplateItemJson, type BudgetTemplateSectionJson, type BudgetUserRef, type BudgetWebhookEvent, type BulkBudgetInput, type BulkBudgetOperation, type BulkBudgetOptions, type BulkBudgetResult, type BulkBudgetResultItem, type ChangeStatusInput, type CheckCodeResponse, type ConvertToInvoiceInput, type ConvertToProjectInput, 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 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, SDK_LIMITS, type SendBudgetInput, 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 UpdateBudgetInput, type UpdateBudgetItemInput, type UpdateBudgetSectionInput, type UpdateBudgetTemplateInput, type UploadFileOptions, type UploadedBudgetImage, 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 };