@pipedream/jira_service_desk 0.2.0 → 0.3.0

package/actions/create-comment-on-request/create-comment-on-request.mjs

@@ -4,7 +4,7 @@ export default {
   key: "jira_service_desk-create-comment-on-request",
   name: "Create Comment on Request",
   description: "Create a comment on a customer request. [See the documentation](https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-request/#api-rest-servicedeskapi-request-issueidorkey-comment-post)",
-  version: "0.0.2",
+  version: "0.0.3",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/create-incident/create-incident.mjs

@@ -0,0 +1,107 @@
+import app from "../../jira_service_desk.app.mjs";
+
+export default {
+  key: "jira_service_desk-create-incident",
+  name: "Create Incident",
+  description:
+    "Creates a new incident request in a Jira Service Desk."
+    + " Auto-discovers the best-matching request type (prefers types named 'incident' or 'problem') and, if `serviceDeskId` is omitted, auto-discovers it from the user's existing requests."
+    + " Use **List Sites** first to obtain the required `cloudId`."
+    + " `serviceDeskId` is optional — if not provided, the tool calls **List My Requests** to discover it automatically."
+    + " Returns the new request including its `issueKey` and `issueId`."
+    + " [See the documentation](https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-request/#api-rest-servicedeskapi-request-post)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: false,
+  },
+  props: {
+    app,
+    cloudId: {
+      propDefinition: [
+        app,
+        "cloudId",
+      ],
+    },
+    serviceDeskId: {
+      type: "string",
+      label: "Service Desk ID",
+      description: "The numeric ID of the service desk (e.g. `2`). If omitted, the tool auto-discovers it from your existing requests. You can also find it in your Jira Service Management project settings.",
+      optional: true,
+    },
+    summary: {
+      type: "string",
+      label: "Summary",
+      description: "The title/summary of the incident.",
+    },
+    description: {
+      type: "string",
+      label: "Description",
+      description: "A detailed description of the incident.",
+    },
+  },
+  async run({ $ }) {
+    // Auto-discover serviceDeskId if not provided — extract from existing requests
+    let serviceDeskId = this.serviceDeskId;
+    if (!serviceDeskId) {
+      const existingRequests = await this.app.listMyRequests({
+        $,
+        cloudId: this.cloudId,
+      });
+      if (!existingRequests?.length) {
+        throw new Error("No existing requests found to auto-discover serviceDeskId. Please provide serviceDeskId explicitly.");
+      }
+      const uniqueIds = [
+        ...new Set(existingRequests.map((r) => r.serviceDeskId)),
+      ];
+      if (uniqueIds.length > 1) {
+        throw new Error(
+          `Multiple service desks found (${uniqueIds.join(", ")}). Please provide serviceDeskId explicitly.`,
+        );
+      }
+      serviceDeskId = uniqueIds[0];
+    }
+
+    // Auto-discover the best-matching request type for an incident.
+    // Prefers types named "incident" or "problem"; falls back to first available.
+    const requestTypes = await this.app.getRequestTypes({
+      $,
+      cloudId: this.cloudId,
+      serviceDeskId,
+    });
+
+    if (!requestTypes?.length) {
+      throw new Error(`No request types found in service desk ${serviceDeskId}.`);
+    }
+
+    const INCIDENT_KEYWORDS = [
+      "incident",
+      "problem",
+      "system problem",
+      "issue",
+    ];
+
+    const incidentType = requestTypes.find(({ name }) =>
+      INCIDENT_KEYWORDS.some((kw) => name?.toLowerCase().includes(kw))) || requestTypes[0];
+
+    const requestFieldValues = {
+      summary: this.summary,
+      description: this.description,
+    };
+
+    const response = await this.app.createCustomerRequest({
+      $,
+      cloudId: this.cloudId,
+      data: {
+        serviceDeskId,
+        requestTypeId: incidentType.id,
+        requestFieldValues,
+      },
+    });
+
+    $.export("$summary", `Created ${incidentType.name} ${response.issueKey}: ${this.summary}`);
+    return response;
+  },
+};

package/actions/create-request/create-request.mjs

