@opencxh/domain 1.16.0 → 1.18.0

package/dist/entities/channel/types.d.ts

@@ -1,4 +1,4 @@
-import { Uri } from '../../platform/communication';
+import { Capability, Uri } from '../../platform/communication';
 export interface Channel {
     id: string;
     organizationId: string;
@@ -12,6 +12,7 @@ export interface Channel {
     ownerId: string;
     externalIds?: string[];
     settings: Record<string, any>;
+    capabilities?: Capability[];
     enabled: boolean;
     verified: boolean;
 }

package/dist/entities/contact/endpoints.d.ts

@@ -0,0 +1,6 @@
+import { Contact, ContactEndpoint } from './types';
+/**
+ * Returns the contact's communication endpoints, synthesising them from
+ * legacy phone/email fields when `endpoints` is not populated yet.
+ */
+export declare function getContactEndpoints(contact: Contact): ContactEndpoint[];

package/dist/entities/contact/index.d.ts

@@ -1 +1,2 @@
 export * from './types';
+export * from './endpoints';

package/dist/entities/contact/types.d.ts

@@ -1,3 +1,10 @@
+import { CommunicationScheme } from '../../platform/communication';
+export interface ContactEndpoint {
+    scheme: CommunicationScheme;
+    resource: string;
+    label?: string;
+    primary?: boolean;
+}
 /**
  * Data model for a single Contact.
  */
@@ -10,4 +17,5 @@ export interface Contact {
     email?: string;
     phone?: string;
     address?: string;
+    endpoints?: ContactEndpoint[];
 }

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=s=>!!s.assignedUserId||!!s.assignedInboxId,l=s=>s.status==="closed",g=s=>({urgent:10,high:5,normal:2,low:1})[s.priority]||0,d=(s,r=30)=>s.title.length<=r?s.title:`${s.title.substring(0,r)}...`;var t=(s=>(s.MAILTO="mailto",s.SIP="sip",s.TEL="tel",s.WEBHOOK="webhook",s.USERNAME="username",s.ID="id",s.CUSTOM="custom",s.URL="url",s.TELEGRAM="telegram",s.WHATSAPP="whatsapp",s.VIBER="viber",s.SMS="sms",s.FAX="fax",s.TEAMS="teams",s))(t||{});exports.CommunicationScheme=t;exports.getShortTitle=d;exports.getUrgencyScore=g;exports.isAssigned=e;exports.isClosed=l;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var o=(e=>(e.MAILTO="mailto",e.SIP="sip",e.TEL="tel",e.WEBHOOK="webhook",e.USERNAME="username",e.ID="id",e.CUSTOM="custom",e.URL="url",e.TELEGRAM="telegram",e.WHATSAPP="whatsapp",e.VIBER="viber",e.SMS="sms",e.FAX="fax",e.TEAMS="teams",e))(o||{});function h(e){if(e.endpoints&&e.endpoints.length>0)return e.endpoints;const s=[];return e.phone&&s.push({scheme:o.TEL,resource:e.phone,primary:!0}),e.email&&s.push({scheme:o.MAILTO,resource:e.email,primary:!e.phone}),s}const g=e=>!!e.assignedUserId||!!e.assignedInboxId,b=e=>e.status==="closed",T=e=>({urgent:10,high:5,normal:2,low:1})[e.priority]||0,v=(e,s=30)=>e.title.length<=s?e.title:`${e.title.substring(0,s)}...`,E={[o.TEL]:["call"],[o.SIP]:["call"],[o.MAILTO]:["mail"],[o.SMS]:["message"],[o.WHATSAPP]:["message"],[o.TELEGRAM]:["message"],[o.VIBER]:["message"],[o.TEAMS]:["call","message","video"],[o.FAX]:["message"]},p={call:"transport",video:"transport",message:"transport",mail:"compose"},u=["call","mail","message","video"];function a(e,s){if(!e.supportedSchemes.includes(s))return[];const n=e.capabilities.filter(t=>t.scheme===s&&t.value===!0&&u.includes(t.key));return n.length>0?n.map(t=>t.key):E[s]??[]}function d(e){const s=new Set;for(const n of e.supportedSchemes)for(const t of a(e,n))s.add(t);return Array.from(s)}function f(e,s,n){return e.capabilities.find(r=>r.scheme===s&&r.key===n&&r.value===!0)?.dispatch??p[n]}function A(e,s){return Object.entries(e).map(([n,t])=>({providerId:n,description:t,intents:d(t)}))}function y(e,s){const n=[];for(const t of e){if(!t.enabled)continue;const r=s[t.providerId];if(r){if(t.capabilities&&t.capabilities.length>0){for(const i of t.capabilities){if(!i.value||!u.includes(i.key))continue;const c=i.scheme,l=i.key;n.push({channel:t,description:r,scheme:c,intent:l,dispatch:i.dispatch??p[l]})}continue}for(const i of r.supportedSchemes){const c=a(r,i);for(const l of c)n.push({channel:t,description:r,scheme:i,intent:l,dispatch:f(r,i,l)})}}}return n}function I(e,s){return s.filter(n=>n.intents.includes(e))}function S(e,s){return s.filter(n=>n.description.supportedSchemes.includes(e.scheme))}function F(e,s,n){const t=[];for(const r of e)for(const i of n)i.description.supportedSchemes.includes(r.scheme)&&a(i.description,r.scheme).includes(s)&&t.push({capability:i,endpoint:r});return t}function M(e,s,n){const t=[];for(const r of e)for(const i of n)i.scheme===r.scheme&&i.intent===s&&t.push({capability:i,endpoint:r});return t}exports.CommunicationScheme=o;exports.buildChannelCapabilities=y;exports.buildResolvedCapabilities=A;exports.dispatchForCapability=f;exports.getContactEndpoints=h;exports.getShortTitle=v;exports.getUrgencyScore=T;exports.intentsForProvider=d;exports.intentsForScheme=a;exports.isAssigned=g;exports.isClosed=b;exports.resolveContactChannelCapabilities=M;exports.resolveForContact=F;exports.resolveForEndpoint=S;exports.resolveForIntent=I;

package/dist/index.d.ts

@@ -17,6 +17,7 @@ export * from './entities/transcript';
 export * from './entities/user';
 export * from './platform/api';
 export * from './platform/common';
+export * from './platform/capabilities';
 export * from './platform/communication';
 export * from './platform/federated';
 export * from './platform/intents';

package/dist/index.js

@@ -1,14 +1,125 @@
-const l = (s) => !!s.assignedUserId || !!s.assignedInboxId, g = (s) => s.status === "closed", d = (s) => ({
+var o = /* @__PURE__ */ ((e) => (e.MAILTO = "mailto", e.SIP = "sip", e.TEL = "tel", e.WEBHOOK = "webhook", e.USERNAME = "username", e.ID = "id", e.CUSTOM = "custom", e.URL = "url", e.TELEGRAM = "telegram", e.WHATSAPP = "whatsapp", e.VIBER = "viber", e.SMS = "sms", e.FAX = "fax", e.TEAMS = "teams", e))(o || {});
+function g(e) {
+  if (e.endpoints && e.endpoints.length > 0)
+    return e.endpoints;
+  const s = [];
+  return e.phone && s.push({ scheme: o.TEL, resource: e.phone, primary: !0 }), e.email && s.push({ scheme: o.MAILTO, resource: e.email, primary: !e.phone }), s;
+}
+const T = (e) => !!e.assignedUserId || !!e.assignedInboxId, E = (e) => e.status === "closed", b = (e) => ({
   urgent: 10,
   high: 5,
   normal: 2,
   low: 1
-})[s.priority] || 0, A = (s, r = 30) => s.title.length <= r ? s.title : `${s.title.substring(0, r)}...`;
-var t = /* @__PURE__ */ ((s) => (s.MAILTO = "mailto", s.SIP = "sip", s.TEL = "tel", s.WEBHOOK = "webhook", s.USERNAME = "username", s.ID = "id", s.CUSTOM = "custom", s.URL = "url", s.TELEGRAM = "telegram", s.WHATSAPP = "whatsapp", s.VIBER = "viber", s.SMS = "sms", s.FAX = "fax", s.TEAMS = "teams", s))(t || {});
+})[e.priority] || 0, A = (e, s = 30) => e.title.length <= s ? e.title : `${e.title.substring(0, s)}...`, d = {
+  [o.TEL]: ["call"],
+  [o.SIP]: ["call"],
+  [o.MAILTO]: ["mail"],
+  [o.SMS]: ["message"],
+  [o.WHATSAPP]: ["message"],
+  [o.TELEGRAM]: ["message"],
+  [o.VIBER]: ["message"],
+  [o.TEAMS]: ["call", "message", "video"],
+  [o.FAX]: ["message"]
+}, u = {
+  call: "transport",
+  video: "transport",
+  message: "transport",
+  mail: "compose"
+}, p = ["call", "mail", "message", "video"];
+function a(e, s) {
+  if (!e.supportedSchemes.includes(s)) return [];
+  const n = e.capabilities.filter(
+    (t) => t.scheme === s && t.value === !0 && p.includes(t.key)
+  );
+  return n.length > 0 ? n.map((t) => t.key) : d[s] ?? [];
+}
+function f(e) {
+  const s = /* @__PURE__ */ new Set();
+  for (const n of e.supportedSchemes)
+    for (const t of a(e, n)) s.add(t);
+  return Array.from(s);
+}
+function h(e, s, n) {
+  return e.capabilities.find(
+    (r) => r.scheme === s && r.key === n && r.value === !0
+  )?.dispatch ?? u[n];
+}
+function I(e, s) {
+  return Object.entries(e).map(([n, t]) => ({
+    providerId: n,
+    description: t,
+    intents: f(t)
+  }));
+}
+function v(e, s) {
+  const n = [];
+  for (const t of e) {
+    if (!t.enabled) continue;
+    const r = s[t.providerId];
+    if (r) {
+      if (t.capabilities && t.capabilities.length > 0) {
+        for (const i of t.capabilities) {
+          if (!i.value || !p.includes(i.key)) continue;
+          const c = i.scheme, l = i.key;
+          n.push({
+            channel: t,
+            description: r,
+            scheme: c,
+            intent: l,
+            dispatch: i.dispatch ?? u[l]
+          });
+        }
+        continue;
+      }
+      for (const i of r.supportedSchemes) {
+        const c = a(r, i);
+        for (const l of c)
+          n.push({
+            channel: t,
+            description: r,
+            scheme: i,
+            intent: l,
+            dispatch: h(r, i, l)
+          });
+      }
+    }
+  }
+  return n;
+}
+function y(e, s) {
+  return s.filter((n) => n.intents.includes(e));
+}
+function M(e, s) {
+  return s.filter((n) => n.description.supportedSchemes.includes(e.scheme));
+}
+function S(e, s, n) {
+  const t = [];
+  for (const r of e)
+    for (const i of n)
+      i.description.supportedSchemes.includes(r.scheme) && a(i.description, r.scheme).includes(s) && t.push({ capability: i, endpoint: r });
+  return t;
+}
+function F(e, s, n) {
+  const t = [];
+  for (const r of e)
+    for (const i of n)
+      i.scheme === r.scheme && i.intent === s && t.push({ capability: i, endpoint: r });
+  return t;
+}
 export {
-  t as CommunicationScheme,
+  o as CommunicationScheme,
+  v as buildChannelCapabilities,
+  I as buildResolvedCapabilities,
+  h as dispatchForCapability,
+  g as getContactEndpoints,
   A as getShortTitle,
-  d as getUrgencyScore,
-  l as isAssigned,
-  g as isClosed
+  b as getUrgencyScore,
+  f as intentsForProvider,
+  a as intentsForScheme,
+  T as isAssigned,
+  E as isClosed,
+  F as resolveContactChannelCapabilities,
+  S as resolveForContact,
+  M as resolveForEndpoint,
+  y as resolveForIntent
 };

package/dist/platform/capabilities.d.ts

@@ -0,0 +1,60 @@
+import { Channel } from '../entities/channel/types';
+import { ContactEndpoint } from '../entities/contact/types';
+import { CommsAccount, CommunicationDispatch, CommunicationScheme, ProviderDescription, Uri } from './communication';
+export type CommunicationIntent = "call" | "mail" | "message" | "video";
+export interface ResolvedCapability {
+    providerId: string;
+    description: ProviderDescription;
+    intents: CommunicationIntent[];
+}
+export interface ChannelCapability {
+    channel: Channel;
+    description: ProviderDescription;
+    scheme: CommunicationScheme;
+    intent: CommunicationIntent;
+    dispatch: CommunicationDispatch;
+}
+export interface ResolvedCapabilityMatch {
+    capability: ResolvedCapability;
+    endpoint: ContactEndpoint;
+}
+export interface ChannelCapabilityMatch {
+    capability: ChannelCapability;
+    endpoint: ContactEndpoint;
+}
+/**
+ * Returns which intents a provider offers for a given scheme.
+ * Capability rows whose `key` is a known user-intent (`call|mail|message|video`)
+ * are treated as explicit declarations; anything else is ignored. Empty
+ * declared list falls back to a conventional default per scheme.
+ */
+export declare function intentsForScheme(description: ProviderDescription, scheme: CommunicationScheme): CommunicationIntent[];
+export declare function intentsForProvider(description: ProviderDescription): CommunicationIntent[];
+/**
+ * Returns how a given (scheme, intent) on this provider should be dispatched.
+ * Honours an explicit `dispatch` on the capability row; otherwise falls back
+ * to the intent default (mail=compose, rest=transport).
+ */
+export declare function dispatchForCapability(description: ProviderDescription, scheme: CommunicationScheme, intent: CommunicationIntent): CommunicationDispatch;
+export declare function buildResolvedCapabilities(descriptions: Record<string, ProviderDescription>, _accounts?: CommsAccount[]): ResolvedCapability[];
+/**
+ * Builds (channel × scheme × intent) capabilities.
+ *
+ * Precedence:
+ *  1. `channel.capabilities` when present — the precise truth for *this*
+ *     specific channel (e.g. one Microsoft account exposes only Teams,
+ *     another only mailto). Each capability row maps directly to one
+ *     ChannelCapability.
+ *  2. Fallback: provider-level `description.capabilities` × `supportedSchemes`
+ *     — coarse default for backends that don't yet declare per-channel.
+ */
+export declare function buildChannelCapabilities(channels: Channel[], descriptions: Record<string, ProviderDescription>): ChannelCapability[];
+export declare function resolveForIntent(intent: CommunicationIntent, capabilities: ResolvedCapability[]): ResolvedCapability[];
+export declare function resolveForEndpoint(uri: Uri, capabilities: ResolvedCapability[]): ResolvedCapability[];
+export declare function resolveForContact(endpoints: ContactEndpoint[], intent: CommunicationIntent, capabilities: ResolvedCapability[]): ResolvedCapabilityMatch[];
+/**
+ * Channel-aware variant: matches contact endpoints against (channel × intent)
+ * capabilities. Each match identifies *exactly* which channel will send and
+ * how. Drives both contact-detail buttons and contact-named palette rows.
+ */
+export declare function resolveContactChannelCapabilities(endpoints: ContactEndpoint[], intent: CommunicationIntent, capabilities: ChannelCapability[]): ChannelCapabilityMatch[];

package/dist/platform/communication.d.ts

@@ -40,10 +40,18 @@ export interface ITransportProvider {
     setOutgoingStream(sessionId: string, stream: MediaStream | null): Promise<void>;
     handleAction(sessionId: string, actionId: string, ...args: any[]): void;
 }
+export type CommunicationDispatch = "transport" | "compose";
 export interface Capability {
     scheme: string;
     key: string;
     value: boolean;
+    /**
+     * How this (scheme,intent) is delivered. `transport` goes through
+     * ITransportProvider.createSession (live SIP/Teams call). `compose`
+     * goes through the server-side compose endpoint with a channelId
+     * (mail, async messaging). Defaults to intent: mail=compose, rest=transport.
+     */
+    dispatch?: CommunicationDispatch;
 }
 export declare enum CommunicationScheme {
     MAILTO = "mailto",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencxh/domain",
-  "version": "1.16.0",
+  "version": "1.18.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",