@pipedream/linear_app 0.5.5 → 0.5.6

package/README.md

@@ -1,8 +1,11 @@
 # Overview
 
-With the Linear API, you can manage your workflow, track issues, and automate
-your development process. Here are some examples of what you can build:
+Linear helps streamline software project management, bug tracking, and task coordination. By using the Linear (API key) API with Pipedream, you can automate routine tasks, sync issues across platforms, and trigger custom workflows. Think auto-assignment of tasks based on specific triggers or pushing updates to a Slack channel when an issue's status changes. These automations save time and ensure that your development team stays focused on coding rather than on administrative overhead.
 
-- A custom workflow management tool
-- A tool to track issues and feature requests
-- A development process automation tool
+# Example Use Cases
+
+- **Sync Issues with Google Sheets**: Use Pipedream to monitor new issues in Linear and automatically add them to a Google Sheets spreadsheet. This can help with reporting, auditing, and providing a high-level overview of tasks without needing to access Linear directly.
+
+- **Automate Task Assignment Based on Labels**: When a new issue is created in Linear with a specific label (e.g., "urgent"), you can set up a Pipedream workflow to automatically assign it to a designated team member or escalate it by creating a high-priority notification in your team's messaging app, like Slack or Microsoft Teams.
+
+- **Create GitHub Issues from Linear Tasks**: For development teams using both Linear and GitHub, a workflow can be set up to create a new GitHub issue whenever a Linear task reaches a certain stage or is tagged for development. This ensures that your code repository is always in sync with your project management tool.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/linear_app",
-  "version": "0.5.5",
+  "version": "0.5.6",
   "description": "Pipedream Linear_app Components",
   "main": "linear_app.app.mjs",
   "keywords": [
@@ -15,6 +15,6 @@
   },
   "dependencies": {
     "@linear/sdk": "^13.0.0",
-    "@pipedream/platform": "^1.3.0"
+    "@pipedream/platform": "^3.0.3"
   }
 }

package/sources/comment-created-instant/comment-created-instant.mjs

@@ -7,7 +7,7 @@ export default {
   name: "New Created Comment (Instant)",
   description: "Emit new event when a new comment is created. See the docs [here](https://developers.linear.app/docs/graphql/webhooks)",
   type: "source",
-  version: "0.1.5",
+  version: "0.1.6",
   dedupe: "unique",
   methods: {
     ...common.methods,

package/sources/common/webhook.mjs

@@ -1,6 +1,7 @@
 import linearApp from "../../linear_app.app.mjs";
 import constants from "../../common/constants.mjs";
 import utils from "../../common/utils.mjs";
+import { ConfigurationError } from "@pipedream/platform";
 
 export default {
   props: {
@@ -12,6 +13,7 @@ export default {
         linearApp,
         "teamId",
       ],
+      reloadProps: true,
     },
     projectId: {
       propDefinition: [
@@ -22,6 +24,17 @@ export default {
     http: "$.interface.http",
     db: "$.service.db",
   },
+  async additionalProps() {
+    const props = {};
+    if (!(await this.isAdmin())) {
+      props.alert = {
+        type: "alert",
+        alertType: "error",
+        content: "You must have an admin role to create or manage webhooks. See the Linear [documentation](https://linear.app/docs/api-and-webhooks#webhooks) for details.",
+      };
+    }
+    return props;
+  },
   methods: {
     setWebhookId(teamId, id) {
       this.db.set(`webhook-${teamId}`, id);
@@ -59,9 +72,26 @@ export default {
     getLoadedProjectId() {
       throw new Error("Get loaded project ID not implemented");
     },
+    async isAdmin() {
+      const { data } = await this.linearApp.makeAxiosRequest({
+        method: "POST",
+        data: {
+          "query": `{ 
+            user(id: "me") {
+              admin
+            }
+          }`,
+        },
+      });
+      return data?.user?.admin;
+    },
   },
   hooks: {
     async deploy() {
+      if (!(await this.isAdmin())) {
+        throw new ConfigurationError("You must have an admin role to create or manage webhooks. See the Linear [documentation](https://linear.app/docs/api-and-webhooks#webhooks) for details.");
+      }
+
       // Retrieve historical events
       console.log("Retrieving historical events...");
       const stream = this.linearApp.paginateResources({

package/sources/issue-created-instant/issue-created-instant.mjs

@@ -7,7 +7,7 @@ export default {
   name: "New Created Issue (Instant)",
   description: "Emit new event when a new issue is created. See the docs [here](https://developers.linear.app/docs/graphql/webhooks)",
   type: "source",
-  version: "0.3.5",
+  version: "0.3.6",
   dedupe: "unique",
   methods: {
     ...common.methods,

package/sources/issue-updated-instant/issue-updated-instant.mjs

@@ -7,7 +7,7 @@ export default {
   name: "New Updated Issue (Instant)",
   description: "Emit new event when an issue is updated. See the docs [here](https://developers.linear.app/docs/graphql/webhooks)",
   type: "source",
-  version: "0.3.5",
+  version: "0.3.6",
   dedupe: "unique",
   methods: {
     ...common.methods,

package/sources/new-issue-status-updated/new-issue-status-updated.mjs

@@ -7,7 +7,7 @@ export default {
   name: "New Issue Status Updated (Instant)",
   description: "Emit new event when the status of an issue is updated. See the docs [here](https://developers.linear.app/docs/graphql/webhooks)",
   type: "source",
-  version: "0.1.5",
+  version: "0.1.6",
   dedupe: "unique",
   props: {
     linearApp: common.props.linearApp,