n8n-nodes-qwease 0.3.9

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Qwease
+
+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,74 @@
+# n8n-nodes-qwease
+
+Community node for [n8n](https://n8n.io) — connect workflows to [Qwease](https://qwease.fr) ITSM (tickets, helpdesk, MSP).
+
+## Install
+
+**Settings → Community nodes → Install** → enter:
+
+```
+n8n-nodes-qwease
+```
+
+Or link locally during development:
+
+```bash
+npm run build
+npm link
+cd ~/.n8n/custom
+npm link n8n-nodes-qwease
+```
+
+## Credentials
+
+Create a **Qwease API** credential:
+
+- **API Token**: your Qwease bearer token (Administration). Paste the token only, without `Bearer`.
+
+Test calls `GET https://rest.qwease.fr/api/me/`.
+
+## Nodes (v0.3)
+
+### Qwease (action)
+
+| Resource | Operations |
+|----------|------------|
+| **Ticket** | Create · Get · Get Many · Update · Add Comment |
+| **User** | Create · Get · Get Many · Update |
+| **Organization** | Create · Get · Get Many · Update (`/client/`) |
+| **Device** | Create · Get · Get Many · Update |
+| **Team** | Create · Get · Get Many · Update |
+| **Knowledge** | Create · Get · Get Many · Update · Update Content · Search |
+| **Task** | Create · Get · Get Many · Update |
+| **Search** | Advanced Search · Quick Search |
+| **Me** | Get |
+
+Related objects use **From list / By ID**. Create flows show essential fields; optionals under **Additional Fields**.
+
+### Qwease Trigger (webhook)
+
+Starts on Qwease outbound webhooks:
+
+1. Activate the workflow and copy the Production webhook URL.
+2. Qwease Admin → Integrations → Webhooks → create URL + save the **secret** (shown once).
+3. Run **Test** on the webhook in Qwease.
+4. Automation → trigger event → action **Send webhook**.
+5. Paste the secret into the trigger node; optionally filter `event_type` values.
+
+Signature: HMAC-SHA256 header `X-Qwease-Signature-256` (raw hex). See [KB webhooks](https://app.notion.com/p/3cd7035fdb12819ea9b4e6487c384cc6).
+
+API reference: https://rest.qwease.fr/swagger/
+
+### Smoke local
+
+```bash
+npm run build
+npm link
+n8n start
+```
+
+Always rebuild then restart n8n after code changes.
+
+## License
+
+MIT

package/dist/credentials/QweaseApi.credentials.d.ts

@@ -0,0 +1,10 @@
+import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class QweaseApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    icon: "file:qwease.svg";
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/QweaseApi.credentials.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QweaseApi = void 0;
+class QweaseApi {
+    constructor() {
+        this.name = 'qweaseApi';
+        this.displayName = 'Qwease API';
+        this.icon = 'file:qwease.svg';
+        this.documentationUrl = 'https://rest.qwease.fr/swagger/';
+        this.properties = [
+            {
+                displayName: 'API Token',
+                name: 'apiToken',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'Bearer token from Qwease Administration (paste the token only, without the "Bearer" prefix)',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.apiToken}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: 'https://rest.qwease.fr/api',
+                url: '/me/',
+            },
+        };
+    }
+}
+exports.QweaseApi = QweaseApi;

package/dist/credentials/qwease.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 60 60" width="60" height="60">
+  <circle cx="30" cy="30" r="30" fill="#0B3D91"/>
+  <text x="30" y="38" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="32" font-weight="700" fill="#FFFFFF">Q</text>
+</svg>

package/dist/nodes/Qwease/FormFieldsHelper.d.ts

@@ -0,0 +1,21 @@
+import type { IDataObject, ILoadOptionsFunctions } from 'n8n-workflow';
+import { type QweaseContext } from './GenericFunctions';
+export type QweaseFormField = {
+    id: number;
+    name: string;
+    technical_name: string;
+    fields_type: string;
+    optionslist?: IDataObject[];
+};
+export declare function extractLocatorValue(value: unknown): string;
+export declare function parseOptionalId(value: unknown): number | undefined;
+export declare function extractStatutModelId(formDetails: IDataObject): number | undefined;
+export declare function extractFormIdFromTicket(ticket: IDataObject): number | undefined;
+export declare function resolveFormIdForLists(context: ILoadOptionsFunctions): Promise<number | undefined>;
+export declare function fetchFormFields(context: QweaseContext, formId: number): Promise<QweaseFormField[]>;
+/** Entity-scoped custom fields: type=user | client | device */
+export declare function fetchEntityFields(context: QweaseContext, fieldType: 'user' | 'client' | 'device'): Promise<QweaseFormField[]>;
+export declare function fetchFieldListOptions(context: QweaseContext, fieldId: number): Promise<IDataObject[]>;
+export declare function resolveScopedCustomField(context: ILoadOptionsFunctions, technicalName: string): Promise<QweaseFormField | undefined>;
+export declare function resolveCustomFieldOptions(context: ILoadOptionsFunctions, technicalName: string): Promise<IDataObject[]>;
+export declare function fetchFormStatusItems(context: QweaseContext, formId: number): Promise<IDataObject[]>;

package/dist/nodes/Qwease/FormFieldsHelper.js

@@ -0,0 +1,187 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractLocatorValue = extractLocatorValue;
+exports.parseOptionalId = parseOptionalId;
+exports.extractStatutModelId = extractStatutModelId;
+exports.extractFormIdFromTicket = extractFormIdFromTicket;
+exports.resolveFormIdForLists = resolveFormIdForLists;
+exports.fetchFormFields = fetchFormFields;
+exports.fetchEntityFields = fetchEntityFields;
+exports.fetchFieldListOptions = fetchFieldListOptions;
+exports.resolveScopedCustomField = resolveScopedCustomField;
+exports.resolveCustomFieldOptions = resolveCustomFieldOptions;
+exports.fetchFormStatusItems = fetchFormStatusItems;
+const GenericFunctions_1 = require("./GenericFunctions");
+function extractLocatorValue(value) {
+    if (value === undefined || value === null || value === '') {
+        return '';
+    }
+    if (typeof value === 'object' && value !== null && 'value' in value) {
+        return extractLocatorValue(value.value);
+    }
+    return String(value);
+}
+function parseOptionalId(value) {
+    const raw = extractLocatorValue(value);
+    if (!raw) {
+        return undefined;
+    }
+    const n = parseInt(raw, 10);
+    return Number.isNaN(n) ? undefined : n;
+}
+function extractStatutModelId(formDetails) {
+    const statutModel = formDetails.statut_model;
+    if (typeof statutModel === 'number') {
+        return statutModel;
+    }
+    if (statutModel && typeof statutModel === 'object') {
+        return parseOptionalId(statutModel.id);
+    }
+    return undefined;
+}
+function extractFormIdFromTicket(ticket) {
+    const form = ticket.form;
+    if (typeof form === 'number') {
+        return form;
+    }
+    if (form && typeof form === 'object') {
+        return parseOptionalId(form.id);
+    }
+    return undefined;
+}
+async function resolveFormIdForLists(context) {
+    const operation = context.getCurrentNodeParameter('operation');
+    if (operation === 'create') {
+        return parseOptionalId(context.getCurrentNodeParameter('form'));
+    }
+    if (operation === 'update') {
+        const ticketId = extractLocatorValue(context.getCurrentNodeParameter('ticketId'));
+        if (!ticketId) {
+            return undefined;
+        }
+        const ticket = (await GenericFunctions_1.qweaseApiRequest.call(context, 'GET', `/ticket/${ticketId}/`));
+        return extractFormIdFromTicket(ticket);
+    }
+    return undefined;
+}
+async function fetchFormFields(context, formId) {
+    var _a;
+    const response = await GenericFunctions_1.qweaseApiRequest.call(context, 'GET', '/forms-category/', {}, { form: formId, depth: 2 });
+    const categories = (0, GenericFunctions_1.qweaseListFromResponse)(response);
+    const fields = [];
+    const seen = new Set();
+    for (const category of categories) {
+        const categoryFields = category.fields;
+        if (!Array.isArray(categoryFields)) {
+            continue;
+        }
+        for (const field of categoryFields) {
+            if (!field || typeof field !== 'object') {
+                continue;
+            }
+            const entry = field;
+            const technicalName = String(entry.technical_name || '');
+            if (!technicalName || seen.has(technicalName)) {
+                continue;
+            }
+            seen.add(technicalName);
+            fields.push({
+                id: (_a = parseOptionalId(entry.id)) !== null && _a !== void 0 ? _a : 0,
+                name: String(entry.name || entry.display_name || technicalName),
+                technical_name: technicalName,
+                fields_type: String(entry.fields_type || 'string'),
+                optionslist: Array.isArray(entry.optionslist) ? entry.optionslist : undefined,
+            });
+        }
+    }
+    return fields;
+}
+/** Entity-scoped custom fields: type=user | client | device */
+async function fetchEntityFields(context, fieldType) {
+    var _a;
+    const response = await GenericFunctions_1.qweaseApiRequest.call(context, 'GET', '/fields/', {}, { type: fieldType, is_active: true, depth: 1 });
+    const list = (0, GenericFunctions_1.qweaseListFromResponse)(response);
+    const fields = [];
+    const seen = new Set();
+    for (const entry of list) {
+        if (!entry || typeof entry !== 'object') {
+            continue;
+        }
+        const technicalName = String(entry.technical_name || '');
+        if (!technicalName || seen.has(technicalName)) {
+            continue;
+        }
+        seen.add(technicalName);
+        fields.push({
+            id: (_a = parseOptionalId(entry.id)) !== null && _a !== void 0 ? _a : 0,
+            name: String(entry.name || entry.display_name || technicalName),
+            technical_name: technicalName,
+            fields_type: String(entry.fields_type || 'string'),
+            optionslist: Array.isArray(entry.optionslist) ? entry.optionslist : undefined,
+        });
+    }
+    return fields;
+}
+async function fetchFieldListOptions(context, fieldId) {
+    const response = await GenericFunctions_1.qweaseApiRequest.call(context, 'GET', `/fields/${fieldId}/listoptions/`);
+    return (0, GenericFunctions_1.qweaseListFromResponse)(response);
+}
+function optionsFromField(field) {
+    if (Array.isArray(field.optionslist) && field.optionslist.length > 0) {
+        return field.optionslist;
+    }
+    return [];
+}
+async function resolveScopedCustomField(context, technicalName) {
+    if (!technicalName) {
+        return undefined;
+    }
+    const resource = context.getCurrentNodeParameter('resource');
+    let fields = [];
+    if (resource === 'ticket') {
+        const formId = await resolveFormIdForLists(context);
+        if (!formId) {
+            return undefined;
+        }
+        fields = await fetchFormFields(context, formId);
+    }
+    else if (resource === 'user') {
+        fields = await fetchEntityFields(context, 'user');
+    }
+    else if (resource === 'organization') {
+        fields = await fetchEntityFields(context, 'client');
+    }
+    else if (resource === 'device') {
+        fields = await fetchEntityFields(context, 'device');
+    }
+    else {
+        return undefined;
+    }
+    return fields.find((field) => field.technical_name === technicalName);
+}
+async function resolveCustomFieldOptions(context, technicalName) {
+    const field = await resolveScopedCustomField(context, technicalName);
+    if (!field) {
+        return [];
+    }
+    const embedded = optionsFromField(field);
+    if (embedded.length > 0) {
+        return embedded;
+    }
+    if (!field.id) {
+        return [];
+    }
+    return fetchFieldListOptions(context, field.id);
+}
+async function fetchFormStatusItems(context, formId) {
+    const formDetails = (await GenericFunctions_1.qweaseApiRequest.call(context, 'GET', `/forms/${formId}/details/`));
+    const statutModelId = extractStatutModelId(formDetails);
+    if (!statutModelId) {
+        return [];
+    }
+    const response = await GenericFunctions_1.qweaseApiRequest.call(context, 'GET', '/statusitem/', {}, {
+        related_status: statutModelId,
+        position__in: '1,2,3,4',
+    });
+    return (0, GenericFunctions_1.qweaseListFromResponse)(response);
+}

package/dist/nodes/Qwease/GenericFunctions.d.ts

@@ -0,0 +1,4 @@
+import type { IExecuteFunctions, IHttpRequestMethods, IDataObject, ILoadOptionsFunctions } from 'n8n-workflow';
+export type QweaseContext = IExecuteFunctions | ILoadOptionsFunctions;
+export declare function qweaseListFromResponse(response: IDataObject | IDataObject[]): IDataObject[];
+export declare function qweaseApiRequest(this: QweaseContext, method: IHttpRequestMethods, endpoint: string, body?: IDataObject, qs?: IDataObject): Promise<IDataObject>;

package/dist/nodes/Qwease/GenericFunctions.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.qweaseListFromResponse = qweaseListFromResponse;
+exports.qweaseApiRequest = qweaseApiRequest;
+const BASE_URL = 'https://rest.qwease.fr/api';
+function qweaseListFromResponse(response) {
+    var _a;
+    if (Array.isArray(response)) {
+        return response;
+    }
+    const results = (_a = response.results) !== null && _a !== void 0 ? _a : response.data;
+    if (Array.isArray(results)) {
+        return results;
+    }
+    return [];
+}
+async function qweaseApiRequest(method, endpoint, body = {}, qs = {}) {
+    const options = {
+        method,
+        url: `${BASE_URL}${endpoint}`,
+        json: true,
+    };
+    if (Object.keys(body).length) {
+        options.body = body;
+    }
+    if (Object.keys(qs).length) {
+        options.qs = qs;
+    }
+    return await this.helpers.httpRequestWithAuthentication.call(this, 'qweaseApi', options);
+}

package/dist/nodes/Qwease/KnowledgeTaskDescription.d.ts

@@ -0,0 +1,5 @@
+import type { INodeProperties } from 'n8n-workflow';
+export declare const knowledgeOperations: INodeProperties[];
+export declare const knowledgeFields: INodeProperties[];
+export declare const taskOperations: INodeProperties[];
+export declare const taskFields: INodeProperties[];