@dispatchtickets/sdk 0.8.0 → 0.8.2

package/dist/index.d.cts

@@ -488,6 +488,8 @@ interface PortalCreateTicketInput {
     title: string;
     /** Ticket body/description (optional) */
     body?: string;
+    /** IDs of pending attachments to associate with the ticket */
+    attachmentIds?: string[];
 }
 /**
  * Filters for listing tickets
@@ -518,6 +520,54 @@ interface PortalTicketListResponse {
         nextCursor: string | null;
     };
 }
+/**
+ * Input for initiating an attachment upload
+ */
+interface PortalCreateAttachmentInput {
+    /** Original filename */
+    filename: string;
+    /** MIME type of the file */
+    contentType: string;
+    /** File size in bytes (max 50MB) */
+    size: number;
+}
+/**
+ * Response from initiating an attachment upload
+ */
+interface PortalAttachmentUploadResponse {
+    /** Attachment ID */
+    id: string;
+    /** Presigned URL for uploading the file (PUT request) */
+    uploadUrl: string;
+    /** URL expiration timestamp */
+    expiresAt: string;
+}
+/**
+ * Attachment record
+ */
+interface PortalAttachment {
+    /** Attachment ID */
+    id: string;
+    /** Original filename */
+    filename: string;
+    /** MIME type */
+    contentType: string;
+    /** File size in bytes */
+    size: number;
+    /** Upload status */
+    status: 'pending' | 'confirmed' | 'failed';
+    /** Creation timestamp */
+    createdAt: string;
+}
+/**
+ * Attachment with download URL
+ */
+interface PortalAttachmentWithUrl extends PortalAttachment {
+    /** Presigned download URL */
+    downloadUrl: string;
+    /** Download URL expiration timestamp */
+    expiresAt: string;
+}
 
 /**
  * Brands resource for managing workspaces
@@ -1889,6 +1939,107 @@ declare class PortalTicketsResource extends BaseResource {
      * ```
      */
     addComment(ticketId: string, body: string, options?: PortalAddCommentOptions): Promise<PortalComment>;