@@ -5,7 +5,7 @@ export default {
   name: "Create Request",
   description:
     "Creates a new customer request. [See the documentation](https://docs.atlassian.com/jira-servicedesk/REST/3.6.2/#servicedeskapi/request-createCustomerRequest)",
-  version: "0.1.1",
+  version: "0.1.2",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/get-current-user/get-current-user.mjs

@@ -0,0 +1,28 @@
+import app from "../../jira_service_desk.app.mjs";
+
+export default {
+  key: "jira_service_desk-get-current-user",
+  name: "Get Current User",
+  description:
+    "Returns the authenticated user's `account_id`, `display_name`, and `email` from Atlassian."
+    + " Use this to identify who is logged in, or to filter requests by the current user's `account_id`."
+    + " No `cloudId` required — this uses the Atlassian Identity API directly."
+    + " [See the documentation](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    app,
+  },
+  async run({ $ }) {
+    const user = await this.app.getCurrentUser({
+      $,
+    });
+    $.export("$summary", `Current user: ${user.name || user.account_id}`);
+    return user;
+  },
+};

package/actions/get-request/get-request.mjs

@@ -0,0 +1,60 @@
+import app from "../../jira_service_desk.app.mjs";
+
+export default {
+  key: "jira_service_desk-get-request",
+  name: "Get Request",
+  description:
+    "Fetches the full details of a Jira Service Desk request including its field values and complete comment thread in a single response."
+    + " Use this to summarize a ticket without needing follow-up calls."
+    + " Use **List Sites** first to obtain the required `cloudId`."
+    + " Use **List My Requests** to find the `issueKey` of a request (e.g. `IT-42`)."
+    + " [See the documentation](https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-request/#api-rest-servicedeskapi-request-issueidorkey-get)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    app,
+    cloudId: {
+      propDefinition: [
+        app,
+        "cloudId",
+      ],
+    },
+    issueIdOrKey: {
+      propDefinition: [
+        app,
+        "issueIdOrKey",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const [
+      request,
+      comments,
+    ] = await Promise.all([
+      this.app.getRequest({
+        $,
+        cloudId: this.cloudId,
+        issueIdOrKey: this.issueIdOrKey,
+      }),
+      this.app.getRequestComments({
+        $,
+        cloudId: this.cloudId,
+        issueIdOrKey: this.issueIdOrKey,
+      }),
+    ]);
+
+    const summary = request.requestFieldValues?.find?.(({ fieldId }) => fieldId === "summary")?.value
+      || this.issueIdOrKey;
+
+    $.export("$summary", `Request ${request.issueKey}: ${summary} (${comments?.length ?? 0} comment(s))`);
+    return {
+      ...request,
+      comments,
+    };
+  },
+};

package/actions/get-request-status/get-request-status.mjs

@@ -0,0 +1,44 @@
+import app from "../../jira_service_desk.app.mjs";
+
+export default {
+  key: "jira_service_desk-get-request-status",
+  name: "Get Request Status",
+  description:
+    "Returns the status history of a Jira Service Desk request — the current status plus all previous states with timestamps."
+    + " Use this to understand how a request has progressed through the workflow."
+    + " Use **List Sites** first to obtain the required `cloudId`."
+    + " Use **List My Requests** to find the `issueKey` (e.g. `IT-42`)."
+    + " [See the documentation](https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-request/#api-rest-servicedeskapi-request-issueidorkey-status-get)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    app,
+    cloudId: {
+      propDefinition: [
+        app,
+        "cloudId",
+      ],
+    },
+    issueIdOrKey: {
+      propDefinition: [
+        app,
+        "issueIdOrKey",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const statuses = await this.app.getRequestStatus({
+      $,
+      cloudId: this.cloudId,
+      issueIdOrKey: this.issueIdOrKey,
+    });
+    const current = statuses?.[0]?.status || "unknown";
+    $.export("$summary", `Status history for ${this.issueIdOrKey}: current status is "${current}" (${statuses?.length ?? 0} entries)`);
+    return statuses;
+  },
+};

package/actions/list-cloud-id-options/list-cloud-id-options.mjs

@@ -4,7 +4,7 @@ export default {
   key: "jira_service_desk-list-cloud-id-options",
   name: "List Cloud ID Options",
   description: "Retrieves available options for the Cloud ID field.",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/list-my-requests/list-my-requests.mjs

@@ -0,0 +1,68 @@
+import app from "../../jira_service_desk.app.mjs";
+
+export default {
+  key: "jira_service_desk-list-my-requests",
+  name: "List My Requests",
+  description:
+    "Lists Jira Service Desk requests owned or participated in by the current user."
+    + " Defaults to open requests owned by the current user."
+    + " Use **List Sites** first to obtain the required `cloudId`."
+    + " Each result includes `issueKey`, `issueId`, and request field values (summary, status)."
+    + " `requestStatus`: `OPEN_REQUESTS` (default), `CLOSED_REQUESTS`, or `ALL_REQUESTS`."
+    + " `requestOwnership`: `OWNED_REQUESTS` (default) or `PARTICIPATED_REQUESTS`."
+    + " [See the documentation](https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-request/#api-rest-servicedeskapi-request-get)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    app,
+    cloudId: {
+      propDefinition: [
+        app,
+        "cloudId",
+      ],
+    },
+    serviceDeskId: {
+      type: "string",
+      label: "Service Desk ID",
+      description: "Filter results to a specific service desk. Omit to return requests from all service desks.",
+      optional: true,
+    },
+    requestStatus: {
+      type: "string",
+      label: "Request Status",
+      description: "Filter by request status. `OPEN_REQUESTS` (default), `CLOSED_REQUESTS`, or `ALL_REQUESTS`.",
+      options: [
+        "OPEN_REQUESTS",
+        "CLOSED_REQUESTS",
+        "ALL_REQUESTS",
+      ],
+      optional: true,
+    },
+    requestOwnership: {
+      type: "string",
+      label: "Request Ownership",
+      description: "Filter by ownership. `OWNED_REQUESTS` (default) returns requests created by the current user. `PARTICIPATED_REQUESTS` includes requests the user commented on.",
+      options: [
+        "OWNED_REQUESTS",
+        "PARTICIPATED_REQUESTS",
+      ],
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const requests = await this.app.listMyRequests({
+      $,
+      cloudId: this.cloudId,
+      serviceDeskId: this.serviceDeskId,
+      requestStatus: this.requestStatus,
+      requestOwnership: this.requestOwnership,
+    });
+    $.export("$summary", `Found ${requests?.length ?? 0} request(s)`);
+    return requests;
+  },
+};

package/actions/list-request-transitions/list-request-transitions.mjs

@@ -0,0 +1,43 @@
+import app from "../../jira_service_desk.app.mjs";
+
+export default {
+  key: "jira_service_desk-list-request-transitions",
+  name: "List Request Transitions",
+  description:
+    "Lists the available workflow transitions for a Jira Service Desk request — returns each transition's `id` and `name`."
+    + " **Call this before `Transition Request`** to obtain valid `transitionId` values."
+    + " Use **List Sites** first to obtain the required `cloudId`."
+    + " Use **List My Requests** or **Get Request** to find the `issueKey` (e.g. `IT-42`)."
+    + " [See the documentation](https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-request/#api-rest-servicedeskapi-request-issueidorkey-transition-get)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    app,
+    cloudId: {
+      propDefinition: [
+        app,
+        "cloudId",
+      ],
+    },
+    issueIdOrKey: {
+      propDefinition: [
+        app,
+        "issueIdOrKey",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const transitions = await this.app.getRequestTransitions({
+      $,
+      cloudId: this.cloudId,
+      issueIdOrKey: this.issueIdOrKey,
+    });
+    $.export("$summary", `Found ${transitions?.length ?? 0} available transition(s) for ${this.issueIdOrKey}`);
+    return transitions;
+  },
+};

package/actions/list-sites/list-sites.mjs

@@ -0,0 +1,28 @@
+import app from "../../jira_service_desk.app.mjs";
+
+export default {
+  key: "jira_service_desk-list-sites",
+  name: "List Sites",
+  description:
+    "Returns all Atlassian cloud sites accessible to the authenticated user."
+    + " **Call this tool first** to obtain the `cloudId` (returned as `id`) required by every other Jira Service Desk tool."
+    + " Each site includes its `id` (cloudId), `name`, and `url`."
+    + " [See the documentation](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/#3-1-get-the-cloudid-for-your-site)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    app,
+  },
+  async run({ $ }) {
+    const sites = await this.app.getSites({
+      $,
+    });
+    $.export("$summary", `Found ${sites?.length ?? 0} accessible Atlassian site(s)`);
+    return sites;
+  },
+};

package/actions/transition-request/transition-request.mjs

@@ -0,0 +1,67 @@
+import app from "../../jira_service_desk.app.mjs";
+
+export default {
+  key: "jira_service_desk-transition-request",
+  name: "Transition Request",
+  description:
+    "Transitions a Jira Service Desk request to a new workflow status."
+    + " Use **List Request Transitions** first to get valid `transitionId` values for the request."
+    + " Use **List Sites** to obtain the required `cloudId`."
+    + " Use **List My Requests** or **Get Request** to find the `issueKey` (e.g. `IT-42`)."
+    + " Optionally include a comment to explain the transition."
+    + " [See the documentation](https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-request/#api-rest-servicedeskapi-request-issueidorkey-transition-post)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: false,
+  },
+  props: {
+    app,
+    cloudId: {
+      propDefinition: [
+        app,
+        "cloudId",
+      ],
+    },
+    issueIdOrKey: {
+      propDefinition: [
+        app,
+        "issueIdOrKey",
+      ],
+    },
+    transitionId: {
+      type: "string",
+      label: "Transition ID",
+      description: "The ID of the transition to perform. Use **List Request Transitions** to retrieve available transition IDs and names.",
+    },
+    additionalComment: {
+      type: "string",
+      label: "Additional Comment",
+      description: "Optional comment to add when performing the transition.",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const body = {
+      id: this.transitionId,
+    };
+
+    if (this.additionalComment) {
+      body.additionalComment = {
+        body: this.additionalComment,
+      };
+    }
+
+    const response = await this.app.transitionRequest({
+      $,
+      cloudId: this.cloudId,
+      issueIdOrKey: this.issueIdOrKey,
+      data: body,
+    });
+
+    $.export("$summary", `Transitioned request ${this.issueIdOrKey} using transition ID ${this.transitionId}`);
+    return response;
+  },
+};

package/actions/update-issue-fields/update-issue-fields.mjs

@@ -0,0 +1,64 @@
+import app from "../../jira_service_desk.app.mjs";
+
+export default {
+  key: "jira_service_desk-update-issue-fields",
+  name: "Update Issue Fields",
+  description:
+    "Updates fields on an existing Jira Service Desk request via the Jira platform API."
+    + " Use this to change the summary, priority, description, or other fields after a request has been created."
+    + " Use **List Sites** first to obtain the required `cloudId`."
+    + " Use **List My Requests** or **Get Request** to find the `issueKey` (e.g. `IT-42`)."
+    + " `fields` is a JSON object of field name-value pairs."
+    + " Example: `{\"summary\": \"Updated title\", \"priority\": {\"name\": \"High\"}}`."
+    + " [See the documentation](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-put)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: false,
+  },
+  props: {
+    app,
+    cloudId: {
+      propDefinition: [
+        app,
+        "cloudId",
+      ],
+    },
+    issueIdOrKey: {
+      propDefinition: [
+        app,
+        "issueIdOrKey",
+      ],
+    },
+    fields: {
+      type: "string",
+      label: "Fields",
+      description: "JSON object of Jira field name-value pairs to update."
+        + " Example: `{\"summary\": \"New title\", \"priority\": {\"name\": \"High\"}}`."
+        + " Use **Get Request** to see current field values.",
+    },
+  },
+  async run({ $ }) {
+    const fields = JSON.parse(this.fields);
+    if (fields === null || typeof fields !== "object" || Array.isArray(fields)) {
+      throw new Error("`fields` must be a JSON object (e.g. `{\"summary\": \"New title\"}`), not an array or primitive.");
+    }
+
+    await this.app.updateIssueFields({
+      $,
+      cloudId: this.cloudId,
+      issueIdOrKey: this.issueIdOrKey,
+      data: {
+        fields,
+      },
+    });
+
+    $.export("$summary", `Updated fields on issue ${this.issueIdOrKey}`);
+    return {
+      issueIdOrKey: this.issueIdOrKey,
+      updatedFields: Object.keys(fields),
+    };
+  },
+};

package/jira_service_desk.app.mjs

@@ -72,6 +72,11 @@ export default {
         }));
       },
     },
