@learningsuite/n8n-nodes-learningsuite 1.2.2

package/dist/nodes/LearningSuite/LearningSuiteTrigger.node.js

@@ -0,0 +1,433 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LearningSuiteTrigger = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const request_1 = require("./shared/request");
+const trigger_instant_properties_1 = require("./descriptions/trigger.instant.properties");
+const parsing_1 = require("./shared/parsing");
+// methods - loadOptions
+const loBundle = __importStar(require("./methods/loadOptions/bundle.loadOptions"));
+const loCommunity = __importStar(require("./methods/loadOptions/community.loadOptions"));
+const loCourse = __importStar(require("./methods/loadOptions/course.loadOptions"));
+const loGroup = __importStar(require("./methods/loadOptions/group.loadOptions"));
+const loHub = __importStar(require("./methods/loadOptions/hub.loadOptions"));
+const loMember = __importStar(require("./methods/loadOptions/member.loadOptions"));
+const loModule = __importStar(require("./methods/loadOptions/module.loadOptions"));
+const loPopup = __importStar(require("./methods/loadOptions/popup.loadOptions"));
+const loRole = __importStar(require("./methods/loadOptions/role.loadOptions"));
+const loWebhook = __importStar(require("./methods/loadOptions/webhook.loadOptions"));
+const loTeamMember = __importStar(require("./methods/loadOptions/teamMember.loadOptions"));
+const loCustomFields = __importStar(require("./methods/loadOptions/customFields.loadOptions"));
+const INSTANT_EVENTS = new Set([
+    'accessRequest.created',
+    'communityPost.created',
+    'communityPost.commented',
+    'communityPost.moderated',
+    'courseProgress.changed',
+    'customPopup.interaction',
+    'exam.completed',
+    'exam.graded',
+    'feedback.created',
+    'group.userAccessChanged',
+    'lesson.completed',
+    'login.new',
+    'submission.created',
+    'course.updated',
+    'course.memberAdded',
+    'customField.valueChanged',
+    'user.activationStatusChanged',
+]);
+function buildDesiredFilter(event) {
+    var _a;
+    const filter = {};
+    const getCol = (path) => {
+        try {
+            const v = this.getNodeParameter(path);
+            return v && typeof v === 'object' ? v : {};
+        }
+        catch {
+            return {};
+        }
+    };
+    const getStr = (path) => {
+        try {
+            const v = this.getNodeParameter(path);
+            return (v !== null && v !== void 0 ? v : '').toString().trim();
+        }
+        catch {
+            return '';
+        }
+    };
+    const getNum = (path, fallback = 0) => {
+        try {
+            const v = this.getNodeParameter(path);
+            return Number.isFinite(v) ? v : fallback;
+        }
+        catch {
+            return fallback;
+        }
+    };
+    switch (event) {
+        // ---------------- Community
+        case 'communityPost.commented': {
+            const col = getCol('additionalCommunityPostCommented');
+            if (col === null || col === void 0 ? void 0 : col.areaId)
+                filter.areaId = String(col.areaId);
+            if (col === null || col === void 0 ? void 0 : col.forumId)
+                filter.forumId = String(col.forumId);
+            const ids = (0, parsing_1.toIdArray)((_a = col === null || col === void 0 ? void 0 : col.mentionedUserIds) !== null && _a !== void 0 ? _a : []);
+            if (ids.length)
+                filter.mentionedUserIds = ids;
+            break;
+        }
+        case 'communityPost.created': {
+            const col = getCol('additionalCommunityPostCreated');
+            if (col === null || col === void 0 ? void 0 : col.areaId)
+                filter.areaId = String(col.areaId);
+            if (col === null || col === void 0 ? void 0 : col.forumId)
+                filter.forumId = String(col.forumId);
+            if ((col === null || col === void 0 ? void 0 : col.publishStatus) && col.publishStatus !== 'both') {
+                filter.published = col.publishStatus === 'published'; // boolean
+            }
+            break;
+        }
+        case 'communityPost.moderated': {
+            const col = getCol('additionalCommunityPostModerated');
+            if (col === null || col === void 0 ? void 0 : col.areaId)
+                filter.areaId = String(col.areaId);
+            if (col === null || col === void 0 ? void 0 : col.forumId)
+                filter.forumId = String(col.forumId);
+            if ((col === null || col === void 0 ? void 0 : col.approved) && col.approved !== 'both') {
+                filter.approved = col.approved === 'approved'; // boolean
+            }
+            break;
+        }
+        // ---------------- Custom Field
+        case 'customField.valueChanged': {
+            const col = getCol('additionalCustomFieldValueChanged');
+            if (col === null || col === void 0 ? void 0 : col.customFieldCardId) {
+                filter.customFieldCardId = String(col.customFieldCardId);
+            }
+            break;
+        }
+        // ---------------- Login
+        case 'login.new': {
+            const col = getCol('additionalLoginNew');
+            if (col === null || col === void 0 ? void 0 : col.loginType) {
+                filter.loginType = String(col.loginType);
+            }
+            if (col === null || col === void 0 ? void 0 : col.userRoleId) {
+                filter.userRoleId = String(col.userRoleId);
+            }
+            break;
+        }
+        // ---------------- Custom Popup
+        case 'customPopup.interaction': {
+            const col = getCol('additionalPopupInteraction');
+            if (col === null || col === void 0 ? void 0 : col.customPopupId) {
+                filter.customPopupId = String(col.customPopupId);
+            }
+            if (col === null || col === void 0 ? void 0 : col.interactionType) {
+                filter.interactionType = String(col.interactionType);
+            }
+            break;
+        }
+        // ---------------- Progress
+        case 'courseProgress.changed': {
+            // API: threshold + optional courseInstanceId
+            const aboveRaw = getNum('threshold', 0);
+            filter.above = Math.max(0, Math.floor(aboveRaw));
+            const col = getCol('additionalCourseProgress');
+            if (col.courseId)
+                filter.courseInstanceId = String(col.courseId);
+            break;
+        }
+        // ---------------- Exams
+        case 'exam.completed':
+        case 'exam.graded': {
+            const col = getCol('additionalExamOptions');
+            if (col === null || col === void 0 ? void 0 : col.courseId) {
+                filter.courseInstanceId = String(col.courseId);
+            }
+            if (col === null || col === void 0 ? void 0 : col.examModuleId) {
+                filter.examModuleId = String(col.examModuleId);
+            }
+            break;
+        }
+        // course.updated
+        case 'course.memberAdded':
+        case 'course.updated': {
+            const col = getCol('additionalCourseOptions');
+            if (col === null || col === void 0 ? void 0 : col.courseId) {
+                filter.courseInstanceId = String(col.courseId);
+            }
+            break;
+        }
+        // feedback.created
+        case 'feedback.created': {
+            const col = getCol('additionalFeedbackOptions');
+            if (col === null || col === void 0 ? void 0 : col.courseId) {
+                filter.courseInstanceId = String(col.courseId);
+            }
+            break;
+        }
+        // ---------------- Access Request (required in UI)
+        case 'accessRequest.created': {
+            const courseId = getStr('courseId');
+            if (courseId)
+                filter.courseInstanceId = courseId;
+            break;
+        }
+        // ---------------- Group Access
+        case 'group.userAccessChanged': {
+            const col = getCol('additionalGroupAccess');
+            const actionType = getStr('actionType');
+            if (actionType)
+                filter.actionType = actionType; // 'added' | 'removed'
+            if (col.groupId)
+                filter.groupId = String(col.groupId);
+            break;
+        }
+        // ---------------- Lesson Completed (kaskadiert)
+        case 'lesson.completed': {
+            const col = getCol('additionalLessonCompleted');
+            if (col.courseId)
+                filter.courseInstanceId = String(col.courseId);
+            if (col.moduleId)
+                filter.moduleId = String(col.moduleId);
+            if (col.lessonId)
+                filter.lessonId = String(col.lessonId);
+            break;
+        }
+        // ---------------- Submission (optional course)
+        case 'submission.created': {
+            const col = getCol('additionalSubmission');
+            if (col.courseId)
+                filter.courseInstanceId = String(col.courseId);
+            break;
+        }
+        // ---------------- User Activation Status Changed
+        case 'user.activationStatusChanged': {
+            const col = getCol('additionalUserActivationStatus');
+            if (col === null || col === void 0 ? void 0 : col.action)
+                filter.action = String(col.action);
+            if (col === null || col === void 0 ? void 0 : col.roleId)
+                filter.roleId = String(col.roleId);
+            break;
+        }
+        default:
+            break;
+    }
+    return { filter, hasFilter: true };
+}
+function isApiErrorLike(error) {
+    return typeof error === 'object' && error !== null;
+}
+class LearningSuiteTrigger {
+    constructor() {
+        this.description = {
+            displayName: 'LearningSuite Trigger',
+            name: 'learningSuiteTrigger',
+            icon: {
+                light: 'file:./icons/learningsuite-icon-light.svg',
+                dark: 'file:./icons/learningsuite-icon-dark.svg',
+            },
+            group: ['trigger'],
+            version: 1,
+            description: 'Interact with LearningSuite API (powered by agentur-systeme.de)',
+            subtitle: '={{$parameter["event"]}}',
+            defaults: {
+                name: 'LearningSuite Trigger',
+                // @ts-expect-error -- description is required by n8n node linting for defaults
+                description: 'Interact with LearningSuite API (powered by agentur-systeme.de)',
+            },
+            inputs: [],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            usableAsTool: true,
+            credentials: [
+                {
+                    name: 'learningSuiteApi',
+                    required: true,
+                    // @ts-expect-error -- credential description is accepted by n8n but missing from typings here
+                    description: 'Uses LearningSuite API Key via header X-API-KEY',
+                },
+            ],
+            webhooks: [{ name: 'default', httpMethod: 'POST', responseMode: 'onReceived', isFullPath: true, path: '' }],
+            properties: trigger_instant_properties_1.instantProperties,
+        };
+        this.methods = {
+            loadOptions: {
+                ...loBundle,
+                ...loCommunity,
+                ...loCourse,
+                ...loGroup,
+                ...loHub,
+                ...loMember,
+                ...loModule,
+                ...loPopup,
+                ...loRole,
+                ...loTeamMember,
+                ...loWebhook,
+                ...loCustomFields,
+            },
+        };
+        this.webhookMethods = {
+            default: {
+                async checkExists() {
+                    var _a, _b;
+                    const event = this.getNodeParameter('event');
+                    if (!INSTANT_EVENTS.has(event))
+                        return true;
+                    const webhookData = this.getWorkflowStaticData('node');
+                    const storedId = webhookData.subscriptionId;
+                    if (!storedId)
+                        return false;
+                    const desiredHookUrl = this.getNodeWebhookUrl('default');
+                    const { filter: desiredFilterRaw } = buildDesiredFilter.call(this, event);
+                    const desiredFilter = desiredFilterRaw && typeof desiredFilterRaw === 'object' ? desiredFilterRaw : {};
+                    try {
+                        const remote = (await request_1.apiRequest.call(this, {
+                            method: 'GET',
+                            path: `/webhooks/subscription/${encodeURIComponent(storedId)}`,
+                        }));
+                        const remoteType = remote.type;
+                        const remoteUrl = remote.url;
+                        const remoteFilter = (_a = remote.filter) !== null && _a !== void 0 ? _a : {};
+                        const typeDiffers = remoteType !== event;
+                        const urlDiffers = remoteUrl !== desiredHookUrl;
+                        let filterDiffers = false;
+                        const keys = new Set([...Object.keys(remoteFilter || {}), ...Object.keys(desiredFilter || {})]);
+                        for (const k of keys) {
+                            const a = remoteFilter[k];
+                            const b = desiredFilter[k];
+                            if (a !== b) {
+                                filterDiffers = true;
+                                break;
+                            }
+                        }
+                        if (typeDiffers || urlDiffers || filterDiffers) {
+                            const body = {
+                                hookUrl: desiredHookUrl,
+                                type: event,
+                                filter: desiredFilter,
+                            };
+                            await request_1.apiRequest.call(this, {
+                                method: 'PUT',
+                                path: `/webhooks/subscription/${encodeURIComponent(storedId)}`,
+                                body,
+                            });
+                        }
+                        return true;
+                    }
+                    catch (error) {
+                        if (isApiErrorLike(error) && (error.statusCode === 404 || ((_b = error.response) === null || _b === void 0 ? void 0 : _b.statusCode) === 404)) {
+                            delete webhookData.subscriptionId;
+                            return false;
+                        }
+                        throw new n8n_workflow_1.NodeApiError(this.getNode(), error, {
+                            message: 'Failed to verify/update existing webhook subscription',
+                        });
+                    }
+                },
+                async create() {
+                    const event = this.getNodeParameter('event');
+                    if (!INSTANT_EVENTS.has(event))
+                        return true;
+                    const webhookUrl = this.getNodeWebhookUrl('default');
+                    const { filter: rawFilter } = buildDesiredFilter.call(this, event);
+                    const filter = rawFilter && typeof rawFilter === 'object' ? rawFilter : {};
+                    const body = {
+                        hookUrl: webhookUrl,
+                        type: event,
+                        filter,
+                    };
+                    try {
+                        const response = (await request_1.apiRequest.call(this, {
+                            method: 'POST',
+                            path: '/webhooks/subscription',
+                            body,
+                        }));
+                        const webhookData = this.getWorkflowStaticData('node');
+                        webhookData.subscriptionId = response.id;
+                        return true;
+                    }
+                    catch (error) {
+                        throw new n8n_workflow_1.NodeApiError(this.getNode(), error, {
+                            message: 'Failed to create webhook subscription',
+                        });
+                    }
+                },
+                async delete() {
+                    var _a;
+                    const event = this.getNodeParameter('event');
+                    if (!INSTANT_EVENTS.has(event))
+                        return true;
+                    const webhookData = this.getWorkflowStaticData('node');
+                    const id = webhookData.subscriptionId;
+                    if (!id)
+                        return true;
+                    try {
+                        await request_1.apiRequest.call(this, {
+                            method: 'DELETE',
+                            path: `/webhooks/subscription/${encodeURIComponent(id)}`,
+                        });
+                    }
+                    catch (error) {
+                        if (!isApiErrorLike(error) || (error.statusCode !== 404 && ((_a = error.response) === null || _a === void 0 ? void 0 : _a.statusCode) !== 404)) {
+                            delete webhookData.subscriptionId;
+                            throw new n8n_workflow_1.NodeApiError(this.getNode(), error, {
+                                message: 'Failed to delete webhook subscription',
+                            });
+                        }
+                    }
+                    delete webhookData.subscriptionId;
+                    return true;
+                },
+            },
+        };
+    }
+    async webhook() {
+        const body = this.getBodyData();
+        if (Array.isArray(body)) {
+            return { workflowData: [this.helpers.returnJsonArray(body)] };
+        }
+        if (body && typeof body === 'object') {
+            return { workflowData: [this.helpers.returnJsonArray([body])] };
+        }
+        return { workflowData: [this.helpers.returnJsonArray([{ error: 'No JSON body' }])] };
+    }
+}
+exports.LearningSuiteTrigger = LearningSuiteTrigger;

