grm-shared-library 1.1.202 → 1.1.203

package/dist/esm/modules/support/utils/support-feedback.util.js

@@ -0,0 +1,60 @@
+import { SUPPORT_FEEDBACK_RATING } from '../constants/support-defaults.const';
+import { CustomerFeedbackSentiment, CustomerFeedbackType, RATING_CUSTOMER_FEEDBACK_TYPES, } from '../enums/support-feedback.enum';
+/** Whether this kind of feedback carries a star rating. */
+export function feedbackTypeRequiresRating(type) {
+    return RATING_CUSTOMER_FEEDBACK_TYPES.includes(type);
+}
+/**
+ * Derive sentiment from the feedback TYPE and rating.
+ *
+ * Never from the message text. An automated reading of "the guard never came"
+ * that lands on POSITIVE is worse than no reading at all, and a support desk
+ * that starts distrusting one column stops trusting the dashboard. When a real
+ * classifier is added it writes this same field, and the rule below becomes its
+ * fallback rather than being replaced.
+ */
+export function deriveFeedbackSentiment(type, rating) {
+    if (rating != null && Number.isFinite(rating)) {
+        if (rating <= SUPPORT_FEEDBACK_RATING.NEGATIVE_AT_OR_BELOW) {
+            return CustomerFeedbackSentiment.NEGATIVE;
+        }
+        if (rating >= SUPPORT_FEEDBACK_RATING.POSITIVE_AT_OR_ABOVE) {
+            return CustomerFeedbackSentiment.POSITIVE;
+        }
+        return CustomerFeedbackSentiment.NEUTRAL;
+    }
+    switch (type) {
+        case CustomerFeedbackType.COMPLIMENT:
+            return CustomerFeedbackSentiment.POSITIVE;
+        case CustomerFeedbackType.COMPLAINT:
+        case CustomerFeedbackType.BUG_REPORT:
+            return CustomerFeedbackSentiment.NEGATIVE;
+        case CustomerFeedbackType.FEATURE_REQUEST:
+        case CustomerFeedbackType.GENERAL:
+            return CustomerFeedbackSentiment.NEUTRAL;
+        default:
+            return CustomerFeedbackSentiment.UNKNOWN;
+    }
+}
+/** Whether a rating is inside the allowed range. */
+export function isValidFeedbackRating(rating) {
+    if (typeof rating !== 'number' || !Number.isFinite(rating))
+        return false;
+    if (!Number.isInteger(rating))
+        return false;
+    return rating >= SUPPORT_FEEDBACK_RATING.MIN && rating <= SUPPORT_FEEDBACK_RATING.MAX;
+}
+/**
+ * Whether a piece of feedback is the kind an agent should probably act on.
+ *
+ * Advisory only - it drives a hint in the admin, never an automatic conversion.
+ * Promoting somebody's complaint into a ticket without a human deciding is how a
+ * queue fills with work nobody chose to take on.
+ */
+export function feedbackWarrantsTicket(type, rating) {
+    if (type === CustomerFeedbackType.BUG_REPORT || type === CustomerFeedbackType.COMPLAINT) {
+        return true;
+    }
+    return rating != null && rating <= SUPPORT_FEEDBACK_RATING.NEGATIVE_AT_OR_BELOW;
+}
+//# sourceMappingURL=support-feedback.util.js.map

package/dist/esm/modules/support/utils/support-feedback.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-feedback.util.js","sourceRoot":"","sources":["../../../../../src/modules/support/utils/support-feedback.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EACH,yBAAyB,EACzB,oBAAoB,EACpB,8BAA8B,GACjC,MAAM,gCAAgC,CAAC;AAExC,2DAA2D;AAC3D,MAAM,UAAU,0BAA0B,CAAC,IAA0B;IACjE,OAAO,8BAA8B,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CACnC,IAA0B,EAC1B,MAAsB;IAEtB,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,IAAI,MAAM,IAAI,uBAAuB,CAAC,oBAAoB,EAAE,CAAC;YACzD,OAAO,yBAAyB,CAAC,QAAQ,CAAC;QAC9C,CAAC;QACD,IAAI,MAAM,IAAI,uBAAuB,CAAC,oBAAoB,EAAE,CAAC;YACzD,OAAO,yBAAyB,CAAC,QAAQ,CAAC;QAC9C,CAAC;QACD,OAAO,yBAAyB,CAAC,OAAO,CAAC;IAC7C,CAAC;IAED,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,oBAAoB,CAAC,UAAU;YAChC,OAAO,yBAAyB,CAAC,QAAQ,CAAC;QAC9C,KAAK,oBAAoB,CAAC,SAAS,CAAC;QACpC,KAAK,oBAAoB,CAAC,UAAU;YAChC,OAAO,yBAAyB,CAAC,QAAQ,CAAC;QAC9C,KAAK,oBAAoB,CAAC,eAAe,CAAC;QAC1C,KAAK,oBAAoB,CAAC,OAAO;YAC7B,OAAO,yBAAyB,CAAC,OAAO,CAAC;QAC7C;YACI,OAAO,yBAAyB,CAAC,OAAO,CAAC;IACjD,CAAC;AACL,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,qBAAqB,CAAC,MAAe;IACjD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACzE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,MAAM,IAAI,uBAAuB,CAAC,GAAG,IAAI,MAAM,IAAI,uBAAuB,CAAC,GAAG,CAAC;AAC1F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAClC,IAA0B,EAC1B,MAAsB;IAEtB,IAAI,IAAI,KAAK,oBAAoB,CAAC,UAAU,IAAI,IAAI,KAAK,oBAAoB,CAAC,SAAS,EAAE,CAAC;QACtF,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,uBAAuB,CAAC,oBAAoB,CAAC;AACpF,CAAC"}

