@tinybirdco/sdk 0.0.3 → 0.0.6

package/dist/api/local.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Local Tinybird container API client
+ * For use with tinybird-local Docker image
+ */
+/**
+ * Tokens returned by the local /tokens endpoint
+ */
+export interface LocalTokens {
+    /** User token for user-level operations */
+    user_token: string;
+    /** Admin token for admin operations like listing workspaces */
+    admin_token: string;
+    /** Default workspace admin token */
+    workspace_admin_token: string;
+}
+/**
+ * Workspace info from local Tinybird
+ */
+export interface LocalWorkspace {
+    /** Workspace ID */
+    id: string;
+    /** Workspace name */
+    name: string;
+    /** Workspace token */
+    token: string;
+}
+/**
+ * Error thrown when local container is not running
+ */
+export declare class LocalNotRunningError extends Error {
+    constructor();
+}
+/**
+ * Error thrown by local API operations
+ */
+export declare class LocalApiError extends Error {
+    readonly status?: number | undefined;
+    readonly body?: unknown | undefined;
+    constructor(message: string, status?: number | undefined, body?: unknown | undefined);
+}
+/**
+ * Check if local Tinybird container is running
+ *
+ * @returns true if container is running and healthy
+ */
+export declare function isLocalRunning(): Promise<boolean>;
+/**
+ * Get tokens from local Tinybird container
+ *
+ * @returns Local tokens
+ * @throws LocalNotRunningError if container is not running
+ */
+export declare function getLocalTokens(): Promise<LocalTokens>;
+/**
+ * List workspaces in local Tinybird
+ *
+ * @param adminToken - Admin token from getLocalTokens()
+ * @returns List of workspaces with their info
+ */
+export declare function listLocalWorkspaces(adminToken: string): Promise<{
+    workspaces: LocalWorkspace[];
+    organizationId?: string;
+}>;
+/**
+ * Create a workspace in local Tinybird
+ *
+ * @param userToken - User token from getLocalTokens()
+ * @param workspaceName - Name for the new workspace
+ * @param organizationId - Organization ID to assign workspace to
+ * @returns Created workspace info
+ */
+export declare function createLocalWorkspace(userToken: string, workspaceName: string, organizationId?: string): Promise<LocalWorkspace>;
+/**
+ * Get or create a workspace in local Tinybird
+ *
+ * @param tokens - Tokens from getLocalTokens()
+ * @param workspaceName - Name of the workspace to get or create
+ * @returns Workspace info and whether it was newly created
+ */
+export declare function getOrCreateLocalWorkspace(tokens: LocalTokens, workspaceName: string): Promise<{
+    workspace: LocalWorkspace;
+    wasCreated: boolean;
+}>;
+/**
+ * Get workspace name for local mode based on git branch or path
+ *
+ * @param tinybirdBranch - Sanitized git branch name (or null if not in git)
+ * @param cwd - Current working directory (used for hash if no branch)
+ * @returns Workspace name to use
+ */
+export declare function getLocalWorkspaceName(tinybirdBranch: string | null, cwd: string): string;
+//# sourceMappingURL=local.d.ts.map

package/dist/api/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/api/local.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAcD;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;;CAQ9C;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAGpB,MAAM,CAAC,EAAE,MAAM;aACf,IAAI,CAAC,EAAE,OAAO;gBAF9B,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,IAAI,CAAC,EAAE,OAAO,YAAA;CAKjC;AAED;;;;GAIG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAUvD;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CA+B3D;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,UAAU,EAAE,cAAc,EAAE,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA0BpE;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC,CAkCzB;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,WAAW,EACnB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,SAAS,EAAE,cAAc,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC,CA4B7D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,MAAM,GAAG,IAAI,EAC7B,GAAG,EAAE,MAAM,GACV,MAAM,CAQR"}

package/dist/api/local.js