+    /**
+     * Initiate a pending attachment upload (before ticket creation)
+     *
+     * Use this to upload files before creating a ticket. After uploading to the
+     * presigned URL, confirm the upload, then pass the attachment IDs when
+     * creating the ticket.
+     *
+     * @param data - Attachment metadata
+     * @param options - Request options
+     * @returns Upload URL and attachment ID
+     *
+     * @example
+     * ```typescript
+     * // 1. Initiate upload
+     * const upload = await portal.tickets.initiatePendingUpload({
+     *   filename: 'screenshot.png',
+     *   contentType: 'image/png',
+     *   size: 12345,
+     * });
+     *
+     * // 2. Upload file to presigned URL
+     * await fetch(upload.uploadUrl, {
+     *   method: 'PUT',
+     *   body: fileBuffer,
+     *   headers: { 'Content-Type': 'image/png' },
+     * });
+     *
+     * // 3. Confirm upload
+     * await portal.tickets.confirmPendingUpload(upload.id);
+     *
+     * // 4. Create ticket with attachment
+     * const ticket = await portal.tickets.create({
+     *   title: 'Bug report',
+     *   body: 'See attached screenshot',
+     *   attachmentIds: [upload.id],
+     * });
+     * ```
+     */
+    initiatePendingUpload(data: PortalCreateAttachmentInput, options?: ApiRequestOptions): Promise<PortalAttachmentUploadResponse>;
+    /**
+     * Confirm a pending attachment upload
+     *
+     * Call this after successfully uploading the file to the presigned URL.
+     *
+     * @param attachmentId - Attachment ID from initiatePendingUpload
+     * @param options - Request options
+     * @returns Confirmed attachment
+     */
+    confirmPendingUpload(attachmentId: string, options?: ApiRequestOptions): Promise<PortalAttachment>;
+    /**
+     * Initiate attachment upload for an existing ticket
+     *
+     * @param ticketId - Ticket ID
+     * @param data - Attachment metadata
+     * @param options - Request options
+     * @returns Upload URL and attachment ID
+     *
+     * @example
+     * ```typescript
+     * const upload = await portal.tickets.initiateUpload('tkt_abc123', {
+     *   filename: 'document.pdf',
+     *   contentType: 'application/pdf',
+     *   size: 54321,
+     * });
+     *
+     * await fetch(upload.uploadUrl, {
+     *   method: 'PUT',
+     *   body: fileBuffer,
+     *   headers: { 'Content-Type': 'application/pdf' },
+     * });
+     *
+     * await portal.tickets.confirmUpload('tkt_abc123', upload.id);
+     * ```
+     */
+    initiateUpload(ticketId: string, data: PortalCreateAttachmentInput, options?: ApiRequestOptions): Promise<PortalAttachmentUploadResponse>;
+    /**
+     * Confirm attachment upload for a ticket
+     *
+     * @param ticketId - Ticket ID
+     * @param attachmentId - Attachment ID from initiateUpload
+     * @param options - Request options
+     * @returns Confirmed attachment
+     */
+    confirmUpload(ticketId: string, attachmentId: string, options?: ApiRequestOptions): Promise<PortalAttachment>;
+    /**
+     * List attachments on a ticket
+     *
+     * @param ticketId - Ticket ID
+     * @param options - Request options
+     * @returns Array of attachments
+     */
+    listAttachments(ticketId: string, options?: ApiRequestOptions): Promise<PortalAttachment[]>;
+    /**
+     * Get attachment with download URL
+     *
+     * @param ticketId - Ticket ID
+     * @param attachmentId - Attachment ID
+     * @param options - Request options
+     * @returns Attachment with presigned download URL
+     */
+    getAttachment(ticketId: string, attachmentId: string, options?: ApiRequestOptions): Promise<PortalAttachmentWithUrl>;
     /**
      * Build query parameters from filters
      */
