n8n-nodes-nvk-browser 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,76 @@
+# n8n-nodes-nvk-browser
+
+n8n custom nodes for managing Chrome browser profiles and page interactions.
+
+## Features
+
+### Profile Management
+- **Create Profile**: Create new browser profiles with proxy, extensions, and notes
+- **Delete Profile**: Delete existing profiles
+- **Start Profile**: Launch Chrome with a specific profile
+- **Stop Profile**: Stop a running browser instance
+
+### Page Interaction
+- **Move and Click**: Click on page elements using different methods (GhostCursor, Puppeteer, JavaScript)
+- **Run JavaScript**: Execute JavaScript code in browser tabs
+
+## Installation
+
+1. Install dependencies:
+```bash
+npm install
+```
+
+2. Build the package:
+```bash
+npm run build
+```
+
+3. Copy the `dist` folder to your n8n custom nodes directory:
+```bash
+cp -r dist /path/to/n8n/custom/nodes/
+```
+
+## Configuration
+
+Set the following environment variables (optional, defaults are provided):
+
+- `NVK_BROWSER_PATH`: Path to Chrome executable (default: `browser-142/chrome.exe`)
+- `NVK_PROFILES_DIR`: Path to profiles directory (default: `profiles`)
+
+## Usage
+
+### Create Profile
+1. Add "Create Profile" node to your workflow
+2. Enter Profile Name (required)
+3. Optionally add Proxy, Note, and Extensions
+4. Execute to create a new profile
+
+### Start Profile
+1. Add "Start Profile" node
+2. Enter Profile ID (required)
+3. Configure window settings (scale, position, size, headless mode)
+4. Execute to launch Chrome with the profile
+
+### Move and Click
+1. Add "Move and Click" node
+2. Enter Profile ID and CSS Selector
+3. Choose click method (GhostCursor, Puppeteer, or JavaScript)
+4. Configure additional options if using JavaScript click
+
+### Run JavaScript
+1. Add "Run JavaScript" node
+2. Enter Profile ID and JavaScript code
+3. Specify tab index if needed
+4. Execute to run the code
+
+## Requirements
+
+- Node.js 18+
+- n8n
+- Chrome browser (included in `browser-142` folder)
+
+## License
+
+MIT
+

package/dist/nodes/PageInteraction/MoveAndClick/MoveAndClick.description.d.ts

@@ -0,0 +1,2 @@
+import { INodeProperties } from 'n8n-workflow';
+export declare const moveAndClickFields: INodeProperties[];

package/dist/nodes/PageInteraction/MoveAndClick/MoveAndClick.description.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.moveAndClickFields = void 0;
+exports.moveAndClickFields = [
+    {
+        displayName: 'Profile ID',
+        name: 'profileId',
+        type: 'string',
+        required: true,
+        default: '',
+        description: 'ID of the running profile',
+        displayOptions: {
+            show: {
+                resource: ['page'],
+                operation: ['moveAndClick'],
+            },
+        },
+    },
+    {
+        displayName: 'Selector',
+        name: 'selector',
+        type: 'string',
+        required: true,
+        default: '',
+        description: 'CSS selector of the element to click',
+        displayOptions: {
+            show: {
+                resource: ['page'],
+                operation: ['moveAndClick'],
+            },
+        },
+    },
+    {
+        displayName: 'Click Method',
+        name: 'clickMethod',
+        type: 'options',
+        options: [
+            {
+                name: 'Use GhostCursor',
+                value: 'ghostcursor',
+            },
+            {
+                name: 'Use Puppeteer',
+                value: 'puppeteer',
+            },
+            {
+                name: 'Use Javascript Click',
+                value: 'javascript',
+            },
+        ],
+        default: 'puppeteer',
+        description: 'Method to use for clicking',
+        displayOptions: {
+            show: {
+                resource: ['page'],
+                operation: ['moveAndClick'],
+            },
+        },
+    },
+    {
+        displayName: 'Wait For Click (Milliseconds)',
+        name: 'waitForClick',
+        type: 'number',
+        default: 0,
+        description: 'Wait time before clicking in milliseconds',
+        displayOptions: {
+            show: {
+                resource: ['page'],
+                operation: ['moveAndClick'],
+                clickMethod: ['javascript'],
+            },
+        },
+    },
+    {
+        displayName: 'Button',
+        name: 'button',
+        type: 'options',
+        options: [
+            {
+                name: 'Left',
+                value: 'left',
+            },
+            {
+                name: 'Right',
+                value: 'right',
+            },
+            {
+                name: 'Middle',
+                value: 'middle',
+            },
+        ],
+        default: 'left',
+        description: 'Mouse button to use',
+        displayOptions: {
+            show: {
+                resource: ['page'],
+                operation: ['moveAndClick'],
+                clickMethod: ['javascript'],
+            },
+        },
+    },
+    {
+        displayName: 'Click Count',
+        name: 'clickCount',
+        type: 'number',
+        default: 1,
+        typeOptions: {
+            minValue: 1,
+        },
+        description: 'Number of times to click',
+        displayOptions: {
+            show: {
+                resource: ['page'],
+                operation: ['moveAndClick'],
+                clickMethod: ['javascript'],
+            },
+        },
+    },
+    {
+        displayName: 'Tab Index',
+        name: 'tabIndex',
+        type: 'number',
+        default: 0,
+        description: 'Index of the tab to interact with (0 = first tab)',
+        displayOptions: {
+            show: {
+                resource: ['page'],
+                operation: ['moveAndClick'],
+            },
+        },
+    },
+];

