@frogbotai/piece-linear 0.31.0 → 0.33.0

package/README.md

@@ -21,8 +21,8 @@ OAuth linking requires factory `oauth: { clientId, clientSecret }` and
 `connections: [{ piece: linear, oauth: true }]`. The built-in recipe requests `actor=app`: a workspace
 admin installs the application, and actions use the app's identity. It does not authorize actions
 as the installing user. For actions as a person, link their API key or an externally obtained
-user-actor OAuth access token through the credential form. Scope overrides remain an array of
-individual scopes in `oauth.scopes`; FrogBot serializes them with commas for Linear.
+user-actor OAuth access token through the credential form. FrogBot serializes the requested scopes
+with commas for Linear; see [OAuth scopes](#oauth-scopes) to change them.
 
 ## Channel setup
 
@@ -67,6 +67,14 @@ Linear signs the exact request body in `Linear-Signature` with HMAC-SHA256. Frog
 invalid, or stale signed deliveries before channel or trigger dispatch. Channel replies are handled
 by the adapter; the triggers below remain independent per-subscription workflows.
 
+## OAuth scopes
+
+Change the requested scopes with the factory's `scopes` option: `createLinear({ oauth, scopes: ({ defaultScopes }) => [...defaultScopes, 'app:assignable'] })` adds one, and an array replaces the defaults. `linearScopes` maps each name to the provider's scope string.
+
+- Always requested: `read`.
+- Defaults: `write`, `comments:create`, `issues:create`, `app:mentionable`.
+- Also available: `timeSchedule:write`, `admin`, `app:assignable`.
+
 ## Actions
 
 | Upstream action slug    | Previous wrapper export | Native action     | Notes                                                |

package/dist/index.d.ts

@@ -4,11 +4,33 @@ import { LinearChannelAdapter } from './adapter.js';
 import { createLinearClient } from './client.js';
 export declare const linearActions: readonly ["createIssue", "updateIssue", "createProject", "updateProject", "createComment", "rawGraphqlQuery"];
 export declare const linearTriggers: readonly ["commentCreated", "issueCreated", "issueUpdated", "issueRemoved", "projectCreated", "projectUpdated", "projectRemoved"];
-export declare const linearScopes: readonly [];
+export declare const linearScopes: {
+    readonly read: "read";
+    readonly write: "write";
+    readonly 'issues:create': "issues:create";
+    readonly 'comments:create': "comments:create";
+    readonly 'timeSchedule:write': "timeSchedule:write";
+    readonly admin: "admin";
+    readonly 'app:assignable': "app:assignable";
+    readonly 'app:mentionable': "app:mentionable";
+};
 export declare const linearOAuth: {
     authorizationUrl: string;
     tokenUrl: string;
-    scopes: string[];
+    scopes: {
+        catalog: {
+            readonly read: "read";
+            readonly write: "write";
+            readonly 'issues:create': "issues:create";
+            readonly 'comments:create': "comments:create";
+            readonly 'timeSchedule:write': "timeSchedule:write";
+            readonly admin: "admin";
+            readonly 'app:assignable': "app:assignable";
+            readonly 'app:mentionable': "app:mentionable";
+        };
+        defaults: ("write" | "issues:create" | "comments:create" | "app:mentionable")[];
+        required: "read"[];
+    };
     scopeSeparator: ",";
     params: {
         actor: string;
@@ -54,7 +76,20 @@ export declare const createLinear: import("frogbot").PieceFactory<{
     readonly oauth: {
         authorizationUrl: string;
         tokenUrl: string;
-        scopes: string[];
+        scopes: {
+            catalog: {
+                readonly read: "read";
+                readonly write: "write";
+                readonly 'issues:create': "issues:create";
+                readonly 'comments:create': "comments:create";
+                readonly 'timeSchedule:write': "timeSchedule:write";
+                readonly admin: "admin";
+                readonly 'app:assignable': "app:assignable";
+                readonly 'app:mentionable': "app:mentionable";
+            };
+            defaults: ("write" | "issues:create" | "comments:create" | "app:mentionable")[];
+            required: "read"[];
+        };
         scopeSeparator: ",";
         params: {
             actor: string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAOzC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQ7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAe,MAAM,aAAa,CAAC;AAY9D,eAAO,MAAM,aAAa,+GAOhB,CAAC;AACX,eAAO,MAAM,cAAc,mIAQjB,CAAC;AACX,eAAO,MAAM,YAAY,aAAc,CAAC;AAExC,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;CAsByC,CAAC;AA0BlE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAXkB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkClE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAQzC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQ7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAe,MAAM,aAAa,CAAC;AAY9D,eAAO,MAAM,aAAa,+GAOhB,CAAC;AACX,eAAO,MAAM,cAAc,mIAQjB,CAAC;AACX,eAAO,MAAM,YAAY;;;;;;;;;CASf,CAAC;AAEX,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BvB,CAAC;AA0BF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAXkB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkClE,CAAC"}

package/dist/index.js

@@ -34,17 +34,31 @@ export const linearTriggers = [
     'projectUpdated',
     'projectRemoved'
 ];
-export const linearScopes = [];
+export const linearScopes = {
+    read: 'read',
+    write: 'write',
+    'issues:create': 'issues:create',
+    'comments:create': 'comments:create',
+    'timeSchedule:write': 'timeSchedule:write',
+    admin: 'admin',
+    'app:assignable': 'app:assignable',
+    'app:mentionable': 'app:mentionable'
+};
 export const linearOAuth = {
     authorizationUrl: 'https://linear.app/oauth/authorize',
     tokenUrl: 'https://api.linear.app/oauth/token',
-    scopes: [
-        'read',
-        'write',
-        'comments:create',
-        'issues:create',
-        'app:mentionable'
-    ],
+    scopes: {
+        catalog: linearScopes,
+        defaults: [
+            'write',
+            'comments:create',
+            'issues:create',
+            'app:mentionable'
+        ],
+        required: [
+            'read'
+        ]
+    },
     scopeSeparator: ',',
     params: {
         actor: 'app'

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["definePiece","findUserByEmail","createComment","createIssue","createProject","rawGraphqlQuery","updateIssue","updateProject","LinearChannelAdapter","createLinearClient","linearAuth","linearOptions","linearQuestions","commentCreated","issueCreated","issueRemoved","issueUpdated","projectCreated","projectRemoved","projectUpdated","linearWebhook","linearActions","linearTriggers","linearScopes","linearOAuth","authorizationUrl","tokenUrl","scopes","scopeSeparator","params","actor","toAuth","tokens","access_token","trim","Error","accessToken","account","client","viewer","email","id","label","name","linearChannel","adapter","auth","options","webhookSecret","apiKey","mode","channelMode","userName","botUsername","identity","author","req","user","userId","toLowerCase","questions","createLinear","slug","admin","description","group","oauth","webhook","channel","actions","triggers"],"mappings":"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","file":"index.js"}
+{"version":3,"sources":["../src/index.ts"],"names":["definePiece","findUserByEmail","createComment","createIssue","createProject","rawGraphqlQuery","updateIssue","updateProject","LinearChannelAdapter","createLinearClient","linearAuth","linearOptions","linearQuestions","commentCreated","issueCreated","issueRemoved","issueUpdated","projectCreated","projectRemoved","projectUpdated","linearWebhook","linearActions","linearTriggers","linearScopes","read","write","admin","linearOAuth","authorizationUrl","tokenUrl","scopes","catalog","defaults","required","scopeSeparator","params","actor","toAuth","tokens","access_token","trim","Error","accessToken","account","client","viewer","email","id","label","name","linearChannel","adapter","auth","options","webhookSecret","apiKey","mode","channelMode","userName","botUsername","identity","author","req","user","userId","toLowerCase","questions","createLinear","slug","description","group","oauth","webhook","channel","actions","triggers"],"mappings":"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","file":"index.js"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frogbotai/piece-linear",
-  "version": "0.31.0",
+  "version": "0.33.0",
   "description": "Linear tools for FrogBot.",
   "license": "MIT",
   "author": "Colby Gilbert",
@@ -29,11 +29,11 @@
     "zod": "^4.3.6"
   },
   "peerDependencies": {
-    "frogbot": "0.31.0"
+    "frogbot": "0.33.0"
   },
   "devDependencies": {
     "typescript": "5.6.2",
-    "frogbot": "0.31.0"
+    "frogbot": "0.33.0"
   },
   "publishConfig": {
     "access": "public"