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

package/dist/connectors/obsidian.js

@@ -0,0 +1,441 @@
+/**
+ * Obsidian connector — read/write notes via the Obsidian Local REST API plugin.
+ *
+ * Auth: API key (Bearer token) from plugin settings.
+ *   - Env var: OBSIDIAN_API_KEY overrides stored key for CI/headless use.
+ *   - Stored: getSecretJsonSync("obsidian") → ObsidianTokens
+ *
+ * Tools: listVault, readNote, writeNote, deleteNote, searchVault, appendToNote,
+ *         getActiveNote, openNote, executeCommand, listCommands
+ *
+ * The plugin runs at https://127.0.0.1:27124 with a self-signed certificate.
+ * All fetch calls use an undici Agent with rejectUnauthorized: false.
+ *
+ * Extends BaseConnector for unified auth, retry, rate-limit, error handling.
+ */
+import { unlinkSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+import { Agent, fetch as undiciFetch } from "undici";
+import { BaseConnector, } from "./baseConnector.js";
+import { getSecretJsonSync, storeSecretJsonSync } from "./tokenStorage.js";
+const DEFAULT_BASE_URL = "https://127.0.0.1:27124";
+// Reusable TLS agent that accepts the plugin's self-signed certificate.
+const tlsAgent = new Agent({ connect: { rejectUnauthorized: false } });
+// ------------------------------------------------------------------ token helpers
+export function loadTokens() {
+    const envKey = process.env.OBSIDIAN_API_KEY;
+    if (envKey) {
+        return {
+            apiKey: envKey,
+            baseUrl: DEFAULT_BASE_URL,
+            connected_at: new Date().toISOString(),
+        };
+    }
+    return getSecretJsonSync("obsidian");
+}
+export function saveTokens(tokens) {
+    storeSecretJsonSync("obsidian", tokens);
+}
+export function clearTokens() {
+    try {
+        const p = path.join(homedir(), ".patchwork", "tokens", "obsidian.json");
+        unlinkSync(p);
+    }
+    catch {
+        /* already gone */
+    }
+}
+// ------------------------------------------------------------------ connector
+export class ObsidianConnector extends BaseConnector {
+    providerName = "obsidian";
+    cachedTokens = null;
+    getOAuthConfig() {
+        return null;
+    }
+    async authenticate() {
+        const tokens = loadTokens();
+        if (!tokens) {
+            throw new Error("Obsidian not connected. Run: patchwork connect obsidian  or set OBSIDIAN_API_KEY");
+        }
+        this.cachedTokens = tokens;
+        return { token: tokens.apiKey };
+    }
+    async healthCheck() {
+        try {
+            const result = await this.apiCall(async (token) => {
+                const tokens = this.cachedTokens ?? loadTokens();
+                const baseUrl = tokens?.baseUrl ?? DEFAULT_BASE_URL;
+                const res = await undiciFetch(`${baseUrl}/vault/`, {
+                    dispatcher: tlsAgent,
+                    headers: 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 || status === 403)
+                return {
+                    code: "auth_expired",
+                    message: "Obsidian API key rejected — check plugin settings",
+                    retryable: false,
+                    suggestedAction: "Reconnect: patchwork connect obsidian",
+                };
+            if (status === 404)
+                return {
+                    code: "not_found",
+                    message: "Obsidian note or path not found",
+                    retryable: false,
+                };
+            return {
+                code: "provider_error",
+                message: `Obsidian API error: HTTP ${status}`,
+                retryable: status >= 500,
+            };
+        }
+        if (error instanceof Error) {
+            if (error.message.includes("ECONNREFUSED") ||
+                error.message.includes("ENOTFOUND")) {
+                return {
+                    code: "network_error",
+                    message: `Cannot reach Obsidian Local REST API: ${error.message}. Is the plugin running?`,
+                    retryable: true,
+                    suggestedAction: "Start Obsidian and enable the Local REST API plugin",
+                };
+            }
+        }
+        return {
+            code: "provider_error",
+            message: error instanceof Error ? error.message : String(error),
+            retryable: false,
+        };
+    }
+    getStatus() {
+        const tokens = loadTokens();
+        return {
+            id: "obsidian",
+            status: tokens ? "connected" : "disconnected",
+            lastSync: tokens?.connected_at,
+            workspace: tokens?.baseUrl,
+        };
+    }
+    baseUrl() {
+        return (this.cachedTokens ?? loadTokens())?.baseUrl ?? DEFAULT_BASE_URL;
+    }
+    // ---------------------------------------------------------------- vault ops
+    async listVault(vaultPath) {
+        const result = await this.apiCall(async (token) => {
+            const encoded = vaultPath ? encodeURIComponent(vaultPath) : "";
+            const url = `${this.baseUrl()}/vault/${encoded ? `${encoded}/` : ""}`;
+            const res = await undiciFetch(url, {
+                dispatcher: tlsAgent,
+                headers: buildHeaders(token),
+            });
+            if (!res.ok)
+                throw Object.assign(new Error(`HTTP ${res.status}`), {
+                    status: res.status,
+                });
+            return res.json();
+        });
+        if ("error" in result)
+            throw new Error(result.error.message);
+        const raw = result.data;
+        return (raw.files ?? []).map((f) => ({
+            path: f,
+            type: f.endsWith("/") ? "directory" : "file",
+        }));
+    }
+    async readNote(notePath) {
+        const result = await this.apiCall(async (token) => {
+            const res = await undiciFetch(`${this.baseUrl()}/vault/${encodeURIComponent(notePath)}`, {
+                dispatcher: tlsAgent,
+                headers: buildHeaders(token),
+            });
+            if (!res.ok)
+                throw Object.assign(new Error(`HTTP ${res.status}`), {
+                    status: res.status,
+                });
+            return res.text();
+        });
+        if ("error" in result)
+            throw new Error(result.error.message);
+        return result.data;
+    }
+    async writeNote(notePath, content, append = false) {
+        const result = await this.apiCall(async (token) => {
+            const method = append ? "POST" : "PUT";
+            const res = await undiciFetch(`${this.baseUrl()}/vault/${encodeURIComponent(notePath)}`, {
+                method,
+                dispatcher: tlsAgent,
+                headers: {
+                    ...buildHeaders(token),
+                    "Content-Type": "text/markdown",
+                },
+                body: content,
+            });
+            if (!res.ok)
+                throw Object.assign(new Error(`HTTP ${res.status}`), {
+                    status: res.status,
+                });
+            return null;
+        });
+        if ("error" in result)
+            throw new Error(result.error.message);
+    }
+    async appendToNote(notePath, content) {
+        return this.writeNote(notePath, content, true);
+    }
+    async deleteNote(notePath) {
+        const result = await this.apiCall(async (token) => {
+            const res = await undiciFetch(`${this.baseUrl()}/vault/${encodeURIComponent(notePath)}`, {
+                method: "DELETE",
+                dispatcher: tlsAgent,
+                headers: buildHeaders(token),
+            });
+            if (!res.ok)
+                throw Object.assign(new Error(`HTTP ${res.status}`), {
+                    status: res.status,
+                });
+            return null;
+        });
+        if ("error" in result)
+            throw new Error(result.error.message);
+    }
+    async searchVault(query) {
+        const result = await this.apiCall(async (token) => {
+            const res = await undiciFetch(`${this.baseUrl()}/search/simple/?query=${encodeURIComponent(query)}`, {
+                method: "POST",
+                dispatcher: tlsAgent,
+                headers: buildHeaders(token),
+            });
+            if (!res.ok)
+                throw Object.assign(new Error(`HTTP ${res.status}`), {
+                    status: res.status,
+                });
+            return res.json();
+        });
+        if ("error" in result)
+            throw new Error(result.error.message);
+        return result.data;
+    }
+    async getActiveNote() {
+        const result = await this.apiCall(async (token) => {
+            const res = await undiciFetch(`${this.baseUrl()}/active/`, {
+                dispatcher: tlsAgent,
+                headers: buildHeaders(token),
+            });
+            if (!res.ok)
+                throw Object.assign(new Error(`HTTP ${res.status}`), {
+                    status: res.status,
+                });
+            return res.text();
+        });
+        if ("error" in result)
+            throw new Error(result.error.message);
+        return result.data;
+    }
+    async openNote(notePath) {
+        const result = await this.apiCall(async (token) => {
+            const res = await undiciFetch(`${this.baseUrl()}/open/${encodeURIComponent(notePath)}`, {
+                method: "POST",
+                dispatcher: tlsAgent,
+                headers: buildHeaders(token),
+            });
+            if (!res.ok)
+                throw Object.assign(new Error(`HTTP ${res.status}`), {
+                    status: res.status,
+                });
+            return null;
+        });
+        if ("error" in result)
+            throw new Error(result.error.message);
+    }
+    async listCommands() {
+        const result = await this.apiCall(async (token) => {
+            const res = await undiciFetch(`${this.baseUrl()}/commands/`, {
+                dispatcher: tlsAgent,
+                headers: buildHeaders(token),
+            });
+            if (!res.ok)
+                throw Object.assign(new Error(`HTTP ${res.status}`), {
+                    status: res.status,
+                });
+            return res.json();
+        });
+        if ("error" in result)
+            throw new Error(result.error.message);
+        return result.data.commands ?? [];
+    }
+    async executeCommand(commandId) {
+        const result = await this.apiCall(async (token) => {
+            const res = await undiciFetch(`${this.baseUrl()}/commands/${encodeURIComponent(commandId)}/execute`, {
+                method: "POST",
+                dispatcher: tlsAgent,
+                headers: buildHeaders(token),
+            });
+            if (!res.ok)
+                throw Object.assign(new Error(`HTTP ${res.status}`), {
+                    status: res.status,
+                });
+            return null;
+        });
+        if ("error" in result)
+            throw new Error(result.error.message);
+    }
+}
+// ------------------------------------------------------------------ helpers
+function buildHeaders(token) {
+    return {
+        Authorization: `Bearer ${token}`,
+        Accept: "application/json",
+    };
+}
+// ------------------------------------------------------------------ singleton
+let _instance = null;
+export function getObsidianConnector() {
+    if (!_instance)
+        _instance = new ObsidianConnector();
+    return _instance;
+}
+export function resetObsidianConnector() {
+    _instance = null;
+}
+// ------------------------------------------------------------------ convenience re-exports
+export { loadTokens as isConnected };
+/**
+ * POST /connections/obsidian/connect  { apiKey: "...", baseUrl?: "https://..." }
+ * Stores the API key and verifies it by calling GET /vault/.
+ */
+export async function handleObsidianConnect(body) {
+    let apiKey;
+    let baseUrl = DEFAULT_BASE_URL;
+    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. Find it in Obsidian → Local REST API plugin settings.",
+                }),
+            };
+        }
+        apiKey = parsed.apiKey.trim();
+        if (typeof parsed.baseUrl === "string" && parsed.baseUrl.trim() !== "") {
+            baseUrl = parsed.baseUrl.trim();
+        }
+    }
+    catch {
+        return {
+            status: 400,
+            contentType: "application/json",
+            body: JSON.stringify({ ok: false, error: "Invalid JSON body" }),
+        };
+    }
+    try {
+        const res = await undiciFetch(`${baseUrl}/vault/`, {
+            dispatcher: tlsAgent,
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                Accept: "application/json",
+            },
+        });
+        if (!res.ok) {
+            return {
+                status: 401,
+                contentType: "application/json",
+                body: JSON.stringify({
+                    ok: false,
+                    error: "API key rejected by Obsidian plugin — check the key in plugin settings",
+                }),
+            };
+        }
+        const tokens = {
+            apiKey,
+            baseUrl,
+            connected_at: new Date().toISOString(),
+        };
+        saveTokens(tokens);
+        resetObsidianConnector();
+        return {
+            status: 200,
+            contentType: "application/json",
+            body: JSON.stringify({
+                ok: true,
+                baseUrl,
+                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/obsidian/test
+ * Verifies stored API key is still valid.
+ */
+export async function handleObsidianTest() {
+    const tokens = loadTokens();
+    if (!tokens) {
+        return {
+            status: 400,
+            contentType: "application/json",
+            body: JSON.stringify({ ok: false, error: "Obsidian not connected" }),
+        };
+    }
+    try {
+        const connector = getObsidianConnector();
+        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/obsidian
+ * Removes stored API key.
+ */
+export function handleObsidianDisconnect() {
+    clearTokens();
+    resetObsidianConnector();
+    return {
+        status: 200,
+        contentType: "application/json",
+        body: JSON.stringify({ ok: true }),
+    };
+}
+//# sourceMappingURL=obsidian.js.map

package/dist/connectors/obsidian.js.map

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

package/dist/connectors/paystack.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Paystack connector — payment gateway dominant in Nigeria, Ghana, Kenya,
+ * South Africa, and Côte d'Ivoire.
+ *
+ * Auth: Bearer token using secret key.
+ *   - Env var: PAYSTACK_SECRET_KEY
+ *   - Stored: getSecretJsonSync("paystack") → PaystackTokens
+ *
+ * Tools: initializeTransaction, verifyTransaction, listTransactions,
+ *        getTransaction, chargeAuthorization, createCustomer, getCustomer,
+ *        listCustomers, createTransferRecipient, initiateTransfer, listBanks
+ *
+ * Webhook: verifyPaystackWebhook — HMAC-SHA512 over raw body with secret key.
+ *
+ * Extends BaseConnector for unified auth, retry, rate-limit, error handling.
+ */
+import { type AuthContext, BaseConnector, type ConnectorError, type ConnectorStatus } from "./baseConnector.js";
+export interface PaystackTokens {
+    secretKey: string;
+    businessName?: string;
+    connected_at: string;
+}
+export interface PaystackTransaction {
+    id: number;
+    domain: string;
+    status: string;
+    reference: string;
+    amount: number;
+    currency: string;
+    paid_at: string | null;
+    customer: {
+        email: string;
+    };
+    authorization: {
+        authorization_code: string;
+        card_type: string;
+        bank: string;
+        last4: string;
+        exp_month: string;
+        exp_year: string;
+    };
+}
+export interface PaystackCustomer {
+    id: number;
+    email: string;
+    customer_code: string;
+    first_name: string | null;
+    last_name: string | null;
+    phone: string | null;
+    createdAt: string;
+}
+export interface PaystackTransfer {
+    id: number;
+    amount: number;
+    currency: string;
+    recipient: string;
+    status: string;
+    transfer_code: string;
+    reason: string | null;
+}
+export interface PaystackInitResult {
+    authorization_url: string;
+    access_code: string;
+    reference: string;
+}
+export interface PaystackListResult<T> {
+    data: T[];
+    meta?: {
+        total?: number;
+        skipped?: number;
+        perPage?: number;
+        page?: number;
+    };
+}
+export declare class PaystackConnector extends BaseConnector {
+    readonly providerName = "paystack";
+    private tokens;
+    protected getOAuthConfig(): null;
+    authenticate(): Promise<AuthContext>;
+    healthCheck(): Promise<{
+        ok: boolean;
+        error?: ConnectorError;
+    }>;
+    normalizeError(error: unknown): ConnectorError;
+    getStatus(): ConnectorStatus;
+    initializeTransaction(email: string, amountKobo: number, params?: {
+        currency?: string;
+        reference?: string;
+        callbackUrl?: string;
+        metadata?: unknown;
+    }): Promise<PaystackInitResult>;
+    verifyTransaction(reference: string): Promise<PaystackTransaction>;
+    listTransactions(params?: {
+        perPage?: number;
+        page?: number;
+        from?: string;
+        to?: string;
+        status?: string;
+    }): Promise<PaystackListResult<PaystackTransaction>>;
+    getTransaction(id: number): Promise<PaystackTransaction>;
+    chargeAuthorization(authorizationCode: string, email: string, amountKobo: number, params?: {
+        currency?: string;
+        reference?: string;
+    }): Promise<PaystackTransaction>;
+    createCustomer(email: string, params?: {
+        firstName?: string;
+        lastName?: string;
+        phone?: string;
+    }): Promise<PaystackCustomer>;
+    getCustomer(emailOrCode: string): Promise<PaystackCustomer>;
+    listCustomers(params?: {
+        perPage?: number;
+        page?: number;
+    }): Promise<PaystackListResult<PaystackCustomer>>;
+    createTransferRecipient(type: string, name: string, accountNumber: string, bankCode: string, currency?: string): Promise<{
+        recipient_code: string;
+        id: number;
+    }>;
+    initiateTransfer(source: string, amountKobo: number, recipient: string, reason?: string): Promise<PaystackTransfer>;
+    listBanks(country?: string): Promise<{
+        id: number;
+        name: string;
+        code: string;
+        country: string;
+    }[]>;
+    private buildHeaders;
+    private throwFromPaystackResponse;
+}
+/**
+ * Verify a Paystack webhook event.
+ *
+ * @param rawBody    Raw request body bytes (Buffer or string)
+ * @param signature  Value of the `x-paystack-signature` header
+ * @param secretKey  Paystack secret key used to sign events
+ * @returns true if the signature matches, false otherwise
+ */
+export declare function verifyPaystackWebhook(rawBody: Buffer | string, signature: string, secretKey: string): boolean;
+export declare function loadTokens(): PaystackTokens | null;
+export declare function saveTokens(tokens: PaystackTokens): void;
+export declare function clearTokens(): void;
+export declare function getPaystackConnector(): PaystackConnector;
+export { getPaystackConnector as paystack };
+export interface ConnectorHandlerResult {
+    status: number;
+    body: string;
+    contentType?: string;
+}
+/**
+ * POST /connections/paystack/connect  { secretKey }
+ */
+export declare function handlePaystackConnect(body: string): Promise<ConnectorHandlerResult>;
+/**
+ * POST /connections/paystack/test
+ */
+export declare function handlePaystackTest(): Promise<ConnectorHandlerResult>;
+/**
+ * DELETE /connections/paystack
+ */
+export declare function handlePaystackDisconnect(): ConnectorHandlerResult;