package/dist/nodes/PageInteraction/MoveAndClick/MoveAndClick.node.d.ts

@@ -0,0 +1,5 @@
+import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class MoveAndClick implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/PageInteraction/MoveAndClick/MoveAndClick.node.js

@@ -0,0 +1,176 @@
+"use strict";
+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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MoveAndClick = void 0;
+const BrowserManager_1 = require("../../../utils/BrowserManager");
+const MoveAndClick_description_1 = require("./MoveAndClick.description");
+const path = __importStar(require("path"));
+class MoveAndClick {
+    constructor() {
+        this.description = {
+            displayName: 'Move and Click',
+            name: 'moveAndClick',
+            icon: 'file:click.svg',
+            group: ['transform'],
+            version: 1,
+            description: 'Move mouse and click on an element',
+            defaults: {
+                name: 'Move and Click',
+            },
+            inputs: ['main'],
+            outputs: ['main'],
+            properties: [
+                {
+                    displayName: 'Resource',
+                    name: 'resource',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Page',
+                            value: 'page',
+                        },
+                    ],
+                    default: 'page',
+                },
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Move and Click',
+                            value: 'moveAndClick',
+                            description: 'Move and click on an element',
+                            action: 'Move and click',
+                        },
+                    ],
+                    default: 'moveAndClick',
+                },
+                ...MoveAndClick_description_1.moveAndClickFields,
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const workspacePath = process.cwd();
+        const profilesDir = process.env.NVK_PROFILES_DIR || path.join(workspacePath, 'profiles');
+        const browserPath = process.env.NVK_BROWSER_PATH || path.join(workspacePath, 'browser-142', 'chrome.exe');
+        const resolvedBrowserPath = path.isAbsolute(browserPath)
+            ? browserPath
+            : path.resolve(workspacePath, browserPath);
+        const resolvedProfilesDir = path.isAbsolute(profilesDir)
+            ? profilesDir
+            : path.resolve(workspacePath, profilesDir);
+        BrowserManager_1.BrowserManager.resetInstance(); // Reset để đảm bảo dùng đúng paths
+        const browserManager = BrowserManager_1.BrowserManager.getInstance(resolvedBrowserPath, resolvedProfilesDir);
+        for (let i = 0; i < items.length; i++) {
+            try {
+                const profileId = this.getNodeParameter('profileId', i);
+                const selector = this.getNodeParameter('selector', i);
+                const clickMethod = this.getNodeParameter('clickMethod', i) || 'puppeteer';
+                const waitForClick = this.getNodeParameter('waitForClick', i) || 0;
+                const button = this.getNodeParameter('button', i) || 'left';
+                const clickCount = this.getNodeParameter('clickCount', i) || 1;
+                const tabIndex = this.getNodeParameter('tabIndex', i) || 0;
+                const instance = browserManager.getInstance(profileId);
+                if (!instance) {
+                    throw new Error(`Profile ${profileId} is not running`);
+                }
+                const page = await browserManager.getPage(profileId, tabIndex);
+                if (!page) {
+                    throw new Error(`Could not get page for profile ${profileId}`);
+                }
+                // Wait for element if needed
+                await page.waitForSelector(selector, { timeout: 30000 });
+                if (clickMethod === 'javascript') {
+                    // Wait before clicking
+                    if (waitForClick > 0) {
+                        await page.waitForTimeout(waitForClick);
+                    }
+                    // JavaScript click
+                    const buttonMap = {
+                        left: 0,
+                        middle: 1,
+                        right: 2,
+                    };
+                    await page.evaluate((sel, btn, count) => {
+                        // This code runs in browser context, so DOM APIs are available
+                        // eslint-disable-next-line @typescript-eslint/no-implied-eval
+                        const element = document.querySelector(sel);
+                        if (element) {
+                            for (let i = 0; i < count; i++) {
+                                const event = new MouseEvent('click', {
+                                    view: window,
+                                    bubbles: true,
+                                    cancelable: true,
+                                    button: btn,
+                                });
+                                element.dispatchEvent(event);
+                            }
+                        }
+                    }, selector, buttonMap[button] || 0, clickCount);
+                }
+                else if (clickMethod === 'puppeteer') {
+                    // Puppeteer native click
+                    await page.click(selector);
+                }
+                else if (clickMethod === 'ghostcursor') {
+                    // GhostCursor simulation (simplified - would need ghost-cursor package)
+                    const element = await page.$(selector);
+                    if (element) {
+                        const box = await element.boundingBox();
+                        if (box) {
+                            // Move mouse to center of element
+                            await page.mouse.move(box.x + box.width / 2, box.y + box.height / 2);
+                            await page.waitForTimeout(100);
+                            await page.mouse.click(box.x + box.width / 2, box.y + box.height / 2);
+                        }
+                    }
+                }
+                returnData.push({
+                    json: {
+                        success: true,
+                        selector,
+                        method: clickMethod,
+                        message: 'Click performed successfully',
+                    },
+                });
+            }
+            catch (error) {
+                returnData.push({
+                    json: {
+                        success: false,
+                        error: error instanceof Error ? error.message : String(error),
+                    },
+                });
+            }
+        }
+        return [returnData];
+    }
+}
+exports.MoveAndClick = MoveAndClick;