package/dist/esm/modules/support/utils/support-redaction.util.js

@@ -0,0 +1,164 @@
+import { SUPPORT_FIELD_LIMITS } from '../constants/support-defaults.const';
+/**
+ * Mask an identifier for logging: enough to correlate, never enough to reuse.
+ * `+254712345678` becomes `+254***5678`.
+ */
+export function maskSupportIdentifier(value) {
+    if (value == null)
+        return 'unknown';
+    const raw = String(value).trim();
+    if (raw === '')
+        return 'unknown';
+    if (raw.length <= 8)
+        return `${raw.slice(0, 2)}***`;
+    return `${raw.slice(0, 4)}***${raw.slice(-4)}`;
+}
+/**
+ * Reduce a URL to scheme and host.
+ *
+ * A helpdesk URL routinely carries an API token in its query string, and a URL
+ * is the single most-logged value in an HTTP client.
+ */
+export function maskSupportUrl(value) {
+    if (value == null)
+        return 'unknown';
+    const raw = String(value).trim();
+    if (raw === '')
+        return 'unknown';
+    try {
+        const url = new URL(raw);
+        return `${url.protocol}//${url.host}${url.pathname}`;
+    }
+    catch {
+        return raw.split('?')[0];
+    }
+}
+/**
+ * Replace anything credential- or PII-shaped in free text.
+ *
+ * Applied to every provider message before it is stored or logged. It is a
+ * belt-and-braces pass on top of key-based redaction: a helpdesk that puts a
+ * token in a prose error defeats key matching, and that message still ends up
+ * in a table an operator can read.
+ */
+export function scrubSupportText(input) {
+    return String(input !== null && input !== void 0 ? input : '')
+        .replace(/Bearer\s+[A-Za-z0-9._-]+/gi, 'Bearer [REDACTED]')
+        .replace(/Token\s+token=[A-Za-z0-9._-]+/gi, 'Token token=[REDACTED]')
+        .replace(/\b(sk|pk)_(test|prod|live)_[A-Za-z0-9_-]+/gi, '[REDACTED]')
+        .replace(/\beyJ[A-Za-z0-9._-]{10,}/g, '[REDACTED]')
+        .replace(/\+[1-9]\d{9,14}\b/g, (match) => maskSupportIdentifier(match));
+}
+/** Keys whose VALUE is redacted wherever it appears in a payload, at any depth. */
+const SENSITIVE_SUPPORT_KEYS = [
+    'password',
+    'passwd',
+    'secret',
+    'token',
+    'apikey',
+    'api_key',
+    'apitoken',
+    'api_token',
+    'authorization',
+    'auth',
+    'credential',
+    'accesstoken',
+    'access_token',
+    'refreshtoken',
+    'refresh_token',
+    'otp',
+    'pin',
+    'signature',
+    'privatekey',
+    'private_key',
+    'sessionid',
+    'session_id',
+    'cookie',
+    'setcookie',
+    'set_cookie',
+];
+function isSensitiveSupportKey(key) {
+    const normalized = key.toLowerCase().replace(/[^a-z_]/g, '');
+    return SENSITIVE_SUPPORT_KEYS.some((candidate) => normalized.includes(candidate.replace(/_/g, '')));
+}
+/**
+ * Redact a payload by key before it is persisted on a synchronization row or an
+ * audit entry.
+ *
+ * Depth-bounded, because a provider can return an arbitrarily nested object and
+ * an audit writer must not be a place a stack overflow can happen. Anything
+ * past the bound is replaced with a marker rather than dropped silently.
+ */
+export function sanitizeSupportPayload(value, depth = 0) {
+    if (depth > 6)
+        return '[TRUNCATED]';
+    if (value == null)
+        return value;
+    if (Array.isArray(value)) {
+        return value.slice(0, 50).map((item) => sanitizeSupportPayload(item, depth + 1));
+    }
+    if (typeof value === 'object') {
+        const source = value;
+        const result = {};
+        for (const key of Object.keys(source)) {
+            result[key] = isSensitiveSupportKey(key)
+                ? '[REDACTED]'
+                : sanitizeSupportPayload(source[key], depth + 1);
+        }
+        return result;
+    }
+    if (typeof value === 'string')
+        return scrubSupportText(value);
+    return value;
+}
+/**
+ * Trim a value to a limit without ever throwing.
+ *
+ * A support message that runs long is truncated and still sent. Refusing to
+ * record what a customer said because it exceeded a column width would lose the
+ * thing the whole domain exists to capture.
+ */
+export function truncateForSupport(value, maxLength) {
+    if (value == null)
+        return undefined;
+    const trimmed = String(value).trim();
+    if (trimmed === '')
+        return undefined;
+    return trimmed.length <= maxLength ? trimmed : trimmed.slice(0, maxLength);
+}
+/**
+ * A one-line preview of a longer body, for list rows.
+ *
+ * Newlines collapse to spaces so a multi-line message cannot break a table row,
+ * and the result is ellipsised rather than hard-cut so a reader can tell there
+ * is more.
+ */
+export function previewSupportText(value, maxLength = 140) {
+    const collapsed = String(value !== null && value !== void 0 ? value : '')
+        .replace(/\s+/g, ' ')
+        .trim();
+    if (collapsed.length <= maxLength)
+        return collapsed;
+    return `${collapsed.slice(0, Math.max(0, maxLength - 1))}…`;
+}
+/** A provider response body reduced to something safe and small enough to keep. */
+export function snapshotSupportPayload(body) {
+    var _a;
+    if (body == null || typeof body !== 'object')
+        return null;
+    const redacted = sanitizeSupportPayload(body);
+    const serialized = (_a = JSON.stringify(redacted)) !== null && _a !== void 0 ? _a : '';
+    if (serialized.length > SUPPORT_FIELD_LIMITS.SYNC_SNAPSHOT_MAX_LENGTH) {
+        return {
+            truncated: true,
+            preview: serialized.slice(0, SUPPORT_FIELD_LIMITS.SYNC_SNAPSHOT_MAX_LENGTH),
+        };
+    }
+    try {
+        return JSON.parse(serialized);
+    }
+    catch {
+        return { unparsed: serialized };
+    }
+}
+//# sourceMappingURL=support-redaction.util.js.map