@@ -0,0 +1,176 @@
+/**
+ * Local Tinybird container API client
+ * For use with tinybird-local Docker image
+ */
+import * as crypto from "crypto";
+import { LOCAL_BASE_URL } from "../cli/config.js";
+/**
+ * Error thrown when local container is not running
+ */
+export class LocalNotRunningError extends Error {
+    constructor() {
+        super(`Tinybird local is not running. Start it with:\n` +
+            `docker run -d -p 7181:7181 --name tinybird-local tinybirdco/tinybird-local:latest`);
+        this.name = "LocalNotRunningError";
+    }
+}
+/**
+ * Error thrown by local API operations
+ */
+export class LocalApiError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.status = status;
+        this.body = body;
+        this.name = "LocalApiError";
+    }
+}
+/**
+ * Check if local Tinybird container is running
+ *
+ * @returns true if container is running and healthy
+ */
+export async function isLocalRunning() {
+    try {
+        const response = await fetch(`${LOCAL_BASE_URL}/tokens`, {
+            method: "GET",
+            signal: AbortSignal.timeout(5000),
+        });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get tokens from local Tinybird container
+ *
+ * @returns Local tokens
+ * @throws LocalNotRunningError if container is not running
+ */
+export async function getLocalTokens() {
+    try {
+        const response = await fetch(`${LOCAL_BASE_URL}/tokens`, {
+            method: "GET",
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!response.ok) {
+            throw new LocalApiError(`Failed to get local tokens: ${response.status} ${response.statusText}`, response.status);
+        }
+        const tokens = (await response.json());
+        // Validate response structure
+        if (!tokens.user_token || !tokens.admin_token || !tokens.workspace_admin_token) {
+            throw new LocalApiError("Invalid tokens response from local Tinybird - missing required fields");
+        }
+        return tokens;
+    }
+    catch (error) {
+        if (error instanceof LocalApiError) {
+            throw error;
+        }
+        // Connection error - container not running
+        throw new LocalNotRunningError();
+    }
+}
+/**
+ * List workspaces in local Tinybird
+ *
+ * @param adminToken - Admin token from getLocalTokens()
+ * @returns List of workspaces with their info
+ */
+export async function listLocalWorkspaces(adminToken) {
+    const url = `${LOCAL_BASE_URL}/v1/user/workspaces?with_organization=true&token=${adminToken}`;
+    const response = await fetch(url, {
+        method: "GET",
+    });
+    if (!response.ok) {
+        const body = await response.text();
+        throw new LocalApiError(`Failed to list local workspaces: ${response.status} ${response.statusText}`, response.status, body);
+    }
+    const data = (await response.json());
+    return {
+        workspaces: data.workspaces.map((ws) => ({
+            id: ws.id,
+            name: ws.name,
+            token: ws.token,
+        })),
+        organizationId: data.organization_id,
+    };
+}
+/**
+ * Create a workspace in local Tinybird
+ *
+ * @param userToken - User token from getLocalTokens()
+ * @param workspaceName - Name for the new workspace
+ * @param organizationId - Organization ID to assign workspace to
+ * @returns Created workspace info
+ */
+export async function createLocalWorkspace(userToken, workspaceName, organizationId) {
+    const url = `${LOCAL_BASE_URL}/v1/workspaces`;
+    const formData = new URLSearchParams();
+    formData.append("name", workspaceName);
+    if (organizationId) {
+        formData.append("assign_to_organization_id", organizationId);
+    }
+    const response = await fetch(url, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${userToken}`,
+            "Content-Type": "application/x-www-form-urlencoded",
+        },
+        body: formData.toString(),
+    });
+    if (!response.ok) {
+        const responseBody = await response.text();
+        throw new LocalApiError(`Failed to create local workspace: ${response.status} ${response.statusText}`, response.status, responseBody);
+    }
+    const data = (await response.json());
+    return {
+        id: data.id,
+        name: data.name,
+        token: data.token,
+    };
+}
+/**
+ * Get or create a workspace in local Tinybird
+ *
+ * @param tokens - Tokens from getLocalTokens()
+ * @param workspaceName - Name of the workspace to get or create
+ * @returns Workspace info and whether it was newly created
+ */
+export async function getOrCreateLocalWorkspace(tokens, workspaceName) {
+    // List existing workspaces
+    const { workspaces, organizationId } = await listLocalWorkspaces(tokens.admin_token);
+    // Check if workspace already exists
+    const existing = workspaces.find((ws) => ws.name === workspaceName);
+    if (existing) {
+        return { workspace: existing, wasCreated: false };
+    }
+    // Create new workspace
+    await createLocalWorkspace(tokens.user_token, workspaceName, organizationId);
+    // Fetch the workspace again to get the token (create response may not include it)
+    const { workspaces: updatedWorkspaces } = await listLocalWorkspaces(tokens.admin_token);
+    const newWorkspace = updatedWorkspaces.find((ws) => ws.name === workspaceName);
+    if (!newWorkspace) {
+        throw new LocalApiError(`Created workspace '${workspaceName}' but could not find it in workspace list`);
+    }
+    return { workspace: newWorkspace, wasCreated: true };
+}
+/**
+ * Get workspace name for local mode based on git branch or path
+ *
+ * @param tinybirdBranch - Sanitized git branch name (or null if not in git)
+ * @param cwd - Current working directory (used for hash if no branch)
+ * @returns Workspace name to use
+ */
+export function getLocalWorkspaceName(tinybirdBranch, cwd) {
+    if (tinybirdBranch) {
+        return tinybirdBranch;
+    }
+    // No branch detected - use hash of path like Python implementation
+    const hash = crypto.createHash("sha256").update(cwd).digest("hex");
+    return `Build_${hash.substring(0, 16)}`;
+}
+//# sourceMappingURL=local.js.map

package/dist/api/local.js.map

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

package/dist/api/local.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=local.test.d.ts.map

package/dist/api/local.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.test.d.ts","sourceRoot":"","sources":["../../src/api/local.test.ts"],"names":[],"mappings":""}

package/dist/api/local.test.js

@@ -0,0 +1,182 @@
+import { describe, it, expect, beforeAll, afterEach, afterAll } from "vitest";
+import { setupServer } from "msw/node";
+import { http, HttpResponse } from "msw";
+import { getLocalTokens, listLocalWorkspaces, createLocalWorkspace, getOrCreateLocalWorkspace, isLocalRunning, getLocalWorkspaceName, LocalNotRunningError, LocalApiError, } from "./local.js";
+import { LOCAL_BASE_URL } from "../cli/config.js";
+const server = setupServer();
+beforeAll(() => server.listen({ onUnhandledRequest: "error" }));
+afterEach(() => server.resetHandlers());
+afterAll(() => server.close());
+describe("Local API", () => {
+    describe("isLocalRunning", () => {
+        it("returns true when local container is running", async () => {
+            server.use(http.get(`${LOCAL_BASE_URL}/tokens`, () => {
+                return HttpResponse.json({
+                    user_token: "user-token",
+                    admin_token: "admin-token",
+                    workspace_admin_token: "workspace-token",
+                });
+            }));
+            const result = await isLocalRunning();
+            expect(result).toBe(true);
+        });
+        it("returns false when local container is not running", async () => {
+            server.use(http.get(`${LOCAL_BASE_URL}/tokens`, () => {
+                return HttpResponse.error();
+            }));
+            const result = await isLocalRunning();
+            expect(result).toBe(false);
+        });
+    });
+    describe("getLocalTokens", () => {
+        it("returns tokens from local container", async () => {
+            server.use(http.get(`${LOCAL_BASE_URL}/tokens`, () => {
+                return HttpResponse.json({
+                    user_token: "user-token-123",
+                    admin_token: "admin-token-456",
+                    workspace_admin_token: "workspace-token-789",
+                });
+            }));
+            const tokens = await getLocalTokens();
+            expect(tokens.user_token).toBe("user-token-123");
+            expect(tokens.admin_token).toBe("admin-token-456");
+            expect(tokens.workspace_admin_token).toBe("workspace-token-789");
+        });
+        it("throws LocalNotRunningError when container is not running", async () => {
+            server.use(http.get(`${LOCAL_BASE_URL}/tokens`, () => {
+                return HttpResponse.error();
+            }));
+            await expect(getLocalTokens()).rejects.toThrow(LocalNotRunningError);
+        });
+        it("throws LocalApiError when response is invalid", async () => {
+            server.use(http.get(`${LOCAL_BASE_URL}/tokens`, () => {
+                return HttpResponse.json({
+                    // Missing required fields
+                    user_token: "user-token",
+                });
+            }));
+            await expect(getLocalTokens()).rejects.toThrow(LocalApiError);
+        });
+    });
+    describe("listLocalWorkspaces", () => {
+        it("returns list of workspaces", async () => {
+            server.use(http.get(`${LOCAL_BASE_URL}/v1/user/workspaces`, () => {
+                return HttpResponse.json({
+                    organization_id: "org-123",
+                    workspaces: [
+                        { id: "ws-1", name: "Workspace1", token: "token-1" },
+                        { id: "ws-2", name: "Workspace2", token: "token-2" },
+                    ],
+                });
+            }));
+            const result = await listLocalWorkspaces("admin-token");
+            expect(result.organizationId).toBe("org-123");
+            expect(result.workspaces).toHaveLength(2);
+            expect(result.workspaces[0]).toEqual({
+                id: "ws-1",
+                name: "Workspace1",
+                token: "token-1",
+            });
+        });
+        it("throws LocalApiError on failure", async () => {
+            server.use(http.get(`${LOCAL_BASE_URL}/v1/user/workspaces`, () => {
+                return new HttpResponse("Not found", { status: 404 });
+            }));
+            await expect(listLocalWorkspaces("admin-token")).rejects.toThrow(LocalApiError);
+        });
+    });
+    describe("createLocalWorkspace", () => {
+        it("creates a new workspace", async () => {
+            server.use(http.post(`${LOCAL_BASE_URL}/v1/workspaces`, async ({ request }) => {
+                const formData = await request.text();
+                const params = new URLSearchParams(formData);
+                return HttpResponse.json({
+                    id: "new-ws-id",
+                    name: params.get("name"),
+                    token: "new-ws-token",
+                });
+            }));
+            const result = await createLocalWorkspace("user-token", "TestWorkspace");
+            expect(result.id).toBe("new-ws-id");
+            expect(result.name).toBe("TestWorkspace");
+            expect(result.token).toBe("new-ws-token");
+        });
+        it("throws LocalApiError on failure", async () => {
+            server.use(http.post(`${LOCAL_BASE_URL}/v1/workspaces`, () => {
+                return new HttpResponse("Server error", { status: 500 });
+            }));
+            await expect(createLocalWorkspace("user-token", "TestWorkspace")).rejects.toThrow(LocalApiError);
+        });
+    });
+    describe("getOrCreateLocalWorkspace", () => {
+        const tokens = {
+            user_token: "user-token",
+            admin_token: "admin-token",
+            workspace_admin_token: "default-token",
+        };
+        it("returns existing workspace if found", async () => {
+            server.use(http.get(`${LOCAL_BASE_URL}/v1/user/workspaces`, () => {
+                return HttpResponse.json({
+                    organization_id: "org-123",
+                    workspaces: [
+                        { id: "existing-ws", name: "MyWorkspace", token: "existing-token" },
+                    ],
+                });
+            }));
+            const result = await getOrCreateLocalWorkspace(tokens, "MyWorkspace");
+            expect(result.wasCreated).toBe(false);
+            expect(result.workspace.name).toBe("MyWorkspace");
+            expect(result.workspace.token).toBe("existing-token");
+        });
+        it("creates new workspace if not found", async () => {
+            let createCalled = false;
+            server.use(http.get(`${LOCAL_BASE_URL}/v1/user/workspaces`, () => {
+                // Return different response based on whether create was called
+                if (createCalled) {
+                    return HttpResponse.json({
+                        organization_id: "org-123",
+                        workspaces: [
+                            { id: "new-ws", name: "NewWorkspace", token: "new-token" },
+                        ],
+                    });
+                }
+                return HttpResponse.json({
+                    organization_id: "org-123",
+                    workspaces: [], // Empty initially
+                });
+            }), http.post(`${LOCAL_BASE_URL}/v1/workspaces`, () => {
+                createCalled = true;
+                return HttpResponse.json({
+                    id: "new-ws",
+                    name: "NewWorkspace",
+                    token: "new-token",
+                });
+            }));
+            const result = await getOrCreateLocalWorkspace(tokens, "NewWorkspace");
+            expect(result.wasCreated).toBe(true);
+            expect(result.workspace.name).toBe("NewWorkspace");
+            expect(result.workspace.token).toBe("new-token");
+        });
+    });
+    describe("getLocalWorkspaceName", () => {
+        it("uses branch name when available", () => {
+            const name = getLocalWorkspaceName("feature_branch", "/some/path");
+            expect(name).toBe("feature_branch");
+        });
+        it("uses hash-based name when no branch", () => {
+            const name = getLocalWorkspaceName(null, "/some/path");
+            expect(name).toMatch(/^Build_[a-f0-9]{16}$/);
+        });
+        it("generates consistent hash for same path", () => {
+            const name1 = getLocalWorkspaceName(null, "/same/path");
+            const name2 = getLocalWorkspaceName(null, "/same/path");
+            expect(name1).toBe(name2);
+        });
+        it("generates different hash for different paths", () => {
+            const name1 = getLocalWorkspaceName(null, "/path/one");
+            const name2 = getLocalWorkspaceName(null, "/path/two");
+            expect(name1).not.toBe(name2);
+        });
+    });
+});
+//# sourceMappingURL=local.test.js.map

package/dist/api/local.test.js.map

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

package/dist/api/resources.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Tinybird Resources API client
+ * Functions to list and fetch datasources and pipes from a workspace
+ */
+import type { WorkspaceApiConfig } from "./workspaces.js";
+/**
+ * Error thrown by resource API operations
+ */
+export declare class ResourceApiError extends Error {
+    readonly status: number;
+    readonly endpoint: string;
+    readonly body?: unknown | undefined;
+    constructor(message: string, status: number, endpoint: string, body?: unknown | undefined);
+}
+/**
+ * Column information from Tinybird API
+ */
+export interface DatasourceColumn {
+    /** Column name */
+    name: string;
+    /** ClickHouse type (e.g., "String", "DateTime", "Nullable(String)") */
+    type: string;
+    /** JSON path for JSON extraction */
+    jsonpath?: string;
+    /** Default value expression */
+    default?: string;
+    /** Codec for compression */
+    codec?: string;
+}
+/**
+ * Engine information from Tinybird API
+ */
+export interface DatasourceEngine {
+    /** Engine type (e.g., "MergeTree", "ReplacingMergeTree") */
+    type: string;
+    /** Sorting key columns */
+    sorting_key?: string;
+    /** Partition key expression */
+    partition_key?: string;
+    /** Primary key columns */
+    primary_key?: string;
+    /** TTL expression */
+    ttl?: string;
+    /** Version column (ReplacingMergeTree) */
+    ver?: string;
+    /** Sign column (CollapsingMergeTree) */
+    sign?: string;
+    /** Version column (VersionedCollapsingMergeTree) */
+    version?: string;
+    /** Summing columns (SummingMergeTree) */
+    summing_columns?: string;
+}
+/**
+ * Full datasource information from Tinybird API
+ */
+export interface DatasourceInfo {
+    /** Datasource name */
+    name: string;
+    /** Human-readable description */
+    description?: string;
+    /** Column definitions */
+    columns: DatasourceColumn[];
+    /** Engine configuration */
+    engine: DatasourceEngine;
+}
+/**
+ * Node information from a pipe
+ */
+export interface PipeNode {
+    /** Node name */
+    name: string;
+    /** SQL query */
+    sql: string;
+    /** Node description */
+    description?: string;
+}
+/**
+ * Parameter information from a pipe
+ */
+export interface PipeParam {
+    /** Parameter name */
+    name: string;
+    /** ClickHouse type */
+    type: string;
+    /** Default value */
+    default?: string | number;
+    /** Whether the parameter is required */
+    required: boolean;
+    /** Parameter description */
+    description?: string;
+}
+/**
+ * Pipe type classification
+ */
+export type PipeType = "endpoint" | "materialized" | "copy" | "pipe";
+/**
+ * Full pipe information from Tinybird API
+ */
+export interface PipeInfo {
+    /** Pipe name */
+    name: string;
+    /** Human-readable description */
+    description?: string;
+    /** Nodes in the pipe */
+    nodes: PipeNode[];
+    /** Query parameters */
+    params: PipeParam[];
+    /** Pipe type */
+    type: PipeType;
+    /** Endpoint configuration (if type is endpoint) */
+    endpoint?: {
+        enabled: boolean;
+        cache?: {
+            enabled: boolean;
+            ttl?: number;
+        };
+    };
+    /** Materialized view configuration (if type is materialized) */
+    materialized?: {
+        datasource: string;
+    };
+    /** Copy pipe configuration (if type is copy) */
+    copy?: {
+        target_datasource: string;
+        copy_schedule?: string;
+        copy_mode?: "append" | "replace";
+    };
+    /** Output column schema (for endpoints) */
+    output_columns: DatasourceColumn[];
+}
+/**
+ * List all datasources in the workspace
+ *
+ * @param config - API configuration
+ * @returns Array of datasource names
+ */
+export declare function listDatasources(config: WorkspaceApiConfig): Promise<string[]>;
+/**
+ * Get detailed information about a specific datasource
+ *
+ * @param config - API configuration
+ * @param name - Datasource name
+ * @returns Datasource information including schema and engine
+ */
+export declare function getDatasource(config: WorkspaceApiConfig, name: string): Promise<DatasourceInfo>;
+/**
+ * List all pipes in the workspace
+ *
+ * @param config - API configuration
+ * @returns Array of pipe names
+ */
+export declare function listPipes(config: WorkspaceApiConfig): Promise<string[]>;
+/**
+ * Get detailed information about a specific pipe
+ *
+ * @param config - API configuration
+ * @param name - Pipe name
+ * @returns Pipe information including nodes, params, and output schema
+ */
+export declare function getPipe(config: WorkspaceApiConfig, name: string): Promise<PipeInfo>;
+/**
+ * Fetch all resources from a workspace
+ *
+ * @param config - API configuration
+ * @returns All datasources and pipes with full details
+ */
+export declare function fetchAllResources(config: WorkspaceApiConfig): Promise<{
+    datasources: DatasourceInfo[];
+    pipes: PipeInfo[];
+}>;
+/**
+ * Check if a workspace has any resources
+ *
+ * @param config - API configuration
+ * @returns True if the workspace has at least one datasource or pipe
+ */
+export declare function hasResources(config: WorkspaceApiConfig): Promise<boolean>;
+//# sourceMappingURL=resources.d.ts.map

package/dist/api/resources.d.ts.map

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