@opencxh/domain 1.17.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/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var t=(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))(t||{});function d(e){if(e.endpoints&&e.endpoints.length>0)return e.endpoints;const s=[];return e.phone&&s.push({scheme:t.TEL,resource:e.phone,primary:!0}),e.email&&s.push({scheme:t.MAILTO,resource:e.email,primary:!e.phone}),s}const p=e=>!!e.assignedUserId||!!e.assignedInboxId,a=e=>e.status==="closed",f=e=>({urgent:10,high:5,normal:2,low:1})[e.priority]||0,g=(e,s=30)=>e.title.length<=s?e.title:`${e.title.substring(0,s)}...`,c={[t.TEL]:["call"],[t.SIP]:["call"],[t.MAILTO]:["mail"],[t.SMS]:["message"],[t.WHATSAPP]:["message"],[t.TELEGRAM]:["message"],[t.VIBER]:["message"],[t.TEAMS]:["call","message","video"],[t.FAX]:["message"]},E=["call","mail","message","video"];function l(e,s){if(!e.supportedSchemes.includes(s))return[];const n=e.capabilities.filter(r=>r.scheme===s&&r.value===!0&&E.includes(r.key));return n.length>0?n.map(r=>r.key):c[s]??[]}function u(e){const s=new Set;for(const n of e.supportedSchemes)for(const r of l(e,n))s.add(r);return Array.from(s)}function T(e,s){return Object.entries(e).map(([n,r])=>({providerId:n,description:r,intents:u(r)}))}function A(e,s){return s.filter(n=>n.intents.includes(e))}function v(e,s){return s.filter(n=>n.description.supportedSchemes.includes(e.scheme))}function I(e,s,n){const r=[];for(const o of e)for(const i of n)i.description.supportedSchemes.includes(o.scheme)&&l(i.description,o.scheme).includes(s)&&r.push({capability:i,endpoint:o});return r}exports.CommunicationScheme=t;exports.buildResolvedCapabilities=T;exports.getContactEndpoints=d;exports.getShortTitle=g;exports.getUrgencyScore=f;exports.intentsForProvider=u;exports.intentsForScheme=l;exports.isAssigned=p;exports.isClosed=a;exports.resolveForContact=I;exports.resolveForEndpoint=v;exports.resolveForIntent=A;
+"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.js

@@ -1,70 +1,125 @@
-var n = /* @__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))(n || {});
-function f(e) {
+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: n.TEL, resource: e.phone, primary: !0 }), e.email && s.push({ scheme: n.MAILTO, resource: e.email, primary: !e.phone }), 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 a = (e) => !!e.assignedUserId || !!e.assignedInboxId, g = (e) => e.status === "closed", E = (e) => ({
+const T = (e) => !!e.assignedUserId || !!e.assignedInboxId, E = (e) => e.status === "closed", b = (e) => ({
   urgent: 10,
   high: 5,
   normal: 2,
   low: 1
-})[e.priority] || 0, T = (e, s = 30) => e.title.length <= s ? e.title : `${e.title.substring(0, s)}...`, u = {
-  [n.TEL]: ["call"],
-  [n.SIP]: ["call"],
-  [n.MAILTO]: ["mail"],
-  [n.SMS]: ["message"],
-  [n.WHATSAPP]: ["message"],
-  [n.TELEGRAM]: ["message"],
-  [n.VIBER]: ["message"],
-  [n.TEAMS]: ["call", "message", "video"],
-  [n.FAX]: ["message"]
-}, d = ["call", "mail", "message", "video"];
-function i(e, s) {
+})[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 t = e.capabilities.filter(
-    (r) => r.scheme === s && r.value === !0 && d.includes(r.key)
+  const n = e.capabilities.filter(
+    (t) => t.scheme === s && t.value === !0 && p.includes(t.key)
   );
-  return t.length > 0 ? t.map((r) => r.key) : u[s] ?? [];
+  return n.length > 0 ? n.map((t) => t.key) : d[s] ?? [];
 }
-function p(e) {
+function f(e) {
   const s = /* @__PURE__ */ new Set();
-  for (const t of e.supportedSchemes)
-    for (const r of i(e, t)) s.add(r);
+  for (const n of e.supportedSchemes)
+    for (const t of a(e, n)) s.add(t);
   return Array.from(s);
 }
-function c(e, s) {
-  return Object.entries(e).map(([t, r]) => ({
-    providerId: t,
-    description: r,
-    intents: p(r)
+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 A(e, s) {
-  return s.filter((t) => t.intents.includes(e));
+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 I(e, s) {
-  return s.filter((t) => t.description.supportedSchemes.includes(e.scheme));
+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 h(e, s, t) {
-  const r = [];
-  for (const l of e)
-    for (const o of t)
-      o.description.supportedSchemes.includes(l.scheme) && i(o.description, l.scheme).includes(s) && r.push({ capability: o, endpoint: l });
-  return r;
+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 {
-  n as CommunicationScheme,
-  c as buildResolvedCapabilities,
-  f as getContactEndpoints,
-  T as getShortTitle,
-  E as getUrgencyScore,
-  p as intentsForProvider,
-  i as intentsForScheme,
-  a as isAssigned,
-  g as isClosed,
-  h as resolveForContact,
-  I as resolveForEndpoint,
-  A as resolveForIntent
+  o as CommunicationScheme,
+  v as buildChannelCapabilities,
+  I as buildResolvedCapabilities,
+  h as dispatchForCapability,
+  g as getContactEndpoints,
+  A as getShortTitle,
+  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

@@ -1,31 +1,60 @@
+import { Channel } from '../entities/channel/types';
 import { ContactEndpoint } from '../entities/contact/types';
-import { CommsAccount, CommunicationScheme, ProviderDescription, Uri } from './communication';
+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 (e.g. `call_forward`,
- * `call_hold` — those are session-action feature flags) is ignored here.
- *
- * When a scheme has no explicit intent rows, the conventional default
- * mapping kicks in so providers can ship just `supportedSchemes`.
+ * 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[];
 /**
- * Unions intents across all schemes a provider supports.
+ * 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 intentsForProvider(description: ProviderDescription): CommunicationIntent[];
+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.17.0",
+  "version": "1.18.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",