@openinc/parse-server-opendash 4.1.4 → 4.1.6

package/dist/features/permissions/types/Permissions.d.ts

@@ -32,6 +32,7 @@ export declare namespace Permissions {
         template_manage = "service:can-manage-template",
         masterdata_manage = "service:can-manage-masterdata",
         formconfig_manage = "service:can-manage-formconfig",
+        tag_create = "service:can-create-tag",
         analytics_view = "service:can-view-analytics"
     }
     enum CORE {

package/dist/features/permissions/types/Permissions.js

@@ -47,6 +47,9 @@ var Permissions;
         SERVICE["template_manage"] = "service:can-manage-template";
         SERVICE["masterdata_manage"] = "service:can-manage-masterdata";
         SERVICE["formconfig_manage"] = "service:can-manage-formconfig";
+        // Narrow master-data capability: create a tag inline from a tag picker,
+        // without granting full master-data management.
+        SERVICE["tag_create"] = "service:can-create-tag";
         // Analytics / monitoring
         SERVICE["analytics_view"] = "service:can-view-analytics";
     })(SERVICE = Permissions.SERVICE || (Permissions.SERVICE = {}));

package/dist/helper/appLinks.d.ts

@@ -0,0 +1,21 @@
+import { _User } from "../types/index.js";
+/**
+ * App-relative deep link to a service ticket (`OD3_Service_Ticket`).
+ *
+ * Notifications store links relative to the app root rather than absolute:
+ * the same notification is rendered in the frontend (which navigates by route)
+ * and mailed out (which needs a host), and the host depends on the recipient's
+ * tenant. {@link getAppBaseUrl} resolves it at delivery time.
+ */
+export declare function ticketPath(ticketId: string): string;
+/**
+ * Resolves the base URL of the open.DASH frontend for a given recipient, so
+ * links in notification emails point at the app that user actually works in.
+ *
+ * Precedence: the user's tenant `baseUrl` (multi-tenant installs serve each
+ * tenant from its own host), then the global `APP_URL`, then
+ * `PARSE_PUBLIC_SERVER_URL` with the trailing `/parse` stripped. Returns an
+ * empty string when nothing is configured, so callers emit the bare relative
+ * path instead of a link to a bogus host.
+ */
+export declare function getAppBaseUrl(user: _User): Promise<string>;

package/dist/helper/appLinks.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ticketPath = ticketPath;
+exports.getAppBaseUrl = getAppBaseUrl;
+const index_js_1 = require("../features/config/index.js");
+/**
+ * App-relative deep link to a service ticket (`OD3_Service_Ticket`).
+ *
+ * Notifications store links relative to the app root rather than absolute:
+ * the same notification is rendered in the frontend (which navigates by route)
+ * and mailed out (which needs a host), and the host depends on the recipient's
+ * tenant. {@link getAppBaseUrl} resolves it at delivery time.
+ */
+function ticketPath(ticketId) {
+    return `/service/tickets/${ticketId}`;
+}
+/**
+ * Resolves the base URL of the open.DASH frontend for a given recipient, so
+ * links in notification emails point at the app that user actually works in.
+ *
+ * Precedence: the user's tenant `baseUrl` (multi-tenant installs serve each
+ * tenant from its own host), then the global `APP_URL`, then
+ * `PARSE_PUBLIC_SERVER_URL` with the trailing `/parse` stripped. Returns an
+ * empty string when nothing is configured, so callers emit the bare relative
+ * path instead of a link to a bogus host.
+ */
+async function getAppBaseUrl(user) {
+    let baseUrl = "";
+    try {
+        const tenant = (await user.fetchWithInclude("tenant", { useMasterKey: true })).get("tenant");
+        baseUrl = tenant?.get("baseUrl") || "";
+    }
+    catch (error) {
+        // No tenant / not fetchable — fall through to the global configuration.
+    }
+    if (!baseUrl) {
+        try {
+            const config = index_js_1.ConfigInstance.getInstance();
+            const parseUrl = config.get("PARSE_PUBLIC_SERVER_URL") || "";
+            baseUrl = config.get("APP_URL") || parseUrl.replace(/\/parse\/?$/, "");
+        }
+        catch (error) {
+            console.warn("[@openinc/parse-server-opendash] Could not resolve an app base URL for notification links");
+        }
+    }
+    return (baseUrl || "").replace(/\/+$/, "");
+}