package/dist/nodes/PageInteraction/MoveAndClick/click.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M9 9l5 12 1.774-5.226L21 14 9 9z"></path>
+  <path d="M21 3l-3.5 3.5"></path>
+</svg>
+

package/dist/nodes/PageInteraction/MoveAndClick/code.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <polyline points="16 18 22 12 16 6"></polyline>
+  <polyline points="8 6 2 12 8 18"></polyline>
+</svg>
+

package/dist/nodes/PageInteraction/MoveAndClick/profile.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M20 21v-2a4 4 0 0 0-4-4H8a4 4 0 0 0-4 4v2"></path>
+  <circle cx="12" cy="7" r="4"></circle>
+</svg>
+

package/dist/nodes/PageInteraction/RunJavaScript/RunJavaScript.description.d.ts

@@ -0,0 +1,2 @@
+import { INodeProperties } from 'n8n-workflow';
+export declare const runJavaScriptFields: INodeProperties[];

package/dist/nodes/PageInteraction/RunJavaScript/RunJavaScript.description.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runJavaScriptFields = void 0;
+exports.runJavaScriptFields = [
+    {
+        displayName: 'Profile ID',
+        name: 'profileId',
+        type: 'string',
+        required: true,
+        default: '',
+        description: 'ID of the running profile',
+        displayOptions: {
+            show: {
+                resource: ['page'],
+                operation: ['runJavaScript'],
+            },
+        },
+    },
+    {
+        displayName: 'Debug Port',
+        name: 'debugPort',
+        type: 'number',
+        default: 0,
+        description: 'Debug port (0 = use default from instance)',
+        displayOptions: {
+            show: {
+                resource: ['page'],
+                operation: ['runJavaScript'],
+            },
+        },
+    },
+    {
+        displayName: 'Tab Index',
+        name: 'tabIndex',
+        type: 'number',
+        default: 0,
+        description: 'Index of the tab to run JavaScript on (0 = first tab)',
+        displayOptions: {
+            show: {
+                resource: ['page'],
+                operation: ['runJavaScript'],
+            },
+        },
+    },
+    {
+        displayName: 'JavaScript Code',
+        name: 'javascriptCode',
+        type: 'string',
+        typeOptions: {
+            rows: 10,
+        },
+        required: true,
+        default: '',
+        description: 'JavaScript code to execute',
+        displayOptions: {
+            show: {
+                resource: ['page'],
+                operation: ['runJavaScript'],
+            },
+        },
+    },
+];