package/dist/esm/modules/support/utils/support-redaction.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-redaction.util.js","sourceRoot":"","sources":["../../../../../src/modules/support/utils/support-redaction.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAE3E;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAgC;IAClE,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IACpC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACjC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC;IACpD,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAgC;IAC3D,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IACpC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACjC,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACzB,OAAO,GAAG,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAgC;IAC7D,OAAO,MAAM,CAAC,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,CAAC;SACrB,OAAO,CAAC,4BAA4B,EAAE,mBAAmB,CAAC;SAC1D,OAAO,CAAC,iCAAiC,EAAE,wBAAwB,CAAC;SACpE,OAAO,CAAC,6CAA6C,EAAE,YAAY,CAAC;SACpE,OAAO,CAAC,2BAA2B,EAAE,YAAY,CAAC;SAClD,OAAO,CAAC,oBAAoB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,mFAAmF;AACnF,MAAM,sBAAsB,GAAG;IAC3B,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,SAAS;IACT,UAAU;IACV,WAAW;IACX,eAAe;IACf,MAAM;IACN,YAAY;IACZ,aAAa;IACb,cAAc;IACd,cAAc;IACd,eAAe;IACf,KAAK;IACL,KAAK;IACL,WAAW;IACX,YAAY;IACZ,aAAa;IACb,WAAW;IACX,YAAY;IACZ,QAAQ;IACR,WAAW;IACX,YAAY;CACf,CAAC;AAEF,SAAS,qBAAqB,CAAC,GAAW;IACtC,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC7D,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AACxG,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc,EAAE,KAAK,GAAG,CAAC;IAC5D,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,aAAa,CAAC;IACpC,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,MAAM,CAAC,GAAG,CAAC,GAAG,qBAAqB,CAAC,GAAG,CAAC;gBACpC,CAAC,CAAC,YAAY;gBACd,CAAC,CAAC,sBAAsB,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC9D,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAC9B,KAAgC,EAChC,SAAiB;IAEjB,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IACpC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACrC,OAAO,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAgC,EAAE,SAAS,GAAG,GAAG;IAChF,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,CAAC;SAChC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;IACZ,IAAI,SAAS,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IACpD,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AAChE,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,sBAAsB,CAAC,IAAa;;IAChD,IAAI,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1D,MAAM,QAAQ,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,MAAA,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,mCAAI,EAAE,CAAC;IAClD,IAAI,UAAU,CAAC,MAAM,GAAG,oBAAoB,CAAC,wBAAwB,EAAE,CAAC;QACpE,OAAO;YACH,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,wBAAwB,CAAC;SAC9E,CAAC;IACN,CAAC;IACD,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAA4B,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IACpC,CAAC;AACL,CAAC"}

