@nodusapi/mcp-server 1.0.0

package/README.md

@@ -0,0 +1,394 @@
+# Nodus MCP Server
+
+[![npm version](https://img.shields.io/npm/v/@nodusapi/mcp-server.svg)](https://www.npmjs.com/package/@nodusapi/mcp-server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Model Context Protocol (MCP) server for NodusAPI - Enable LLMs to interact directly with your Backend-as-a-Service platform.
+
+## Overview
+
+Nodus MCP Server exposes your NodusAPI backend as MCP tools, allowing AI assistants like Claude to:
+
+- Query and manipulate data in your tables
+- Create and modify database schemas
+- Manage projects and API keys
+- Access table schemas as contextual resources
+
+All through natural language conversations!
+
+## Features
+
+- **Data CRUD Operations**: List, get, create, update, and delete rows
+- **Schema Management**: Create tables, add columns, update schemas
+- **Project Management**: List projects, create new projects, manage API keys
+- **Automatic Context**: Table schemas are automatically available to the LLM
+- **Secure Authentication**: API key-based authentication with multiple configuration options
+- **TypeScript**: Fully typed with comprehensive error handling
+
+## Installation
+
+### Quick Start (npx)
+
+The easiest way to use Nodus MCP Server is with npx:
+
+```bash
+npx @nodusapi/mcp-server
+```
+
+### Global Installation
+
+```bash
+npm install -g @nodusapi/mcp-server
+```
+
+### Local Development
+
+```bash
+git clone https://github.com/yourusername/nodusmcp.git
+cd nodusmcp
+npm install
+npm run build
+```
+
+## Configuration
+
+### Option 1: Environment Variables (Recommended for Cursor)
+
+Set these environment variables in your MCP client configuration:
+
+```bash
+NODUS_API_KEY=nds_your_api_key_here
+NODUS_PROJECT_ID=your_project_uuid (optional)
+NODUS_API_URL=https://api.nodus.com (optional, defaults to production)
+```
+
+### Option 2: Interactive Setup
+
+If no configuration is found, the server will prompt you for:
+- API Key
+- API URL (defaults to https://api.nodus.com)
+- Project ID (optional)
+
+Configuration is saved to `~/.nodus-mcp/config.json` for future use.
+
+### Option 3: Manual Configuration
+
+Create `~/.nodus-mcp/config.json`:
+
+```json
+{
+  "apiKey": "nds_your_api_key_here",
+  "projectId": "your_project_uuid",
+  "apiUrl": "https://api.nodus.com"
+}
+```
+
+## Cursor Integration
+
+Add to your `.cursor/settings.json` or Cursor MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "nodus": {
+      "command": "npx",
+      "args": ["-y", "@nodusapi/mcp-server"],
+      "env": {
+        "NODUS_API_KEY": "nds_your_api_key_here",
+        "NODUS_PROJECT_ID": "your_project_id"
+      }
+    }
+  }
+}
+```
+
+Or use a local path during development:
+
+```json
+{
+  "mcpServers": {
+    "nodus": {
+      "command": "node",
+      "args": ["/absolute/path/to/nodusmcp/dist/index.js"],
+      "env": {
+        "NODUS_API_KEY": "nds_your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+### Data CRUD Tools
+
+#### `list_rows`
+List rows from a table with pagination and filtering.
+
+**Parameters:**
+- `tableSlug` (string, required): Table identifier
+- `page` (number, optional): Page number (default: 1)
+- `limit` (number, optional): Rows per page, max 100 (default: 20)
+- `orderBy` (string, optional): Column to sort by
+- `orderDir` (string, optional): Sort direction ('ASC' or 'DESC')
+- `filters` (object, optional): Filter conditions (column: value pairs)
+
+**Example:**
+```
+"Show me the first 10 users ordered by created date"
+```
+
+#### `get_row`
+Get a single row by ID.
+
+**Parameters:**
+- `tableSlug` (string, required): Table identifier
+- `id` (string, required): Row UUID
+
+**Example:**
+```
+"Get the user with ID 123e4567-e89b-12d3-a456-426614174000"
+```
+
+#### `create_row`
+Create a new row in a table.
+
+**Parameters:**
+- `tableSlug` (string, required): Table identifier
+- `data` (object, required): Row data matching table schema
+
+**Example:**
+```
+"Create a new user with name 'John Doe' and email 'john@example.com'"
+```
+
+#### `update_row`
+Update an existing row.
+
+**Parameters:**
+- `tableSlug` (string, required): Table identifier
+- `id` (string, required): Row UUID
+- `data` (object, required): Partial row data to update
+
+**Example:**
+```
+"Update user 123... and set their status to 'active'"
+```
+
+#### `delete_row`
+Delete a row from a table.
+
+**Parameters:**
+- `tableSlug` (string, required): Table identifier
+- `id` (string, required): Row UUID
+
+**Example:**
+```
+"Delete the row with ID 123... from users table"
+```
+
+### Schema Management Tools
+
+#### `list_tables`
+List all tables in the project.
+
+**Example:**
+```
+"Show me all my database tables"
+```
+
+#### `get_table_schema`
+Get detailed schema for a specific table.
+
+**Parameters:**
+- `tableSlug` (string, required): Table identifier
+
+**Example:**
+```
+"What columns does the users table have?"
+```
+
+#### `create_table`
+Create a new table.
+
+**Parameters:**
+- `name` (string, required): Human-readable table name
+- `slug` (string, required): Table slug (lowercase, numbers, underscores only)
+
+**Example:**
+```
+"Create a new table called 'Products' with slug 'products'"
+```
+
+#### `update_table`
+Update table name.
+
+**Parameters:**
+- `tableSlug` (string, required): Current table slug
+- `name` (string, required): New table name
+
+#### `add_column`
+Add a new column to a table.
+
+**Parameters:**
+- `tableSlug` (string, required): Table identifier
+- `name` (string, required): Column name
+- `slug` (string, required): Column slug
+- `type` (string, required): Column type (string, text, integer, float, boolean, datetime, json)
+- `isRequired` (boolean, optional): Whether column is required
+- `defaultValue` (any, optional): Default value
+
+**Example:**
+```
+"Add a 'bio' column of type text to the users table"
+```
+
+#### `update_column`
+Update column properties.
+
+**Parameters:**
+- `tableSlug` (string, required): Table identifier
+- `columnSlug` (string, required): Column identifier
+- `name` (string, optional): New column name
+- `isRequired` (boolean, optional): Required status
+- `defaultValue` (any, optional): Default value
+
+### Project Management Tools
+
+#### `list_projects`
+List all projects for the authenticated user.
+
+**Example:**
+```
+"Show me my projects"
+```
+
+#### `create_project`
+Create a new project.
+
+**Parameters:**
+- `name` (string, required): Project name
+
+**Example:**
+```
+"Create a new project called 'My Blog API'"
+```
+
+#### `switch_project`
+Switch to a different project.
+
+**Parameters:**
+- `projectId` (string, required): Project UUID
+
+#### `list_api_keys`
+List API keys for a project.
+
+**Parameters:**
+- `projectId` (string, required): Project UUID
+
+#### `create_api_key`
+Create a new API key.
+
+**Parameters:**
+- `projectId` (string, required): Project UUID
+- `name` (string, required): API key name
+
+**Note:** The full API key is only shown once during creation!
+
+## Resources
+
+### `nodus://schemas/tables`
+Automatically provides the LLM with information about all tables and their schemas in your project.
+
+## Usage Examples
+
+### Example Conversation
+
+```
+User: "Show me all my database tables"
+Assistant: [Calls list_tables tool]
+"You have 3 tables: users, posts, and comments"
+
+User: "What columns does the users table have?"
+Assistant: [Calls get_table_schema with tableSlug: "users"]
+"The users table has the following columns:
+- id (string, required)
+- name (string, required)
+- email (string, required)
+- bio (text, optional)
+- created_at (datetime)"
+
+User: "Create a new user named Alice with email alice@example.com"
+Assistant: [Calls create_row with tableSlug: "users", data: {name: "Alice", email: "alice@example.com"}]
+"Successfully created user Alice with ID abc-123..."
+
+User: "List all users"
+Assistant: [Calls list_rows with tableSlug: "users"]
+"Found 5 users: Alice, Bob, Charlie, Diana, Eve"
+```
+
+## Security Notes
+
+- **No Delete Operations**: Table and project deletion are NOT exposed through MCP for safety
+- **API Key Security**: Store API keys securely using environment variables
+- **Row-Level Operations**: Only individual row deletion is allowed (no bulk delete)
+- **Validation**: All inputs are validated with Zod schemas
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Development mode with auto-reload
+npm run dev
+
+# Run locally
+npm start
+```
+
+## Troubleshooting
+
+### "Cannot connect to Nodus API"
+- Check your API URL (default: https://api.nodus.com)
+- Verify network connectivity
+
+### "Authentication failed"
+- Verify your API key starts with `nds_`
+- Generate a new API key from Nodus dashboard if needed
+
+### "Access denied"
+- Ensure your API key has necessary permissions
+- Check if you're using the correct project ID
+
+### "Resource not found"
+- Verify table slug spelling
+- Use `list_tables` to see available tables
+
+## Requirements
+
+- Node.js >= 18.0.0
+- NodusAPI account with valid API key
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Support
+
+- Documentation: https://docs.nodus.com
+- Issues: https://github.com/nodusapi/nodusmcp/issues
+- NodusAPI: https://nodus.com
+
+## Related Projects
+
+- [NodusAPI](https://github.com/nodusapi/nodusapi) - Backend-as-a-Service platform
+- [NodusWeb](https://github.com/nodusapi/nodusweb) - Web dashboard for NodusAPI
+- [Model Context Protocol](https://modelcontextprotocol.io) - MCP specification

package/cursor-config.example.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "nodus": {
+      "command": "npx",
+      "args": ["-y", "@nodusapi/mcp-server"],
+      "env": {
+        "NODUS_API_KEY": "nds_your_api_key_here",
+        "NODUS_PROJECT_ID": "your_project_id_here",
+        "NODUS_API_URL": "https://api.nodus.com"
+      }
+    }
+  }
+}

package/dist/client/nodus-client.d.ts

@@ -0,0 +1,30 @@
+import { Project, ApiKey, Table, TableWithColumns, DataRow, PaginatedResponse, QueryOptions, ColumnInput } from './types.js';
+export declare class NodusClient {
+    private client;
+    private apiKey;
+    constructor(apiKey: string, baseURL?: string);
+    private request;
+    getProjects(): Promise<Project[]>;
+    createProject(name: string): Promise<Project>;
+    switchProject(projectId: string): Promise<{
+        project: Project;
+        token: string;
+    }>;
+    getApiKeys(projectId: string): Promise<ApiKey[]>;
+    createApiKey(projectId: string, name: string): Promise<{
+        apiKey: ApiKey;
+        fullKey: string;
+    }>;
+    getTables(): Promise<Table[]>;
+    getTable(tableSlug: string): Promise<TableWithColumns>;
+    createTable(name: string, slug: string): Promise<Table>;
+    updateTable(tableSlug: string, name: string): Promise<Table>;
+    addColumn(tableSlug: string, column: ColumnInput): Promise<TableWithColumns>;
+    updateColumn(tableSlug: string, columnSlug: string, updates: Partial<Omit<ColumnInput, 'slug' | 'type'>>): Promise<TableWithColumns>;
+    listRows(tableSlug: string, options?: QueryOptions): Promise<PaginatedResponse<DataRow>>;
+    getRow(tableSlug: string, id: string): Promise<DataRow>;
+    createRow(tableSlug: string, data: Record<string, any>): Promise<DataRow>;
+    updateRow(tableSlug: string, id: string, data: Record<string, any>): Promise<DataRow>;
+    deleteRow(tableSlug: string, id: string): Promise<void>;
+}
+//# sourceMappingURL=nodus-client.d.ts.map

package/dist/client/nodus-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodus-client.d.ts","sourceRoot":"","sources":["../../src/client/nodus-client.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,OAAO,EACP,MAAM,EACN,KAAK,EACL,gBAAgB,EAChB,OAAO,EACP,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,MAAgC;YAYvD,OAAO;IA0Cf,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIjC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7C,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAO9E,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIhD,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ3F,SAAS,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAI7B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAItD,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAIvD,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAI5D,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQ5E,YAAY,CAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,GACnD,OAAO,CAAC,gBAAgB,CAAC;IAQtB,QAAQ,CACZ,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IA6BhC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzE,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrF,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG9D"}

package/dist/client/nodus-client.js

@@ -0,0 +1,121 @@
+import axios from 'axios';
+export class NodusClient {
+    client;
+    apiKey;
+    constructor(apiKey, baseURL = 'https://api.nodus.com') {
+        this.apiKey = apiKey;
+        this.client = axios.create({
+            baseURL,
+            headers: {
+                'X-API-Key': apiKey,
+                'Content-Type': 'application/json',
+            },
+            timeout: 30000,
+        });
+    }
+    async request(method, url, data, params) {
+        try {
+            const response = await this.client.request({
+                method,
+                url,
+                data,
+                params,
+            });
+            if (!response.data.success) {
+                throw new Error(response.data.error?.message || 'API request failed');
+            }
+            return response.data.data;
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                const axiosError = error;
+                if (axiosError.response?.data?.error) {
+                    throw new Error(`API Error: ${axiosError.response.data.error.message}`);
+                }
+                if (axiosError.code === 'ECONNREFUSED') {
+                    throw new Error('Cannot connect to Nodus API. Please check your API URL.');
+                }
+                if (axiosError.response?.status === 401) {
+                    throw new Error('Authentication failed. Please check your API key.');
+                }
+                if (axiosError.response?.status === 403) {
+                    throw new Error('Access denied. You do not have permission to perform this action.');
+                }
+                if (axiosError.response?.status === 404) {
+                    throw new Error('Resource not found.');
+                }
+            }
+            throw error;
+        }
+    }
+    async getProjects() {
+        return this.request('get', '/api/v1/projects');
+    }
+    async createProject(name) {
+        return this.request('post', '/api/v1/projects', { name });
+    }
+    async switchProject(projectId) {
+        return this.request('post', `/api/v1/projects/${projectId}/switch`);
+    }
+    async getApiKeys(projectId) {
+        return this.request('get', `/api/v1/projects/${projectId}/api-keys`);
+    }
+    async createApiKey(projectId, name) {
+        return this.request('post', `/api/v1/projects/${projectId}/api-keys`, { name });
+    }
+    async getTables() {
+        return this.request('get', '/api/v1/schemas/tables');
+    }
+    async getTable(tableSlug) {
+        return this.request('get', `/api/v1/schemas/tables/${tableSlug}`);
+    }
+    async createTable(name, slug) {
+        return this.request('post', '/api/v1/schemas/tables', { name, slug });
+    }
+    async updateTable(tableSlug, name) {
+        return this.request('put', `/api/v1/schemas/tables/${tableSlug}`, { name });
+    }
+    async addColumn(tableSlug, column) {
+        return this.request('post', `/api/v1/schemas/tables/${tableSlug}/columns`, column);
+    }
+    async updateColumn(tableSlug, columnSlug, updates) {
+        return this.request('put', `/api/v1/schemas/tables/${tableSlug}/columns/${columnSlug}`, updates);
+    }
+    async listRows(tableSlug, options) {
+        const params = {};
+        if (options?.page)
+            params.page = options.page;
+        if (options?.limit)
+            params.limit = options.limit;
+        if (options?.orderBy)
+            params.orderBy = options.orderBy;
+        if (options?.orderDir)
+            params.orderDir = options.orderDir;
+        if (options?.filters) {
+            Object.entries(options.filters).forEach(([key, value]) => {
+                params[key] = value;
+            });
+        }
+        const response = await this.client.get(`/api/v1/data/${tableSlug}`, { params });
+        if (!response.data.success) {
+            throw new Error(response.data.error?.message || 'Failed to fetch rows');
+        }
+        return {
+            data: response.data.data || [],
+            meta: response.data.meta || { page: 1, limit: 20, total: 0, totalPages: 0 },
+        };
+    }
+    async getRow(tableSlug, id) {
+        return this.request('get', `/api/v1/data/${tableSlug}/${id}`);
+    }
+    async createRow(tableSlug, data) {
+        return this.request('post', `/api/v1/data/${tableSlug}`, data);
+    }
+    async updateRow(tableSlug, id, data) {
+        return this.request('put', `/api/v1/data/${tableSlug}/${id}`, data);
+    }
+    async deleteRow(tableSlug, id) {
+        return this.request('delete', `/api/v1/data/${tableSlug}/${id}`);
+    }
+}
+//# sourceMappingURL=nodus-client.js.map

package/dist/client/nodus-client.js.map

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

package/dist/client/types.d.ts

@@ -0,0 +1,81 @@
+export interface NodusConfig {
+    apiKey: string;
+    projectId?: string;
+    apiUrl: string;
+}
+export interface Project {
+    id: string;
+    name: string;
+    slug: string;
+    userId: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ApiKey {
+    id: string;
+    projectId: string;
+    name: string;
+    prefix: string;
+    createdAt: string;
+    lastUsedAt: string | null;
+}
+export interface Table {
+    id: string;
+    projectId: string;
+    name: string;
+    slug: string;
+    createdAt: string;
+    updatedAt: string;
+    rowCount?: number;
+}
+export interface Column {
+    id: string;
+    tableId: string;
+    name: string;
+    slug: string;
+    type: 'string' | 'text' | 'integer' | 'float' | 'boolean' | 'datetime' | 'json';
+    isRequired: boolean;
+    defaultValue: any;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface TableWithColumns extends Table {
+    columns: Column[];
+}
+export interface DataRow {
+    id: string;
+    [key: string]: any;
+}
+export interface PaginatedResponse<T> {
+    data: T[];
+    meta: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+    };
+}
+export interface ApiResponse<T = any> {
+    success: boolean;
+    data?: T;
+    meta?: any;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface QueryOptions {
+    page?: number;
+    limit?: number;
+    orderBy?: string;
+    orderDir?: 'ASC' | 'DESC';
+    filters?: Record<string, any>;
+}
+export interface ColumnInput {
+    name: string;
+    slug: string;
+    type: 'string' | 'text' | 'integer' | 'float' | 'boolean' | 'datetime' | 'json';
+    isRequired?: boolean;
+    defaultValue?: any;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IAChF,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,GAAG,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAiB,SAAQ,KAAK;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IAChF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,GAAG,CAAC;CACpB"}

package/dist/client/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":""}

package/dist/config.d.ts

@@ -0,0 +1,6 @@
+import { NodusConfig } from './client/types.js';
+export declare function loadConfig(): Promise<NodusConfig | null>;
+export declare function saveConfig(config: NodusConfig): Promise<void>;
+export declare function getConfig(): Promise<NodusConfig>;
+export declare function promptForConfig(): Promise<NodusConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKhD,wBAAsB,UAAU,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAO9D;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAOnE;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC,CAqBtD;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC,CAuC5D"}