@egdesk/next-api-plugin 1.0.0

package/dist/generate-proxy.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * Generate Next.js 16+ proxy for EGDesk database proxy
+ *
+ * Creates proxy.ts that intercepts __user_data_proxy requests
+ * and forwards them to the EGDesk MCP server.
+ *
+ * This is the Next.js 16+ recommended approach (replaces middleware.ts)
+ */
+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.generateProxy = generateProxy;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Detect if project uses src/ directory structure
+ */
+function usesSrcDirectory(projectPath) {
+    const srcPath = path.join(projectPath, 'src');
+    const srcAppPath = path.join(projectPath, 'src', 'app');
+    return fs.existsSync(srcPath) && fs.existsSync(srcAppPath);
+}
+/**
+ * Generate proxy.ts file in the correct location (root or src/)
+ */
+function generateProxy(projectPath) {
+    // Detect if project uses src/ directory
+    const hasSrc = usesSrcDirectory(projectPath);
+    const targetDir = hasSrc ? path.join(projectPath, 'src') : projectPath;
+    const proxyPath = path.join(targetDir, 'proxy.ts');
+    console.log(`📁 Detected ${hasSrc ? 'src/' : 'root'} directory structure`);
+    console.log(`📝 Generating proxy at: ${proxyPath}`);
+    // Check if proxy.ts already exists
+    if (fs.existsSync(proxyPath)) {
+        console.log('⚠️  proxy.ts already exists - backing up to proxy.backup.ts');
+        const backupPath = path.join(targetDir, 'proxy.backup.ts');
+        fs.copyFileSync(proxyPath, backupPath);
+    }
+    const proxyContent = `import { NextResponse } from 'next/server';
+import type { NextRequest } from 'next/server';
+
+/**
+ * EGDesk Database Proxy (Next.js 16+)
+ *
+ * Intercepts __user_data_proxy requests and forwards them to the EGDesk MCP server.
+ * This allows CORS-free database access in both local and tunneled environments.
+ *
+ * Generated by @egdesk/next-api-plugin
+ */
+export async function proxy(request: NextRequest) {
+  const { pathname } = request.nextUrl;
+
+  // Intercept __user_data_proxy requests
+  if (pathname.includes('__user_data_proxy')) {
+    try {
+      const body = await request.text();
+
+      // Read API key and URL from environment
+      const apiKey = process.env.NEXT_PUBLIC_EGDESK_API_KEY;
+      const apiUrl = process.env.NEXT_PUBLIC_EGDESK_API_URL || 'http://localhost:8080';
+
+      const headers: HeadersInit = {
+        'Content-Type': 'application/json',
+      };
+
+      if (apiKey) {
+        headers['X-Api-Key'] = apiKey;
+      }
+
+      // Forward to EGDesk MCP server
+      const response = await fetch(\`\${apiUrl}/user-data/tools/call\`, {
+        method: 'POST',
+        headers,
+        body,
+      });
+
+      const result = await response.json();
+
+      return NextResponse.json(result, { status: response.status });
+    } catch (error: any) {
+      return NextResponse.json(
+        { error: 'Proxy error', message: error.message },
+        { status: 500 }
+      );
+    }
+  }
+
+  // Continue to next proxy or route
+  return NextResponse.next();
+}
+
+export const config = {
+  matcher: [
+    /*
+     * Match all paths except static assets
+     * The proxy function itself filters for __user_data_proxy
+     */
+    '/:path*',
+  ],
+};
+`;
+    fs.writeFileSync(proxyPath, proxyContent, 'utf-8');
+    console.log(`✅ Generated ${proxyPath}`);
+}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @egdesk/next-api-plugin
+ *
+ * Next.js plugin for EGDesk database proxy integration.
+ * Provides middleware-based database access for Next.js applications.
+ */
+export interface SetupOptions {
+    egdeskUrl?: string;
+    apiKey?: string;
+    useProxy?: boolean;
+}
+/**
+ * Main setup function for Next.js projects
+ *
+ * Discovers tables and generates all necessary files:
+ * - proxy.ts or middleware.ts (proxy interceptor)
+ * - egdesk.config.ts (table definitions)
+ * - egdesk-helpers.ts (helper functions)
+ * - .env.local (environment variables)
+ */
+export declare function setupNextApiPlugin(projectPath: string, options?: SetupOptions): Promise<void>;
+export type { UserDataTable, UserDataConfig } from './setup-userdata';
+export { discoverTables } from './setup-userdata';
+export { generateMiddleware } from './generate-middleware';
+export { generateProxy } from './generate-proxy';
+export { generateHelpers } from './generate-helpers';

