@pipedream/linear_app 0.7.0 → 0.7.2

package/actions/create-issue/create-issue.mjs

@@ -4,8 +4,8 @@ export default {
   type: "action",
   key: "linear_app-create-issue",
   name: "Create Issue",
-  description: "Create an issue (API Key). See the docs [here](https://developers.linear.app/docs/graphql/working-with-the-graphql-api#creating-and-editing-issues)",
-  version: "0.4.7",
+  description: "Creates a new issue in Linear. Requires team ID and title. Optional: description, assignee, project, state. Returns response object with success status and issue details. Uses API Key authentication. See Linear docs for additional info [here](https://developers.linear.app/docs/graphql/working-with-the-graphql-api#creating-and-editing-issues).",
+  version: "0.4.9",
   props: {
     linearApp,
     teamId: {

package/actions/get-issue/get-issue.mjs

@@ -3,8 +3,8 @@ import linearApp from "../../linear_app.app.mjs";
 export default {
   key: "linear_app-get-issue",
   name: "Get Issue",
-  description: "Get an issue by ID (API Key). See the docs [here](https://developers.linear.app/docs/graphql/working-with-the-graphql-api)",
-  version: "0.1.7",
+  description: "Retrieves a Linear issue by its ID. Returns complete issue details including title, description, state, assignee, team, project, labels, and timestamps. Uses API Key authentication. See Linear docs for additional info [here](https://developers.linear.app/docs/graphql/working-with-the-graphql-api).",
+  version: "0.1.9",
   type: "action",
   props: {
     linearApp,

package/actions/get-teams/get-teams.mjs

@@ -1,16 +1,31 @@
 import linearApp from "../../linear_app.app.mjs";
+import constants from "../../common/constants.mjs";
 
 export default {
   key: "linear_app-get-teams",
   name: "Get Teams",
-  description: "Get all the teams (API Key). See the docs [here](https://developers.linear.app/docs/graphql/working-with-the-graphql-api)",
-  version: "0.2.7",
+  description: "Retrieves all teams in your Linear workspace. Returns array of team objects with details like ID, name, and key. Supports pagination with configurable limit. Uses API Key authentication. See Linear docs for additional info [here](https://developers.linear.app/docs/graphql/working-with-the-graphql-api).",
+  version: "0.2.9",
   type: "action",
   props: {
     linearApp,
+    limit: {
+      propDefinition: [
+        linearApp,
+        "limit",
+      ],
+      description: "Maximum number of teams to return. Defaults to 20 if not specified.",
+    },
   },
   async run({ $ }) {
-    const { nodes: teams } = await this.linearApp.listTeams();
+    // Use the specified limit or default to a reasonable number
+    const limit = this.limit || constants.DEFAULT_NO_QUERY_LIMIT;
+
+    const variables = {
+      first: limit,
+    };
+
+    const { nodes: teams } = await this.linearApp.listTeams(variables);
 
     $.export("$summary", `Found ${teams.length} teams(s)`);
 

package/actions/search-issues/search-issues.mjs

@@ -1,32 +1,43 @@
 import linearApp from "../../linear_app.app.mjs";
 import utils from "../../common/utils.mjs";
+import constants from "../../common/constants.mjs";
 
 export default {
   key: "linear_app-search-issues",
   name: "Search Issues",
-  description: "Search issues (API Key). See the docs [here](https://developers.linear.app/docs/graphql/working-with-the-graphql-api)",
+  description: "Searches Linear issues by team, project, assignee, labels, state, or text query. Supports pagination, ordering, and archived issues. Returns array of matching issues. Uses API Key authentication. See Linear docs for additional info [here](https://developers.linear.app/docs/graphql/working-with-the-graphql-api).",
   type: "action",
-  version: "0.2.7",
+  version: "0.2.9",
   props: {
     linearApp,
-    query: {
+    teamId: {
       propDefinition: [
         linearApp,
-        "query",
+        "teamId",
       ],
     },
-    teamId: {
+    projectId: {
       propDefinition: [
         linearApp,
-        "teamId",
+        "projectId",
+      ],
+    },
+    query: {
+      propDefinition: [
+        linearApp,
+        "query",
       ],
       optional: true,
     },
-    projectId: {
+    stateId: {
       propDefinition: [
         linearApp,
-        "projectId",
+        "stateId",
+        ({ teamId }) => ({
+          teamId,
+        }),
       ],
+      description: "Filter issues by their workflow state (status). States are scoped to the selected team.",
     },
     assigneeId: {
       propDefinition: [
@@ -52,13 +63,36 @@ export default {
         "includeArchived",
       ],
     },
+    limit: {
+      propDefinition: [
+        linearApp,
+        "limit",
+      ],
+    },
   },
   async run({ $ }) {
     const issues = [];
     let hasNextPage;
     let after;
 
+    // Determine the overall max limit for all pages combined
+    const maxLimit = this.limit || (this.query
+      ? constants.DEFAULT_MAX_RECORDS
+      : constants.DEFAULT_NO_QUERY_LIMIT);
+
+    // For pagination, we'll use a smaller page size
+    const pageSize = Math.min(maxLimit, constants.DEFAULT_LIMIT);
+
     do {
+      // If we've already reached our limit, stop fetching more data
+      if (issues.length >= maxLimit) {
+        break;
+      }
+
+      // Calculate how many more items we need for this page
+      const remainingNeeded = maxLimit - issues.length;
+      const thisPageLimit = Math.min(pageSize, remainingNeeded);
+
       const variables = utils.buildVariables(after, {
         filter: {
           query: this.query,
@@ -66,10 +100,19 @@ export default {
           projectId: this.projectId,
           assigneeId: this.assigneeId,
           issueLabels: this.issueLabels,
+          state: this.stateId
+            ? {
+              id: {
+                eq: this.stateId,
+              },
+            }
+            : undefined,
         },
         orderBy: this.orderBy,
         includeArchived: this.includeArchived,
+        limit: thisPageLimit, // Use calculated limit for this page
       });
+
       const {
         nodes,
         pageInfo,
@@ -78,7 +121,7 @@ export default {
       issues.push(...nodes);
       after = pageInfo.endCursor;
       hasNextPage = pageInfo.hasNextPage;
-    } while (hasNextPage);
+    } while (hasNextPage && issues.length < maxLimit);
 
     $.export("$summary", `Found ${issues.length} issues`);
 

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

@@ -3,9 +3,9 @@ import linearApp from "../../linear_app.app.mjs";
 export default {
   key: "linear_app-update-issue",
   name: "Update Issue",
-  description: "Update an issue (API Key). See the docs [here](https://developers.linear.app/docs/graphql/working-with-the-graphql-api#creating-and-editing-issues)",
+  description: "Updates an existing Linear issue. Can modify title, description, assignee, state, project, team, labels, priority, and dates. Returns updated issue details. Uses API Key authentication. See Linear docs for additional info [here](https://developers.linear.app/docs/graphql/working-with-the-graphql-api#creating-and-editing-issues).",
   type: "action",
-  version: "0.1.7",
+  version: "0.1.9",
   props: {
     linearApp,
     teamId: {

package/common/constants.mjs

@@ -2,6 +2,7 @@ const WEBHOOK_ID = "webhookId";
 const LINEAR_DELIVERY_HEADER = "linear-delivery";
 const DEFAULT_LIMIT = 100;
 const DEFAULT_MAX_RECORDS = 200;
+const DEFAULT_NO_QUERY_LIMIT = 20;
 
 const ACTION = {
   CREATE: "create",
@@ -49,6 +50,7 @@ export default {
   LINEAR_DELIVERY_HEADER,
   DEFAULT_LIMIT,
   DEFAULT_MAX_RECORDS,
+  DEFAULT_NO_QUERY_LIMIT,
   ACTION,
   RESOURCE_TYPE,
   RESOURCE_TYPES,

package/common/utils.mjs

@@ -59,7 +59,17 @@ function buildVariables(endCursor, args) {
   const after = endCursor
     ? `, after: "${endCursor}"`
     : "";
-  return strToObj(`{ filter: { ${filter} }, first: ${constants.DEFAULT_LIMIT}${orderBy}${includeArchived}${after} }`);
+  // Determine the appropriate limit:
+  // 1. Use custom limit if provided
+  // 2. Use a smaller default limit when no query is provided to avoid returning too many results
+  // 3. Otherwise use the standard default limit
+  const limit = args.limit
+    ? args.limit
+    : (args.filter.query
+      ? constants.DEFAULT_LIMIT
+      : constants.DEFAULT_NO_QUERY_LIMIT);
+
+  return strToObj(`{ filter: { ${filter} }, first: ${limit}${orderBy}${includeArchived}${after} }`);
 }
 
 export default {

package/linear_app.app.mjs

@@ -164,7 +164,8 @@ export default {
     query: {
       type: "string",
       label: "Query",
-      description: "Search string to look for",
+      description: "Search string to look for in issue titles. The query is used to filter issues where the title contains the query text (case insensitive).",
+      optional: true,
     },
     orderBy: {
       type: "string",
@@ -179,6 +180,12 @@ export default {
       description: "Should archived resources be included? (default: `false`)",
       optional: true,
     },
+    limit: {
+      type: "integer",
+      label: "Limit",
+      description: "Maximum number of issues to return. If no query is provided, this defaults to 20 to avoid returning too many results.",
+      optional: true,
+    },
   },
   methods: {
     getAxiosHeaders() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/linear_app",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "Pipedream Linear_app Components",
   "main": "linear_app.app.mjs",
   "keywords": [

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

@@ -4,10 +4,10 @@ import constants from "../../common/constants.mjs";
 export default {
   ...common,
   key: "linear_app-comment-created-instant",
-  name: "New Created Comment (Instant)",
-  description: "Emit new event when a new comment is created. [See the documentation](https://developers.linear.app/docs/graphql/webhooks)",
+  name: "New Comment Created (Instant)",
+  description: "Triggers instantly when a new comment is added to an issue in Linear. Returns comment details including content, author, issue reference, and timestamps. Supports filtering by team. See Linear docs for additional info [here](https://developers.linear.app/docs/graphql/webhooks).",
   type: "source",
-  version: "0.1.9",
+  version: "0.1.11",
   dedupe: "unique",
   methods: {
     ...common.methods,

package/sources/common/webhook.mjs

@@ -21,6 +21,13 @@ export default {
         "projectId",
       ],
     },
+    limit: {
+      propDefinition: [
+        linearApp,
+        "limit",
+      ],
+      description: "Maximum number of items to return when polling. Defaults to 20 if not specified.",
+    },
     db: "$.service.db",
   },
   async additionalProps() {
@@ -102,10 +109,14 @@ export default {
       return data?.user?.admin;
     },
     async emitPolledResources() {
+      // Use the specified limit or default to a reasonable number
+      const maxLimit = this.limit || constants.DEFAULT_NO_QUERY_LIMIT;
+
       const stream = this.linearApp.paginateResources({
         resourcesFn: this.getResourcesFn(),
         resourcesFnArgs: this.getResourcesFnArgs(),
         useGraphQl: this.useGraphQl(),
+        max: maxLimit, // Apply the limit to pagination
       });
       const resources = await utils.streamIterator(stream);
 

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

@@ -4,10 +4,10 @@ import constants from "../../common/constants.mjs";
 export default {
   ...common,
   key: "linear_app-issue-created-instant",
-  name: "New Created Issue (Instant)",
-  description: "Emit new event when a new issue is created. [See the documentation](https://developers.linear.app/docs/graphql/webhooks)",
+  name: "New Issue Created (Instant)",
+  description: "Triggers instantly when a new issue is created in Linear. Provides complete issue details including title, description, team, assignee, state, and timestamps. Supports filtering by team and project. See Linear docs for additional info [here](https://developers.linear.app/docs/graphql/webhooks).",
   type: "source",
-  version: "0.3.9",
+  version: "0.3.11",
   dedupe: "unique",
   methods: {
     ...common.methods,

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

@@ -4,10 +4,10 @@ import constants from "../../common/constants.mjs";
 export default {
   ...common,
   key: "linear_app-issue-updated-instant",
-  name: "New Updated Issue (Instant)",
-  description: "Emit new event when an issue is updated. [See the documentation](https://developers.linear.app/docs/graphql/webhooks)",
+  name: "Issue Updated (Instant)",
+  description: "Triggers instantly when any issue is updated in Linear. Provides complete issue details with changes. Supports filtering by team and project. Includes all updates except status changes. See Linear docs for additional info [here](https://developers.linear.app/docs/graphql/webhooks).",
   type: "source",
-  version: "0.3.9",
+  version: "0.3.11",
   dedupe: "unique",
   methods: {
     ...common.methods,

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

@@ -5,10 +5,10 @@ import utils from "../../common/utils.mjs";
 export default {
   ...common,
   key: "linear_app-new-issue-status-updated",
-  name: "New Issue Status Updated (Instant)",
-  description: "Emit new event when the status of an issue is updated. [See the documentation](https://developers.linear.app/docs/graphql/webhooks)",
+  name: "Issue Status Updated (Instant)",
+  description: "Triggers instantly when an issue's workflow state changes (e.g., Todo to In Progress). Returns issue with previous and current state info. Can filter by specific target state. See Linear docs for additional info [here](https://developers.linear.app/docs/graphql/webhooks).",
   type: "source",
-  version: "0.1.9",
+  version: "0.1.11",
   dedupe: "unique",
   props: {
     linearApp: common.props.linearApp,
@@ -108,11 +108,14 @@ export default {
       const previousStatuses = this._getPreviousStatuses();
       const newStatuses = {};
 
+      // Use the specified limit or default to a reasonable number
+      const maxLimit = this.limit || constants.DEFAULT_NO_QUERY_LIMIT;
+
       const stream = this.linearApp.paginateResources({
         resourcesFn: this.getResourcesFn(),
         resourcesFnArgs: this.getResourcesFnArgs(),
         useGraphQl: this.useGraphQl(),
-        max: 1000,
+        max: maxLimit, // Use the configured limit instead of hardcoded 1000
       });
       const resources = await utils.streamIterator(stream);
 

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

@@ -6,9 +6,9 @@ export default {
   ...common,
   key: "linear_app-new-projectupdate-created",
   name: "New Project Update Written (Instant)",
-  description: "Project updates are short status reports on the health of your projects. Emit new event when a new Project Update is written. [See the documentation](https://developers.linear.app/docs/graphql/webhooks)",
+  description: "Triggers instantly when a project update (status report) is created in Linear. Returns update content, author, project details, and health status. Filters by team and optionally by project. See Linear docs for additional info [here](https://developers.linear.app/docs/graphql/webhooks).",
   type: "source",
-  version: "0.0.1",
+  version: "0.0.3",
   dedupe: "unique",
   props: {
     linearApp,

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

@@ -5,10 +5,10 @@ import linearApp from "../../linear_app.app.mjs";
 export default {
   ...common,
   key: "linear_app-project-updated-instant",
-  name: "New Updated Project (Instant)",
-  description: "Emit new event when a project is updated. [See the documentation](https://developers.linear.app/docs/graphql/webhooks)",
+  name: "Project Updated (Instant)",
+  description: "Triggers instantly when a project is updated in Linear. Returns project details including name, description, status, dates, and team info. Supports filtering by specific teams. See Linear docs for additional info [here](https://developers.linear.app/docs/graphql/webhooks).",
   type: "source",
-  version: "0.0.2",
+  version: "0.0.4",
   dedupe: "unique",
   props: {
     linearApp,