@seventhingscompany/n8n-nodes-seventhings 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 seventhings GmbH
+
+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,108 @@
+# @seventhingscompany/n8n-nodes-seventhings
+
+This is an n8n community node. It lets you use [seventhings](https://seventhings.com/) in your n8n workflows.
+
+seventhings is an asset-management and inventory platform for tracking physical assets, tasks, rental cases, locations and rooms across an organization. This package adds two nodes: a **Seventhings** action node for reading and writing those records, and a **Seventhings Trigger** node that starts workflows when records change.
+
+[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/sustainable-use-license/) workflow automation platform.
+
+[Installation](#installation)
+[Operations](#operations)
+[Credentials](#credentials)
+[Compatibility](#compatibility)
+[Usage](#usage)
+[Resources](#resources)
+[Version history](#version-history)
+
+## Installation
+
+Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.
+
+Install the package `@seventhingscompany/n8n-nodes-seventhings` from **Settings → Community Nodes** in your n8n instance.
+
+## Operations
+
+This package provides two nodes.
+
+### Seventhings (action node)
+
+Manage assets, tasks, rental cases, locations, rooms and files. The node is organized by **resource**, each with its own set of operations.
+
+| Resource | Operations |
+|----------|------------|
+| **Asset** | Create, Update, Get, Get Many, Archive, Unarchive, Delete, Move to Location, Move to Room, Attach File, Detach File |
+| **Task** | Create, Update, Get, Get Many, Close, Reopen, Delete |
+| **Rental Case** | Create, Update, Get, Get Many, Delete |
+| **Location** | Create, Update, Get, Get Many, Delete |
+| **Room** | Create, Update, Get, Get Many, Delete |
+| **File** | Upload |
+
+Notes:
+
+- **Get** looks a record up by UUID; **Get Many** lists/filters records with a **Return All** toggle and a **Limit**.
+- **Asset** and **Room** Create/Update expose your tenant's own custom fields dynamically (via a resource mapper that reads the field definitions), so the inputs match your seventhings configuration.
+- **Asset → Create** supports a find-or-create behaviour to avoid duplicates.
+- **Asset → Attach File / Detach File** target an attachment-type field, picked from a dropdown of the asset's attachment fields.
+- **Room** records belong to a **Building** (a Location), selected from a dropdown.
+- **File → Upload** accepts either an upstream node's **binary** data or a public **URL** to download, and returns the uploaded file's UUID — which you can then attach to an asset.
+
+### Seventhings Trigger (polling)
+
+Starts a workflow when seventhings records change. The trigger **polls** the API (there are no webhooks). Pick one event:
+
+- **New Asset**, **Updated Asset**
+- **New Task**, **Updated Task**, **Task Closed**, **Task Reopened**, **Task Overdue**, **Task Due Soon**
+- **New Rental Case**, **Updated Rental Case**, **Rental Case Returned**
+
+**Task Due Soon** has a **Days Ahead** input (default 3) controlling how far ahead to look for upcoming deadlines.
+
+## Credentials
+
+You need a seventhings account and API access.
+
+**Prerequisites**
+
+- A seventhings instance (you log in at `https://<yourcompany>.seventhings.com`).
+- A **Client ID**, found in seventhings under **Integrations → Rest API**.
+
+**Setting up the credential**
+
+Create a **Seventhings API** credential with:
+
+- **Subdomain** — the `<yourcompany>` part of your seventhings URL.
+- **Username** — your seventhings login (an email address).
+- **Password** — your seventhings password.
+- **Client ID** — from Integrations → Rest API.
+
+Authentication uses a session bearer token obtained via a password grant. n8n fetches and caches the token automatically and refreshes it when it expires, so you only ever enter the four fields above. Use **Test** to confirm the connection.
+
+## Compatibility
+
+- Requires **n8n 1.x** (uses `n8nNodesApiVersion: 1`).
+- Built and tested against **Node.js 20+**.
+
+No known incompatibilities. If you hit one, please open an issue.
+
+## Usage
+
+- Records are selected through searchable dropdowns (resource locators) — start typing to find an asset, task, location, room or rental case, or paste a UUID directly.
+- For list operations, enable **Return All** to fetch every record, or leave it off and set a **Limit**.
+- For **Asset → Attach File / Detach File**, first **Upload** a file (File resource) to get its UUID, then choose the asset's attachment field from the dropdown.
+- The action node is usable as a tool by AI agents.
+
+New to n8n? See the [Try it out](https://docs.n8n.io/try-it-out/) documentation to get started.
+
+## Resources
+
+* [n8n community nodes documentation](https://docs.n8n.io/integrations/#community-nodes)
+* [seventhings API documentation](https://helpcenter.seventhings.com/en/articles/58547-how-do-i-use-the-seventhings-api)
+
+## Version history
+
+### 0.1.0
+
+Initial release. Full parity with the seventhings Zapier integration:
+
+- **Seventhings** action node with Asset, Task, Rental Case, Location, Room and File resources.
+- **Seventhings Trigger** node with 11 polling events.
+- Session-token authentication with automatic refresh.

package/dist/credentials/SeventhingsApi.credentials.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SeventhingsApi = void 0;
+const validators_1 = require("../nodes/Seventhings/transport/validators");
+class SeventhingsApi {
+    constructor() {
+        this.name = 'seventhingsApi';
+        this.displayName = 'Seventhings API';
+        this.icon = { light: 'file:seventhings.svg', dark: 'file:seventhings.dark.svg' };
+        this.documentationUrl = 'https://helpcenter.seventhings.com/en/articles/58547-how-do-i-use-the-seventhings-api';
+        this.properties = [
+            {
+                displayName: 'Subdomain',
+                name: 'subdomain',
+                type: 'string',
+                default: '',
+                required: true,
+                placeholder: 'yourcompany',
+                description: 'The subdomain of your seventhings instance. If you log in at https://yourcompany.seventhings.com, enter "yourcompany".',
+            },
+            {
+                displayName: 'Username',
+                name: 'username',
+                type: 'string',
+                default: '',
+                required: true,
+                placeholder: 'name@example.com',
+                description: 'Your seventhings login username (email address)',
+            },
+            {
+                displayName: 'Password',
+                name: 'password',
+                type: 'string',
+                typeOptions: {
+                    password: true,
+                },
+                default: '',
+                required: true,
+                description: 'Your seventhings password',
+            },
+            {
+                displayName: 'Client ID',
+                name: 'clientId',
+                type: 'string',
+                default: '',
+                required: true,
+                description: 'Your client ID, found in seventhings under Integrations → Rest API',
+            },
+            {
+                displayName: 'Session Token',
+                name: 'sessionToken',
+                type: 'string',
+                typeOptions: {
+                    password: true,
+                    expirable: true,
+                },
+                default: '',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.sessionToken}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '=https://{{$credentials.subdomain}}.seventhings.com',
+                url: '/customer-api/v1/users',
+                method: 'GET',
+            },
+        };
+    }
+    async preAuthentication(credentials) {
+        const baseUrl = (0, validators_1.buildBaseUrl)(credentials.subdomain);
+        const username = (0, validators_1.validateEmail)(credentials.username);
+        const response = (await this.helpers.httpRequest({
+            method: 'POST',
+            url: `${baseUrl}/customer-api/v1/auth_token`,
+            headers: {
+                'Content-Type': 'application/x-www-form-urlencoded',
+                Accept: 'application/json',
+            },
+            body: {
+                username,
+                password: credentials.password,
+                client_id: credentials.clientId,
+                grant_type: 'password',
+            },
+        }));
+        const accessToken = response === null || response === void 0 ? void 0 : response.access_token;
+        if (typeof accessToken !== 'string' || accessToken === '') {
+            throw new Error('Authentication failed: no access token returned by seventhings.');
+        }
+        return { sessionToken: accessToken };
+    }
+}
+exports.SeventhingsApi = SeventhingsApi;

package/dist/credentials/seventhings.dark.svg

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg xmlns="http://www.w3.org/2000/svg" version="1.1" width="1418px" height="1418px" style="shape-rendering:geometricPrecision; text-rendering:geometricPrecision; image-rendering:optimizeQuality; fill-rule:evenodd; clip-rule:evenodd" xmlns:xlink="http://www.w3.org/1999/xlink">
+<g><path style="opacity:1" fill="#f9faf9" d="M 282.5,282.5 C 471.833,282.5 661.167,282.5 850.5,282.5C 850.5,376.833 850.5,471.167 850.5,565.5C 944.833,565.5 1039.17,565.5 1133.5,565.5C 1133.5,660.5 1133.5,755.5 1133.5,850.5C 999.166,850.333 864.833,850.5 730.5,851C 788.137,861.971 826.637,895.138 846,950.5C 863.217,1020.54 842.384,1076.04 783.5,1117C 742.56,1140.12 699.894,1143.79 655.5,1128C 597.192,1102.26 566.526,1057.42 563.5,993.5C 565.598,938.439 589.931,896.606 636.5,868C 652.144,859.341 668.811,853.674 686.5,851C 646.168,850.5 605.835,850.333 565.5,850.5C 569.264,741.075 617.597,658.242 710.5,602C 746.073,582.476 784.073,570.809 824.5,567C 643.834,566.5 463.167,566.333 282.5,566.5C 282.5,471.833 282.5,377.167 282.5,282.5 Z"/></g>
+</svg>

package/dist/credentials/seventhings.svg

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg xmlns="http://www.w3.org/2000/svg" version="1.1" width="1418px" height="1418px" style="shape-rendering:geometricPrecision; text-rendering:geometricPrecision; image-rendering:optimizeQuality; fill-rule:evenodd; clip-rule:evenodd" xmlns:xlink="http://www.w3.org/1999/xlink">
+<g><path style="opacity:1" fill="#000000" d="M 282.5,282.5 C 471.833,282.5 661.167,282.5 850.5,282.5C 850.5,376.833 850.5,471.167 850.5,565.5C 944.833,565.5 1039.17,565.5 1133.5,565.5C 1133.5,660.5 1133.5,755.5 1133.5,850.5C 999.166,850.333 864.833,850.5 730.5,851C 788.137,861.971 826.637,895.138 846,950.5C 863.217,1020.54 842.384,1076.04 783.5,1117C 742.56,1140.12 699.894,1143.79 655.5,1128C 597.192,1102.26 566.526,1057.42 563.5,993.5C 565.598,938.439 589.931,896.606 636.5,868C 652.144,859.341 668.811,853.674 686.5,851C 646.168,850.5 605.835,850.333 565.5,850.5C 569.264,741.075 617.597,658.242 710.5,602C 746.073,582.476 784.073,570.809 824.5,567C 643.834,566.5 463.167,566.333 282.5,566.5C 282.5,471.833 282.5,377.167 282.5,282.5 Z"/></g>
+</svg>

package/dist/nodes/Seventhings/Seventhings.node.js

@@ -0,0 +1,251 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Seventhings = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const AssetDescription_1 = require("./descriptions/AssetDescription");
+const TaskDescription_1 = require("./descriptions/TaskDescription");
+const RentalCaseDescription_1 = require("./descriptions/RentalCaseDescription");
+const LocationDescription_1 = require("./descriptions/LocationDescription");
+const RoomDescription_1 = require("./descriptions/RoomDescription");
+const FileDescription_1 = require("./descriptions/FileDescription");
+const asset_1 = require("./actions/asset");
+const task_1 = require("./actions/task");
+const rentalCase_1 = require("./actions/rentalCase");
+const location_1 = require("./actions/location");
+const room_1 = require("./actions/room");
+const file_1 = require("./actions/file");
+const methods_1 = require("./methods");
+const resourceProperty = {
+    displayName: 'Resource',
+    name: 'resource',
+    type: 'options',
+    noDataExpression: true,
+    options: [
+        { name: 'Asset', value: 'asset' },
+        { name: 'File', value: 'file' },
+        { name: 'Location', value: 'location' },
+        { name: 'Rental Case', value: 'rentalCase' },
+        { name: 'Room', value: 'room' },
+        { name: 'Task', value: 'task' },
+    ],
+    default: 'asset',
+};
+const taskOperations = {
+    displayName: 'Operation',
+    name: 'operation',
+    type: 'options',
+    noDataExpression: true,
+    displayOptions: { show: { resource: ['task'] } },
+    options: [
+        { name: 'Close', value: 'close', description: 'Close a task', action: 'Close a task' },
+        { name: 'Create', value: 'create', description: 'Create a task', action: 'Create a task' },
+        { name: 'Delete', value: 'delete', description: 'Delete a task', action: 'Delete a task' },
+        { name: 'Get', value: 'get', description: 'Get a task by UUID', action: 'Get a task' },
+        { name: 'Get Many', value: 'getAll', description: 'Get many tasks', action: 'Get many tasks' },
+        { name: 'Reopen', value: 'reopen', description: 'Reopen a task', action: 'Reopen a task' },
+        { name: 'Update', value: 'update', description: 'Update a task', action: 'Update a task' },
+    ],
+    default: 'create',
+};
+const rentalCaseOperations = {
+    displayName: 'Operation',
+    name: 'operation',
+    type: 'options',
+    noDataExpression: true,
+    displayOptions: { show: { resource: ['rentalCase'] } },
+    options: [
+        {
+            name: 'Create',
+            value: 'create',
+            description: 'Create a rental case',
+            action: 'Create a rental case',
+        },
+        {
+            name: 'Delete',
+            value: 'delete',
+            description: 'Delete a rental case',
+            action: 'Delete a rental case',
+        },
+        {
+            name: 'Get',
+            value: 'get',
+            description: 'Get a rental case by UUID',
+            action: 'Get a rental case',
+        },
+        {
+            name: 'Get Many',
+            value: 'getAll',
+            description: 'Get many rental cases',
+            action: 'Get many rental cases',
+        },
+        {
+            name: 'Update',
+            value: 'update',
+            description: 'Update a rental case',
+            action: 'Update a rental case',
+        },
+    ],
+    default: 'create',
+};
+const locationOperations = {
+    displayName: 'Operation',
+    name: 'operation',
+    type: 'options',
+    noDataExpression: true,
+    displayOptions: { show: { resource: ['location'] } },
+    options: [
+        {
+            name: 'Create',
+            value: 'create',
+            description: 'Create a location',
+            action: 'Create a location',
+        },
+        {
+            name: 'Delete',
+            value: 'delete',
+            description: 'Delete a location',
+            action: 'Delete a location',
+        },
+        { name: 'Get', value: 'get', description: 'Get a location by UUID', action: 'Get a location' },
+        {
+            name: 'Get Many',
+            value: 'getAll',
+            description: 'Get many locations',
+            action: 'Get many locations',
+        },
+        {
+            name: 'Update',
+            value: 'update',
+            description: 'Update a location',
+            action: 'Update a location',
+        },
+    ],
+    default: 'create',
+};
+const roomOperations = {
+    displayName: 'Operation',
+    name: 'operation',
+    type: 'options',
+    noDataExpression: true,
+    displayOptions: { show: { resource: ['room'] } },
+    options: [
+        { name: 'Create', value: 'create', description: 'Create a room', action: 'Create a room' },
+        { name: 'Delete', value: 'delete', description: 'Delete a room', action: 'Delete a room' },
+        { name: 'Get', value: 'get', description: 'Get a room by UUID', action: 'Get a room' },
+        { name: 'Get Many', value: 'getAll', description: 'Get many rooms', action: 'Get many rooms' },
+        { name: 'Update', value: 'update', description: 'Update a room', action: 'Update a room' },
+    ],
+    default: 'create',
+};
+const fileOperations = {
+    displayName: 'Operation',
+    name: 'operation',
+    type: 'options',
+    noDataExpression: true,
+    displayOptions: { show: { resource: ['file'] } },
+    options: [
+        { name: 'Upload', value: 'upload', description: 'Upload a file', action: 'Upload a file' },
+    ],
+    default: 'upload',
+};
+class Seventhings {
+    constructor() {
+        this.description = {
+            displayName: 'Seventhings',
+            name: 'seventhings',
+            icon: { light: 'file:seventhings.svg', dark: 'file:seventhings.dark.svg' },
+            group: ['output'],
+            version: 1,
+            subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+            description: 'Manage assets, tasks, rental cases, locations, rooms and files in seventhings',
+            defaults: {
+                name: 'Seventhings',
+            },
+            usableAsTool: true,
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            credentials: [
+                {
+                    name: 'seventhingsApi',
+                    required: true,
+                },
+            ],
+            properties: [
+                resourceProperty,
+                AssetDescription_1.assetOperations,
+                taskOperations,
+                rentalCaseOperations,
+                locationOperations,
+                roomOperations,
+                fileOperations,
+                ...AssetDescription_1.assetFields,
+                ...TaskDescription_1.taskFields,
+                ...RentalCaseDescription_1.rentalCaseFields,
+                ...LocationDescription_1.locationFields,
+                ...RoomDescription_1.roomFields,
+                ...FileDescription_1.fileFields,
+            ],
+        };
+        this.methods = {
+            loadOptions: methods_1.loadOptions,
+            listSearch: methods_1.listSearch,
+            resourceMapping: methods_1.resourceMapping,
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        for (let i = 0; i < items.length; i++) {
+            const resource = this.getNodeParameter('resource', i);
+            const operation = this.getNodeParameter('operation', i);
+            try {
+                if (resource === 'asset' && (0, asset_1.isAssetOperationSupported)(operation)) {
+                    const results = await asset_1.executeAssetOperation.call(this, operation, i);
+                    returnData.push(...results);
+                    continue;
+                }
+                if (resource === 'task' && (0, task_1.isTaskOperationSupported)(operation)) {
+                    const results = await task_1.executeTaskOperation.call(this, operation, i);
+                    returnData.push(...results);
+                    continue;
+                }
+                if (resource === 'rentalCase' && (0, rentalCase_1.isRentalCaseOperationSupported)(operation)) {
+                    const results = await rentalCase_1.executeRentalCaseOperation.call(this, operation, i);
+                    returnData.push(...results);
+                    continue;
+                }
+                if (resource === 'location' && (0, location_1.isLocationOperationSupported)(operation)) {
+                    const results = await location_1.executeLocationOperation.call(this, operation, i);
+                    returnData.push(...results);
+                    continue;
+                }
+                if (resource === 'room' && (0, room_1.isRoomOperationSupported)(operation)) {
+                    const results = await room_1.executeRoomOperation.call(this, operation, i);
+                    returnData.push(...results);
+                    continue;
+                }
+                if (resource === 'file' && (0, file_1.isFileOperationSupported)(operation)) {
+                    const results = await file_1.executeFileOperation.call(this, operation, i);
+                    returnData.push(...results);
+                    continue;
+                }
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), `The operation "${operation}" for resource "${resource}" is not implemented yet.`, { itemIndex: i });
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({
+                        json: { error: error.message },
+                        pairedItem: { item: i },
+                    });
+                    continue;
+                }
+                if (error instanceof n8n_workflow_1.NodeOperationError) {
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), error, { itemIndex: i });
+                }
+                throw new n8n_workflow_1.NodeApiError(this.getNode(), error, { itemIndex: i });
+            }
+        }
+        return [returnData];
+    }
+}
+exports.Seventhings = Seventhings;

package/dist/nodes/Seventhings/Seventhings.node.json

@@ -0,0 +1,18 @@
+{
+    "node": "n8n-nodes-base.seventhings",
+    "nodeVersion": "1.0",
+    "codexVersion": "1.0",
+    "categories": ["Productivity"],
+    "resources": {
+        "credentialDocumentation": [
+            {
+                "url": "https://github.com/seventhingscompany/n8n-nodes-seventhings?tab=readme-ov-file#credentials"
+            }
+        ],
+        "primaryDocumentation": [
+            {
+                "url": "https://github.com/seventhingscompany/n8n-nodes-seventhings?tab=readme-ov-file"
+            }
+        ]
+    }
+}