graphjin 3.2.3 → 3.2.5

package/README.md

@@ -42,8 +42,8 @@ docker pull dosco/graphjin
 
 ```bash
 # With Claude Desktop - run the demo
-graphjin mcp demo --path examples/webshop/config
-graphjin mcp demo info  # Copy output to Claude Desktop config
+graphjin mcp --demo --path examples/webshop/config
+graphjin mcp info --demo  # Copy output to Claude Desktop config
 
 # With your own database
 graphjin mcp --path /path/to/config
@@ -52,6 +52,67 @@ graphjin mcp info  # Copy output to Claude Desktop config
 
 Within minutes, ask Claude: "What products do we have?" or "Show me orders from last week"
 
+## Using with Claude Desktop
+
+### Option A: Local Mode (Starts with Claude)
+
+1. **Install GraphJin**
+   ```bash
+   npm install -g graphjin
+   ```
+
+2. **Get the config JSON**
+   ```bash
+   graphjin mcp info --path /path/to/your/config
+   ```
+
+3. **Add to Claude Desktop**
+   - Open Claude Desktop settings
+   - Edit `claude_desktop_config.json`
+   - Paste the JSON output
+   - Restart Claude Desktop
+
+### Option B: Remote Mode (Always-On Server)
+
+1. **Start GraphJin on server**
+   ```bash
+   graphjin serve --path /path/to/config
+   ```
+
+2. **Get the proxy config** (on your local machine)
+   ```bash
+   # For local server
+   graphjin mcp info --server 127.0.0.1:8080
+
+   # For remote server
+   graphjin mcp info --server 10.0.0.5:8080
+   ```
+
+3. **Add to Claude Desktop**
+   - Paste the JSON into `claude_desktop_config.json`
+   - Restart Claude Desktop
+
+### Try the Webshop Demo
+
+1. **Start the demo**
+   ```bash
+   graphjin mcp --demo --path examples/webshop/config
+   ```
+
+2. **Get config and add to Claude Desktop**
+   ```bash
+   graphjin mcp info --demo --path examples/webshop/config
+   ```
+
+3. **Ask Claude questions like:**
+   - "What tables are in the database?"
+   - "Show me all products under $50"
+   - "List customers and their purchases"
+   - "What's the total revenue by product?"
+   - "Find products with 'wireless' in the name"
+   - "Add a new product called 'USB-C Cable' for $19.99"
+   - "Which customers have returned items?"
+
 ## How It Works
 
 1. **Connects to database** - Reads your schema automatically
@@ -168,19 +229,22 @@ graphjin mcp --path /path/to/config
 graphjin mcp info
 
 # Run with temporary database container
-graphjin mcp demo --path examples/webshop/config
+graphjin mcp --demo --path examples/webshop/config
 
 # Show demo mode config JSON
-graphjin mcp demo info
+graphjin mcp info --demo
 
 # Keep data between restarts
-graphjin mcp demo --persist
+graphjin mcp --demo --persist
 
 # Override database type
-graphjin mcp demo --db mysql
+graphjin mcp --demo --db mysql
 
 # Set auth context
 graphjin mcp --user-id admin --user-role admin
+
+# HTTP server with demo database
+graphjin serve --demo --path examples/webshop/config
 ```
 
 **Claude Desktop config** (`claude_desktop_config.json`):

package/bin/graphjin.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+const { spawn } = require('child_process');
+const path = require('path');
+
+const ext = process.platform === 'win32' ? '.exe' : '';
+const binary = path.join(__dirname, 'graphjin' + ext);
+
+const child = spawn(binary, process.argv.slice(2), { stdio: 'inherit' });
+
+child.on('error', (err) => {
+  console.error(`Failed to start graphjin: ${err.message}`);
+  console.error('Try reinstalling: npm install -g graphjin');
+  process.exit(1);
+});
+
+child.on('exit', (code) => process.exit(code || 0));

package/bin/install.js

@@ -0,0 +1,116 @@
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+// Map Node.js platform/arch to Go equivalents
+const PLATFORM_MAP = {
+  darwin: 'darwin',
+  linux: 'linux',
+  win32: 'windows',
+};
+
+const ARCH_MAP = {
+  x64: 'amd64',
+  arm64: 'arm64',
+};
+
+async function download(url, dest) {
+  return new Promise((resolve, reject) => {
+    const follow = (url) => {
+      https.get(url, (res) => {
+        if (res.statusCode === 302 || res.statusCode === 301) {
+          follow(res.headers.location);
+          return;
+        }
+        if (res.statusCode !== 200) {
+          reject(new Error(`Download failed: ${res.statusCode}`));
+          return;
+        }
+        const file = fs.createWriteStream(dest);
+        res.pipe(file);
+        file.on('finish', () => {
+          file.close();
+          resolve();
+        });
+      }).on('error', reject);
+    };
+    follow(url);
+  });
+}
+
+async function extract(tarPath, destDir) {
+  // Use tar module for extraction
+  const tar = require('tar');
+  await tar.x({
+    file: tarPath,
+    cwd: destDir,
+    filter: (path) => path === 'graphjin' || path === 'graphjin.exe',
+  });
+}
+
+async function install() {
+  const pkg = require('../package.json');
+  const version = pkg.version;
+
+  const platform = PLATFORM_MAP[process.platform];
+  const arch = ARCH_MAP[process.arch];
+
+  if (!platform || !arch) {
+    console.error(`Unsupported platform: ${process.platform} ${process.arch}`);
+    console.error('Please download manually from: https://github.com/dosco/graphjin/releases');
+    process.exit(1);
+  }
+
+  const ext = platform === 'windows' ? '.zip' : '.tar.gz';
+  const filename = `graphjin_${platform}_${arch}${ext}`;
+  const url = `https://github.com/dosco/graphjin/releases/download/v${version}/${filename}`;
+
+  const binDir = __dirname;
+  const archivePath = path.join(binDir, filename);
+  const binaryName = platform === 'windows' ? 'graphjin.exe' : 'graphjin';
+  const binaryPath = path.join(binDir, binaryName);
+
+  // Skip if binary already exists
+  if (fs.existsSync(binaryPath)) {
+    console.log('GraphJin binary already installed');
+    return;
+  }
+
+  console.log(`Downloading GraphJin v${version} for ${platform}/${arch}...`);
+
+  try {
+    await download(url, archivePath);
+
+    console.log('Extracting...');
+
+    if (platform === 'windows') {
+      // For Windows, use PowerShell to extract
+      execSync(`powershell -command "Expand-Archive -Path '${archivePath}' -DestinationPath '${binDir}' -Force"`, {
+        stdio: 'inherit',
+      });
+    } else {
+      await extract(archivePath, binDir);
+    }
+
+    // Set executable permission on Unix
+    if (platform !== 'windows') {
+      fs.chmodSync(binaryPath, 0o755);
+    }
+
+    // Clean up archive
+    fs.unlinkSync(archivePath);
+
+    console.log('GraphJin installed successfully!');
+  } catch (err) {
+    console.error(`Failed to install GraphJin: ${err.message}`);
+    console.error('Please download manually from: https://github.com/dosco/graphjin/releases');
+    // Clean up on failure
+    try {
+      fs.unlinkSync(archivePath);
+    } catch {}
+    process.exit(1);
+  }
+}
+
+install();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "graphjin",
-  "version": "3.2.3",
+  "version": "3.2.5",
   "description": "GraphJin CLI - Build APIs in 5 minutes with GraphQL",
   "bin": {
     "graphjin": "bin/graphjin.js"