@platform-modules/civil-aviation-authority 2.3.279 → 2.3.281

package/dist/i18n/workflow-chat-message.builder.js

@@ -0,0 +1,350 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enrichCancellationChatMessage = exports.enrichCancellationWorkflowLog = void 0;
+exports.getWorkflowChatI18nCatalog = getWorkflowChatI18nCatalog;
+exports.resolveBilingualName = resolveBilingualName;
+exports.pickLocalizedName = pickLocalizedName;
+exports.pickArabicName = pickArabicName;
+exports.resolveActorDisplayNames = resolveActorDisplayNames;
+exports.joinDeptSectionBilingualLabels = joinDeptSectionBilingualLabels;
+exports.joinDeptSectionArabicLabels = joinDeptSectionArabicLabels;
+exports.formatWorkflowCommentSuffix = formatWorkflowCommentSuffix;
+exports.formatChatCommentSuffix = formatChatCommentSuffix;
+exports.renderSynchronizedWorkflowMessage = renderSynchronizedWorkflowMessage;
+exports.renderSynchronizedChatMessage = renderSynchronizedChatMessage;
+exports.buildBilingualFromTemplate = buildBilingualFromTemplate;
+exports.workflowTemplate = workflowTemplate;
+exports.chatTemplate = chatTemplate;
+exports.buildSynchronizedWorkflowMessage = buildSynchronizedWorkflowMessage;
+exports.buildSynchronizedChatMessage = buildSynchronizedChatMessage;
+exports.buildApprovalWorkflowContent = buildApprovalWorkflowContent;
+exports.buildHumanApprovalWorkflowContent = buildHumanApprovalWorkflowContent;
+exports.buildApprovalChatMessage = buildApprovalChatMessage;
+exports.resolveWorkflowStatusAr = resolveWorkflowStatusAr;
+exports.resolveChatStatusAr = resolveChatStatusAr;
+exports.resolveWorkflowContentAr = resolveWorkflowContentAr;
+exports.resolveChatMessageAr = resolveChatMessageAr;
+exports.enrichWorkflowLog = enrichWorkflowLog;
+exports.enrichChatMessage = enrichChatMessage;
+/**
+ * CAA standard bilingual workflow/chat message builder.
+ *
+ * All services MUST use these helpers (never hardcode message strings).
+ * Templates live in workflow-chat-i18n.json; dynamic values use parallel EN/AR params.
+ */
+const workflow_chat_i18n_json_1 = __importDefault(require("./workflow-chat-i18n.json"));
+const WORKFLOW_TEMPLATES = workflow_chat_i18n_json_1.default.workflowTemplates;
+const CHAT_TEMPLATES = workflow_chat_i18n_json_1.default.chatTemplates;
+const WORKFLOW_STATUS_LABELS = workflow_chat_i18n_json_1.default.workflowStatusLabels;
+const CHAT_STATUS_LABELS = workflow_chat_i18n_json_1.default.chatStatusLabels;
+function getWorkflowChatI18nCatalog() {
+    return workflow_chat_i18n_json_1.default;
+}
+function interpolate(template, params = {}) {
+    return template.replace(/\{\{(\w+)\}\}/g, (_, key) => params[key] ?? '');
+}
+/** Arabic DB column preferred; English fallback so AR keeps identical structure to EN. */
+function resolveBilingualName(englishName, arabicName) {
+    const ar = arabicName?.trim();
+    if (ar)
+        return ar;
+    return englishName?.trim() || '';
+}
+function pickLocalizedName(englishName, arabicName, fallback = '') {
+    return resolveBilingualName(englishName, arabicName) || fallback;
+}
+/** @deprecated Use resolveBilingualName */
+function pickArabicName(arabicName) {
+    return arabicName?.trim() || '';
+}
+function joinLabels(...parts) {
+    return parts.map((p) => p?.trim()).filter(Boolean).join(' - ');
+}
+/** Build parallel EN / AR actor label from role OR dept+section. */
+function resolveActorDisplayNames(actors) {
+    if (actors.roleName?.trim()) {
+        const en = actors.roleName.trim();
+        return { en, ar: resolveBilingualName(en, actors.roleArabicName) };
+    }
+    const en = joinLabels(actors.deptName, actors.sectionName);
+    const ar = joinLabels(resolveBilingualName(actors.deptName, actors.deptArabicName), resolveBilingualName(actors.sectionName, actors.sectionArabicName));
+    return { en, ar };
+}
+/** @deprecated Use resolveActorDisplayNames */
+function joinDeptSectionBilingualLabels(deptEn, deptAr, sectEn, sectAr) {
+    return resolveActorDisplayNames({
+        deptName: deptEn,
+        deptArabicName: deptAr,
+        sectionName: sectEn,
+        sectionArabicName: sectAr,
+    });
+}
+/** @deprecated Use resolveActorDisplayNames */
+function joinDeptSectionArabicLabels(deptArabic, sectionArabic) {
+    return joinLabels(deptArabic, sectionArabic);
+}
+function formatWorkflowCommentSuffix(comment) {
+    const text = comment?.trim();
+    return text ? `: ${text}` : '';
+}
+function formatChatCommentSuffix(comment) {
+    const text = comment?.trim();
+    return text ? ` - ${text}` : '';
+}
+/** Core renderer — always pass explicit EN and AR param objects with the same keys. */
+function renderSynchronizedWorkflowMessage(templateKey, enParams, arParams) {
+    const tpl = WORKFLOW_TEMPLATES[templateKey];
+    if (!tpl)
+        return { en: templateKey, ar: templateKey };
+    return {
+        en: interpolate(tpl.en, enParams),
+        ar: interpolate(tpl.ar, arParams),
+    };
+}
+function renderSynchronizedChatMessage(templateKey, enParams, arParams) {
+    const tpl = CHAT_TEMPLATES[templateKey];
+    if (!tpl)
+        return { en: templateKey, ar: templateKey };
+    return {
+        en: interpolate(tpl.en, enParams),
+        ar: interpolate(tpl.ar, arParams),
+    };
+}
+function buildBilingualFromTemplate(templateCatalog, key, params = {}, arParams) {
+    const tpl = templateCatalog[key];
+    if (!tpl)
+        return { en: key, ar: key };
+    const arabicParams = arParams ?? params;
+    return {
+        en: interpolate(tpl.en, params),
+        ar: interpolate(tpl.ar, arabicParams),
+    };
+}
+function workflowTemplate(key, params = {}, arParams) {
+    return buildBilingualFromTemplate(WORKFLOW_TEMPLATES, key, params, arParams);
+}
+function chatTemplate(key, params = {}, arParams) {
+    return buildBilingualFromTemplate(CHAT_TEMPLATES, key, params, arParams);
+}
+/**
+ * Standard entry point for workflow `content` + `content_ar`.
+ * Use for every workflow log insert/update across all CAA modules.
+ */
+function buildSynchronizedWorkflowMessage(ctx) {
+    const commentWf = formatWorkflowCommentSuffix(ctx.comment);
+    const { en: actorEn, ar: actorAr } = resolveActorDisplayNames(ctx);
+    switch (ctx.action) {
+        case 'request_submitted':
+            return workflowTemplate('request_submitted');
+        case 'notification_sent_pending':
+            return workflowTemplate('notification_sent_pending');
+        case 'notification_sent_successfully':
+            return workflowTemplate('notification_sent_successfully');
+        case 'approval_in_progress':
+            return actorEn
+                ? renderSynchronizedWorkflowMessage('request_approval_in_progress_from', { name: actorEn }, { name: actorAr })
+                : workflowTemplate('request_approval_in_progress');
+        case 'approval_pending':
+            return actorEn
+                ? renderSynchronizedWorkflowMessage('request_approval_pending_from', { name: actorEn }, { name: actorAr })
+                : workflowTemplate('request_approval_pending');
+        case 'approved':
+            return actorEn
+                ? renderSynchronizedWorkflowMessage('request_approved_by', { name: actorEn, comment: commentWf }, { name: actorAr, comment: commentWf })
+                : renderSynchronizedWorkflowMessage('request_approved', { comment: commentWf }, { comment: commentWf });
+        case 'rejected':
+            return actorEn
+                ? renderSynchronizedWorkflowMessage('request_rejected_by', { name: actorEn, comment: commentWf }, { name: actorAr, comment: commentWf })
+                : renderSynchronizedWorkflowMessage('request_rejected', { comment: commentWf }, { comment: commentWf });
+        case 'returned_for_modification':
+            return actorEn
+                ? renderSynchronizedWorkflowMessage('request_returned_for_modification_by', { name: actorEn, comment: commentWf }, { name: actorAr, comment: commentWf })
+                : renderSynchronizedWorkflowMessage('request_returned_for_modification', { comment: commentWf }, { comment: commentWf });
+        case 'approval_pending_update':
+            return actorEn
+                ? renderSynchronizedWorkflowMessage('request_approval_pending_from', { name: actorEn, comment: commentWf }, { name: actorAr, comment: commentWf })
+                : renderSynchronizedWorkflowMessage('request_approval_pending', { comment: commentWf }, { comment: commentWf });
+        default:
+            return workflowTemplate('request_submitted');
+    }
+}
+/**
+ * Standard entry point for chat `message` + `message_ar`.
+ * Use for every chat insert/update across all CAA modules.
+ */
+function buildSynchronizedChatMessage(ctx) {
+    const commentChat = formatChatCommentSuffix(ctx.comment);
+    switch (ctx.action) {
+        case 'cancellation_submitted': {
+            const userEn = ctx.userName?.trim() || 'Unknown User';
+            const userAr = resolveBilingualName(userEn, ctx.userArabicName);
+            const employeeId = String(ctx.employeeId ?? 'N/A');
+            return chatTemplate('cancellation_submitted_by', { userName: userEn, employeeId }, { userName: userAr, employeeId });
+        }
+        case 'request_received':
+            return chatTemplate('request_received');
+        case 'approved':
+        case 'rejected':
+        case 'returned_for_modification': {
+            const roleEn = ctx.roleName?.trim() || 'Unknown Role';
+            const roleAr = resolveBilingualName(roleEn, ctx.roleArabicName);
+            const key = ctx.action === 'approved'
+                ? 'request_approved_by_role'
+                : ctx.action === 'rejected'
+                    ? 'request_rejected_by_role'
+                    : 'request_returned_for_modification_by_role';
+            return renderSynchronizedChatMessage(key, { roleName: roleEn, comment: commentChat }, { roleName: roleAr, comment: commentChat });
+        }
+        default:
+            return chatTemplate('request_received');
+    }
+}
+// ─── Backward-compatible aliases used by Cancellation pilot ───────────────────
+function buildApprovalWorkflowContent(params) {
+    const status = params.status;
+    let action;
+    if (status === 'Approved')
+        action = 'approved';
+    else if (status === 'Rejected')
+        action = 'rejected';
+    else if (status === 'Returned for Modification')
+        action = 'returned_for_modification';
+    else
+        action = 'approval_pending_update';
+    return buildSynchronizedWorkflowMessage({
+        action,
+        roleName: params.roleName,
+        roleArabicName: params.roleArabicName,
+        comment: params.comment,
+    });
+}
+function buildHumanApprovalWorkflowContent(params) {
+    return buildSynchronizedWorkflowMessage({
+        action: params.isFirst ? 'approval_in_progress' : 'approval_pending',
+        roleName: params.roleName,
+        roleArabicName: params.roleArabicName,
+        deptName: params.deptName,
+        deptArabicName: params.deptArabicName,
+        sectionName: params.sectionName,
+        sectionArabicName: params.sectionArabicName,
+    });
+}
+function buildApprovalChatMessage(params) {
+    let action = 'approved';
+    if (params.status === 'Rejected')
+        action = 'rejected';
+    else if (params.status === 'Returned for Modification')
+        action = 'returned_for_modification';
+    return buildSynchronizedChatMessage({
+        action,
+        roleName: params.roleName,
+        roleArabicName: params.roleArabicName,
+        comment: params.comment,
+    });
+}
+// ─── Status labels ───────────────────────────────────────────────────────────
+function resolveWorkflowStatusAr(status) {
+    if (status == null || status === '')
+        return null;
+    return WORKFLOW_STATUS_LABELS[status] ?? status;
+}
+function resolveChatStatusAr(status) {
+    if (status == null || status === '')
+        return null;
+    return CHAT_STATUS_LABELS[status] ?? status;
+}
+// ─── Legacy row enrichment (read API) ────────────────────────────────────────
+function resolveWorkflowContentAr(content) {
+    if (content == null || content.trim() === '')
+        return null;
+    const normalized = content.trim();
+    for (const tpl of Object.values(WORKFLOW_TEMPLATES)) {
+        if (tpl.en === normalized)
+            return tpl.ar;
+    }
+    const commentIdx = normalized.indexOf(': ');
+    if (commentIdx > 0) {
+        const baseEn = normalized.slice(0, commentIdx).trim();
+        const commentText = normalized.slice(commentIdx + 2).trim();
+        const commentSuffix = formatWorkflowCommentSuffix(commentText);
+        for (const tpl of Object.values(WORKFLOW_TEMPLATES)) {
+            if (!tpl.en.includes('{{comment}}'))
+                continue;
+            const withoutComment = tpl.en.replace('{{comment}}', '');
+            if (withoutComment.includes('{{name}}')) {
+                const staticPrefix = withoutComment.replace('{{name}}', '').trim();
+                if (baseEn.startsWith(staticPrefix)) {
+                    const namePart = baseEn.slice(staticPrefix.length).trim();
+                    return interpolate(tpl.ar, { name: namePart, comment: commentSuffix });
+                }
+            }
+            else if (withoutComment.trim() === baseEn) {
+                return interpolate(tpl.ar, { comment: commentSuffix });
+            }
+        }
+    }
+    const inProgressPrefix = WORKFLOW_TEMPLATES.request_approval_in_progress_from?.en.split('{{name}}')[0].trim();
+    if (inProgressPrefix && normalized.startsWith(inProgressPrefix)) {
+        const namePart = normalized.slice(inProgressPrefix.length).trim();
+        return interpolate(WORKFLOW_TEMPLATES.request_approval_in_progress_from.ar, { name: namePart });
+    }
+    const pendingPrefix = WORKFLOW_TEMPLATES.request_approval_pending_from?.en.split('{{name}}')[0].trim();
+    if (pendingPrefix && normalized.startsWith(pendingPrefix)) {
+        const namePart = normalized.slice(pendingPrefix.length).trim();
+        return interpolate(WORKFLOW_TEMPLATES.request_approval_pending_from.ar, { name: namePart });
+    }
+    return null;
+}
+function resolveChatMessageAr(message) {
+    if (message == null || message.trim() === '')
+        return null;
+    const normalized = message.trim();
+    for (const tpl of Object.values(CHAT_TEMPLATES)) {
+        if (tpl.en === normalized)
+            return tpl.ar;
+    }
+    for (const tpl of Object.values(CHAT_TEMPLATES)) {
+        if (!tpl.en.includes('{{roleName}}'))
+            continue;
+        const prefix = tpl.en.split('{{roleName}}')[0];
+        if (!normalized.startsWith(prefix))
+            continue;
+        const rest = normalized.slice(prefix.length);
+        const commentIdx = rest.lastIndexOf(' - ');
+        if (commentIdx >= 0) {
+            return interpolate(tpl.ar, {
+                roleName: rest.slice(0, commentIdx),
+                comment: rest.slice(commentIdx),
+            });
+        }
+        return interpolate(tpl.ar, { roleName: rest, comment: '' });
+    }
+    return null;
+}
+/** Generic workflow log enricher — use in all module repositories. */
+function enrichWorkflowLog(log) {
+    const status = log.status != null ? String(log.status) : null;
+    const content = log.content != null ? String(log.content) : null;
+    return {
+        ...log,
+        content_ar: log.content_ar ?? resolveWorkflowContentAr(content),
+        status_ar: log.status_ar ?? resolveWorkflowStatusAr(status),
+    };
+}
+/** Generic chat enricher — use in all module repositories. */
+function enrichChatMessage(chat) {
+    const status = chat.status != null ? String(chat.status) : null;
+    const message = chat.message != null ? String(chat.message) : null;
+    return {
+        ...chat,
+        message_ar: chat.message_ar ?? resolveChatMessageAr(message),
+        status_ar: chat.status_ar ?? resolveChatStatusAr(status),
+    };
+}
+/** @deprecated Use enrichWorkflowLog */
+exports.enrichCancellationWorkflowLog = enrichWorkflowLog;
+/** @deprecated Use enrichChatMessage */
+exports.enrichCancellationChatMessage = enrichChatMessage;

