patchwork-os 0.2.0-beta.1 → 0.2.0-beta.10.canary.95

package/dist/connectors/caldiy.js

@@ -0,0 +1,424 @@
+/**
+ * Cal.diy connector — scheduling via Cal.com-compatible API.
+ *
+ * Auth: API key (Personal Access Token).
+ *   - Env var: CALCOM_API_KEY overrides stored token for CI/headless use.
+ *   - Stored: getSecretJsonSync("caldiy") → CalDiyTokens
+ *
+ * Cal.diy is the MIT-licensed self-hostable fork of Cal.com; the API is
+ * identical to Cal.com cloud. Defaults to https://api.cal.com/v2 but
+ * accepts a custom baseUrl for self-hosted deployments.
+ *
+ * Tools: getEventTypes, getEventType, getBookings, getBooking,
+ *        cancelBooking, rescheduleBooking, getMeUser, getSchedules,
+ *        createSchedule
+ *
+ * Webhook verification: verifyCalDiyWebhook (HMAC-SHA256, x-cal-signature-256)
+ *
+ * Extends BaseConnector for unified auth, retry, rate-limit, error handling.
+ */
+import { createHmac, timingSafeEqual } from "node:crypto";
+import { unlinkSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+import { BaseConnector, } from "./baseConnector.js";
+import { getSecretJsonSync, storeSecretJsonSync } from "./tokenStorage.js";
+const CALDIY_DEFAULT_BASE_URL = "https://api.cal.com/v2";
+const CALDIY_API_VERSION = "2024-09-04";
+// ------------------------------------------------------------------ token helpers
+export function loadTokens() {
+    const envKey = process.env.CALCOM_API_KEY;
+    if (envKey) {
+        return {
+            apiKey: envKey,
+            baseUrl: CALDIY_DEFAULT_BASE_URL,
+            connected_at: new Date().toISOString(),
+        };
+    }
+    return getSecretJsonSync("caldiy");
+}
+export function saveTokens(tokens) {
+    storeSecretJsonSync("caldiy", tokens);
+}
+export function clearTokens() {
+    try {
+        const p = path.join(homedir(), ".patchwork", "tokens", "caldiy.json");
+        unlinkSync(p);
+    }
+    catch {
+        /* already gone */
+    }
+}
+// ------------------------------------------------------------------ webhook verification
+/**
+ * Verify a Cal.diy webhook signature.
+ *
+ * Cal.com sends `x-cal-signature-256: <hex>` computed as HMAC-SHA256 over
+ * the raw request body using the webhook secret.
+ *
+ * Returns true only when the signature matches; returns false on any
+ * mismatch or malformed input. Never throws.
+ */
+export function verifyCalDiyWebhook(rawBody, signatureHeader, webhookSecret) {
+    try {
+        const bodyBuf = typeof rawBody === "string" ? Buffer.from(rawBody, "utf8") : rawBody;
+        const expected = createHmac("sha256", webhookSecret)
+            .update(bodyBuf)
+            .digest("hex");
+        const actual = signatureHeader.trim().toLowerCase();
+        const expectedBuf = Buffer.from(expected, "utf8");
+        const actualBuf = Buffer.from(actual, "utf8");
+        if (expectedBuf.length !== actualBuf.length)
+            return false;
+        return timingSafeEqual(expectedBuf, actualBuf);
+    }
+    catch {
+        return false;
+    }
+}
+// ------------------------------------------------------------------ connector
+export class CalDiyConnector extends BaseConnector {
+    providerName = "caldiy";
+    cachedTokens = null;
+    getOAuthConfig() {
+        return null;
+    }
+    async authenticate() {
+        const tokens = loadTokens();
+        if (!tokens) {
+            throw new Error("Cal.diy not connected. Run: patchwork connect caldiy  or set CALCOM_API_KEY");
+        }
+        this.cachedTokens = tokens;
+        return { token: tokens.apiKey };
+    }
+    async healthCheck() {
+        try {
+            const result = await this.apiCall(async (token) => {
+                const baseUrl = this.baseUrl();
+                const res = await fetch(`${baseUrl}/me`, {
+                    headers: this.buildHeaders(token),
+                });
+                if (!res.ok)
+                    throw Object.assign(new Error(`HTTP ${res.status}`), {
+                        status: res.status,
+                    });
+                return res.json();
+            });
+            if ("error" in result)
+                return { ok: false, error: result.error };
+            return { ok: true };
+        }
+        catch (err) {
+            return { ok: false, error: this.normalizeError(err) };
+        }
+    }
+    normalizeError(error) {
+        if (error && typeof error === "object" && "status" in error) {
+            const status = error.status;
+            if (status === 401)
+                return {
+                    code: "auth_expired",
+                    message: "Cal.diy API key expired or invalid",
+                    retryable: false,
+                    suggestedAction: "Reconnect: patchwork connect caldiy",
+                };
+            if (status === 429)
+                return {
+                    code: "rate_limited",
+                    message: "Cal.diy API rate limit exceeded",
+                    retryable: true,
+                    suggestedAction: "Wait and retry",
+                };
+            if (status === 404)
+                return {
+                    code: "not_found",
+                    message: "Cal.diy resource not found",
+                    retryable: false,
+                };
+            if (status === 400)
+                return {
+                    code: "validation_error",
+                    message: "Cal.diy request validation failed",
+                    retryable: false,
+                };
+            return {
+                code: "provider_error",
+                message: `Cal.diy API error: HTTP ${status}`,
+                retryable: status >= 500,
+            };
+        }
+        if (error instanceof Error) {
+            if (error.message.includes("ENOTFOUND") ||
+                error.message.includes("ECONNREFUSED")) {
+                return {
+                    code: "network_error",
+                    message: `Cannot reach Cal.diy API: ${error.message}`,
+                    retryable: true,
+                };
+            }
+        }
+        return {
+            code: "provider_error",
+            message: error instanceof Error ? error.message : String(error),
+            retryable: false,
+        };
+    }
+    getStatus() {
+        const tokens = loadTokens();
+        return {
+            id: "caldiy",
+            status: tokens ? "connected" : "disconnected",
+            lastSync: tokens?.connected_at,
+            workspace: tokens?.username,
+        };
+    }
+    buildHeaders(token) {
+        return {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json",
+            "cal-api-version": CALDIY_API_VERSION,
+        };
+    }
+    baseUrl() {
+        const tokens = this.cachedTokens ?? loadTokens();
+        return tokens?.baseUrl ?? CALDIY_DEFAULT_BASE_URL;
+    }
+    async get(apiPath) {
+        const result = await this.apiCall(async (token) => {
+            const res = await fetch(`${this.baseUrl()}${apiPath}`, {
+                headers: this.buildHeaders(token),
+            });
+            if (!res.ok) {
+                const err = (await res.json().catch(() => ({})));
+                throw Object.assign(new Error(err.message ?? `HTTP ${res.status}`), {
+                    status: res.status,
+                });
+            }
+            return res.json();
+        });
+        if ("error" in result)
+            throw new Error(result.error.message);
+        return result.data.data;
+    }
+    async post(apiPath, body) {
+        const result = await this.apiCall(async (token) => {
+            const res = await fetch(`${this.baseUrl()}${apiPath}`, {
+                method: "POST",
+                headers: this.buildHeaders(token),
+                body: JSON.stringify(body),
+            });
+            if (!res.ok) {
+                const err = (await res.json().catch(() => ({})));
+                throw Object.assign(new Error(err.message ?? `HTTP ${res.status}`), {
+                    status: res.status,
+                });
+            }
+            return res.json();
+        });
+        if ("error" in result)
+            throw new Error(result.error.message);
+        return result.data.data;
+    }
+    async del(apiPath, body) {
+        const result = await this.apiCall(async (token) => {
+            const res = await fetch(`${this.baseUrl()}${apiPath}`, {
+                method: "DELETE",
+                headers: this.buildHeaders(token),
+                ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+            });
+            if (!res.ok) {
+                const err = (await res.json().catch(() => ({})));
+                throw Object.assign(new Error(err.message ?? `HTTP ${res.status}`), {
+                    status: res.status,
+                });
+            }
+            return res.json();
+        });
+        if ("error" in result)
+            throw new Error(result.error.message);
+        return result.data.data;
+    }
+    // ---------------------------------------------------------------- tools
+    async getEventTypes() {
+        return this.get("/event-types");
+    }
+    async getEventType(id) {
+        return this.get(`/event-types/${id}`);
+    }
+    async getBookings(opts) {
+        const params = new URLSearchParams();
+        if (opts?.status)
+            params.set("status", opts.status);
+        if (opts?.attendeeEmail)
+            params.set("attendeeEmail", opts.attendeeEmail);
+        if (opts?.dateFrom)
+            params.set("dateFrom", opts.dateFrom);
+        if (opts?.dateTo)
+            params.set("dateTo", opts.dateTo);
+        const qs = params.toString();
+        return this.get(`/bookings${qs ? `?${qs}` : ""}`);
+    }
+    async getBooking(uid) {
+        return this.get(`/bookings/${uid}`);
+    }
+    async cancelBooking(uid, reason) {
+        return this.del(`/bookings/${uid}`, reason !== undefined ? { reason } : undefined);
+    }
+    async rescheduleBooking(uid, startTime, reason) {
+        const body = { startTime };
+        if (reason !== undefined)
+            body.reason = reason;
+        return this.post(`/bookings/${uid}/reschedule`, body);
+    }
+    async getMeUser() {
+        return this.get("/me");
+    }
+    async getSchedules() {
+        return this.get("/schedules");
+    }
+    async createSchedule(name, timeZone, availability) {
+        const body = { name, timeZone };
+        if (availability !== undefined)
+            body.availability = availability;
+        return this.post("/schedules", body);
+    }
+}
+// ------------------------------------------------------------------ singleton
+let _instance = null;
+export function getCalDiyConnector() {
+    if (!_instance)
+        _instance = new CalDiyConnector();
+    return _instance;
+}
+export function resetCalDiyConnector() {
+    _instance = null;
+}
+// ------------------------------------------------------------------ convenience re-exports
+export { loadTokens as isConnected };
+/**
+ * POST /connections/caldiy/connect  { apiKey: "cal_...", baseUrl?: "..." }
+ * Stores the API key and verifies it by calling GET /me.
+ */
+export async function handleCalDiyConnect(body) {
+    let apiKey;
+    let baseUrl;
+    try {
+        const parsed = JSON.parse(body);
+        if (typeof parsed.apiKey !== "string" || parsed.apiKey.trim() === "") {
+            return {
+                status: 400,
+                contentType: "application/json",
+                body: JSON.stringify({
+                    ok: false,
+                    error: "apiKey is required. Generate one at your Cal.diy dashboard under Settings → API Keys.",
+                }),
+            };
+        }
+        apiKey = parsed.apiKey.trim();
+        baseUrl =
+            typeof parsed.baseUrl === "string" && parsed.baseUrl.trim() !== ""
+                ? parsed.baseUrl.trim()
+                : CALDIY_DEFAULT_BASE_URL;
+    }
+    catch {
+        return {
+            status: 400,
+            contentType: "application/json",
+            body: JSON.stringify({ ok: false, error: "Invalid JSON body" }),
+        };
+    }
+    try {
+        const res = await fetch(`${baseUrl}/me`, {
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                "cal-api-version": CALDIY_API_VERSION,
+            },
+        });
+        if (!res.ok) {
+            return {
+                status: 401,
+                contentType: "application/json",
+                body: JSON.stringify({
+                    ok: false,
+                    error: "API key rejected by Cal.diy — check the key is valid",
+                }),
+            };
+        }
+        const wrapped = (await res.json());
+        const user = wrapped.data;
+        const tokens = {
+            apiKey,
+            baseUrl,
+            username: user.username,
+            connected_at: new Date().toISOString(),
+        };
+        saveTokens(tokens);
+        resetCalDiyConnector();
+        return {
+            status: 200,
+            contentType: "application/json",
+            body: JSON.stringify({
+                ok: true,
+                username: tokens.username ?? "unknown",
+                connectedAt: tokens.connected_at,
+            }),
+        };
+    }
+    catch (err) {
+        return {
+            status: 500,
+            contentType: "application/json",
+            body: JSON.stringify({
+                ok: false,
+                error: err instanceof Error ? err.message : String(err),
+            }),
+        };
+    }
+}
+/**
+ * POST /connections/caldiy/test
+ * Verifies stored API key is still valid.
+ */
+export async function handleCalDiyTest() {
+    const tokens = loadTokens();
+    if (!tokens) {
+        return {
+            status: 400,
+            contentType: "application/json",
+            body: JSON.stringify({ ok: false, error: "Cal.diy not connected" }),
+        };
+    }
+    try {
+        const connector = getCalDiyConnector();
+        const check = await connector.healthCheck();
+        return {
+            status: check.ok ? 200 : 401,
+            contentType: "application/json",
+            body: JSON.stringify(check.ok ? { ok: true } : { ok: false, error: check.error?.message }),
+        };
+    }
+    catch (err) {
+        return {
+            status: 500,
+            contentType: "application/json",
+            body: JSON.stringify({
+                ok: false,
+                error: err instanceof Error ? err.message : String(err),
+            }),
+        };
+    }
+}
+/**
+ * DELETE /connections/caldiy
+ * Removes stored token.
+ */
+export function handleCalDiyDisconnect() {
+    clearTokens();
+    resetCalDiyConnector();
+    return {
+        status: 200,
+        contentType: "application/json",
+        body: JSON.stringify({ ok: true }),
+    };
+}
+//# sourceMappingURL=caldiy.js.map

