semantic-release-linear-app 0.3.0 → 0.4.0-next.2

package/README.md

@@ -25,7 +25,7 @@ npm install --save-dev semantic-release-linear-app
 }
 ```
 
-2. Set `LINEAR_API_KEY` environment variable (create at Linear Settings > API)
+2. Set `LINEAR_TOKEN` environment variable (see [Authentication](#authentication) below)
 
 3. Use branch names with Linear issue IDs:
 
@@ -45,6 +45,29 @@ ENG-789
 | `addComment` | `false` | Add release comment to issues |
 | `dryRun` | `false` | Preview without making changes |
 
+## How it Works
+
+This plugin hooks into two semantic-release lifecycle stages:
+
+```mermaid
+flowchart LR
+    subgraph semantic-release
+        A[verifyConditions] --> B[analyzeCommits]
+        B --> C[generateNotes]
+        C --> D[publish]
+        D --> E[success]
+    end
+
+    A -. "validate Linear auth" .-> A
+    E -. "update Linear issues" .-> E
+```
+
+1. **verifyConditions** - Validates your `LINEAR_TOKEN` and tests the API connection
+2. **success** - After release is published:
+   - Finds branches containing the release commits
+   - Extracts issue IDs from branch names (e.g., `ENG-123`)
+   - Creates/applies version label to each issue
+
 ## Labels
 
 Labels are created based on version and channel:
@@ -54,8 +77,23 @@ Labels are created based on version and channel:
 
 Colors indicate release type: red (major), orange (minor), green (patch), purple (prerelease).
 
-## License
+## Authentication
+
+Set `LINEAR_TOKEN` environment variable with either:
+
+### API Key (Simple)
+Actions appear as your personal account.
+1. Go to Linear Settings > API > Personal API keys
+2. Create new key
+3. Set as `LINEAR_TOKEN`
 
-MIT
+### OAuth Access Token (Recommended for CI)
+Actions appear as your app name instead of a user.
+1. Go to Linear Settings > API > Applications
+2. Create new application, enable "Client credentials tokens"
+3. Use client credentials to get an access token ([docs](https://linear.app/developers/oauth-2-0-authentication))
+4. Set the access token as `LINEAR_TOKEN`
+
+## License
 
-<!-- SD-1135 e2e test v3 -->
+MIT

package/dist/index.d.ts

@@ -2,7 +2,7 @@
  * semantic-release-linear-app
  * A semantic-release plugin to update Linear issues with version labels
  */
-import { verifyConditions } from "./lib/verify";
-import { success } from "./lib/success";
+import { verifyConditions } from './lib/verify.js';
+import { success } from './lib/success.js';
 export { verifyConditions, success };
-export type { PluginConfig } from "./types";
+export type { PluginConfig } from './types.js';

package/dist/index.js

@@ -1,11 +1,7 @@
-"use strict";
 /**
  * semantic-release-linear-app
  * A semantic-release plugin to update Linear issues with version labels
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.success = exports.verifyConditions = void 0;
-const verify_1 = require("./lib/verify");
-Object.defineProperty(exports, "verifyConditions", { enumerable: true, get: function () { return verify_1.verifyConditions; } });
-const success_1 = require("./lib/success");
-Object.defineProperty(exports, "success", { enumerable: true, get: function () { return success_1.success; } });
+import { verifyConditions } from './lib/verify.js';
+import { success } from './lib/success.js';
+export { verifyConditions, success };

package/dist/lib/context.d.ts

@@ -1,4 +1,4 @@
-import { LinearContext } from '../types';
+import { LinearContext } from '../types.js';
 /** Store Linear context for access across hooks */
 export declare function setLinearContext(ctx: LinearContext): void;
 export declare function getLinearContext(): LinearContext | null;

package/dist/lib/context.js

@@ -1,7 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setLinearContext = setLinearContext;
-exports.getLinearContext = getLinearContext;
 /**
  * Module-level storage for Linear context between semantic-release hooks.
  * semantic-release creates separate context objects per hook, so we need
@@ -9,9 +5,9 @@ exports.getLinearContext = getLinearContext;
  */
 let linearContext = null;
 /** Store Linear context for access across hooks */
-function setLinearContext(ctx) {
+export function setLinearContext(ctx) {
     linearContext = ctx;
 }
-function getLinearContext() {
+export function getLinearContext() {
     return linearContext;
 }

package/dist/lib/linear-client.d.ts

@@ -1,4 +1,4 @@
-import { LinearIssue, LinearLabel, LinearViewer } from '../types';
+import { LinearIssue, LinearLabel, LinearViewer } from '../types.js';
 /**
  * Linear API client for GraphQL operations
  */

package/dist/lib/linear-client.js

@@ -1,14 +1,8 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LinearClient = void 0;
-const node_fetch_1 = __importDefault(require("node-fetch"));
+import fetch from 'node-fetch';
 /**
  * Linear API client for GraphQL operations
  */
-class LinearClient {
+export class LinearClient {
     apiKey;
     apiUrl = 'https://api.linear.app/graphql';
     constructor(apiKey) {
@@ -18,7 +12,7 @@ class LinearClient {
      * Execute a GraphQL query
      */
     async query(query, variables = {}) {
-        const response = await (0, node_fetch_1.default)(this.apiUrl, {
+        const response = await fetch(this.apiUrl, {
             method: 'POST',
             headers: {
                 Authorization: this.apiKey,
@@ -192,4 +186,3 @@ class LinearClient {
         return data.commentCreate.comment;
     }
 }
-exports.LinearClient = LinearClient;

package/dist/lib/parse-issues.js

@@ -1,17 +1,14 @@
-"use strict";
 /**
  * Extract Linear issue IDs from branch name ONLY
  * This enforces a single source of truth for issue tracking
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseIssuesFromBranch = parseIssuesFromBranch;
 /**
  * Extract Linear issue IDs from a branch name
  * @param branchName - The branch name to parse
  * @param teamKeys - Optional list of team keys to filter by
  * @returns Array of unique issue identifiers
  */
-function parseIssuesFromBranch(branchName, teamKeys = null) {
+export function parseIssuesFromBranch(branchName, teamKeys = null) {
     const issues = new Set();
     // Build regex pattern based on team keys
     const teamPattern = teamKeys ? `(?:${teamKeys.join('|')})` : '[A-Z]+';

package/dist/lib/parse-issues.test.js

@@ -1,26 +1,25 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const parse_issues_1 = require("./parse-issues");
+import { describe, test, expect } from '@jest/globals';
+import { parseIssuesFromBranch } from './parse-issues.js';
 describe('parse-issues', () => {
     test('extracts Linear issue IDs from branch name', () => {
         const branchName = 'feature/ENG-123-add-new-feature';
-        const result = (0, parse_issues_1.parseIssuesFromBranch)(branchName);
+        const result = parseIssuesFromBranch(branchName);
         expect(result).toEqual(['ENG-123']);
     });
     test('extracts multiple issue IDs from branch name', () => {
         const branchName = 'fix/ENG-123-FEAT-456-bug-fix';
-        const result = (0, parse_issues_1.parseIssuesFromBranch)(branchName);
+        const result = parseIssuesFromBranch(branchName);
         expect(result).toEqual(expect.arrayContaining(['ENG-123', 'FEAT-456']));
         expect(result).toHaveLength(2);
     });
     test('filters by team keys when provided', () => {
         const branchName = 'feature/ENG-123-OTHER-456';
-        const result = (0, parse_issues_1.parseIssuesFromBranch)(branchName, ['ENG']);
+        const result = parseIssuesFromBranch(branchName, ['ENG']);
         expect(result).toEqual(['ENG-123']);
     });
     test('returns empty array for branch without issues', () => {
         const branchName = 'feature/no-issues-here';
-        const result = (0, parse_issues_1.parseIssuesFromBranch)(branchName);
+        const result = parseIssuesFromBranch(branchName);
         expect(result).toEqual([]);
     });
 });

package/dist/lib/success.d.ts

@@ -1,5 +1,5 @@
 import { SuccessContext } from 'semantic-release';
-import { PluginConfig } from '../types';
+import { PluginConfig } from '../types.js';
 /**
  * Update Linear issues after a successful release
  */

package/dist/lib/success.js

@@ -1,10 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.success = success;
-const execa_1 = require("execa");
-const linear_client_1 = require("./linear-client");
-const parse_issues_1 = require("./parse-issues");
-const context_1 = require("./context");
+import { execa } from 'execa';
+import { LinearClient } from './linear-client.js';
+import { parseIssuesFromBranch } from './parse-issues.js';
+import { getLinearContext } from './context.js';
 /**
  * Find source branches that contain the given commits
  */
@@ -16,7 +13,7 @@ async function findSourceBranches(commits, logger) {
     // Check all commits to find all source branches
     for (const commit of commits) {
         try {
-            const { stdout } = await (0, execa_1.execa)('git', [
+            const { stdout } = await execa('git', [
                 'branch',
                 '-r',
                 '--contains',
@@ -43,9 +40,9 @@ async function findSourceBranches(commits, logger) {
 /**
  * Update Linear issues after a successful release
  */
-async function success(pluginConfig, context) {
+export async function success(pluginConfig, context) {
     const { logger, nextRelease, commits } = context;
-    const linear = (0, context_1.getLinearContext)();
+    const linear = getLinearContext();
     if (!linear) {
         logger.log('Linear context not found, skipping issue updates');
         return;
@@ -64,7 +61,7 @@ async function success(pluginConfig, context) {
     // Extract Linear issue IDs from all found branches
     const issueIds = new Set();
     for (const branchName of Array.from(sourceBranches)) {
-        const branchIssues = (0, parse_issues_1.parseIssuesFromBranch)(branchName, linear.teamKeys);
+        const branchIssues = parseIssuesFromBranch(branchName, linear.teamKeys);
         branchIssues.forEach((id) => issueIds.add(id));
     }
     if (issueIds.size === 0) {
@@ -82,7 +79,7 @@ async function success(pluginConfig, context) {
         return;
     }
     // Initialize Linear client and prepare label
-    const client = new linear_client_1.LinearClient(linear.apiKey);
+    const client = new LinearClient(linear.apiKey);
     const labelColor = getLabelColor(nextRelease.type);
     // Ensure the version label exists
     const label = await client.ensureLabel(labelName, labelColor);

package/dist/lib/verify.d.ts

@@ -1,5 +1,5 @@
 import { VerifyConditionsContext } from 'semantic-release';
-import { PluginConfig } from '../types';
+import { PluginConfig } from '../types.js';
 /**
  * Verify the plugin configuration and Linear API access
  */

package/dist/lib/verify.js

@@ -1,44 +1,38 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.verifyConditions = verifyConditions;
-const error_1 = __importDefault(require("@semantic-release/error"));
-const linear_client_1 = require("./linear-client");
-const context_1 = require("./context");
+import SemanticReleaseError from '@semantic-release/error';
+import { LinearClient } from './linear-client.js';
+import { setLinearContext } from './context.js';
 /**
  * Verify the plugin configuration and Linear API access
  */
-async function verifyConditions(pluginConfig, context) {
+export async function verifyConditions(pluginConfig, context) {
     const { logger } = context;
-    const { apiKey, teamKeys = [] } = pluginConfig;
-    // Check for API key in config or environment
-    const linearApiKey = apiKey || process.env.LINEAR_API_KEY;
-    if (!linearApiKey) {
-        throw new error_1.default('No Linear API key found', 'ENOLINEARTOKEN', 'Please provide a Linear API key via plugin config or LINEAR_API_KEY environment variable.');
+    const { token, teamKeys = [] } = pluginConfig;
+    // Check for token in config or environment
+    const linearToken = token || process.env.LINEAR_TOKEN;
+    if (!linearToken) {
+        throw new SemanticReleaseError('No Linear token found', 'ENOLINEARTOKEN', 'Please provide LINEAR_TOKEN environment variable.');
     }
     // Validate team keys format if provided
     const teamKeyPattern = /^[A-Z]+$/;
     const branchPattern = /^[A-Za-z0-9._-]+\/[A-Za-z0-9][A-Za-z0-9._-]*$/;
     const invalidTeamKeys = teamKeys.filter((key) => !teamKeyPattern.test(key) && !branchPattern.test(key));
     if (invalidTeamKeys.length > 0) {
-        throw new error_1.default('Invalid team key format', 'EINVALIDTEAMKEY', 'Team keys must be uppercase letters (e.g. SD) or branch names (e.g. caio/tk-519-title). ' +
+        throw new SemanticReleaseError('Invalid team key format', 'EINVALIDTEAMKEY', 'Team keys must be uppercase letters (e.g. SD) or branch names (e.g. caio/tk-519-title). ' +
             `Invalid: ${invalidTeamKeys.join(', ')}`);
     }
     // Test API connection
-    const client = new linear_client_1.LinearClient(linearApiKey);
+    const client = new LinearClient(linearToken);
     try {
         logger.log('Verifying Linear API access...');
         await client.testConnection();
         logger.log('✓ Linear API access verified');
     }
     catch (error) {
-        throw new error_1.default('Failed to connect to Linear API', 'ELINEARCONNECTION', `Could not connect to Linear API: ${error.message}`);
+        throw new SemanticReleaseError('Failed to connect to Linear API', 'ELINEARCONNECTION', `Could not connect to Linear API: ${error.message}`);
     }
     // Store validated config for other lifecycle methods
-    (0, context_1.setLinearContext)({
-        apiKey: linearApiKey,
+    setLinearContext({
+        apiKey: linearToken,
         teamKeys: teamKeys.length > 0 ? teamKeys : null,
         labelPrefix: pluginConfig.labelPrefix || 'v',
     });

package/dist/lib/verify.test.js

@@ -1,7 +1,6 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-// Minimal ESM mocks
-jest.mock('@semantic-release/error', () => {
+import { jest, describe, test, expect, beforeEach } from '@jest/globals';
+// ESM mocks must be set up before imports
+jest.unstable_mockModule('@semantic-release/error', () => {
     class SemanticReleaseError extends Error {
         code;
         constructor(message, code) {
@@ -9,33 +8,33 @@ jest.mock('@semantic-release/error', () => {
             this.code = code;
         }
     }
-    return { __esModule: true, default: SemanticReleaseError };
+    return { default: SemanticReleaseError };
 });
-jest.mock('./linear-client', () => ({
-    LinearClient: jest.fn().mockImplementation(() => ({
-        testConnection: jest.fn().mockResolvedValue({}),
+jest.unstable_mockModule('./linear-client.js', () => ({
+    LinearClient: jest.fn(() => ({
+        testConnection: jest.fn(() => Promise.resolve({})),
     })),
 }));
-jest.mock('node-fetch', () => ({ __esModule: true, default: jest.fn() }));
-const verify_1 = require("./verify");
+jest.unstable_mockModule('node-fetch', () => ({ default: jest.fn() }));
+const { verifyConditions } = await import('./verify.js');
 describe('verify', () => {
     const mockContext = {
         logger: { log: jest.fn(), error: jest.fn() },
     };
     beforeEach(() => {
-        delete process.env.LINEAR_API_KEY;
+        delete process.env.LINEAR_TOKEN;
     });
-    test('throws without API key', async () => {
-        await expect((0, verify_1.verifyConditions)({}, mockContext)).rejects.toThrow('No Linear API key found');
+    test('throws without token', async () => {
+        await expect(verifyConditions({}, mockContext)).rejects.toThrow('No Linear token found');
     });
     test('validates team key format', async () => {
         // Validation happens BEFORE the API call, so it fails fast
-        await expect((0, verify_1.verifyConditions)({ apiKey: 'test', teamKeys: ['eng-123'] }, mockContext)).rejects.toThrow('Invalid team key format');
+        await expect(verifyConditions({ token: 'test', teamKeys: ['eng-123'] }, mockContext)).rejects.toThrow('Invalid team key format');
     });
     test('accepts valid branch like team key', async () => {
         // Accepts branch patterns without hitting API
-        await expect((0, verify_1.verifyConditions)({
-            apiKey: 'test',
+        await expect(verifyConditions({
+            token: 'test',
             teamKeys: ['caio/tk-519-title'],
         }, mockContext)).resolves.toBeUndefined();
     });

package/dist/types.d.ts

@@ -1,6 +1,6 @@
 export interface PluginConfig {
-    /** Linear API key (can also use LINEAR_API_KEY env var) */
-    apiKey?: string;
+    /** Linear token - API key or OAuth access token (can also use LINEAR_TOKEN env var) */
+    token?: string;
     /** Team keys to filter issues (e.g., ["ENG", "FEAT"]) */
     teamKeys?: string[];
     /** Prefix for version labels (default: "v") */

package/dist/types.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/package.json

@@ -1,7 +1,8 @@
 {
     "name": "semantic-release-linear-app",
-    "version": "0.3.0",
+    "version": "0.4.0-next.2",
     "description": "Semantic-release plugin to update Linear issues with version labels",
+    "type": "module",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
     "engines": {
@@ -17,12 +18,27 @@
         "lint": "eslint src/**/*.ts",
         "format": "prettier --write src/**/*.ts",
         "prepare": "husky",
-        "test": "jest",
-        "test:watch": "jest --watch"
+        "test": "NODE_OPTIONS='--experimental-vm-modules' jest",
+        "test:watch": "jest --watch",
+        "validate": "pnpm lint && pnpm type-check && pnpm build && pnpm test"
     },
     "jest": {
-        "preset": "ts-jest",
+        "preset": "ts-jest/presets/default-esm",
         "testEnvironment": "node",
+        "extensionsToTreatAsEsm": [
+            ".ts"
+        ],
+        "moduleNameMapper": {
+            "^(\\.{1,2}/.*)\\.js$": "$1"
+        },
+        "transform": {
+            "^.+\\.tsx?$": [
+                "ts-jest",
+                {
+                    "useESM": true
+                }
+            ]
+        },
         "testMatch": [
             "**/*.test.ts"
         ]
@@ -39,7 +55,7 @@
     "license": "MIT",
     "repository": {
         "type": "git",
-        "url": "https://github.com/caiopizzol/semantic-release-linear.git"
+        "url": "https://github.com/caiopizzol/semantic-release-linear-app.git"
     },
     "peerDependencies": {
         "semantic-release": ">=20.0.0"
@@ -50,6 +66,7 @@
         "node-fetch": "^3.3.2"
     },
     "devDependencies": {
+        "@jest/globals": "^30.2.0",
         "@semantic-release/commit-analyzer": "^13.0.1",
         "@semantic-release/git": "^10.0.1",
         "@semantic-release/github": "^12.0.2",
@@ -77,8 +94,7 @@
     "lint-staged": {
         "*.ts": [
             "eslint --fix",
-            "prettier --write",
-            "tsc --noEmit"
+            "prettier --write"
         ]
     }
 }

package/src/index.ts

@@ -3,10 +3,10 @@
  * A semantic-release plugin to update Linear issues with version labels
  */
 
-import { verifyConditions } from "./lib/verify";
-import { success } from "./lib/success";
+import { verifyConditions } from './lib/verify.js';
+import { success } from './lib/success.js';
 
 export { verifyConditions, success };
 
 // Also export types for consumers who use TypeScript
-export type { PluginConfig } from "./types";
+export type { PluginConfig } from './types.js';

package/src/lib/context.ts

@@ -1,4 +1,4 @@
-import { LinearContext } from '../types';
+import { LinearContext } from '../types.js';
 
 /**
  * Module-level storage for Linear context between semantic-release hooks.

package/src/lib/linear-client.ts

@@ -1,5 +1,5 @@
 import fetch from 'node-fetch';
-import { LinearIssue, LinearLabel, LinearViewer } from '../types';
+import { LinearIssue, LinearLabel, LinearViewer } from '../types.js';
 
 interface GraphQLResponse<T> {
   data?: T;

package/src/lib/parse-issues.test.ts

@@ -1,4 +1,5 @@
-import { parseIssuesFromBranch } from './parse-issues';
+import { describe, test, expect } from '@jest/globals';
+import { parseIssuesFromBranch } from './parse-issues.js';
 
 describe('parse-issues', () => {
   test('extracts Linear issue IDs from branch name', () => {

package/src/lib/success.ts

@@ -1,9 +1,9 @@
 import { SuccessContext } from 'semantic-release';
 import { execa } from 'execa';
-import { LinearClient } from './linear-client';
-import { parseIssuesFromBranch } from './parse-issues';
-import { PluginConfig, ReleaseType } from '../types';
-import { getLinearContext } from './context';
+import { LinearClient } from './linear-client.js';
+import { parseIssuesFromBranch } from './parse-issues.js';
+import { PluginConfig, ReleaseType } from '../types.js';
+import { getLinearContext } from './context.js';
 
 /**
  * Find source branches that contain the given commits

package/src/lib/verify.test.ts

@@ -1,5 +1,7 @@
-// Minimal ESM mocks
-jest.mock('@semantic-release/error', () => {
+import { jest, describe, test, expect, beforeEach } from '@jest/globals';
+
+// ESM mocks must be set up before imports
+jest.unstable_mockModule('@semantic-release/error', () => {
   class SemanticReleaseError extends Error {
     code: string;
     constructor(message: string, code: string) {
@@ -7,37 +9,37 @@ jest.mock('@semantic-release/error', () => {
       this.code = code;
     }
   }
-  return { __esModule: true, default: SemanticReleaseError };
+  return { default: SemanticReleaseError };
 });
 
-jest.mock('./linear-client', () => ({
-  LinearClient: jest.fn().mockImplementation(() => ({
-    testConnection: jest.fn().mockResolvedValue({}),
+jest.unstable_mockModule('./linear-client.js', () => ({
+  LinearClient: jest.fn(() => ({
+    testConnection: jest.fn(() => Promise.resolve({})),
   })),
 }));
 
-jest.mock('node-fetch', () => ({ __esModule: true, default: jest.fn() }));
+jest.unstable_mockModule('node-fetch', () => ({ default: jest.fn() }));
 
-import { verifyConditions } from './verify';
-import { VerifyConditionsContext } from 'semantic-release';
+const { verifyConditions } = await import('./verify.js');
+import type { VerifyConditionsContext } from 'semantic-release';
 
 describe('verify', () => {
   const mockContext = {
     logger: { log: jest.fn(), error: jest.fn() },
-  } as VerifyConditionsContext;
+  } as unknown as VerifyConditionsContext;
 
   beforeEach(() => {
-    delete process.env.LINEAR_API_KEY;
+    delete process.env.LINEAR_TOKEN;
   });
 
-  test('throws without API key', async () => {
-    await expect(verifyConditions({}, mockContext)).rejects.toThrow('No Linear API key found');
+  test('throws without token', async () => {
+    await expect(verifyConditions({}, mockContext)).rejects.toThrow('No Linear token found');
   });
 
   test('validates team key format', async () => {
     // Validation happens BEFORE the API call, so it fails fast
     await expect(
-      verifyConditions({ apiKey: 'test', teamKeys: ['eng-123'] }, mockContext),
+      verifyConditions({ token: 'test', teamKeys: ['eng-123'] }, mockContext),
     ).rejects.toThrow('Invalid team key format');
   });
 
@@ -46,7 +48,7 @@ describe('verify', () => {
     await expect(
       verifyConditions(
         {
-          apiKey: 'test',
+          token: 'test',
           teamKeys: ['caio/tk-519-title'],
         },
         mockContext,

package/src/lib/verify.ts

@@ -1,8 +1,8 @@
 import SemanticReleaseError from '@semantic-release/error';
 import { VerifyConditionsContext } from 'semantic-release';
-import { LinearClient } from './linear-client';
-import { PluginConfig } from '../types';
-import { setLinearContext } from './context';
+import { LinearClient } from './linear-client.js';
+import { PluginConfig } from '../types.js';
+import { setLinearContext } from './context.js';
 
 /**
  * Verify the plugin configuration and Linear API access
@@ -12,16 +12,16 @@ export async function verifyConditions(
   context: VerifyConditionsContext,
 ): Promise<void> {
   const { logger } = context;
-  const { apiKey, teamKeys = [] } = pluginConfig;
+  const { token, teamKeys = [] } = pluginConfig;
 
-  // Check for API key in config or environment
-  const linearApiKey = apiKey || process.env.LINEAR_API_KEY;
+  // Check for token in config or environment
+  const linearToken = token || process.env.LINEAR_TOKEN;
 
-  if (!linearApiKey) {
+  if (!linearToken) {
     throw new SemanticReleaseError(
-      'No Linear API key found',
+      'No Linear token found',
       'ENOLINEARTOKEN',
-      'Please provide a Linear API key via plugin config or LINEAR_API_KEY environment variable.',
+      'Please provide LINEAR_TOKEN environment variable.',
     );
   }
 
@@ -42,7 +42,7 @@ export async function verifyConditions(
   }
 
   // Test API connection
-  const client = new LinearClient(linearApiKey);
+  const client = new LinearClient(linearToken);
 
   try {
     logger.log('Verifying Linear API access...');
@@ -58,7 +58,7 @@ export async function verifyConditions(
 
   // Store validated config for other lifecycle methods
   setLinearContext({
-    apiKey: linearApiKey,
+    apiKey: linearToken,
     teamKeys: teamKeys.length > 0 ? teamKeys : null,
     labelPrefix: pluginConfig.labelPrefix || 'v',
   });

package/src/types.ts

@@ -1,6 +1,6 @@
 export interface PluginConfig {
-  /** Linear API key (can also use LINEAR_API_KEY env var) */
-  apiKey?: string;
+  /** Linear token - API key or OAuth access token (can also use LINEAR_TOKEN env var) */
+  token?: string;
 
   /** Team keys to filter issues (e.g., ["ENG", "FEAT"]) */
   teamKeys?: string[];