n8n-nodes-render-cloud 1.0.0

package/COMMERCIAL_LICENSE.md

@@ -0,0 +1,31 @@
+# Commercial License
+
+Velocity BPA, LLC offers commercial licenses for its n8n community nodes.
+
+## When a Commercial License Is Required
+
+A commercial license is required if you:
+- Use this node within a SaaS, PaaS, or hosted platform that is sold or monetized
+- Offer this node as part of a managed services or consulting engagement
+- Bundle or redistribute this node with a paid product
+- Resell, sublicense, or white-label this node
+- Embed this node into a commercial automation or integration platform
+
+## What the Commercial License Provides
+
+- Legal authorization for commercial deployment
+- Organization-wide usage rights
+- Rights to deploy across multiple environments
+- Optional priority support and maintenance
+- Optional custom development or feature extensions
+
+## Licensing Model
+
+Licenses are issued on a per-organization basis.
+
+Enterprise, OEM, and platform licensing terms are available upon request.
+
+## Contact
+
+Email: licensing@velobpa.com  
+Website: https://velobpa.com

package/LICENSE

@@ -0,0 +1,46 @@
+Business Source License 1.1
+
+License text copyright (c) 2017 MariaDB Corporation Ab.
+
+Licensor:
+Velocity BPA, LLC
+https://velobpa.com
+
+Licensed Work:
+This repository and all source code, documentation, and associated artifacts
+contained herein, including all n8n community nodes published by Velocity BPA.
+
+Additional Use Grant:
+You may use, modify, and run the Licensed Work free of charge for:
+- Personal use
+- Educational use
+- Research use
+- Internal business use, provided such use does not involve resale,
+  redistribution, or offering the Licensed Work as part of a commercial
+  product or service.
+
+Commercial Use Restriction:
+Commercial Use of the Licensed Work is prohibited without a valid
+Commercial License issued by the Licensor.
+
+Commercial Use includes, but is not limited to:
+- Use of the Licensed Work within any Software-as-a-Service (SaaS),
+  Platform-as-a-Service (PaaS), or hosted application that is sold,
+  licensed, or monetized in any form
+- Offering the Licensed Work as part of a managed services engagement
+- Bundling or redistributing the Licensed Work with a paid product
+- Reselling, sublicensing, or white-labeling the Licensed Work
+- Embedding the Licensed Work into any commercial automation platform,
+  integration product, or solution offering
+
+Change Date:
+January 1, 2030
+
+Change License:
+Apache License, Version 2.0
+
+For commercial licensing inquiries:
+licensing@velobpa.com
+
+Business Source License 1.1 full text:
+https://mariadb.com/bsl11/

package/LICENSING_FAQ.md

@@ -0,0 +1,18 @@
+## Licensing FAQ
+
+### Is internal SaaS infrastructure considered internal use?
+No. If the infrastructure supports a revenue-generating service,
+it is considered commercial use.
+
+### What if customers never see the node?
+Visibility is irrelevant. Revenue enablement constitutes commercial use.
+
+### What if we are a startup?
+Startups are commercial entities and require a commercial license.
+
+### What if we only use one workflow?
+Scope does not change license requirements.
+
+### Do proof-of-concepts require a license?
+Internal, non-customer-facing POCs are permitted.
+Production SaaS deployments require a license.

package/README.md

