Going exponential with Linear (#478)

* Unleash GPT magic

* Clean up after GPT

* All the hooks

* Provisional integration catalog entry

* Sample webhook jobs

* Attachments with alpha warnings

* Remove some verbose logs

* Fix IP restrictions

* Remove tunnel

* Revert "Remove tunnel"

This reverts commit c5b69ce.

* Resolve event name clashes

* Remove circular dependency

* Use correct payload uuid

* Schema fixes

* Fix webhook event name

* Start to Linearify catalog entry

* Remove todo

* More catalog updates

* Make OAuth work

* Rename webhook helper

* Schema juggling

* More discrimination

* Add Issue SLA event

* Simplify triggers

* Handle rate limits

* Fix Project schema

* Payload examples

* Improve event props

* Remove redundant source metadata

* One type to rule them all

* Recursive WithoutFunctions type

* Linear output serializer

* Some tasks

* Update catalog entry

* Dynamic usage sample

* Bump version

* Remove tunnel

* More tasks

* Add optional skipRetrying on runTask errors

* Fail fast on user errors

* Entity getter tasks

* Another couple of tasks

* Token to apiKey

* Sort tasks

* Add filtered issue SLA triggers

* Add docs

* Type fixes

* Job catalog examples

* Serialization helper docs

* Add changeset

* Refactor webhooks

* Enhance properties

* Pagination helper and docs

* Clean up imports

* Change misc catalog job

---------

Co-authored-by: Matt Aitken <[email protected]>

Author: nicktrn

.changeset/strange-gorillas-kick.md

@@ -0,0 +1,6 @@
+---
+"@trigger.dev/sdk": patch
+"@trigger.dev/linear": patch
+---
+
+First release of `@trigger.dev/linear` integration. `io.runTask()` error handlers can now prevent further retries.

.env.example

@@ -31,6 +31,8 @@ CLOUD_AIRTABLE_CLIENT_ID=
 CLOUD_AIRTABLE_CLIENT_SECRET=
 CLOUD_GITHUB_CLIENT_ID=
 CLOUD_GITHUB_CLIENT_SECRET=
+CLOUD_LINEAR_CLIENT_ID=
+CLOUD_LINEAR_CLIENT_SECRET=
 CLOUD_SLACK_APP_HOST=
 CLOUD_SLACK_CLIENT_ID=
 CLOUD_SLACK_CLIENT_SECRET= 

apps/webapp/app/services/externalApis/integrationCatalog.server.ts

@@ -1,5 +1,6 @@
 import { airtable } from "./integrations/airtable";
 import { github } from "./integrations/github";
+import { linear } from "./integrations/linear";
 import { openai } from "./integrations/openai";
 import { plain } from "./integrations/plain";
 import { resend } from "./integrations/resend";
@@ -33,6 +34,7 @@ export class IntegrationCatalog {
 export const integrationCatalog = new IntegrationCatalog({
   airtable,
   github,
+  linear,
   openai,
   plain,
   resend,

apps/webapp/app/services/externalApis/integrations/linear.ts

@@ -0,0 +1,104 @@
+import type { HelpSample, Integration } from "../types";
+
+function usageSample(hasApiKey: boolean): HelpSample {
+  return {
+    title: "Using the client",
+    code: `
+import { Linear } from "@trigger.dev/linear";
+
+const linear = new Linear({
+  id: "__SLUG__",${hasApiKey ? ",\n  apiKey: process.env.LINEAR_API_KEY!" : ""}
+});
+
+client.defineJob({
+  id: "linear-react-to-new-issue",
+  name: "Linear - React To New Issue",
+  version: "0.1.0",
+  integrations: { linear },
+  trigger: linear.onIssueCreated(),
+  run: async (payload, io, ctx) => {
+    await io.linear.createComment("create-comment", {
+      issueId: payload.data.id,
+      body: "Thank's for opening this issue!"
+    });
+
+    await io.linear.createReaction("create-reaction", {
+      issueId: payload.data.id,
+      emoji: "+1"
+    });
+
+    return { payload, ctx };
+  },
+});
+  `,
+  };
+}
+
+export const linear: Integration = {
+  identifier: "linear",
+  name: "Linear",
+  packageName: "@trigger.dev/linear@latest",
+  authenticationMethods: {
+    oauth2: {
+      name: "OAuth",
+      type: "oauth2",
+      client: {
+        id: {
+          envName: "CLOUD_LINEAR_CLIENT_ID",
+        },
+        secret: {
+          envName: "CLOUD_LINEAR_CLIENT_SECRET",
+        },
+      },
+      config: {
+        authorization: {
+          url: "https://linear.app/oauth/authorize",
+          scopeSeparator: ",",
+        },
+        token: {
+          url: "https://api.linear.app/oauth/token",
+          metadata: {},
+        },
+        refresh: {
+          url: "https://linear.app/oauth/authorize",
+        },
+        pkce: false,
+      },
+      scopes: [
+        {
+          name: "write",
+          description:
+            "Grants global write access to the user's account. Use a more targeted scope if you don't need full access.",
+          defaultChecked: true,
+        },
+
+        {
+          name: "issue:create",
+          description: "Grants access to create issues and attachments only.",
+          annotations: [{ label: "Issues" }],
+        },
+
+        {
+          name: "comments:create",
+          description: "Grants access to create new issue comments.",
+          annotations: [{ label: "Comments" }],
+        },
+
+        {
+          name: "admin",
+          description:
+            "Grants full access to admin-level endpoints. Don't use this unless you really need it.",
+        },
+      ],
+      help: {
+        samples: [usageSample(false)],
+      },
+    },
+    apikey: {
+      type: "apikey",
+      help: {
+        samples: [usageSample(true)],
+      },
+    },
+  },
+};