@quarri/claude-data-tools 1.0.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "quarri",
+  "displayName": "Quarri Data Assistant",
+  "version": "1.0.0",
+  "description": "Natural language data analysis with Quarri. Query databases, create visualizations, and get insights using plain English.",
+  "publisher": "quarri",
+  "repository": "https://github.com/quarri-ai/quarri-claude-plugin",
+  "homepage": "https://quarri.ai",
+  "icon": "https://quarri.ai/logo.png",
+  "categories": ["Data & Analytics", "Developer Tools"],
+  "keywords": ["sql", "data", "analytics", "visualization", "database"],
+  "mcpServers": {
+    "quarri": {
+      "command": "node",
+      "args": ["${pluginDir}/dist/index.js"]
+    }
+  },
+  "skills": ["quarri-guide"]
+}

package/README.md

@@ -0,0 +1,165 @@
+# Quarri Claude Code Plugin
+
+Natural language data analysis with Quarri. Query databases, create visualizations, and get insights using plain English.
+
+## Installation
+
+### Via Claude Code Marketplace
+
+```bash
+claude /install quarri
+```
+
+### Manual Installation
+
+```bash
+npm install -g @anthropic/quarri
+```
+
+Then add to your Claude Code configuration:
+
+```json
+{
+  "mcpServers": {
+    "quarri": {
+      "command": "quarri-mcp"
+    }
+  }
+}
+```
+
+## Authentication
+
+On first use, you'll be prompted to authenticate:
+
+### Existing Quarri Users
+
+1. Enter your email address
+2. Check your email for a 6-digit verification code
+3. Enter the code to complete authentication
+
+### New Users (with invitation)
+
+1. Select "invite" when prompted
+2. Enter your email address
+3. Enter the invitation token from your admin's email
+4. Your account will be created automatically
+
+## Features
+
+### 47 Tools for Data Analysis
+
+**Sub-Agents (12):**
+- `quarri_query_agent` - Generate SQL from natural language
+- `quarri_explain_agent` - Explain SQL queries
+- `quarri_chart_agent` - Generate visualizations
+- `quarri_metric_builder_agent` - Define metrics interactively
+- `quarri_planning_agent` - Create analysis plans
+- `quarri_insight_agent` - Generate actionable insights
+- `quarri_stats_agent` - Statistical analysis
+- `quarri_staging_agent` - Stage raw data
+- `quarri_modeling_agent` - Design data models
+- `quarri_transformers_agent` - Generate transformation SQL
+- `quarri_extraction_agent` - Create data pipelines
+- `quarri_query_with_analysis` - Full analysis pipeline
+
+**Data Tools (8):**
+- `quarri_execute_sql` - Run SQL queries
+- `quarri_get_schema` - View database schema
+- `quarri_search_values` - Semantic search
+- `quarri_get_metrics`, `quarri_create_metric`, `quarri_approve_metric`
+- `quarri_get_metric_detail`, `quarri_search_metrics`
+
+**Configuration (8):**
+- `quarri_list_agent_prompts`, `quarri_update_agent_prompt`
+- `quarri_list_rules`, `quarri_create_rule`, `quarri_update_rule`, `quarri_delete_rule`
+- `quarri_vectorize_column_values`, `quarri_list_searchable_columns`
+
+**Canvas (5):**
+- `quarri_list_canvases`, `quarri_get_canvas`
+- `quarri_create_chart_panel`, `quarri_update_chart_panel`
+- `quarri_export_canvas`
+
+**Team (3):**
+- `quarri_list_teams`, `quarri_get_team_filters`, `quarri_get_team_restrictions`
+
+**Extraction (7):**
+- `quarri_list_extraction_sources`, `quarri_configure_extraction`
+- `quarri_discover_tables`, `quarri_propose_transformation`
+- `quarri_upload_csv`, `quarri_generate_quarri_schema`, `quarri_list_raw_tables`
+
+**Debug (3):**
+- `quarri_read_server_logs`, `quarri_query_repl_activity`, `quarri_read_fly_logs`
+
+**Session (2):**
+- `quarri_list_databases`, `quarri_select_database`
+
+## Usage Examples
+
+### Ask a Data Question
+
+```
+What were our top 10 products by revenue last month?
+```
+
+Claude will use `quarri_query_with_analysis` to:
+1. Generate SQL from your question
+2. Execute the query
+3. Perform statistical analysis
+4. Generate a chart
+5. Provide key insights
+
+### Create a Metric
+
+```
+Help me define a metric for customer lifetime value
+```
+
+Claude will guide you through defining the metric using `quarri_metric_builder_agent`.
+
+### Configure Semantic Search
+
+```
+Enable semantic search on the product_name column
+```
+
+Claude will use `quarri_vectorize_column_values` to enable natural language search.
+
+## Configuration
+
+Credentials are stored in `~/.quarri/credentials` with secure permissions (0600).
+
+### Environment Variables
+
+- `QUARRI_API_URL` - API endpoint (default: https://app.quarri.ai)
+
+## Development
+
+### Building
+
+```bash
+npm install
+npm run build
+```
+
+### Testing
+
+```bash
+npm test
+```
+
+### Local Development
+
+```bash
+npm run dev
+```
+
+## License
+
+MIT
+
+## Support
+
+- GitHub Issues: https://github.com/quarri-ai/quarri-claude-plugin/issues
+- Documentation: https://docs.quarri.ai
+- Email: support@quarri.ai

package/dist/api/client.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Quarri API Client
+ * HTTP client for communicating with the Quarri backend
+ */
+interface ApiResponse<T = unknown> {
+    success: boolean;
+    error?: string;
+    data?: T;
+}
+interface AuthResponse {
+    success: boolean;
+    error?: string;
+    token?: string;
+    expiresAt?: string;
+    user?: {
+        email: string;
+        role: string;
+        user_id?: number;
+    };
+    databases?: Array<{
+        database_name: string;
+        display_name: string;
+        access_level: string;
+    }>;
+}
+interface ToolResult {
+    success: boolean;
+    error?: string;
+    [key: string]: unknown;
+}
+export declare class QuarriApiClient {
+    private baseUrl;
+    private token;
+    constructor(baseUrl?: string);
+    /**
+     * Set the authentication token
+     */
+    setToken(token: string): void;
+    /**
+     * Make an HTTP request to the API
+     */
+    private request;
+    /**
+     * Request a verification code for CLI authentication
+     */
+    requestVerificationCode(email: string): Promise<AuthResponse>;
+    /**
+     * Verify a code and get an API token
+     */
+    verifyCode(email: string, code: string): Promise<AuthResponse>;
+    /**
+     * Verify an invitation token for new users
+     */
+    verifyInvite(email: string, inviteToken: string): Promise<AuthResponse>;
+    /**
+     * Validate an existing token
+     */
+    validateToken(token: string): Promise<AuthResponse>;
+    /**
+     * List available tools
+     */
+    listTools(): Promise<ApiResponse<{
+        tools: unknown[];
+        count: number;
+    }>>;
+    /**
+     * Get tool schema
+     */
+    getToolSchema(toolName: string): Promise<ApiResponse<{
+        tool: unknown;
+    }>>;
+    /**
+     * Execute a tool
+     */
+    executeTool(toolName: string, args: Record<string, unknown>, databaseName?: string): Promise<ToolResult>;
+    /**
+     * List user's databases
+     */
+    listDatabases(): Promise<ApiResponse<{
+        databases: Array<{
+            database_name: string;
+            display_name: string;
+            access_level: string;
+        }>;
+    }>>;
+    /**
+     * Execute multiple tools in batch
+     */
+    executeBatch(tools: Array<{
+        name: string;
+        args: Record<string, unknown>;
+    }>, databaseName?: string, stopOnError?: boolean): Promise<ApiResponse<{
+        results: ToolResult[];
+    }>>;
+    /**
+     * Health check
+     */
+    healthCheck(): Promise<ApiResponse<{
+        tool_count: number;
+    }>>;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,UAAU,WAAW,CAAC,CAAC,GAAG,OAAO;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,CAAC,CAAC;CACV;AAED,UAAU,YAAY;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED,UAAU,UAAU;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAuB;gBAExB,OAAO,CAAC,EAAE,MAAM;IAI5B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;YACW,OAAO;IAwCrB;;OAEG;IACG,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAenE;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAsBpE;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAsB7E;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA2BzD;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC;QAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAI5E;;OAEG;IACG,aAAa,CACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAI1C;;OAEG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,UAAU,CAAC;IAmBtB;;OAEG;IACG,aAAa,IAAI,OAAO,CAC5B,WAAW,CAAC;QACV,SAAS,EAAE,KAAK,CAAC;YACf,aAAa,EAAE,MAAM,CAAC;YACtB,YAAY,EAAE,MAAM,CAAC;YACrB,YAAY,EAAE,MAAM,CAAC;SACtB,CAAC,CAAC;KACJ,CAAC,CACH;IAID;;OAEG;IACG,YAAY,CAChB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,EAC7D,YAAY,CAAC,EAAE,MAAM,EACrB,WAAW,UAAQ,GAClB,OAAO,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC,CAAC;IASlD;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAGlE"}

package/dist/api/client.js

@@ -0,0 +1,166 @@
+"use strict";
+/**
+ * Quarri API Client
+ * HTTP client for communicating with the Quarri backend
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuarriApiClient = void 0;
+const DEFAULT_API_URL = 'https://app.quarri.ai';
+class QuarriApiClient {
+    baseUrl;
+    token = null;
+    constructor(baseUrl) {
+        this.baseUrl = baseUrl || process.env.QUARRI_API_URL || DEFAULT_API_URL;
+    }
+    /**
+     * Set the authentication token
+     */
+    setToken(token) {
+        this.token = token;
+    }
+    /**
+     * Make an HTTP request to the API
+     */
+    async request(method, path, body, useAuth = true) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (useAuth && this.token) {
+            headers['Authorization'] = `Bearer ${this.token}`;
+        }
+        try {
+            const response = await fetch(url, {
+                method,
+                headers,
+                body: body ? JSON.stringify(body) : undefined,
+            });
+            const data = await response.json();
+            if (!response.ok) {
+                return {
+                    success: false,
+                    error: data.error || `HTTP ${response.status}: ${response.statusText}`,
+                };
+            }
+            return { success: true, data: data };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return { success: false, error: message };
+        }
+    }
+    // ==================== Auth Methods ====================
+    /**
+     * Request a verification code for CLI authentication
+     */
+    async requestVerificationCode(email) {
+        const result = await this.request('POST', '/api/auth/cli/request-code', { email }, false);
+        if (!result.success) {
+            return { success: false, error: result.error };
+        }
+        return { success: true, ...result.data };
+    }
+    /**
+     * Verify a code and get an API token
+     */
+    async verifyCode(email, code) {
+        const result = await this.request('POST', '/api/auth/cli/verify-code', { email, code }, false);
+        if (!result.success) {
+            return { success: false, error: result.error };
+        }
+        const data = result.data;
+        return {
+            success: true,
+            token: data.token,
+            expiresAt: data.expiresAt,
+            user: data.user,
+            databases: data.databases,
+        };
+    }
+    /**
+     * Verify an invitation token for new users
+     */
+    async verifyInvite(email, inviteToken) {
+        const result = await this.request('POST', '/api/auth/cli/verify-invite', { email, invite_token: inviteToken }, false);
+        if (!result.success) {
+            return { success: false, error: result.error };
+        }
+        const data = result.data;
+        return {
+            success: true,
+            token: data.token,
+            expiresAt: data.expiresAt,
+            user: data.user,
+            databases: data.databases,
+        };
+    }
+    /**
+     * Validate an existing token
+     */
+    async validateToken(token) {
+        const oldToken = this.token;
+        this.token = token;
+        const result = await this.request('POST', '/api/auth/cli/validate-token', {}, true);
+        this.token = oldToken;
+        if (!result.success) {
+            return { success: false, error: result.error };
+        }
+        const data = result.data;
+        return {
+            success: true,
+            user: data.user,
+            databases: data.databases,
+        };
+    }
+    // ==================== Tool Methods ====================
+    /**
+     * List available tools
+     */
+    async listTools() {
+        return this.request('GET', '/api/cli/tools');
+    }
+    /**
+     * Get tool schema
+     */
+    async getToolSchema(toolName) {
+        return this.request('GET', `/api/cli/tools/${toolName}`);
+    }
+    /**
+     * Execute a tool
+     */
+    async executeTool(toolName, args, databaseName) {
+        const body = { args };
+        if (databaseName) {
+            body.database_name = databaseName;
+        }
+        const result = await this.request('POST', `/api/cli/tool/${toolName}`, body);
+        if (!result.success) {
+            return { success: false, error: result.error };
+        }
+        return result.data;
+    }
+    /**
+     * List user's databases
+     */
+    async listDatabases() {
+        return this.request('GET', '/api/cli/databases');
+    }
+    /**
+     * Execute multiple tools in batch
+     */
+    async executeBatch(tools, databaseName, stopOnError = false) {
+        const body = { tools, stop_on_error: stopOnError };
+        if (databaseName) {
+            body.database_name = databaseName;
+        }
+        return this.request('POST', '/api/cli/batch', body);
+    }
+    /**
+     * Health check
+     */
+    async healthCheck() {
+        return this.request('GET', '/api/cli/health', undefined, false);
+    }
+}
+exports.QuarriApiClient = QuarriApiClient;
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

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