@@ -2343,4 +2494,4 @@ declare const webhookUtils: {
  */
 declare function collectAll<T>(iterable: AsyncIterable<T>): Promise<T[]>;
 
-export { type Account, type AccountUsage, type ApiKey, type ApiKeyWithSecret, type ApiRequestOptions, type Attachment, type AttachmentStatus, type AttachmentWithUrl, AuthenticationError, type AuthorType, type Brand, type BulkAction, type BulkActionResult, type Category, type CategoryStats, type Comment, type CommentCreatedData, type CommentCreatedEvent, type Company, ConflictError, type CreateApiKeyInput, type CreateBrandInput, type CreateCategoryInput, type CreateCommentInput, type CreateCommentOptions, type CreateCustomerInput, type CreateFieldInput, type CreateTagInput, type CreateTicketInput, type CreateTicketOptions, type CreateWebhookInput, type Customer, type DeleteBrandPreview, DispatchPortal, type DispatchPortalConfig, DispatchTickets, type DispatchTicketsConfig, DispatchTicketsError, type EntityType, type EventCommentData, type EventCustomerInfo, type FieldDefinition, type FieldDefinitions, type FieldType, type GeneratePortalTokenInput, type Hooks, type InitiateUploadInput, type InitiateUploadResponse, type Link, type ListCustomersFilters, type ListTicketsFilters, type MergeTagsInput, type MergeTicketsInput, NetworkError, NotFoundError, type PaginatedResponse, type PortalComment, type PortalCreateTicketInput, type PortalListTicketsFilters, type PortalTicket, type PortalTicketDetail, type PortalTicketListResponse, type PortalTokenResponse, RateLimitError, type RateLimitInfo, type RequestContext, type ResponseContext, type RetryConfig, type SendMagicLinkInput, ServerError, type SortOrder, type Tag, type Ticket, type TicketCreatedData, type TicketCreatedEvent, type TicketPriority, type TicketSource, type TicketStatus, type TicketUpdatedData, type TicketUpdatedEvent, TimeoutError, type UpdateApiKeyScopeInput, type UpdateBrandInput, type UpdateCategoryInput, type UpdateCommentInput, type UpdateCustomerInput, type UpdateFieldInput, type UpdateTagInput, type UpdateTicketInput, ValidationError, type Webhook, type WebhookDelivery, type WebhookEvent, type WebhookEventEnvelope, type WebhookEventMap, type WebhookEventName, type WebhookEventType, collectAll, isAuthenticationError, isCommentCreatedEvent, isConflictError, isDispatchTicketsError, isNetworkError, isNotFoundError, isRateLimitError, isServerError, isTicketCreatedEvent, isTicketUpdatedEvent, isTimeoutError, isValidationError, parseWebhookEvent, webhookUtils };
+export { type Account, type AccountUsage, type ApiKey, type ApiKeyWithSecret, type ApiRequestOptions, type Attachment, type AttachmentStatus, type AttachmentWithUrl, AuthenticationError, type AuthorType, type Brand, type BulkAction, type BulkActionResult, type Category, type CategoryStats, type Comment, type CommentCreatedData, type CommentCreatedEvent, type Company, ConflictError, type CreateApiKeyInput, type CreateBrandInput, type CreateCategoryInput, type CreateCommentInput, type CreateCommentOptions, type CreateCustomerInput, type CreateFieldInput, type CreateTagInput, type CreateTicketInput, type CreateTicketOptions, type CreateWebhookInput, type Customer, type DeleteBrandPreview, DispatchPortal, type DispatchPortalConfig, DispatchTickets, type DispatchTicketsConfig, DispatchTicketsError, type EntityType, type EventCommentData, type EventCustomerInfo, type FieldDefinition, type FieldDefinitions, type FieldType, type GeneratePortalTokenInput, type Hooks, type InitiateUploadInput, type InitiateUploadResponse, type Link, type ListCustomersFilters, type ListTicketsFilters, type MergeTagsInput, type MergeTicketsInput, NetworkError, NotFoundError, type PaginatedResponse, type PortalAttachment, type PortalAttachmentUploadResponse, type PortalAttachmentWithUrl, type PortalComment, type PortalCreateAttachmentInput, type PortalCreateTicketInput, type PortalListTicketsFilters, type PortalTicket, type PortalTicketDetail, type PortalTicketListResponse, type PortalTokenResponse, RateLimitError, type RateLimitInfo, type RequestContext, type ResponseContext, type RetryConfig, type SendMagicLinkInput, ServerError, type SortOrder, type Tag, type Ticket, type TicketCreatedData, type TicketCreatedEvent, type TicketPriority, type TicketSource, type TicketStatus, type TicketUpdatedData, type TicketUpdatedEvent, TimeoutError, type UpdateApiKeyScopeInput, type UpdateBrandInput, type UpdateCategoryInput, type UpdateCommentInput, type UpdateCustomerInput, type UpdateFieldInput, type UpdateTagInput, type UpdateTicketInput, ValidationError, type Webhook, type WebhookDelivery, type WebhookEvent, type WebhookEventEnvelope, type WebhookEventMap, type WebhookEventName, type WebhookEventType, collectAll, isAuthenticationError, isCommentCreatedEvent, isConflictError, isDispatchTicketsError, isNetworkError, isNotFoundError, isRateLimitError, isServerError, isTicketCreatedEvent, isTicketUpdatedEvent, isTimeoutError, isValidationError, parseWebhookEvent, webhookUtils };

package/dist/index.d.ts

@@ -488,6 +488,8 @@ interface PortalCreateTicketInput {
     title: string;
     /** Ticket body/description (optional) */
     body?: string;
+    /** IDs of pending attachments to associate with the ticket */
+    attachmentIds?: string[];
 }
 /**
  * Filters for listing tickets
@@ -518,6 +520,54 @@ interface PortalTicketListResponse {
         nextCursor: string | null;
     };
 }
+/**
+ * Input for initiating an attachment upload
+ */
+interface PortalCreateAttachmentInput {
+    /** Original filename */
+    filename: string;
+    /** MIME type of the file */
+    contentType: string;
+    /** File size in bytes (max 50MB) */
+    size: number;
+}
+/**
+ * Response from initiating an attachment upload
+ */
+interface PortalAttachmentUploadResponse {
+    /** Attachment ID */
+    id: string;
+    /** Presigned URL for uploading the file (PUT request) */
+    uploadUrl: string;
+    /** URL expiration timestamp */
+    expiresAt: string;
+}
+/**
+ * Attachment record
+ */
+interface PortalAttachment {
+    /** Attachment ID */
+    id: string;
+    /** Original filename */
+    filename: string;
+    /** MIME type */
+    contentType: string;
+    /** File size in bytes */
+    size: number;
+    /** Upload status */
+    status: 'pending' | 'confirmed' | 'failed';
+    /** Creation timestamp */
+    createdAt: string;
+}
+/**
+ * Attachment with download URL
+ */
+interface PortalAttachmentWithUrl extends PortalAttachment {
+    /** Presigned download URL */
+    downloadUrl: string;
+    /** Download URL expiration timestamp */
+    expiresAt: string;
+}
 
 /**
  * Brands resource for managing workspaces
@@ -1889,6 +1939,107 @@ declare class PortalTicketsResource extends BaseResource {
      * ```
      */
     addComment(ticketId: string, body: string, options?: PortalAddCommentOptions): Promise<PortalComment>;
+    /**
+     * Initiate a pending attachment upload (before ticket creation)
+     *
+     * Use this to upload files before creating a ticket. After uploading to the
+     * presigned URL, confirm the upload, then pass the attachment IDs when
+     * creating the ticket.
+     *
+     * @param data - Attachment metadata
+     * @param options - Request options
+     * @returns Upload URL and attachment ID
+     *
+     * @example
+     * ```typescript
+     * // 1. Initiate upload
+     * const upload = await portal.tickets.initiatePendingUpload({
+     *   filename: 'screenshot.png',
+     *   contentType: 'image/png',
+     *   size: 12345,
+     * });
+     *
+     * // 2. Upload file to presigned URL
+     * await fetch(upload.uploadUrl, {
+     *   method: 'PUT',
+     *   body: fileBuffer,
+     *   headers: { 'Content-Type': 'image/png' },
+     * });
+     *
+     * // 3. Confirm upload
+     * await portal.tickets.confirmPendingUpload(upload.id);
+     *
+     * // 4. Create ticket with attachment
+     * const ticket = await portal.tickets.create({
+     *   title: 'Bug report',
+     *   body: 'See attached screenshot',
+     *   attachmentIds: [upload.id],
+     * });
+     * ```
+     */
+    initiatePendingUpload(data: PortalCreateAttachmentInput, options?: ApiRequestOptions): Promise<PortalAttachmentUploadResponse>;
+    /**
+     * Confirm a pending attachment upload
+     *
+     * Call this after successfully uploading the file to the presigned URL.
+     *
+     * @param attachmentId - Attachment ID from initiatePendingUpload
+     * @param options - Request options
+     * @returns Confirmed attachment
+     */
+    confirmPendingUpload(attachmentId: string, options?: ApiRequestOptions): Promise<PortalAttachment>;
+    /**
+     * Initiate attachment upload for an existing ticket
+     *
+     * @param ticketId - Ticket ID
+     * @param data - Attachment metadata
+     * @param options - Request options
+     * @returns Upload URL and attachment ID
+     *
+     * @example
+     * ```typescript
+     * const upload = await portal.tickets.initiateUpload('tkt_abc123', {
+     *   filename: 'document.pdf',
+     *   contentType: 'application/pdf',
+     *   size: 54321,
+     * });
+     *
+     * await fetch(upload.uploadUrl, {
+     *   method: 'PUT',
+     *   body: fileBuffer,
+     *   headers: { 'Content-Type': 'application/pdf' },
+     * });
+     *
+     * await portal.tickets.confirmUpload('tkt_abc123', upload.id);
+     * ```
+     */
+    initiateUpload(ticketId: string, data: PortalCreateAttachmentInput, options?: ApiRequestOptions): Promise<PortalAttachmentUploadResponse>;
+    /**
+     * Confirm attachment upload for a ticket
+     *
+     * @param ticketId - Ticket ID
+     * @param attachmentId - Attachment ID from initiateUpload
+     * @param options - Request options
+     * @returns Confirmed attachment
+     */
+    confirmUpload(ticketId: string, attachmentId: string, options?: ApiRequestOptions): Promise<PortalAttachment>;
+    /**
+     * List attachments on a ticket
+     *
+     * @param ticketId - Ticket ID
+     * @param options - Request options
+     * @returns Array of attachments
+     */
+    listAttachments(ticketId: string, options?: ApiRequestOptions): Promise<PortalAttachment[]>;
+    /**
+     * Get attachment with download URL
+     *
+     * @param ticketId - Ticket ID
+     * @param attachmentId - Attachment ID
+     * @param options - Request options
+     * @returns Attachment with presigned download URL
+     */
+    getAttachment(ticketId: string, attachmentId: string, options?: ApiRequestOptions): Promise<PortalAttachmentWithUrl>;
     /**
      * Build query parameters from filters
      */
@@ -2343,4 +2494,4 @@ declare const webhookUtils: {
  */
 declare function collectAll<T>(iterable: AsyncIterable<T>): Promise<T[]>;
 
-export { type Account, type AccountUsage, type ApiKey, type ApiKeyWithSecret, type ApiRequestOptions, type Attachment, type AttachmentStatus, type AttachmentWithUrl, AuthenticationError, type AuthorType, type Brand, type BulkAction, type BulkActionResult, type Category, type CategoryStats, type Comment, type CommentCreatedData, type CommentCreatedEvent, type Company, ConflictError, type CreateApiKeyInput, type CreateBrandInput, type CreateCategoryInput, type CreateCommentInput, type CreateCommentOptions, type CreateCustomerInput, type CreateFieldInput, type CreateTagInput, type CreateTicketInput, type CreateTicketOptions, type CreateWebhookInput, type Customer, type DeleteBrandPreview, DispatchPortal, type DispatchPortalConfig, DispatchTickets, type DispatchTicketsConfig, DispatchTicketsError, type EntityType, type EventCommentData, type EventCustomerInfo, type FieldDefinition, type FieldDefinitions, type FieldType, type GeneratePortalTokenInput, type Hooks, type InitiateUploadInput, type InitiateUploadResponse, type Link, type ListCustomersFilters, type ListTicketsFilters, type MergeTagsInput, type MergeTicketsInput, NetworkError, NotFoundError, type PaginatedResponse, type PortalComment, type PortalCreateTicketInput, type PortalListTicketsFilters, type PortalTicket, type PortalTicketDetail, type PortalTicketListResponse, type PortalTokenResponse, RateLimitError, type RateLimitInfo, type RequestContext, type ResponseContext, type RetryConfig, type SendMagicLinkInput, ServerError, type SortOrder, type Tag, type Ticket, type TicketCreatedData, type TicketCreatedEvent, type TicketPriority, type TicketSource, type TicketStatus, type TicketUpdatedData, type TicketUpdatedEvent, TimeoutError, type UpdateApiKeyScopeInput, type UpdateBrandInput, type UpdateCategoryInput, type UpdateCommentInput, type UpdateCustomerInput, type UpdateFieldInput, type UpdateTagInput, type UpdateTicketInput, ValidationError, type Webhook, type WebhookDelivery, type WebhookEvent, type WebhookEventEnvelope, type WebhookEventMap, type WebhookEventName, type WebhookEventType, collectAll, isAuthenticationError, isCommentCreatedEvent, isConflictError, isDispatchTicketsError, isNetworkError, isNotFoundError, isRateLimitError, isServerError, isTicketCreatedEvent, isTicketUpdatedEvent, isTimeoutError, isValidationError, parseWebhookEvent, webhookUtils };
+export { type Account, type AccountUsage, type ApiKey, type ApiKeyWithSecret, type ApiRequestOptions, type Attachment, type AttachmentStatus, type AttachmentWithUrl, AuthenticationError, type AuthorType, type Brand, type BulkAction, type BulkActionResult, type Category, type CategoryStats, type Comment, type CommentCreatedData, type CommentCreatedEvent, type Company, ConflictError, type CreateApiKeyInput, type CreateBrandInput, type CreateCategoryInput, type CreateCommentInput, type CreateCommentOptions, type CreateCustomerInput, type CreateFieldInput, type CreateTagInput, type CreateTicketInput, type CreateTicketOptions, type CreateWebhookInput, type Customer, type DeleteBrandPreview, DispatchPortal, type DispatchPortalConfig, DispatchTickets, type DispatchTicketsConfig, DispatchTicketsError, type EntityType, type EventCommentData, type EventCustomerInfo, type FieldDefinition, type FieldDefinitions, type FieldType, type GeneratePortalTokenInput, type Hooks, type InitiateUploadInput, type InitiateUploadResponse, type Link, type ListCustomersFilters, type ListTicketsFilters, type MergeTagsInput, type MergeTicketsInput, NetworkError, NotFoundError, type PaginatedResponse, type PortalAttachment, type PortalAttachmentUploadResponse, type PortalAttachmentWithUrl, type PortalComment, type PortalCreateAttachmentInput, type PortalCreateTicketInput, type PortalListTicketsFilters, type PortalTicket, type PortalTicketDetail, type PortalTicketListResponse, type PortalTokenResponse, RateLimitError, type RateLimitInfo, type RequestContext, type ResponseContext, type RetryConfig, type SendMagicLinkInput, ServerError, type SortOrder, type Tag, type Ticket, type TicketCreatedData, type TicketCreatedEvent, type TicketPriority, type TicketSource, type TicketStatus, type TicketUpdatedData, type TicketUpdatedEvent, TimeoutError, type UpdateApiKeyScopeInput, type UpdateBrandInput, type UpdateCategoryInput, type UpdateCommentInput, type UpdateCustomerInput, type UpdateFieldInput, type UpdateTagInput, type UpdateTicketInput, ValidationError, type Webhook, type WebhookDelivery, type WebhookEvent, type WebhookEventEnvelope, type WebhookEventMap, type WebhookEventName, type WebhookEventType, collectAll, isAuthenticationError, isCommentCreatedEvent, isConflictError, isDispatchTicketsError, isNetworkError, isNotFoundError, isRateLimitError, isServerError, isTicketCreatedEvent, isTicketUpdatedEvent, isTimeoutError, isValidationError, parseWebhookEvent, webhookUtils };

package/dist/index.js

@@ -237,7 +237,9 @@ var HttpClient = class {
     return delay + jitter;
   }
   buildUrl(path, query) {
-    const url = new URL(path, this.config.baseUrl);
+    const base = this.config.baseUrl.endsWith("/") ? this.config.baseUrl : `${this.config.baseUrl}/`;
+    const normalizedPath = path.startsWith("/") ? path.slice(1) : path;
+    const url = new URL(normalizedPath, base);
     if (query) {
       for (const [key, value] of Object.entries(query)) {
         if (value !== void 0) {
@@ -1468,6 +1470,146 @@ var PortalTicketsResource = class extends BaseResource {
       signal: options?.signal
     });
   }
+  // ==========================================================================
+  // Attachment Methods
+  // ==========================================================================
+  /**
+   * Initiate a pending attachment upload (before ticket creation)
+   *
+   * Use this to upload files before creating a ticket. After uploading to the
+   * presigned URL, confirm the upload, then pass the attachment IDs when
+   * creating the ticket.
+   *
+   * @param data - Attachment metadata
+   * @param options - Request options
+   * @returns Upload URL and attachment ID
+   *
+   * @example
+   * ```typescript
+   * // 1. Initiate upload
+   * const upload = await portal.tickets.initiatePendingUpload({
+   *   filename: 'screenshot.png',
+   *   contentType: 'image/png',
+   *   size: 12345,
+   * });
+   *
+   * // 2. Upload file to presigned URL
+   * await fetch(upload.uploadUrl, {
+   *   method: 'PUT',
+   *   body: fileBuffer,
+   *   headers: { 'Content-Type': 'image/png' },
+   * });
+   *
+   * // 3. Confirm upload
+   * await portal.tickets.confirmPendingUpload(upload.id);
+   *
+   * // 4. Create ticket with attachment
+   * const ticket = await portal.tickets.create({
+   *   title: 'Bug report',
+   *   body: 'See attached screenshot',
+   *   attachmentIds: [upload.id],
+   * });
+   * ```
+   */
+  async initiatePendingUpload(data, options) {
+    return this._post(
+      "/portal/tickets/attachments/pending",
+      data,
+      options
+    );
+  }
+  /**
+   * Confirm a pending attachment upload
+   *
+   * Call this after successfully uploading the file to the presigned URL.
+   *
+   * @param attachmentId - Attachment ID from initiatePendingUpload
+   * @param options - Request options
+   * @returns Confirmed attachment
+   */
+  async confirmPendingUpload(attachmentId, options) {
+    return this._post(
+      `/portal/tickets/attachments/pending/${attachmentId}/confirm`,
+      {},
+      options
+    );
+  }
+  /**
+   * Initiate attachment upload for an existing ticket
+   *
+   * @param ticketId - Ticket ID
+   * @param data - Attachment metadata
+   * @param options - Request options
+   * @returns Upload URL and attachment ID
+   *
+   * @example
+   * ```typescript
+   * const upload = await portal.tickets.initiateUpload('tkt_abc123', {
+   *   filename: 'document.pdf',
+   *   contentType: 'application/pdf',
+   *   size: 54321,
+   * });
+   *
+   * await fetch(upload.uploadUrl, {
+   *   method: 'PUT',
+   *   body: fileBuffer,
+   *   headers: { 'Content-Type': 'application/pdf' },
+   * });
+   *
+   * await portal.tickets.confirmUpload('tkt_abc123', upload.id);
+   * ```
+   */
+  async initiateUpload(ticketId, data, options) {
+    return this._post(
+      `/portal/tickets/${ticketId}/attachments`,
+      data,
+      options
+    );
+  }
+  /**
+   * Confirm attachment upload for a ticket
+   *
+   * @param ticketId - Ticket ID
+   * @param attachmentId - Attachment ID from initiateUpload
+   * @param options - Request options
+   * @returns Confirmed attachment
+   */
+  async confirmUpload(ticketId, attachmentId, options) {
+    return this._post(
+      `/portal/tickets/${ticketId}/attachments/${attachmentId}/confirm`,
+      {},
+      options
+    );
+  }
+  /**
+   * List attachments on a ticket
+   *
+   * @param ticketId - Ticket ID
+   * @param options - Request options
+   * @returns Array of attachments
+   */
+  async listAttachments(ticketId, options) {
+    return this._get(
+      `/portal/tickets/${ticketId}/attachments`,
+      void 0,
+      options
+    );
+  }
+  /**
+   * Get attachment with download URL
+   *
+   * @param ticketId - Ticket ID
+   * @param attachmentId - Attachment ID
+   * @param options - Request options
+   * @returns Attachment with presigned download URL
+   */
+  async getAttachment(ticketId, attachmentId, options) {
+    return this._get(
+      `/portal/tickets/${ticketId}/attachments/${attachmentId}`,
+      void 0,
+      options
+    );
+  }
   /**
    * Build query parameters from filters
    */