@rawdash/connector-linear 0.15.0 → 0.17.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 +58 -120
- package/dist/index.d.ts +272 -6
- package/dist/index.js +133 -51
- package/dist/index.js.map +1 -1
- package/package.json +5 -4
package/README.md
CHANGED
|
@@ -1,99 +1,81 @@
|
|
|
1
|
+
<!-- This file is generated from connector metadata by scripts/generate-connector-docs.ts. Do not edit by hand. -->
|
|
2
|
+
|
|
1
3
|
# @rawdash/connector-linear
|
|
2
4
|
|
|
3
|
-
|
|
5
|
+
[](https://www.npmjs.com/package/@rawdash/connector-linear)
|
|
6
|
+
[](https://github.com/rawdash/rawdash/blob/main/LICENSE)
|
|
7
|
+
|
|
8
|
+
Sync teams, members, cycles, issues, and issue state-transition events from a Linear workspace.
|
|
4
9
|
|
|
5
|
-
##
|
|
10
|
+
## Install
|
|
6
11
|
|
|
7
|
-
|
|
12
|
+
```sh
|
|
13
|
+
npm install @rawdash/connector-linear
|
|
14
|
+
```
|
|
8
15
|
|
|
9
|
-
|
|
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.
|
|
16
|
+
## Authentication
|
|
12
17
|
|
|
13
|
-
Personal API
|
|
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.
|
|
14
19
|
|
|
15
|
-
|
|
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")`.
|
|
16
23
|
|
|
17
24
|
## Configuration
|
|
18
25
|
|
|
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
|
|
48
|
+
|
|
19
49
|
```ts
|
|
20
|
-
import {
|
|
50
|
+
import {
|
|
51
|
+
defineConfig,
|
|
52
|
+
defineDashboard,
|
|
53
|
+
defineMetric,
|
|
54
|
+
secret,
|
|
55
|
+
} from '@rawdash/core';
|
|
21
56
|
|
|
22
57
|
const linear = {
|
|
23
58
|
name: 'linear',
|
|
24
59
|
connectorId: 'linear',
|
|
25
60
|
config: {
|
|
26
61
|
apiKey: secret('LINEAR_API_KEY'),
|
|
27
|
-
// teamIds: ['team-uuid'], // optional — restrict to one or more teams
|
|
28
|
-
// resources: ['issues'], // optional — defaults to all four phases
|
|
29
|
-
// historyPerIssue: 25, // optional — how many history entries to fetch per issue
|
|
30
62
|
},
|
|
31
63
|
};
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
Register the connector class when mounting the engine:
|
|
35
|
-
|
|
36
|
-
```ts
|
|
37
|
-
import { LinearConnector } from '@rawdash/connector-linear';
|
|
38
|
-
import { mountEngine } from '@rawdash/hono';
|
|
39
|
-
|
|
40
|
-
mountEngine(config, { connectorRegistry: { linear: LinearConnector } });
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
### Choosing resources
|
|
44
|
-
|
|
45
|
-
The connector exposes four sync phases, run in order:
|
|
46
|
-
|
|
47
|
-
`teams`, `users`, `cycles`, `issues`
|
|
48
|
-
|
|
49
|
-
Pass any non-empty subset as `resources` to sync only those phases. The `issues` phase also emits `linear_issue_state_change` events.
|
|
50
|
-
|
|
51
|
-
### Example dashboard
|
|
52
|
-
|
|
53
|
-
```ts
|
|
54
|
-
import { defineConfig, defineDashboard, defineMetric } from '@rawdash/core';
|
|
55
64
|
|
|
56
65
|
export default defineConfig({
|
|
57
66
|
connectors: [linear],
|
|
58
67
|
dashboards: {
|
|
59
|
-
|
|
68
|
+
product: defineDashboard({
|
|
60
69
|
widgets: {
|
|
61
70
|
open_issues: {
|
|
62
71
|
kind: 'stat',
|
|
63
|
-
title: '
|
|
64
|
-
metric: defineMetric({
|
|
65
|
-
connector: linear,
|
|
66
|
-
shape: 'entity',
|
|
67
|
-
entityType: 'linear_issue',
|
|
68
|
-
fn: 'count',
|
|
69
|
-
filter: [
|
|
70
|
-
{ field: 'stateType', op: 'in', value: ['unstarted', 'started'] },
|
|
71
|
-
],
|
|
72
|
-
}),
|
|
73
|
-
},
|
|
74
|
-
completed_this_week: {
|
|
75
|
-
kind: 'timeseries',
|
|
76
|
-
title: 'Issues completed per day',
|
|
77
|
-
window: '7d',
|
|
78
|
-
metric: defineMetric({
|
|
79
|
-
connector: linear,
|
|
80
|
-
shape: 'event',
|
|
81
|
-
name: 'linear_issue_state_change',
|
|
82
|
-
fn: 'count',
|
|
83
|
-
window: '7d',
|
|
84
|
-
filter: [{ field: 'toStateName', op: 'eq', value: 'Done' }],
|
|
85
|
-
groupBy: { field: 'start_ts', granularity: 'day' },
|
|
86
|
-
}),
|
|
87
|
-
},
|
|
88
|
-
issues_by_priority: {
|
|
89
|
-
kind: 'distribution',
|
|
90
|
-
title: 'Issues by priority',
|
|
72
|
+
title: 'In-progress issues',
|
|
91
73
|
metric: defineMetric({
|
|
92
74
|
connector: linear,
|
|
93
75
|
shape: 'entity',
|
|
94
76
|
entityType: 'linear_issue',
|
|
95
77
|
fn: 'count',
|
|
96
|
-
|
|
78
|
+
filter: [{ field: 'stateType', op: 'eq', value: 'started' }],
|
|
97
79
|
}),
|
|
98
80
|
},
|
|
99
81
|
},
|
|
@@ -102,65 +84,21 @@ export default defineConfig({
|
|
|
102
84
|
});
|
|
103
85
|
```
|
|
104
86
|
|
|
105
|
-
##
|
|
106
|
-
|
|
107
|
-
| Storage shape | Entity/event type | Key attributes |
|
|
108
|
-
| ------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
109
|
-
| entity | `linear_team` | name, key, createdAt |
|
|
110
|
-
| entity | `linear_user` | name, email, displayName, active, createdAt |
|
|
111
|
-
| entity | `linear_cycle` | number, name, teamId, startsAt, endsAt, completedAt, progress, scope, completedScope |
|
|
112
|
-
| entity | `linear_issue` | identifier, title, stateId, stateName, stateType, priority, assigneeId, teamId, projectId, cycleId, labels, estimate, createdAt, completedAt, canceledAt, startedAt |
|
|
113
|
-
| event | `linear_issue_state_change` | historyId, issueId, issueIdentifier, teamId, actorId, fromStateId, fromStateName, toStateId, toStateName |
|
|
87
|
+
## Rate limits
|
|
114
88
|
|
|
115
|
-
|
|
89
|
+
Linear returns X-RateLimit-Requests-Remaining / X-RateLimit-Requests-Reset headers (reset in ms); requests are paged 50 at a time.
|
|
116
90
|
|
|
117
|
-
##
|
|
91
|
+
## Limitations
|
|
118
92
|
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
| Resource | Represents |
|
|
122
|
-
| -------- | ------------------------------------------------------- |
|
|
123
|
-
| `teams` | `teams(...)` connection nodes |
|
|
124
|
-
| `users` | `users(...)` connection nodes |
|
|
125
|
-
| `cycles` | `cycles(...)` connection nodes |
|
|
126
|
-
| `issues` | `issues(...)` connection nodes (incl. nested `history`) |
|
|
127
|
-
|
|
128
|
-
## Sync behaviour
|
|
129
|
-
|
|
130
|
-
- **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.
|
|
131
|
-
- **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.
|
|
132
|
-
- **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.
|
|
133
|
-
- **Resumable**: every phase yields a `(phase, endCursor)` cursor — if the host aborts the sync, the next invocation picks up at the same page.
|
|
134
|
-
|
|
135
|
-
## Out of scope (post-MVP)
|
|
136
|
-
|
|
137
|
-
- Linear OAuth (currently API key only).
|
|
138
|
-
- Webhooks for live updates (Team-tier feature).
|
|
139
|
-
- Roadmap / Initiative resources (open a ticket if you need them).
|
|
140
|
-
|
|
141
|
-
## Registering in the MCP server
|
|
142
|
-
|
|
143
|
-
```ts
|
|
144
|
-
import { LinearConnector, configFields } from '@rawdash/connector-linear';
|
|
145
|
-
|
|
146
|
-
createMcpServer({
|
|
147
|
-
// ...
|
|
148
|
-
connectorFactories: [
|
|
149
|
-
{
|
|
150
|
-
id: 'linear',
|
|
151
|
-
configFields,
|
|
152
|
-
create: LinearConnector.create,
|
|
153
|
-
},
|
|
154
|
-
],
|
|
155
|
-
});
|
|
156
|
-
```
|
|
93
|
+
- API key auth only (OAuth not yet supported).
|
|
94
|
+
- Webhooks and roadmap/initiative resources are out of scope.
|
|
157
95
|
|
|
158
|
-
##
|
|
96
|
+
## Links
|
|
159
97
|
|
|
160
|
-
|
|
98
|
+
- [Rawdash docs](https://rawdash.dev/docs/connectors/)
|
|
99
|
+
- [Linear API docs](https://developers.linear.app/docs)
|
|
100
|
+
- [GitHub](https://github.com/rawdash/rawdash)
|
|
161
101
|
|
|
162
|
-
|
|
163
|
-
2. Pipe them through `connector.sync()` against an `InMemoryStorage` instance.
|
|
164
|
-
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
|
|
165
103
|
|
|
166
|
-
|
|
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[];
|
|
@@ -29,9 +30,270 @@ type LinearCredentials = typeof linearCredentials;
|
|
|
29
30
|
declare const PHASE_ORDER: readonly ["teams", "users", "cycles", "issues"];
|
|
30
31
|
type LinearPhase = (typeof PHASE_ORDER)[number];
|
|
31
32
|
type LinearResource = LinearPhase;
|
|
33
|
+
declare const linearResources: {
|
|
34
|
+
readonly linear_team: {
|
|
35
|
+
readonly shape: "entity";
|
|
36
|
+
readonly description: "Workspace teams with their name and key.";
|
|
37
|
+
readonly endpoint: "GraphQL query: teams { nodes { ... } }";
|
|
38
|
+
readonly responses: {
|
|
39
|
+
readonly teams: z.ZodArray<z.ZodObject<{
|
|
40
|
+
id: z.ZodString;
|
|
41
|
+
name: z.ZodString;
|
|
42
|
+
key: z.ZodString;
|
|
43
|
+
createdAt: z.ZodISODateTime;
|
|
44
|
+
updatedAt: z.ZodISODateTime;
|
|
45
|
+
}, z.core.$strip>>;
|
|
46
|
+
};
|
|
47
|
+
};
|
|
48
|
+
readonly linear_user: {
|
|
49
|
+
readonly shape: "entity";
|
|
50
|
+
readonly description: "Workspace members, including name, email, display name, and active state.";
|
|
51
|
+
readonly endpoint: "GraphQL query: users { nodes { ... } }";
|
|
52
|
+
readonly responses: {
|
|
53
|
+
readonly users: z.ZodArray<z.ZodObject<{
|
|
54
|
+
id: z.ZodString;
|
|
55
|
+
name: z.ZodString;
|
|
56
|
+
email: z.ZodNullable<z.ZodString>;
|
|
57
|
+
displayName: z.ZodString;
|
|
58
|
+
active: z.ZodBoolean;
|
|
59
|
+
createdAt: z.ZodISODateTime;
|
|
60
|
+
updatedAt: z.ZodISODateTime;
|
|
61
|
+
}, z.core.$strip>>;
|
|
62
|
+
};
|
|
63
|
+
};
|
|
64
|
+
readonly linear_cycle: {
|
|
65
|
+
readonly shape: "entity";
|
|
66
|
+
readonly description: "Team cycles with their number, dates, progress, and final scope / completed-scope figures.";
|
|
67
|
+
readonly endpoint: "GraphQL query: cycles { nodes { ... } }";
|
|
68
|
+
readonly responses: {
|
|
69
|
+
readonly cycles: z.ZodArray<z.ZodObject<{
|
|
70
|
+
id: z.ZodString;
|
|
71
|
+
number: z.ZodNumber;
|
|
72
|
+
name: z.ZodNullable<z.ZodString>;
|
|
73
|
+
startsAt: z.ZodISODateTime;
|
|
74
|
+
endsAt: z.ZodISODateTime;
|
|
75
|
+
completedAt: z.ZodNullable<z.ZodISODateTime>;
|
|
76
|
+
progress: z.ZodNullable<z.ZodNumber>;
|
|
77
|
+
scopeHistory: z.ZodNullable<z.ZodArray<z.ZodNumber>>;
|
|
78
|
+
completedScopeHistory: z.ZodNullable<z.ZodArray<z.ZodNumber>>;
|
|
79
|
+
team: z.ZodNullable<z.ZodObject<{
|
|
80
|
+
id: z.ZodString;
|
|
81
|
+
}, z.core.$strip>>;
|
|
82
|
+
createdAt: z.ZodISODateTime;
|
|
83
|
+
updatedAt: z.ZodISODateTime;
|
|
84
|
+
}, z.core.$strip>>;
|
|
85
|
+
};
|
|
86
|
+
};
|
|
87
|
+
readonly linear_issue: {
|
|
88
|
+
readonly shape: "entity";
|
|
89
|
+
readonly description: "Issues with their state, priority, assignee, team, project, cycle, labels, estimate, and lifecycle timestamps.";
|
|
90
|
+
readonly endpoint: "GraphQL query: issues { nodes { ... } }";
|
|
91
|
+
readonly responses: {
|
|
92
|
+
readonly issues: z.ZodArray<z.ZodObject<{
|
|
93
|
+
id: z.ZodString;
|
|
94
|
+
identifier: z.ZodString;
|
|
95
|
+
title: z.ZodString;
|
|
96
|
+
priority: z.ZodNumber;
|
|
97
|
+
estimate: z.ZodNullable<z.ZodNumber>;
|
|
98
|
+
state: z.ZodNullable<z.ZodObject<{
|
|
99
|
+
id: z.ZodString;
|
|
100
|
+
name: z.ZodString;
|
|
101
|
+
type: z.ZodString;
|
|
102
|
+
}, z.core.$strip>>;
|
|
103
|
+
assignee: z.ZodNullable<z.ZodObject<{
|
|
104
|
+
id: z.ZodString;
|
|
105
|
+
}, z.core.$strip>>;
|
|
106
|
+
team: z.ZodNullable<z.ZodObject<{
|
|
107
|
+
id: z.ZodString;
|
|
108
|
+
}, z.core.$strip>>;
|
|
109
|
+
project: z.ZodNullable<z.ZodObject<{
|
|
110
|
+
id: z.ZodString;
|
|
111
|
+
}, z.core.$strip>>;
|
|
112
|
+
cycle: z.ZodNullable<z.ZodObject<{
|
|
113
|
+
id: z.ZodString;
|
|
114
|
+
}, z.core.$strip>>;
|
|
115
|
+
labels: z.ZodObject<{
|
|
116
|
+
nodes: z.ZodArray<z.ZodObject<{
|
|
117
|
+
id: z.ZodString;
|
|
118
|
+
name: z.ZodString;
|
|
119
|
+
}, z.core.$strip>>;
|
|
120
|
+
}, z.core.$strip>;
|
|
121
|
+
createdAt: z.ZodISODateTime;
|
|
122
|
+
updatedAt: z.ZodISODateTime;
|
|
123
|
+
completedAt: z.ZodNullable<z.ZodISODateTime>;
|
|
124
|
+
canceledAt: z.ZodNullable<z.ZodISODateTime>;
|
|
125
|
+
startedAt: z.ZodNullable<z.ZodISODateTime>;
|
|
126
|
+
history: z.ZodObject<{
|
|
127
|
+
nodes: z.ZodArray<z.ZodObject<{
|
|
128
|
+
id: z.ZodString;
|
|
129
|
+
createdAt: z.ZodISODateTime;
|
|
130
|
+
actor: z.ZodNullable<z.ZodObject<{
|
|
131
|
+
id: z.ZodString;
|
|
132
|
+
}, z.core.$strip>>;
|
|
133
|
+
fromState: z.ZodNullable<z.ZodObject<{
|
|
134
|
+
id: z.ZodString;
|
|
135
|
+
name: z.ZodString;
|
|
136
|
+
}, z.core.$strip>>;
|
|
137
|
+
toState: z.ZodNullable<z.ZodObject<{
|
|
138
|
+
id: z.ZodString;
|
|
139
|
+
name: z.ZodString;
|
|
140
|
+
}, z.core.$strip>>;
|
|
141
|
+
fromAssignee: z.ZodNullable<z.ZodObject<{
|
|
142
|
+
id: z.ZodString;
|
|
143
|
+
}, z.core.$strip>>;
|
|
144
|
+
toAssignee: z.ZodNullable<z.ZodObject<{
|
|
145
|
+
id: z.ZodString;
|
|
146
|
+
}, z.core.$strip>>;
|
|
147
|
+
}, z.core.$strip>>;
|
|
148
|
+
pageInfo: z.ZodObject<{
|
|
149
|
+
hasNextPage: z.ZodBoolean;
|
|
150
|
+
endCursor: z.ZodNullable<z.ZodString>;
|
|
151
|
+
}, z.core.$strip>;
|
|
152
|
+
}, z.core.$strip>;
|
|
153
|
+
}, z.core.$strip>>;
|
|
154
|
+
};
|
|
155
|
+
};
|
|
156
|
+
readonly linear_issue_state_change: {
|
|
157
|
+
readonly shape: "event";
|
|
158
|
+
readonly description: "State-transition events derived from each issue’s history (from-state to to-state), keyed by the originating actor.";
|
|
159
|
+
readonly endpoint: "GraphQL query: issues { nodes { history { nodes { ... } } } }";
|
|
160
|
+
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.";
|
|
161
|
+
};
|
|
162
|
+
};
|
|
163
|
+
declare const id = "linear";
|
|
32
164
|
declare class LinearConnector extends BaseConnector<LinearSettings, LinearCredentials> {
|
|
33
165
|
static readonly id = "linear";
|
|
34
|
-
static readonly
|
|
166
|
+
static readonly resources: {
|
|
167
|
+
readonly linear_team: {
|
|
168
|
+
readonly shape: "entity";
|
|
169
|
+
readonly description: "Workspace teams with their name and key.";
|
|
170
|
+
readonly endpoint: "GraphQL query: teams { nodes { ... } }";
|
|
171
|
+
readonly responses: {
|
|
172
|
+
readonly teams: z.ZodArray<z.ZodObject<{
|
|
173
|
+
id: z.ZodString;
|
|
174
|
+
name: z.ZodString;
|
|
175
|
+
key: z.ZodString;
|
|
176
|
+
createdAt: z.ZodISODateTime;
|
|
177
|
+
updatedAt: z.ZodISODateTime;
|
|
178
|
+
}, z.core.$strip>>;
|
|
179
|
+
};
|
|
180
|
+
};
|
|
181
|
+
readonly linear_user: {
|
|
182
|
+
readonly shape: "entity";
|
|
183
|
+
readonly description: "Workspace members, including name, email, display name, and active state.";
|
|
184
|
+
readonly endpoint: "GraphQL query: users { nodes { ... } }";
|
|
185
|
+
readonly responses: {
|
|
186
|
+
readonly users: z.ZodArray<z.ZodObject<{
|
|
187
|
+
id: z.ZodString;
|
|
188
|
+
name: z.ZodString;
|
|
189
|
+
email: z.ZodNullable<z.ZodString>;
|
|
190
|
+
displayName: z.ZodString;
|
|
191
|
+
active: z.ZodBoolean;
|
|
192
|
+
createdAt: z.ZodISODateTime;
|
|
193
|
+
updatedAt: z.ZodISODateTime;
|
|
194
|
+
}, z.core.$strip>>;
|
|
195
|
+
};
|
|
196
|
+
};
|
|
197
|
+
readonly linear_cycle: {
|
|
198
|
+
readonly shape: "entity";
|
|
199
|
+
readonly description: "Team cycles with their number, dates, progress, and final scope / completed-scope figures.";
|
|
200
|
+
readonly endpoint: "GraphQL query: cycles { nodes { ... } }";
|
|
201
|
+
readonly responses: {
|
|
202
|
+
readonly cycles: z.ZodArray<z.ZodObject<{
|
|
203
|
+
id: z.ZodString;
|
|
204
|
+
number: z.ZodNumber;
|
|
205
|
+
name: z.ZodNullable<z.ZodString>;
|
|
206
|
+
startsAt: z.ZodISODateTime;
|
|
207
|
+
endsAt: z.ZodISODateTime;
|
|
208
|
+
completedAt: z.ZodNullable<z.ZodISODateTime>;
|
|
209
|
+
progress: z.ZodNullable<z.ZodNumber>;
|
|
210
|
+
scopeHistory: z.ZodNullable<z.ZodArray<z.ZodNumber>>;
|
|
211
|
+
completedScopeHistory: z.ZodNullable<z.ZodArray<z.ZodNumber>>;
|
|
212
|
+
team: z.ZodNullable<z.ZodObject<{
|
|
213
|
+
id: z.ZodString;
|
|
214
|
+
}, z.core.$strip>>;
|
|
215
|
+
createdAt: z.ZodISODateTime;
|
|
216
|
+
updatedAt: z.ZodISODateTime;
|
|
217
|
+
}, z.core.$strip>>;
|
|
218
|
+
};
|
|
219
|
+
};
|
|
220
|
+
readonly linear_issue: {
|
|
221
|
+
readonly shape: "entity";
|
|
222
|
+
readonly description: "Issues with their state, priority, assignee, team, project, cycle, labels, estimate, and lifecycle timestamps.";
|
|
223
|
+
readonly endpoint: "GraphQL query: issues { nodes { ... } }";
|
|
224
|
+
readonly responses: {
|
|
225
|
+
readonly issues: z.ZodArray<z.ZodObject<{
|
|
226
|
+
id: z.ZodString;
|
|
227
|
+
identifier: z.ZodString;
|
|
228
|
+
title: z.ZodString;
|
|
229
|
+
priority: z.ZodNumber;
|
|
230
|
+
estimate: z.ZodNullable<z.ZodNumber>;
|
|
231
|
+
state: z.ZodNullable<z.ZodObject<{
|
|
232
|
+
id: z.ZodString;
|
|
233
|
+
name: z.ZodString;
|
|
234
|
+
type: z.ZodString;
|
|
235
|
+
}, z.core.$strip>>;
|
|
236
|
+
assignee: z.ZodNullable<z.ZodObject<{
|
|
237
|
+
id: z.ZodString;
|
|
238
|
+
}, z.core.$strip>>;
|
|
239
|
+
team: z.ZodNullable<z.ZodObject<{
|
|
240
|
+
id: z.ZodString;
|
|
241
|
+
}, z.core.$strip>>;
|
|
242
|
+
project: z.ZodNullable<z.ZodObject<{
|
|
243
|
+
id: z.ZodString;
|
|
244
|
+
}, z.core.$strip>>;
|
|
245
|
+
cycle: z.ZodNullable<z.ZodObject<{
|
|
246
|
+
id: z.ZodString;
|
|
247
|
+
}, z.core.$strip>>;
|
|
248
|
+
labels: z.ZodObject<{
|
|
249
|
+
nodes: z.ZodArray<z.ZodObject<{
|
|
250
|
+
id: z.ZodString;
|
|
251
|
+
name: z.ZodString;
|
|
252
|
+
}, z.core.$strip>>;
|
|
253
|
+
}, z.core.$strip>;
|
|
254
|
+
createdAt: z.ZodISODateTime;
|
|
255
|
+
updatedAt: z.ZodISODateTime;
|
|
256
|
+
completedAt: z.ZodNullable<z.ZodISODateTime>;
|
|
257
|
+
canceledAt: z.ZodNullable<z.ZodISODateTime>;
|
|
258
|
+
startedAt: z.ZodNullable<z.ZodISODateTime>;
|
|
259
|
+
history: z.ZodObject<{
|
|
260
|
+
nodes: z.ZodArray<z.ZodObject<{
|
|
261
|
+
id: z.ZodString;
|
|
262
|
+
createdAt: z.ZodISODateTime;
|
|
263
|
+
actor: z.ZodNullable<z.ZodObject<{
|
|
264
|
+
id: z.ZodString;
|
|
265
|
+
}, z.core.$strip>>;
|
|
266
|
+
fromState: z.ZodNullable<z.ZodObject<{
|
|
267
|
+
id: z.ZodString;
|
|
268
|
+
name: z.ZodString;
|
|
269
|
+
}, z.core.$strip>>;
|
|
270
|
+
toState: z.ZodNullable<z.ZodObject<{
|
|
271
|
+
id: z.ZodString;
|
|
272
|
+
name: z.ZodString;
|
|
273
|
+
}, z.core.$strip>>;
|
|
274
|
+
fromAssignee: z.ZodNullable<z.ZodObject<{
|
|
275
|
+
id: z.ZodString;
|
|
276
|
+
}, z.core.$strip>>;
|
|
277
|
+
toAssignee: z.ZodNullable<z.ZodObject<{
|
|
278
|
+
id: z.ZodString;
|
|
279
|
+
}, z.core.$strip>>;
|
|
280
|
+
}, z.core.$strip>>;
|
|
281
|
+
pageInfo: z.ZodObject<{
|
|
282
|
+
hasNextPage: z.ZodBoolean;
|
|
283
|
+
endCursor: z.ZodNullable<z.ZodString>;
|
|
284
|
+
}, z.core.$strip>;
|
|
285
|
+
}, z.core.$strip>;
|
|
286
|
+
}, z.core.$strip>>;
|
|
287
|
+
};
|
|
288
|
+
};
|
|
289
|
+
readonly linear_issue_state_change: {
|
|
290
|
+
readonly shape: "event";
|
|
291
|
+
readonly description: "State-transition events derived from each issue’s history (from-state to to-state), keyed by the originating actor.";
|
|
292
|
+
readonly endpoint: "GraphQL query: issues { nodes { history { nodes { ... } } } }";
|
|
293
|
+
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.";
|
|
294
|
+
};
|
|
295
|
+
};
|
|
296
|
+
static readonly schemas: object & {
|
|
35
297
|
readonly teams: z.ZodArray<z.ZodObject<{
|
|
36
298
|
id: z.ZodString;
|
|
37
299
|
name: z.ZodString;
|
|
@@ -39,6 +301,7 @@ declare class LinearConnector extends BaseConnector<LinearSettings, LinearCreden
|
|
|
39
301
|
createdAt: z.ZodISODateTime;
|
|
40
302
|
updatedAt: z.ZodISODateTime;
|
|
41
303
|
}, z.core.$strip>>;
|
|
304
|
+
} & {
|
|
42
305
|
readonly users: z.ZodArray<z.ZodObject<{
|
|
43
306
|
id: z.ZodString;
|
|
44
307
|
name: z.ZodString;
|
|
@@ -48,6 +311,7 @@ declare class LinearConnector extends BaseConnector<LinearSettings, LinearCreden
|
|
|
48
311
|
createdAt: z.ZodISODateTime;
|
|
49
312
|
updatedAt: z.ZodISODateTime;
|
|
50
313
|
}, z.core.$strip>>;
|
|
314
|
+
} & {
|
|
51
315
|
readonly cycles: z.ZodArray<z.ZodObject<{
|
|
52
316
|
id: z.ZodString;
|
|
53
317
|
number: z.ZodNumber;
|
|
@@ -64,6 +328,7 @@ declare class LinearConnector extends BaseConnector<LinearSettings, LinearCreden
|
|
|
64
328
|
createdAt: z.ZodISODateTime;
|
|
65
329
|
updatedAt: z.ZodISODateTime;
|
|
66
330
|
}, z.core.$strip>>;
|
|
331
|
+
} & {
|
|
67
332
|
readonly issues: z.ZodArray<z.ZodObject<{
|
|
68
333
|
id: z.ZodString;
|
|
69
334
|
identifier: z.ZodString;
|
|
@@ -126,7 +391,7 @@ declare class LinearConnector extends BaseConnector<LinearSettings, LinearCreden
|
|
|
126
391
|
}, z.core.$strip>;
|
|
127
392
|
}, z.core.$strip>;
|
|
128
393
|
}, z.core.$strip>>;
|
|
129
|
-
}
|
|
394
|
+
} & Readonly<Record<string, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
|
|
130
395
|
static create(input: unknown, ctx?: ConnectorContext): LinearConnector;
|
|
131
396
|
readonly id = "linear";
|
|
132
397
|
readonly credentials: {
|
|
@@ -138,6 +403,7 @@ declare class LinearConnector extends BaseConnector<LinearSettings, LinearCreden
|
|
|
138
403
|
private buildHeaders;
|
|
139
404
|
private graphql;
|
|
140
405
|
private sinceFilter;
|
|
406
|
+
private issueSinceFilter;
|
|
141
407
|
private teamFilter;
|
|
142
408
|
private issueTeamFilter;
|
|
143
409
|
private mergeFilters;
|
|
@@ -152,4 +418,4 @@ declare class LinearConnector extends BaseConnector<LinearSettings, LinearCreden
|
|
|
152
418
|
sync(options: SyncOptions, storage: StorageHandle, signal?: AbortSignal): Promise<SyncResult>;
|
|
153
419
|
}
|
|
154
420
|
|
|
155
|
-
export { LinearConnector, type LinearResource, type LinearSettings, configFields, LinearConnector as default };
|
|
421
|
+
export { LinearConnector, type LinearResource, type LinearSettings, configFields, LinearConnector as default, doc, id, linearResources as resources };
|
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
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
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
|
-
|
|
22
|
-
|
|
23
|
-
|
|
37
|
+
const resetMs = reset * multiplier;
|
|
38
|
+
if (!Number.isFinite(resetMs)) {
|
|
39
|
+
return null;
|
|
40
|
+
}
|
|
41
|
+
return { remaining, resetAt: new Date(resetMs) };
|
|
24
42
|
}
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
};
|
|
43
|
+
};
|
|
44
|
+
}
|
|
28
45
|
|
|
29
46
|
// src/linear.ts
|
|
30
47
|
import {
|
|
31
48
|
BaseConnector,
|
|
32
49
|
defineConfigFields,
|
|
33
|
-
|
|
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
|
-
|
|
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) {
|
|
@@ -212,14 +249,43 @@ var issueSchema = z.object({
|
|
|
212
249
|
})
|
|
213
250
|
})
|
|
214
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
|
+
});
|
|
284
|
+
var id = "linear";
|
|
215
285
|
var LinearConnector = class _LinearConnector extends BaseConnector {
|
|
216
|
-
static id =
|
|
217
|
-
static
|
|
218
|
-
|
|
219
|
-
users: z.array(userSchema),
|
|
220
|
-
cycles: z.array(cycleSchema),
|
|
221
|
-
issues: z.array(issueSchema)
|
|
222
|
-
};
|
|
286
|
+
static id = id;
|
|
287
|
+
static resources = linearResources;
|
|
288
|
+
static schemas = schemasFromResources(linearResources);
|
|
223
289
|
static create(input, ctx) {
|
|
224
290
|
const parsed = configFields.parse(input);
|
|
225
291
|
return new _LinearConnector(
|
|
@@ -232,13 +298,13 @@ var LinearConnector = class _LinearConnector extends BaseConnector {
|
|
|
232
298
|
ctx
|
|
233
299
|
);
|
|
234
300
|
}
|
|
235
|
-
id =
|
|
301
|
+
id = id;
|
|
236
302
|
credentials = linearCredentials;
|
|
237
303
|
buildHeaders() {
|
|
238
304
|
return {
|
|
239
305
|
Authorization: this.creds.apiKey,
|
|
240
306
|
"Content-Type": "application/json",
|
|
241
|
-
"User-Agent": "
|
|
307
|
+
"User-Agent": connectorUserAgent("linear")
|
|
242
308
|
};
|
|
243
309
|
}
|
|
244
310
|
async graphql(query, variables, resource, signal) {
|
|
@@ -261,7 +327,16 @@ var LinearConnector = class _LinearConnector extends BaseConnector {
|
|
|
261
327
|
return res;
|
|
262
328
|
}
|
|
263
329
|
sinceFilter(options) {
|
|
264
|
-
if (
|
|
330
|
+
if (!options.since) {
|
|
331
|
+
return void 0;
|
|
332
|
+
}
|
|
333
|
+
if (options.mode === "latest") {
|
|
334
|
+
return { updatedAt: { gt: options.since } };
|
|
335
|
+
}
|
|
336
|
+
return void 0;
|
|
337
|
+
}
|
|
338
|
+
issueSinceFilter(options) {
|
|
339
|
+
if (!options.since) {
|
|
265
340
|
return void 0;
|
|
266
341
|
}
|
|
267
342
|
return { updatedAt: { gt: options.since } };
|
|
@@ -347,7 +422,7 @@ var LinearConnector = class _LinearConnector extends BaseConnector {
|
|
|
347
422
|
async fetchIssuesPage(page, options, signal) {
|
|
348
423
|
const filter = this.mergeFilters(
|
|
349
424
|
this.issueTeamFilter(),
|
|
350
|
-
this.
|
|
425
|
+
this.issueSinceFilter(options)
|
|
351
426
|
);
|
|
352
427
|
const historyFirst = this.settings.historyPerIssue ?? DEFAULT_HISTORY_PER_ISSUE;
|
|
353
428
|
const res = await this.graphql(
|
|
@@ -480,13 +555,17 @@ var LinearConnector = class _LinearConnector extends BaseConnector {
|
|
|
480
555
|
async sync(options, storage, signal) {
|
|
481
556
|
const cursor = isLinearSyncCursor(options.cursor) ? options.cursor : void 0;
|
|
482
557
|
const isFull = options.mode === "full";
|
|
483
|
-
const historySinceMs = options.
|
|
484
|
-
const
|
|
485
|
-
|
|
558
|
+
const historySinceMs = options.since ? new Date(options.since).getTime() : null;
|
|
559
|
+
const phases = selectActivePhases(
|
|
560
|
+
(r) => r,
|
|
561
|
+
PHASE_ORDER,
|
|
562
|
+
this.settings.resources
|
|
563
|
+
);
|
|
486
564
|
return paginateChunked({
|
|
487
565
|
phases,
|
|
488
566
|
cursor,
|
|
489
567
|
signal,
|
|
568
|
+
logger: this.logger,
|
|
490
569
|
fetchPage: async (phase, page, sig) => {
|
|
491
570
|
switch (phase) {
|
|
492
571
|
case "teams":
|
|
@@ -543,6 +622,9 @@ var index_default = LinearConnector;
|
|
|
543
622
|
export {
|
|
544
623
|
LinearConnector,
|
|
545
624
|
configFields,
|
|
546
|
-
index_default as default
|
|
625
|
+
index_default as default,
|
|
626
|
+
doc,
|
|
627
|
+
id,
|
|
628
|
+
linearResources as resources
|
|
547
629
|
};
|
|
548
630
|
//# 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\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\nexport class LinearConnector extends BaseConnector<\n LinearSettings,\n LinearCredentials\n> {\n static readonly id = 'linear';\n\n static readonly schemas = {\n teams: z.array(teamSchema),\n users: z.array(userSchema),\n cycles: z.array(cycleSchema),\n issues: z.array(issueSchema),\n } as const;\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\nexport const 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 const id = 'linear';\n\nexport class LinearConnector extends BaseConnector<\n LinearSettings,\n LinearCredentials\n> {\n static readonly id = id;\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 = id;\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 {\n configFields,\n doc,\n id,\n LinearConnector,\n linearResources as resources,\n} from './linear';\nexport type { LinearSettings, LinearResource } from './linear';\nexport default LinearConnector;\n"],"mappings":"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","names":[]}
|
package/package.json
CHANGED
|
@@ -1,9 +1,10 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@rawdash/connector-linear",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.17.0",
|
|
4
4
|
"description": "Rawdash connector for Linear — issues, cycles, teams, and users",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"type": "module",
|
|
7
|
+
"sideEffects": false,
|
|
7
8
|
"repository": {
|
|
8
9
|
"type": "git",
|
|
9
10
|
"url": "https://github.com/rawdash/rawdash.git",
|
|
@@ -23,15 +24,15 @@
|
|
|
23
24
|
},
|
|
24
25
|
"dependencies": {
|
|
25
26
|
"zod": "^4.4.3",
|
|
26
|
-
"@rawdash/core": "0.
|
|
27
|
+
"@rawdash/core": "0.17.0"
|
|
27
28
|
},
|
|
28
29
|
"devDependencies": {
|
|
29
30
|
"fast-check": "^4.8.0",
|
|
30
31
|
"tsup": "^8.0.0",
|
|
31
32
|
"typescript": "^5.7.2",
|
|
32
33
|
"vitest": "^4.1.4",
|
|
33
|
-
"@rawdash/connector-shared": "0.
|
|
34
|
-
"@rawdash/connector-test-utils": "0.0.
|
|
34
|
+
"@rawdash/connector-shared": "0.3.0",
|
|
35
|
+
"@rawdash/connector-test-utils": "0.0.4"
|
|
35
36
|
},
|
|
36
37
|
"scripts": {
|
|
37
38
|
"build": "tsup",
|