n8n-nodes-bambulab 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 n8n-nodes-bambulab Contributors
+
+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,273 @@
+# n8n-nodes-bambulab
+
+[![NPM Version](https://img.shields.io/npm/v/n8n-nodes-bambulab)](https://www.npmjs.com/package/n8n-nodes-bambulab)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+This is an n8n community node that lets you control and monitor Bambu Lab 3D printers directly from your n8n workflows.
+
+[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.
+
+[Installation](#installation)
+[Operations](#operations)
+[Credentials](#credentials)
+[Compatibility](#compatibility)
+[Usage](#usage)
+[Resources](#resources)
+
+## Installation
+
+Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.
+
+### Manual Installation
+
+1. Navigate to your n8n installation directory
+2. Install the package:
+   ```bash
+   npm install n8n-nodes-bambulab
+   ```
+3. Restart your n8n instance
+
+### Prerequisites
+
+**IMPORTANT:** Before using this node, you MUST enable **Developer Mode** on your Bambu Lab printer. This grants local network access via MQTT and FTP.
+
+⚠️ **Security Warning:** Developer Mode disables authentication and allows full control over your printer. Use only on trusted networks.
+
+#### Enabling Developer Mode
+
+1. On your printer, go to **Settings** → **General** → **Developer Mode**
+2. Enable **Developer Mode**
+3. Note your **LAN Access Code** from **Settings** → **Network** → **LAN Access Code**
+4. Note your **Serial Number** from **Settings** → **Device** → **Serial Number**
+5. Ensure your printer is connected to the same network as your n8n instance
+
+📖 [Official Guide: Enable Developer Mode](https://wiki.bambulab.com/en/knowledge-sharing/enable-developer-mode)
+
+## Operations
+
+### Print Resource
+Control print jobs on your printer.
+
+- **Start**: Start a print job from a file on the printer's SD card
+  - File name (required)
+  - Options: Bed leveling, flow calibration, vibration calibration, layer inspect, use AMS
+- **Pause**: Pause the current print job
+- **Resume**: Resume a paused print job
+- **Stop**: Stop the current print job
+
+### Status Resource
+Monitor printer status and get information.
+
+- **Get Current Status**: Retrieve full printer status (temperatures, progress, state, etc.)
+- **Get Print Progress**: Get progress information for the current print job
+- **Get Temperature**: Get current temperature readings (nozzle, bed, chamber)
+
+### File Resource
+Manage files on the printer via FTP.
+
+- **Upload**: Upload a G-code or 3MF file to the printer
+  - File content (required)
+  - File name (required)
+  - Remote path (default: `/`)
+- **List**: List files on the printer's SD card
+  - Path (default: `/`)
+- **Delete**: Delete a file from the printer
+  - File path (required)
+
+### Camera Resource
+Access the printer's camera.
+
+- **Get Stream URL**: Get URLs for the camera stream (RTSP and HTTP)
+- **Get Snapshot**: Get URL for capturing a snapshot
+
+⚠️ **Security Note**: The RTSP URL includes your access code for authentication (`rtsp://bblp:YOUR_ACCESS_CODE@PRINTER_IP/...`). Be careful not to expose these URLs in logs or share them publicly.
+
+### Control Resource
+Control printer hardware and settings.
+
+- **Set LED**: Control printer LED lights (chamber light, work light, logo LED)
+  - LED selection
+  - Mode: on, off, flashing
+- **Set Speed**: Set print speed percentage (50-166%)
+  - Speed percentage
+- **Home Axes**: Home all printer axes
+
+## Credentials
+
+This node requires Bambu Lab API credentials. You need the following information from your printer:
+
+1. **Printer IP Address**: The local network IP address of your printer
+   - Find in **Settings** → **Network** → **IP Address**
+2. **Access Code**: The LAN access code
+   - Find in **Settings** → **Network** → **LAN Access Code**
+3. **Serial Number**: The printer's serial number
+   - Find in **Settings** → **Device** → **Serial Number**
+4. **MQTT Port** (optional): Default is 8883 for secure connection
+5. **Use TLS** (optional): Default is enabled. Uses self-signed certificates.
+6. **FTP Port** (optional): Default is 990 for FTPS
+
+## Compatibility
+
+- **n8n Version**: 1.0.0+
+- **Node.js Version**: 22.0.0+
+- **Supported Printers**: X1 Series, P1 Series, A1 Series, A1 Mini
+
+This node uses:
+- **MQTT** for printer control and status monitoring
+- **FTP/FTPS** for file operations
+
+## Usage
+
+### Example: Upload and Print Workflow
+
+This workflow uploads a G-code file and starts printing:
+
+```
+[HTTP Request] Download .gcode file
+    ↓
+[Bambu Lab - File: Upload] Upload to printer
+    ↓
+[Bambu Lab - Print: Start] Start printing
+```
+
+### Example: Print Status Monitor
+
+Monitor print progress every 30 seconds:
+
+```
+[Schedule Trigger] Every 30 seconds
+    ↓
+[Bambu Lab - Status: Get Progress]
+    ↓
+[IF] Check if progress > 50%
+    ↓
+[Send Email] Notify when print is halfway done
+```
+
+### Example: Temperature Monitor
+
+Check temperatures and send alert if too high:
+
+```
+[Schedule Trigger] Every minute
+    ↓
+[Bambu Lab - Status: Get Temperature]
+    ↓
+[IF] Nozzle temp > 250°C
+    ↓
+[Slack] Send alert to #printer-alerts
+```
+
+### Example Workflow JSON
+
+See the `/examples` directory for complete workflow JSON files that you can import into n8n.
+
+## Troubleshooting
+
+### Connection Issues
+
+**Problem**: "MQTT connection timeout" or "Failed to connect to FTP server"
+
+**Solutions**:
+1. Verify your printer is on the same network as n8n
+2. Check that Developer Mode is enabled
+3. Confirm the printer IP address is correct
+4. Ensure firewall isn't blocking ports 8883 (MQTT) or 990 (FTP)
+5. Try pinging the printer: `ping <printer-ip>`
+
+### Authentication Errors
+
+**Problem**: "MQTT connection error: Not authorized"
+
+**Solutions**:
+1. Verify your Access Code is correct (Settings → Network → LAN Access Code)
+2. Ensure Developer Mode is enabled
+3. Try resetting the Access Code on the printer
+
+### File Upload Failures
+
+**Problem**: File upload fails or times out
+
+**Solutions**:
+1. Check that the file is a valid .gcode or .3MF file
+2. Ensure sufficient space on printer's SD card
+3. Try uploading a smaller file first to test connection
+4. Check FTP port (default: 990) is accessible
+
+### Print Won't Start
+
+**Problem**: Print command succeeds but print doesn't start
+
+**Solutions**:
+1. Verify the file name matches exactly (case-sensitive)
+2. Check that the file exists on the printer's SD card (use File → List)
+3. Ensure the printer is in IDLE state (not already printing)
+4. Check printer display for error messages
+
+## Resources
+
+* [n8n Community Nodes Documentation](https://docs.n8n.io/integrations/community-nodes/)
+* [Bambu Lab Wiki - Developer Mode](https://wiki.bambulab.com/en/knowledge-sharing/enable-developer-mode)
+* [OpenBambuAPI Documentation](https://github.com/Doridian/OpenBambuAPI)
+* [Bambu Lab Official Website](https://bambulab.com/)
+
+## Development
+
+### Building
+
+```bash
+npm run build
+```
+
+### Testing
+
+```bash
+npm test
+```
+
+### Linting
+
+```bash
+npm run lint
+npm run lintfix
+```
+
+### Local Development
+
+To test this node locally with n8n:
+
+```bash
+# Build the node
+npm run build
+
+# Link globally
+npm link
+
+# In your n8n directory
+npm link n8n-nodes-bambulab
+
+# Start n8n
+n8n start
+```
+
+## Contributing
+
+Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Disclaimer
+
+This is a community-developed node and is not officially supported by Bambu Lab. Use at your own risk. The developers are not responsible for any damage to your printer or failed prints.
+
+## Acknowledgments
+
+- Built with [n8n](https://n8n.io/)
+- MQTT API documentation from [OpenBambuAPI](https://github.com/Doridian/OpenBambuAPI)
+- Bambu Lab for creating excellent 3D printers
+
+---
+
+**Made with ❤️ for the n8n and 3D printing communities**

package/dist/credentials/BambuLabApi.credentials.d.ts

@@ -0,0 +1,10 @@
+import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class BambuLabApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}
+//# sourceMappingURL=BambuLabApi.credentials.d.ts.map

package/dist/credentials/BambuLabApi.credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BambuLabApi.credentials.d.ts","sourceRoot":"","sources":["../../credentials/BambuLabApi.credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,MAAM,cAAc,CAAC;AAEtB,qBAAa,WAAY,YAAW,eAAe;IAClD,IAAI,SAAiB;IAErB,WAAW,SAAmB;IAE9B,gBAAgB,SACwD;IAExE,UAAU,EAAE,eAAe,EAAE,CAsD3B;IAGF,YAAY,EAAE,oBAAoB,CAGhC;IAEF,IAAI,EAAE,sBAAsB,CAK1B;CACF"}

package/dist/credentials/BambuLabApi.credentials.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BambuLabApi = void 0;
+class BambuLabApi {
+    name = 'bambuLabApi';
+    displayName = 'Bambu Lab API';
+    documentationUrl = 'https://wiki.bambulab.com/en/knowledge-sharing/enable-developer-mode';
+    properties = [
+        {
+            displayName: 'Printer IP Address',
+            name: 'printerIp',
+            type: 'string',
+            default: '',
+            required: true,
+            placeholder: '192.168.1.100',
+            description: 'The IP address of your Bambu Lab printer on your local network',
+        },
+        {
+            displayName: 'Access Code',
+            name: 'accessCode',
+            type: 'string',
+            typeOptions: {
+                password: true,
+            },
+            default: '',
+            required: true,
+            description: 'LAN access code from printer settings (Settings > Network > LAN Access Code)',
+        },
+        {
+            displayName: 'Serial Number',
+            name: 'serialNumber',
+            type: 'string',
+            default: '',
+            required: true,
+            placeholder: '01S00A123456789',
+            description: 'Printer serial number (found in Settings > Device > Serial Number). Required for MQTT communication.',
+        },
+        {
+            displayName: 'MQTT Port',
+            name: 'mqttPort',
+            type: 'number',
+            default: 8883,
+            description: 'MQTT port on the printer (default: 8883 for secure connection)',
+        },
+        {
+            displayName: 'Use TLS',
+            name: 'useTls',
+            type: 'boolean',
+            default: true,
+            description: 'Whether to use TLS/SSL for MQTT connection (recommended). Note: Bambu Lab printers use self-signed certificates.',
+        },
+        {
+            displayName: 'FTP Port',
+            name: 'ftpPort',
+            type: 'number',
+            default: 990,
+            description: 'FTP port on the printer for file operations (default: 990 for FTPS)',
+        },
+    ];
+    // Test the connection to verify credentials
+    authenticate = {
+        type: 'generic',
+        properties: {},
+    };
+    test = {
+        request: {
+            method: 'GET',
+            url: '={{$credentials.printerIp}}',
+        },
+    };
+}
+exports.BambuLabApi = BambuLabApi;
+//# sourceMappingURL=BambuLabApi.credentials.js.map

package/dist/credentials/BambuLabApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BambuLabApi.credentials.js","sourceRoot":"","sources":["../../credentials/BambuLabApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,WAAW;IACvB,IAAI,GAAG,aAAa,CAAC;IAErB,WAAW,GAAG,eAAe,CAAC;IAE9B,gBAAgB,GACf,sEAAsE,CAAC;IAExE,UAAU,GAAsB;QAC/B;YACC,WAAW,EAAE,oBAAoB;YACjC,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,eAAe;YAC5B,WAAW,EAAE,gEAAgE;SAC7E;QACD;YACC,WAAW,EAAE,aAAa;YAC1B,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE;gBACZ,QAAQ,EAAE,IAAI;aACd;YACD,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,IAAI;YACd,WAAW,EACV,8EAA8E;SAC/E;QACD;YACC,WAAW,EAAE,eAAe;YAC5B,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,iBAAiB;YAC9B,WAAW,EACV,sGAAsG;SACvG;QACD;YACC,WAAW,EAAE,WAAW;YACxB,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,gEAAgE;SAC7E;QACD;YACC,WAAW,EAAE,SAAS;YACtB,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,WAAW,EACV,kHAAkH;SACnH;QACD;YACC,WAAW,EAAE,UAAU;YACvB,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,GAAG;YACZ,WAAW,EAAE,qEAAqE;SAClF;KACD,CAAC;IAEF,4CAA4C;IAC5C,YAAY,GAAyB;QACpC,IAAI,EAAE,SAAS;QACf,UAAU,EAAE,EAAE;KACd,CAAC;IAEF,IAAI,GAA2B;QAC9B,OAAO,EAAE;YACR,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,6BAA6B;SAClC;KACD,CAAC;CACF;AA5ED,kCA4EC"}

package/dist/nodes/BambuLab/BambuLab.node.d.ts

@@ -0,0 +1,6 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class BambuLab implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}
+//# sourceMappingURL=BambuLab.node.d.ts.map

package/dist/nodes/BambuLab/BambuLab.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BambuLab.node.d.ts","sourceRoot":"","sources":["../../../nodes/BambuLab/BambuLab.node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,oBAAoB,EACpB,MAAM,cAAc,CAAC;AAQtB,qBAAa,QAAS,YAAW,SAAS;IACzC,WAAW,EAAE,oBAAoB,CAuc/B;IAEI,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;CAiOvE"}