@joshuanode/n8n-nodes-datto-backup 0.1.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Joshua Smith
+
+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,96 @@
+# Datto Backup Node for n8n
+
+[![npm version](https://badge.fury.io/js/%40joshuanode%2Fn8n-nodes-datto-backup.svg)](https://www.npmjs.com/package/@joshuanode/n8n-nodes-datto-backup)
+[![GitHub](https://img.shields.io/badge/GitHub-ajoshuasmith-181717?logo=github)](https://github.com/ajoshuasmith)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Community node for the **Datto API** — built for MSPs managing backup devices at scale.
+
+## Features
+
+### BCDR (Backup, Continuity & Disaster Recovery)
+
+| Resource       | Operations    | Description                        |
+| -------------- | ------------- | ---------------------------------- |
+| **Device**     | Get, Get Many | BCDR appliances and cloud devices  |
+| **Agent**      | Get Many      | Backup agents on protected systems |
+| **Alert**      | Get Many      | Device alerts and notifications    |
+| **Asset**      | Get Many      | Combined view of agents and shares |
+| **Share**      | Get Many      | Network shares being backed up     |
+| **Volume**     | Get           | Storage volumes on a device        |
+| **VM Restore** | Get Many      | Virtual machine restore operations |
+
+### Reporting
+
+| Resource         | Operations | Description                          |
+| ---------------- | ---------- | ------------------------------------ |
+| **Activity Log** | Get Many   | User activity audit log with filters |
+
+### SaaS Protection
+
+| Resource             | Operations | Description                  |
+| -------------------- | ---------- | ---------------------------- |
+| **SaaS Domain**      | Get Many   | Protected domains            |
+| **SaaS Seat**        | Get Many   | Customer seat allocations    |
+| **SaaS Application** | Get Many   | Backup data for applications |
+
+### Direct-to-Cloud (Endpoint Backup)
+
+| Resource             | Operations                   | Description              |
+| -------------------- | ---------------------------- | ------------------------ |
+| **DTC Asset**        | Get, Get Many, Get by Client | Endpoint backup assets   |
+| **DTC RMM Template** | Get Many                     | RMM deployment templates |
+| **DTC Storage Pool** | Get Many                     | Storage pool usage       |
+
+## Installation
+
+### Community Nodes (Recommended)
+
+1. In n8n, go to **Settings → Community Nodes → Install**
+2. Enter: `@joshuanode/n8n-nodes-datto-backup`
+3. Click **Install**
+
+### Manual Installation
+
+```bash
+npm install @joshuanode/n8n-nodes-datto-backup
+```
+
+## Credentials
+
+### Getting API Keys
+
+1. Log into the [Datto Partner Portal](https://portal.dattobackup.com)
+2. Navigate to **Admin → Integrations**
+3. Select the **API Keys** tab
+4. Click **Create API Key** and provide a name
+5. Copy both the **Public Key** and **Secret Key**
+
+### Configuring in n8n
+
+1. In n8n, create new credentials for **Datto Backup API**
+2. Enter your **Public API Key**
+3. Enter your **Secret API Key**
+4. Click **Save** — the credentials will be tested automatically
+
+## Usage Examples
+
+### Get All Devices with Alerts
+
+```
+1. Datto Backup → Device → Get Many (Return All: true)
+2. Loop Over Items
+3. Datto Backup → Alert → Get Many (Serial Number: {{$json.serialNumber}})
+```
+
+### Monitor Backup Status Across Tenants
+
+```
+1. Datto Backup → Device → Get Many
+2. Filter → devices with backup issues
+3. Send notification (Slack, Email, etc.)
+```
+
+## License
+
+[MIT](LICENSE)

package/dist/credentials/DattoBackupApi.credentials.d.ts

@@ -0,0 +1,14 @@
+import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class DattoBackupApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    icon: {
+        readonly light: "file:../nodes/DattoBackup/dattobackup.svg";
+        readonly dark: "file:../nodes/DattoBackup/dattobackup.svg";
+    };
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}
+//# sourceMappingURL=DattoBackupApi.credentials.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DattoBackupApi.credentials.d.ts","sourceRoot":"","sources":["../../credentials/DattoBackupApi.credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,MAAM,cAAc,CAAC;AAEtB,qBAAa,cAAe,YAAW,eAAe;IACrD,IAAI,SAAoB;IAExB,WAAW,SAAsB;IAEjC,gBAAgB,SAAqD;IAErE,IAAI;;;MAGO;IAEX,UAAU,EAAE,eAAe,EAAE,CAoB3B;IAEF,YAAY,EAAE,oBAAoB,CAQhC;IAEF,IAAI,EAAE,sBAAsB,CAU1B;CACF"}

package/dist/credentials/DattoBackupApi.credentials.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DattoBackupApi = void 0;
+class DattoBackupApi {
+    name = 'dattoBackupApi';
+    displayName = 'Datto Backup API';
+    documentationUrl = 'https://portal.dattobackup.com/integrations/api';
+    icon = {
+        light: 'file:../nodes/DattoBackup/dattobackup.svg',
+        dark: 'file:../nodes/DattoBackup/dattobackup.svg',
+    };
+    properties = [
+        {
+            displayName: 'Public API Key',
+            name: 'publicKey',
+            type: 'string',
+            default: '',
+            required: true,
+            description: 'The Public API Key from Datto Partner Portal (Admin > Integrations > API Keys)',
+        },
+        {
+            displayName: 'Secret API Key',
+            name: 'secretKey',
+            type: 'string',
+            typeOptions: {
+                password: true,
+            },
+            default: '',
+            required: true,
+            description: 'The Secret API Key from Datto Partner Portal (Admin > Integrations > API Keys)',
+        },
+    ];
+    authenticate = {
+        type: 'generic',
+        properties: {
+            headers: {
+                Authorization: '=Basic {{Buffer.from($credentials.publicKey + ":" + $credentials.secretKey).toString("base64")}}',
+            },
+        },
+    };
+    test = {
+        request: {
+            baseURL: 'https://api.datto.com/v1',
+            url: '/bcdr/device',
+            method: 'GET',
+            qs: {
+                _page: 1,
+                _perPage: 1,
+            },
+        },
+    };
+}
+exports.DattoBackupApi = DattoBackupApi;
+//# sourceMappingURL=DattoBackupApi.credentials.js.map

package/dist/credentials/DattoBackupApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DattoBackupApi.credentials.js","sourceRoot":"","sources":["../../credentials/DattoBackupApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,cAAc;IAC1B,IAAI,GAAG,gBAAgB,CAAC;IAExB,WAAW,GAAG,kBAAkB,CAAC;IAEjC,gBAAgB,GAAG,iDAAiD,CAAC;IAErE,IAAI,GAAG;QACN,KAAK,EAAE,2CAA2C;QAClD,IAAI,EAAE,2CAA2C;KACxC,CAAC;IAEX,UAAU,GAAsB;QAC/B;YACC,WAAW,EAAE,gBAAgB;YAC7B,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,gFAAgF;SAC7F;QACD;YACC,WAAW,EAAE,gBAAgB;YAC7B,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE;gBACZ,QAAQ,EAAE,IAAI;aACd;YACD,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,gFAAgF;SAC7F;KACD,CAAC;IAEF,YAAY,GAAyB;QACpC,IAAI,EAAE,SAAS;QACf,UAAU,EAAE;YACX,OAAO,EAAE;gBACR,aAAa,EACZ,kGAAkG;aACnG;SACD;KACD,CAAC;IAEF,IAAI,GAA2B;QAC9B,OAAO,EAAE;YACR,OAAO,EAAE,0BAA0B;YACnC,GAAG,EAAE,cAAc;YACnB,MAAM,EAAE,KAAK;YACb,EAAE,EAAE;gBACH,KAAK,EAAE,CAAC;gBACR,QAAQ,EAAE,CAAC;aACX;SACD;KACD,CAAC;CACF;AAvDD,wCAuDC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './credentials/DattoBackupApi.credentials';
+export * from './nodes/DattoBackup/DattoBackup.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":"AAAA,cAAc,0CAA0C,CAAC;AACzD,cAAc,sCAAsC,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+"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 __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/DattoBackupApi.credentials"), exports);
+__exportStar(require("./nodes/DattoBackup/DattoBackup.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,2EAAyD;AACzD,uEAAqD"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"DattoBackup.node.d.ts","sourceRoot":"","sources":["../../../nodes/DattoBackup/DattoBackup.node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,iBAAiB,EAEjB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,SAAS,EACT,oBAAoB,EACpB,MAAM,cAAc,CAAC;AAyCtB,qBAAa,WAAY,YAAW,SAAS;IAC5C,WAAW,EAAE,oBAAoB,CA+I/B;IAEF,OAAO;;6BAEkB,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;mCAGjD,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;;MAIpF;IAEI,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;CA2dvE"}