@rn-ave/metro-plugin 0.1.0

package/README.md

@@ -0,0 +1,27 @@
+# @rn-ave/metro-plugin
+
+Metro plugin for `rn-ave`. Enables "Open in Cursor" functionality.
+
+## Installation
+
+```bash
+npm install @rn-ave/metro-plugin
+```
+
+## Usage
+
+```js
+// metro.config.js
+const { withAVE } = require('@rn-ave/metro-plugin');
+
+const config = {
+  // your metro config
+};
+
+module.exports = withAVE(config);
+```
+
+## Features
+
+- **Cursor Bridge**: Opens Cursor deeplinks from the host machine (useful for simulators).
+- **File Opening**: Standard endpoint for opening files at specific lines.

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Metro plugin for rn-ave
+ * Provides server middleware for opening files in Cursor editor
+ */
+export interface OpenFileRequest {
+    file: string;
+    absolutePath?: string;
+    lineNumber?: number;
+    line?: number;
+    column?: number;
+}
+/**
+ * Metro configuration helper
+ * Wraps your Metro config to add rn-ave middleware
+ */
+export declare function withAVE<T extends object>(metroConfig: T): T;

package/dist/index.js

@@ -0,0 +1,207 @@
+"use strict";
+/**
+ * Metro plugin for rn-ave
+ * Provides server middleware for opening files in Cursor editor
+ */
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withAVE = withAVE;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const child_process_1 = require("child_process");
+// @ts-ignore - launch-editor doesn't have types
+const launch_editor_1 = __importDefault(require("launch-editor"));
+/**
+ * Format file path with line and column for launch-editor
+ */
+function formatFilePathWithPosition(filePath, lineNumber, column) {
+    if (lineNumber) {
+        if (column) {
+            return `${filePath}:${lineNumber}:${column}`;
+        }
+        return `${filePath}:${lineNumber}`;
+    }
+    return filePath;
+}
+/**
+ * Open a file in Cursor editor
+ */
+async function openInEditor(request) {
+    const cwd = process.cwd();
+    // Resolve file path
+    let filePath = request.absolutePath || request.file;
+    if (!path.isAbsolute(filePath)) {
+        filePath = path.resolve(cwd, filePath);
+    }
+    // Check if file exists
+    if (!fs.existsSync(filePath)) {
+        return {
+            success: false,
+            error: `File not found: ${filePath}`,
+        };
+    }
+    const lineNumber = request.lineNumber || request.line;
+    const column = request.column;
+    const fileWithPosition = formatFilePathWithPosition(filePath, lineNumber, column);
+    return new Promise((resolve) => {
+        try {
+            (0, launch_editor_1.default)(fileWithPosition, 'cursor', // Always use Cursor
+            (fileName, errorMsg) => {
+                const errorMessage = errorMsg || 'Unknown error launching editor';
+                resolve({ success: false, error: errorMessage });
+            });
+            setTimeout(() => {
+                resolve({ success: true });
+            }, 100);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            resolve({ success: false, error: `Failed to launch editor: ${errorMessage}` });
+        }
+    });
+}
+// Endpoints
+const LAUNCH_EDITOR_ENDPOINT = '/__inspect-open-in-editor';
+const CURSOR_PROMPT_ENDPOINT = '/__rn_ave__/cursor-prompt';
+const STATUS_ENDPOINT = '/__rn_ave__/status';
+function parseQueryParams(url) {
+    const queryIndex = url.indexOf('?');
+    if (queryIndex === -1)
+        return {};
+    const queryString = url.slice(queryIndex + 1);
+    const params = {};
+    for (const pair of queryString.split('&')) {
+        const [key, value] = pair.split('=');
+        if (key) {
+            params[decodeURIComponent(key)] = value ? decodeURIComponent(value) : '';
+        }
+    }
+    return params;
+}
+/**
+ * Create the Metro server middleware
+ */
+function createInspectorMiddleware() {
+    return async function inspectorMiddleware(req, res, next) {
+        const urlPath = req.url?.split('?')[0];
+        // Open in editor endpoint
+        if (urlPath === LAUNCH_EDITOR_ENDPOINT && req.method === 'GET') {
+            const params = parseQueryParams(req.url || '');
+            if (!params.file && !params.fileName) {
+                res.writeHead(400, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ success: false, error: 'Missing file parameter' }));
+                return;
+            }
+            const request = {
+                file: params.file || params.fileName,
+                lineNumber: params.line ? parseInt(params.line, 10) : undefined,
+                column: params.column ? parseInt(params.column, 10) : undefined,
+            };
+            const result = await openInEditor(request);
+            res.writeHead(result.success ? 200 : 500, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify(result));
+            return;
+        }
+        // Status endpoint
+        if (urlPath === STATUS_ENDPOINT && req.method === 'GET') {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ status: 'ok', version: '1.0.0', editor: 'cursor' }));
+            return;
+        }
+        // Cursor prompt endpoint - opens deeplink on Mac side
+        if (urlPath === CURSOR_PROMPT_ENDPOINT && req.method === 'POST') {
+            let body = '';
+            req.on('data', (chunk) => { body += chunk.toString(); });
+            req.on('end', () => {
+                try {
+                    const { promptText } = JSON.parse(body);
+                    if (!promptText || typeof promptText !== 'string') {
+                        res.writeHead(400, { 'Content-Type': 'application/json' });
+                        res.end(JSON.stringify({ success: false, error: 'Missing promptText' }));
+                        return;
+                    }
+                    // Build Cursor deeplink URL
+                    const baseUrl = 'cursor://anysphere.cursor-deeplink/prompt';
+                    const encodedText = encodeURIComponent(promptText);
+                    const deeplinkUrl = `${baseUrl}?text=${encodedText}`;
+                    // Use execFile to open the deeplink on macOS
+                    (0, child_process_1.execFile)('open', [deeplinkUrl], (error) => {
+                        if (error) {
+                            res.writeHead(500, { 'Content-Type': 'application/json' });
+                            res.end(JSON.stringify({ success: false, error: error.message }));
+                        }
+                        else {
+                            res.writeHead(200, { 'Content-Type': 'application/json' });
+                            res.end(JSON.stringify({ success: true }));
+                        }
+                    });
+                }
+                catch (e) {
+                    res.writeHead(400, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ success: false, error: 'Invalid request body' }));
+                }
+            });
+            return;
+        }
+        next();
+    };
+}
+/**
+ * Metro configuration helper
+ * Wraps your Metro config to add rn-ave middleware
+ */
+function withAVE(metroConfig) {
+    const middleware = createInspectorMiddleware();
+    const serverConfig = metroConfig.server || {};
+    const existingEnhanceMiddleware = serverConfig.enhanceMiddleware;
+    return {
+        ...metroConfig,
+        server: {
+            ...serverConfig,
+            enhanceMiddleware: (middleware2, server) => {
+                let enhanced = middleware2;
+                if (existingEnhanceMiddleware) {
+                    enhanced = existingEnhanceMiddleware(middleware2, server);
+                }
+                return (req, res, next) => {
+                    middleware(req, res, () => { enhanced(req, res, next); });
+                };
+            },
+        },
+    };
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@rn-ave/metro-plugin",
+  "version": "0.1.0",
+  "description": "Metro plugin for rn-ave - enables 'Open in Cursor' functionality",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch"
+  },
+  "keywords": ["react-native", "metro", "ave", "visual-edit", "cursor", "open-in-editor"],
+  "license": "MIT",
+  "dependencies": {
+    "launch-editor": "^2.9.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  }
+}