+    issueIdOrKey: {
+      type: "string",
+      label: "Issue ID or Key",
+      description: "The ID or key of the Jira Service Desk request (e.g. `IT-42` or `10001`). Use **List My Requests** to find the `issueKey` of a request.",
+    },
   },
   methods: {
     _baseUrl() {
@@ -89,8 +94,9 @@ export default {
         },
       });
     },
-    async getSites() {
+    async getSites({ $ } = {}) {
       return this._makeRequest({
+        $,
         path: "/oauth/token/accessible-resources",
       });
     },
@@ -101,9 +107,10 @@ export default {
       return response.values;
     },
     async getRequestTypes({
-      cloudId, serviceDeskId,
+      $, cloudId, serviceDeskId,
     }) {
       const response = await this._makeRequest({
+        $,
         path: `/ex/jira/${cloudId}/rest/servicedeskapi/servicedesk/${serviceDeskId}/requesttype`,
       });
       return response.values;
@@ -140,5 +147,79 @@ export default {
         path: `/ex/jira/${cloudId}/rest/servicedeskapi/request/${requestId}/comment`,
       });
     },
+    async getCurrentUser({ $ } = {}) {
+      return this._makeRequest({
+        $,
+        path: "/me",
+      });
+    },
+    async listMyRequests({
+      $, cloudId, serviceDeskId, requestStatus, requestOwnership,
+    }) {
+      const params = {
+        requestStatus: requestStatus || "OPEN_REQUESTS",
+        requestOwnership: requestOwnership || "OWNED_REQUESTS",
+      };
+      if (serviceDeskId) params.serviceDeskId = serviceDeskId;
+      const response = await this._makeRequest({
+        $,
+        path: `/ex/jira/${cloudId}/rest/servicedeskapi/request`,
+        params,
+      });
+      return response.values;
+    },
+    async getRequest({
+      $, cloudId, issueIdOrKey,
+    }) {
+      return this._makeRequest({
+        $,
+        path: `/ex/jira/${cloudId}/rest/servicedeskapi/request/${issueIdOrKey}`,
+      });
+    },
+    async getRequestComments({
+      $, cloudId, issueIdOrKey,
+    }) {
+      const response = await this._makeRequest({
+        $,
+        path: `/ex/jira/${cloudId}/rest/servicedeskapi/request/${issueIdOrKey}/comment`,
+      });
+      return response.values;
+    },
+    async getRequestStatus({
+      $, cloudId, issueIdOrKey,
+    }) {
+      const response = await this._makeRequest({
+        $,
+        path: `/ex/jira/${cloudId}/rest/servicedeskapi/request/${issueIdOrKey}/status`,
+      });
+      return response.values;
+    },
+    async getRequestTransitions({
+      $, cloudId, issueIdOrKey,
+    }) {
+      const response = await this._makeRequest({
+        $,
+        path: `/ex/jira/${cloudId}/rest/servicedeskapi/request/${issueIdOrKey}/transition`,
+      });
+      return response.values;
+    },
+    async transitionRequest({
+      cloudId, issueIdOrKey, ...opts
+    }) {
+      return this._makeRequest({
+        ...opts,
+        method: "POST",
+        path: `/ex/jira/${cloudId}/rest/servicedeskapi/request/${issueIdOrKey}/transition`,
+      });
+    },
+    async updateIssueFields({
+      cloudId, issueIdOrKey, ...opts
+    }) {
+      return this._makeRequest({
+        ...opts,
+        method: "PUT",
+        path: `/ex/jira/${cloudId}/rest/api/3/issue/${issueIdOrKey}`,
+      });
+    },
   },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/jira_service_desk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Pipedream Jira Service Desk Components",
   "main": "jira_service_desk.app.mjs",
   "keywords": [

package/sources/new-request-created/new-request-created.mjs

@@ -6,7 +6,7 @@ export default {
   name: "New Request Created",
   description:
     "Emit new event when a customer request is created. [See the documentation](https://developer.atlassian.com/cloud/jira/service-desk/rest/#api-rest-servicedeskapi-request-get)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "source",
   dedupe: "unique",
   methods: {

package/sources/request-status-updated/request-status-updated.mjs

@@ -6,7 +6,7 @@ export default {
   name: "Request Status Updated",
   description:
     "Emit new event when a customer request is updated. [See the documentation](https://developer.atlassian.com/cloud/jira/service-desk/rest/#api-rest-servicedeskapi-request-get)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "source",
   dedupe: "unique",
   methods: {