@opencxh/domain 1.18.0 → 1.18.1

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

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

package/dist/index.cjs

@@ -1 +1 @@
-"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;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var l=(t=>(t.MAILTO="mailto",t.SIP="sip",t.TEL="tel",t.WEBHOOK="webhook",t.USERNAME="username",t.ID="id",t.CUSTOM="custom",t.URL="url",t.TELEGRAM="telegram",t.WHATSAPP="whatsapp",t.VIBER="viber",t.SMS="sms",t.FAX="fax",t.TEAMS="teams",t))(l||{});function a(t){if(t.endpoints&&t.endpoints.length>0)return t.endpoints;const e=[];return t.phone&&e.push({scheme:l.TEL,resource:t.phone,primary:!0}),t.email&&e.push({scheme:l.MAILTO,resource:t.email,primary:!t.phone}),e}const p=t=>!!t.assignedUserId||!!t.assignedInboxId,d=t=>t.status==="closed",g=t=>({urgent:10,high:5,normal:2,low:1})[t.priority]||0,c=(t,e=30)=>t.title?.length<=e?t.title:`${t.title.substring(0,e)}...`;function f(t,e){const r=new Set(t.disabledIntents??[]),i=t.intentOverrides??{},n=e.intents.filter(s=>!r.has(s.intent)).map(s=>I(s,i[s.intent]));if(!t.extraIntents||t.extraIntents.length===0)return n;const o=new Set(n.map(s=>s.intent));for(const s of t.extraIntents)o.has(s.intent)||(n.push(s),o.add(s.intent));return n}function I(t,e){return e?{intent:e.intent??t.intent,targetSchemes:e.targetSchemes??t.targetSchemes,transport:e.transport??t.transport}:t}function h(t,e){const r=[];for(const i of t){if(!i.enabled)continue;const n=e[i.providerId];if(n)for(const o of f(i,n))r.push({channel:i,description:n,capability:o})}return r}function y(t,e){return e.filter(r=>r.capability.intent===t)}function u(t,e){return e.filter(r=>r.capability.targetSchemes.includes(t))}function T(t,e){return u(t.scheme,e)}function b(t,e,r){const i=[];for(const n of t)for(const o of r)o.capability.intent===e&&o.capability.targetSchemes.includes(n.scheme)&&i.push({channelIntent:o,endpoint:n});return i}exports.CommunicationScheme=l;exports.buildChannelIntents=h;exports.filterByEndpoint=T;exports.filterByIntent=y;exports.filterByTargetScheme=u;exports.getContactEndpoints=a;exports.getShortTitle=c;exports.getUrgencyScore=g;exports.isAssigned=p;exports.isClosed=d;exports.matchContactToIntents=b;exports.resolveChannelIntents=f;

package/dist/index.js

@@ -1,125 +1,69 @@
-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;
+var f = /* @__PURE__ */ ((t) => (t.MAILTO = "mailto", t.SIP = "sip", t.TEL = "tel", t.WEBHOOK = "webhook", t.USERNAME = "username", t.ID = "id", t.CUSTOM = "custom", t.URL = "url", t.TELEGRAM = "telegram", t.WHATSAPP = "whatsapp", t.VIBER = "viber", t.SMS = "sms", t.FAX = "fax", t.TEAMS = "teams", t))(f || {});
+function a(t) {
+  if (t.endpoints && t.endpoints.length > 0)
+    return t.endpoints;
+  const e = [];
+  return t.phone && e.push({ scheme: f.TEL, resource: t.phone, primary: !0 }), t.email && e.push({ scheme: f.MAILTO, resource: t.email, primary: !t.phone }), e;
 }
-const T = (e) => !!e.assignedUserId || !!e.assignedInboxId, E = (e) => e.status === "closed", b = (e) => ({
+const d = (t) => !!t.assignedUserId || !!t.assignedInboxId, g = (t) => t.status === "closed", I = (t) => ({
   urgent: 10,
   high: 5,
   normal: 2,
   low: 1
-})[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];
+})[t.priority] || 0, c = (t, e = 30) => t.title?.length <= e ? t.title : `${t.title.substring(0, e)}...`;
+function l(t, e) {
+  const r = new Set(t.disabledIntents ?? []), i = t.intentOverrides ?? {}, n = e.intents.filter((s) => !r.has(s.intent)).map((s) => u(s, i[s.intent]));
+  if (!t.extraIntents || t.extraIntents.length === 0) return n;
+  const o = new Set(n.map((s) => s.intent));
+  for (const s of t.extraIntents)
+    o.has(s.intent) || (n.push(s), o.add(s.intent));
+  return n;
 }
