n8n-nodes-leadtime 0.1.0 → 0.1.7

package/README.md

@@ -1,499 +1,7 @@
 # n8n-nodes-leadtime
 
-Community node for the [Leadtime ERP](https://leadtime.de) Public API.
+This library was generated with [Nx](https://nx.dev).
 
-![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)
+## Building
 
-**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.
-
----
-
-## 📦 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>
-
-**Project** - Full CRUD for projects
-- Get Many, Get, Create, Update, Delete
-- Get Categories, Statuses, Phases
-
-**Project Sub-Resources:**
-- Documentation (articles)
-- Journal (entries)
-- Uploads (files)
-- Documents (project documents)
-
-</details>
-
-<details>
-<summary><strong>Task Management</strong> (22 operations)</summary>
-
-**Task** - Full CRUD with advanced features
-- Get Many, Get, Create, Update, Delete
-- Bulk Create, Bulk Update
-- Get Custom Fields
-
-**Task Comment** - Commenting system
-- Get Many, Create, Update, Delete
-- Status change & time booking in one call
-
-**Task Subtask** - Subtask management
-- Add, Remove
-
-**Task Planning:**
-- Stack (personal Kanban board)
-- Pipeline (team planning view)
-- Pipeline Items (CRUD)
-
-**Task Product** - Product integration
-- Import products to tasks
-
-</details>
-
-<details>
-<summary><strong>Billing & Invoicing</strong> (19 operations)</summary>
-
-**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
-
-**Potential Invoice** - Invoice drafts
-- Get Many, Get, Update
-
-</details>
-
-### People & Organizations
-
-<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>
-
-**Organization** - Customer/partner management
-- Get Many, Get, Create, Update (Full/Partial), Delete
-
-**Organization Member** - External contacts
-- Get Many, Get, Create, Update, Delete
-
-**Organization Member Journal** - Member journal
-- Get Many, Get, Create, Update, Delete
-
-</details>
-
-### Time & Attendance
-
-<details>
-<summary><strong>Time Tracking</strong> (22 operations)</summary>
-
-**Time Booking** - Log working hours
-- Get Many, Create, Update, Delete
-
-**Timetable** - Unified calendar view
-- Get (employee schedule)
-
-**Attendance** - Clock in/out
-- Create/Update, Delete
-
-**Vacation Management:**
-- Request, Update, Cancel
-- Approve, Decline
-- Get (Pending/Upcoming/History)
-- Stats & Compensation
-
-**Sick Days:**
-- Request, Update, Delete
-- History
-
-**Overtime:**
-- Get Stats
-- Get Compensation History
-
-</details>
-
-### Analytics & Insights
-
-<details>
-<summary><strong>Analytics</strong> (5 operations)</summary>
-
-**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>
-
-### Administration
-
-<details>
-<summary><strong>Settings & Configuration</strong> (29 operations)</summary>
-
-**Workspace:**
-- Details, Upload File
-- List Users, Quick Search
-- Product List, Manual Position Categories
-
-**Product Management:**
-- Product Catalog (CRUD with variants)
-- Product Categories (Get/Delete)
-
-**Settings:**
-- Subscription Status
-- Basic Settings (localization, attendance, sprints)
-- Company Settings (master data)
-- Permissions List
-
-**Roles:**
-- Get Many, Get (with permissions)
-
-**VAT Rates:**
-- Get Many
-
-**Task Settings:**
-- Custom Fields, Activities, Statuses, Types
-
-**Project Settings:**
-- Categories, Statuses, Phases
-- Custom Fields
-- Support Contingents
-
-</details>
-
-### Personal
-
-<details>
-<summary><strong>Personal Tools</strong> (13 operations)</summary>
-
-**Account:**
-- Get Info
-- Get/Update Employee Data
-
-**Journal:**
-- Get Many, Create, Update (Full/Partial), Delete
-
-**Notification:**
-- Get Many (with unread filter)
-
-</details>
-
-### Sales
-
-<details>
-<summary><strong>Sales Tools</strong> (2 operations)</summary>
-
-**Sales:**
-- Get Estimates
-- Get Opportunities
-
-</details>
-
----
-
-## 💡 Usage Examples
-
-### Create a Task with Time Tracking
-
-```javascript
-// n8n node configuration
-{
-  "resource": "task",
-  "operation": "create",
-  "projectId": "{{ $json.projectId }}",
-  "title": "Implement new feature",
-  "typeId": "{{ $json.typeId }}",
-  "statusId": "{{ $json.statusId }}",
-  "priority": "High",
-  "estimatedTime": 8,
-  "assignedToId": "{{ $json.userId }}",
-  "description": "<p>Detailed task description</p>"
-}
-```
-
-### Add Comment with Time Booking
-
-```javascript
-{
-  "resource": "taskComment",
-  "operation": "create",
-  "taskIdentifier": "{{ $json.taskId }}",
-  "comment": "Completed implementation",
-  "statusId": "{{ $json.doneStatusId }}",
-  "timeBookingHours": 2,
-  "timeBookingActivityId": "{{ $json.activityId }}"
-}
-```
-
-### Get Invoice PDF
-
-```javascript
-{
-  "resource": "invoice",
-  "operation": "getFileUrl",
-  "invoiceId": "{{ $json.invoiceId }}",
-  "fileType": "pdf",
-  "documentType": "invoice"
-}
-```
-
-### Upload File to Workspace
-
-```javascript
-{
-  "resource": "workspace",
-  "operation": "uploadFile",
-  "file": "{{ $binary.file }}"
-}
-```
-
-### Get Project Analytics
-
-```javascript
-{
-  "resource": "insight",
-  "operation": "getProjectChart",
-  "projectIds": "{{ $json.projectIds }}",
-  "model": "timeSeries",
-  "period": "weeks",
-  "breakdown": "byUser",
-  "startDate": "2024-01-01",
-  "endDate": "2024-12-31"
-}
-```
-
-### Bulk Create Tasks
-
-```javascript
-{
-  "resource": "task",
-  "operation": "bulkCreate",
-  "tasksJson": JSON.stringify([
-    {
-      "title": "Task 1",
-      "projectId": "...",
-      "typeId": "...",
-      "statusId": "..."
-    },
-    {
-      "title": "Task 2",
-      "projectId": "...",
-      "typeId": "...",
-      "statusId": "..."
-    }
-  ])
-}
-```
-
----
-
-## 🎨 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 |
-
-### Cascading Dropdowns Example
-
-When creating a task, dropdowns cascade intelligently:
-
-```
-1. Select Project → loads project-specific task types
-2. Select Task Type → loads allowed statuses for that type
-3. Select Status → ready to assign
-4. Select Assignee → loads only team members from selected project
-```
-
----
-
-## 🔧 Development
-
-### Prerequisites
-
-- 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
-npm install
-npm run build
-
-# Link for local testing
-npm link
-cd ~/.n8n/custom
-npm link n8n-nodes-leadtime
-
-# Start n8n
-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
-
----
-
-## 🐛 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
-
----
-
-## 🤝 Contributing
-
-Contributions are welcome! Please:
-
-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
-
-### 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`
-
----
-
-## 📝 License
-
-MIT License - see [LICENSE](LICENSE) file
-
-Copyright (c) 2024 Lukas Ebner / Leadtime Labs GmbH
-
----
-
-## 👤 Author
-
-**Lukas Ebner**  
-Leadtime Labs GmbH  
-[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)
-
----
-
-## 🙏 Acknowledgments
-
-- [n8n](https://n8n.io) - Workflow automation platform
-- [Leadtime](https://leadtime.de) - ERP for digital service companies
-
----
-
-**Made with ❤️ for the n8n Community**
+Run `nx build n8n-nodes-leadtime` to build the library.

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"}