Going exponential with Linear

.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)],
+      },
+    },
+  },
+};