@@ -0,0 +1,439 @@
+# n8n-nodes-render-cloud
+
+> **[Velocity BPA Licensing Notice]**
+>
+> This n8n node is licensed under the Business Source License 1.1 (BSL 1.1).
+>
+> Use of this node by for-profit organizations in production environments requires a commercial license from Velocity BPA.
+>
+> For licensing information, visit https://velobpa.com/licensing or contact licensing@velobpa.com.
+
+A comprehensive n8n community node for Render Cloud providing 12 resources and 80+ operations for service deployment, database management, and infrastructure automation. Enables workflow automation for web services, static sites, background workers, cron jobs, PostgreSQL databases, and Redis instances through Render's REST API.
+
+![n8n version](https://img.shields.io/badge/n8n-1.30.0+-blue)
+![Node.js version](https://img.shields.io/badge/node-18+-green)
+![License](https://img.shields.io/badge/license-BSL--1.1-blue)
+
+## Features
+
+- **12 Resource Categories**: Services, Deploys, Custom Domains, Environment Variables, Secret Files, Projects, Environments, Postgres, Key Value (Redis), Disks, Environment Groups, and Webhooks
+- **80+ Operations**: Full CRUD operations plus specialized actions for each resource type
+- **Webhook Triggers**: Real-time event notifications with signature verification
+- **Cursor-Based Pagination**: Efficient handling of large datasets
+- **Rate Limit Handling**: Built-in rate limit detection and exponential backoff
+- **Database Management**: PostgreSQL operations including PITR recovery, exports, and user management
+- **Infrastructure Automation**: Service scaling, autoscaling configuration, and deployment management
+
+## Installation
+
+### Community Nodes (Recommended)
+
+1. Open n8n
+2. Go to **Settings** → **Community Nodes**
+3. Click **Install a community node**
+4. Enter `n8n-nodes-render-cloud`
+5. Click **Install**
+
+### Manual Installation
+
+```bash
+# Navigate to your n8n installation directory
+cd ~/.n8n
+
+# Install the package
+npm install n8n-nodes-render-cloud
+```
+
+### Development Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/Velocity-BPA/n8n-nodes-render-cloud.git
+cd n8n-nodes-render-cloud
+
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Create symlink to n8n custom nodes directory
+mkdir -p ~/.n8n/custom
+ln -s $(pwd) ~/.n8n/custom/n8n-nodes-render-cloud
+
+# Restart n8n
+n8n start
+```
+
+## Credentials Setup
+
+### Render Cloud API
+
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| API Key | String | Yes | API key from Render Dashboard Account Settings |
+
+**How to get your API key:**
+
+1. Log into [Render Dashboard](https://dashboard.render.com)
+2. Navigate to **Account Settings**
+3. Under **API Keys** section, click **Create API Key**
+4. Provide a descriptive name for the key
+5. Copy and securely store the API key (only shown once)
+
+## Resources & Operations
+
+### Service
+Manage web services, static sites, background workers, private services, and cron jobs.
+
+| Operation | Description |
+|-----------|-------------|
+| List | List all services with optional filtering |
+| Create | Create a new service |
+| Get | Retrieve a service by ID |
+| Update | Update service configuration |
+| Delete | Delete a service |
+| Suspend | Suspend a running service |
+| Resume | Resume a suspended service |
+| Restart | Restart a service |
+| Scale | Scale instance count |
+| Update Autoscaling | Configure autoscaling settings |
+| Delete Autoscaling | Remove autoscaling configuration |
+| Purge Cache | Purge cache for a web service |
+
+### Deploy
+Trigger and manage service deployments.
+
+| Operation | Description |
+|-----------|-------------|
+| List | List deploys for a service |
+| Trigger | Trigger a new deploy |
+| Get | Retrieve deploy details |
+| Cancel | Cancel an in-progress deploy |
+| Rollback | Roll back to a previous deploy |
+
+### Custom Domain
+Manage custom domains for services.
+
+| Operation | Description |
+|-----------|-------------|
+| List | List custom domains for a service |
+| Add | Add a custom domain |
+| Get | Retrieve custom domain details |
+| Delete | Remove a custom domain |
+| Verify DNS | Verify DNS configuration |
+
+### Environment Variable
+Manage environment variables for services.
+
+| Operation | Description |
+|-----------|-------------|
+| List | List environment variables |
+| Get | Retrieve a specific variable |
+| Add or Update | Add or update a variable |
+| Delete | Delete a variable |
+| Update All | Replace all variables |
+
+### Secret File
+Manage secret files for services.
+
+| Operation | Description |
+|-----------|-------------|
+| List | List secret files |
+| Get | Retrieve a specific secret file |
+| Add or Update | Add or update a secret file |
+| Delete | Delete a secret file |
+| Update All | Replace all secret files |
+
+### Project
+Manage Render projects for organizing resources.
+
+| Operation | Description |
+|-----------|-------------|
+| List | List all projects |
+| Create | Create a new project |
+| Get | Retrieve project details |
+| Update | Update project configuration |
+| Delete | Delete a project |
+
+### Environment
+Manage environments within projects.
+
+| Operation | Description |
+|-----------|-------------|
+| List | List environments in a project |
+| Create | Create a new environment |
+| Get | Retrieve environment details |
+| Update | Update environment configuration |
+| Delete | Delete an environment |
+| Add Resources | Add services/databases to environment |
+| Remove Resources | Remove resources from environment |
+
+### Postgres
+Manage PostgreSQL database instances.
+
+| Operation | Description |
+|-----------|-------------|
+| List | List PostgreSQL instances |
+| Create | Create a new instance |
+| Get | Retrieve instance details |
+| Update | Update configuration |
+| Delete | Delete an instance |
+| Get Connection Info | Get connection credentials |
+| Suspend | Suspend an instance |
+| Resume | Resume a suspended instance |
+| Restart | Restart an instance |
+| Failover | Trigger manual failover (HA) |
+| Get Recovery Status | Get PITR recovery status |
+| Trigger Recovery | Restore from a point in time |
+| List Exports | List database exports |
+| Create Export | Create a database export |
+| List Users | List PostgreSQL users |
+| Create User | Create a user |
+| Delete User | Delete a user |
+
+### Key Value (Redis)
+Manage Redis/Key Value instances.
+
+| Operation | Description |
+|-----------|-------------|
+| List | List Key Value instances |
+| Create | Create a new instance |
+| Get | Retrieve instance details |
+| Update | Update configuration |
+| Delete | Delete an instance |
+| Get Connection Info | Get connection credentials |
+| Suspend | Suspend an instance |
+| Resume | Resume a suspended instance |
+
+### Disk
+Manage persistent disks and snapshots.
+
+| Operation | Description |
+|-----------|-------------|
+| List | List disks for a service |
+| Add | Add a disk to a service |
+| Get | Retrieve disk details |
+| Update | Update disk configuration |
+| Delete | Delete a disk |
+| List Snapshots | List disk snapshots |
+| Restore Snapshot | Restore from a snapshot |
+
+### Environment Group
+Manage shared environment variables and secrets across services.
+
+| Operation | Description |
+|-----------|-------------|
+| List | List environment groups |
+| Create | Create a new environment group |
+| Get | Retrieve environment group details |
+| Update | Update environment group |
+| Delete | Delete an environment group |
+| Link Service | Link a service to the group |
+| Unlink Service | Unlink a service from the group |
+| Get Env Var | Get a specific environment variable |
+| Update Env Var | Add or update an environment variable |
+| Delete Env Var | Remove an environment variable |
+| Get Secret File | Get a specific secret file |
+| Update Secret File | Add or update a secret file |
+| Delete Secret File | Remove a secret file |
+
+### Webhook
+Manage webhooks for event notifications.
+
+| Operation | Description |
+|-----------|-------------|
+| List | List webhooks for a workspace |
+| Create | Create a new webhook |
+| Get | Retrieve webhook details |
+| Update | Update webhook configuration |
+| Delete | Delete a webhook |
+| List Events | List events delivered to a webhook |
+
+## Trigger Node
+
+### Render Cloud Trigger
+
+Starts the workflow when Render Cloud events occur.
+
+**Supported Events:**
+- `deploy_started` - Deploy has started
+- `deploy_succeeded` - Deploy completed successfully
+- `deploy_failed` - Deploy failed
+- `deploy_canceled` - Deploy was canceled
+- `service_created` - New service created
+- `service_deleted` - Service deleted
+- `service_suspended` - Service suspended
+- `service_resumed` - Service resumed
+- `server_failed` - Server failure detected
+- `server_available` - Server recovered
+- `certificate_renewed` - TLS certificate renewed
+- `maintenance_started` - Maintenance started
+- `maintenance_completed` - Maintenance completed
+
+**Features:**
+- Automatic webhook creation and cleanup
+- Webhook signature verification for security
+- Filter events by specific service IDs
+
+## Usage Examples
+
+### List All Services
+
+```javascript
+// Configure the Render Cloud node
+// Resource: Service
+// Operation: List
+// Returns all services in your workspace
+```
+
+### Trigger a Deploy
+
+```javascript
+// Resource: Deploy
+// Operation: Trigger
+// Service ID: srv-abc123
+// Clear Cache: true
+```
+
+### Create a PostgreSQL Database
+
+```javascript
+// Resource: Postgres
+// Operation: Create
+// Owner ID: usr-xxxxx
+// Name: my-database
+// Region: oregon
+// Plan: starter
+// PostgreSQL Version: 16
+```
+
+### Scale a Service
+
+```javascript
+// Resource: Service
+// Operation: Scale
+// Service ID: srv-abc123
+// Number of Instances: 3
+```
+
+## Render Concepts
+
+### Service Types
+- **Web Service**: Long-running web applications
+- **Static Site**: Static HTML/CSS/JS hosting
+- **Background Worker**: Long-running background processes
+- **Private Service**: Internal services not exposed to internet
+- **Cron Job**: Scheduled tasks
+
+### Regions
+| Region | Location |
+|--------|----------|
+| oregon | US West (Oregon) |
+| ohio | US East (Ohio) |
+| virginia | US East (Virginia) |
+| frankfurt | Europe (Frankfurt) |
+| singapore | Asia Pacific (Singapore) |
+
+### Plans
+- **free**: Free tier with limitations
+- **starter**: Entry-level paid tier
+- **standard**: Standard production tier
+- **pro**: Professional tier
+- **pro_plus**: Enhanced professional tier
+- **pro_max**: Maximum performance tier
+- **pro_ultra**: Ultimate performance tier
+
+## Error Handling
+
+The node handles common Render API errors:
+
+| Error Code | Description |
+|------------|-------------|
+| 400 | Bad Request - Invalid parameters |
+| 401 | Unauthorized - Invalid API key |
+| 403 | Forbidden - Insufficient permissions |
+| 404 | Not Found - Resource doesn't exist |
+| 409 | Conflict - Resource state conflict |
+| 422 | Unprocessable - Validation errors |
+| 429 | Rate Limited - Too many requests |
+| 500 | Server Error - Render API issue |
+
+Rate limiting is handled automatically with exponential backoff.
+
+## Security Best Practices
+
+1. **Store API keys securely**: Use n8n credentials, never hardcode
+2. **Use webhook signatures**: Enable signature verification for triggers
+3. **Limit API key scope**: Create keys with minimal required permissions
+4. **Rotate keys regularly**: Periodically regenerate API keys
+5. **Use environment groups**: Share secrets securely across services
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Run linting
+npm run lint
+
+# Fix linting issues
+npm run lint:fix
+
+# Run tests
+npm test
+
+# Run tests with coverage
+npm run test:coverage
+
+# Watch mode for development
+npm run dev
+```
+
+## Author
+
+**Velocity BPA**
+- Website: [velobpa.com](https://velobpa.com)
+- GitHub: [Velocity-BPA](https://github.com/Velocity-BPA)
+
+## Licensing
+
+This n8n community node is licensed under the **Business Source License 1.1**.
+
+### Free Use
+Permitted for personal, educational, research, and internal business use.
+
+### Commercial Use
+Use of this node within any SaaS, PaaS, hosted platform, managed service,
+or paid automation offering requires a commercial license.
+
+For licensing inquiries:
+**licensing@velobpa.com**
+
+See [LICENSE](LICENSE), [COMMERCIAL_LICENSE.md](COMMERCIAL_LICENSE.md), and [LICENSING_FAQ.md](LICENSING_FAQ.md) for details.
+
+## Contributing
+
+Contributions are welcome! Please follow these steps:
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## Support
+
+- **Issues**: [GitHub Issues](https://github.com/Velocity-BPA/n8n-nodes-render-cloud/issues)
+- **Documentation**: [Render API Docs](https://api-docs.render.com/)
+- **n8n Community**: [n8n Community Forum](https://community.n8n.io/)
+
+## Acknowledgments
+
+- [Render](https://render.com) for providing an excellent cloud platform and API
+- [n8n](https://n8n.io) for the workflow automation platform
+- The n8n community for inspiration and support

package/dist/credentials/RenderCloudApi.credentials.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"RenderCloudApi.credentials.d.ts","sourceRoot":"","sources":["../../credentials/RenderCloudApi.credentials.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACX,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,MAAM,cAAc,CAAC;AAEtB,qBAAa,cAAe,YAAW,eAAe;IACrD,IAAI,SAAoB;IACxB,WAAW,SAAsB;IACjC,gBAAgB,SAAiC;IACjD,UAAU,EAAE,eAAe,EAAE,CAY3B;IAEF,YAAY,EAAE,oBAAoB,CAOhC;IAEF,IAAI,EAAE,sBAAsB,CAM1B;CACF"}

package/dist/credentials/RenderCloudApi.credentials.js

@@ -0,0 +1,46 @@
+"use strict";
+/*
+ * Copyright (c) Velocity BPA, LLC
+ * Licensed under the Business Source License 1.1
+ * Commercial use requires a separate commercial license.
+ * See LICENSE file for details.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RenderCloudApi = void 0;
+class RenderCloudApi {
+    constructor() {
+        this.name = 'renderCloudApi';
+        this.displayName = 'Render Cloud API';
+        this.documentationUrl = 'https://render.com/docs/api';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: {
+                    password: true,
+                },
+                default: '',
+                required: true,
+                description: 'API key from Render Dashboard Account Settings. Navigate to Account Settings > API Keys to create one.',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.apiKey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: 'https://api.render.com/v1',
+                url: '/owners',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.RenderCloudApi = RenderCloudApi;
+//# sourceMappingURL=RenderCloudApi.credentials.js.map

package/dist/credentials/RenderCloudApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderCloudApi.credentials.js","sourceRoot":"","sources":["../../credentials/RenderCloudApi.credentials.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AASH,MAAa,cAAc;IAA3B;QACC,SAAI,GAAG,gBAAgB,CAAC;QACxB,gBAAW,GAAG,kBAAkB,CAAC;QACjC,qBAAgB,GAAG,6BAA6B,CAAC;QACjD,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;oBACZ,QAAQ,EAAE,IAAI;iBACd;gBACD,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,wGAAwG;aACrH;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EAAE,iCAAiC;iBAChD;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,2BAA2B;gBACpC,GAAG,EAAE,SAAS;gBACd,MAAM,EAAE,KAAK;aACb;SACD,CAAC;IACH,CAAC;CAAA;AAlCD,wCAkCC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './credentials/RenderCloudApi.credentials';
+export * from './nodes/RenderCloud/RenderCloud.node';
+export * from './nodes/RenderCloud/RenderCloudTrigger.node';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAOA,cAAc,0CAA0C,CAAC;AACzD,cAAc,sCAAsC,CAAC;AACrD,cAAc,6CAA6C,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/*
+ * Copyright (c) Velocity BPA, LLC
+ * Licensed under the Business Source License 1.1
+ * Commercial use requires a separate commercial license.
+ * See LICENSE file for details.
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./credentials/RenderCloudApi.credentials"), exports);
+__exportStar(require("./nodes/RenderCloud/RenderCloud.node"), exports);
+__exportStar(require("./nodes/RenderCloud/RenderCloudTrigger.node"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,2EAAyD;AACzD,uEAAqD;AACrD,8EAA4D"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"RenderCloud.node.d.ts","sourceRoot":"","sources":["../../../nodes/RenderCloud/RenderCloud.node.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACX,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,oBAAoB,EACpB,MAAM,cAAc,CAAC;AA2BtB,qBAAa,WAAY,YAAW,SAAS;IAC5C,WAAW,EAAE,oBAAoB,CA0I/B;IAEI,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;CAuEvE"}