package/dist/auth/cli-auth.d.ts

@@ -0,0 +1,15 @@
+/**
+ * CLI Authentication flow for Quarri
+ * Handles both existing users (email + code) and new users (email + invite token)
+ */
+import { QuarriApiClient } from '../api/client.js';
+import { StoredCredentials } from './token-store.js';
+/**
+ * Run the interactive authentication flow
+ */
+export declare function runAuthFlow(client: QuarriApiClient): Promise<StoredCredentials | null>;
+/**
+ * Validate an existing token
+ */
+export declare function validateToken(client: QuarriApiClient, token: string): Promise<boolean>;
+//# sourceMappingURL=cli-auth.d.ts.map

package/dist/auth/cli-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-auth.d.ts","sourceRoot":"","sources":["../../src/auth/cli-auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAmB,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAuBtE;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAiC5F;AAkGD;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC,CAGlB"}

package/dist/auth/cli-auth.js

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * CLI Authentication flow for Quarri
+ * Handles both existing users (email + code) and new users (email + invite token)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAuthFlow = runAuthFlow;
+exports.validateToken = validateToken;
+const readline = __importStar(require("readline"));
+const token_store_js_1 = require("./token-store.js");
+/**
+ * Create a readline interface for user input
+ */
+function createReadline() {
+    return readline.createInterface({
+        input: process.stdin,
+        output: process.stderr, // Use stderr so it doesn't interfere with MCP protocol
+    });
+}
+/**
+ * Prompt user for input
+ */
+async function prompt(rl, question) {
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            resolve(answer.trim());
+        });
+    });
+}
+/**
+ * Run the interactive authentication flow
+ */
+async function runAuthFlow(client) {
+    const rl = createReadline();
+    try {
+        console.error('\n=== Quarri CLI Authentication ===\n');
+        // Ask if user has an account or invite
+        const authType = await prompt(rl, 'Do you have a Quarri account? (yes/no/invite): ');
+        const email = await prompt(rl, 'Enter your email address: ');
+        if (!email || !email.includes('@')) {
+            console.error('Invalid email address');
+            return null;
+        }
+        if (authType.toLowerCase() === 'invite' || authType.toLowerCase() === 'i') {
+            // New user with invitation
+            return await handleInviteAuth(rl, client, email);
+        }
+        else if (authType.toLowerCase() === 'yes' || authType.toLowerCase() === 'y') {
+            // Existing user
+            return await handleExistingUserAuth(rl, client, email);
+        }
+        else {
+            console.error('\nYou need either an existing Quarri account or an invitation.');
+            console.error('Contact your administrator for an invitation.');
+            return null;
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+/**
+ * Handle authentication for existing users (email + verification code)
+ */
+async function handleExistingUserAuth(rl, client, email) {
+    console.error('\nRequesting verification code...');
+    // Request verification code
+    const requestResult = await client.requestVerificationCode(email);
+    if (!requestResult.success) {
+        console.error(`Failed to request code: ${requestResult.error}`);
+        return null;
+    }
+    console.error('Verification code sent to your email.');
+    const code = await prompt(rl, 'Enter the 6-digit verification code: ');
+    if (!code || code.length !== 6) {
+        console.error('Invalid verification code');
+        return null;
+    }
+    // Verify code and get token
+    console.error('Verifying code...');
+    const verifyResult = await client.verifyCode(email, code);
+    if (!verifyResult.success) {
+        console.error(`Verification failed: ${verifyResult.error}`);
+        return null;
+    }
+    // Save credentials
+    const credentials = {
+        token: verifyResult.token,
+        email: verifyResult.user.email,
+        role: verifyResult.user.role,
+        databases: verifyResult.databases,
+        expiresAt: verifyResult.expiresAt,
+    };
+    (0, token_store_js_1.saveCredentials)(credentials);
+    console.error(`\nAuthenticated successfully as ${email}!`);
+    console.error(`Role: ${credentials.role}`);
+    console.error(`Databases: ${credentials.databases.map((d) => d.database_name).join(', ')}`);
+    return credentials;
+}
+/**
+ * Handle authentication for new users with invitation token
+ */
+async function handleInviteAuth(rl, client, email) {
+    const inviteToken = await prompt(rl, 'Enter your invitation token (from the invite email): ');
+    if (!inviteToken) {
+        console.error('Invitation token is required');
+        return null;
+    }
+    console.error('\nVerifying invitation...');
+    const verifyResult = await client.verifyInvite(email, inviteToken);
+    if (!verifyResult.success) {
+        console.error(`Invitation verification failed: ${verifyResult.error}`);
+        return null;
+    }
+    // Save credentials
+    const credentials = {
+        token: verifyResult.token,
+        email: verifyResult.user.email,
+        role: verifyResult.user.role,
+        databases: verifyResult.databases,
+        expiresAt: verifyResult.expiresAt,
+    };
+    (0, token_store_js_1.saveCredentials)(credentials);
+    console.error(`\nAccount created and authenticated successfully!`);
+    console.error(`Email: ${email}`);
+    console.error(`Role: ${credentials.role}`);
+    console.error(`Databases: ${credentials.databases.map((d) => d.database_name).join(', ')}`);
+    return credentials;
+}
+/**
+ * Validate an existing token
+ */
+async function validateToken(client, token) {
+    const result = await client.validateToken(token);
+    return result.success;
+}
+//# sourceMappingURL=cli-auth.js.map

package/dist/auth/cli-auth.js.map

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