package/dist/connectors/caldiy.js.map

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

package/dist/connectors/circleci.d.ts

@@ -0,0 +1,162 @@
+/**
+ * CircleCI connector — pipeline + workflow management via the CircleCI v2 API.
+ *
+ * Auth: PAT via `Circle-Token` header (NOT Bearer).
+ *   - Env var: CIRCLECI_API_TOKEN
+ *   - Stored: getSecretJsonSync("circleci") → CircleCITokens
+ *
+ * Tools: getProject, getPipelines, getPipeline, triggerPipeline,
+ *        getPipelineWorkflows, getWorkflow, getWorkflowJobs, cancelWorkflow,
+ *        approveJob, getJob, listWebhooks, createWebhook, deleteWebhook
+ *
+ * Extends BaseConnector for unified auth, retry, rate-limit, error handling.
+ */
+import { type AuthContext, BaseConnector, type ConnectorError, type ConnectorStatus } from "./baseConnector.js";
+export interface CircleCITokens {
+    apiToken: string;
+    login?: string;
+    connected_at: string;
+}
+export interface CircleCIPipeline {
+    id: string;
+    project_slug: string;
+    state: "created" | "errored" | "setup-pending" | "setup" | "pending";
+    number: number;
+    trigger: {
+        type: string;
+        received_at: string;
+    };
+    vcs?: {
+        branch?: string;
+        tag?: string;
+        commit?: {
+            oid?: string;
+            subject?: string;
+        };
+    };
+    created_at?: string;
+    updated_at?: string;
+}
+export interface CircleCIWorkflow {
+    id: string;
+    name: string;
+    status: "success" | "running" | "not_run" | "failed" | "error" | "failing" | "on_hold" | "canceled" | "unauthorized";
+    pipeline_id: string;
+    pipeline_number?: number;
+    project_slug?: string;
+    started_by: string;
+    created_at: string;
+    stopped_at?: string | null;
+}
+export interface CircleCIJob {
+    id: string;
+    name: string;
+    status: string;
+    job_number?: number;
+    type: "build" | "approval";
+    created_at?: string;
+    started_at?: string | null;
+    stopped_at?: string | null;
+    approval_request_id?: string;
+    dependencies?: string[];
+}
+export interface CircleCIWebhook {
+    id: string;
+    name: string;
+    url: string;
+    scope: {
+        id: string;
+        type: string;
+    };
+    events: string[];
+    verify_tls: boolean;
+    signing_secret: string;
+    created_at?: string;
+    updated_at?: string;
+}
+export interface CircleCIProject {
+    slug: string;
+    name: string;
+    id?: string;
+    organization_name?: string;
+    vcs_url?: string;
+}
+export interface CircleCITriggerResult {
+    id: string;
+    state: string;
+    number: number;
+    created_at: string;
+}
+export declare class CircleCIConnector extends BaseConnector {
+    readonly providerName = "circleci";
+    private tokens;
+    protected getOAuthConfig(): null;
+    authenticate(): Promise<AuthContext>;
+    healthCheck(): Promise<{
+        ok: boolean;
+        error?: ConnectorError;
+    }>;
+    normalizeError(error: unknown): ConnectorError;
+    getStatus(): ConnectorStatus;
+    getProject(slug: string): Promise<CircleCIProject>;
+    getPipelines(projectSlug: string, branch?: string): Promise<CircleCIPipeline[]>;
+    getPipeline(id: string): Promise<CircleCIPipeline>;
+    triggerPipeline(projectSlug: string, params?: {
+        branch?: string;
+        tag?: string;
+        parameters?: Record<string, string | boolean | number>;
+    }): Promise<CircleCITriggerResult>;
+    getPipelineWorkflows(pipelineId: string): Promise<CircleCIWorkflow[]>;
+    getWorkflow(id: string): Promise<CircleCIWorkflow>;
+    getWorkflowJobs(workflowId: string): Promise<CircleCIJob[]>;
+    cancelWorkflow(id: string): Promise<void>;
+    approveJob(workflowId: string, approvalRequestId: string): Promise<void>;
+    getJob(projectSlug: string, jobNumber: number): Promise<CircleCIJob>;
+    listWebhooks(scopeId: string, scopeType?: string): Promise<CircleCIWebhook[]>;
+    createWebhook(params: {
+        name: string;
+        events: string[];
+        url: string;
+        scopeId: string;
+        scopeType?: string;
+        signingSecret: string;
+        verifyTls?: boolean;
+    }): Promise<CircleCIWebhook>;
+    deleteWebhook(webhookId: string): Promise<void>;
+    private buildHeaders;
+}
+/**
+ * Verify a CircleCI webhook delivery.
+ *
+ * CircleCI signs payloads with HMAC-SHA256 and sends the signature in the
+ * `circleci-signature` header as `v1=<hex>`. This function recomputes the
+ * expected HMAC and does a constant-time comparison to prevent timing attacks.
+ *
+ * @param rawBody       Raw request body bytes (Buffer or string)
+ * @param signatureHeader  Value of the `circleci-signature` header
+ * @param signingSecret    The signing secret configured on the webhook
+ * @returns true if the signature is valid, false otherwise
+ */
+export declare function verifyCircleCIWebhook(rawBody: Buffer | string, signatureHeader: string, signingSecret: string): boolean;
+export declare function loadTokens(): CircleCITokens | null;
+export declare function saveTokens(tokens: CircleCITokens): void;
+export declare function clearTokens(): void;
+export declare function getCircleCIConnector(): CircleCIConnector;
+export { getCircleCIConnector as circleci };
+export interface ConnectorHandlerResult {
+    status: number;
+    body: string;
+    contentType?: string;
+}
+/**
+ * POST /connections/circleci/connect  { apiToken }
+ */
+export declare function handleCircleCIConnect(body: string): Promise<ConnectorHandlerResult>;
+/**
+ * POST /connections/circleci/test
+ */
+export declare function handleCircleCITest(): Promise<ConnectorHandlerResult>;
+/**
+ * DELETE /connections/circleci
+ */
+export declare function handleCircleCIDisconnect(): ConnectorHandlerResult;