databar-mcp-server 1.3.0

package/dist/databar-client.js

@@ -0,0 +1,377 @@
+/**
+ * Databar API Client with async polling support
+ */
+import axios from 'axios';
+const API_ROW_BATCH = 50;
+function chunkArray(arr, size) {
+    const chunks = [];
+    for (let i = 0; i < arr.length; i += size) {
+        chunks.push(arr.slice(i, i + size));
+    }
+    return chunks;
+}
+export class DatabarClient {
+    client;
+    config;
+    constructor(config) {
+        this.config = config;
+        this.client = axios.create({
+            baseURL: config.baseUrl,
+            headers: {
+                'x-apikey': config.apiKey,
+                'Content-Type': 'application/json'
+            },
+            timeout: 30000
+        });
+    }
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    handleError(error) {
+        if (axios.isAxiosError(error)) {
+            const axiosError = error;
+            const status = axiosError.response?.status;
+            const data = axiosError.response?.data;
+            if (status === 401 || status === 403) {
+                throw new Error('Invalid API key or insufficient credits. Please check your API key and account balance.');
+            }
+            if (status === 422) {
+                if (data?.detail && Array.isArray(data.detail)) {
+                    const errors = data.detail.map((d) => `${d.loc.join('.')}: ${d.msg}`).join(', ');
+                    throw new Error(`Validation error: ${errors}`);
+                }
+                throw new Error('Invalid parameters provided');
+            }
+            if (status === 404) {
+                throw new Error('Resource not found');
+            }
+            if (status === 410) {
+                throw new Error('Resource has expired. Data is only stored for 1 hour after task completion.');
+            }
+            if (status === 429) {
+                throw new Error('Rate limit exceeded. Please try again later.');
+            }
+            if (data?.error) {
+                throw new Error(data.error + (data.details ? `: ${data.details}` : ''));
+            }
+            throw new Error(`API error (${status}): ${axiosError.message}`);
+        }
+        throw new Error(`Unexpected error: ${error.message || 'Unknown error'}`);
+    }
+    async withRetry(fn, maxRetries = 3, baseDelay = 1000) {
+        let lastError;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                return await fn();
+            }
+            catch (error) {
+                lastError = error;
+                if (axios.isAxiosError(error)) {
+                    const status = error.response?.status;
+                    if (status && status >= 400 && status < 500 && status !== 429) {
+                        throw error;
+                    }
+                }
+                if (attempt === maxRetries) {
+                    throw error;
+                }
+                const delay = baseDelay * Math.pow(2, attempt);
+                await this.sleep(delay);
+            }
+        }
+        throw lastError;
+    }
+    // ============================================================================
+    // Enrichment Methods
+    // ============================================================================
+    async getAllEnrichments() {
+        try {
+            const response = await this.withRetry(() => this.client.get('/enrichments'));
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    async getEnrichmentDetails(enrichmentId) {
+        try {
+            const response = await this.withRetry(() => this.client.get(`/enrichments/${enrichmentId}`));
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    async runEnrichment(enrichmentId, params) {
+        try {
+            const payload = { params };
+            const response = await this.withRetry(() => this.client.post(`/enrichments/${enrichmentId}/run`, payload));
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    async runBulkEnrichment(enrichmentId, paramsList) {
+        try {
+            const payload = { params: paramsList };
+            const response = await this.withRetry(() => this.client.post(`/enrichments/${enrichmentId}/bulk-run`, payload));
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    async getTaskStatus(taskId) {
+        try {
+            const response = await this.withRetry(() => this.client.get(`/tasks/${taskId}`));
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    async pollTaskUntilComplete(taskId) {
+        const maxAttempts = this.config.maxPollAttempts;
+        const pollInterval = this.config.pollIntervalMs;
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            await this.sleep(pollInterval);
+            const result = await this.getTaskStatus(taskId);
+            const status = result.status.toLowerCase();
+            if (status === 'completed' || status === 'success') {
+                return result.data;
+            }
+            if (status === 'failed' || status === 'error') {
+                const errorMsg = Array.isArray(result.error)
+                    ? result.error.join('; ')
+                    : result.error;
+                throw new Error(errorMsg || 'Task failed');
+            }
+            if (status === 'gone') {
+                throw new Error('Task data has expired. Data is only stored for 1 hour after completion. Please re-run the enrichment.');
+            }
+        }
+        throw new Error(`Task timed out after ${maxAttempts * pollInterval / 1000} seconds`);
+    }
+    async runEnrichmentSync(enrichmentId, params) {
+        const runResponse = await this.runEnrichment(enrichmentId, params);
+        return await this.pollTaskUntilComplete(runResponse.task_id);
+    }
+    async runBulkEnrichmentSync(enrichmentId, paramsList) {
+        const runResponse = await this.runBulkEnrichment(enrichmentId, paramsList);
+        return await this.pollTaskUntilComplete(runResponse.task_id);
+    }
+    // ============================================================================
+    // Waterfall Methods
+    // ============================================================================
+    async getAllWaterfalls() {
+        try {
+            const response = await this.withRetry(() => this.client.get('/waterfalls'));
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    async getWaterfallDetails(identifier) {
+        try {
+            const response = await this.withRetry(() => this.client.get(`/waterfalls/${identifier}`));
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    async runWaterfall(identifier, params, enrichmentIds, emailVerifier) {
+        try {
+            if (!enrichmentIds || enrichmentIds.length === 0) {
+                const waterfall = await this.getWaterfallDetails(identifier);
+                enrichmentIds = waterfall.available_enrichments.map(e => e.id);
+            }
+            const payload = {
+                params,
+                enrichments: enrichmentIds
+            };
+            if (emailVerifier != null) {
+                payload.email_verifier = emailVerifier;
+            }
+            const response = await this.withRetry(() => this.client.post(`/waterfalls/${identifier}/run`, payload));
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    async runBulkWaterfall(identifier, paramsList, enrichmentIds, emailVerifier) {
+        try {
+            if (!enrichmentIds || enrichmentIds.length === 0) {
+                const waterfall = await this.getWaterfallDetails(identifier);
+                enrichmentIds = waterfall.available_enrichments.map(e => e.id);
+            }
+            const payload = {
+                params: paramsList,
+                enrichments: enrichmentIds
+            };
+            if (emailVerifier != null) {
+                payload.email_verifier = emailVerifier;
+            }
+            const response = await this.withRetry(() => this.client.post(`/waterfalls/${identifier}/bulk-run`, payload));
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    async runWaterfallSync(identifier, params, enrichmentIds, emailVerifier) {
+        const runResponse = await this.runWaterfall(identifier, params, enrichmentIds, emailVerifier);
+        const data = await this.pollTaskUntilComplete(runResponse.task_id);
+        return {
+            request_id: runResponse.task_id,
+            status: 'completed',
+            data: data,
+            error: null
+        };
+    }
+    async runBulkWaterfallSync(identifier, paramsList, enrichmentIds, emailVerifier) {
+        const runResponse = await this.runBulkWaterfall(identifier, paramsList, enrichmentIds, emailVerifier);
+        return await this.pollTaskUntilComplete(runResponse.task_id);
+    }
+    // ============================================================================
+    // Table Methods
+    // ============================================================================
+    async createTable() {
+        try {
+            const response = await this.withRetry(() => this.client.post('/table/create'));
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    async getAllTables() {
+        try {
+            const response = await this.withRetry(() => this.client.get('/table/'));
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    async getTableColumns(tableUuid) {
+        try {
+            const response = await this.withRetry(() => this.client.get(`/table/${tableUuid}/columns`));
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    async getTableEnrichments(tableUuid) {
+        try {
+            const response = await this.withRetry(() => this.client.get(`/table/${tableUuid}/enrichments`));
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    async addTableEnrichment(tableUuid, data) {
+        try {
+            const response = await this.withRetry(() => this.client.post(`/table/${tableUuid}/add-enrichment`, data));
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    async runTableEnrichment(tableUuid, enrichmentId) {
+        try {
+            const response = await this.withRetry(() => this.client.get(`/table/${tableUuid}/run-enrichment/${enrichmentId}`));
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    async getTableRows(tableUuid, page = 1, perPage = 1000) {
+        try {
+            const response = await this.withRetry(() => this.client.get(`/table/${tableUuid}/rows`, {
+                params: { page, per_page: perPage }
+            }));
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    /**
+     * Insert rows, auto-batching into chunks of 50 (API limit).
+     */
+    async createRows(tableId, request) {
+        const chunks = chunkArray(request.records, API_ROW_BATCH);
+        const allCreated = [];
+        const allErrors = [];
+        for (const chunk of chunks) {
+            try {
+                const response = await this.withRetry(() => this.client.post(`/tables/${tableId}/rows`, { records: chunk, options: request.options }));
+                if (response.data.created)
+                    allCreated.push(...response.data.created);
+                if (response.data.errors)
+                    allErrors.push(...response.data.errors);
+            }
+            catch (error) {
+                this.handleError(error);
+            }
+        }
+        return { created: allCreated, errors: allErrors };
+    }
+    /**
+     * Patch rows, auto-batching into chunks of 50 (API limit).
+     */
+    async patchRows(tableId, request) {
+        const chunks = chunkArray(request.rows, API_ROW_BATCH);
+        const allResults = [];
+        for (const chunk of chunks) {
+            try {
+                const response = await this.withRetry(() => this.client.patch(`/tables/${tableId}/rows`, { rows: chunk, return_rows: request.return_rows, overwrite: request.overwrite }));
+                if (response.data.results)
+                    allResults.push(...response.data.results);
+            }
+            catch (error) {
+                this.handleError(error);
+            }
+        }
+        return { results: allResults };
+    }
+    /**
+     * Upsert rows, auto-batching into chunks of 50 (API limit).
+     */
+    async upsertRows(tableId, request) {
+        const chunks = chunkArray(request.rows, API_ROW_BATCH);
+        const allResults = [];
+        for (const chunk of chunks) {
+            try {
+                const response = await this.withRetry(() => this.client.post(`/tables/${tableId}/rows:upsert`, { rows: chunk }));
+                if (response.data.results)
+                    allResults.push(...response.data.results);
+            }
+            catch (error) {
+                this.handleError(error);
+            }
+        }
+        return { results: allResults };
+    }
+    // ============================================================================
+    // User Methods
+    // ============================================================================
+    async getUserInfo() {
+        try {
+            const response = await this.withRetry(() => this.client.get('/user/me'));
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+}
+//# sourceMappingURL=databar-client.js.map

package/dist/databar-client.js.map

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

package/dist/guards.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Security guards: spending limits, input validation, result sanitization
+ */
+import { DatabarClient } from './databar-client.js';
+export interface SpendingConfig {
+    safeMode: boolean;
+    maxCostPerRequest: number | null;
+    minBalance: number;
+    maxResultLength: number;
+}
+export declare function loadSpendingConfig(): SpendingConfig;
+/**
+ * Check spending guard. Behavior depends on safe mode:
+ *
+ * Safe mode (default):
+ *   - Checks cost cap (local, fast)
+ *   - Fetches balance from API and blocks if insufficient
+ *   - Returns error string if blocked, null if OK
+ *
+ * Unsafe mode (DATABAR_SAFE_MODE=false):
+ *   - Still checks cost cap (local, fast)
+ *   - Skips the balance API call entirely
+ *   - Returns null (never blocks on balance)
+ */
+export declare function checkSpendingGuard(client: DatabarClient, estimatedCost: number, config: SpendingConfig): Promise<string | null>;
+/**
+ * Build a cost warning string for unsafe mode.
+ * In safe mode, returns empty string (guard already checked).
+ */
+export declare function unsafeModeWarning(config: SpendingConfig, estimatedCost: number, recordCount?: number): string;
+/**
+ * Validate that an array is non-empty.
+ * For enrichments/waterfalls there's no backend size limit.
+ */
+export declare function validateBulkArray(items: any[], label: string): string | null;
+/**
+ * Validate row operations — the Databar API limits these to 50 per request.
+ * We accept up to MAX_ROW_ITEMS and auto-batch into chunks of 50.
+ */
+export declare function validateRowBatchSize(items: any[], label: string): string | null;
+export declare function sanitizeResult(text: string, maxLength: number): string;
+//# sourceMappingURL=guards.d.ts.map

package/dist/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../src/guards.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,kBAAkB,IAAI,cAAc,CAYnD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,aAAa,EACrB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyBxB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,cAAc,EACtB,aAAa,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CASR;AAQD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ5E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW/E;AAMD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAMtE"}

package/dist/guards.js

@@ -0,0 +1,108 @@
+/**
+ * Security guards: spending limits, input validation, result sanitization
+ */
+export function loadSpendingConfig() {
+    const safeMode = process.env.DATABAR_SAFE_MODE;
+    const maxCost = process.env.DATABAR_MAX_COST_PER_REQUEST;
+    const minBal = process.env.DATABAR_MIN_BALANCE;
+    const maxResult = process.env.DATABAR_MAX_RESULT_LENGTH;
+    return {
+        safeMode: safeMode !== 'false',
+        maxCostPerRequest: maxCost ? parseFloat(maxCost) : null,
+        minBalance: minBal ? parseFloat(minBal) : 1.0,
+        maxResultLength: maxResult ? parseInt(maxResult) : 50000,
+    };
+}
+/**
+ * Check spending guard. Behavior depends on safe mode:
+ *
+ * Safe mode (default):
+ *   - Checks cost cap (local, fast)
+ *   - Fetches balance from API and blocks if insufficient
+ *   - Returns error string if blocked, null if OK
+ *
+ * Unsafe mode (DATABAR_SAFE_MODE=false):
+ *   - Still checks cost cap (local, fast)
+ *   - Skips the balance API call entirely
+ *   - Returns null (never blocks on balance)
+ */
+export async function checkSpendingGuard(client, estimatedCost, config) {
+    if (config.maxCostPerRequest !== null && estimatedCost > config.maxCostPerRequest) {
+        return `Blocked: estimated cost (${estimatedCost.toFixed(2)} credits) exceeds per-request limit (${config.maxCostPerRequest} credits). Adjust DATABAR_MAX_COST_PER_REQUEST to allow higher costs.`;
+    }
+    if (!config.safeMode) {
+        return null;
+    }
+    try {
+        const user = await client.getUserInfo();
+        const balance = user.balance;
+        if (balance < config.minBalance) {
+            return `Blocked: current balance (${balance.toFixed(2)} credits) is below minimum threshold (${config.minBalance} credits). Top up your account or adjust DATABAR_MIN_BALANCE.`;
+        }
+        if (balance < estimatedCost) {
+            return `Blocked: current balance (${balance.toFixed(2)} credits) is insufficient for estimated cost (${estimatedCost.toFixed(2)} credits).`;
+        }
+    }
+    catch {
+        // If balance check fails, don't block — the API will reject if truly insufficient
+    }
+    return null;
+}
+/**
+ * Build a cost warning string for unsafe mode.
+ * In safe mode, returns empty string (guard already checked).
+ */
+export function unsafeModeWarning(config, estimatedCost, recordCount) {
+    if (config.safeMode)
+        return '';
+    const parts = ['[Unsafe mode — no credit balance check]'];
+    if (recordCount != null) {
+        parts.push(`Records: ${recordCount}`);
+    }
+    parts.push(`Estimated cost: ~${estimatedCost.toFixed(2)} credits`);
+    return parts.join(' | ') + '\n\n';
+}
+// ============================================================================
+// Input Validation
+// ============================================================================
+const MAX_ROW_ITEMS = 100;
+/**
+ * Validate that an array is non-empty.
+ * For enrichments/waterfalls there's no backend size limit.
+ */
+export function validateBulkArray(items, label) {
+    if (!Array.isArray(items)) {
+        return `${label} must be an array.`;
+    }
+    if (items.length === 0) {
+        return `${label} cannot be empty.`;
+    }
+    return null;
+}
+/**
+ * Validate row operations — the Databar API limits these to 50 per request.
+ * We accept up to MAX_ROW_ITEMS and auto-batch into chunks of 50.
+ */
+export function validateRowBatchSize(items, label) {
+    if (!Array.isArray(items)) {
+        return `${label} must be an array.`;
+    }
+    if (items.length === 0) {
+        return `${label} cannot be empty.`;
+    }
+    if (items.length > MAX_ROW_ITEMS) {
+        return `${label} has ${items.length} items, but the maximum is ${MAX_ROW_ITEMS} per request. The API batches these into groups of 50 automatically.`;
+    }
+    return null;
+}
+// ============================================================================
+// Result Sanitization
+// ============================================================================
+export function sanitizeResult(text, maxLength) {
+    if (text.length <= maxLength) {
+        return text;
+    }
+    const truncated = text.slice(0, maxLength);
+    return truncated + `\n\n[Result truncated — showing ${maxLength.toLocaleString()} of ${text.length.toLocaleString()} characters. Use more specific parameters to reduce output size.]`;
+}
+//# sourceMappingURL=guards.js.map

package/dist/guards.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Databar MCP Server
+ * Enables AI assistants to interact with Databar.ai's enrichment API
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG"}