package/dist/nodes/LearningSuite/descriptions/ai.properties.d.ts

@@ -0,0 +1,2 @@
+import type { INodeProperties } from 'n8n-workflow';
+export declare const aiProperties: INodeProperties[];

package/dist/nodes/LearningSuite/descriptions/ai.properties.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.aiProperties = void 0;
+exports.aiProperties = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        default: 'ragChat',
+        displayOptions: { show: { resource: ['ai'] } },
+        options: [
+            {
+                name: 'RAG Chat',
+                value: 'ragChat',
+                description: 'Ask a question using the AI RAG chat endpoint',
+                action: 'Ask AI question',
+            },
+        ],
+    },
+    {
+        displayName: 'Question',
+        name: 'question',
+        type: 'string',
+        required: true,
+        default: '',
+        description: 'The question to ask the AI',
+        displayOptions: { show: { resource: ['ai'], operation: ['ragChat'] } },
+    },
+    {
+        displayName: 'User Name or ID',
+        name: 'userId',
+        type: 'options',
+        typeOptions: { loadOptionsMethod: 'member_getMembers' },
+        default: '',
+        description: 'The ID of the user making the request. Used to personalize and scope the AI response. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+        displayOptions: { show: { resource: ['ai'], operation: ['ragChat'] } },
+    },
+    {
+        displayName: 'Conversation ID',
+        name: 'conversationId',
+        type: 'string',
+        default: '',
+        description: 'If set, the conversation history with this ID will be taken into account',
+        displayOptions: { show: { resource: ['ai'], operation: ['ragChat'] } },
+    },
+    {
+        displayName: 'Answer Length',
+        name: 'answerLength',
+        type: 'options',
+        default: 'standard',
+        description: 'The desired length of the AI’s answer',
+        displayOptions: { show: { resource: ['ai'], operation: ['ragChat'] } },
+        options: [
+            {
+                name: 'Concise',
+                value: 'concise',
+                description: 'A short and to-the-point answer',
+            },
+            {
+                name: 'Standard',
+                value: 'standard',
+                description: 'A balanced answer with sufficient detail',
+            },
+            {
+                name: 'Detailed',
+                value: 'detailed',
+                description: 'A comprehensive and detailed answer',
+            },
+        ],
+    },
+    {
+        displayName: 'Tone',
+        name: 'tone',
+        type: 'options',
+        default: 'neutral',
+        description: 'The desired tone of the AI’s answer',
+        displayOptions: { show: { resource: ['ai'], operation: ['ragChat'] } },
+        options: [
+            {
+                name: 'Friendly',
+                value: 'friendly',
+                description: 'A warm and approachable tone',
+            },
+            {
+                name: 'Neutral',
+                value: 'neutral',
+                description: 'A neutral and factual tone',
+            },
+            {
+                name: 'Professional',
+                value: 'professional',
+                description: 'A formal and professional tone',
+            },
+        ],
+    },
+    {
+        displayName: 'Format',
+        name: 'format',
+        type: 'options',
+        default: 'markdown',
+        description: 'The desired output format of the AI’s answer',
+        displayOptions: { show: { resource: ['ai'], operation: ['ragChat'] } },
+        options: [
+            {
+                name: 'Markdown',
+                value: 'markdown',
+                description: 'Formatted output using Markdown',
+            },
+            {
+                name: 'Plain Text',
+                value: 'plaintext',
+                description: 'Unformatted plain text output',
+            },
+        ],
+    },
+    {
+        displayName: 'Add Citations',
+        name: 'addCitations',
+        type: 'boolean',
+        default: false,
+        description: 'Whether the AI will add citations to its answer',
+        displayOptions: { show: { resource: ['ai'], operation: ['ragChat'] } },
+    },
+    {
+        displayName: 'Unlock Content Drip',
+        name: 'unlockContentDrip',
+        type: 'boolean',
+        default: false,
+        description: 'Whether the AI will have access to content that is normally restricted by content drip settings',
+        displayOptions: { show: { resource: ['ai'], operation: ['ragChat'] } },
+    },
+    {
+        displayName: 'System Prompt Addition',
+        name: 'systemPromptAddition',
+        type: 'string',
+        default: '',
+        description: 'Additional system prompt instructions to guide the AI’s behavior',
+        displayOptions: { show: { resource: ['ai'], operation: ['ragChat'] } },
+    },
+];

