@rawdash/connector-linear 0.14.0 → 0.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,101 +1,81 @@
1
- # @rawdash/connector-linear
2
-
3
- Rawdash connector for [Linear](https://linear.app) — syncs teams, users, cycles, and issues (plus state-transition events derived from each issue's history) into the six-shape storage model.
4
-
5
- ## Auth setup
1
+ <!-- This file is generated from connector metadata by scripts/generate-connector-docs.ts. Do not edit by hand. -->
6
2
 
7
- The MVP uses a Linear **Personal API Key**:
8
-
9
- 1. Sign in to Linear and open **Settings → API → Personal API keys**.
10
- 2. Click **Create new** and give it a name like `rawdash`.
11
- 3. Copy the key (starts with `lin_api_…`). Linear shows it only once.
3
+ # @rawdash/connector-linear
12
4
 
13
- Personal API keys inherit the scopes of the user who created them. The connector only issues read queries, but use an account with appropriate visibility into the teams you want to sync.
5
+ [![npm version](https://img.shields.io/npm/v/@rawdash/connector-linear)](https://www.npmjs.com/package/@rawdash/connector-linear)
6
+ [![license](https://img.shields.io/npm/l/@rawdash/connector-linear)](https://github.com/rawdash/rawdash/blob/main/LICENSE)
14
7
 
15
- OAuth-based auth is planned post-MVP see the connector roadmap for details.
8
+ Sync teams, members, cycles, issues, and issue state-transition events from a Linear workspace.
16
9
 
17
- ## Configuration
10
+ ## Install
18
11
 
19
- ```ts
20
- import { LinearConnector } from '@rawdash/connector-linear';
21
- import { secret } from '@rawdash/core';
22
-
23
- const linear = new LinearConnector(
24
- {
25
- // teamIds: ['team-uuid'], // optional — restrict to one or more teams
26
- // resources: ['issues'], // optional — defaults to all four phases
27
- // historyPerIssue: 25, // optional — how many history entries to fetch per issue
28
- },
29
- {
30
- apiKey: secret('LINEAR_API_KEY'),
31
- },
32
- );
12
+ ```sh
13
+ npm install @rawdash/connector-linear
33
14
  ```
34
15
 
35
- Or via `LinearConnector.create` (validates the input with the `configFields` Zod schema):
16
+ ## Authentication
36
17
 
37
- ```ts
38
- const linear = LinearConnector.create({
39
- apiKey: { $secret: 'LINEAR_API_KEY' },
40
- // teamIds: ['team-uuid'],
41
- // resources: ['issues'],
42
- });
43
- ```
44
-
45
- ### Choosing resources
46
-
47
- The connector exposes four sync phases, run in order:
18
+ A Linear Personal API Key is required. It authenticates all GraphQL requests and scopes the sync to the workspaces and teams the key can access.
48
19
 
49
- `teams`, `users`, `cycles`, `issues`
20
+ 1. Open Linear → Settings → API → Personal API keys.
21
+ 2. Create a new personal API key.
22
+ 3. Store it as a secret and reference it from the connector config as `apiKey: secret("LINEAR_API_KEY")`.
50
23
 
51
- Pass any non-empty subset as `resources` to sync only those phases. The `issues` phase also emits `linear_issue_state_change` events.
24
+ ## Configuration
52
25
 
53
- ### Example dashboard
26
+ | Field | Type | Required | Description |
27
+ | ----------------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
28
+ | `apiKey` | secret | Yes | Linear Personal API Key. Create one at Linear → Settings → API → Personal API keys. |
29
+ | `teamIds` | array | No | Restrict the sync to specific Linear team IDs. Omit to sync all teams the API key can see. |
30
+ | `resources` | array | No | Which Linear resources to sync. Omit to sync all resources. The `issues` phase also emits state-transition events derived from each issue's history. |
31
+ | `historyPerIssue` | number | No | How many history entries to pull per issue (newest first). State transitions inside this window become events. Defaults to 25. |
32
+
33
+ ## Resources
34
+
35
+ - **`linear_team`** _(entity)_ - Workspace teams with their name and key.
36
+ - Endpoint: `GraphQL query: teams { nodes { ... } }`
37
+ - **`linear_user`** _(entity)_ - Workspace members, including name, email, display name, and active state.
38
+ - Endpoint: `GraphQL query: users { nodes { ... } }`
39
+ - **`linear_cycle`** _(entity)_ - Team cycles with their number, dates, progress, and final scope / completed-scope figures.
40
+ - Endpoint: `GraphQL query: cycles { nodes { ... } }`
41
+ - **`linear_issue`** _(entity)_ - Issues with their state, priority, assignee, team, project, cycle, labels, estimate, and lifecycle timestamps.
42
+ - Endpoint: `GraphQL query: issues { nodes { ... } }`
43
+ - **`linear_issue_state_change`** _(event)_ - State-transition events derived from each issue’s history (from-state to to-state), keyed by the originating actor.
44
+ - Endpoint: `GraphQL query: issues { nodes { history { nodes { ... } } } }`
45
+ - Only history entries with a non-null fromState and toState (where they differ) become events; these append-only events accumulate across incremental syncs.
46
+
47
+ ## Example
54
48
 
55
49
  ```ts
56
- import { defineConfig, defineDashboard, defineMetric } from '@rawdash/core';
50
+ import {
51
+ defineConfig,
52
+ defineDashboard,
53
+ defineMetric,
54
+ secret,
55
+ } from '@rawdash/core';
56
+
57
+ const linear = {
58
+ name: 'linear',
59
+ connectorId: 'linear',
60
+ config: {
61
+ apiKey: secret('LINEAR_API_KEY'),
62
+ },
63
+ };
57
64
 
58
65
  export default defineConfig({
59
- connectors: [{ connector: linear }],
66
+ connectors: [linear],
60
67
  dashboards: {
61
- engineering: defineDashboard({
68
+ product: defineDashboard({
62
69
  widgets: {
63
70
  open_issues: {
64
71
  kind: 'stat',
65
- title: 'Open issues',
66
- metric: defineMetric({
67
- connector: linear,
68
- shape: 'entity',
69
- entityType: 'linear_issue',
70
- fn: 'count',
71
- filter: [
72
- { field: 'stateType', op: 'in', value: ['unstarted', 'started'] },
73
- ],
74
- }),
75
- },
76
- completed_this_week: {
77
- kind: 'timeseries',
78
- title: 'Issues completed per day',
79
- window: '7d',
80
- metric: defineMetric({
81
- connector: linear,
82
- shape: 'event',
83
- name: 'linear_issue_state_change',
84
- fn: 'count',
85
- window: '7d',
86
- filter: [{ field: 'toStateName', op: 'eq', value: 'Done' }],
87
- groupBy: { field: 'start_ts', granularity: 'day' },
88
- }),
89
- },
90
- issues_by_priority: {
91
- kind: 'distribution',
92
- title: 'Issues by priority',
72
+ title: 'In-progress issues',
93
73
  metric: defineMetric({
94
74
  connector: linear,
95
75
  shape: 'entity',
96
76
  entityType: 'linear_issue',
97
77
  fn: 'count',
98
- groupBy: { field: 'priority' },
78
+ filter: [{ field: 'stateType', op: 'eq', value: 'started' }],
99
79
  }),
100
80
  },
101
81
  },
@@ -104,54 +84,21 @@ export default defineConfig({
104
84
  });
105
85
  ```
106
86
 
107
- ## Data model
108
-
109
- | Storage shape | Entity/event type | Key attributes |
110
- | ------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
111
- | entity | `linear_team` | name, key, createdAt |
112
- | entity | `linear_user` | name, email, displayName, active, createdAt |
113
- | entity | `linear_cycle` | number, name, teamId, startsAt, endsAt, completedAt, progress, scope, completedScope |
114
- | entity | `linear_issue` | identifier, title, stateId, stateName, stateType, priority, assigneeId, teamId, projectId, cycleId, labels, estimate, createdAt, completedAt, canceledAt, startedAt |
115
- | event | `linear_issue_state_change` | historyId, issueId, issueIdentifier, teamId, actorId, fromStateId, fromStateName, toStateId, toStateName |
116
-
117
- Timestamps are stored as Unix epoch milliseconds. `linear_issue_state_change` events are derived from the `history(first: N)` window on each issue — only entries with a non-null `fromState` and `toState` (and where they differ) become events.
118
-
119
- ## Sync behaviour
120
-
121
- - **Backfill** (`mode: 'full'`): paginates each phase via Linear's `after`/`endCursor` GraphQL connection (page size 50). Issue and event scopes are cleared at the start of their phase so deletions in Linear converge.
122
- - **Incremental** (`mode: 'latest'`): applies an `updatedAt > since` GraphQL filter on each connection, fetching only records that have changed since the last sync. Append-only state-transition events derived from issue history will accumulate over consecutive incremental syncs.
123
- - **Rate limits**: Linear sends `X-RateLimit-Requests-Remaining` / `X-RateLimit-Requests-Reset` on every response — the connector reports the parsed state back to the host via the shared rate-limit policy so the engine can budget future requests.
124
- - **Resumable**: every phase yields a `(phase, endCursor)` cursor — if the host aborts the sync, the next invocation picks up at the same page.
87
+ ## Rate limits
125
88
 
126
- ## Out of scope (post-MVP)
89
+ Linear returns X-RateLimit-Requests-Remaining / X-RateLimit-Requests-Reset headers (reset in ms); requests are paged 50 at a time.
127
90
 
128
- - Linear OAuth (currently API key only).
129
- - Webhooks for live updates (Team-tier feature).
130
- - Roadmap / Initiative resources (open a ticket if you need them).
91
+ ## Limitations
131
92
 
132
- ## Registering in the MCP server
133
-
134
- ```ts
135
- import { LinearConnector, configFields } from '@rawdash/connector-linear';
136
-
137
- createMcpServer({
138
- // ...
139
- connectorFactories: [
140
- {
141
- id: 'linear',
142
- configFields,
143
- create: LinearConnector.create,
144
- },
145
- ],
146
- });
147
- ```
93
+ - API key auth only (OAuth not yet supported).
94
+ - Webhooks and roadmap/initiative resources are out of scope.
148
95
 
149
- ## Property tests
96
+ ## Links
150
97
 
151
- Resources in this connector have fast-check property tests under `src/property.test.ts` that:
98
+ - [Rawdash docs](https://rawdash.dev/docs/connectors/)
99
+ - [Linear API docs](https://developers.linear.app/docs)
100
+ - [GitHub](https://github.com/rawdash/rawdash)
152
101
 
153
- 1. Generate N≥50 synthetic API payloads from a Zod schema mirroring the upstream API response.
154
- 2. Pipe them through `connector.sync()` against an `InMemoryStorage` instance.
155
- 3. Assert universal invariants — non-empty entity ids, finite event timestamps, no `undefined` leaking into storage, no thrown errors on any valid input — plus per-resource counts.
102
+ ## License
156
103
 
157
- The helper lives in `@rawdash/connector-test-utils`. When adding a new resource, add a Zod schema for its payload and a test wired up via `runPropertySyncTest`.
104
+ Apache-2.0
package/dist/index.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { BaseConnector, ConnectorContext, SyncOptions, StorageHandle, SyncResult } from '@rawdash/core';
1
+ import { BaseConnector, ConnectorContext, SyncOptions, StorageHandle, SyncResult, ConnectorDoc } from '@rawdash/core';
2
2
  import { z } from 'zod';
3
3
 
4
4
  declare const configFields: z.ZodObject<{
@@ -7,13 +7,14 @@ declare const configFields: z.ZodObject<{
7
7
  }, z.core.$strip>;
8
8
  teamIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
9
9
  resources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
10
+ issues: "issues";
11
+ cycles: "cycles";
10
12
  teams: "teams";
11
13
  users: "users";
12
- cycles: "cycles";
13
- issues: "issues";
14
14
  }>>>;
15
15
  historyPerIssue: z.ZodOptional<z.ZodNumber>;
16
16
  }, z.core.$strip>;
17
+ declare const doc: ConnectorDoc;
17
18
  interface LinearSettings {
18
19
  teamIds?: readonly string[];
19
20
  resources?: readonly LinearResource[];
@@ -31,6 +32,235 @@ type LinearPhase = (typeof PHASE_ORDER)[number];
31
32
  type LinearResource = LinearPhase;
32
33
  declare class LinearConnector extends BaseConnector<LinearSettings, LinearCredentials> {
33
34
  static readonly id = "linear";
35
+ static readonly resources: {
36
+ readonly linear_team: {
37
+ readonly shape: "entity";
38
+ readonly description: "Workspace teams with their name and key.";
39
+ readonly endpoint: "GraphQL query: teams { nodes { ... } }";
40
+ readonly responses: {
41
+ readonly teams: z.ZodArray<z.ZodObject<{
42
+ id: z.ZodString;
43
+ name: z.ZodString;
44
+ key: z.ZodString;
45
+ createdAt: z.ZodISODateTime;
46
+ updatedAt: z.ZodISODateTime;
47
+ }, z.core.$strip>>;
48
+ };
49
+ };
50
+ readonly linear_user: {
51
+ readonly shape: "entity";
52
+ readonly description: "Workspace members, including name, email, display name, and active state.";
53
+ readonly endpoint: "GraphQL query: users { nodes { ... } }";
54
+ readonly responses: {
55
+ readonly users: z.ZodArray<z.ZodObject<{
56
+ id: z.ZodString;
57
+ name: z.ZodString;
58
+ email: z.ZodNullable<z.ZodString>;
59
+ displayName: z.ZodString;
60
+ active: z.ZodBoolean;
61
+ createdAt: z.ZodISODateTime;
62
+ updatedAt: z.ZodISODateTime;
63
+ }, z.core.$strip>>;
64
+ };
65
+ };
66
+ readonly linear_cycle: {
67
+ readonly shape: "entity";
68
+ readonly description: "Team cycles with their number, dates, progress, and final scope / completed-scope figures.";
69
+ readonly endpoint: "GraphQL query: cycles { nodes { ... } }";
70
+ readonly responses: {
71
+ readonly cycles: z.ZodArray<z.ZodObject<{
72
+ id: z.ZodString;
73
+ number: z.ZodNumber;
74
+ name: z.ZodNullable<z.ZodString>;
75
+ startsAt: z.ZodISODateTime;
76
+ endsAt: z.ZodISODateTime;
77
+ completedAt: z.ZodNullable<z.ZodISODateTime>;
78
+ progress: z.ZodNullable<z.ZodNumber>;
79
+ scopeHistory: z.ZodNullable<z.ZodArray<z.ZodNumber>>;
80
+ completedScopeHistory: z.ZodNullable<z.ZodArray<z.ZodNumber>>;
81
+ team: z.ZodNullable<z.ZodObject<{
82
+ id: z.ZodString;
83
+ }, z.core.$strip>>;
84
+ createdAt: z.ZodISODateTime;
85
+ updatedAt: z.ZodISODateTime;
86
+ }, z.core.$strip>>;
87
+ };
88
+ };
89
+ readonly linear_issue: {
90
+ readonly shape: "entity";
91
+ readonly description: "Issues with their state, priority, assignee, team, project, cycle, labels, estimate, and lifecycle timestamps.";
92
+ readonly endpoint: "GraphQL query: issues { nodes { ... } }";
93
+ readonly responses: {
94
+ readonly issues: z.ZodArray<z.ZodObject<{
95
+ id: z.ZodString;
96
+ identifier: z.ZodString;
97
+ title: z.ZodString;
98
+ priority: z.ZodNumber;
99
+ estimate: z.ZodNullable<z.ZodNumber>;
100
+ state: z.ZodNullable<z.ZodObject<{
101
+ id: z.ZodString;
102
+ name: z.ZodString;
103
+ type: z.ZodString;
104
+ }, z.core.$strip>>;
105
+ assignee: z.ZodNullable<z.ZodObject<{
106
+ id: z.ZodString;
107
+ }, z.core.$strip>>;
108
+ team: z.ZodNullable<z.ZodObject<{
109
+ id: z.ZodString;
110
+ }, z.core.$strip>>;
111
+ project: z.ZodNullable<z.ZodObject<{
112
+ id: z.ZodString;
113
+ }, z.core.$strip>>;
114
+ cycle: z.ZodNullable<z.ZodObject<{
115
+ id: z.ZodString;
116
+ }, z.core.$strip>>;
117
+ labels: z.ZodObject<{
118
+ nodes: z.ZodArray<z.ZodObject<{
119
+ id: z.ZodString;
120
+ name: z.ZodString;
121
+ }, z.core.$strip>>;
122
+ }, z.core.$strip>;
123
+ createdAt: z.ZodISODateTime;
124
+ updatedAt: z.ZodISODateTime;
125
+ completedAt: z.ZodNullable<z.ZodISODateTime>;
126
+ canceledAt: z.ZodNullable<z.ZodISODateTime>;
127
+ startedAt: z.ZodNullable<z.ZodISODateTime>;
128
+ history: z.ZodObject<{
129
+ nodes: z.ZodArray<z.ZodObject<{
130
+ id: z.ZodString;
131
+ createdAt: z.ZodISODateTime;
132
+ actor: z.ZodNullable<z.ZodObject<{
133
+ id: z.ZodString;
134
+ }, z.core.$strip>>;
135
+ fromState: z.ZodNullable<z.ZodObject<{
136
+ id: z.ZodString;
137
+ name: z.ZodString;
138
+ }, z.core.$strip>>;
139
+ toState: z.ZodNullable<z.ZodObject<{
140
+ id: z.ZodString;
141
+ name: z.ZodString;
142
+ }, z.core.$strip>>;
143
+ fromAssignee: z.ZodNullable<z.ZodObject<{
144
+ id: z.ZodString;
145
+ }, z.core.$strip>>;
146
+ toAssignee: z.ZodNullable<z.ZodObject<{
147
+ id: z.ZodString;
148
+ }, z.core.$strip>>;
149
+ }, z.core.$strip>>;
150
+ pageInfo: z.ZodObject<{
151
+ hasNextPage: z.ZodBoolean;
152
+ endCursor: z.ZodNullable<z.ZodString>;
153
+ }, z.core.$strip>;
154
+ }, z.core.$strip>;
155
+ }, z.core.$strip>>;
156
+ };
157
+ };
158
+ readonly linear_issue_state_change: {
159
+ readonly shape: "event";
160
+ readonly description: "State-transition events derived from each issue’s history (from-state to to-state), keyed by the originating actor.";
161
+ readonly endpoint: "GraphQL query: issues { nodes { history { nodes { ... } } } }";
162
+ readonly notes: "Only history entries with a non-null fromState and toState (where they differ) become events; these append-only events accumulate across incremental syncs.";
163
+ };
164
+ };
165
+ static readonly schemas: object & {
166
+ readonly teams: z.ZodArray<z.ZodObject<{
167
+ id: z.ZodString;
168
+ name: z.ZodString;
169
+ key: z.ZodString;
170
+ createdAt: z.ZodISODateTime;
171
+ updatedAt: z.ZodISODateTime;
172
+ }, z.core.$strip>>;
173
+ } & {
174
+ readonly users: z.ZodArray<z.ZodObject<{
175
+ id: z.ZodString;
176
+ name: z.ZodString;
177
+ email: z.ZodNullable<z.ZodString>;
178
+ displayName: z.ZodString;
179
+ active: z.ZodBoolean;
180
+ createdAt: z.ZodISODateTime;
181
+ updatedAt: z.ZodISODateTime;
182
+ }, z.core.$strip>>;
183
+ } & {
184
+ readonly cycles: z.ZodArray<z.ZodObject<{
185
+ id: z.ZodString;
186
+ number: z.ZodNumber;
187
+ name: z.ZodNullable<z.ZodString>;
188
+ startsAt: z.ZodISODateTime;
189
+ endsAt: z.ZodISODateTime;
190
+ completedAt: z.ZodNullable<z.ZodISODateTime>;
191
+ progress: z.ZodNullable<z.ZodNumber>;
192
+ scopeHistory: z.ZodNullable<z.ZodArray<z.ZodNumber>>;
193
+ completedScopeHistory: z.ZodNullable<z.ZodArray<z.ZodNumber>>;
194
+ team: z.ZodNullable<z.ZodObject<{
195
+ id: z.ZodString;
196
+ }, z.core.$strip>>;
197
+ createdAt: z.ZodISODateTime;
198
+ updatedAt: z.ZodISODateTime;
199
+ }, z.core.$strip>>;
200
+ } & {
201
+ readonly issues: z.ZodArray<z.ZodObject<{
202
+ id: z.ZodString;
203
+ identifier: z.ZodString;
204
+ title: z.ZodString;
205
+ priority: z.ZodNumber;
206
+ estimate: z.ZodNullable<z.ZodNumber>;
207
+ state: z.ZodNullable<z.ZodObject<{
208
+ id: z.ZodString;
209
+ name: z.ZodString;
210
+ type: z.ZodString;
211
+ }, z.core.$strip>>;
212
+ assignee: z.ZodNullable<z.ZodObject<{
213
+ id: z.ZodString;
214
+ }, z.core.$strip>>;
215
+ team: z.ZodNullable<z.ZodObject<{
216
+ id: z.ZodString;
217
+ }, z.core.$strip>>;
218
+ project: z.ZodNullable<z.ZodObject<{
219
+ id: z.ZodString;
220
+ }, z.core.$strip>>;
221
+ cycle: z.ZodNullable<z.ZodObject<{
222
+ id: z.ZodString;
223
+ }, z.core.$strip>>;
224
+ labels: z.ZodObject<{
225
+ nodes: z.ZodArray<z.ZodObject<{
226
+ id: z.ZodString;
227
+ name: z.ZodString;
228
+ }, z.core.$strip>>;
229
+ }, z.core.$strip>;
230
+ createdAt: z.ZodISODateTime;
231
+ updatedAt: z.ZodISODateTime;
232
+ completedAt: z.ZodNullable<z.ZodISODateTime>;
233
+ canceledAt: z.ZodNullable<z.ZodISODateTime>;
234
+ startedAt: z.ZodNullable<z.ZodISODateTime>;
235
+ history: z.ZodObject<{
236
+ nodes: z.ZodArray<z.ZodObject<{
237
+ id: z.ZodString;
238
+ createdAt: z.ZodISODateTime;
239
+ actor: z.ZodNullable<z.ZodObject<{
240
+ id: z.ZodString;
241
+ }, z.core.$strip>>;
242
+ fromState: z.ZodNullable<z.ZodObject<{
243
+ id: z.ZodString;
244
+ name: z.ZodString;
245
+ }, z.core.$strip>>;
246
+ toState: z.ZodNullable<z.ZodObject<{
247
+ id: z.ZodString;
248
+ name: z.ZodString;
249
+ }, z.core.$strip>>;
250
+ fromAssignee: z.ZodNullable<z.ZodObject<{
251
+ id: z.ZodString;
252
+ }, z.core.$strip>>;
253
+ toAssignee: z.ZodNullable<z.ZodObject<{
254
+ id: z.ZodString;
255
+ }, z.core.$strip>>;
256
+ }, z.core.$strip>>;
257
+ pageInfo: z.ZodObject<{
258
+ hasNextPage: z.ZodBoolean;
259
+ endCursor: z.ZodNullable<z.ZodString>;
260
+ }, z.core.$strip>;
261
+ }, z.core.$strip>;
262
+ }, z.core.$strip>>;
263
+ } & Readonly<Record<string, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
34
264
  static create(input: unknown, ctx?: ConnectorContext): LinearConnector;
35
265
  readonly id = "linear";
36
266
  readonly credentials: {
@@ -42,6 +272,7 @@ declare class LinearConnector extends BaseConnector<LinearSettings, LinearCreden
42
272
  private buildHeaders;
43
273
  private graphql;
44
274
  private sinceFilter;
275
+ private issueSinceFilter;
45
276
  private teamFilter;
46
277
  private issueTeamFilter;
47
278
  private mergeFilters;
@@ -56,4 +287,4 @@ declare class LinearConnector extends BaseConnector<LinearSettings, LinearCreden
56
287
  sync(options: SyncOptions, storage: StorageHandle, signal?: AbortSignal): Promise<SyncResult>;
57
288
  }
58
289
 
59
- export { LinearConnector, type LinearResource, type LinearSettings, configFields, LinearConnector as default };
290
+ export { LinearConnector, type LinearResource, type LinearSettings, configFields, LinearConnector as default, doc };
package/dist/index.js CHANGED
@@ -1,36 +1,58 @@
1
1
  // ../../connector-shared/dist/index.js
2
2
  var HTTP_CLIENT_VERSION = "0.0.0";
3
3
  var DEFAULT_USER_AGENT = `rawdash-connector/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;
4
- var linearRateLimit = {
5
- parse(h) {
6
- const remainingRaw = h.get("x-ratelimit-requests-remaining");
7
- const resetRaw = h.get("x-ratelimit-requests-reset");
8
- if (remainingRaw === null) {
9
- return null;
10
- }
11
- const remaining = Number(remainingRaw);
12
- if (!Number.isFinite(remaining)) {
13
- return null;
14
- }
15
- let resetAt;
16
- if (resetRaw !== null) {
4
+ function connectorUserAgent(connectorId) {
5
+ return `rawdash-connector-${connectorId}/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;
6
+ }
7
+ function standardRateLimitPolicy(config) {
8
+ const { remainingHeader, resetHeader, resetUnit, resetFallbackMs } = config;
9
+ const multiplier = resetUnit === "s" ? 1e3 : 1;
10
+ return {
11
+ parse(h) {
12
+ const remainingRaw = h.get(remainingHeader);
13
+ if (remainingRaw === null || remainingRaw.trim() === "") {
14
+ return null;
15
+ }
16
+ const remaining = Number(remainingRaw);
17
+ if (!Number.isFinite(remaining)) {
18
+ return null;
19
+ }
20
+ const resetRaw = h.get(resetHeader);
21
+ if (resetRaw === null) {
22
+ if (resetFallbackMs === void 0) {
23
+ return null;
24
+ }
25
+ return {
26
+ remaining,
27
+ resetAt: new Date(Date.now() + resetFallbackMs)
28
+ };
29
+ }
30
+ if (resetRaw.trim() === "") {
31
+ return null;
32
+ }
17
33
  const reset = Number(resetRaw);
18
34
  if (!Number.isFinite(reset) || reset < 0) {
19
35
  return null;
20
36
  }
21
- resetAt = new Date(reset);
22
- } else {
23
- resetAt = new Date(Date.now() + 6e4);
37
+ const resetMs = reset * multiplier;
38
+ if (!Number.isFinite(resetMs)) {
39
+ return null;
40
+ }
41
+ return { remaining, resetAt: new Date(resetMs) };
24
42
  }
25
- return { remaining, resetAt };
26
- }
27
- };
43
+ };
44
+ }
28
45
 
29
46
  // src/linear.ts
30
47
  import {
31
48
  BaseConnector,
32
49
  defineConfigFields,
33
- paginateChunked
50
+ defineConnectorDoc,
51
+ defineResources,
52
+ makeChunkedCursorGuard,
53
+ paginateChunked,
54
+ schemasFromResources,
55
+ selectActivePhases
34
56
  } from "@rawdash/core";
35
57
  import { z } from "zod";
36
58
  var configFields = defineConfigFields(
@@ -56,29 +78,44 @@ var configFields = defineConfigFields(
56
78
  })
57
79
  })
58
80
  );
81
+ var doc = defineConnectorDoc({
82
+ displayName: "Linear",
83
+ category: "product",
84
+ brandColor: "#5E6AD2",
85
+ tagline: "Sync teams, members, cycles, issues, and issue state-transition events from a Linear workspace.",
86
+ vendor: {
87
+ name: "Linear",
88
+ apiDocs: "https://developers.linear.app/docs",
89
+ website: "https://linear.app"
90
+ },
91
+ auth: {
92
+ summary: "A Linear Personal API Key is required. It authenticates all GraphQL requests and scopes the sync to the workspaces and teams the key can access.",
93
+ setup: [
94
+ "Open Linear \u2192 Settings \u2192 API \u2192 Personal API keys.",
95
+ "Create a new personal API key.",
96
+ 'Store it as a secret and reference it from the connector config as `apiKey: secret("LINEAR_API_KEY")`.'
97
+ ]
98
+ },
99
+ rateLimit: "Linear returns X-RateLimit-Requests-Remaining / X-RateLimit-Requests-Reset headers (reset in ms); requests are paged 50 at a time.",
100
+ limitations: [
101
+ "API key auth only (OAuth not yet supported).",
102
+ "Webhooks and roadmap/initiative resources are out of scope."
103
+ ]
104
+ });
59
105
  var linearCredentials = {
60
106
  apiKey: {
61
107
  description: "Linear Personal API Key",
62
108
  auth: "required"
63
109
  }
64
110
  };
111
+ var linearRateLimit = standardRateLimitPolicy({
112
+ remainingHeader: "x-ratelimit-requests-remaining",
113
+ resetHeader: "x-ratelimit-requests-reset",
114
+ resetUnit: "ms",
115
+ resetFallbackMs: 6e4
116
+ });
65
117
  var PHASE_ORDER = ["teams", "users", "cycles", "issues"];
66
- function isLinearSyncCursor(value) {
67
- if (typeof value !== "object" || value === null) {
68
- return false;
69
- }
70
- const v = value;
71
- if (typeof v.phase !== "string") {
72
- return false;
73
- }
74
- if (!PHASE_ORDER.includes(v.phase)) {
75
- return false;
76
- }
77
- if (v.page !== null && typeof v.page !== "string") {
78
- return false;
79
- }
80
- return true;
81
- }
118
+ var isLinearSyncCursor = makeChunkedCursorGuard(PHASE_ORDER);
82
119
  var TEAMS_QUERY = `
83
120
  query Teams($after: String, $first: Int!, $filter: TeamFilter) {
84
121
  teams(after: $after, first: $first, filter: $filter, orderBy: updatedAt) {
@@ -144,8 +181,110 @@ var ISSUES_QUERY = `
144
181
  var PAGE_SIZE = 50;
145
182
  var DEFAULT_HISTORY_PER_ISSUE = 25;
146
183
  var ENDPOINT = "https://api.linear.app/graphql";
184
+ var idString = z.string().min(1);
185
+ var teamSchema = z.object({
186
+ id: idString,
187
+ name: z.string(),
188
+ key: z.string(),
189
+ createdAt: z.iso.datetime(),
190
+ updatedAt: z.iso.datetime()
191
+ });
192
+ var userSchema = z.object({
193
+ id: idString,
194
+ name: z.string(),
195
+ email: z.string().nullable(),
196
+ displayName: z.string(),
197
+ active: z.boolean(),
198
+ createdAt: z.iso.datetime(),
199
+ updatedAt: z.iso.datetime()
200
+ });
201
+ var cycleSchema = z.object({
202
+ id: idString,
203
+ number: z.number().int(),
204
+ name: z.string().nullable(),
205
+ startsAt: z.iso.datetime(),
206
+ endsAt: z.iso.datetime(),
207
+ completedAt: z.iso.datetime().nullable(),
208
+ progress: z.number().nullable(),
209
+ scopeHistory: z.array(z.number()).nullable(),
210
+ completedScopeHistory: z.array(z.number()).nullable(),
211
+ team: z.object({ id: idString }).nullable(),
212
+ createdAt: z.iso.datetime(),
213
+ updatedAt: z.iso.datetime()
214
+ });
215
+ var issueSchema = z.object({
216
+ id: idString,
217
+ identifier: z.string(),
218
+ title: z.string(),
219
+ priority: z.number().int(),
220
+ estimate: z.number().nullable(),
221
+ state: z.object({ id: idString, name: z.string(), type: z.string() }).nullable(),
222
+ assignee: z.object({ id: idString }).nullable(),
223
+ team: z.object({ id: idString }).nullable(),
224
+ project: z.object({ id: idString }).nullable(),
225
+ cycle: z.object({ id: idString }).nullable(),
226
+ labels: z.object({
227
+ nodes: z.array(z.object({ id: idString, name: z.string() }))
228
+ }),
229
+ createdAt: z.iso.datetime(),
230
+ updatedAt: z.iso.datetime(),
231
+ completedAt: z.iso.datetime().nullable(),
232
+ canceledAt: z.iso.datetime().nullable(),
233
+ startedAt: z.iso.datetime().nullable(),
234
+ history: z.object({
235
+ nodes: z.array(
236
+ z.object({
237
+ id: idString,
238
+ createdAt: z.iso.datetime(),
239
+ actor: z.object({ id: idString }).nullable(),
240
+ fromState: z.object({ id: idString, name: z.string() }).nullable(),
241
+ toState: z.object({ id: idString, name: z.string() }).nullable(),
242
+ fromAssignee: z.object({ id: idString }).nullable(),
243
+ toAssignee: z.object({ id: idString }).nullable()
244
+ })
245
+ ),
246
+ pageInfo: z.object({
247
+ hasNextPage: z.boolean(),
248
+ endCursor: z.string().nullable()
249
+ })
250
+ })
251
+ });
252
+ var linearResources = defineResources({
253
+ linear_team: {
254
+ shape: "entity",
255
+ description: "Workspace teams with their name and key.",
256
+ endpoint: "GraphQL query: teams { nodes { ... } }",
257
+ responses: { teams: z.array(teamSchema) }
258
+ },
259
+ linear_user: {
260
+ shape: "entity",
261
+ description: "Workspace members, including name, email, display name, and active state.",
262
+ endpoint: "GraphQL query: users { nodes { ... } }",
263
+ responses: { users: z.array(userSchema) }
264
+ },
265
+ linear_cycle: {
266
+ shape: "entity",
267
+ description: "Team cycles with their number, dates, progress, and final scope / completed-scope figures.",
268
+ endpoint: "GraphQL query: cycles { nodes { ... } }",
269
+ responses: { cycles: z.array(cycleSchema) }
270
+ },
271
+ linear_issue: {
272
+ shape: "entity",
273
+ description: "Issues with their state, priority, assignee, team, project, cycle, labels, estimate, and lifecycle timestamps.",
274
+ endpoint: "GraphQL query: issues { nodes { ... } }",
275
+ responses: { issues: z.array(issueSchema) }
276
+ },
277
+ linear_issue_state_change: {
278
+ shape: "event",
279
+ description: "State-transition events derived from each issue\u2019s history (from-state to to-state), keyed by the originating actor.",
280
+ endpoint: "GraphQL query: issues { nodes { history { nodes { ... } } } }",
281
+ notes: "Only history entries with a non-null fromState and toState (where they differ) become events; these append-only events accumulate across incremental syncs."
282
+ }
283
+ });
147
284
  var LinearConnector = class _LinearConnector extends BaseConnector {
148
285
  static id = "linear";
286
+ static resources = linearResources;
287
+ static schemas = schemasFromResources(linearResources);
149
288
  static create(input, ctx) {
150
289
  const parsed = configFields.parse(input);
151
290
  return new _LinearConnector(
@@ -164,7 +303,7 @@ var LinearConnector = class _LinearConnector extends BaseConnector {
164
303
  return {
165
304
  Authorization: this.creds.apiKey,
166
305
  "Content-Type": "application/json",
167
- "User-Agent": "rawdash/connector-linear (+https://rawdash.dev)"
306
+ "User-Agent": connectorUserAgent("linear")
168
307
  };
169
308
  }
170
309
  async graphql(query, variables, resource, signal) {
@@ -187,7 +326,16 @@ var LinearConnector = class _LinearConnector extends BaseConnector {
187
326
  return res;
188
327
  }
189
328
  sinceFilter(options) {
190
- if (options.mode !== "latest" || !options.since) {
329
+ if (!options.since) {
330
+ return void 0;
331
+ }
332
+ if (options.mode === "latest") {
333
+ return { updatedAt: { gt: options.since } };
334
+ }
335
+ return void 0;
336
+ }
337
+ issueSinceFilter(options) {
338
+ if (!options.since) {
191
339
  return void 0;
192
340
  }
193
341
  return { updatedAt: { gt: options.since } };
@@ -273,7 +421,7 @@ var LinearConnector = class _LinearConnector extends BaseConnector {
273
421
  async fetchIssuesPage(page, options, signal) {
274
422
  const filter = this.mergeFilters(
275
423
  this.issueTeamFilter(),
276
- this.sinceFilter(options)
424
+ this.issueSinceFilter(options)
277
425
  );
278
426
  const historyFirst = this.settings.historyPerIssue ?? DEFAULT_HISTORY_PER_ISSUE;
279
427
  const res = await this.graphql(
@@ -406,13 +554,17 @@ var LinearConnector = class _LinearConnector extends BaseConnector {
406
554
  async sync(options, storage, signal) {
407
555
  const cursor = isLinearSyncCursor(options.cursor) ? options.cursor : void 0;
408
556
  const isFull = options.mode === "full";
409
- const historySinceMs = options.mode === "latest" && options.since ? new Date(options.since).getTime() : null;
410
- const enabled = this.settings.resources;
411
- const phases = enabled && enabled.length > 0 ? PHASE_ORDER.filter((p) => enabled.includes(p)) : PHASE_ORDER;
557
+ const historySinceMs = options.since ? new Date(options.since).getTime() : null;
558
+ const phases = selectActivePhases(
559
+ (r) => r,
560
+ PHASE_ORDER,
561
+ this.settings.resources
562
+ );
412
563
  return paginateChunked({
413
564
  phases,
414
565
  cursor,
415
566
  signal,
567
+ logger: this.logger,
416
568
  fetchPage: async (phase, page, sig) => {
417
569
  switch (phase) {
418
570
  case "teams":
@@ -469,6 +621,7 @@ var index_default = LinearConnector;
469
621
  export {
470
622
  LinearConnector,
471
623
  configFields,
472
- index_default as default
624
+ index_default as default,
625
+ doc
473
626
  };
474
627
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../connector-shared/src/errors.ts","../../../connector-shared/src/retry.ts","../../../connector-shared/src/version.ts","../../../connector-shared/src/request.ts","../../../connector-shared/src/rate-limit.ts","../../../connector-shared/src/pagination.ts","../src/linear.ts","../src/index.ts"],"sourcesContent":["import type { HttpResponse } from './types';\n\nexport type HttpErrorKind =\n | 'transient'\n | 'rate_limit'\n | 'auth'\n | 'upstream_bug'\n | 'client_bug';\n\nexport abstract class HttpClientError extends Error {\n abstract readonly kind: HttpErrorKind;\n readonly response?: HttpResponse;\n\n constructor(message: string, response?: HttpResponse) {\n super(message);\n this.name = new.target.name;\n this.response = response;\n }\n}\n\nexport class TransientError extends HttpClientError {\n readonly kind = 'transient' as const;\n}\n\nexport class RateLimitError extends HttpClientError {\n readonly kind = 'rate_limit' as const;\n readonly retryAfter?: Date;\n\n constructor(message: string, response?: HttpResponse, retryAfter?: Date) {\n super(message, response);\n this.retryAfter = retryAfter;\n }\n}\n\nexport class AuthError extends HttpClientError {\n readonly kind = 'auth' as const;\n}\n\nexport class UpstreamBugError extends HttpClientError {\n readonly kind = 'upstream_bug' as const;\n}\n\nexport class ClientBugError extends HttpClientError {\n readonly kind = 'client_bug' as const;\n}\n\nexport function classifyStatus(status: number): HttpErrorKind {\n if (status === 429) {\n return 'rate_limit';\n }\n if (status === 401 || status === 403) {\n return 'auth';\n }\n if (status === 408) {\n return 'transient';\n }\n if (status >= 500) {\n return 'upstream_bug';\n }\n if (status >= 400) {\n return 'client_bug';\n }\n return 'client_bug';\n}\n\nexport function errorForStatus(\n message: string,\n response: HttpResponse,\n retryAfter?: Date,\n): HttpClientError {\n const kind = classifyStatus(response.status);\n switch (kind) {\n case 'rate_limit':\n return new RateLimitError(message, response, retryAfter);\n case 'auth':\n return new AuthError(message, response);\n case 'transient':\n return new TransientError(message, response);\n case 'upstream_bug':\n return new UpstreamBugError(message, response);\n case 'client_bug':\n return new ClientBugError(message, response);\n }\n}\n","import { HttpClientError, RateLimitError, TransientError } from './errors';\n\nexport interface RetryPolicy {\n maxAttempts?: number;\n initialDelayMs?: number;\n maxDelayMs?: number;\n retryOn?: (status: number | null, err?: Error) => boolean;\n}\n\nexport const defaultRetryOn = (status: number | null, err?: Error): boolean => {\n if (err instanceof RateLimitError) {\n return true;\n }\n if (err instanceof TransientError) {\n return true;\n }\n if (status === null) {\n return err instanceof Error && !(err instanceof HttpClientError);\n }\n if (status === 408 || status === 429) {\n return true;\n }\n if (status >= 500) {\n return true;\n }\n return false;\n};\n\nexport function backoffDelayMs(\n attempt: number,\n policy: Required<Pick<RetryPolicy, 'initialDelayMs' | 'maxDelayMs'>>,\n): number {\n const base = policy.initialDelayMs * 2 ** attempt;\n const jitter = base * 0.25 * Math.random();\n return Math.min(base + jitter, policy.maxDelayMs);\n}\n\nexport function parseRetryAfter(\n headerValue: string | null,\n now: Date = new Date(),\n): Date | undefined {\n if (!headerValue) {\n return undefined;\n }\n const trimmed = headerValue.trim();\n if (/^\\d+$/.test(trimmed)) {\n return new Date(now.getTime() + Number(trimmed) * 1000);\n }\n const parsed = Date.parse(trimmed);\n if (Number.isNaN(parsed)) {\n return undefined;\n }\n return new Date(parsed);\n}\n\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n if (signal?.aborted) {\n return Promise.reject(signal.reason ?? new Error('Aborted'));\n }\n return new Promise<void>((resolve, reject) => {\n const onAbort = () => {\n clearTimeout(timer);\n reject(signal!.reason ?? new Error('Aborted'));\n };\n const timer = setTimeout(() => {\n signal?.removeEventListener('abort', onAbort);\n resolve();\n }, ms);\n signal?.addEventListener('abort', onAbort, { once: true });\n });\n}\n","export const HTTP_CLIENT_VERSION = '0.0.0';\n\nexport const DEFAULT_USER_AGENT = `rawdash-connector/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;\n","import {\n AuthError,\n ClientBugError,\n HttpClientError,\n RateLimitError,\n TransientError,\n UpstreamBugError,\n errorForStatus,\n} from './errors';\nimport { defaultRetryOn, parseRetryAfter, sleep } from './retry';\nimport type { FetchLike, HttpMethod, HttpRequest, HttpResponse } from './types';\nimport { DEFAULT_USER_AGENT } from './version';\n\nconst DEFAULT_TIMEOUT_MS = 10_000;\nconst DEFAULT_MAX_ATTEMPTS = 3;\nconst DEFAULT_INITIAL_DELAY_MS = 1000;\nconst DEFAULT_MAX_DELAY_MS = 60_000;\nconst OBSERVER_TIMEOUT_MS = 250;\n\nexport interface RequestObservation {\n url: string;\n method: HttpMethod;\n status: number;\n resource: string;\n requestId: string;\n body: unknown;\n}\n\nexport type RequestObserver = (\n event: RequestObservation,\n) => void | Promise<void>;\n\nexport interface RequestOptions {\n fetch?: FetchLike;\n observer?: RequestObserver;\n resource: string;\n requestId?: string;\n}\n\nasync function notifyObserver(\n observer: RequestObserver,\n event: RequestObservation,\n): Promise<void> {\n let result: void | Promise<void>;\n try {\n result = observer(event);\n } catch (err) {\n console.warn('[connector-shared] request observer threw:', err);\n return;\n }\n if (!(result instanceof Promise)) {\n return;\n }\n const guarded = result.catch((err) => {\n console.warn('[connector-shared] request observer rejected:', err);\n });\n let timer: ReturnType<typeof setTimeout> | undefined;\n const timeout = new Promise<void>((resolve) => {\n timer = setTimeout(resolve, OBSERVER_TIMEOUT_MS);\n });\n try {\n await Promise.race([guarded, timeout]);\n } finally {\n if (timer) {\n clearTimeout(timer);\n }\n }\n}\n\nfunction newRequestId(): string {\n const c = (globalThis as { crypto?: { randomUUID?: () => string } }).crypto;\n if (c?.randomUUID) {\n return c.randomUUID();\n }\n return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\nfunction mergeHeaders(\n defaults: Record<string, string>,\n overrides: Record<string, string> | undefined,\n): Record<string, string> {\n const merged: Record<string, string> = {};\n for (const [k, v] of Object.entries(defaults)) {\n merged[k.toLowerCase()] = v;\n }\n if (overrides) {\n for (const [k, v] of Object.entries(overrides)) {\n merged[k.toLowerCase()] = v;\n }\n }\n return merged;\n}\n\nfunction linkTimeoutSignal(\n parent: AbortSignal | undefined,\n timeoutMs: number,\n): { signal: AbortSignal; cancel: () => void } {\n const controller = new AbortController();\n const onParentAbort = () => {\n controller.abort(parent?.reason);\n };\n if (parent) {\n if (parent.aborted) {\n controller.abort(parent.reason);\n } else {\n parent.addEventListener('abort', onParentAbort, { once: true });\n }\n }\n const timer = setTimeout(() => {\n controller.abort(new Error(`Request timed out after ${timeoutMs}ms`));\n }, timeoutMs);\n return {\n signal: controller.signal,\n cancel: () => {\n clearTimeout(timer);\n if (parent) {\n parent.removeEventListener('abort', onParentAbort);\n }\n },\n };\n}\n\nasync function readBody(res: Response, parseJson: boolean): Promise<unknown> {\n if (res.status === 204 || res.status === 205) {\n return null;\n }\n const contentType = res.headers.get('content-type') ?? '';\n if (parseJson && contentType.includes('application/json')) {\n const text = await res.text();\n if (text.length === 0) {\n return null;\n }\n return JSON.parse(text);\n }\n return res.text();\n}\n\nexport async function request<T = unknown>(\n req: HttpRequest,\n options: RequestOptions,\n): Promise<HttpResponse<T>> {\n const fetchImpl: FetchLike = options.fetch ?? (globalThis.fetch as FetchLike);\n const retry = req.retry ?? {};\n const maxAttempts = retry.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;\n const initialDelayMs = retry.initialDelayMs ?? DEFAULT_INITIAL_DELAY_MS;\n const maxDelayMs = retry.maxDelayMs ?? DEFAULT_MAX_DELAY_MS;\n const retryOn = retry.retryOn ?? defaultRetryOn;\n const timeoutMs = req.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n const parseJson = req.parseJson ?? true;\n\n const headers = mergeHeaders(\n {\n 'User-Agent': DEFAULT_USER_AGENT,\n Accept: 'application/json',\n },\n req.headers,\n );\n\n let lastErr: Error | undefined;\n\n for (let attempt = 0; attempt < maxAttempts; attempt++) {\n req.signal?.throwIfAborted();\n\n const { signal, cancel } = linkTimeoutSignal(req.signal, timeoutMs);\n let res: Response;\n try {\n res = await fetchImpl(req.url, {\n method: req.method ?? 'GET',\n headers,\n body: req.body as RequestInit['body'],\n signal,\n });\n } catch (err) {\n cancel();\n if (req.signal?.aborted) {\n throw req.signal.reason ?? err;\n }\n const error = err instanceof Error ? err : new Error(String(err));\n lastErr = error;\n if (attempt < maxAttempts - 1 && retryOn(null, error)) {\n const delay = computeDelay(attempt, initialDelayMs, maxDelayMs);\n await sleep(delay, req.signal);\n continue;\n }\n throw new TransientError(error.message);\n }\n cancel();\n\n const body = await readBody(res, parseJson);\n const httpResponse: HttpResponse<T> = {\n status: res.status,\n headers: res.headers,\n body: body as T,\n };\n if (req.rateLimit) {\n const state = req.rateLimit.parse(res.headers);\n if (state) {\n httpResponse.rateLimitState = state;\n }\n }\n\n if (options.observer) {\n await notifyObserver(options.observer, {\n url: req.url,\n method: req.method ?? 'GET',\n status: res.status,\n resource: options.resource,\n requestId: options.requestId ?? newRequestId(),\n body,\n });\n }\n\n if (res.ok) {\n return httpResponse;\n }\n\n const retryAfter = parseRetryAfter(res.headers.get('retry-after'));\n const message = `HTTP ${res.status} ${res.statusText} for ${req.method ?? 'GET'} ${req.url}`;\n const err = errorForStatus(message, httpResponse, retryAfter);\n\n if (\n attempt < maxAttempts - 1 &&\n retryOn(res.status, err) &&\n !(err instanceof AuthError) &&\n !(err instanceof ClientBugError)\n ) {\n lastErr = err;\n let delay = computeDelay(attempt, initialDelayMs, maxDelayMs);\n if (err instanceof RateLimitError && retryAfter) {\n const wait = retryAfter.getTime() - Date.now();\n if (wait > 0) {\n delay = Math.min(wait, maxDelayMs);\n }\n }\n await sleep(delay, req.signal);\n continue;\n }\n\n throw err;\n }\n\n throw lastErr ?? new UpstreamBugError('Exhausted retry attempts');\n}\n\nfunction computeDelay(\n attempt: number,\n initialDelayMs: number,\n maxDelayMs: number,\n): number {\n const base = initialDelayMs * 2 ** attempt;\n const jitter = base * 0.25 * Math.random();\n return Math.min(base + jitter, maxDelayMs);\n}\n\nexport { HttpClientError };\n","export interface RateLimitState {\n remaining: number;\n resetAt: Date;\n}\n\nexport interface RateLimitPolicy {\n parse(headers: Headers): RateLimitState | null;\n}\n\nexport const githubRateLimit: RateLimitPolicy = {\n parse(h) {\n const remainingRaw = h.get('x-ratelimit-remaining');\n const resetRaw = h.get('x-ratelimit-reset');\n if (remainingRaw === null || resetRaw === null) {\n return null;\n }\n const remaining = Number(remainingRaw);\n const reset = Number(resetRaw);\n if (!Number.isFinite(remaining) || !Number.isFinite(reset) || reset < 0) {\n return null;\n }\n return { remaining, resetAt: new Date(reset * 1000) };\n },\n};\n\nexport const sentryRateLimit: RateLimitPolicy = {\n parse(h) {\n const concurrent = h.get('x-sentry-rate-limit-remaining');\n const reset = h.get('x-sentry-rate-limit-reset');\n if (concurrent === null || reset === null) {\n return null;\n }\n const remaining = Number(concurrent);\n const resetSec = Number(reset);\n if (\n !Number.isFinite(remaining) ||\n !Number.isFinite(resetSec) ||\n resetSec < 0\n ) {\n return null;\n }\n return { remaining, resetAt: new Date(resetSec * 1000) };\n },\n};\n\nexport const linearRateLimit: RateLimitPolicy = {\n parse(h) {\n const remainingRaw = h.get('x-ratelimit-requests-remaining');\n const resetRaw = h.get('x-ratelimit-requests-reset');\n if (remainingRaw === null) {\n return null;\n }\n const remaining = Number(remainingRaw);\n if (!Number.isFinite(remaining)) {\n return null;\n }\n let resetAt: Date;\n if (resetRaw !== null) {\n const reset = Number(resetRaw);\n if (!Number.isFinite(reset) || reset < 0) {\n return null;\n }\n resetAt = new Date(reset);\n } else {\n resetAt = new Date(Date.now() + 60_000);\n }\n return { remaining, resetAt };\n },\n};\n","import { request } from './request';\nimport type { HttpRequest } from './types';\n\nexport function parseLinkHeader(header: string | null): Record<string, string> {\n if (!header) {\n return {};\n }\n const result: Record<string, string> = {};\n for (const part of header.split(',')) {\n const match = part.match(/<([^>]+)>\\s*;\\s*rel=\"([^\"]+)\"/);\n if (match) {\n result[match[2]!] = match[1]!;\n }\n }\n return result;\n}\n\nexport async function* paginateLink<T>(\n initial: HttpRequest,\n parse: (body: unknown) => T[],\n options: { resource: string },\n): AsyncIterable<T> {\n let next: string | null = initial.url;\n while (next) {\n const res: Awaited<ReturnType<typeof request>> = await request(\n {\n ...initial,\n url: next,\n },\n { resource: options.resource },\n );\n for (const item of parse(res.body)) {\n yield item;\n }\n const links = parseLinkHeader(res.headers.get('link'));\n next = links['next'] ?? null;\n }\n}\n\nexport async function* paginateCursor<T>(\n initial: HttpRequest,\n parse: (body: unknown) => { items: T[]; nextCursor: string | null },\n buildNext: (req: HttpRequest, cursor: string) => HttpRequest,\n options: { resource: string },\n): AsyncIterable<T> {\n let req: HttpRequest = initial;\n while (true) {\n const res = await request(req, { resource: options.resource });\n const { items, nextCursor } = parse(res.body);\n for (const item of items) {\n yield item;\n }\n if (!nextCursor) {\n return;\n }\n req = buildNext(req, nextCursor);\n }\n}\n\nexport async function* paginatePage<T>(\n initial: HttpRequest,\n parse: (body: unknown) => { items: T[]; hasMore: boolean },\n buildPage: (req: HttpRequest, page: number) => HttpRequest,\n options: { resource: string },\n): AsyncIterable<T> {\n let page = 1;\n while (true) {\n const req = page === 1 ? initial : buildPage(initial, page);\n const res = await request(req, { resource: options.resource });\n const { items, hasMore } = parse(res.body);\n for (const item of items) {\n yield item;\n }\n if (!hasMore || items.length === 0) {\n return;\n }\n page++;\n }\n}\n","import { type HttpResponse, linearRateLimit } from '@rawdash/connector-shared';\nimport {\n BaseConnector,\n type ChunkedSyncCursor,\n type ConnectorContext,\n type CredentialsSchema,\n type StorageHandle,\n type SyncOptions,\n type SyncResult,\n defineConfigFields,\n paginateChunked,\n} from '@rawdash/core';\nimport { z } from 'zod';\n\nexport const configFields = defineConfigFields(\n z.object({\n apiKey: z.object({ $secret: z.string() }).meta({\n label: 'API Key',\n description:\n 'Linear Personal API Key. Create one at Linear → Settings → API → Personal API keys.',\n placeholder: 'lin_api_...',\n secret: true,\n }),\n teamIds: z.array(z.string().min(1)).nonempty().optional().meta({\n label: 'Team IDs (optional)',\n description:\n 'Restrict the sync to specific Linear team IDs. Omit to sync all teams the API key can see.',\n }),\n resources: z\n .array(z.enum(['teams', 'users', 'cycles', 'issues']))\n .nonempty()\n .optional()\n .meta({\n label: 'Resources',\n description:\n \"Which Linear resources to sync. Omit to sync all resources. The `issues` phase also emits state-transition events derived from each issue's history.\",\n }),\n historyPerIssue: z.number().int().positive().max(50).optional().meta({\n label: 'History entries per issue',\n description:\n 'How many history entries to pull per issue (newest first). State transitions inside this window become events. Defaults to 25.',\n placeholder: '25',\n }),\n }),\n);\n\nexport interface LinearSettings {\n teamIds?: readonly string[];\n resources?: readonly LinearResource[];\n historyPerIssue?: number;\n}\n\nconst linearCredentials = {\n apiKey: {\n description: 'Linear Personal API Key',\n auth: 'required' as const,\n },\n} satisfies CredentialsSchema;\n\ntype LinearCredentials = typeof linearCredentials;\n\nconst PHASE_ORDER = ['teams', 'users', 'cycles', 'issues'] as const;\n\ntype LinearPhase = (typeof PHASE_ORDER)[number];\n\nexport type LinearResource = LinearPhase;\n\ntype LinearSyncCursor = ChunkedSyncCursor<LinearPhase, string>;\n\nfunction isLinearSyncCursor(value: unknown): value is LinearSyncCursor {\n if (typeof value !== 'object' || value === null) {\n return false;\n }\n const v = value as { phase?: unknown; page?: unknown };\n if (typeof v.phase !== 'string') {\n return false;\n }\n if (!(PHASE_ORDER as readonly string[]).includes(v.phase)) {\n return false;\n }\n if (v.page !== null && typeof v.page !== 'string') {\n return false;\n }\n return true;\n}\n\n// ---------------------------------------------------------------------------\n// Linear GraphQL types\n// ---------------------------------------------------------------------------\n\ninterface PageInfo {\n hasNextPage: boolean;\n endCursor: string | null;\n}\n\ninterface Connection<T> {\n nodes: T[];\n pageInfo: PageInfo;\n}\n\ninterface LinearTeam {\n id: string;\n name: string;\n key: string;\n createdAt: string;\n updatedAt: string;\n}\n\ninterface LinearUser {\n id: string;\n name: string;\n email: string | null;\n displayName: string;\n active: boolean;\n createdAt: string;\n updatedAt: string;\n}\n\ninterface LinearCycle {\n id: string;\n number: number;\n name: string | null;\n startsAt: string;\n endsAt: string;\n completedAt: string | null;\n progress: number | null;\n scopeHistory: number[] | null;\n completedScopeHistory: number[] | null;\n team: { id: string } | null;\n createdAt: string;\n updatedAt: string;\n}\n\ninterface LinearIssueHistory {\n id: string;\n createdAt: string;\n actor: { id: string } | null;\n fromState: { id: string; name: string } | null;\n toState: { id: string; name: string } | null;\n fromAssignee: { id: string } | null;\n toAssignee: { id: string } | null;\n}\n\ninterface LinearIssue {\n id: string;\n identifier: string;\n title: string;\n priority: number;\n estimate: number | null;\n state: { id: string; name: string; type: string } | null;\n assignee: { id: string } | null;\n team: { id: string } | null;\n project: { id: string } | null;\n cycle: { id: string } | null;\n labels: { nodes: Array<{ id: string; name: string }> };\n createdAt: string;\n updatedAt: string;\n completedAt: string | null;\n canceledAt: string | null;\n startedAt: string | null;\n history: Connection<LinearIssueHistory>;\n}\n\ninterface GraphQLError {\n message: string;\n extensions?: { code?: string; type?: string };\n}\n\ninterface GraphQLResponse<T> {\n data?: T;\n errors?: GraphQLError[];\n}\n\n// ---------------------------------------------------------------------------\n// GraphQL documents\n// ---------------------------------------------------------------------------\n\nconst TEAMS_QUERY = `\n query Teams($after: String, $first: Int!, $filter: TeamFilter) {\n teams(after: $after, first: $first, filter: $filter, orderBy: updatedAt) {\n nodes { id name key createdAt updatedAt }\n pageInfo { hasNextPage endCursor }\n }\n }\n`;\n\nconst USERS_QUERY = `\n query Users($after: String, $first: Int!, $filter: UserFilter) {\n users(after: $after, first: $first, filter: $filter, orderBy: updatedAt) {\n nodes { id name email displayName active createdAt updatedAt }\n pageInfo { hasNextPage endCursor }\n }\n }\n`;\n\nconst CYCLES_QUERY = `\n query Cycles($after: String, $first: Int!, $filter: CycleFilter) {\n cycles(after: $after, first: $first, filter: $filter, orderBy: updatedAt) {\n nodes {\n id number name startsAt endsAt completedAt progress\n scopeHistory completedScopeHistory\n team { id }\n createdAt updatedAt\n }\n pageInfo { hasNextPage endCursor }\n }\n }\n`;\n\nconst ISSUES_QUERY = `\n query Issues(\n $after: String\n $first: Int!\n $filter: IssueFilter\n $historyFirst: Int!\n ) {\n issues(after: $after, first: $first, filter: $filter, orderBy: updatedAt) {\n nodes {\n id identifier title priority estimate\n state { id name type }\n assignee { id }\n team { id }\n project { id }\n cycle { id }\n labels { nodes { id name } }\n createdAt updatedAt completedAt canceledAt startedAt\n history(first: $historyFirst) {\n nodes {\n id createdAt\n actor { id }\n fromState { id name }\n toState { id name }\n fromAssignee { id }\n toAssignee { id }\n }\n pageInfo { hasNextPage endCursor }\n }\n }\n pageInfo { hasNextPage endCursor }\n }\n }\n`;\n\n// ---------------------------------------------------------------------------\n// LinearConnector\n// ---------------------------------------------------------------------------\n\nconst PAGE_SIZE = 50;\nconst DEFAULT_HISTORY_PER_ISSUE = 25;\nconst ENDPOINT = 'https://api.linear.app/graphql';\n\nexport class LinearConnector extends BaseConnector<\n LinearSettings,\n LinearCredentials\n> {\n static readonly id = 'linear';\n\n static create(input: unknown, ctx?: ConnectorContext): LinearConnector {\n const parsed = configFields.parse(input);\n return new LinearConnector(\n {\n teamIds: parsed.teamIds,\n resources: parsed.resources,\n historyPerIssue: parsed.historyPerIssue,\n },\n { apiKey: parsed.apiKey },\n ctx,\n );\n }\n\n readonly id = 'linear';\n override readonly credentials = linearCredentials;\n\n private buildHeaders(): Record<string, string> {\n return {\n Authorization: this.creds.apiKey,\n 'Content-Type': 'application/json',\n 'User-Agent': 'rawdash/connector-linear (+https://rawdash.dev)',\n };\n }\n\n private async graphql<T>(\n query: string,\n variables: Record<string, unknown>,\n resource: string,\n signal?: AbortSignal,\n ): Promise<HttpResponse<GraphQLResponse<T>>> {\n const res = await this.post<GraphQLResponse<T>>(ENDPOINT, {\n resource,\n headers: this.buildHeaders(),\n body: JSON.stringify({ query, variables }),\n signal,\n rateLimit: linearRateLimit,\n });\n if (res.body.errors && res.body.errors.length > 0) {\n const messages = res.body.errors.map((e) => e.message).join('; ');\n throw new Error(`Linear GraphQL error: ${messages}`);\n }\n if (!res.body.data) {\n throw new Error(\n `Linear GraphQL response missing data for resource '${resource}'`,\n );\n }\n return res;\n }\n\n private sinceFilter(\n options: SyncOptions,\n ): Record<string, unknown> | undefined {\n if (options.mode !== 'latest' || !options.since) {\n return undefined;\n }\n return { updatedAt: { gt: options.since } };\n }\n\n private teamFilter(): Record<string, unknown> | undefined {\n const ids = this.settings.teamIds;\n if (!ids || ids.length === 0) {\n return undefined;\n }\n return { id: { in: [...ids] } };\n }\n\n private issueTeamFilter(): Record<string, unknown> | undefined {\n const ids = this.settings.teamIds;\n if (!ids || ids.length === 0) {\n return undefined;\n }\n return { team: { id: { in: [...ids] } } };\n }\n\n private mergeFilters(\n ...filters: Array<Record<string, unknown> | undefined>\n ): Record<string, unknown> | undefined {\n const merged: Record<string, unknown> = {};\n let any = false;\n for (const f of filters) {\n if (f) {\n Object.assign(merged, f);\n any = true;\n }\n }\n return any ? merged : undefined;\n }\n\n // ---------------------------------------------------------------------------\n // Fetchers\n // ---------------------------------------------------------------------------\n\n private async fetchTeamsPage(\n page: string | null,\n options: SyncOptions,\n signal?: AbortSignal,\n ): Promise<{ items: LinearTeam[]; next: string | null }> {\n const filter = this.mergeFilters(\n this.teamFilter(),\n this.sinceFilter(options),\n );\n const res = await this.graphql<{ teams: Connection<LinearTeam> }>(\n TEAMS_QUERY,\n { after: page ?? null, first: PAGE_SIZE, filter },\n 'teams',\n signal,\n );\n const conn = res.body.data!.teams;\n return {\n items: conn.nodes,\n next: conn.pageInfo.hasNextPage ? conn.pageInfo.endCursor : null,\n };\n }\n\n private async fetchUsersPage(\n page: string | null,\n options: SyncOptions,\n signal?: AbortSignal,\n ): Promise<{ items: LinearUser[]; next: string | null }> {\n const res = await this.graphql<{ users: Connection<LinearUser> }>(\n USERS_QUERY,\n {\n after: page ?? null,\n first: PAGE_SIZE,\n filter: this.sinceFilter(options),\n },\n 'users',\n signal,\n );\n const conn = res.body.data!.users;\n return {\n items: conn.nodes,\n next: conn.pageInfo.hasNextPage ? conn.pageInfo.endCursor : null,\n };\n }\n\n private async fetchCyclesPage(\n page: string | null,\n options: SyncOptions,\n signal?: AbortSignal,\n ): Promise<{ items: LinearCycle[]; next: string | null }> {\n const teamIds = this.settings.teamIds;\n const teamFilter =\n teamIds && teamIds.length > 0\n ? { team: { id: { in: [...teamIds] } } }\n : undefined;\n const filter = this.mergeFilters(teamFilter, this.sinceFilter(options));\n const res = await this.graphql<{ cycles: Connection<LinearCycle> }>(\n CYCLES_QUERY,\n { after: page ?? null, first: PAGE_SIZE, filter },\n 'cycles',\n signal,\n );\n const conn = res.body.data!.cycles;\n return {\n items: conn.nodes,\n next: conn.pageInfo.hasNextPage ? conn.pageInfo.endCursor : null,\n };\n }\n\n private async fetchIssuesPage(\n page: string | null,\n options: SyncOptions,\n signal?: AbortSignal,\n ): Promise<{ items: LinearIssue[]; next: string | null }> {\n const filter = this.mergeFilters(\n this.issueTeamFilter(),\n this.sinceFilter(options),\n );\n const historyFirst =\n this.settings.historyPerIssue ?? DEFAULT_HISTORY_PER_ISSUE;\n const res = await this.graphql<{ issues: Connection<LinearIssue> }>(\n ISSUES_QUERY,\n { after: page ?? null, first: PAGE_SIZE, filter, historyFirst },\n 'issues',\n signal,\n );\n const conn = res.body.data!.issues;\n return {\n items: conn.nodes,\n next: conn.pageInfo.hasNextPage ? conn.pageInfo.endCursor : null,\n };\n }\n\n // ---------------------------------------------------------------------------\n // Writers\n // ---------------------------------------------------------------------------\n\n private async writeTeams(\n storage: StorageHandle,\n teams: LinearTeam[],\n ): Promise<void> {\n for (const t of teams) {\n await storage.entity({\n type: 'linear_team',\n id: t.id,\n attributes: {\n name: t.name,\n key: t.key,\n createdAt: new Date(t.createdAt).getTime(),\n },\n updated_at: new Date(t.updatedAt).getTime(),\n });\n }\n }\n\n private async writeUsers(\n storage: StorageHandle,\n users: LinearUser[],\n ): Promise<void> {\n for (const u of users) {\n await storage.entity({\n type: 'linear_user',\n id: u.id,\n attributes: {\n name: u.name,\n email: u.email,\n displayName: u.displayName,\n active: u.active,\n createdAt: new Date(u.createdAt).getTime(),\n },\n updated_at: new Date(u.updatedAt).getTime(),\n });\n }\n }\n\n private async writeCycles(\n storage: StorageHandle,\n cycles: LinearCycle[],\n ): Promise<void> {\n for (const c of cycles) {\n const startsMs = new Date(c.startsAt).getTime();\n const endsMs = new Date(c.endsAt).getTime();\n const scopeFinal =\n c.scopeHistory && c.scopeHistory.length > 0\n ? (c.scopeHistory.at(-1) ?? null)\n : null;\n const completedFinal =\n c.completedScopeHistory && c.completedScopeHistory.length > 0\n ? (c.completedScopeHistory.at(-1) ?? null)\n : null;\n await storage.entity({\n type: 'linear_cycle',\n id: c.id,\n attributes: {\n number: c.number,\n name: c.name,\n teamId: c.team?.id ?? null,\n startsAt: startsMs,\n endsAt: endsMs,\n completedAt: c.completedAt ? new Date(c.completedAt).getTime() : null,\n progress: c.progress,\n scope: scopeFinal,\n completedScope: completedFinal,\n },\n updated_at: new Date(c.updatedAt).getTime(),\n });\n }\n }\n\n private async writeIssues(\n storage: StorageHandle,\n issues: LinearIssue[],\n historySinceMs: number | null,\n ): Promise<void> {\n for (const i of issues) {\n await storage.entity({\n type: 'linear_issue',\n id: i.id,\n attributes: {\n identifier: i.identifier,\n title: i.title,\n stateId: i.state?.id ?? null,\n stateName: i.state?.name ?? null,\n stateType: i.state?.type ?? null,\n priority: i.priority,\n assigneeId: i.assignee?.id ?? null,\n teamId: i.team?.id ?? null,\n projectId: i.project?.id ?? null,\n cycleId: i.cycle?.id ?? null,\n labels: i.labels.nodes.map((l) => l.name),\n estimate: i.estimate,\n createdAt: new Date(i.createdAt).getTime(),\n completedAt: i.completedAt ? new Date(i.completedAt).getTime() : null,\n canceledAt: i.canceledAt ? new Date(i.canceledAt).getTime() : null,\n startedAt: i.startedAt ? new Date(i.startedAt).getTime() : null,\n },\n updated_at: new Date(i.updatedAt).getTime(),\n });\n\n for (const h of i.history.nodes) {\n if (!h.toState || !h.fromState) {\n continue;\n }\n if (h.toState.id === h.fromState.id) {\n continue;\n }\n const eventTs = new Date(h.createdAt).getTime();\n if (historySinceMs !== null && eventTs <= historySinceMs) {\n continue;\n }\n await storage.event({\n name: 'linear_issue_state_change',\n start_ts: eventTs,\n end_ts: null,\n attributes: {\n historyId: h.id,\n issueId: i.id,\n issueIdentifier: i.identifier,\n teamId: i.team?.id ?? null,\n actorId: h.actor?.id ?? null,\n fromStateId: h.fromState.id,\n fromStateName: h.fromState.name,\n toStateId: h.toState.id,\n toStateName: h.toState.name,\n },\n });\n }\n }\n }\n\n // ---------------------------------------------------------------------------\n // sync\n // ---------------------------------------------------------------------------\n\n async sync(\n options: SyncOptions,\n storage: StorageHandle,\n signal?: AbortSignal,\n ): Promise<SyncResult> {\n const cursor = isLinearSyncCursor(options.cursor)\n ? options.cursor\n : undefined;\n const isFull = options.mode === 'full';\n const historySinceMs =\n options.mode === 'latest' && options.since\n ? new Date(options.since).getTime()\n : null;\n\n const enabled = this.settings.resources;\n const phases =\n enabled && enabled.length > 0\n ? PHASE_ORDER.filter((p) => enabled.includes(p))\n : PHASE_ORDER;\n\n return paginateChunked<LinearPhase, string>({\n phases,\n cursor,\n signal,\n fetchPage: async (phase, page, sig) => {\n switch (phase) {\n case 'teams':\n return this.fetchTeamsPage(page, options, sig);\n case 'users':\n return this.fetchUsersPage(page, options, sig);\n case 'cycles':\n return this.fetchCyclesPage(page, options, sig);\n case 'issues':\n return this.fetchIssuesPage(page, options, sig);\n }\n },\n writeBatch: async (phase, items, page) => {\n if (isFull && page === null) {\n switch (phase) {\n case 'teams':\n await storage.entities([], { types: ['linear_team'] });\n break;\n case 'users':\n await storage.entities([], { types: ['linear_user'] });\n break;\n case 'cycles':\n await storage.entities([], { types: ['linear_cycle'] });\n break;\n case 'issues':\n await storage.entities([], { types: ['linear_issue'] });\n await storage.events([], {\n names: ['linear_issue_state_change'],\n });\n break;\n }\n }\n switch (phase) {\n case 'teams':\n return this.writeTeams(storage, items as LinearTeam[]);\n case 'users':\n return this.writeUsers(storage, items as LinearUser[]);\n case 'cycles':\n return this.writeCycles(storage, items as LinearCycle[]);\n case 'issues':\n return this.writeIssues(\n storage,\n items as LinearIssue[],\n historySinceMs,\n );\n }\n },\n });\n }\n}\n","import { LinearConnector } from './linear';\n\nexport { configFields, LinearConnector } from './linear';\nexport type { LinearSettings, LinearResource } from './linear';\nexport default LinearConnector;\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../../../connector-shared/src/errors.ts","../../../connector-shared/src/retry.ts","../../../connector-shared/src/version.ts","../../../connector-shared/src/request.ts","../../../connector-shared/src/rate-limit.ts","../../../connector-shared/src/sanitize.ts","../../../connector-shared/src/epoch.ts","../../../connector-shared/src/pagination.ts","../../../connector-shared/src/logger.ts","../src/linear.ts","../src/index.ts"],"sourcesContent":["import type { HttpResponse } from './types';\n\nexport type HttpErrorKind =\n | 'transient'\n | 'rate_limit'\n | 'auth'\n | 'upstream_bug'\n | 'client_bug';\n\nexport abstract class HttpClientError extends Error {\n abstract readonly kind: HttpErrorKind;\n readonly response?: HttpResponse;\n\n constructor(message: string, response?: HttpResponse) {\n super(message);\n this.name = new.target.name;\n this.response = response;\n }\n}\n\nexport class TransientError extends HttpClientError {\n readonly kind = 'transient' as const;\n}\n\nexport class RateLimitError extends HttpClientError {\n readonly kind = 'rate_limit' as const;\n readonly retryAfter?: Date;\n\n constructor(message: string, response?: HttpResponse, retryAfter?: Date) {\n super(message, response);\n this.retryAfter = retryAfter;\n }\n}\n\nexport class AuthError extends HttpClientError {\n readonly kind = 'auth' as const;\n}\n\nexport class UpstreamBugError extends HttpClientError {\n readonly kind = 'upstream_bug' as const;\n}\n\nexport class ClientBugError extends HttpClientError {\n readonly kind = 'client_bug' as const;\n}\n\nexport function classifyStatus(status: number): HttpErrorKind {\n if (status === 429) {\n return 'rate_limit';\n }\n if (status === 401 || status === 403) {\n return 'auth';\n }\n if (status === 408) {\n return 'transient';\n }\n if (status >= 500) {\n return 'upstream_bug';\n }\n if (status >= 400) {\n return 'client_bug';\n }\n return 'client_bug';\n}\n\nexport function errorForStatus(\n message: string,\n response: HttpResponse,\n retryAfter?: Date,\n): HttpClientError {\n const kind = classifyStatus(response.status);\n switch (kind) {\n case 'rate_limit':\n return new RateLimitError(message, response, retryAfter);\n case 'auth':\n return new AuthError(message, response);\n case 'transient':\n return new TransientError(message, response);\n case 'upstream_bug':\n return new UpstreamBugError(message, response);\n case 'client_bug':\n return new ClientBugError(message, response);\n }\n}\n","import { HttpClientError, RateLimitError, TransientError } from './errors';\n\nexport interface RetryPolicy {\n maxAttempts?: number;\n initialDelayMs?: number;\n maxDelayMs?: number;\n retryOn?: (status: number | null, err?: Error) => boolean;\n}\n\nexport const defaultRetryOn = (status: number | null, err?: Error): boolean => {\n if (err instanceof RateLimitError) {\n return true;\n }\n if (err instanceof TransientError) {\n return true;\n }\n if (status === null) {\n return err instanceof Error && !(err instanceof HttpClientError);\n }\n if (status === 408 || status === 429) {\n return true;\n }\n if (status >= 500) {\n return true;\n }\n return false;\n};\n\nexport function backoffDelayMs(\n attempt: number,\n policy: Required<Pick<RetryPolicy, 'initialDelayMs' | 'maxDelayMs'>>,\n): number {\n const base = policy.initialDelayMs * 2 ** attempt;\n const jitter = base * 0.25 * Math.random();\n return Math.min(base + jitter, policy.maxDelayMs);\n}\n\nexport function parseRetryAfter(\n headerValue: string | null,\n now: Date = new Date(),\n): Date | undefined {\n if (!headerValue) {\n return undefined;\n }\n const trimmed = headerValue.trim();\n if (/^\\d+$/.test(trimmed)) {\n return new Date(now.getTime() + Number(trimmed) * 1000);\n }\n const parsed = Date.parse(trimmed);\n if (Number.isNaN(parsed)) {\n return undefined;\n }\n return new Date(parsed);\n}\n\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n if (signal?.aborted) {\n return Promise.reject(signal.reason ?? new Error('Aborted'));\n }\n return new Promise<void>((resolve, reject) => {\n const onAbort = () => {\n clearTimeout(timer);\n reject(signal!.reason ?? new Error('Aborted'));\n };\n const timer = setTimeout(() => {\n signal?.removeEventListener('abort', onAbort);\n resolve();\n }, ms);\n signal?.addEventListener('abort', onAbort, { once: true });\n });\n}\n","export const HTTP_CLIENT_VERSION = '0.0.0';\n\nexport const DEFAULT_USER_AGENT = `rawdash-connector/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;\n\nexport function connectorUserAgent(connectorId: string): string {\n return `rawdash-connector-${connectorId}/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;\n}\n","import {\n AuthError,\n ClientBugError,\n HttpClientError,\n RateLimitError,\n TransientError,\n UpstreamBugError,\n errorForStatus,\n} from './errors';\nimport { defaultRetryOn, parseRetryAfter, sleep } from './retry';\nimport type { FetchLike, HttpMethod, HttpRequest, HttpResponse } from './types';\nimport { DEFAULT_USER_AGENT } from './version';\n\nconst DEFAULT_TIMEOUT_MS = 10_000;\nconst DEFAULT_MAX_ATTEMPTS = 3;\nconst DEFAULT_INITIAL_DELAY_MS = 1000;\nconst DEFAULT_MAX_DELAY_MS = 60_000;\nconst OBSERVER_TIMEOUT_MS = 250;\n\nexport interface RequestObservation {\n url: string;\n method: HttpMethod;\n status: number;\n resource: string;\n requestId: string;\n body: unknown;\n}\n\nexport type RequestObserver = (\n event: RequestObservation,\n) => void | Promise<void>;\n\nexport interface RequestOptions {\n fetch?: FetchLike;\n observer?: RequestObserver;\n resource: string;\n requestId?: string;\n}\n\nasync function notifyObserver(\n observer: RequestObserver,\n event: RequestObservation,\n): Promise<void> {\n let result: void | Promise<void>;\n try {\n result = observer(event);\n } catch (err) {\n console.warn('[connector-shared] request observer threw:', err);\n return;\n }\n if (!(result instanceof Promise)) {\n return;\n }\n const guarded = result.catch((err) => {\n console.warn('[connector-shared] request observer rejected:', err);\n });\n let timer: ReturnType<typeof setTimeout> | undefined;\n const timeout = new Promise<void>((resolve) => {\n timer = setTimeout(resolve, OBSERVER_TIMEOUT_MS);\n });\n try {\n await Promise.race([guarded, timeout]);\n } finally {\n if (timer) {\n clearTimeout(timer);\n }\n }\n}\n\nfunction newRequestId(): string {\n const c = (globalThis as { crypto?: { randomUUID?: () => string } }).crypto;\n if (c?.randomUUID) {\n return c.randomUUID();\n }\n return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\nfunction mergeHeaders(\n defaults: Record<string, string>,\n overrides: Record<string, string> | undefined,\n): Record<string, string> {\n const merged: Record<string, string> = {};\n for (const [k, v] of Object.entries(defaults)) {\n merged[k.toLowerCase()] = v;\n }\n if (overrides) {\n for (const [k, v] of Object.entries(overrides)) {\n merged[k.toLowerCase()] = v;\n }\n }\n return merged;\n}\n\nfunction linkTimeoutSignal(\n parent: AbortSignal | undefined,\n timeoutMs: number,\n): { signal: AbortSignal; cancel: () => void } {\n const controller = new AbortController();\n const onParentAbort = () => {\n controller.abort(parent?.reason);\n };\n if (parent) {\n if (parent.aborted) {\n controller.abort(parent.reason);\n } else {\n parent.addEventListener('abort', onParentAbort, { once: true });\n }\n }\n const timer = setTimeout(() => {\n controller.abort(new Error(`Request timed out after ${timeoutMs}ms`));\n }, timeoutMs);\n return {\n signal: controller.signal,\n cancel: () => {\n clearTimeout(timer);\n if (parent) {\n parent.removeEventListener('abort', onParentAbort);\n }\n },\n };\n}\n\nasync function readBody(res: Response, parseJson: boolean): Promise<unknown> {\n if (res.status === 204 || res.status === 205) {\n return null;\n }\n const contentType = res.headers.get('content-type') ?? '';\n if (parseJson && contentType.includes('application/json')) {\n const text = await res.text();\n if (text.length === 0) {\n return null;\n }\n return JSON.parse(text);\n }\n return res.text();\n}\n\nexport async function request<T = unknown>(\n req: HttpRequest,\n options: RequestOptions,\n): Promise<HttpResponse<T>> {\n const fetchImpl: FetchLike = options.fetch ?? (globalThis.fetch as FetchLike);\n const retry = req.retry ?? {};\n const maxAttempts = retry.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;\n const initialDelayMs = retry.initialDelayMs ?? DEFAULT_INITIAL_DELAY_MS;\n const maxDelayMs = retry.maxDelayMs ?? DEFAULT_MAX_DELAY_MS;\n const retryOn = retry.retryOn ?? defaultRetryOn;\n const timeoutMs = req.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n const parseJson = req.parseJson ?? true;\n\n const headers = mergeHeaders(\n {\n 'User-Agent': DEFAULT_USER_AGENT,\n Accept: 'application/json',\n },\n req.headers,\n );\n\n let lastErr: Error | undefined;\n\n for (let attempt = 0; attempt < maxAttempts; attempt++) {\n req.signal?.throwIfAborted();\n\n const { signal, cancel } = linkTimeoutSignal(req.signal, timeoutMs);\n let res: Response;\n try {\n res = await fetchImpl(req.url, {\n method: req.method ?? 'GET',\n headers,\n body: req.body as RequestInit['body'],\n signal,\n });\n } catch (err) {\n cancel();\n if (req.signal?.aborted) {\n throw req.signal.reason ?? err;\n }\n const error = err instanceof Error ? err : new Error(String(err));\n lastErr = error;\n if (attempt < maxAttempts - 1 && retryOn(null, error)) {\n const delay = computeDelay(attempt, initialDelayMs, maxDelayMs);\n await sleep(delay, req.signal);\n continue;\n }\n throw new TransientError(error.message);\n }\n cancel();\n\n const body = await readBody(res, parseJson);\n const httpResponse: HttpResponse<T> = {\n status: res.status,\n headers: res.headers,\n body: body as T,\n };\n if (req.rateLimit) {\n const state = req.rateLimit.parse(res.headers);\n if (state) {\n httpResponse.rateLimitState = state;\n }\n }\n\n if (options.observer) {\n await notifyObserver(options.observer, {\n url: req.url,\n method: req.method ?? 'GET',\n status: res.status,\n resource: options.resource,\n requestId: options.requestId ?? newRequestId(),\n body,\n });\n }\n\n if (res.ok) {\n return httpResponse;\n }\n\n const retryAfter = parseRetryAfter(res.headers.get('retry-after'));\n const message = `HTTP ${res.status} ${res.statusText} for ${req.method ?? 'GET'} ${req.url}`;\n const err = errorForStatus(message, httpResponse, retryAfter);\n\n if (\n attempt < maxAttempts - 1 &&\n retryOn(res.status, err) &&\n !(err instanceof AuthError) &&\n !(err instanceof ClientBugError)\n ) {\n lastErr = err;\n let delay = computeDelay(attempt, initialDelayMs, maxDelayMs);\n if (err instanceof RateLimitError && retryAfter) {\n const wait = retryAfter.getTime() - Date.now();\n if (wait > 0) {\n delay = Math.min(wait, maxDelayMs);\n }\n }\n await sleep(delay, req.signal);\n continue;\n }\n\n throw err;\n }\n\n throw lastErr ?? new UpstreamBugError('Exhausted retry attempts');\n}\n\nfunction computeDelay(\n attempt: number,\n initialDelayMs: number,\n maxDelayMs: number,\n): number {\n const base = initialDelayMs * 2 ** attempt;\n const jitter = base * 0.25 * Math.random();\n return Math.min(base + jitter, maxDelayMs);\n}\n\nexport { HttpClientError };\n","export interface RateLimitState {\n remaining: number;\n resetAt: Date;\n}\n\nexport interface RateLimitPolicy {\n parse(headers: Headers): RateLimitState | null;\n}\n\nexport interface StandardRateLimitPolicyConfig {\n remainingHeader: string;\n resetHeader: string;\n resetUnit: 's' | 'ms';\n resetFallbackMs?: number;\n}\n\nexport function standardRateLimitPolicy(\n config: StandardRateLimitPolicyConfig,\n): RateLimitPolicy {\n const { remainingHeader, resetHeader, resetUnit, resetFallbackMs } = config;\n const multiplier = resetUnit === 's' ? 1000 : 1;\n return {\n parse(h) {\n const remainingRaw = h.get(remainingHeader);\n if (remainingRaw === null || remainingRaw.trim() === '') {\n return null;\n }\n const remaining = Number(remainingRaw);\n if (!Number.isFinite(remaining)) {\n return null;\n }\n const resetRaw = h.get(resetHeader);\n if (resetRaw === null) {\n if (resetFallbackMs === undefined) {\n return null;\n }\n return {\n remaining,\n resetAt: new Date(Date.now() + resetFallbackMs),\n };\n }\n if (resetRaw.trim() === '') {\n return null;\n }\n const reset = Number(resetRaw);\n if (!Number.isFinite(reset) || reset < 0) {\n return null;\n }\n const resetMs = reset * multiplier;\n if (!Number.isFinite(resetMs)) {\n return null;\n }\n return { remaining, resetAt: new Date(resetMs) };\n },\n };\n}\n","export interface SanitizeAllowedUrlOptions {\n url: string | null;\n host: string;\n pathname: string;\n protocol?: 'https:' | 'http:';\n}\n\nexport function sanitizeAllowedUrl(\n options: SanitizeAllowedUrlOptions,\n): string | null {\n const { url, host, pathname, protocol = 'https:' } = options;\n if (url === null) {\n return null;\n }\n try {\n const u = new URL(url);\n if (u.protocol !== protocol || u.host !== host || u.pathname !== pathname) {\n return null;\n }\n return u.toString();\n } catch {\n return null;\n }\n}\n","export type EpochUnit = 'ms' | 's' | 'iso';\n\nexport function parseEpoch(\n value: number | string | null | undefined,\n unit: EpochUnit,\n): number | null {\n if (value === null || value === undefined) {\n return null;\n }\n if (unit === 'iso') {\n if (typeof value !== 'string') {\n return null;\n }\n const ms = new Date(value).getTime();\n return Number.isFinite(ms) ? ms : null;\n }\n if (typeof value === 'string' && value.trim() === '') {\n return null;\n }\n const n = typeof value === 'number' ? value : Number(value);\n if (!Number.isFinite(n)) {\n return null;\n }\n const result = unit === 's' ? n * 1000 : n;\n return Number.isFinite(result) ? result : null;\n}\n","import { request } from './request';\nimport type { HttpRequest } from './types';\n\nexport function parseLinkHeader(header: string | null): Record<string, string> {\n if (!header) {\n return {};\n }\n const result: Record<string, string> = {};\n for (const part of header.split(',')) {\n const match = part.match(/<([^>]+)>\\s*;\\s*rel=\"([^\"]+)\"/);\n if (match) {\n result[match[2]!] = match[1]!;\n }\n }\n return result;\n}\n\nexport async function* paginateLink<T>(\n initial: HttpRequest,\n parse: (body: unknown) => T[],\n options: { resource: string },\n): AsyncIterable<T> {\n let next: string | null = initial.url;\n while (next) {\n const res: Awaited<ReturnType<typeof request>> = await request(\n {\n ...initial,\n url: next,\n },\n { resource: options.resource },\n );\n for (const item of parse(res.body)) {\n yield item;\n }\n const links = parseLinkHeader(res.headers.get('link'));\n next = links['next'] ?? null;\n }\n}\n\nexport async function* paginateCursor<T>(\n initial: HttpRequest,\n parse: (body: unknown) => { items: T[]; nextCursor: string | null },\n buildNext: (req: HttpRequest, cursor: string) => HttpRequest,\n options: { resource: string },\n): AsyncIterable<T> {\n let req: HttpRequest = initial;\n while (true) {\n const res = await request(req, { resource: options.resource });\n const { items, nextCursor } = parse(res.body);\n for (const item of items) {\n yield item;\n }\n if (!nextCursor) {\n return;\n }\n req = buildNext(req, nextCursor);\n }\n}\n\nexport async function* paginatePage<T>(\n initial: HttpRequest,\n parse: (body: unknown) => { items: T[]; hasMore: boolean },\n buildPage: (req: HttpRequest, page: number) => HttpRequest,\n options: { resource: string },\n): AsyncIterable<T> {\n let page = 1;\n while (true) {\n const req = page === 1 ? initial : buildPage(initial, page);\n const res = await request(req, { resource: options.resource });\n const { items, hasMore } = parse(res.body);\n for (const item of items) {\n yield item;\n }\n if (!hasMore || items.length === 0) {\n return;\n }\n page++;\n }\n}\n","export type LogFields = Record<string, unknown>;\n\nexport interface ConnectorLogger {\n info(event: string, fields?: LogFields): void;\n warn(event: string, fields?: LogFields): void;\n}\n\nexport interface ConnectorLoggerOptions {\n scope: string;\n}\n\nconst MAX_VALUE_LEN = 120;\n\nfunction truncate(s: string, max = MAX_VALUE_LEN): string {\n if (s.length <= max) {\n return s;\n }\n return `${s.slice(0, max - 1)}…`;\n}\n\nfunction formatValue(value: unknown): string {\n if (value === null) {\n return 'null';\n }\n if (value === undefined) {\n return '';\n }\n if (typeof value === 'number' || typeof value === 'boolean') {\n return String(value);\n }\n if (typeof value === 'string') {\n const t = truncate(value);\n if (/[\\s\"=]/.test(t)) {\n return JSON.stringify(t);\n }\n return t;\n }\n if (typeof value === 'bigint') {\n return value.toString();\n }\n let json: string | undefined;\n try {\n json = JSON.stringify(value);\n } catch {\n json = undefined;\n }\n return truncate(json ?? String(value));\n}\n\nexport function formatLogFields(fields?: LogFields): string {\n if (!fields) {\n return '';\n }\n const parts: string[] = [];\n for (const [k, v] of Object.entries(fields)) {\n if (v === undefined) {\n continue;\n }\n parts.push(`${k}=${formatValue(v)}`);\n }\n return parts.length > 0 ? ` ${parts.join(' ')}` : '';\n}\n\nexport function formatLogLine(\n scope: string,\n event: string,\n fields?: LogFields,\n): string {\n return `[${scope}] ${event}${formatLogFields(fields)}`;\n}\n\nexport function createDefaultConnectorLogger(\n opts: ConnectorLoggerOptions,\n): ConnectorLogger {\n return {\n info(event, fields) {\n console.info(formatLogLine(opts.scope, event, fields));\n },\n warn(event, fields) {\n console.warn(formatLogLine(opts.scope, event, fields));\n },\n };\n}\n\nconst NOOP_LOGGER: ConnectorLogger = {\n info() {},\n warn() {},\n};\n\nexport function noopConnectorLogger(): ConnectorLogger {\n return NOOP_LOGGER;\n}\n","import {\n type HttpResponse,\n connectorUserAgent,\n standardRateLimitPolicy,\n} from '@rawdash/connector-shared';\nimport {\n BaseConnector,\n type ConnectorContext,\n type ConnectorDoc,\n type CredentialsSchema,\n type StorageHandle,\n type SyncOptions,\n type SyncResult,\n defineConfigFields,\n defineConnectorDoc,\n defineResources,\n makeChunkedCursorGuard,\n paginateChunked,\n schemasFromResources,\n selectActivePhases,\n} from '@rawdash/core';\nimport { z } from 'zod';\n\nexport const configFields = defineConfigFields(\n z.object({\n apiKey: z.object({ $secret: z.string() }).meta({\n label: 'API Key',\n description:\n 'Linear Personal API Key. Create one at Linear → Settings → API → Personal API keys.',\n placeholder: 'lin_api_...',\n secret: true,\n }),\n teamIds: z.array(z.string().min(1)).nonempty().optional().meta({\n label: 'Team IDs (optional)',\n description:\n 'Restrict the sync to specific Linear team IDs. Omit to sync all teams the API key can see.',\n }),\n resources: z\n .array(z.enum(['teams', 'users', 'cycles', 'issues']))\n .nonempty()\n .optional()\n .meta({\n label: 'Resources',\n description:\n \"Which Linear resources to sync. Omit to sync all resources. The `issues` phase also emits state-transition events derived from each issue's history.\",\n }),\n historyPerIssue: z.number().int().positive().max(50).optional().meta({\n label: 'History entries per issue',\n description:\n 'How many history entries to pull per issue (newest first). State transitions inside this window become events. Defaults to 25.',\n placeholder: '25',\n }),\n }),\n);\n\nexport const doc: ConnectorDoc = defineConnectorDoc({\n displayName: 'Linear',\n category: 'product',\n brandColor: '#5E6AD2',\n tagline:\n 'Sync teams, members, cycles, issues, and issue state-transition events from a Linear workspace.',\n vendor: {\n name: 'Linear',\n apiDocs: 'https://developers.linear.app/docs',\n website: 'https://linear.app',\n },\n auth: {\n summary:\n 'A Linear Personal API Key is required. It authenticates all GraphQL requests and scopes the sync to the workspaces and teams the key can access.',\n setup: [\n 'Open Linear → Settings → API → Personal API keys.',\n 'Create a new personal API key.',\n 'Store it as a secret and reference it from the connector config as `apiKey: secret(\"LINEAR_API_KEY\")`.',\n ],\n },\n rateLimit:\n 'Linear returns X-RateLimit-Requests-Remaining / X-RateLimit-Requests-Reset headers (reset in ms); requests are paged 50 at a time.',\n limitations: [\n 'API key auth only (OAuth not yet supported).',\n 'Webhooks and roadmap/initiative resources are out of scope.',\n ],\n});\n\nexport interface LinearSettings {\n teamIds?: readonly string[];\n resources?: readonly LinearResource[];\n historyPerIssue?: number;\n}\n\nconst linearCredentials = {\n apiKey: {\n description: 'Linear Personal API Key',\n auth: 'required' as const,\n },\n} satisfies CredentialsSchema;\n\ntype LinearCredentials = typeof linearCredentials;\n\nconst linearRateLimit = standardRateLimitPolicy({\n remainingHeader: 'x-ratelimit-requests-remaining',\n resetHeader: 'x-ratelimit-requests-reset',\n resetUnit: 'ms',\n resetFallbackMs: 60_000,\n});\n\nconst PHASE_ORDER = ['teams', 'users', 'cycles', 'issues'] as const;\n\ntype LinearPhase = (typeof PHASE_ORDER)[number];\n\nexport type LinearResource = LinearPhase;\n\nconst isLinearSyncCursor = makeChunkedCursorGuard(PHASE_ORDER);\n\n// ---------------------------------------------------------------------------\n// Linear GraphQL types\n// ---------------------------------------------------------------------------\n\ninterface PageInfo {\n hasNextPage: boolean;\n endCursor: string | null;\n}\n\ninterface Connection<T> {\n nodes: T[];\n pageInfo: PageInfo;\n}\n\ninterface LinearTeam {\n id: string;\n name: string;\n key: string;\n createdAt: string;\n updatedAt: string;\n}\n\ninterface LinearUser {\n id: string;\n name: string;\n email: string | null;\n displayName: string;\n active: boolean;\n createdAt: string;\n updatedAt: string;\n}\n\ninterface LinearCycle {\n id: string;\n number: number;\n name: string | null;\n startsAt: string;\n endsAt: string;\n completedAt: string | null;\n progress: number | null;\n scopeHistory: number[] | null;\n completedScopeHistory: number[] | null;\n team: { id: string } | null;\n createdAt: string;\n updatedAt: string;\n}\n\ninterface LinearIssueHistory {\n id: string;\n createdAt: string;\n actor: { id: string } | null;\n fromState: { id: string; name: string } | null;\n toState: { id: string; name: string } | null;\n fromAssignee: { id: string } | null;\n toAssignee: { id: string } | null;\n}\n\ninterface LinearIssue {\n id: string;\n identifier: string;\n title: string;\n priority: number;\n estimate: number | null;\n state: { id: string; name: string; type: string } | null;\n assignee: { id: string } | null;\n team: { id: string } | null;\n project: { id: string } | null;\n cycle: { id: string } | null;\n labels: { nodes: Array<{ id: string; name: string }> };\n createdAt: string;\n updatedAt: string;\n completedAt: string | null;\n canceledAt: string | null;\n startedAt: string | null;\n history: Connection<LinearIssueHistory>;\n}\n\ninterface GraphQLError {\n message: string;\n extensions?: { code?: string; type?: string };\n}\n\ninterface GraphQLResponse<T> {\n data?: T;\n errors?: GraphQLError[];\n}\n\n// ---------------------------------------------------------------------------\n// GraphQL documents\n// ---------------------------------------------------------------------------\n\nconst TEAMS_QUERY = `\n query Teams($after: String, $first: Int!, $filter: TeamFilter) {\n teams(after: $after, first: $first, filter: $filter, orderBy: updatedAt) {\n nodes { id name key createdAt updatedAt }\n pageInfo { hasNextPage endCursor }\n }\n }\n`;\n\nconst USERS_QUERY = `\n query Users($after: String, $first: Int!, $filter: UserFilter) {\n users(after: $after, first: $first, filter: $filter, orderBy: updatedAt) {\n nodes { id name email displayName active createdAt updatedAt }\n pageInfo { hasNextPage endCursor }\n }\n }\n`;\n\nconst CYCLES_QUERY = `\n query Cycles($after: String, $first: Int!, $filter: CycleFilter) {\n cycles(after: $after, first: $first, filter: $filter, orderBy: updatedAt) {\n nodes {\n id number name startsAt endsAt completedAt progress\n scopeHistory completedScopeHistory\n team { id }\n createdAt updatedAt\n }\n pageInfo { hasNextPage endCursor }\n }\n }\n`;\n\nconst ISSUES_QUERY = `\n query Issues(\n $after: String\n $first: Int!\n $filter: IssueFilter\n $historyFirst: Int!\n ) {\n issues(after: $after, first: $first, filter: $filter, orderBy: updatedAt) {\n nodes {\n id identifier title priority estimate\n state { id name type }\n assignee { id }\n team { id }\n project { id }\n cycle { id }\n labels { nodes { id name } }\n createdAt updatedAt completedAt canceledAt startedAt\n history(first: $historyFirst) {\n nodes {\n id createdAt\n actor { id }\n fromState { id name }\n toState { id name }\n fromAssignee { id }\n toAssignee { id }\n }\n pageInfo { hasNextPage endCursor }\n }\n }\n pageInfo { hasNextPage endCursor }\n }\n }\n`;\n\n// ---------------------------------------------------------------------------\n// LinearConnector\n// ---------------------------------------------------------------------------\n\nconst PAGE_SIZE = 50;\nconst DEFAULT_HISTORY_PER_ISSUE = 25;\nconst ENDPOINT = 'https://api.linear.app/graphql';\n\n// ---------------------------------------------------------------------------\n// Schemas — describe the per-resource GraphQL node shape consumed by request()\n// ---------------------------------------------------------------------------\n\nconst idString = z.string().min(1);\n\nconst teamSchema = z.object({\n id: idString,\n name: z.string(),\n key: z.string(),\n createdAt: z.iso.datetime(),\n updatedAt: z.iso.datetime(),\n});\n\nconst userSchema = z.object({\n id: idString,\n name: z.string(),\n email: z.string().nullable(),\n displayName: z.string(),\n active: z.boolean(),\n createdAt: z.iso.datetime(),\n updatedAt: z.iso.datetime(),\n});\n\nconst cycleSchema = z.object({\n id: idString,\n number: z.number().int(),\n name: z.string().nullable(),\n startsAt: z.iso.datetime(),\n endsAt: z.iso.datetime(),\n completedAt: z.iso.datetime().nullable(),\n progress: z.number().nullable(),\n scopeHistory: z.array(z.number()).nullable(),\n completedScopeHistory: z.array(z.number()).nullable(),\n team: z.object({ id: idString }).nullable(),\n createdAt: z.iso.datetime(),\n updatedAt: z.iso.datetime(),\n});\n\nconst issueSchema = z.object({\n id: idString,\n identifier: z.string(),\n title: z.string(),\n priority: z.number().int(),\n estimate: z.number().nullable(),\n state: z\n .object({ id: idString, name: z.string(), type: z.string() })\n .nullable(),\n assignee: z.object({ id: idString }).nullable(),\n team: z.object({ id: idString }).nullable(),\n project: z.object({ id: idString }).nullable(),\n cycle: z.object({ id: idString }).nullable(),\n labels: z.object({\n nodes: z.array(z.object({ id: idString, name: z.string() })),\n }),\n createdAt: z.iso.datetime(),\n updatedAt: z.iso.datetime(),\n completedAt: z.iso.datetime().nullable(),\n canceledAt: z.iso.datetime().nullable(),\n startedAt: z.iso.datetime().nullable(),\n history: z.object({\n nodes: z.array(\n z.object({\n id: idString,\n createdAt: z.iso.datetime(),\n actor: z.object({ id: idString }).nullable(),\n fromState: z.object({ id: idString, name: z.string() }).nullable(),\n toState: z.object({ id: idString, name: z.string() }).nullable(),\n fromAssignee: z.object({ id: idString }).nullable(),\n toAssignee: z.object({ id: idString }).nullable(),\n }),\n ),\n pageInfo: z.object({\n hasNextPage: z.boolean(),\n endCursor: z.string().nullable(),\n }),\n }),\n});\n\nconst linearResources = defineResources({\n linear_team: {\n shape: 'entity',\n description: 'Workspace teams with their name and key.',\n endpoint: 'GraphQL query: teams { nodes { ... } }',\n responses: { teams: z.array(teamSchema) },\n },\n linear_user: {\n shape: 'entity',\n description:\n 'Workspace members, including name, email, display name, and active state.',\n endpoint: 'GraphQL query: users { nodes { ... } }',\n responses: { users: z.array(userSchema) },\n },\n linear_cycle: {\n shape: 'entity',\n description:\n 'Team cycles with their number, dates, progress, and final scope / completed-scope figures.',\n endpoint: 'GraphQL query: cycles { nodes { ... } }',\n responses: { cycles: z.array(cycleSchema) },\n },\n linear_issue: {\n shape: 'entity',\n description:\n 'Issues with their state, priority, assignee, team, project, cycle, labels, estimate, and lifecycle timestamps.',\n endpoint: 'GraphQL query: issues { nodes { ... } }',\n responses: { issues: z.array(issueSchema) },\n },\n linear_issue_state_change: {\n shape: 'event',\n description:\n 'State-transition events derived from each issue’s history (from-state to to-state), keyed by the originating actor.',\n endpoint: 'GraphQL query: issues { nodes { history { nodes { ... } } } }',\n notes:\n 'Only history entries with a non-null fromState and toState (where they differ) become events; these append-only events accumulate across incremental syncs.',\n },\n});\n\nexport class LinearConnector extends BaseConnector<\n LinearSettings,\n LinearCredentials\n> {\n static readonly id = 'linear';\n\n static readonly resources = linearResources;\n\n static readonly schemas = schemasFromResources(linearResources);\n\n static create(input: unknown, ctx?: ConnectorContext): LinearConnector {\n const parsed = configFields.parse(input);\n return new LinearConnector(\n {\n teamIds: parsed.teamIds,\n resources: parsed.resources,\n historyPerIssue: parsed.historyPerIssue,\n },\n { apiKey: parsed.apiKey },\n ctx,\n );\n }\n\n readonly id = 'linear';\n override readonly credentials = linearCredentials;\n\n private buildHeaders(): Record<string, string> {\n return {\n Authorization: this.creds.apiKey,\n 'Content-Type': 'application/json',\n 'User-Agent': connectorUserAgent('linear'),\n };\n }\n\n private async graphql<T>(\n query: string,\n variables: Record<string, unknown>,\n resource: string,\n signal?: AbortSignal,\n ): Promise<HttpResponse<GraphQLResponse<T>>> {\n const res = await this.post<GraphQLResponse<T>>(ENDPOINT, {\n resource,\n headers: this.buildHeaders(),\n body: JSON.stringify({ query, variables }),\n signal,\n rateLimit: linearRateLimit,\n });\n if (res.body.errors && res.body.errors.length > 0) {\n const messages = res.body.errors.map((e) => e.message).join('; ');\n throw new Error(`Linear GraphQL error: ${messages}`);\n }\n if (!res.body.data) {\n throw new Error(\n `Linear GraphQL response missing data for resource '${resource}'`,\n );\n }\n return res;\n }\n\n private sinceFilter(\n options: SyncOptions,\n ): Record<string, unknown> | undefined {\n if (!options.since) {\n return undefined;\n }\n if (options.mode === 'latest') {\n return { updatedAt: { gt: options.since } };\n }\n return undefined;\n }\n\n private issueSinceFilter(\n options: SyncOptions,\n ): Record<string, unknown> | undefined {\n if (!options.since) {\n return undefined;\n }\n return { updatedAt: { gt: options.since } };\n }\n\n private teamFilter(): Record<string, unknown> | undefined {\n const ids = this.settings.teamIds;\n if (!ids || ids.length === 0) {\n return undefined;\n }\n return { id: { in: [...ids] } };\n }\n\n private issueTeamFilter(): Record<string, unknown> | undefined {\n const ids = this.settings.teamIds;\n if (!ids || ids.length === 0) {\n return undefined;\n }\n return { team: { id: { in: [...ids] } } };\n }\n\n private mergeFilters(\n ...filters: Array<Record<string, unknown> | undefined>\n ): Record<string, unknown> | undefined {\n const merged: Record<string, unknown> = {};\n let any = false;\n for (const f of filters) {\n if (f) {\n Object.assign(merged, f);\n any = true;\n }\n }\n return any ? merged : undefined;\n }\n\n // ---------------------------------------------------------------------------\n // Fetchers\n // ---------------------------------------------------------------------------\n\n private async fetchTeamsPage(\n page: string | null,\n options: SyncOptions,\n signal?: AbortSignal,\n ): Promise<{ items: LinearTeam[]; next: string | null }> {\n const filter = this.mergeFilters(\n this.teamFilter(),\n this.sinceFilter(options),\n );\n const res = await this.graphql<{ teams: Connection<LinearTeam> }>(\n TEAMS_QUERY,\n { after: page ?? null, first: PAGE_SIZE, filter },\n 'teams',\n signal,\n );\n const conn = res.body.data!.teams;\n return {\n items: conn.nodes,\n next: conn.pageInfo.hasNextPage ? conn.pageInfo.endCursor : null,\n };\n }\n\n private async fetchUsersPage(\n page: string | null,\n options: SyncOptions,\n signal?: AbortSignal,\n ): Promise<{ items: LinearUser[]; next: string | null }> {\n const res = await this.graphql<{ users: Connection<LinearUser> }>(\n USERS_QUERY,\n {\n after: page ?? null,\n first: PAGE_SIZE,\n filter: this.sinceFilter(options),\n },\n 'users',\n signal,\n );\n const conn = res.body.data!.users;\n return {\n items: conn.nodes,\n next: conn.pageInfo.hasNextPage ? conn.pageInfo.endCursor : null,\n };\n }\n\n private async fetchCyclesPage(\n page: string | null,\n options: SyncOptions,\n signal?: AbortSignal,\n ): Promise<{ items: LinearCycle[]; next: string | null }> {\n const teamIds = this.settings.teamIds;\n const teamFilter =\n teamIds && teamIds.length > 0\n ? { team: { id: { in: [...teamIds] } } }\n : undefined;\n const filter = this.mergeFilters(teamFilter, this.sinceFilter(options));\n const res = await this.graphql<{ cycles: Connection<LinearCycle> }>(\n CYCLES_QUERY,\n { after: page ?? null, first: PAGE_SIZE, filter },\n 'cycles',\n signal,\n );\n const conn = res.body.data!.cycles;\n return {\n items: conn.nodes,\n next: conn.pageInfo.hasNextPage ? conn.pageInfo.endCursor : null,\n };\n }\n\n private async fetchIssuesPage(\n page: string | null,\n options: SyncOptions,\n signal?: AbortSignal,\n ): Promise<{ items: LinearIssue[]; next: string | null }> {\n const filter = this.mergeFilters(\n this.issueTeamFilter(),\n this.issueSinceFilter(options),\n );\n const historyFirst =\n this.settings.historyPerIssue ?? DEFAULT_HISTORY_PER_ISSUE;\n const res = await this.graphql<{ issues: Connection<LinearIssue> }>(\n ISSUES_QUERY,\n { after: page ?? null, first: PAGE_SIZE, filter, historyFirst },\n 'issues',\n signal,\n );\n const conn = res.body.data!.issues;\n return {\n items: conn.nodes,\n next: conn.pageInfo.hasNextPage ? conn.pageInfo.endCursor : null,\n };\n }\n\n // ---------------------------------------------------------------------------\n // Writers\n // ---------------------------------------------------------------------------\n\n private async writeTeams(\n storage: StorageHandle,\n teams: LinearTeam[],\n ): Promise<void> {\n for (const t of teams) {\n await storage.entity({\n type: 'linear_team',\n id: t.id,\n attributes: {\n name: t.name,\n key: t.key,\n createdAt: new Date(t.createdAt).getTime(),\n },\n updated_at: new Date(t.updatedAt).getTime(),\n });\n }\n }\n\n private async writeUsers(\n storage: StorageHandle,\n users: LinearUser[],\n ): Promise<void> {\n for (const u of users) {\n await storage.entity({\n type: 'linear_user',\n id: u.id,\n attributes: {\n name: u.name,\n email: u.email,\n displayName: u.displayName,\n active: u.active,\n createdAt: new Date(u.createdAt).getTime(),\n },\n updated_at: new Date(u.updatedAt).getTime(),\n });\n }\n }\n\n private async writeCycles(\n storage: StorageHandle,\n cycles: LinearCycle[],\n ): Promise<void> {\n for (const c of cycles) {\n const startsMs = new Date(c.startsAt).getTime();\n const endsMs = new Date(c.endsAt).getTime();\n const scopeFinal =\n c.scopeHistory && c.scopeHistory.length > 0\n ? (c.scopeHistory.at(-1) ?? null)\n : null;\n const completedFinal =\n c.completedScopeHistory && c.completedScopeHistory.length > 0\n ? (c.completedScopeHistory.at(-1) ?? null)\n : null;\n await storage.entity({\n type: 'linear_cycle',\n id: c.id,\n attributes: {\n number: c.number,\n name: c.name,\n teamId: c.team?.id ?? null,\n startsAt: startsMs,\n endsAt: endsMs,\n completedAt: c.completedAt ? new Date(c.completedAt).getTime() : null,\n progress: c.progress,\n scope: scopeFinal,\n completedScope: completedFinal,\n },\n updated_at: new Date(c.updatedAt).getTime(),\n });\n }\n }\n\n private async writeIssues(\n storage: StorageHandle,\n issues: LinearIssue[],\n historySinceMs: number | null,\n ): Promise<void> {\n for (const i of issues) {\n await storage.entity({\n type: 'linear_issue',\n id: i.id,\n attributes: {\n identifier: i.identifier,\n title: i.title,\n stateId: i.state?.id ?? null,\n stateName: i.state?.name ?? null,\n stateType: i.state?.type ?? null,\n priority: i.priority,\n assigneeId: i.assignee?.id ?? null,\n teamId: i.team?.id ?? null,\n projectId: i.project?.id ?? null,\n cycleId: i.cycle?.id ?? null,\n labels: i.labels.nodes.map((l) => l.name),\n estimate: i.estimate,\n createdAt: new Date(i.createdAt).getTime(),\n completedAt: i.completedAt ? new Date(i.completedAt).getTime() : null,\n canceledAt: i.canceledAt ? new Date(i.canceledAt).getTime() : null,\n startedAt: i.startedAt ? new Date(i.startedAt).getTime() : null,\n },\n updated_at: new Date(i.updatedAt).getTime(),\n });\n\n for (const h of i.history.nodes) {\n if (!h.toState || !h.fromState) {\n continue;\n }\n if (h.toState.id === h.fromState.id) {\n continue;\n }\n const eventTs = new Date(h.createdAt).getTime();\n if (historySinceMs !== null && eventTs <= historySinceMs) {\n continue;\n }\n await storage.event({\n name: 'linear_issue_state_change',\n start_ts: eventTs,\n end_ts: null,\n attributes: {\n historyId: h.id,\n issueId: i.id,\n issueIdentifier: i.identifier,\n teamId: i.team?.id ?? null,\n actorId: h.actor?.id ?? null,\n fromStateId: h.fromState.id,\n fromStateName: h.fromState.name,\n toStateId: h.toState.id,\n toStateName: h.toState.name,\n },\n });\n }\n }\n }\n\n // ---------------------------------------------------------------------------\n // sync\n // ---------------------------------------------------------------------------\n\n async sync(\n options: SyncOptions,\n storage: StorageHandle,\n signal?: AbortSignal,\n ): Promise<SyncResult> {\n const cursor = isLinearSyncCursor(options.cursor)\n ? options.cursor\n : undefined;\n const isFull = options.mode === 'full';\n const historySinceMs = options.since\n ? new Date(options.since).getTime()\n : null;\n\n const phases = selectActivePhases<LinearResource, LinearPhase>(\n (r) => r,\n PHASE_ORDER,\n this.settings.resources,\n );\n\n return paginateChunked<LinearPhase, string>({\n phases,\n cursor,\n signal,\n logger: this.logger,\n fetchPage: async (phase, page, sig) => {\n switch (phase) {\n case 'teams':\n return this.fetchTeamsPage(page, options, sig);\n case 'users':\n return this.fetchUsersPage(page, options, sig);\n case 'cycles':\n return this.fetchCyclesPage(page, options, sig);\n case 'issues':\n return this.fetchIssuesPage(page, options, sig);\n }\n },\n writeBatch: async (phase, items, page) => {\n if (isFull && page === null) {\n switch (phase) {\n case 'teams':\n await storage.entities([], { types: ['linear_team'] });\n break;\n case 'users':\n await storage.entities([], { types: ['linear_user'] });\n break;\n case 'cycles':\n await storage.entities([], { types: ['linear_cycle'] });\n break;\n case 'issues':\n await storage.entities([], { types: ['linear_issue'] });\n await storage.events([], {\n names: ['linear_issue_state_change'],\n });\n break;\n }\n }\n switch (phase) {\n case 'teams':\n return this.writeTeams(storage, items as LinearTeam[]);\n case 'users':\n return this.writeUsers(storage, items as LinearUser[]);\n case 'cycles':\n return this.writeCycles(storage, items as LinearCycle[]);\n case 'issues':\n return this.writeIssues(\n storage,\n items as LinearIssue[],\n historySinceMs,\n );\n }\n },\n });\n }\n}\n","import { LinearConnector } from './linear';\n\nexport { configFields, doc, LinearConnector } from './linear';\nexport type { LinearSettings, LinearResource } from './linear';\nexport default LinearConnector;\n"],"mappings":"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","names":[]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rawdash/connector-linear",
3
- "version": "0.14.0",
3
+ "version": "0.16.0",
4
4
  "description": "Rawdash connector for Linear — issues, cycles, teams, and users",
5
5
  "license": "Apache-2.0",
6
6
  "type": "module",
@@ -23,15 +23,15 @@
23
23
  },
24
24
  "dependencies": {
25
25
  "zod": "^4.4.3",
26
- "@rawdash/core": "0.14.0"
26
+ "@rawdash/core": "0.16.0"
27
27
  },
28
28
  "devDependencies": {
29
29
  "fast-check": "^4.8.0",
30
30
  "tsup": "^8.0.0",
31
31
  "typescript": "^5.7.2",
32
32
  "vitest": "^4.1.4",
33
- "@rawdash/connector-shared": "0.2.0",
34
- "@rawdash/connector-test-utils": "0.0.1"
33
+ "@rawdash/connector-shared": "0.3.0",
34
+ "@rawdash/connector-test-utils": "0.0.3"
35
35
  },
36
36
  "scripts": {
37
37
  "build": "tsup",