package/dist/esm/modules/support/utils/support-routing.util.js

@@ -0,0 +1,82 @@
+import { SupportRoutingMatchType } from '../enums/support-routing.enum';
+/** Whether one rule matches one ticket. */
+export function supportRoutingRuleMatches(rule, subject) {
+    if (!rule.active)
+        return false;
+    if (rule.organizationId !== subject.organizationId)
+        return false;
+    switch (rule.matchType) {
+        case SupportRoutingMatchType.ANY:
+            return true;
+        case SupportRoutingMatchType.CATEGORY:
+            return !!rule.matchCategoryId && rule.matchCategoryId === subject.categoryId;
+        case SupportRoutingMatchType.PRIORITY:
+            return !!rule.matchPriority && rule.matchPriority === subject.priority;
+        case SupportRoutingMatchType.CHANNEL:
+            return !!rule.matchChannel && rule.matchChannel === subject.channel;
+        case SupportRoutingMatchType.COUNTRY:
+            return !!rule.matchCountryCode && rule.matchCountryCode === subject.countryCode;
+        case SupportRoutingMatchType.CONTROL_CENTRE:
+            return (rule.matchControlCentreId != null &&
+                rule.matchControlCentreId === subject.controlCentreId);
+        case SupportRoutingMatchType.APP_ID:
+            return !!rule.matchAppId && rule.matchAppId === subject.appId;
+        case SupportRoutingMatchType.RELATED_ENTITY_TYPE:
+            return (!!rule.matchRelatedEntityType &&
+                subject.relatedEntityTypes.includes(rule.matchRelatedEntityType));
+        default:
+            // An unrecognised match type never matches. A rule the running code
+            // does not understand must not silently become a catch-all.
+            return false;
+    }
+}
+/**
+ * Pick a queue.
+ *
+ * Rules are sorted by ascending `priority` and the FIRST match wins. No
+ * scoring, no weighting, no learning: an operator has to be able to answer "why
+ * did this land here?" by reading the table, and a routing decision nobody can
+ * explain is one nobody can fix at 2am.
+ *
+ * Ties on `priority` are broken by rule id, so the same inputs always produce
+ * the same answer - a routing engine whose output depends on row order is a
+ * routing engine that cannot be tested.
+ */
+export function decideSupportQueue(rules, subject, fallbackQueueId) {
+    var _a;
+    const ordered = [...rules].sort((left, right) => {
+        if (left.priority !== right.priority)
+            return left.priority - right.priority;
+        return left.id.localeCompare(right.id);
+    });
+    for (const rule of ordered) {
+        if (supportRoutingRuleMatches(rule, subject)) {
+            return {
+                queueId: rule.targetQueueId,
+                ruleId: rule.id,
+                ruleName: rule.name,
+                forcedPriority: (_a = rule.forcePriority) !== null && _a !== void 0 ? _a : null,
+            };
+        }
+    }
+    return {
+        queueId: fallbackQueueId !== null && fallbackQueueId !== void 0 ? fallbackQueueId : null,
+        ruleId: null,
+        ruleName: null,
+        forcedPriority: null,
+    };
+}
+/**
+ * The priority a new ticket should start at.
+ *
+ * A rule may raise a priority and never lower one. A customer who says their
+ * panic button is broken has told us something a routing table cannot know
+ * better than they do, and quietly downgrading them is the failure mode this
+ * rule exists to prevent.
+ */
+export function applyForcedPriority(requested, forced, rank) {
+    if (!forced)
+        return requested;
+    return rank[forced] < rank[requested] ? forced : requested;
+}
+//# sourceMappingURL=support-routing.util.js.map

package/dist/esm/modules/support/utils/support-routing.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-routing.util.js","sourceRoot":"","sources":["../../../../../src/modules/support/utils/support-routing.util.ts"],"names":[],"mappings":"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"}