package/dist/nodes/LearningSuite/descriptions/apiCall.properties.d.ts

@@ -0,0 +1,2 @@
+import type { INodeProperties } from 'n8n-workflow';
+export declare const apiCallProperties: INodeProperties[];

package/dist/nodes/LearningSuite/descriptions/apiCall.properties.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiCallProperties = void 0;
+exports.apiCallProperties = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        default: 'makeRequest',
+        displayOptions: { show: { resource: ['apiCall'] } },
+        options: [
+            {
+                name: 'Make Request',
+                value: 'makeRequest',
+                description: 'Make an arbitrary API call',
+                action: 'Custom api call',
+            },
+        ],
+    },
+    {
+        displayName: 'HTTP Method',
+        name: 'httpMethod',
+        type: 'options',
+        displayOptions: { show: { resource: ['apiCall'], operation: ['makeRequest'] } },
+        options: [
+            { name: 'DELETE', value: 'DELETE' },
+            { name: 'GET', value: 'GET' },
+            { name: 'PATCH', value: 'PATCH' },
+            { name: 'POST', value: 'POST' },
+            { name: 'PUT', value: 'PUT' },
+        ],
+        default: 'GET',
+        required: true,
+        description: 'HTTP method for the API call',
+    },
+    {
+        displayName: 'Endpoint',
+        name: 'endpoint',
+        type: 'string',
+        displayOptions: { show: { resource: ['apiCall'], operation: ['makeRequest'] } },
+        default: '',
+        required: true,
+        placeholder: '/members/123/courses',
+        description: 'API endpoint path (without base URL)',
+    },
+    {
+        displayName: 'Request Body',
+        name: 'requestBody',
+        type: 'json',
+        displayOptions: {
+            show: { resource: ['apiCall'], operation: ['makeRequest'], httpMethod: ['POST', 'PUT', 'PATCH'] },
+        },
+        default: '{}',
+        description: 'Request body as JSON',
+    },
+    {
+        displayName: 'Query Parameters',
+        name: 'queryParameters',
+        type: 'fixedCollection',
+        typeOptions: { multipleValues: true },
+        displayOptions: { show: { resource: ['apiCall'], operation: ['makeRequest'] } },
+        default: {},
+        options: [
+            {
+                name: 'parameter',
+                displayName: 'Parameter',
+                values: [
+                    {
+                        displayName: 'Name',
+                        name: 'name',
+                        type: 'string',
+                        default: '',
+                        description: 'Name of the query parameter',
+                    },
+                    {
+                        displayName: 'Value',
+                        name: 'value',
+                        type: 'string',
+                        default: '',
+                        description: 'Value of the query parameter',
+                    },
+                ],
+            },
+        ],
+    },
+];

package/dist/nodes/LearningSuite/descriptions/bundle.properties.d.ts

@@ -0,0 +1,2 @@
+import type { INodeProperties } from 'n8n-workflow';
+export declare const bundleProperties: INodeProperties[];