package/dist/index.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * @egdesk/next-api-plugin
+ *
+ * Next.js plugin for EGDesk database proxy integration.
+ * Provides middleware-based database access for Next.js applications.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateHelpers = exports.generateProxy = exports.generateMiddleware = exports.discoverTables = void 0;
+exports.setupNextApiPlugin = setupNextApiPlugin;
+const setup_userdata_1 = require("./setup-userdata");
+const generate_middleware_1 = require("./generate-middleware");
+const generate_proxy_1 = require("./generate-proxy");
+const generate_helpers_1 = require("./generate-helpers");
+/**
+ * Main setup function for Next.js projects
+ *
+ * Discovers tables and generates all necessary files:
+ * - proxy.ts or middleware.ts (proxy interceptor)
+ * - egdesk.config.ts (table definitions)
+ * - egdesk-helpers.ts (helper functions)
+ * - .env.local (environment variables)
+ */
+async function setupNextApiPlugin(projectPath, options = {}) {
+    const { egdeskUrl = 'http://localhost:8080', apiKey, useProxy = true } = options;
+    console.log('🔍 Discovering EGDesk user-data tables...');
+    try {
+        const tables = await (0, setup_userdata_1.discoverTables)(egdeskUrl, apiKey);
+        if (tables.length === 0) {
+            console.warn('⚠️  No tables found. Import data in EGDesk first.');
+            console.log('');
+            console.log('Generating files anyway with empty table list...');
+        }
+        else {
+            console.log(`✅ Found ${tables.length} table(s):`);
+            tables.forEach((table, index) => {
+                console.log(`   ${index + 1}. ${table.displayName} (${table.rowCount} rows)`);
+            });
+        }
+        const config = {
+            apiKey: apiKey || null,
+            baseUrl: egdeskUrl,
+            tables,
+            generatedAt: new Date().toISOString()
+        };
+        // Generate all configuration files
+        console.log('');
+        console.log('📝 Generating configuration files...');
+        // Use proxy.ts (Next.js 16+) or middleware.ts (legacy)
+        if (useProxy) {
+            console.log('🔄 Using proxy.ts (Next.js 16+ recommended)');
+            (0, generate_proxy_1.generateProxy)(projectPath);
+        }
+        else {
+            console.log('🔄 Using middleware.ts (legacy)');
+            (0, generate_middleware_1.generateMiddleware)(projectPath);
+        }
+        (0, setup_userdata_1.generateConfigFile)(projectPath, config);
+        (0, generate_helpers_1.generateHelpers)(projectPath);
+        (0, setup_userdata_1.updateEnvLocal)(projectPath, config);
+        const proxyFile = useProxy ? 'proxy.ts' : 'middleware.ts';
+        console.log('');
+        console.log('✅ Setup complete! Files generated:');
+        console.log(`   - ${proxyFile} (database proxy)`);
+        console.log('   - egdesk.config.ts (type-safe config)');
+        console.log('   - egdesk-helpers.ts (helper functions)');
+        console.log('   - .env.local (environment variables)');
+        console.log('');
+        console.log('📝 Next steps:');
+        console.log('   1. Add .env.local to your .gitignore');
+        console.log('   2. Restart your Next.js dev server');
+        console.log('   3. Import and use helpers in your components:');
+        console.log('      import { queryTable } from "./egdesk-helpers"');
+        console.log('      import { TABLES } from "./egdesk.config"');
+        console.log('');
+        console.log('Example usage in a component:');
+        console.log('   const data = await queryTable(TABLES.table1.name, { limit: 10 });');
+    }
+    catch (error) {
+        console.error('❌ Setup failed:', error);
+        throw error;
+    }
+}
+var setup_userdata_2 = require("./setup-userdata");
+Object.defineProperty(exports, "discoverTables", { enumerable: true, get: function () { return setup_userdata_2.discoverTables; } });
+var generate_middleware_2 = require("./generate-middleware");
+Object.defineProperty(exports, "generateMiddleware", { enumerable: true, get: function () { return generate_middleware_2.generateMiddleware; } });
+var generate_proxy_2 = require("./generate-proxy");
+Object.defineProperty(exports, "generateProxy", { enumerable: true, get: function () { return generate_proxy_2.generateProxy; } });
+var generate_helpers_2 = require("./generate-helpers");
+Object.defineProperty(exports, "generateHelpers", { enumerable: true, get: function () { return generate_helpers_2.generateHelpers; } });