package/dist/esm/modules/support/utils/support-sla.util.js

@@ -0,0 +1,229 @@
+import { SUPPORTED_COUNTRIES_BY_CODE } from '../../country/constants/supported-countries.const';
+import { DEFAULT_TIMEZONE } from '../../country/constants/country-defaults.const';
+import { SUPPORT_BUSINESS_CALENDAR_DEFAULTS, SUPPORT_SLA_DEFAULTS, SUPPORT_SLA_WARNING_THRESHOLD_RATIO, } from '../constants/support-defaults.const';
+import { SupportSlaClock, SupportSlaState } from '../enums/support-sla.enum';
+/** Safety bound on the day-by-day walk, so a misconfigured calendar cannot hang a request. */
+const MAX_CALENDAR_DAYS = 400;
+/**
+ * The timezone a country's working hours are measured in.
+ *
+ * Read from the country configuration rather than from the server clock. Every
+ * supported country happens to sit at UTC+3 today; writing it this way is what
+ * stops that being an assumption baked into a deadline.
+ */
+export function timezoneForCountry(countryCode) {
+    var _a;
+    if (!countryCode)
+        return DEFAULT_TIMEZONE;
+    const config = SUPPORTED_COUNTRIES_BY_CODE[countryCode];
+    return (_a = config === null || config === void 0 ? void 0 : config.timezone) !== null && _a !== void 0 ? _a : DEFAULT_TIMEZONE;
+}
+/**
+ * The zone's UTC offset, in minutes, at a given instant.
+ *
+ * Derived through Intl rather than hard-coded, so a zone that observes daylight
+ * saving is handled correctly away from the transition itself. At the exact
+ * hour of a transition the result can be off by the shift; that is a documented
+ * limitation, and it does not arise for KE, UG or TZ, none of which observe DST.
+ */
+function zoneOffsetMinutes(instant, timeZone) {
+    const formatter = new Intl.DateTimeFormat('en-US', {
+        timeZone,
+        hourCycle: 'h23',
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+    });
+    const parts = {};
+    for (const part of formatter.formatToParts(instant)) {
+        if (part.type !== 'literal')
+            parts[part.type] = part.value;
+    }
+    const asUtc = Date.UTC(Number(parts.year), Number(parts.month) - 1, Number(parts.day), Number(parts.hour), Number(parts.minute), Number(parts.second));
+    return Math.round((asUtc - instant.getTime()) / 60000);
+}
+function zonedParts(instant, timeZone) {
+    const offset = zoneOffsetMinutes(instant, timeZone);
+    const shifted = new Date(instant.getTime() + offset * 60000);
+    const isoWeekday = shifted.getUTCDay() === 0 ? 7 : shifted.getUTCDay();
+    const year = shifted.getUTCFullYear();
+    const month = shifted.getUTCMonth() + 1;
+    const day = shifted.getUTCDate();
+    return {
+        year,
+        month,
+        day,
+        minuteOfDay: shifted.getUTCHours() * 60 + shifted.getUTCMinutes(),
+        isoWeekday,
+        isoDate: `${year}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}`,
+    };
+}
+/** The instant at which a given local wall-clock time occurs in a zone. */
+function instantFromZonedWallTime(year, month, day, minuteOfDay, timeZone) {
+    const naive = Date.UTC(year, month - 1, day, 0, minuteOfDay);
+    // Two passes: the first offset is read at the naive instant, the second at
+    // the corrected one, which settles any case where the correction crosses a
+    // transition boundary.
+    let offset = zoneOffsetMinutes(new Date(naive), timeZone);
+    let instant = naive - offset * 60000;
+    offset = zoneOffsetMinutes(new Date(instant), timeZone);
+    instant = naive - offset * 60000;
+    return new Date(instant);
+}
+/** The calendar in force, falling back to the platform default. */
+export function resolveBusinessCalendar(calendar, countryCode) {
+    var _a, _b, _c, _d;
+    return {
+        workingDays: ((_a = calendar === null || calendar === void 0 ? void 0 : calendar.workingDays) === null || _a === void 0 ? void 0 : _a.length)
+            ? [...calendar.workingDays]
+            : [...SUPPORT_BUSINESS_CALENDAR_DEFAULTS.workingDays],
+        startMinuteOfDay: (_b = calendar === null || calendar === void 0 ? void 0 : calendar.startMinuteOfDay) !== null && _b !== void 0 ? _b : SUPPORT_BUSINESS_CALENDAR_DEFAULTS.startMinuteOfDay,
+        endMinuteOfDay: (_c = calendar === null || calendar === void 0 ? void 0 : calendar.endMinuteOfDay) !== null && _c !== void 0 ? _c : SUPPORT_BUSINESS_CALENDAR_DEFAULTS.endMinuteOfDay,
+        timezone: (_d = calendar === null || calendar === void 0 ? void 0 : calendar.timezone) !== null && _d !== void 0 ? _d : timezoneForCountry(countryCode),
+        holidays: (calendar === null || calendar === void 0 ? void 0 : calendar.holidays) ? [...calendar.holidays] : [],
+    };
+}
+function isWorkingDay(parts, calendar) {
+    if (!calendar.workingDays.includes(parts.isoWeekday))
+        return false;
+    return !calendar.holidays.includes(parts.isoDate);
+}
+/**
+ * Add working minutes to an instant.
+ *
+ * Walks day by day rather than doing arithmetic on a whole-week average,
+ * because holidays and a partial first day make the average wrong exactly when
+ * it matters - the ticket raised at 16:55 on the day before a public holiday.
+ *
+ * A calendar with no working days, or a zero-length window, degrades to
+ * calendar time rather than looping: a misconfigured calendar must not be able
+ * to hang the request that creates a ticket.
+ */
+export function addBusinessMinutes(start, minutes, calendar) {
+    if (minutes <= 0)
+        return new Date(start.getTime());
+    const windowLength = calendar.endMinuteOfDay - calendar.startMinuteOfDay;
+    if (windowLength <= 0 || calendar.workingDays.length === 0) {
+        return new Date(start.getTime() + minutes * 60000);
+    }
+    let remaining = minutes;
+    let cursor = new Date(start.getTime());
+    for (let guard = 0; guard < MAX_CALENDAR_DAYS; guard += 1) {
+        const parts = zonedParts(cursor, calendar.timezone);
+        if (!isWorkingDay(parts, calendar)) {
+            cursor = nextDayWindowStart(parts, calendar);
+            continue;
+        }
+        const dayStart = instantFromZonedWallTime(parts.year, parts.month, parts.day, calendar.startMinuteOfDay, calendar.timezone);
+        const dayEnd = instantFromZonedWallTime(parts.year, parts.month, parts.day, calendar.endMinuteOfDay, calendar.timezone);
+        if (cursor.getTime() < dayStart.getTime())
+            cursor = dayStart;
+        if (cursor.getTime() >= dayEnd.getTime()) {
+            cursor = nextDayWindowStart(parts, calendar);
+            continue;
+        }
+        const availableMinutes = (dayEnd.getTime() - cursor.getTime()) / 60000;
+        if (remaining <= availableMinutes) {
+            return new Date(cursor.getTime() + remaining * 60000);
+        }
+        remaining -= availableMinutes;
+        cursor = nextDayWindowStart(parts, calendar);
+    }
+    // Past the safety bound the calendar is unusable; do not silently return a
+    // wrong deadline, return an honest calendar-time one.
+    return new Date(start.getTime() + minutes * 60000);
+}
+function nextDayWindowStart(parts, calendar) {
+    const nextDay = new Date(Date.UTC(parts.year, parts.month - 1, parts.day + 1));
+    return instantFromZonedWallTime(nextDay.getUTCFullYear(), nextDay.getUTCMonth() + 1, nextDay.getUTCDate(), calendar.startMinuteOfDay, calendar.timezone);
+}
+/** Working minutes between two instants. Used to account for paused time. */
+export function businessMinutesBetween(from, to, calendar) {
+    if (to.getTime() <= from.getTime())
+        return 0;
+    const windowLength = calendar.endMinuteOfDay - calendar.startMinuteOfDay;
+    if (windowLength <= 0 || calendar.workingDays.length === 0) {
+        return (to.getTime() - from.getTime()) / 60000;
+    }
+    let total = 0;
+    let cursor = new Date(from.getTime());
+    for (let guard = 0; guard < MAX_CALENDAR_DAYS; guard += 1) {
+        if (cursor.getTime() >= to.getTime())
+            break;
+        const parts = zonedParts(cursor, calendar.timezone);
+        if (!isWorkingDay(parts, calendar)) {
+            cursor = nextDayWindowStart(parts, calendar);
+            continue;
+        }
+        const dayStart = instantFromZonedWallTime(parts.year, parts.month, parts.day, calendar.startMinuteOfDay, calendar.timezone);
+        const dayEnd = instantFromZonedWallTime(parts.year, parts.month, parts.day, calendar.endMinuteOfDay, calendar.timezone);
+        const segmentStart = Math.max(cursor.getTime(), dayStart.getTime());
+        const segmentEnd = Math.min(to.getTime(), dayEnd.getTime());
+        if (segmentEnd > segmentStart)
+            total += (segmentEnd - segmentStart) / 60000;
+        cursor = nextDayWindowStart(parts, calendar);
+    }
+    return total;
+}
+/** The targets in force for a priority: queue policy, then organization policy, then defaults. */
+export function resolveSlaTargets(priority, policies) {
+    var _a;
+    for (const policy of policies) {
+        const target = (_a = policy === null || policy === void 0 ? void 0 : policy.targets) === null || _a === void 0 ? void 0 : _a.find((candidate) => candidate.priority === priority);
+        if (target) {
+            return {
+                firstResponseMinutes: target.firstResponseMinutes,
+                resolutionMinutes: target.resolutionMinutes,
+                clock: target.clock,
+            };
+        }
+    }
+    return SUPPORT_SLA_DEFAULTS[priority];
+}
+/** When a target elapses, measured on the right clock. */
+export function computeSlaDueAt(start, minutes, clock, calendar) {
+    if (clock === SupportSlaClock.CALENDAR) {
+        return new Date(start.getTime() + minutes * 60000);
+    }
+    return addBusinessMinutes(start, minutes, calendar);
+}
+/**
+ * Where a clock stands right now.
+ *
+ * Pure, and takes `now` as an argument rather than reading the clock, so the
+ * scheduler and the read path can never disagree about what time it is and so
+ * the whole thing is testable without freezing time.
+ */
+export function evaluateSlaState(input) {
+    var _a, _b;
+    const { now, dueAt, metAt, paused, stopped } = input;
+    if (metAt)
+        return SupportSlaState.MET;
+    if (!dueAt)
+        return SupportSlaState.NOT_APPLICABLE;
+    if (stopped) {
+        return now.getTime() > dueAt.getTime() ? SupportSlaState.BREACHED : SupportSlaState.MET;
+    }
+    if (paused)
+        return SupportSlaState.PAUSED;
+    if (now.getTime() > dueAt.getTime())
+        return SupportSlaState.BREACHED;
+    const targetMinutes = (_a = input.targetMinutes) !== null && _a !== void 0 ? _a : null;
+    const ratio = (_b = input.warningRatio) !== null && _b !== void 0 ? _b : SUPPORT_SLA_WARNING_THRESHOLD_RATIO;
+    if (targetMinutes && targetMinutes > 0) {
+        const warningAt = dueAt.getTime() - targetMinutes * (1 - ratio) * 60000;
+        if (now.getTime() >= warningAt)
+            return SupportSlaState.WARNING;
+    }
+    return SupportSlaState.ON_TRACK;
+}
+/** Minutes left before a deadline; negative once it has passed. */
+export function minutesUntil(now, dueAt) {
+    if (!dueAt)
+        return null;
+    return Math.round((dueAt.getTime() - now.getTime()) / 60000);
+}
+//# sourceMappingURL=support-sla.util.js.map