package/dist/nodes/PageInteraction/RunJavaScript/RunJavaScript.node.d.ts

@@ -0,0 +1,5 @@
+import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class RunJavaScript implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/PageInteraction/RunJavaScript/RunJavaScript.node.js

@@ -0,0 +1,126 @@
+"use strict";
+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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RunJavaScript = void 0;
+const BrowserManager_1 = require("../../../utils/BrowserManager");
+const RunJavaScript_description_1 = require("./RunJavaScript.description");
+const path = __importStar(require("path"));
+class RunJavaScript {
+    constructor() {
+        this.description = {
+            displayName: 'Run JavaScript',
+            name: 'runJavaScript',
+            icon: 'file:code.svg',
+            group: ['transform'],
+            version: 1,
+            description: 'Execute JavaScript code in the browser',
+            defaults: {
+                name: 'Run JavaScript',
+            },
+            inputs: ['main'],
+            outputs: ['main'],
+            properties: [
+                {
+                    displayName: 'Resource',
+                    name: 'resource',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Page',
+                            value: 'page',
+                        },
+                    ],
+                    default: 'page',
+                },
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Run JavaScript',
+                            value: 'runJavaScript',
+                            description: 'Execute JavaScript code',
+                            action: 'Run JavaScript',
+                        },
+                    ],
+                    default: 'runJavaScript',
+                },
+                ...RunJavaScript_description_1.runJavaScriptFields,
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const workspacePath = process.cwd();
+        const profilesDir = process.env.NVK_PROFILES_DIR || path.join(workspacePath, 'profiles');
+        const browserPath = process.env.NVK_BROWSER_PATH || path.join(workspacePath, 'browser-142', 'chrome.exe');
+        const resolvedBrowserPath = path.isAbsolute(browserPath)
+            ? browserPath
+            : path.resolve(workspacePath, browserPath);
+        const resolvedProfilesDir = path.isAbsolute(profilesDir)
+            ? profilesDir
+            : path.resolve(workspacePath, profilesDir);
+        BrowserManager_1.BrowserManager.resetInstance(); // Reset để đảm bảo dùng đúng paths
+        const browserManager = BrowserManager_1.BrowserManager.getInstance(resolvedBrowserPath, resolvedProfilesDir);
+        for (let i = 0; i < items.length; i++) {
+            try {
+                const profileId = this.getNodeParameter('profileId', i);
+                const tabIndex = this.getNodeParameter('tabIndex', i) || 0;
+                const javascriptCode = this.getNodeParameter('javascriptCode', i);
+                const instance = browserManager.getInstance(profileId);
+                if (!instance) {
+                    throw new Error(`Profile ${profileId} is not running`);
+                }
+                const page = await browserManager.getPage(profileId, tabIndex);
+                if (!page) {
+                    throw new Error(`Could not get page for profile ${profileId}`);
+                }
+                // Execute JavaScript
+                const result = await page.evaluate(javascriptCode);
+                returnData.push({
+                    json: {
+                        success: true,
+                        result: result,
+                        message: 'JavaScript executed successfully',
+                    },
+                });
+            }
+            catch (error) {
+                returnData.push({
+                    json: {
+                        success: false,
+                        error: error instanceof Error ? error.message : String(error),
+                    },
+                });
+            }
+        }
+        return [returnData];
+    }
+}
+exports.RunJavaScript = RunJavaScript;

package/dist/nodes/PageInteraction/RunJavaScript/click.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M9 9l5 12 1.774-5.226L21 14 9 9z"></path>
+  <path d="M21 3l-3.5 3.5"></path>
+</svg>
+

package/dist/nodes/PageInteraction/RunJavaScript/code.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <polyline points="16 18 22 12 16 6"></polyline>
+  <polyline points="8 6 2 12 8 18"></polyline>
+</svg>
+

package/dist/nodes/PageInteraction/RunJavaScript/profile.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M20 21v-2a4 4 0 0 0-4-4H8a4 4 0 0 0-4 4v2"></path>
+  <circle cx="12" cy="7" r="4"></circle>
+</svg>
+

package/dist/nodes/ProfileManagement/CreateProfile/CreateProfile.description.d.ts

@@ -0,0 +1,2 @@
+import { INodeProperties } from 'n8n-workflow';
+export declare const createProfileFields: INodeProperties[];