@polardbx/pxbaas-client 0.0.0-stage → 0.1.0-beta.2

package/dist/drivers/functions.driver.js

@@ -0,0 +1,173 @@
+/**
+ * Functions Driver - Edge Functions Management API client
+ *
+ * Endpoints:
+ * - POST /v1/projects/{ref}/functions/deploy?slug={slug} - Deploy function
+ * - GET /v1/projects/{ref}/functions - List functions
+ * - GET /v1/projects/{ref}/functions/{slug} - Get function details
+ * - DELETE /v1/projects/{ref}/functions/{slug} - Delete function
+ */
+import axios from 'axios';
+import FormData from 'form-data';
+import { readFile } from 'node:fs/promises';
+import { basename } from 'node:path';
+export class FunctionsDriver {
+    client;
+    serviceRoleKey;
+    tenantId;
+    projectRef;
+    constructor(options) {
+        this.serviceRoleKey = options.serviceRoleKey;
+        this.tenantId = options.tenantId;
+        this.projectRef = options.projectRef ?? 'default';
+        this.client = axios.create({
+            baseURL: `${options.endpoint}/v1/projects/${this.projectRef}`,
+            timeout: options.timeout ?? 60000, // 60s for deploy
+            headers: {
+                'Authorization': `Bearer ${this.serviceRoleKey}`,
+            },
+        });
+    }
+    getHeaders() {
+        const headers = {
+            'Authorization': `Bearer ${this.serviceRoleKey}`,
+        };
+        // Note: Do NOT include apikey header for Functions Management API
+        // Kong will inject X-Tenant-Id from the JWT
+        return headers;
+    }
+    handleError(error) {
+        if (axios.isAxiosError(error)) {
+            const axiosError = error;
+            const status = axiosError.response?.status;
+            const data = axiosError.response?.data;
+            let message = axiosError.message;
+            if (status === 401) {
+                message = 'Authentication failed. Please check your service_role key and run "pxbaas login" again.';
+            }
+            else if (status === 403) {
+                message = 'Permission denied. Functions Management API requires service_role key.';
+            }
+            else if (status === 404) {
+                message = 'Function not found. Please check the slug and try again.';
+            }
+            else if (status === 400) {
+                // Common issue: metadata part missing or incorrectly formatted
+                const errorMsg = data?.message;
+                if (typeof errorMsg === 'string' && errorMsg.includes('metadata')) {
+                    message = 'Invalid metadata format. Ensure metadata is passed as a form field without filename.';
+                }
+                else {
+                    message = typeof errorMsg === 'string' ? errorMsg : 'Bad request';
+                }
+            }
+            else if (data?.message) {
+                message = typeof data.message === 'string' ? data.message : String(data.message);
+            }
+            throw new Error(`Functions API error (${status ?? 'unknown'}): ${message}`);
+        }
+        throw error;
+    }
+    /**
+     * Deploy a function
+     *
+     * IMPORTANT: metadata must be passed as a form field WITHOUT filename,
+     * not as a file upload. This is a common source of 400 errors.
+     */
+    async deploy(options) {
+        try {
+            const formData = new FormData();
+            // Prepare metadata (MUST be without filename)
+            const metadata = {
+                name: options.slug,
+                entrypoint_path: options.entrypointPath ?? 'index.ts',
+                verify_jwt: options.verifyJwt ?? true,
+            };
+            // Add metadata as a form field (NOT as a file)
+            formData.append('metadata', JSON.stringify(metadata), {
+                contentType: 'application/json',
+                // IMPORTANT: Do NOT set filename here
+            });
+            // Add files
+            for (const file of options.files) {
+                const content = file.content ?? await readFile(file.path, 'utf-8');
+                // Preserve nested paths (assets/style.css); fall back to basename.
+                const filename = file.relativePath ?? basename(file.path);
+                formData.append('file', content, {
+                    // form-data basenames a custom `filename` (lib/form_data.js
+                    // `_getContentDisposition`), which flattens nested artifact paths such as
+                    // `frontend/dist/index.html` and makes the Management API reject the
+                    // candidate. `filepath` is normalized instead, so the nesting survives.
+                    // Both options serialize to the same `Content-Disposition` header.
+                    ...(filename.includes('/')
+                        ? { filepath: filename }
+                        : { filename }),
+                    contentType: this.getContentType(filename),
+                });
+            }
+            const response = await this.client.post(`/functions/deploy`, formData, {
+                headers: {
+                    ...this.getHeaders(),
+                    ...formData.getHeaders(),
+                },
+                params: {
+                    slug: options.slug,
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    /**
+     * List all deployed functions
+     */
+    async list() {
+        try {
+            const response = await this.client.get('/functions', { headers: this.getHeaders() });
+            return response.data ?? [];
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    /**
+     * Get function details
+     */
+    async get(slug) {
+        try {
+            const response = await this.client.get(`/functions/${slug}`, { headers: this.getHeaders() });
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    /**
+     * Delete a function
+     */
+    async delete(slug) {
+        try {
+            await this.client.delete(`/functions/${slug}`, { headers: this.getHeaders() });
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    /**
+     * Get content type based on file extension
+     */
+    getContentType(filename) {
+        const ext = filename.split('.').pop()?.toLowerCase();
+        const contentTypes = {
+            'ts': 'application/typescript',
+            'js': 'application/javascript',
+            'json': 'application/json',
+            'md': 'text/markdown',
+            'txt': 'text/plain',
+        };
+        return contentTypes[ext ?? ''] ?? 'application/octet-stream';
+    }
+}
+//# sourceMappingURL=functions.driver.js.map

package/dist/drivers/functions.driver.js.map

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

package/dist/drivers/meta.driver.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Meta API Driver - PolarDB-X BaaS 元数据 API 客户端
+ *
+ * Endpoints:
+ * - POST /pg/query - Execute SQL query
+ * - GET /pg/tables - List tables
+ * - GET /pg/tables/{table}/columns - Get table columns
+ * - GET /pg/tables/{table}/indexes - Get table indexes
+ * - GET /pg/types - Get data types
+ */
+export interface QueryResult {
+    rows: Record<string, unknown>[];
+    rowCount: number;
+    fields?: Array<{
+        name: string;
+        dataType: string;
+    }>;
+}
+export interface TableColumn {
+    name: string;
+    dataType: string;
+    isNullable: boolean;
+    defaultValue: string | null;
+    isPrimaryKey: boolean;
+    comment?: string;
+}
+export interface TableIndex {
+    name: string;
+    columns: string[];
+    isUnique: boolean;
+    isPrimary: boolean;
+    type: string;
+}
+export interface TableInfo {
+    schema: string;
+    name: string;
+    type: 'table' | 'view';
+    rowCount?: number;
+    comment?: string;
+}
+export interface MetaDriverOptions {
+    endpoint: string;
+    anonKey: string;
+    serviceRoleKey?: string;
+    tenantId?: string;
+    timeout?: number;
+}
+export declare class MetaDriver {
+    private client;
+    private anonKey;
+    private serviceRoleKey?;
+    private tenantId?;
+    constructor(options: MetaDriverOptions);
+    private getHeaders;
+    private handleError;
+    /**
+     * Execute SQL query
+     */
+    query(sql: string, useServiceRole?: boolean): Promise<QueryResult>;
+    /**
+     * List all tables in the database
+     */
+    listTables(useServiceRole?: boolean, schema?: string): Promise<TableInfo[]>;
+    /**
+     * Get table columns
+     */
+    getTableColumns(tableName: string, schema?: string, useServiceRole?: boolean): Promise<TableColumn[]>;
+    /**
+     * Get table indexes
+     */
+    getTableIndexes(tableName: string, schema?: string, useServiceRole?: boolean): Promise<TableIndex[]>;
+    /**
+     * Get database data types
+     */
+    getTypes(useServiceRole?: boolean): Promise<Record<string, string>>;
+}
+//# sourceMappingURL=meta.driver.d.ts.map

package/dist/drivers/meta.driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.driver.d.ts","sourceRoot":"","sources":["../../src/drivers/meta.driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAiCD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,CAAS;gBAEd,OAAO,EAAE,iBAAiB;IActC,OAAO,CAAC,UAAU;IAkBlB,OAAO,CAAC,WAAW;IAwBnB;;OAEG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,GAAE,OAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAa/E;;OAEG;IACG,UAAU,CAAC,cAAc,GAAE,OAAc,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAoBvF;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE,MAAiB,EAAE,cAAc,GAAE,OAAc,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAuB3H;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE,MAAiB,EAAE,cAAc,GAAE,OAAc,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAmB1H;;OAEG;IACG,QAAQ,CAAC,cAAc,GAAE,OAAe,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAgBjF"}

package/dist/drivers/meta.driver.js

@@ -0,0 +1,191 @@
+/**
+ * Meta API Driver - PolarDB-X BaaS 元数据 API 客户端
+ *
+ * Endpoints:
+ * - POST /pg/query - Execute SQL query
+ * - GET /pg/tables - List tables
+ * - GET /pg/tables/{table}/columns - Get table columns
+ * - GET /pg/tables/{table}/indexes - Get table indexes
+ * - GET /pg/types - Get data types
+ */
+import axios from 'axios';
+/**
+ * PG-Meta returns BARE JSON arrays (pg-meta style), not a {data,error} envelope.
+ * Normalize either shape into a QueryResult.
+ */
+function toQueryResult(body) {
+    if (Array.isArray(body)) {
+        const rows = body;
+        return {
+            rows,
+            rowCount: rows.length,
+            fields: rows.length > 0 ? Object.keys(rows[0]).map((name) => ({ name, dataType: 'unknown' })) : [],
+        };
+    }
+    const wrapped = body;
+    if (wrapped && typeof wrapped === 'object') {
+        if (wrapped.error)
+            throw new Error(`Query failed: ${wrapped.error}`);
+        if (wrapped.data)
+            return wrapped.data;
+    }
+    return { rows: [], rowCount: 0 };
+}
+function unwrapArray(body) {
+    if (Array.isArray(body))
+        return body;
+    const wrapped = body;
+    if (wrapped && typeof wrapped === 'object') {
+        if (wrapped.error)
+            throw new Error(String(wrapped.error));
+        return wrapped.data ?? [];
+    }
+    return [];
+}
+export class MetaDriver {
+    client;
+    anonKey;
+    serviceRoleKey;
+    tenantId;
+    constructor(options) {
+        this.anonKey = options.anonKey;
+        this.serviceRoleKey = options.serviceRoleKey;
+        this.tenantId = options.tenantId;
+        this.client = axios.create({
+            baseURL: `${options.endpoint}/pg`,
+            timeout: options.timeout ?? 30000,
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+    }
+    getHeaders(useServiceRole = false) {
+        // Kong identifies the consumer via the `apikey` header (key-auth) and forwards
+        // `Authorization` downstream for JWT verification; both MUST carry the SAME key.
+        // Sending apikey=anon with Authorization=service_role makes Kong see the anon
+        // consumer, so admin-ACL routes like /pg/ return 403. Use one key for both.
+        const key = useServiceRole && this.serviceRoleKey ? this.serviceRoleKey : this.anonKey;
+        const headers = {
+            'apikey': key,
+            'Authorization': `Bearer ${key}`,
+        };
+        if (this.tenantId) {
+            headers['X-Tenant-Id'] = this.tenantId;
+        }
+        return headers;
+    }
+    handleError(error) {
+        if (axios.isAxiosError(error)) {
+            const axiosError = error;
+            const status = axiosError.response?.status;
+            const data = axiosError.response?.data;
+            let message = axiosError.message;
+            if (status === 401) {
+                message = 'Authentication failed. Please check your API keys and run "pxbaas login" again.';
+            }
+            else if (status === 403) {
+                message = 'Permission denied. You may need service_role key for this operation.';
+            }
+            else if (status === 404) {
+                message = 'Resource not found. Please check the table name and try again.';
+            }
+            else if (data?.error) {
+                message = String(data.error);
+            }
+            throw new Error(`Meta API error (${status ?? 'unknown'}): ${message}`);
+        }
+        throw error;
+    }
+    /**
+     * Execute SQL query
+     */
+    async query(sql, useServiceRole = false) {
+        try {
+            const response = await this.client.post('/query', { query: sql }, { headers: this.getHeaders(useServiceRole) });
+            return toQueryResult(response.data);
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    /**
+     * List all tables in the database
+     */
+    async listTables(useServiceRole = true, schema) {
+        try {
+            const response = await this.client.get('/tables', { headers: this.getHeaders(useServiceRole) });
+            const arr = unwrapArray(response.data);
+            const mapped = arr.map((t) => ({
+                schema: String(t.schema ?? 'public'),
+                name: String(t.name ?? t.table_name ?? ''),
+                type: (t.type === 'view' || t.table_type === 'VIEW') ? 'view' : 'table',
+                rowCount: t.live_rows_estimate != null ? Number(t.live_rows_estimate) : undefined,
+                comment: t.comment != null ? String(t.comment) : undefined,
+            }));
+            return schema ? mapped.filter((t) => t.schema === schema) : mapped;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    /**
+     * Get table columns
+     */
+    async getTableColumns(tableName, schema = 'public', useServiceRole = true) {
+        // Use information_schema via /pg/query (reliable, schema-filtered) instead of
+        // the pg-meta /tables/{schema}.{table}/columns path (404 on this deployment).
+        const sql = `SELECT column_name AS name, data_type AS dataType, ` +
+            `CASE WHEN is_nullable='YES' THEN 1 ELSE 0 END AS isNullable, ` +
+            `column_default AS defaultValue, ` +
+            `CASE WHEN column_key='PRI' THEN 1 ELSE 0 END AS isPrimaryKey, ` +
+            `column_comment AS comment ` +
+            `FROM information_schema.columns ` +
+            `WHERE table_schema='${schema.replace(/'/g, "''")}' AND table_name='${tableName.replace(/'/g, "''")}' ` +
+            `ORDER BY ordinal_position`;
+        const r = await this.query(sql, useServiceRole);
+        return r.rows.map((row) => ({
+            name: String(row.name),
+            dataType: String(row.dataType),
+            isNullable: row.isNullable === 1 || row.isNullable === true,
+            defaultValue: row.defaultValue == null ? null : String(row.defaultValue),
+            isPrimaryKey: row.isPrimaryKey === 1 || row.isPrimaryKey === true,
+            comment: row.comment != null && row.comment !== '' ? String(row.comment) : undefined,
+        }));
+    }
+    /**
+     * Get table indexes
+     */
+    async getTableIndexes(tableName, schema = 'public', useServiceRole = true) {
+        const sql = `SELECT index_name AS name, ` +
+            `GROUP_CONCAT(column_name ORDER BY seq_in_index) AS cols, ` +
+            `CASE WHEN MIN(non_unique)=0 THEN 1 ELSE 0 END AS isUnique, ` +
+            `CASE WHEN index_name='PRIMARY' THEN 1 ELSE 0 END AS isPrimary ` +
+            `FROM information_schema.statistics ` +
+            `WHERE table_schema='${schema.replace(/'/g, "''")}' AND table_name='${tableName.replace(/'/g, "''")}' ` +
+            `GROUP BY index_name`;
+        const r = await this.query(sql, useServiceRole);
+        return r.rows.map((row) => ({
+            name: String(row.name),
+            columns: row.cols != null && row.cols !== '' ? String(row.cols).split(',') : [],
+            isUnique: row.isUnique === 1 || row.isUnique === true,
+            isPrimary: row.isPrimary === 1 || row.isPrimary === true,
+            type: 'BTREE',
+        }));
+    }
+    /**
+     * Get database data types
+     */
+    async getTypes(useServiceRole = false) {
+        try {
+            const response = await this.client.get('/types', { headers: this.getHeaders(useServiceRole) });
+            if (response.data.error) {
+                throw new Error(`Get types failed: ${response.data.error}`);
+            }
+            return response.data.data ?? {};
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+}
+//# sourceMappingURL=meta.driver.js.map

package/dist/drivers/meta.driver.js.map

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

package/dist/drivers/share-links.driver.d.ts

@@ -0,0 +1,42 @@
+export type ShareLinkStatus = 'ACTIVE' | 'REVOKED' | 'EXPIRED';
+export interface ShareLink {
+    id: string;
+    mount_id: string;
+    tenant_id: string;
+    function_slug: string;
+    status: ShareLinkStatus;
+    expires_at: string;
+    max_uses: number | null;
+    used_count: number;
+    session_generation: number;
+    created_by: string | null;
+    used_at: string | null;
+    revoked_at: string | null;
+    created_at: string;
+    updated_at: string;
+}
+/** Only create returns this short-lived capability; list/get/revoke never do. */
+export interface CreatedShareLink extends ShareLink {
+    ticket: string;
+}
+export interface ShareLinksDriverOptions {
+    endpoint: string;
+    serviceRoleKey: string;
+    projectRef?: string;
+    timeout?: number;
+}
+export declare class ShareLinksDriver {
+    private readonly client;
+    constructor(options: ShareLinksDriverOptions);
+    create(functionSlug: string, options: {
+        expiresAt?: string;
+        expiresInSeconds?: number;
+        maxUses?: number;
+        tenantId?: string;
+    }): Promise<CreatedShareLink>;
+    list(functionSlug: string, tenantId?: string): Promise<ShareLink[]>;
+    get(functionSlug: string, shareId: string, tenantId?: string): Promise<ShareLink>;
+    revoke(functionSlug: string, shareId: string, tenantId?: string): Promise<ShareLink>;
+    private request;
+}
+//# sourceMappingURL=share-links.driver.d.ts.map

package/dist/drivers/share-links.driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"share-links.driver.d.ts","sourceRoot":"","sources":["../../src/drivers/share-links.driver.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAA;AAE9D,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,eAAe,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,iFAAiF;AACjF,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,OAAO,EAAE,uBAAuB;IAQtC,MAAM,CACV,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAA;QACzB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,GACA,OAAO,CAAC,gBAAgB,CAAC;IActB,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IASnE,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAUjF,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;YAU5E,OAAO;CAgBtB"}

package/dist/drivers/share-links.driver.js

@@ -0,0 +1,53 @@
+import axios from 'axios';
+export class ShareLinksDriver {
+    client;
+    constructor(options) {
+        this.client = axios.create({
+            baseURL: `${options.endpoint.replace(/\/$/, '')}/v1/projects/${options.projectRef ?? 'default'}`,
+            timeout: options.timeout ?? 30_000,
+            headers: { Authorization: `Bearer ${options.serviceRoleKey}` },
+        });
+    }
+    async create(functionSlug, options) {
+        const response = await this.request(() => this.client.post(`/functions/${encodeURIComponent(functionSlug)}/shares`, {
+            ...(options.expiresAt ? { expires_at: options.expiresAt } : {}),
+            ...(options.expiresInSeconds !== undefined
+                ? { expires_in_seconds: options.expiresInSeconds }
+                : {}),
+            ...(options.maxUses !== undefined ? { max_uses: options.maxUses } : {}),
+            ...(options.tenantId ? { tenant_id: options.tenantId } : {}),
+        }));
+        return response.data;
+    }
+    async list(functionSlug, tenantId) {
+        const response = await this.request(() => this.client.get(`/functions/${encodeURIComponent(functionSlug)}/shares`, {
+            params: tenantId ? { tenant_id: tenantId } : undefined,
+        }));
+        return response.data.shares ?? [];
+    }
+    async get(functionSlug, shareId, tenantId) {
+        const response = await this.request(() => this.client.get(`/functions/${encodeURIComponent(functionSlug)}/shares/${encodeURIComponent(shareId)}`, { params: tenantId ? { tenant_id: tenantId } : undefined }));
+        return response.data;
+    }
+    async revoke(functionSlug, shareId, tenantId) {
+        const response = await this.request(() => this.client.post(`/functions/${encodeURIComponent(functionSlug)}/shares/${encodeURIComponent(shareId)}/revoke`, tenantId ? { tenant_id: tenantId } : {}));
+        return response.data;
+    }
+    async request(operation) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                const axiosError = error;
+                const status = axiosError.response?.status;
+                const message = axiosError.response?.data?.error?.message ??
+                    axiosError.response?.data?.message ??
+                    axiosError.message;
+                throw new Error(`Share API error (${status ?? 'unknown'}): ${message}`);
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=share-links.driver.js.map

package/dist/drivers/share-links.driver.js.map

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

package/dist/drivers/storage.driver.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Storage Driver - Supabase Storage API client
+ *
+ * Endpoints:
+ * - GET /storage/v1/bucket - List buckets
+ * - GET /storage/v1/object/list/{bucket} - List objects
+ * - POST /storage/v1/object/{bucket}/{path} - Upload object
+ * - GET /storage/v1/object/{bucket}/{path} - Download object
+ * - DELETE /storage/v1/object/{bucket}/{path} - Delete object
+ * - POST /storage/v1/object/move - Move object
+ * - POST /storage/v1/object/copy - Copy object
+ */
+export interface Bucket {
+    id: string;
+    name: string;
+    public: boolean;
+    created_at: string;
+    updated_at: string;
+}
+export interface StorageObject {
+    name: string;
+    id: string;
+    bucket_id: string;
+    owner: string;
+    created_at: string;
+    updated_at: string;
+    last_accessed_at: string;
+    metadata: Record<string, unknown>;
+}
+export interface StorageDriverOptions {
+    endpoint: string;
+    serviceRoleKey: string;
+    tenantId?: string;
+    timeout?: number;
+}
+export declare class StorageDriver {
+    private client;
+    private serviceRoleKey;
+    private tenantId?;
+    constructor(options: StorageDriverOptions);
+    private getHeaders;
+    private handleError;
+    /**
+     * List all buckets
+     */
+    listBuckets(): Promise<Bucket[]>;
+    /**
+     * List objects in a bucket
+     */
+    listObjects(bucket: string, prefix?: string): Promise<StorageObject[]>;
+    /**
+     * Upload a file to storage
+     */
+    upload(bucket: string, remotePath: string, localPath: string): Promise<void>;
+    /**
+     * Download a file from storage
+     */
+    download(bucket: string, remotePath: string, localPath: string): Promise<void>;
+    /**
+     * Delete an object from storage
+     */
+    delete(bucket: string, remotePath: string): Promise<void>;
+    /**
+     * Move/rename an object
+     */
+    move(sourceBucket: string, sourcePath: string, destBucket: string, destPath: string): Promise<void>;
+    /**
+     * Copy an object
+     */
+    copy(sourceBucket: string, sourcePath: string, destBucket: string, destPath: string): Promise<void>;
+}
+//# sourceMappingURL=storage.driver.d.ts.map

package/dist/drivers/storage.driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.driver.d.ts","sourceRoot":"","sources":["../../src/drivers/storage.driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,CAAS;gBAEd,OAAO,EAAE,oBAAoB;IAczC,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,WAAW;IA0BnB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAatC;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAc5E;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBlF;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBpF;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/D;;OAEG;IACG,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBzG;;OAEG;IACG,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAgB1G"}