@5minds/node-red-contrib-processcube 2.0.0-feature-629c78-m2dq1ygt → 7.6.0-develop-51b534-mjy3s4sm

package/processcube-engine-config.html

@@ -4,11 +4,13 @@
         defaults: {
             name: { value: '' },
             url: { value: 'http://engine:8000', required: true },
-            urlType: { type: 'str'},
+            urlType: { type: 'str' },
             clientId: { value: '' },
             clientIdType: { type: 'str' },
             clientSecret: { value: '' },
             clientSecretType: { type: 'str' },
+            scope: { value: 'engine_etw engine_read engine_write engine_observer' },
+            scopeType: { type: 'str' },
         },
         label: function () {
             return this.name || this.url;
@@ -16,17 +18,22 @@
         oneditprepare: function () {
             $('#node-config-input-url').typedInput({
                 default: 'str',
-                types: ['str', 'global', 'flow', 'env', 'msg', 'cred'],
+                types: ['str', 'env', 'cred'],
             });
 
             $('#node-config-input-clientId').typedInput({
                 default: 'str',
-                types: ['str', 'global', 'flow', 'env', 'msg', 'cred'],
+                types: ['str', 'env', 'cred'],
             });
 
             $('#node-config-input-clientSecret').typedInput({
                 default: 'str',
-                types: ['str', 'global', 'flow', 'env', 'msg', 'cred'],
+                types: ['str', 'env', 'cred'],
+            });
+
+            $('#node-config-input-scope').typedInput({
+                default: 'str',
+                types: ['str', 'env', 'cred'],
             });
 
             $('#node-config-input-url').typedInput('value', this.url);
@@ -37,6 +44,9 @@
 
             $('#node-config-input-clientSecret').typedInput('value', this.clientSecret);
             $('#node-config-input-clientSecret').typedInput('type', this.clientSecretType);
+
+            $('#node-config-input-scope').typedInput('value', this.scope);
+            $('#node-config-input-scope').typedInput('type', this.scopeType);
         },
         oneditsave: function () {
             this.url = $('#node-config-input-url').typedInput('value');
@@ -47,6 +57,9 @@
 
             this.clientSecret = $('#node-config-input-clientSecret').typedInput('value');
             this.clientSecretType = $('#node-config-input-clientSecret').typedInput('type');
+
+            this.scope = $('#node-config-input-scope').typedInput('value');
+            this.scopeType = $('#node-config-input-scope').typedInput('type');
         },
     });
 </script>
@@ -66,7 +79,11 @@
     </div>
     <div class="form-row">
         <label for="node-config-input-clientSecret"><i class="fa fa-bookmark"></i> Client secret</label>
-        <input type="password" id="node-config-input-clientSecret" />
+        <input type="text" id="node-config-input-clientSecret" />
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-scope"><i class="fa fa-bookmark"></i> Scope</label>
+        <input type="text" id="node-config-input-scope" />
     </div>
 </script>
 
@@ -78,9 +95,10 @@ The configuration for the ProcessCube engine.
 : url (String) : The URL of the ProcessCube engine.
 : clientId (String) : The client id for the ProcessCube engine.
 : clientSecret (String) : The client secret for the ProcessCube engine.
+: scope (String|Secret|ENV) : The scope for the ProcessCube engine.
 
 ### References
 
