n8n-nodes-leadtime 0.1.0 → 0.1.9

package/README.md

@@ -1,266 +1,170 @@
 # n8n-nodes-leadtime
 
-Community node for the [Leadtime ERP](https://leadtime.de) Public API.
-
-![n8n](https://img.shields.io/badge/n8n-Community%20Node-FF6D5A?style=flat-square)
-![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?style=flat-square)
-![License](https://img.shields.io/badge/License-MIT-green?style=flat-square)
-![npm](https://img.shields.io/npm/v/n8n-nodes-leadtime?style=flat-square)
-
-**Leadtime** is an ERP system designed specifically for digital service companies (IT agencies, SaaS companies, consulting firms) in the DACH region. This n8n community node provides comprehensive access to Leadtime's Public API for workflow automation.
-
----
+n8n community node for Leadtime ERP - Project management, time tracking, billing, and more for digital service companies.
 
 ## 📦 Installation
 
-### In n8n
-
-1. Go to **Settings → Community Nodes**
-2. Click **Install a community node**
-3. Enter package name: `n8n-nodes-leadtime`
-4. Install and restart n8n
-
-### Manual Installation
-
 ```bash
-cd ~/.n8n/custom
 npm install n8n-nodes-leadtime
 ```
 
----
-
-## 🔐 Credentials Setup
-
-1. In n8n, create a new **Leadtime API** credential
-2. Enter your **Personal Access Token**
-   - Create one in: Leadtime → Settings → API → Personal Access Tokens
-3. Test the connection (performs a test request to `/workspace/quick-search`)
-
-**Required Scopes:**
-- `api:read` - for read operations
-- `api:write` - for create/update/delete operations
-
----
-
-## 🚀 Features
-
-- ✅ **159 Operations** across 39 resources
-- ✅ **12 Dynamic Dropdowns** (Projects, Tasks, Employees, Teams, etc.)
-- ✅ **Cascading Dropdowns** (Project → Type → Status → Assignee)
-- ✅ **File Upload** Support (multipart/form-data)
-- ✅ **Pagination** with returnAll option
-- ✅ **Advanced Filtering** (JSON-based filters)
-- ✅ **Bulk Operations** (Create/Update multiple tasks)
-- ✅ **~95% API Coverage** of Leadtime Public API
-
----
-
-## 📚 Supported Resources
-
-### Core Business Operations
-
-<details>
-<summary><strong>Project Management</strong> (26 operations)</summary>
+After installation, restart n8n. The node will appear in the node palette under **Leadtime**.
 
-**Project** - Full CRUD for projects
-- Get Many, Get, Create, Update, Delete
-- Get Categories, Statuses, Phases
+## 🔑 Authentication
 
-**Project Sub-Resources:**
-- Documentation (articles)
-- Journal (entries)
-- Uploads (files)
-- Documents (project documents)
+The node uses API key authentication. To get your API key:
 
-</details>
+1. Log in to your Leadtime workspace
+2. Go to **Settings** → **API Keys**
+3. Create a new API key
+4. Copy the key and paste it into the node credentials
 
-<details>
-<summary><strong>Task Management</strong> (22 operations)</summary>
+## 🎯 Features
 
-**Task** - Full CRUD with advanced features
-- Get Many, Get, Create, Update, Delete
-- Bulk Create, Bulk Update
-- Get Custom Fields
+### Comprehensive API Coverage
 
-**Task Comment** - Commenting system
-- Get Many, Create, Update, Delete
-- Status change & time booking in one call
+The node provides access to **200+ operations** across all Leadtime ERP modules:
 
-**Task Subtask** - Subtask management
-- Add, Remove
+### Project Management
 
-**Task Planning:**
-- Stack (personal Kanban board)
-- Pipeline (team planning view)
-- Pipeline Items (CRUD)
+**Project** (12 operations)
+* Get Many, Get, Create, Update (Full/Partial), Delete
+* Upload File, Get File URL
+* Get Team Members, Get Statistics
 
-**Task Product** - Product integration
-- Import products to tasks
+**Task** (18 operations)
+* Get Many (with filters), Get, Create, Update (Full/Partial), Delete
+* Bulk Create, Bulk Update, Bulk Delete
+* Add Comment, Get Comments
+* Get File URL, Upload File
+* Get Time Bookings, Get Statistics
 
-</details>
+**Task Comment** (4 operations)
+* Get Many, Get, Create, Update, Delete
 
-<details>
-<summary><strong>Billing & Invoicing</strong> (19 operations)</summary>
+**Task Template** (5 operations)
+* Get Many, Get, Create, Update, Delete
 
-**Invoice** - Complete invoice lifecycle
-- Get (New/Paid/Canceled/Overdue)
-- Mark as Paid/Unpaid/Sent
-- Send via Email
-- Get PDF/XML Download URL
-- Invoice Settings
-- Contact Management
+**Sprint** (6 operations)
+* Get Many, Get, Create, Update, Delete
 
-**Potential Invoice** - Invoice drafts
-- Get Many, Get, Update
+**Project Template** (5 operations)
+* Get Many, Get, Create, Update, Delete
 
-</details>
+### CRM & Contacts
 
-### People & Organizations
+**Contact** (1 operation)
+* Get Many (with filters)
 
-<details>
-<summary><strong>Employees & Teams</strong> (15 operations)</summary>
-
-**Employee** - Employee management
-- Get Many, Get, Create, Update, Delete
-
-**Team** - Team management
-- Get Many, Get, Create, Delete
-
-**Contact** - Contact management
-- Get Many (with filters)
-
-</details>
-
-<details>
-<summary><strong>Organizations</strong> (16 operations)</summary>
+**Organizations** (16 operations)
 
 **Organization** - Customer/partner management
-- Get Many, Get, Create, Update (Full/Partial), Delete
+* Get Many, Get, Create, Update (Full/Partial), Delete
 
 **Organization Member** - External contacts
-- Get Many, Get, Create, Update, Delete
+* Get Many, Get, Create, Update, Delete
 
 **Organization Member Journal** - Member journal
-- Get Many, Get, Create, Update, Delete
-
-</details>
+* Get Many, Get, Create, Update, Delete
 
 ### Time & Attendance
 
-<details>
-<summary><strong>Time Tracking</strong> (22 operations)</summary>
+**Time Tracking** (22 operations)
 
 **Time Booking** - Log working hours
-- Get Many, Create, Update, Delete
+* Get Many, Create, Update, Delete
 
 **Timetable** - Unified calendar view
-- Get (employee schedule)
+* Get (employee schedule)
 
 **Attendance** - Clock in/out
-- Create/Update, Delete
+* Create/Update, Delete
 
 **Vacation Management:**
-- Request, Update, Cancel
-- Approve, Decline
-- Get (Pending/Upcoming/History)
-- Stats & Compensation
+* Request, Update, Cancel
+* Approve, Decline
+* Get (Pending/Upcoming/History)
+* Stats & Compensation
 
 **Sick Days:**
-- Request, Update, Delete
-- History
+* Request, Update, Delete
+* History
 
 **Overtime:**
-- Get Stats
-- Get Compensation History
-
-</details>
+* Get Stats
+* Get Compensation History
 
 ### Analytics & Insights
 
-<details>
-<summary><strong>Analytics</strong> (5 operations)</summary>
+**Analytics** (5 operations)
 
 **Insight** - Business intelligence
-- Project Chart (working hours analysis)
-- Staff Chart (employee time analysis)
-- Turnover Chart (revenue analysis & forecast)
-- Goal Chart (employee goal progress)
-- Workload Chart (open tasks analysis)
-
-</details>
+* Project Chart (working hours analysis)
+* Staff Chart (employee time analysis)
+* Turnover Chart (revenue analysis & forecast)
+* Goal Chart (employee goal progress)
+* Workload Chart (open tasks analysis)
 
 ### Administration
 
-<details>
-<summary><strong>Settings & Configuration</strong> (29 operations)</summary>
+**Settings & Configuration** (29 operations)
 
 **Workspace:**
-- Details, Upload File
-- List Users, Quick Search
-- Product List, Manual Position Categories
+* Details, Upload File
+* List Users, Quick Search
+* Product List, Manual Position Categories
 
 **Product Management:**
-- Product Catalog (CRUD with variants)
-- Product Categories (Get/Delete)
+* Product Catalog (CRUD with variants)
+* Product Categories (Get/Delete)
 
 **Settings:**
-- Subscription Status
-- Basic Settings (localization, attendance, sprints)
-- Company Settings (master data)
-- Permissions List
+* Subscription Status
+* Basic Settings (localization, attendance, sprints)
+* Company Settings (master data)
+* Permissions List
 
 **Roles:**
-- Get Many, Get (with permissions)
+* Get Many, Get (with permissions)
 
 **VAT Rates:**
-- Get Many
+* Get Many
 
 **Task Settings:**
-- Custom Fields, Activities, Statuses, Types
+* Custom Fields, Activities, Statuses, Types
 
 **Project Settings:**
-- Categories, Statuses, Phases
-- Custom Fields
-- Support Contingents
-
-</details>
+* Categories, Statuses, Phases
+* Custom Fields
+* Support Contingents
 
 ### Personal
 
-<details>
-<summary><strong>Personal Tools</strong> (13 operations)</summary>
+**Personal Tools** (13 operations)
 
 **Account:**
-- Get Info
-- Get/Update Employee Data
+* Get Info
+* Get/Update Employee Data
 
 **Journal:**
-- Get Many, Create, Update (Full/Partial), Delete
+* Get Many, Create, Update (Full/Partial), Delete
 
 **Notification:**
-- Get Many (with unread filter)
-
-</details>
+* Get Many (with unread filter)
 
 ### Sales
 
-<details>
-<summary><strong>Sales Tools</strong> (2 operations)</summary>
+**Sales Tools** (2 operations)
 
 **Sales:**
-- Get Estimates
-- Get Opportunities
-
-</details>
-
----
+* Get Estimates
+* Get Opportunities
 
 ## 💡 Usage Examples
 
 ### Create a Task with Time Tracking
 
-```javascript
-// n8n node configuration
+```json
 {
   "resource": "task",
   "operation": "create",
@@ -277,7 +181,7 @@ npm install n8n-nodes-leadtime
 
 ### Add Comment with Time Booking
 
-```javascript
+```json
 {
   "resource": "taskComment",
   "operation": "create",
@@ -291,7 +195,7 @@ npm install n8n-nodes-leadtime
 
 ### Get Invoice PDF
 
-```javascript
+```json
 {
   "resource": "invoice",
   "operation": "getFileUrl",
@@ -303,7 +207,7 @@ npm install n8n-nodes-leadtime
 
 ### Upload File to Workspace
 
-```javascript
+```json
 {
   "resource": "workspace",
   "operation": "uploadFile",
@@ -313,7 +217,7 @@ npm install n8n-nodes-leadtime
 
 ### Get Project Analytics
 
-```javascript
+```json
 {
   "resource": "insight",
   "operation": "getProjectChart",
@@ -328,7 +232,7 @@ npm install n8n-nodes-leadtime
 
 ### Bulk Create Tasks
 
-```javascript
+```json
 {
   "resource": "task",
   "operation": "bulkCreate",
@@ -349,26 +253,24 @@ npm install n8n-nodes-leadtime
 }
 ```
 
----
-
 ## 🎨 Dynamic Dropdowns
 
 The node provides **12 intelligent dropdown methods** that automatically populate with data from your Leadtime workspace:
 
-| Dropdown | Purpose | Depends On |
-|----------|---------|------------|
-| `loadProjects` | Select projects | - |
-| `loadEmployees` | Select employees | - |
-| `loadTeams` | Select teams | - |
-| `loadTaskStatuses` | Select task statuses | - |
-| `loadTaskTypes` | Select task types | - |
-| `loadActivities` | Select work activities | - |
-| `loadProjectCategories` | Select project categories | - |
-| `loadProjectStatuses` | Select project statuses | - |
-| `loadProjectPhases` | Select project phases | - |
-| `loadProjectTaskTypes` | Task types for project | Project |
-| `loadTypeStatuses` | Statuses for task type | Task Type |
-| `loadProjectUsers` | Team members | Project |
+| Dropdown              | Purpose                   | Depends On |
+| --------------------- | ------------------------- | ---------- |
+| loadProjects          | Select projects           | -          |
+| loadEmployees         | Select employees          | -          |
+| loadTeams             | Select teams              | -          |
+| loadTaskStatuses      | Select task statuses      | -          |
+| loadTaskTypes         | Select task types         | -          |
+| loadActivities        | Select work activities    | -          |
+| loadProjectCategories | Select project categories | -          |
+| loadProjectStatuses   | Select project statuses   | -          |
+| loadProjectPhases     | Select project phases     | -          |
+| loadProjectTaskTypes  | Task types for project    | Project    |
+| loadTypeStatuses      | Statuses for task type    | Task Type  |
+| loadProjectUsers      | Team members              | Project    |
 
 ### Cascading Dropdowns Example
 
@@ -381,25 +283,24 @@ When creating a task, dropdowns cascade intelligently:
 4. Select Assignee → loads only team members from selected project
 ```
 
----
-
 ## 🔧 Development
 
 ### Prerequisites
 
-- Node.js >= 18
-- n8n >= 1.0.0
-- TypeScript >= 5.x
+* Node.js >= 18
+* n8n >= 1.0.0
+* TypeScript >= 5.x
 
 ### Local Development
 
 ```bash
-git clone https://github.com/LukasEbner/n8n-nodes-leadtime.git
-cd n8n-nodes-leadtime
+git clone https://github.com/workcio/workc.git
+cd workc
 npm install
-npm run build
+nx build n8n-nodes-leadtime
 
 # Link for local testing
+cd dist/libs/integrations/n8n-nodes-leadtime
 npm link
 cd ~/.n8n/custom
 npm link n8n-nodes-leadtime
@@ -408,41 +309,16 @@ npm link n8n-nodes-leadtime
 n8n start
 ```
 
-### Project Structure
-
-```
-n8n-nodes-leadtime/
-├── credentials/
-│   └── LeadtimeApi.credentials.ts     # API authentication
-├── nodes/
-│   └── Leadtime/
-│       ├── Leadtime.node.ts           # Main node (14,785 lines)
-│       └── leadtime.svg               # Icon
-├── dist/                               # Compiled output
-├── package.json
-├── tsconfig.json
-├── LICENSE
-├── README.md
-└── CHANGELOG.md
-```
-
----
-
 ## 📖 Documentation
 
-- **[Leadtime API Documentation](https://leadtime.app/api/public/docs)** - Official API reference
-- **[n8n Community Nodes](https://docs.n8n.io/integrations/creating-nodes/)** - n8n developer docs
-- **[CHANGELOG](./CHANGELOG.md)** - Version history
-
----
+* **Leadtime API Documentation** - Official API reference
+* **n8n Community Nodes** - n8n developer docs
 
 ## 🐛 Known Limitations
 
-- ⚠️ No webhook/trigger support (would require separate trigger node)
-- ⚠️ Batch file upload not implemented (single file upload works)
-- ⚠️ Some complex nested data structures require JSON input
-
----
+* ⚠️ No webhook/trigger support (would require separate trigger node)
+* ⚠️ Batch file upload not implemented (single file upload works)
+* ⚠️ Some complex nested data structures require JSON input
 
 ## 🤝 Contributing
 
@@ -456,43 +332,35 @@ Contributions are welcome! Please:
 
 ### Coding Guidelines
 
-- ✅ TypeScript strict mode
-- ✅ Consistent error handling (try/catch with type guards)
-- ✅ Use `i === 0` pattern for array responses to avoid duplicates
-- ✅ Full URLs for all API calls
-- ✅ Conditional fields with `displayOptions.show`
-
----
+* ✅ TypeScript strict mode
+* ✅ Consistent error handling (try/catch with type guards)
+* ✅ Use `i === 0` pattern for array responses to avoid duplicates
+* ✅ Full URLs for all API calls
+* ✅ Conditional fields with `displayOptions.show`
 
 ## 📝 License
 
-MIT License - see [LICENSE](LICENSE) file
+MIT License - see LICENSE file
 
 Copyright (c) 2024 Lukas Ebner / Leadtime Labs GmbH
 
----
-
 ## 👤 Author
 
 **Lukas Ebner**  
 Leadtime Labs GmbH  
-[https://leadtime.de](https://leadtime.de)
-
----
+<https://leadtime.de>
 
 ## 📮 Support
 
-- 🐛 [GitHub Issues](https://github.com/LukasEbner/n8n-nodes-leadtime/issues)
-- 💬 [n8n Community Forum](https://community.n8n.io)
-- 📧 Email: support@leadtime.de
-- 📚 [Leadtime Help Center](https://help.leadtime.de)
-
----
+* 🐛 GitHub Issues
+* 💬 n8n Community Forum
+* 📧 Email: support@leadtime.de
+* 📚 Leadtime Help Center
 
 ## 🙏 Acknowledgments
 
-- [n8n](https://n8n.io) - Workflow automation platform
-- [Leadtime](https://leadtime.de) - ERP for digital service companies
+* n8n - Workflow automation platform
+* Leadtime - ERP for digital service companies
 
 ---
 

package/credentials/LeadtimeApi.credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LeadtimeApi.credentials.d.ts","sourceRoot":"","sources":["../../../../../libs/integrations/n8n-nodes-leadtime/credentials/LeadtimeApi.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;IACrB,WAAW,SAAkB;IAC7B,gBAAgB,SAA0C;IAC1D,UAAU,EAAE,eAAe,EAAE,CAU3B;IAEF,YAAY,EAAE,oBAAoB,CAOhC;IAEF,IAAI,EAAE,sBAAsB,CAS1B;CACF"}

package/credentials/LeadtimeApi.credentials.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LeadtimeApi = void 0;
+class LeadtimeApi {
+    constructor() {
+        this.name = 'leadtimeApi';
+        this.displayName = 'Leadtime API';
+        this.documentationUrl = 'https://leadtime.app/api/public/docs';
+        this.properties = [
+            {
+                displayName: 'Personal Access Token',
+                name: 'accessToken',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'Your Leadtime Personal Access Token. Create one in Leadtime → Settings → API → Personal Access Tokens. Requires at least api:read scope.',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.accessToken}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: 'https://leadtime.app/api/public',
+                url: '/workspace/quick-search',
+                method: 'GET',
+                qs: {
+                    term: 'test',
+                },
+            },
+        };
+    }
+}
+exports.LeadtimeApi = LeadtimeApi;
+//# sourceMappingURL=LeadtimeApi.credentials.js.map

package/credentials/LeadtimeApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LeadtimeApi.credentials.js","sourceRoot":"","sources":["../../../../../libs/integrations/n8n-nodes-leadtime/credentials/LeadtimeApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,WAAW;IAAxB;QACC,SAAI,GAAG,aAAa,CAAC;QACrB,gBAAW,GAAG,cAAc,CAAC;QAC7B,qBAAgB,GAAG,sCAAsC,CAAC;QAC1D,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,uBAAuB;gBACpC,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,0IAA0I;aACvJ;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,yBAAyB;gBAC9B,MAAM,EAAE,KAAK;gBACb,EAAE,EAAE;oBACH,IAAI,EAAE,MAAM;iBACZ;aACD;SACD,CAAC;IACH,CAAC;CAAA;AAnCD,kCAmCC"}

package/nodes/Leadtime/Leadtime.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Leadtime.node.d.ts","sourceRoot":"","sources":["../../../../../../libs/integrations/n8n-nodes-leadtime/nodes/Leadtime/Leadtime.node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,SAAS,EACT,oBAAoB,EAEpB,MAAM,cAAc,CAAC;AAEtB,qBAAa,QAAS,YAAW,SAAS;IACzC,WAAW,EAAE,oBAAoB,CAw/RhC;IAED,OAAO;;+BAGoB,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;mCA4BnD,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;gCA2B1D,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;gCA2BvD,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;4BA2B5D,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;uCAwB5C,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;mCAyD1D,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;wCA2DnD,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;sCAyB1D,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;oCAyBzD,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;iCAyBzD,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;mCA4BrD,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;;MA6JnF;IAEI,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;CAw7JvE"}