package/dist/esm/modules/support/utils/support-sla.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-sla.util.js","sourceRoot":"","sources":["../../../../../src/modules/support/utils/support-sla.util.ts"],"names":[],"mappings":"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"}

package/dist/esm/modules/support/utils/support-status.util.js

@@ -0,0 +1,81 @@
+import { CUSTOMER_FEEDBACK_TRANSITIONS, } from '../enums/support-feedback.enum';
+import { ACTIVE_SUPPORT_TICKET_STATUSES, SLA_PAUSED_SUPPORT_TICKET_STATUSES, SLA_STOPPED_SUPPORT_TICKET_STATUSES, SUPPORT_TICKET_TRANSITIONS, SupportTicketStatus, TERMINAL_SUPPORT_TICKET_STATUSES, } from '../enums/support-ticket-status.enum';
+/**
+ * Whether a ticket may move from one state to another.
+ *
+ * The single authority. Controllers, services, webhook handlers and the
+ * reconciliation job all ask this rather than each carrying their own idea of
+ * what is legal - which is what stops a provider webhook quietly doing
+ * something no Clarion user could do.
+ *
+ * A move to the SAME state is allowed and is a no-op, because a provider that
+ * re-sends its current status should not be an error.
+ */
+export function canTransitionSupportTicket(from, to) {
+    if (from === to)
+        return true;
+    const allowed = SUPPORT_TICKET_TRANSITIONS[from];
+    return Array.isArray(allowed) && allowed.includes(to);
+}
+/** The states a ticket may legally move to right now. Drives the admin's buttons. */
+export function allowedSupportTicketTransitions(from) {
+    var _a;
+    return (_a = SUPPORT_TICKET_TRANSITIONS[from]) !== null && _a !== void 0 ? _a : [];
+}
+export function isTerminalSupportTicketStatus(status) {
+    return TERMINAL_SUPPORT_TICKET_STATUSES.includes(status);
+}
+export function isActiveSupportTicketStatus(status) {
+    return ACTIVE_SUPPORT_TICKET_STATUSES.includes(status);
+}
+/** True while an SLA clock should be stopped but may still resume. */
+export function isSlaPausedStatus(status) {
+    return SLA_PAUSED_SUPPORT_TICKET_STATUSES.includes(status);
+}
+/** True once the clocks stop for good. */
+export function isSlaStoppedStatus(status) {
+    return SLA_STOPPED_SUPPORT_TICKET_STATUSES.includes(status);
+}
+/**
+ * Whether a customer may reply on a ticket in this state.
+ *
+ * A CANCELLED ticket is closed to further conversation; everything else, CLOSED
+ * included, accepts a reply - and a reply to a closed ticket reopens it, which
+ * is what a customer expects and what stops them raising a duplicate.
+ */
+export function customerMayReply(status) {
+    return status !== SupportTicketStatus.CANCELLED;
+}
+/**
+ * The state a customer reply should move a ticket into, or null to leave it.
+ *
+ * CLOSED becomes REOPENED, which is counted. RESOLVED goes back to IN_PROGRESS,
+ * which is not - the ticket was never finished from the customer's point of
+ * view, and calling that a reopen would inflate the reopen rate with tickets
+ * that simply were not fixed yet. WAITING_ON_CUSTOMER becomes IN_PROGRESS,
+ * because the wait is over.
+ */
+export function statusAfterCustomerReply(status) {
+    switch (status) {
+        case SupportTicketStatus.CLOSED:
+            return SupportTicketStatus.REOPENED;
+        case SupportTicketStatus.RESOLVED:
+        case SupportTicketStatus.WAITING_ON_CUSTOMER:
+            return SupportTicketStatus.IN_PROGRESS;
+        default:
+            return null;
+    }
+}
+/** Whether a piece of feedback may move from one state to another. */
+export function canTransitionCustomerFeedback(from, to) {
+    if (from === to)
+        return true;
+    const allowed = CUSTOMER_FEEDBACK_TRANSITIONS[from];
+    return Array.isArray(allowed) && allowed.includes(to);
+}
+/** The states a piece of feedback may legally move to right now. */
+export function allowedCustomerFeedbackTransitions(from) {
+    var _a;
+    return (_a = CUSTOMER_FEEDBACK_TRANSITIONS[from]) !== null && _a !== void 0 ? _a : [];
+}
+//# sourceMappingURL=support-status.util.js.map