package/dist/hooks/Chat_Message.js

@@ -7,6 +7,7 @@ exports.init = init;
 const node_1 = __importDefault(require("parse/node"));
 const i18next_1 = __importDefault(require("i18next"));
 const index_js_1 = require("../features/schema/index.js");
+const appLinks_js_1 = require("../helper/appLinks.js");
 const getUserLanguage_js_1 = require("../helper/getUserLanguage.js");
 const index_js_2 = require("../types/index.js");
 async function init() {
@@ -49,7 +50,8 @@ async function notifyMentions(object, original) {
         return;
     const username = object.get("authorName") || "System";
     const messageText = messageSnippet(object.get("text"));
-    const url = getMessageLink(object.get("context"));
+    // The only linkable chat context today is a service ticket's comment section.
+    const ticketId = getTicketId(object.get("context"));
     // Users already handled — seeded with the author so they never self-notify.
     const notified = new Set();
     const authorId = object.get("author")?.id;
@@ -71,7 +73,7 @@ async function notifyMentions(object, original) {
         await sendMentionNotification(user, "user", object, {
             username,
             messageText,
-            url,
+            ticketId,
         });
     }
     // 2. Mentioned roles → their members, skipping anyone already notified.
@@ -95,7 +97,7 @@ async function notifyMentions(object, original) {
             await sendMentionNotification(member, "role", object, {
                 username,
                 messageText,
-                url,
+                ticketId,
                 role: role.get("label"),
             });
         }
@@ -105,6 +107,12 @@ async function notifyMentions(object, original) {
  * Builds and saves a single mention notification, translated into the
  * recipient's preferred language. Delivery (email + web push) is handled
  * automatically by the {@link Notification} afterSave hook.
+ *
+ * When the chat belongs to a service ticket the notification also carries that
+ * ticket: `data.url` gives the notification email a deep link (the host is
+ * resolved per recipient at delivery time) and `data.ticketId` gives the
+ * frontend its "open ticket" action — the same two keys assignment
+ * notifications use, so a mention behaves like any other ticket notification.
  */
 async function sendMentionNotification(user, kind, message, vars) {
     await i18next_1.default.changeLanguage(await (0, getUserLanguage_js_1.getUserLanguage)(user));
@@ -117,7 +125,9 @@ async function sendMentionNotification(user, kind, message, vars) {
             role: vars.role,
         }),
         data: {
-            url: vars.url,
+            ...(vars.ticketId
+                ? { ticketId: vars.ticketId, url: (0, appLinks_js_1.ticketPath)(vars.ticketId) }
+                : {}),
             messageId: message.id,
             context: message.get("context"),
             translation: {
@@ -143,11 +153,11 @@ function mentionKey(mention) {
     return `${mention.className}:${mention.id}`;
 }
 /**
- * Derives a deep-link path from the chat's `context`. The context is the
+ * Extracts the ticket a chat belongs to from its `context`. The context is the
  * JSON-stringified address tuple (e.g. `["service","ticket","<id>"]`). Only the
- * service-ticket context is linkable today; anything else yields no link.
+ * service-ticket context is linkable today; anything else yields no ticket.
  */
-function getMessageLink(context) {
+function getTicketId(context) {
     if (typeof context !== "string")
         return undefined;
     try {
@@ -155,12 +165,13 @@ function getMessageLink(context) {
         if (Array.isArray(parts) &&
             parts[0] === "service" &&
             parts[1] === "ticket" &&
+            typeof parts[2] === "string" &&
             parts[2]) {
-            return `/service/tickets/${parts[2]}`;
+            return parts[2];
         }
     }
     catch {
-        // context is not a JSON tuple — no link
+        // context is not a JSON tuple — not ticket-bound
     }
     return undefined;
 }

package/dist/hooks/Notification.js

@@ -9,6 +9,7 @@ const web_push_1 = __importDefault(require("web-push"));
 const index_js_1 = require("../features/schema/index.js");
 const index_js_2 = require("../features/config/index.js");
 const index_js_3 = require("../features/notifications/index.js");
+const appLinks_js_1 = require("../helper/appLinks.js");
 const index_js_4 = require("../types/index.js");
 async function init() {
     (0, index_js_1.beforeSaveHook)(index_js_4.Notification, async (request) => {
@@ -28,13 +29,7 @@ async function init() {
                 const email = user?.getEmail();
                 console.log("[@openinc/parse-server-opendash][Notification]", `notification="${object.id}"`, `type="email"`, `to="${email}"`);
                 if (email) {
-                    let body = description || "";
-                    if (object.get("data")?.url) {
-                        body += "\n\n";
-                        body += index_js_2.ConfigInstance.getInstance().get("APP_URL");
-                        body += object.get("data")?.url;
-                    }
-                    await (0, index_js_3.sendSimpleEmail)(email, title, body);
+                    await (0, index_js_3.sendSimpleEmail)(email, title, await buildEmailBody(description, object.get("data")?.url, user));
                 }
             }
             // Handle Push
@@ -55,6 +50,26 @@ async function init() {
         }
     });
 }
+/**
+ * Plain-text body of a notification email: the (already translated)
+ * description, followed by a link to the thing the notification is about.
+ *
+ * Producers store that link in `data.url` as an app-relative path (e.g.
+ * `/service/tickets/<id>`), because the host depends on the recipient's tenant
+ * and is only known here, at delivery time — the frontend renders the same
+ * notification by route and never needs it. Absolute URLs are passed through
+ * unchanged for producers that resolved a host themselves.
+ */
+async function buildEmailBody(description, url, user) {
+    const body = description || "";
+    if (typeof url !== "string" || url === "") {
+        return body;
+    }
+    const link = /^https?:\/\//i.test(url)
+        ? url
+        : `${await (0, appLinks_js_1.getAppBaseUrl)(user)}${url}`;
+    return `${body}\n\n${link}`;
+}
 async function sendWebPush(subscription, id, title, description, icon, data) {
     try {
         console.log("[@openinc/parse-server-opendash][Notification]", `notification="${id}"`, `type="web"`, `subscription="${subscription?.id}"`);

package/dist/hooks/Service_Ticket.js

@@ -40,9 +40,9 @@ exports.init = init;
 const node_1 = __importStar(require("parse/node"));
 const i18next_1 = __importDefault(require("i18next"));
 const index_js_1 = require("../features/schema/index.js");
+const appLinks_js_1 = require("../helper/appLinks.js");
 const getUserLanguage_js_1 = require("../helper/getUserLanguage.js");
 const index_js_2 = require("../types/index.js");
-const index_js_3 = require("../features/config/index.js");
 const applyRuleSet_js_1 = require("../features/ruleset/applyRuleSet.js");
 async function init() {
     (0, index_js_1.beforeSaveHook)("OD3_Service_Ticket", async (request) => {
@@ -338,10 +338,15 @@ async function notifyRecipients(userIds, roleIds, notified, ticket, options) {
  * Builds and saves a single assignment notification, translated into the
  * recipient's preferred language. Delivery (email + web push) is handled
  * automatically by the {@link Notification} afterSave hook.
+ *
+ * The deep link lives in `data.url` rather than inside the description text:
+ * the frontend opens the ticket from `data.ticketId` (see
+ * `TicketNotificationActionAdapter`) and would only render a raw URL as noise,
+ * while the notification email appends `data.url` — resolved against the
+ * recipient's tenant host — to the body.
  */
 async function sendAssignmentNotification(user, ticket, options) {
     await i18next_1.default.changeLanguage(await (0, getUserLanguage_js_1.getUserLanguage)(user));
-    const ticketLink = await getTicketLink(ticket, user);
     const base = `openservice:ticket.assignment.${options.variant}`;
     const ticketName = ticket.get("title");
     await new index_js_2.Notification({
@@ -349,11 +354,11 @@ async function sendAssignmentNotification(user, ticket, options) {
         description: i18next_1.default.t(`${base}.description`, {
             username: options.assignerName,
             ticketName,
-            ticketLink,
         }),
         type: options.frontpage ? "frontpage" : "mailbox",
         data: {
             ticketId: ticket.id,
+            url: (0, appLinks_js_1.ticketPath)(ticket.id),
             translation: {
                 username: options.assignerName,
                 ticketName,
@@ -390,32 +395,6 @@ function pointerIds(value) {
     })
         .filter((id) => typeof id === "string");
 }
-/**
- * Returns the link to a ticket.
- * @param ticket
- * @returns
- */
-async function getTicketLink(ticket, user) {
-    //Get hostname from tenant or environment variable or default to localhost
-    let hostname = "localhost";
-    const tenant = (await user.fetchWithInclude("tenant", { useMasterKey: true })).get("tenant");
-    try {
-        const baseurl = tenant?.get("baseUrl");
-        const publicurl = index_js_3.ConfigInstance.getInstance()
-            .get("PARSE_PUBLIC_SERVER_URL")
-            .replace("/parse", "");
-        if (baseurl !== undefined && baseurl !== "") {
-            hostname = baseurl;
-        }
-        else if (publicurl) {
-            hostname = publicurl;
-        }
-    }
-    catch (error) {
-        console.warn("[@openinc/parse-server-opendash] Could not get a hostname, defaulting to localhost");
-    }
-    return `${hostname}/service/tickets/${ticket.id}`;
-}
 function getUsername(user) {
     if (!user)
         return "System";

package/dist/i18n/de-DE/openservice.json

@@ -3,11 +3,11 @@
         "assignment": {
             "assigned": {
                 "title": "Ihnen wurde ein Ticket zugewiesen",
-                "description": "{{username}} hat Ihnen das Ticket {{ticketName}} zugewiesen.\n\nLink: {{- ticketLink}}"
+                "description": "{{username}} hat Ihnen das Ticket {{ticketName}} zugewiesen."
             },
             "watcher": {
                 "title": "Ein Ticket wurde zugewiesen",
-                "description": "{{username}} hat das Ticket {{ticketName}} zugewiesen.\n\nLink: {{- ticketLink}}"
+                "description": "{{username}} hat das Ticket {{ticketName}} zugewiesen."
             }
         }
     }

package/dist/i18n/en-US/openservice.json

@@ -3,11 +3,11 @@
         "assignment": {
             "assigned": {
                 "title": "You were assigned to a ticket",
-                "description": "{{username}} assigned you to ticket {{ticketName}}.\n\nLink: {{- ticketLink}}"
+                "description": "{{username}} assigned you to ticket {{ticketName}}."
             },
             "watcher": {
                 "title": "A ticket was assigned",
-                "description": "{{username}} assigned ticket {{ticketName}}.\n\nLink: {{- ticketLink}}"
+                "description": "{{username}} assigned ticket {{ticketName}}."
             }
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openinc/parse-server-opendash",
-  "version": "4.1.4",
+  "version": "4.1.6",
   "description": "Parse Server Cloud Code for open.INC Stack.",
   "packageManager": "pnpm@11.25.0",
   "keywords": [