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

package/dist/connectors/supabase.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Supabase connector — PostgreSQL-as-a-service via PostgREST REST, Storage,
+ * Edge Functions, and RPC APIs.
+ *
+ * Auth: SUPABASE_URL + SUPABASE_SERVICE_ROLE_KEY env vars; stored as
+ *   getSecretJsonSync("supabase") → SupabaseTokens
+ *
+ * Tools: select, insert, update, upsert, delete, rpc, getSchema,
+ *        uploadFile, downloadFile, listFiles, deleteFiles, invokeEdgeFunction
+ *
+ * Extends BaseConnector for unified auth, retry, rate-limit, error handling.
+ */
+import { type AuthContext, BaseConnector, type ConnectorError, type ConnectorStatus } from "./baseConnector.js";
+export interface SupabaseTokens {
+    url: string;
+    serviceRoleKey: string;
+    anonKey?: string;
+    connected_at: string;
+}
+export interface SupabaseQueryResult<T = Record<string, unknown>> {
+    data: T[];
+    count?: number;
+}
+export interface SupabaseStorageObject {
+    name: string;
+    bucket_id: string;
+    owner: string;
+    created_at: string;
+    updated_at: string;
+    last_accessed_at: string;
+    metadata: Record<string, unknown> | null;
+}
+export interface SupabaseRpcResult<T = unknown> {
+    data: T;
+}
+export declare function loadTokens(): SupabaseTokens | null;
+export declare function saveTokens(tokens: SupabaseTokens): void;
+export declare function clearTokens(): void;
+/**
+ * Verify a Supabase database webhook signature.
+ * Supabase sends HMAC-SHA256 of the raw body in `x-supabase-webhook-secret`.
+ * Uses constant-time comparison to prevent timing attacks.
+ */
+export declare function verifySupabaseWebhook(rawBody: string | Buffer, signatureHeader: string, webhookSecret: string): boolean;
+export declare class SupabaseConnector extends BaseConnector {
+    readonly providerName = "supabase";
+    private tokens;
+    protected getOAuthConfig(): null;
+    authenticate(): Promise<AuthContext>;
+    healthCheck(): Promise<{
+        ok: boolean;
+        error?: ConnectorError;
+    }>;
+    normalizeError(error: unknown): ConnectorError;
+    getStatus(): ConnectorStatus;
+    private getTokens;
+    private buildHeaders;
+    private throwOnError;
+    select<T = Record<string, unknown>>(table: string, columns?: string, filters?: string, limit?: number, offset?: number, orderBy?: string): Promise<SupabaseQueryResult<T>>;
+    insert<T = Record<string, unknown>>(table: string, data: Record<string, unknown> | Record<string, unknown>[], returning?: boolean): Promise<SupabaseQueryResult<T>>;
+    update<T = Record<string, unknown>>(table: string, data: Record<string, unknown>, filters: string): Promise<SupabaseQueryResult<T>>;
+    upsert<T = Record<string, unknown>>(table: string, data: Record<string, unknown> | Record<string, unknown>[], onConflict?: string): Promise<SupabaseQueryResult<T>>;
+    delete<T = Record<string, unknown>>(table: string, filters: string): Promise<SupabaseQueryResult<T>>;
+    rpc<T = unknown>(functionName: string, params?: Record<string, unknown>): Promise<SupabaseRpcResult<T>>;
+    getSchema(): Promise<Record<string, unknown>>;
+    uploadFile(bucket: string, path: string, file: Buffer | string, contentType?: string): Promise<Record<string, unknown>>;
+    downloadFile(bucket: string, path: string): Promise<Buffer>;
+    listFiles(bucket: string, prefix?: string, limit?: number): Promise<SupabaseStorageObject[]>;
+    deleteFiles(bucket: string, paths: string[]): Promise<Record<string, unknown>[]>;
+    invokeEdgeFunction<T = unknown>(functionName: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
+}
+export declare function resetSupabaseConnector(): void;
+export declare function getSupabaseConnector(): SupabaseConnector;
+export { getSupabaseConnector as supabase };
+export interface ConnectorHandlerResult {
+    status: number;
+    body: string;
+    contentType?: string;
+}
+/**
+ * POST /connections/supabase/connect  { url, serviceRoleKey, anonKey? }
+ * Validates credentials by calling GET {url}/rest/v1/ (OpenAPI endpoint).
+ */
+export declare function handleSupabaseConnect(rawBody: string): Promise<ConnectorHandlerResult>;
+/**
+ * POST /connections/supabase/test
+ */
+export declare function handleSupabaseTest(): Promise<ConnectorHandlerResult>;
+/**
+ * DELETE /connections/supabase
+ */
+export declare function handleSupabaseDisconnect(): ConnectorHandlerResult;