package/dist/esm/modules/support/utils/support-status.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-status.util.js","sourceRoot":"","sources":["../../../../../src/modules/support/utils/support-status.util.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,6BAA6B,GAEhC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACH,8BAA8B,EAC9B,kCAAkC,EAClC,mCAAmC,EACnC,0BAA0B,EAC1B,mBAAmB,EACnB,gCAAgC,GACnC,MAAM,qCAAqC,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,0BAA0B,CACtC,IAAyB,EACzB,EAAuB;IAEvB,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,OAAO,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,+BAA+B,CAC3C,IAAyB;;IAEzB,OAAO,MAAA,0BAA0B,CAAC,IAAI,CAAC,mCAAI,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,MAA2B;IACrE,OAAO,gCAAgC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,MAA2B;IACnE,OAAO,8BAA8B,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC3D,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,iBAAiB,CAAC,MAA2B;IACzD,OAAO,kCAAkC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC/D,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,kBAAkB,CAAC,MAA2B;IAC1D,OAAO,mCAAmC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA2B;IACxD,OAAO,MAAM,KAAK,mBAAmB,CAAC,SAAS,CAAC;AACpD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CACpC,MAA2B;IAE3B,QAAQ,MAAM,EAAE,CAAC;QACb,KAAK,mBAAmB,CAAC,MAAM;YAC3B,OAAO,mBAAmB,CAAC,QAAQ,CAAC;QACxC,KAAK,mBAAmB,CAAC,QAAQ,CAAC;QAClC,KAAK,mBAAmB,CAAC,mBAAmB;YACxC,OAAO,mBAAmB,CAAC,WAAW,CAAC;QAC3C;YACI,OAAO,IAAI,CAAC;IACpB,CAAC;AACL,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,6BAA6B,CACzC,IAA4B,EAC5B,EAA0B;IAE1B,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,OAAO,GAAG,6BAA6B,CAAC,IAAI,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,kCAAkC,CAC9C,IAA4B;;IAE5B,OAAO,MAAA,6BAA6B,CAAC,IAAI,CAAC,mCAAI,EAAE,CAAC;AACrD,CAAC"}