@platform-modules/civil-aviation-authority 2.3.280 → 2.3.282

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

@@ -0,0 +1,409 @@
+"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.extractBilingualActorsFromRecord = extractBilingualActorsFromRecord;
+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) ────────────────────────────────────────
+/** Pull bilingual actor fields from joined relations on workflow/chat rows. */
+function extractBilingualActorsFromRecord(record) {
+    const role = (record.approver_role ?? record.role);
+    const user = (record.approver_user ?? record.user);
+    const dept = (record.approver_department ?? record.department);
+    const section = (record.approver_section ?? record.section);
+    return {
+        roleName: role?.name != null ? String(role.name) : null,
+        roleArabicName: role?.arabic_name != null ? String(role.arabic_name) : null,
+        deptName: dept?.department_name != null ? String(dept.department_name) : null,
+        deptArabicName: dept?.department_arabic_name != null ? String(dept.department_arabic_name) : null,
+        sectionName: section?.section_name != null ? String(section.section_name) : null,
+        sectionArabicName: section?.section_arabic_name != null ? String(section.section_arabic_name) : null,
+        userName: user?.employee_name != null ? String(user.employee_name) : null,
+        userArabicName: user?.employee_arabic_name != null ? String(user.employee_arabic_name) : null,
+        employeeId: user?.employee_id != null ? String(user.employee_id) : null,
+    };
+}
+/** Arabic actor label for workflow templates (role, dept+section, or user). */
+function resolveArabicWorkflowActorName(actors, parsedEnglishName) {
+    if (actors) {
+        const { ar } = resolveActorDisplayNames(actors);
+        if (ar)
+            return ar;
+        if (actors.userName?.trim()) {
+            return resolveBilingualName(actors.userName, actors.userArabicName);
+        }
+    }
+    return parsedEnglishName?.trim() || '';
+}
+/** Arabic role/user label for chat templates. */
+function resolveArabicChatRoleName(actors, parsedEnglishRole) {
+    if (actors?.roleName?.trim()) {
+        return resolveBilingualName(actors.roleName, actors.roleArabicName);
+    }
+    if (actors?.userName?.trim()) {
+        return resolveBilingualName(actors.userName, actors.userArabicName);
+    }
+    return resolveBilingualName(parsedEnglishRole, actors?.roleArabicName);
+}
+function resolveWorkflowContentAr(content, actors) {
+    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 namePartEn = baseEn.slice(staticPrefix.length).trim();
+                    const nameAr = resolveArabicWorkflowActorName(actors, namePartEn);
+                    return interpolate(tpl.ar, { name: nameAr, 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 namePartEn = normalized.slice(inProgressPrefix.length).trim();
+        const nameAr = resolveArabicWorkflowActorName(actors, namePartEn);
+        return interpolate(WORKFLOW_TEMPLATES.request_approval_in_progress_from.ar, { name: nameAr });
+    }
+    const pendingPrefix = WORKFLOW_TEMPLATES.request_approval_pending_from?.en.split('{{name}}')[0].trim();
+    if (pendingPrefix && normalized.startsWith(pendingPrefix)) {
+        const namePartEn = normalized.slice(pendingPrefix.length).trim();
+        const nameAr = resolveArabicWorkflowActorName(actors, namePartEn);
+        return interpolate(WORKFLOW_TEMPLATES.request_approval_pending_from.ar, { name: nameAr });
+    }
+    return null;
+}
+function resolveChatMessageAr(message, actors) {
+    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;
+    }
+    const submittedTpl = CHAT_TEMPLATES.cancellation_submitted_by;
+    if (submittedTpl) {
+        const prefix = submittedTpl.en.split('{{userName}}')[0];
+        if (normalized.startsWith(prefix)) {
+            const afterPrefix = normalized.slice(prefix.length);
+            const parenMatch = afterPrefix.match(/^(.+?) \((.+)\)$/);
+            if (parenMatch) {
+                const userEn = parenMatch[1].trim();
+                const employeeId = parenMatch[2].trim();
+                const userAr = actors?.userName?.trim()
+                    ? resolveBilingualName(actors.userName, actors.userArabicName)
+                    : resolveBilingualName(userEn, actors?.userArabicName);
+                return interpolate(submittedTpl.ar, { userName: userAr, employeeId });
+            }
+        }
+    }
+    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(' - ');
+        const roleNameEn = commentIdx >= 0 ? rest.slice(0, commentIdx) : rest;
+        const commentSuffix = commentIdx >= 0 ? rest.slice(commentIdx) : '';
+        const roleNameAr = resolveArabicChatRoleName(actors, roleNameEn.trim());
+        return interpolate(tpl.ar, { roleName: roleNameAr, comment: commentSuffix });
+    }
+    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;
+    const actors = extractBilingualActorsFromRecord(log);
+    return {
+        ...log,
+        content_ar: log.content_ar ?? resolveWorkflowContentAr(content, actors),
+        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;
+    const actors = extractBilingualActorsFromRecord(chat);
+    return {
+        ...chat,
+        message_ar: chat.message_ar ?? resolveChatMessageAr(message, actors),
+        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.280",
+ "version": "2.3.282",
  "main": "dist/index.js",
  "types": "dist/index.d.ts",
   "scripts": {