--  [The ProcessCube&copy; Developer Network](https://processcube.io) - All documentation for the ProcessCube&copy; platform
--  [ProcessCube&copy; LowCode Integration](https://processcube.io/docs/node-red) - LowCode integration in ProcessCube&copy;
+-   [The ProcessCube&copy; Developer Network](https://processcube.io) - All documentation for the ProcessCube&copy; platform
+-   [ProcessCube&copy; LowCode Integration](https://processcube.io/docs/node-red) - LowCode integration in ProcessCube&copy;
 </script>

package/processcube-engine-config.js

@@ -1,72 +1,44 @@
 const engine_client = require('@5minds/processcube_engine_client');
-const jwt = require('jwt-decode');
-const oidc = require('openid-client');
-
-const DELAY_FACTOR = 0.85;
 
 module.exports = function (RED) {
     function ProcessCubeEngineNode(n) {
         RED.nodes.createNode(this, n);
         const node = this;
-        const identityChangedCallbacks = [];
-        this.url = RED.util.evaluateNodeProperty(n.url, n.urlType, node);
-        this.identity = null;
 
-        this.credentials.clientId = RED.util.evaluateNodeProperty(n.clientId, n.clientIdType, node);
-        this.credentials.clientSecret = RED.util.evaluateNodeProperty(n.clientSecret, n.clientSecretType, node);
+        node.url = RED.util.evaluateNodeProperty(n.url, n.urlType, node);
+        node.credentials.clientId = RED.util.evaluateNodeProperty(n.clientId, n.clientIdType, node);
+        node.credentials.clientSecret = RED.util.evaluateNodeProperty(n.clientSecret, n.clientSecretType, node);
+        node.credentials.scope = RED.util.evaluateNodeProperty(n.scope, n.scopeType, node);
 
-        this.registerOnIdentityChanged = function (callback) {
-            identityChangedCallbacks.push(callback);
-        };
+        if (!node.credentials.scope) {
+            node.credentials.scope = 'engine_etw engine_read engine_write engine_observer';
+        }
 
-        this.isIdentityReady = function () {
-            if (this.credentials.clientId && this.credentials.clientSecret) {
-                return this.identity != null;
+        try {
+            if (node.credentials.clientId && node.credentials.clientSecret) {
+                node.log('Create Client with secrets');
+                node.engineClient = new engine_client.EngineClient(node.url, {
+                    clientId: node.credentials.clientId,
+                    clientSecret: node.credentials.clientSecret,
+                    scope: node.credentials.scope,
+                });
             } else {
-                return true;
-            }
-        };
-
-        this.setIdentity = (identity) => {
-            node.log(`setIdentity: ${JSON.stringify(identity)}`);
-            this.identity = identity;
-
-            for (const callback of identityChangedCallbacks) {
-                callback(identity);
+                node.log('Create Client without secrets');
+                node.engineClient = new engine_client.EngineClient(node.url);
             }
-        };
+        } catch (error) {
+            node.error(error, {});
+        }
 
         node.on('close', async () => {
-            if (this.engineClient) {
-                this.engineClient.dispose();
-                this.engineClient = null;
+            node.log('close');
+            if (node.engineClient) {
+                node.engineClient.dispose();
+                node.engineClient = null;
             }
         });
-
-        if (this.credentials.clientId && this.credentials.clientSecret) {
-            this.engineClient = new engine_client.EngineClient(this.url);
-
-            this.engineClient.applicationInfo
-                .getAuthorityAddress()
-                .then((authorityUrl) => {
-                    startRefreshingIdentityCycle(
-                        this.credentials.clientId,
-                        this.credentials.clientSecret,
-                        authorityUrl,
-                        node
-                    ).catch((reason) => {
-                        console.error(reason);
-                        node.error(reason);
-                    });
-                })
-                .catch((reason) => {
-                    console.error(reason);
-                    node.error(reason);
-                });
-        } else {
-            this.engineClient = new engine_client.EngineClient(this.url);
-        }
     }
+
     RED.nodes.registerType('processcube-engine-config', ProcessCubeEngineNode, {
         credentials: {
             clientId: { type: 'text' },
@@ -74,85 +46,3 @@ module.exports = function (RED) {
         },
     });
 };
-
-async function getFreshTokenSet(clientId, clientSecret, authorityUrl) {
-    const issuer = await oidc.Issuer.discover(authorityUrl);
-
-    const client = new issuer.Client({
-        client_id: clientId,
-        client_secret: clientSecret,
-    });
-
-    const tokenSet = await client.grant({
-        grant_type: 'client_credentials',
-        scope: 'engine_etw engine_read engine_write',
-    });
-
-    return tokenSet;
-}
-
-function getIdentityForExternalTaskWorkers(tokenSet) {
-    const accessToken = tokenSet.access_token;
-    const decodedToken = jwt.jwtDecode(accessToken);
-
-    return {
-        token: tokenSet.access_token,
-        userId: decodedToken.sub,
-    };
-}
-
-async function getExpiresInForExternalTaskWorkers(tokenSet) {
-    let expiresIn = tokenSet.expires_in;
-
-    if (!expiresIn && tokenSet.expires_at) {
-        expiresIn = Math.floor(tokenSet.expires_at - Date.now() / 1000);
-    }
-
-    if (expiresIn === undefined) {
-        throw new Error('Could not determine the time until the access token for external task workers expires');
-    }
-
-    return expiresIn;
-}
-
-/**
- * Start refreshing the identity in regular intervals.
- * @param {TokenSet | null} tokenSet The token set to refresh the identity for
- * @returns {Promise<void>} A promise that resolves when the timer for refreshing the identity is initialized
- * */
-async function startRefreshingIdentityCycle(clientId, clientSecret, authorityUrl, configNode) {
-    let retries = 5;
-
-    const refresh = async () => {
-        try {
-            const newTokenSet = await getFreshTokenSet(clientId, clientSecret, authorityUrl);
-            const expiresIn = await getExpiresInForExternalTaskWorkers(newTokenSet);
-            const delay = expiresIn * DELAY_FACTOR * 1000;
-
-            freshIdentity = getIdentityForExternalTaskWorkers(newTokenSet);
-
-            configNode.setIdentity(freshIdentity);
-
-            retries = 5;
-            setTimeout(refresh, delay);
-        } catch (error) {
-            if (retries === 0) {
-                console.error(
-                    'Could not refresh identity for external task worker processes. Stopping all external task workers.',
-                    { error }
-                );
-                return;
-            }
-            console.error('Could not refresh identity for external task worker processes.', {
-                error,
-                retryCount: retries,
-            });
-            retries--;
-
-            const delay = 2 * 1000;
-            setTimeout(refresh, delay);
-        }
-    };
-
-    await refresh();
-}

package/processcube-google-docs-mail-template.html

@@ -0,0 +1,150 @@
+<script type="text/javascript">
+    RED.nodes.registerType('processcube-google-docs-mail-template', {
+        category: 'ProcessCube Tools',
+        color: '#02AFD6',
+        defaults: {
+            name: { value: '' },
+            template_link: { value: '', type: 'str' },
+            template_link_type: { value: 'str'},
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: 'font-awesome/fa-sign-in',
+        label: function () {
+            return this.name || 'processcube-google-docs-mail-template';
+        },
+        oneditprepare: function () {
+            $('#node-input-template_link').typedInput({
+                default: 'msg',
+                types: ['msg', 'str'],
+            });
+
+            $('#node-input-template_link').typedInput('value', this.template_link);
+            $('#node-input-template_link').typedInput('type', this.template_link_type);
+        },
+        oneditsave: function () {
+            (this.template_link = $('#node-input-template_link').typedInput('value')),
+            (this.template_link_type = $('#node-input-template_link').typedInput('type'));
+        },
+    });
+</script>
+
+<script type="text/html" data-template-name="processcube-google-docs-mail-template">
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-input-name" placeholder="Name" />
+    </div>
+    <div class="form-row">
+        <label for="node-input-template_link"><i class="fa fa-tag"></i> Template Link</label>
+        <input type="text" id="node-input-template_link" placeholder="Template Link" />
+    </div>
+</script>
+
+<script type="text/markdown" data-help-name="processcube-google-docs-mail-template">
+# Email Template Renderer (with Google Drive/Docs Support)
+
+This Node-RED template module downloads a ZIP archive from a URL, extracts an HTML file and embedded images, replaces placeholders, and prepares the HTML content with inline attachments (CID) for email delivery.
+
+## Google Drive / Docs Link Support
+
+The ZIP file must be publicly accessible via a **shared Google Drive link** (at least “Anyone with the link can view”). The following link formats are supported:
+
+```js
+// Format 0: Google Docs (export as ZIP)
+const editMatch = link.match(/https:\/\/docs\.google\.com\/document\/d\/([^/]+)/);
+if (editMatch) {
+    const fileId = editMatch[1];
+    return `https://docs.google.com/document/d/${fileId}/export?format=zip`;
+}
+
+// Format 1: Google Drive – shared file
+const fileMatch = link.match(/https:\/\/drive\.google\.com\/file\/d\/([^/]+)\/view/);
+if (fileMatch) {
+    return `https://drive.google.com/uc?export=download&id=${fileMatch[1]}`;
+}
+
+// Format 2: Google Drive – open by ID
+const openMatch = link.match(/https:\/\/drive\.google\.com\/open\?id=([^&]+)/);
+if (openMatch) {
+    return `https://drive.google.com/uc?export=download&id=${openMatch[1]}`;
+}
+```
+
+> Make sure that the file is shared with one of these formats and publicly accessible.
+
+---
+
+## Processing Steps
+
+1. **Download** the ZIP archive from the URL.
+2. **Extract** the contents (expects one HTML file in the root directory).
+3. **Embed images**: All images referenced in `images/` will be replaced with `cid:` links.
+4. **Replace placeholders** in the following formats:
+   - `{{field}}`
+   - `///field///`
+5. **Output**:
+   - rendered HTML string
+   - `msg.attachments[]` containing Nodemailer-compatible inline files
+
+---
+
+## Inputs
+
+### `template_link` (String||msg): The URL to the ZIP archive containing the HTML template and images.
+### `payload` (JSON): Field to replace placeholders in the HTML template.
+
+Fields for placeholder replacement. Example:
+
+```json
+{
+  "user_name": "Martin",
+  "newsletter_date": "May 5, 2025",
+  "announcement": "Our new album will be released soon!"
+}
+```
+
+Used to replace `{{user_name}}` or `///user_name///` in the HTML template.
+
+---
+
+## Outputs
+
+### `payload` (String)
+
+The rendered HTML content with embedded CID references and replaced placeholders.
+
+### `attachments` (Array)
+
+Array of objects like:
+
+```json
+{
+  "filename": "image1.png",
+  "path": "/path/to/file/image1.png",
+  "cid": "image1"
+}
+```
+
+---
+
+## Example
+
+```text
+&lt;p&gt;Hello &#123;&#123;user_name&#125;&#125;,&lt;/p&gt;
+&lt;img src=&quot;images/image1.png&quot;&gt;
+```
+
+Becomes:
+
+```text
+&lt;p&gt;Hello Martin,&lt;/p&gt;
+&lt;img src=&quot;cid:image1&quot;&gt;
+```
+
+---
+
+## References
+
+- [The ProcessCube Developer Network](https://processcube.io) – All documentation for the ProcessCube&copy; platform  
+- [Node-RED Integration in ProcessCube&copy;](https://processcube.io/docs/node-red) – Node-RED integration in ProcessCube&copy;
+</script>

package/processcube-google-docs-mail-template.js

@@ -0,0 +1,158 @@
+module.exports = function (RED) {
+
+    const fs = require('fs');
+    const path = require('path');
+    const { pipeline } = require('stream');
+    const { promisify } = require('util');
+    const AdmZip = require('adm-zip');
+    const fetch = require('node-fetch');
+
+    const streamPipeline = promisify(pipeline);
+
+    function ProcesssCubeGoogleDocsMailTemplate(config) {
+        RED.nodes.createNode(this, config);
+        const node = this;
+
+        node.on('input', async function (msg) {
+
+            try {
+
+                async function inlineCssImport(html) {
+                    // 1. Finde @import-Zeile
+                    const importRegex = /@import\s+url\(([^)]+)\);?/;
+                    const match = html.match(importRegex);
+                    if (!match) return html; // keine @import-Zeile gefunden
+
+                    const url = match[1].replace(/['"]/g, ''); // evtl. Anführungszeichen entfernen
+
+                    try {
+                        const response = await fetch(url);
+                        if (!response.ok) throw new Error(`Fehler beim Laden von ${url}`);
+
+                        const cssContent = await response.text();
+
+                        // 2. Ersetze @import-Zeile durch eingebettetes CSS
+                        const embeddedStyle = `\n/* inlined from ${url} */\n${cssContent}`;
+                        return html.replace(importRegex, embeddedStyle);
+                    } catch (error) {
+                        console.error('Fehler beim Inlining der CSS-Datei:', error);
+                        return html; // Fallback: Original belassen
+                    }
+                }
+
+
+                function convertGoogleDriveLink(link) {
+                    // Format 0: https://docs.google.com/document/d/FILE_ID/edit
+                    const editMatch = link.match(/https:\/\/docs\.google\.com\/document\/d\/([^/]+)/);
+                    if (editMatch) {
+                        const fileId = editMatch[1];
+                        return `https://docs.google.com/document/d/${fileId}/export?format=zip`;
+                    }
+
+                    // Format 1: https://drive.google.com/file/d/FILE_ID/view?usp=sharing
+                    const fileMatch = link.match(/https:\/\/drive\.google\.com\/file\/d\/([^/]+)\/view/);
+                    if (fileMatch) {
+                        return `https://drive.google.com/uc?export=download&id=${fileMatch[1]}`;
+                    }
+
+                    // Format 2: https://drive.google.com/open?id=FILE_ID
+                    const openMatch = link.match(/https:\/\/drive\.google\.com\/open\?id=([^&]+)/);
+                    if (openMatch) {
+                        return `https://drive.google.com/uc?export=download&id=${openMatch[1]}`;
+                    }
+
+                    // Anderenfalls unverändert zurückgeben
+                    return link;
+                }
+
+                function renderTemplate(html, payload) {
+                    // Ersetze {{feld}} und ///feld///
+                    return html.replace(/({{([^}]+)}}|\/\/\/([^/]+)\/\/\/)/g, (match, _, field1, field2) => {
+                        const key = field1 || field2;
+                        return payload[key.trim()] ?? match; // fallback: Platzhalter bleibt bestehen
+                    });
+                }
+
+                function removeGoogleRedirects(html) {
+                    return html.replace(/https:\/\/www\.google\.com\/url\?q=([^"&]+)[^"]*/g, (match, actualUrl) => {
+                        try {
+                            // Google-URLs sind URL-encoded – dekodieren
+                            return decodeURIComponent(actualUrl);
+                        } catch {
+                            return actualUrl;
+                        }
+                    });
+                }
+
+                const template_link = RED.util.evaluateNodeProperty(config.template_link, config.template_link_type, node, msg);
+
+                const customRoot = path.resolve(RED.settings.userDir, 'tmp/processcube-google-docs-mail-template');
+                fs.mkdirSync(customRoot, { recursive: true });
+                const tempDir = fs.mkdtempSync(path.join(customRoot, 'run-'));
+                const zipPath = path.join(tempDir, 'downloaded.zip');
+
+                const url = convertGoogleDriveLink(template_link);
+
+                const response = await fetch(url);
+                if (!response.ok) {
+                    throw new Error(`Fehler beim Herunterladen: ${response.status} ${response.statusText}`);
+                }
+                await streamPipeline(response.body, fs.createWriteStream(zipPath));
+
+                const zip = new AdmZip(zipPath);
+                zip.extractAllTo(tempDir, true);
+
+                // === HTML-Datei im obersten Verzeichnis finden ===
+                const topLevelFiles = fs.readdirSync(tempDir, { withFileTypes: true });
+                const htmlEntry = topLevelFiles.find(file =>
+                    file.isFile() && file.name.toLowerCase().endsWith('.html')
+                );
+
+                if (!htmlEntry) {
+                    throw new Error('Keine HTML-Datei im ZIP-Hauptverzeichnis gefunden.');
+                }
+
+                const htmlPath = path.join(tempDir, htmlEntry.name);
+                let html = fs.readFileSync(htmlPath, 'utf8');
+
+                // === Bilder durch CID ersetzen ===
+                const imgRegex = /src="images\/([^"]+)"/g;
+                const attachments = [];
+                let match;
+
+                while ((match = imgRegex.exec(html)) !== null) {
+                    const fileName = match[1];
+                    const cidName = path.parse(fileName).name;
+                    const imgPath = path.join(tempDir, 'images', fileName);
+
+                    if (fs.existsSync(imgPath)) {
+                        attachments.push({
+                            filename: fileName,
+                            path: imgPath,
+                            cid: cidName
+                        });
+
+                        html = html.replace(`src="images/${fileName}"`, `src="cid:${cidName}"`);
+                    }
+                }
+
+                html = await inlineCssImport(html);
+
+                let new_payload = renderTemplate(html, msg.payload);
+
+                // ggf. mit schalter
+                new_payload = removeGoogleRedirects(new_payload);
+
+                msg.payload = new_payload;
+                msg.attachments = attachments;
+
+
+                node.send(msg);
+            } catch (queryError) {
+                node.error(`Generate the content: ${queryError.message}`, msg);
+            }
+        });
+    }
+
+    RED.nodes.registerType('processcube-google-docs-mail-template', ProcesssCubeGoogleDocsMailTemplate);
+};

package/processdefinition-deploy.html

@@ -0,0 +1,44 @@
+<script type="text/javascript">
+    RED.nodes.registerType('processdefinition-deploy', {
+        category: 'ProcessCube',
+        color: '#02AFD6',
+        defaults: {
+            name: { value: '' },
+            engine: { value: '', type: 'processcube-engine-config' },
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: 'processdefinition_deploy.svg',
+        label: function () {
+            return this.name || 'processdefinition-deploy';
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="processdefinition-deploy">
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-input-name" placeholder="Name" />
+    </div>
+    <div class="form-row">
+        <label for="node-input-engine"><i class="fa fa-tag"></i> Engine-URL</label>
+        <input type="text" id="node-input-engine" placeholder="http://engine:8000" />
+    </div>
+</script>
+
+<script type="text/markdown" data-help-name="processdefinition-deploy">
+A node to deploy process definition to the ProcessCube Engine.
+
+## Inputs
+
+: payload (String) : XML of the bpmn file
+
+## Outputs
+
+: payload (String) : XML of the bpmn file
+
+### References
+
+-  [The ProcessCube&copy; Developer Network](https://processcube.io) - All documentation for the ProcessCube&copy; platform
+-  [ProcessCube&copy; LowCode Integration](https://processcube.io/docs/node-red) - LowCode integration in ProcessCube&copy;
+</script>

package/processdefinition-deploy.js

@@ -0,0 +1,28 @@
+module.exports = function (RED) {
+    function ProcessdefinitionDeploy(config) {
+        RED.nodes.createNode(this, config);
+        var node = this;
+
+        node.on('input', function (msg) {
+            node.engine = RED.nodes.getNode(config.engine);
+            const client = node.engine.engineClient;
+            const isUser = !!msg._client?.user && !!msg._client.user.accessToken;
+            const userIdentity = isUser ? { userId: msg._client.user.id, token: msg._client.user.accessToken } : null;
+
+            if (!client) {
+                node.error('No engine configured.');
+                return;
+            }
+     
+            client.processDefinitions
+                .persistProcessDefinitions(msg.payload, { overwriteExisting: true, identity: userIdentity })
+                .then(() => {
+                    node.send(msg);
+                })
+                .catch((error) => {
+                    node.error(error, {});
+                });
+        });
+    }
+    RED.nodes.registerType('processdefinition-deploy', ProcessdefinitionDeploy);
+};