package/dist/setup-userdata.d.ts

@@ -0,0 +1,37 @@
+/**
+ * User Data Setup Utility for Next.js
+ *
+ * Automatically discovers EGDesk user-data tables and generates configuration
+ * for Next.js projects to access them.
+ */
+export interface UserDataTable {
+    id: string;
+    tableName: string;
+    displayName: string;
+    description?: string;
+    rowCount: number;
+    columnCount: number;
+    columns: string[];
+}
+export interface UserDataConfig {
+    apiKey: string | null;
+    baseUrl: string;
+    tables: UserDataTable[];
+    generatedAt: string;
+}
+/**
+ * Fetch available tables from EGDesk
+ */
+export declare function discoverTables(egdeskUrl?: string, apiKey?: string): Promise<UserDataTable[]>;
+/**
+ * Read existing .env.local file or return empty object
+ */
+export declare function readEnvLocal(projectPath: string): Record<string, string>;
+/**
+ * Update .env.local file with Next.js environment variables
+ */
+export declare function updateEnvLocal(projectPath: string, config: UserDataConfig): void;
+/**
+ * Generate TypeScript config file with table definitions
+ */
+export declare function generateConfigFile(projectPath: string, config: UserDataConfig): void;

package/dist/setup-userdata.js

@@ -0,0 +1,225 @@
+"use strict";
+/**
+ * User Data Setup Utility for Next.js
+ *
+ * Automatically discovers EGDesk user-data tables and generates configuration
+ * for Next.js projects to access them.
+ */
+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.discoverTables = discoverTables;
+exports.readEnvLocal = readEnvLocal;
+exports.updateEnvLocal = updateEnvLocal;
+exports.generateConfigFile = generateConfigFile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Fetch available tables from EGDesk
+ */
+async function discoverTables(egdeskUrl = 'http://localhost:8080', apiKey) {
+    try {
+        const headers = {
+            'Content-Type': 'application/json'
+        };
+        if (apiKey) {
+            headers['X-Api-Key'] = apiKey;
+        }
+        // List all tables
+        const listResponse = await fetch(`${egdeskUrl}/user-data/tools/call`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({
+                tool: 'user_data_list_tables',
+                arguments: {}
+            })
+        });
+        if (!listResponse.ok) {
+            throw new Error(`Failed to list tables: ${listResponse.statusText}`);
+        }
+        const listResult = await listResponse.json();
+        if (!listResult.success) {
+            throw new Error(listResult.error || 'Failed to list tables');
+        }
+        // Parse MCP response
+        const content = listResult.result?.content?.[0]?.text;
+        const data = content ? JSON.parse(content) : null;
+        if (!data || !data.tables) {
+            return [];
+        }
+        // Fetch schema for each table to get column names
+        const tablesWithColumns = [];
+        for (const table of data.tables) {
+            try {
+                const schemaResponse = await fetch(`${egdeskUrl}/user-data/tools/call`, {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify({
+                        tool: 'user_data_get_schema',
+                        arguments: { tableName: table.tableName }
+                    })
+                });
+                if (schemaResponse.ok) {
+                    const schemaResult = await schemaResponse.json();
+                    const schemaContent = schemaResult.result?.content?.[0]?.text;
+                    const schemaData = schemaContent ? JSON.parse(schemaContent) : null;
+                    tablesWithColumns.push({
+                        id: table.id,
+                        tableName: table.tableName,
+                        displayName: table.displayName,
+                        description: table.description,
+                        rowCount: table.rowCount,
+                        columnCount: table.columnCount,
+                        columns: schemaData?.schema?.map((col) => col.name) || []
+                    });
+                }
+            }
+            catch (error) {
+                console.warn(`Failed to fetch schema for ${table.tableName}:`, error);
+                // Add table without column info
+                tablesWithColumns.push({
+                    ...table,
+                    columns: []
+                });
+            }
+        }
+        return tablesWithColumns;
+    }
+    catch (error) {
+        console.error('Failed to discover tables:', error);
+        throw error;
+    }
+}
+/**
+ * Read existing .env.local file or return empty object
+ */
+function readEnvLocal(projectPath) {
+    const envPath = path.join(projectPath, '.env.local');
+    if (!fs.existsSync(envPath)) {
+        return {};
+    }
+    const envContent = fs.readFileSync(envPath, 'utf-8');
+    const envVars = {};
+    for (const line of envContent.split('\n')) {
+        const trimmed = line.trim();
+        if (trimmed && !trimmed.startsWith('#')) {
+            const [key, ...valueParts] = trimmed.split('=');
+            if (key && valueParts.length > 0) {
+                envVars[key.trim()] = valueParts.join('=').trim();
+            }
+        }
+    }
+    return envVars;
+}
+/**
+ * Update .env.local file with Next.js environment variables
+ */
+function updateEnvLocal(projectPath, config) {
+    const envPath = path.join(projectPath, '.env.local');
+    const existingVars = readEnvLocal(projectPath);
+    // Merge with existing vars, prioritizing new EGDesk values
+    const newVars = {
+        ...existingVars,
+        'NEXT_PUBLIC_EGDESK_API_URL': config.baseUrl,
+        ...(config.apiKey && { 'NEXT_PUBLIC_EGDESK_API_KEY': config.apiKey })
+    };
+    const envContent = [
+        '# EGDesk User Data Configuration',
+        `# Generated at: ${config.generatedAt}`,
+        '',
+        ...Object.entries(newVars).map(([key, value]) => `${key}=${value}`),
+        '',
+        '# Available Tables',
+        `# Total tables: ${config.tables.length}`,
+        ...config.tables.map((table, index) => `# ${index + 1}. ${table.displayName} (${table.tableName}) - ${table.rowCount} rows, ${table.columnCount} columns`),
+        ''
+    ].join('\n');
+    fs.writeFileSync(envPath, envContent, 'utf-8');
+    console.log(`✅ Updated ${envPath}`);
+}
+/**
+ * Generate TypeScript config file with table definitions
+ */
+function generateConfigFile(projectPath, config) {
+    const configPath = path.join(projectPath, 'egdesk.config.ts');
+    const configContent = `/**
+ * EGDesk User Data Configuration
+ * Generated at: ${config.generatedAt}
+ *
+ * This file contains type-safe definitions for your EGDesk tables.
+ */
+
+export const EGDESK_CONFIG = {
+  apiUrl: '${config.baseUrl}',
+  apiKey: ${config.apiKey ? `'${config.apiKey}'` : 'undefined'},
+} as const;
+
+export interface TableDefinition {
+  name: string;
+  displayName: string;
+  description?: string;
+  rowCount: number;
+  columnCount: number;
+  columns: string[];
+}
+
+export const TABLES = {
+${config.tables.map((table, index) => `  table${index + 1}: {
+    name: '${table.tableName}',
+    displayName: '${table.displayName}',
+    description: ${table.description ? `'${table.description}'` : 'undefined'},
+    rowCount: ${table.rowCount},
+    columnCount: ${table.columnCount},
+    columns: [${table.columns.map(col => `'${col}'`).join(', ')}]
+  } as TableDefinition`).join(',\n')}
+} as const;
+
+${config.tables.length > 0 ? `
+// Main table (first table by default)
+export const MAIN_TABLE = TABLES.table1;
+` : ''}
+
+// Helper to get table by name
+export function getTableByName(tableName: string): TableDefinition | undefined {
+  return Object.values(TABLES).find(t => t.name === tableName);
+}
+
+// Export table names for easy access
+export const TABLE_NAMES = {
+${config.tables.map((table, index) => `  table${index + 1}: '${table.tableName}'`).join(',\n')}
+} as const;
+`;
+    fs.writeFileSync(configPath, configContent, 'utf-8');
+    console.log(`✅ Generated ${configPath}`);
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@egdesk/next-api-plugin",
+  "version": "1.0.0",
+  "description": "Next.js plugin for EGDesk database proxy integration",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "egdesk-next-setup": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "nextjs",
+    "egdesk",
+    "database",
+    "proxy"
+  ],
+  "author": "EGDesk",
+  "license": "MIT",
+  "peerDependencies": {
+    "next": ">=13.0.0"
+  },
+  "dependencies": {
+    "dotenv": "^16.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "next": "^14.0.0",
+    "typescript": "^5.3.0"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for @egdesk/next-api-plugin
+ *
+ * Usage:
+ *   npx egdesk-next-setup
+ *   npx egdesk-next-setup --url http://localhost:8080 --api-key YOUR_KEY
+ */
+
+import { setupNextApiPlugin } from './index';
+import * as path from 'path';
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  // Parse command line arguments
+  let egdeskUrl = 'http://localhost:8080';
+  let apiKey: string | undefined;
+  let useProxy = true; // Use proxy.ts by default (Next.js 16+)
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--url' && i + 1 < args.length) {
+      egdeskUrl = args[i + 1];
+      i++;
+    } else if (args[i] === '--api-key' && i + 1 < args.length) {
+      apiKey = args[i + 1];
+      i++;
+    } else if (args[i] === '--legacy-middleware') {
+      useProxy = false;
+    } else if (args[i] === '--help' || args[i] === '-h') {
+      console.log('Usage: egdesk-next-setup [options]');
+      console.log('');
+      console.log('Options:');
+      console.log('  --url <url>             EGDesk server URL (default: http://localhost:8080)');
+      console.log('  --api-key <key>         API key for authentication');
+      console.log('  --legacy-middleware     Use middleware.ts instead of proxy.ts (for Next.js <16)');
+      console.log('  --help, -h              Show this help message');
+      console.log('');
+      console.log('Example:');
+      console.log('  egdesk-next-setup --url http://localhost:8080 --api-key mykey');
+      console.log('  egdesk-next-setup --legacy-middleware  # For Next.js <16');
+      process.exit(0);
+    }
+  }
+
+  // Get current working directory (project root)
+  const projectPath = process.cwd();
+
+  console.log('🚀 EGDesk Next.js Setup');
+  console.log(`📂 Project: ${projectPath}`);
+  console.log(`🔗 EGDesk URL: ${egdeskUrl}`);
+  console.log('');
+
+  try {
+    await setupNextApiPlugin(projectPath, { egdeskUrl, apiKey, useProxy });
+    process.exit(0);
+  } catch (error) {
+    console.error('Setup failed:', error);
+    process.exit(1);
+  }
+}
+
+main();