package/dist/index.d.ts

@@ -415,4 +415,4 @@ export * from './models/SlaApprovalsViewModel';
 export * from './models/ServiceSlaApprovalModel';
 export * from './sla/sla-table-sync.service';
 export * from './sla/sla-approval-mirror';
-export * from './i18n/workflow-chat-i18n';
+export * from './i18n/workflow-chat-message.builder';

package/dist/index.js

@@ -604,4 +604,4 @@ __exportStar(require("./models/SlaApprovalsViewModel"), exports);
 __exportStar(require("./models/ServiceSlaApprovalModel"), exports);
 __exportStar(require("./sla/sla-table-sync.service"), exports);
 __exportStar(require("./sla/sla-approval-mirror"), exports);
-__exportStar(require("./i18n/workflow-chat-i18n"), exports);
+__exportStar(require("./i18n/workflow-chat-message.builder"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
  "name": "@platform-modules/civil-aviation-authority",
- "version": "2.3.279",
+ "version": "2.3.281",
  "main": "dist/index.js",
  "types": "dist/index.d.ts",
   "scripts": {

package/src/i18n/workflow-chat-i18n.json

@@ -58,6 +58,10 @@
       "en": "Cancellation request submitted by {{userName}} ({{employeeId}})",
       "ar": "تم تقديم طلب الإلغاء بواسطة {{userName}} ({{employeeId}})"
     },
+    "cancellation_submitted": {
+      "en": "Cancellation request submitted",
+      "ar": "تم تقديم طلب الإلغاء"
+    },
     "request_received": {
       "en": "Request Received",
       "ar": "تم استلام الطلب"
@@ -73,6 +77,18 @@
     "request_returned_for_modification_by_role": {
       "en": "Request Returned for Modification by: {{roleName}}{{comment}}",
       "ar": "تم إرجاع الطلب للتعديل من قبل: {{roleName}}{{comment}}"
+    },
+    "request_approved": {
+      "en": "Request Approved{{comment}}",
+      "ar": "تمت الموافقة على الطلب{{comment}}"
+    },
+    "request_rejected": {
+      "en": "Request Rejected{{comment}}",
+      "ar": "تم رفض الطلب{{comment}}"
+    },
+    "request_returned_for_modification": {
+      "en": "Request Returned for Modification{{comment}}",
+      "ar": "تم إرجاع الطلب للتعديل{{comment}}"
     }
   },
   "workflowStatusLabels": {