@dispatchtickets/sdk 0.8.0 → 0.8.2

package/dist/index.cjs

@@ -239,7 +239,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) {
@@ -1470,6 +1472,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
    */