-function I(e, s) {
-  return Object.entries(e).map(([n, t]) => ({
-    providerId: n,
-    description: t,
-    intents: f(t)
-  }));
+function u(t, e) {
+  return e ? {
+    intent: e.intent ?? t.intent,
+    targetSchemes: e.targetSchemes ?? t.targetSchemes,
+    transport: e.transport ?? t.transport
+  } : 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)
-          });
-      }
-    }
+function h(t, e) {
+  const r = [];
+  for (const i of t) {
+    if (!i.enabled) continue;
+    const n = e[i.providerId];
+    if (n)
+      for (const o of l(i, n))
+        r.push({ channel: i, description: n, capability: o });
   }
-  return n;
+  return r;
 }
-function y(e, s) {
-  return s.filter((n) => n.intents.includes(e));
+function y(t, e) {
+  return e.filter((r) => r.capability.intent === t);
 }
-function M(e, s) {
-  return s.filter((n) => n.description.supportedSchemes.includes(e.scheme));
+function p(t, e) {
+  return e.filter((r) => r.capability.targetSchemes.includes(t));
 }
-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 b(t, e) {
+  return p(t.scheme, e);
 }
-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;
+function E(t, e, r) {
+  const i = [];
+  for (const n of t)
+    for (const o of r)
+      o.capability.intent === e && o.capability.targetSchemes.includes(n.scheme) && i.push({ channelIntent: o, endpoint: n });
+  return i;
 }
 export {
-  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
+  f as CommunicationScheme,
+  h as buildChannelIntents,
+  b as filterByEndpoint,
+  y as filterByIntent,
+  p as filterByTargetScheme,
+  a as getContactEndpoints,
+  c as getShortTitle,
+  I as getUrgencyScore,
+  d as isAssigned,
+  g as isClosed,
+  E as matchContactToIntents,
+  l as resolveChannelIntents
 };

package/dist/platform/capabilities.d.ts

@@ -1,60 +1,48 @@
 import { Channel } from '../entities/channel/types';
 import { ContactEndpoint } from '../entities/contact/types';
-import { CommsAccount, CommunicationDispatch, CommunicationScheme, ProviderDescription, Uri } from './communication';
+import { CommunicationScheme, IntentCapability, ProviderDescription, Uri } from './communication';
+/**
+ * Reference list of intents that have built-in UI defaults (icons, labels,
+ * default composers). Intent itself is an open string — providers may
+ * declare anything. Unknown intents render as generic actions.
+ */
 export type CommunicationIntent = "call" | "mail" | "message" | "video";
-export interface ResolvedCapability {
-    providerId: string;
-    description: ProviderDescription;
-    intents: CommunicationIntent[];
-}
-export interface ChannelCapability {
+/**
+ * A channel's effective intent — the resolved IntentCapability for this
+ * specific channel, ready for routing/UI decisions.
+ */
+export interface ChannelIntent {
     channel: Channel;
     description: ProviderDescription;
-    scheme: CommunicationScheme;
-    intent: CommunicationIntent;
-    dispatch: CommunicationDispatch;
+    capability: IntentCapability;
 }
-export interface ResolvedCapabilityMatch {
-    capability: ResolvedCapability;
+export interface ChannelIntentMatch {
+    channelIntent: ChannelIntent;
     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).
+ * Pure resolution of a channel's effective intents.
+ *
+ * Algorithm:
+ *  1. Start from `description.intents` (provider defaults)
+ *  2. Drop entries whose `intent` is in `channel.disabledIntents`
+ *  3. Shallow-merge `channel.intentOverrides[intent]` over the provider default
+ *  4. Append `channel.extraIntents` (deduped on `intent`)
+ *
+ * No fallback heuristics, no scheme-based defaults — provider declares the
+ * source of truth, channel patches it.
  */
-export declare function dispatchForCapability(description: ProviderDescription, scheme: CommunicationScheme, intent: CommunicationIntent): CommunicationDispatch;
-export declare function buildResolvedCapabilities(descriptions: Record<string, ProviderDescription>, _accounts?: CommsAccount[]): ResolvedCapability[];
+export declare function resolveChannelIntents(channel: Channel, description: ProviderDescription): IntentCapability[];
 /**
- * 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.
+ * Builds the full set of (channel × intent) entries across all channels —
+ * the source for the starter palette.
  */
-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[];
+export declare function buildChannelIntents(channels: Channel[], descriptions: Record<string, ProviderDescription>): ChannelIntent[];
+export declare function filterByIntent(intent: string, items: ChannelIntent[]): ChannelIntent[];
+export declare function filterByTargetScheme(scheme: CommunicationScheme, items: ChannelIntent[]): ChannelIntent[];
+export declare function filterByEndpoint(uri: Uri, items: ChannelIntent[]): ChannelIntent[];
 /**
- * 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.
+ * Cross-product of contact endpoints × channel intents for one specific
+ * intent. One match = one row in the starter palette / contact buttons.
  */
-export declare function resolveContactChannelCapabilities(endpoints: ContactEndpoint[], intent: CommunicationIntent, capabilities: ChannelCapability[]): ChannelCapabilityMatch[];
+export declare function matchContactToIntents(endpoints: ContactEndpoint[], intent: string, items: ChannelIntent[]): ChannelIntentMatch[];

package/dist/platform/communication.d.ts

@@ -41,18 +41,6 @@ export interface ITransportProvider {
     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",
     SIP = "sip",
@@ -69,11 +57,63 @@ export declare enum CommunicationScheme {
     FAX = "fax",
     TEAMS = "teams"
 }
+/**
+ * Account selector for `transport: session` intents. Tells the frontend
+ * which `CommsAccount` should service this intent on this channel.
+ *  - `protocol` only: pick the first registered account with this protocol
+ *    (acceptable when there is one UA per provider per tenant)
+ *  - `accountId` set: pin to a specific account (multi-trunk / multi-tenant)
+ */
+export interface AccountSelector {
+    protocol: string;
+    accountId?: string;
+}
+export type TransportConfig = {
+    kind: "compose";
+    /** Optional federated composer resource as "<app>:<resource>". */
+    composer?: string;
+    /**
+     * When true, comms-app `interaction/compose` skips its auto-create
+     * and lets the provider own interaction lifecycle (e.g. Teams chat
+     * upserts on a chatId externalId).
+     */
+    ownsInteraction?: boolean;
+} | {
+    kind: "session";
+    accountSelector: AccountSelector;
+    ui: {
+        canvas: `${string}:${string}`;
+        actionTray?: `${string}:${string}`;
+    };
+};
+/**
+ * One user-facing intent a provider/channel can perform on a target.
+ * `intent` is an open string — known values (call/mail/message/video) get
+ * default UI/labels; new ones (`schedule`, `transfer`, `record`) render as
+ * generic actions until a provider declares specialised UI.
+ */
+export interface IntentCapability {
+    intent: string;
+    targetSchemes: CommunicationScheme[];
+    transport: TransportConfig;
+}
+/**
+ * Provider-level feature flag (no routing relevance). Used for things
+ * like `call_hold`, `call_forward`, `message_reactions` that providers
+ * advertise to feature-detect, but which are not user-pickable intents.
+ */
+export interface ProviderFeature {
+    name: string;
+    scheme?: CommunicationScheme;
+    value: boolean;
+}
 export interface ProviderDescription {
     id?: string;
     displayName: string;
-    capabilities: Capability[];
-    supportedSchemes: CommunicationScheme[];
+    /** User-intents this provider offers by default. Channels inherit. */
+    intents: IntentCapability[];
+    /** Provider feature flags — separate from routing. */
+    features: ProviderFeature[];
 }
 export interface PersonalAuthOption {
     id: string;

package/dist/platform/provider.d.ts

@@ -16,6 +16,18 @@ export interface ComposePayload {
     channelUri?: Uri;
     recipientUri: Uri;
     subject?: string;
+    /**
+     * The user-intent picked in the starter / contact buttons. Lets a
+     * provider compose-handler dispatch on intent — e.g. a Microsoft
+     * mailbox with intent `message` routes to Teams chat, intent `mail`
+     * routes to Outlook send-mail. Open string for forward-compat.
+     */
+    intent?: string;
+    /**
+     * Channel-specific extras — template_id, attachments, location, etc.
+     * Provider compose-handlers may read this; defaults ignore it.
+     */
+    extra?: Record<string, any>;
 }
 export interface ComposeResponse {
     messageId: string;

package/package.json

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