patchwork-os 0.2.0-alpha.3 → 0.2.0-alpha.4

package/dist/connectors/googleCalendar.js

@@ -0,0 +1,308 @@
+/**
+ * Google Calendar OAuth 2.0 connector.
+ *
+ * Handles:
+ *   GET  /connections/google-calendar/auth      — redirect to Google consent screen
+ *   GET  /connections/google-calendar/callback  — exchange code for tokens, store locally
+ *   POST /connections/google-calendar/test      — verify stored token works
+ *   DELETE /connections/google-calendar         — revoke + delete stored token
+ *
+ * Tokens stored at ~/.patchwork/tokens/google-calendar.json (mode 0600).
+ * Client credentials read from env: GOOGLE_CALENDAR_CLIENT_ID, GOOGLE_CALENDAR_CLIENT_SECRET
+ */
+import crypto from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync, } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+const SCOPES = ["https://www.googleapis.com/auth/calendar.readonly"];
+const REDIRECT_URI = process.env.PATCHWORK_DASHBOARD_URL
+    ? `${process.env.PATCHWORK_DASHBOARD_URL}/connections/google-calendar/callback`
+    : "http://localhost:3200/connections/google-calendar/callback";
+const CALENDAR_API = "https://www.googleapis.com/calendar/v3";
+const TOKEN_PATH = path.join(homedir(), ".patchwork", "tokens", "google-calendar.json");
+function clientId() {
+    return process.env.GOOGLE_CALENDAR_CLIENT_ID ?? "";
+}
+function clientSecret() {
+    return process.env.GOOGLE_CALENDAR_CLIENT_SECRET ?? "";
+}
+function isConfigured() {
+    return Boolean(clientId() && clientSecret());
+}
+// ── Token storage ─────────────────────────────────────────────────────────────
+export function loadTokens() {
+    if (!existsSync(TOKEN_PATH))
+        return null;
+    try {
+        return JSON.parse(readFileSync(TOKEN_PATH, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function saveTokens(tokens) {
+    mkdirSync(path.dirname(TOKEN_PATH), { recursive: true, mode: 0o700 });
+    writeFileSync(TOKEN_PATH, JSON.stringify(tokens, null, 2), { mode: 0o600 });
+}
+function deleteTokens() {
+    if (existsSync(TOKEN_PATH))
+        unlinkSync(TOKEN_PATH);
+}
+export function getStatus() {
+    const tokens = loadTokens();
+    return {
+        id: "google-calendar",
+        status: tokens ? "connected" : "disconnected",
+        lastSync: tokens?.connected_at,
+        calendarId: tokens?.calendar_id,
+    };
+}
+// ── OAuth helpers ─────────────────────────────────────────────────────────────
+function buildAuthUrl(state) {
+    const params = new URLSearchParams({
+        client_id: clientId(),
+        redirect_uri: REDIRECT_URI,
+        response_type: "code",
+        scope: SCOPES.join(" "),
+        access_type: "offline",
+        prompt: "consent",
+        state,
+    });
+    return `https://accounts.google.com/o/oauth2/v2/auth?${params.toString()}`;
+}
+async function exchangeCode(code) {
+    const res = await fetch("https://oauth2.googleapis.com/token", {
+        method: "POST",
+        headers: { "Content-Type": "application/x-www-form-urlencoded" },
+        body: new URLSearchParams({
+            code,
+            client_id: clientId(),
+            client_secret: clientSecret(),
+            redirect_uri: REDIRECT_URI,
+            grant_type: "authorization_code",
+        }).toString(),
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`Token exchange failed: ${res.status} ${body}`);
+    }
+    const json = (await res.json());
+    return {
+        access_token: json.access_token,
+        refresh_token: json.refresh_token,
+        expiry_date: json.expires_in
+            ? Date.now() + json.expires_in * 1000
+            : undefined,
+        token_type: json.token_type,
+        scope: json.scope,
+    };
+}
+async function refreshAccessToken(tokens) {
+    if (!tokens.refresh_token)
+        throw new Error("No refresh token available");
+    const res = await fetch("https://oauth2.googleapis.com/token", {
+        method: "POST",
+        headers: { "Content-Type": "application/x-www-form-urlencoded" },
+        body: new URLSearchParams({
+            refresh_token: tokens.refresh_token,
+            client_id: clientId(),
+            client_secret: clientSecret(),
+            grant_type: "refresh_token",
+        }).toString(),
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`Token refresh failed: ${res.status} ${body}`);
+    }
+    const json = (await res.json());
+    const updated = {
+        ...tokens,
+        access_token: json.access_token,
+        expiry_date: json.expires_in
+            ? Date.now() + json.expires_in * 1000
+            : tokens.expiry_date,
+    };
+    saveTokens(updated);
+    return updated;
+}
+/** Returns a valid access token, refreshing if needed. */
+export async function getValidAccessToken() {
+    let tokens = loadTokens();
+    if (!tokens)
+        throw new Error("Google Calendar not connected");
+    const bufferMs = 60_000;
+    if (tokens.expiry_date && Date.now() > tokens.expiry_date - bufferMs) {
+        tokens = await refreshAccessToken(tokens);
+    }
+    return tokens.access_token;
+}
+async function revokeToken(token) {
+    await fetch(`https://oauth2.googleapis.com/revoke?token=${encodeURIComponent(token)}`, { method: "POST" }).catch(() => { });
+}
+// ── State map (in-memory CSRF protection) ────────────────────────────────────
+const pendingStates = new Set();
+function generateState() {
+    const state = crypto.randomBytes(32).toString("hex");
+    pendingStates.add(state);
+    setTimeout(() => pendingStates.delete(state), 10 * 60 * 1000);
+    return state;
+}
+// ── API helpers ───────────────────────────────────────────────────────────────
+async function calendarGet(endpoint, accessToken, params = {}, signal) {
+    const qs = new URLSearchParams(params);
+    const res = await fetch(`${CALENDAR_API}${endpoint}?${qs}`, {
+        headers: { Authorization: `Bearer ${accessToken}` },
+        signal,
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`Google Calendar API error ${res.status}: ${body.slice(0, 200)}`);
+    }
+    return res.json();
+}
+async function fetchCalendarSummary(accessToken, calendarId) {
+    const data = (await calendarGet(`/calendars/${encodeURIComponent(calendarId)}`, accessToken));
+    return data.summary ?? calendarId;
+}
+// ── Event fetching ────────────────────────────────────────────────────────────
+export async function listEvents(opts = {}, signal) {
+    const accessToken = await getValidAccessToken();
+    const tokens = loadTokens();
+    const calendarId = opts.calendarId ?? tokens.calendar_id ?? "primary";
+    const daysAhead = Math.min(opts.daysAhead ?? 7, 30);
+    const maxResults = Math.min(opts.maxResults ?? 20, 50);
+    const now = new Date();
+    const end = new Date(now.getTime() + daysAhead * 24 * 60 * 60 * 1000);
+    const data = (await calendarGet(`/calendars/${encodeURIComponent(calendarId)}/events`, accessToken, {
+        timeMin: now.toISOString(),
+        timeMax: end.toISOString(),
+        maxResults: String(maxResults),
+        singleEvents: "true",
+        orderBy: "startTime",
+    }, signal));
+    return (data.items ?? []).map((item) => {
+        const startRaw = item.start?.dateTime ?? item.start?.date ?? "";
+        const endRaw = item.end?.dateTime ?? item.end?.date ?? "";
+        const allDay = !item.start?.dateTime;
+        return {
+            id: item.id,
+            summary: item.summary ?? "(no title)",
+            description: item.description,
+            start: startRaw,
+            end: endRaw,
+            allDay,
+            location: item.location,
+            htmlLink: item.htmlLink ?? "",
+            attendees: (item.attendees ?? [])
+                .map((a) => a.displayName ?? a.email ?? "")
+                .filter(Boolean),
+        };
+    });
+}
+// ── HTTP handlers ─────────────────────────────────────────────────────────────
+export function handleCalendarAuthRedirect() {
+    if (!isConfigured()) {
+        return {
+            status: 400,
+            contentType: "application/json",
+            body: JSON.stringify({
+                ok: false,
+                error: "GOOGLE_CALENDAR_CLIENT_ID and GOOGLE_CALENDAR_CLIENT_SECRET env vars not set",
+            }),
+        };
+    }
+    const state = generateState();
+    return { status: 302, body: "", redirect: buildAuthUrl(state) };
+}
+export async function handleCalendarCallback(code, state, error) {
+    if (error) {
+        return {
+            status: 400,
+            contentType: "application/json",
+            body: JSON.stringify({ ok: false, error }),
+        };
+    }
+    if (!code || !state || !pendingStates.has(state)) {
+        return {
+            status: 400,
+            contentType: "application/json",
+            body: JSON.stringify({ ok: false, error: "Invalid OAuth state" }),
+        };
+    }
+    pendingStates.delete(state);
+    try {
+        const oauthTokens = await exchangeCode(code);
+        // Default to "primary" calendar; user can update later
+        const calId = "primary";
+        const summary = await fetchCalendarSummary(oauthTokens.access_token, calId);
+        const tokens = {
+            ...oauthTokens,
+            calendar_id: calId,
+            connected_at: new Date().toISOString(),
+        };
+        saveTokens(tokens);
+        return {
+            status: 200,
+            contentType: "application/json",
+            body: JSON.stringify({ ok: true, calendarId: calId, summary }),
+        };
+    }
+    catch (err) {
+        return {
+            status: 400,
+            contentType: "application/json",
+            body: JSON.stringify({
+                ok: false,
+                error: err instanceof Error ? err.message : String(err),
+            }),
+        };
+    }
+}
+export async function handleCalendarTest() {
+    const tokens = loadTokens();
+    if (!tokens) {
+        return {
+            status: 400,
+            contentType: "application/json",
+            body: JSON.stringify({
+                ok: false,
+                error: "Google Calendar not connected",
+            }),
+        };
+    }
+    try {
+        const accessToken = await getValidAccessToken();
+        const summary = await fetchCalendarSummary(accessToken, tokens.calendar_id);
+        return {
+            status: 200,
+            contentType: "application/json",
+            body: JSON.stringify({
+                ok: true,
+                calendarId: tokens.calendar_id,
+                summary,
+            }),
+        };
+    }
+    catch (err) {
+        return {
+            status: 400,
+            contentType: "application/json",
+            body: JSON.stringify({
+                ok: false,
+                error: err instanceof Error ? err.message : String(err),
+            }),
+        };
+    }
+}
+export async function handleCalendarDisconnect() {
+    const tokens = loadTokens();
+    if (tokens?.access_token)
+        await revokeToken(tokens.access_token);
+    deleteTokens();
+    return {
+        status: 200,
+        contentType: "application/json",
+        body: JSON.stringify({ ok: true }),
+    };
+}
+//# sourceMappingURL=googleCalendar.js.map

package/dist/connectors/googleCalendar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"googleCalendar.js","sourceRoot":"","sources":["../../src/connectors/googleCalendar.ts"],"names":[],"mappings":"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"}

package/dist/connectors/linear.d.ts

@@ -1,14 +1,17 @@
 /**
- * Linear connector.
+ * Linear connector — routes through Linear's official MCP server.
  *
- * Uses Linear's GraphQL API with a personal API key (no OAuth app required).
- * Token stored at ~/.patchwork/tokens/linear.json (mode 0600).
- * Env var: LINEAR_API_KEY
+ * Endpoint: https://mcp.linear.app/mcp
+ * Auth:     OAuth 2.1 w/ PKCE; dynamic client registration (RFC 7591).
  *
- * HTTP routes registered in server.ts:
- *   POST   /connections/linear/connect   — store token + verify
- *   POST   /connections/linear/test      — verify stored token works
- *   DELETE /connections/linear           — delete stored token
+ * HTTP routes (wired in src/server.ts):
+ *   GET    /connections/linear/authorize — returns { url } for popup
+ *   GET    /connections/linear/callback  — token exchange
+ *   POST   /connections/linear/test      — ping MCP server
+ *   DELETE /connections/linear           — revoke + delete token
+ *
+ * Back-compat: loadTokens() returns a shape compatible with legacy code
+ * that expected { api_key }. Set LINEAR_API_KEY to bypass OAuth for CI/headless.
  */
 export interface LinearTokens {
     api_key: string;
@@ -21,9 +24,14 @@ export interface ConnectorStatus {
     lastSync?: string;
     workspace?: string;
 }
+export interface ConnectorHandlerResult {
+    status: number;
+    body: string;
+    contentType?: string;
+    redirect?: string;
+}
 export declare function loadTokens(): LinearTokens | null;
 export declare function getStatus(): ConnectorStatus;
-export declare function linearQuery<T>(query: string, variables: Record<string, unknown>, apiKey: string, signal?: AbortSignal): Promise<T>;
 export interface LinearIssue {
     id: string;
     identifier: string;
@@ -52,16 +60,41 @@ export interface LinearIssue {
         }>;
     };
 }
-/**
- * Fetch a Linear issue by ID or URL.
- * Accepts: "LIN-123", "abc123def456...", "https://linear.app/.../issue/LIN-123/..."
- */
 export declare function fetchIssue(issueIdOrUrl: string, signal?: AbortSignal): Promise<LinearIssue>;
-export interface ConnectorHandlerResult {
-    status: number;
-    body: string;
-    contentType?: string;
+export interface ListLinearIssuesOpts {
+    team?: string;
+    assigneeMe?: boolean;
+    states?: string[];
+    limit?: number;
 }
-export declare function handleLinearConnect(body: unknown): Promise<ConnectorHandlerResult>;
+export declare function listIssues(opts?: ListLinearIssuesOpts, signal?: AbortSignal): Promise<Record<string, unknown>[]>;
+export declare function handleLinearAuthorize(): Promise<ConnectorHandlerResult>;
+export declare function handleLinearCallback(code: string | null, state: string | null, error: string | null): Promise<ConnectorHandlerResult>;
 export declare function handleLinearTest(): Promise<ConnectorHandlerResult>;
-export declare function handleLinearDisconnect(): ConnectorHandlerResult;
+export declare function handleLinearDisconnect(): Promise<ConnectorHandlerResult>;
+export interface LinearTeam {
+    id: string;
+    key: string;
+    name: string;
+}
+export declare function listTeams(signal?: AbortSignal): Promise<LinearTeam[]>;
+export declare function listLabels(signal?: AbortSignal): Promise<Array<{
+    id: string;
+    name: string;
+}>>;
+export interface CreateIssueInput {
+    team: string;
+    title: string;
+    description?: string;
+    priority?: number;
+    labels?: string[];
+}
+export declare function createIssue(input: CreateIssueInput, signal?: AbortSignal): Promise<{
+    id: string;
+    identifier: string;
+    title: string;
+    url: string;
+    state: {
+        name: string;
+    };
+}>;