n8n-nodes-do 1.0.0

package/LICENSE.md

@@ -0,0 +1,19 @@
+Copyright 2022 n8n
+
+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,350 @@
+# n8n-nodes-do
+
+<div align="center">
+
+**Official n8n community node for [DigitalOcean](https://www.digitalocean.com/)**
+
+Manage your DigitalOcean Droplets, Volumes, Databases, Kubernetes clusters, and more — all from your n8n workflows.
+
+[![npm version](https://img.shields.io/npm/v/n8n-nodes-do.svg)](https://www.npmjs.com/package/n8n-nodes-do)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![n8n community node](https://img.shields.io/badge/n8n-community%20node-orange)](https://docs.n8n.io/integrations/community-nodes/)
+
+</div>
+
+---
+
+## Features
+
+- **13 Resources** — Droplets, Volumes, Databases, Domains, Images, Kubernetes, Load Balancers, Projects, Reserved IPs, Snapshots, SSH Keys, VPCs, Account
+- **50+ Operations** — Complete CRUD coverage for all resources
+- **Auto-authentication** — Uses Personal Access Token (Bearer token) authentication
+- **Pagination** — Automatically handles paginated responses for list operations
+- **Expression Support** — All ID fields support n8n expressions (`{{ $json.dropletId }}`)
+- **Dynamic Dropdowns** — Resources load dynamically from your DigitalOcean account
+- **AI Tool Ready** — Node is marked `usableAsTool: true` for use in AI agent workflows
+
+---
+
+## Installation
+
+### In n8n Cloud or Self-hosted n8n
+
+1. Go to **Settings → Community Nodes**
+2. Click **Install**
+3. Enter: `n8n-nodes-do`
+4. Click **Install**
+5. Restart n8n if prompted
+
+### Via npm (self-hosted)
+
+```bash
+npm install n8n-nodes-do
+```
+
+---
+
+## Authentication
+
+This node uses DigitalOcean Personal Access Token authentication. You'll need:
+
+| Field | Description |
+|-------|-------------|
+| **Personal Access Token** | Your DigitalOcean API token |
+
+### How to get your credentials:
+
+1. Log in to [cloud.digitalocean.com](https://cloud.digitalocean.com/)
+2. Navigate to **API → Tokens/Keys**
+3. Click **Generate New Token**
+4. Give it a name and select **Read** and **Write** scopes
+5. Copy the token (you won't be able to see it again!)
+
+> **Note:** Keep your token secure! It provides full access to your DigitalOcean account.
+
+---
+
+## Resources & Operations
+
+### Account
+
+| Operation | Description |
+|-----------|-------------|
+| **Get** | Get account information |
+
+---
+
+### Droplet
+
+Manage your DigitalOcean virtual machines.
+
+| Operation | Description |
+|-----------|-------------|
+| **Get Many** | List all Droplets |
+| **Get** | Get a specific Droplet by ID |
+| **Create** | Create a new Droplet |
+| **Delete** | Delete a Droplet |
+| **Reboot** | Reboot a Droplet |
+| **Shutdown** | Shutdown a Droplet |
+| **Power On** | Power on a Droplet |
+| **Power Off** | Power off a Droplet |
+
+**Parameters for Create:**
+- Name (hostname)
+- Region (e.g., nyc1, sfo3, ams3)
+- Size (e.g., s-1vcpu-1gb, s-2vcpu-4gb)
+- Image (OS distribution or custom image)
+
+---
+
+### Volume
+
+Manage block storage volumes.
+
+| Operation | Description |
+|-----------|-------------|
+| **Get Many** | List all volumes |
+| **Get** | Get a specific volume by ID |
+| **Create** | Create a new volume |
+| **Delete** | Delete a volume |
+
+---
+
+### Database
+
+Manage managed database clusters.
+
+| Operation | Description |
+|-----------|-------------|
+| **Get Many** | List all database clusters |
+| **Get** | Get a specific database cluster |
+| **Create** | Create a new database cluster |
+| **Delete** | Delete a database cluster |
+
+**Supported Engines:** PostgreSQL, MySQL, MongoDB, Kafka, Valkey, OpenSearch
+
+---
+
+### Domain
+
+Manage domains and DNS records.
+
+| Operation | Description |
+|-----------|-------------|
+| **Get Many** | List all domains |
+| **Get** | Get a specific domain |
+| **Create** | Create a new domain |
+| **Delete** | Delete a domain |
+| **Get Records** | List DNS records for a domain |
+
+---
+
+### Image
+
+Manage images (distributions and snapshots).
+
+| Operation | Description |
+|-----------|-------------|
+| **Get Many** | List all images |
+| **Get** | Get a specific image |
+| **Delete** | Delete an image |
+
+---
+
+### Kubernetes (DOKS)
+
+Manage DigitalOcean Kubernetes clusters.
+
+| Operation | Description |
+|-----------|-------------|
+| **Get Many Clusters** | List all Kubernetes clusters |
+| **Get Cluster** | Get a specific cluster |
+| **Create Cluster** | Create a new cluster |
+| **Delete Cluster** | Delete a cluster |
+| **Get Kubeconfig** | Get kubeconfig for a cluster |
+
+---
+
+### Load Balancer
+
+Manage load balancers.
+
+| Operation | Description |
+|-----------|-------------|
+| **Get Many** | List all load balancers |
+| **Get** | Get a specific load balancer |
+| **Create** | Create a load balancer |
+| **Delete** | Delete a load balancer |
+
+---
+
+### Project
+
+Organize resources into projects.
+
+| Operation | Description |
+|-----------|-------------|
+| **Get Many** | List all projects |
+| **Get** | Get a specific project |
+| **Create** | Create a new project |
+| **Delete** | Delete a project |
+
+---
+
+### Reserved IP
+
+Manage reserved (static) IP addresses.
+
+| Operation | Description |
+|-----------|-------------|
+| **Get Many** | List all reserved IPs |
+| **Get** | Get a specific reserved IP |
+| **Create** | Create a reserved IP |
+| **Delete** | Delete a reserved IP |
+
+---
+
+### Snapshot
+
+Manage snapshots of Droplets and volumes.
+
+| Operation | Description |
+|-----------|-------------|
+| **Get Many** | List all snapshots |
+| **Get** | Get a specific snapshot |
+| **Delete** | Delete a snapshot |
+
+---
+
+### SSH Key
+
+Manage SSH keys for Droplet access.
+
+| Operation | Description |
+|-----------|-------------|
+| **Get Many** | List all SSH keys |
+| **Get** | Get a specific SSH key |
+| **Create** | Add a new SSH key |
+| **Delete** | Delete an SSH key |
+
+---
+
+### VPC
+
+Manage Virtual Private Clouds.
+
+| Operation | Description |
+|-----------|-------------|
+| **Get Many** | List all VPCs |
+| **Get** | Get a specific VPC |
+| **Create** | Create a new VPC |
+| **Delete** | Delete a VPC |
+
+---
+
+## Usage Examples
+
+### Example 1: Create a Droplet
+
+```
+[DigitalOcean - Create Droplet]
+   Name: "my-server"
+   Region: "nyc1"
+   Size: "s-1vcpu-1gb"
+   Image: "ubuntu-22-04-x64"
+```
+
+### Example 2: List All Droplets and Shutdown Running Ones
+
+```
+[DigitalOcean - Get Many Droplets]
+        ↓
+[If: status = "running"]
+        ↓
+[DigitalOcean - Shutdown]
+   Droplet ID: {{ $json.id }}
+```
+
+### Example 3: Create Daily Database Backups
+
+```
+[Schedule Trigger - Daily at 2 AM]
+        ↓
+[DigitalOcean - Get Many Databases]
+        ↓
+[DigitalOcean - Create Snapshot]
+   (for each database)
+```
+
+---
+
+## Expression Reference
+
+When chaining nodes, use these expressions:
+
+| Field | Expression |
+|-------|-----------|
+| Droplet ID | `{{ $json.id }}` |
+| Droplet Name | `{{ $json.name }}` |
+| Droplet Status | `{{ $json.status }}` |
+| Region | `{{ $json.region.slug }}` |
+| IP Address | `{{ $json.networks.v4[0].ip_address }}` |
+
+---
+
+## Regions
+
+DigitalOcean supports the following regions:
+
+| Code | Location |
+|------|----------|
+| nyc1, nyc2, nyc3 | New York, USA |
+| sfo2, sfo3 | San Francisco, USA |
+| tor1 | Toronto, Canada |
+| lon1 | London, UK |
+| fra1 | Frankfurt, Germany |
+| ams2, ams3 | Amsterdam, Netherlands |
+| sgp1 | Singapore |
+| blr1 | Bangalore, India |
+| syd1 | Sydney, Australia |
+
+---
+
+## Troubleshooting
+
+### Authentication fails
+
+- Double-check your Personal Access Token
+- Make sure the token has **Read** and **Write** scopes
+- Verify the token hasn't expired or been revoked
+
+### Droplet ID field not visible
+
+- Confirm **Resource** = `Droplet` and the **Operation** requires an ID
+- The ID field appears for operations like Get, Delete, Reboot, etc.
+
+### Node not found after installation
+
+1. Make sure you installed `n8n-nodes-do`
+2. Restart n8n after installation
+3. Check **Settings → Community Nodes** to confirm it's listed
+
+### Rate Limits
+
+DigitalOcean API has rate limits. If you encounter rate limit errors:
+- Reduce the frequency of API calls
+- Use the `limit` parameter to fetch smaller batches
+- Consider using wait nodes between operations
+
+---
+
+## License
+
+[MIT](LICENSE.md)
+
+---
+
+## Credits
+
+Built with the [n8n Node Starter](https://github.com/n8n-io/n8n-nodes-starter).
+Uses the [DigitalOcean API v2](https://docs.digitalocean.com/reference/api/).

package/dist/credentials/DigitalOceanApi.credentials.d.ts

@@ -0,0 +1,10 @@
+import { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class DigitalOceanApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    icon: any;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/DigitalOceanApi.credentials.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DigitalOceanApi = void 0;
+class DigitalOceanApi {
+    constructor() {
+        this.name = 'digitalOceanApi';
+        this.displayName = 'DigitalOcean API';
+        this.documentationUrl = 'https://docs.digitalocean.com/reference/api/';
+        this.icon = 'file:digitalocean.svg';
+        this.properties = [
+            {
+                displayName: 'Personal Access Token',
+                name: 'accessToken',
+                type: 'string',
+                typeOptions: {
+                    password: true,
+                },
+                default: '',
+                required: true,
+                description: 'Your DigitalOcean Personal Access Token. Generate one at https://cloud.digitalocean.com/account/api/tokens',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.accessToken}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: 'https://api.digitalocean.com/v2',
+                url: '/account',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.DigitalOceanApi = DigitalOceanApi;
+//# sourceMappingURL=DigitalOceanApi.credentials.js.map

package/dist/credentials/DigitalOceanApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DigitalOceanApi.credentials.js","sourceRoot":"","sources":["../../credentials/DigitalOceanApi.credentials.ts"],"names":[],"mappings":";;;AASA,MAAa,eAAe;IAA5B;QACC,SAAI,GAAG,iBAAiB,CAAC;QACzB,gBAAW,GAAG,kBAAkB,CAAC;QACjC,qBAAgB,GAAG,8CAA8C,CAAC;QAClE,SAAI,GAAG,uBAA8B,CAAC;QACtC,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,uBAAuB;gBACpC,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;oBACZ,QAAQ,EAAE,IAAI;iBACd;gBACD,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,4GAA4G;aACzH;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EAAE,sCAAsC;iBACrD;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,iCAAiC;gBAC1C,GAAG,EAAE,UAAU;gBACf,MAAM,EAAE,KAAK;aACb;SACD,CAAC;IACH,CAAC;CAAA;AAnCD,0CAmCC"}

package/dist/icons/github.dark.svg

@@ -0,0 +1,3 @@
+<svg width="40" height="40" viewBox="0 0 40 40" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M20.0165 0C8.94791 0 0 9.01388 0 20.1653C0 29.0792 5.73324 36.6246 13.6868 39.2952C14.6812 39.496 15.0454 38.8613 15.0454 38.3274C15.0454 37.8599 15.0126 36.2575 15.0126 34.5879C9.4445 35.79 8.28498 32.1841 8.28498 32.1841C7.39015 29.847 6.06429 29.2463 6.06429 29.2463C4.24185 28.011 6.19704 28.011 6.19704 28.011C8.21861 28.1446 9.27938 30.081 9.27938 30.081C11.0686 33.1522 13.9518 32.2844 15.1118 31.7502C15.2773 30.4481 15.8079 29.5467 16.3713 29.046C11.9303 28.5785 7.25781 26.8425 7.25781 19.0967C7.25781 16.8932 8.05267 15.0905 9.31216 13.6884C9.11344 13.1877 8.41732 11.1174 9.51128 8.34644C9.51128 8.34644 11.2014 7.81217 15.0122 10.4164C16.6438 9.97495 18.3263 9.7504 20.0165 9.74851C21.7067 9.74851 23.4295 9.98246 25.0205 10.4164C28.8317 7.81217 30.5218 8.34644 30.5218 8.34644C31.6158 11.1174 30.9192 13.1877 30.7205 13.6884C32.0132 15.0905 32.7753 16.8932 32.7753 19.0967C32.7753 26.8425 28.1028 28.5449 23.6287 29.046C24.358 29.6802 24.9873 30.882 24.9873 32.7851C24.9873 35.4893 24.9545 37.6596 24.9545 38.327C24.9545 38.8613 25.3192 39.496 26.3132 39.2956C34.2667 36.6242 39.9999 29.0792 39.9999 20.1653C40.0327 9.01388 31.052 0 20.0165 0Z" fill="white"/>
+</svg>

package/dist/icons/github.svg

@@ -0,0 +1,3 @@
+<svg width="40" height="40" viewBox="0 0 40 40" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M20.0165 0C8.94791 0 0 9.01388 0 20.1653C0 29.0792 5.73324 36.6246 13.6868 39.2952C14.6812 39.496 15.0454 38.8613 15.0454 38.3274C15.0454 37.8599 15.0126 36.2575 15.0126 34.5879C9.4445 35.79 8.28498 32.1841 8.28498 32.1841C7.39015 29.847 6.06429 29.2463 6.06429 29.2463C4.24185 28.011 6.19704 28.011 6.19704 28.011C8.21861 28.1446 9.27938 30.081 9.27938 30.081C11.0686 33.1522 13.9518 32.2844 15.1118 31.7502C15.2773 30.4481 15.8079 29.5467 16.3713 29.046C11.9303 28.5785 7.25781 26.8425 7.25781 19.0967C7.25781 16.8932 8.05267 15.0905 9.31216 13.6884C9.11344 13.1877 8.41732 11.1174 9.51128 8.34644C9.51128 8.34644 11.2014 7.81217 15.0122 10.4164C16.6438 9.97495 18.3263 9.7504 20.0165 9.74851C21.7067 9.74851 23.4295 9.98246 25.0205 10.4164C28.8317 7.81217 30.5218 8.34644 30.5218 8.34644C31.6158 11.1174 30.9192 13.1877 30.7205 13.6884C32.0132 15.0905 32.7753 16.8932 32.7753 19.0967C32.7753 26.8425 28.1028 28.5449 23.6287 29.046C24.358 29.6802 24.9873 30.882 24.9873 32.7851C24.9873 35.4893 24.9545 37.6596 24.9545 38.327C24.9545 38.8613 25.3192 39.496 26.3132 39.2956C34.2667 36.6242 39.9999 29.0792 39.9999 20.1653C40.0327 9.01388 31.052 0 20.0165 0Z" fill="#24292F"/>
+</svg>

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

@@ -0,0 +1,22 @@
+import { IExecuteFunctions, ILoadOptionsFunctions, INodeExecutionData, INodePropertyOptions, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class DigitalOcean implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        loadOptions: {
+            getDroplets(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getVolumes(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getDatabases(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getDomains(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getImages(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getClusters(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getLoadBalancers(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getProjects(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getReservedIps(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getSnapshots(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getSshKeys(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getVpcs(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getFirewalls(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+        };
+    };
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}