@opencxh/domain 1.17.0 → 1.18.1

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

@@ -1,4 +1,4 @@
-import { Uri } from '../../platform/communication';
+import { IntentCapability, Uri } from '../../platform/communication';
 export interface Channel {
     id: string;
     organizationId: string;
@@ -12,6 +12,9 @@ export interface Channel {
     ownerId: string;
     externalIds?: string[];
     settings: Record<string, any>;
+    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 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 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,70 +1,69 @@
-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) {
-  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;
+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 a = (e) => !!e.assignedUserId || !!e.assignedInboxId, g = (e) => e.status === "closed", E = (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, 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) {
-  if (!e.supportedSchemes.includes(s)) return [];
-  const t = e.capabilities.filter(
-    (r) => r.scheme === s && r.value === !0 && d.includes(r.key)
-  );
-  return t.length > 0 ? t.map((r) => r.key) : u[s] ?? [];
+})[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 p(e) {
-  const s = /* @__PURE__ */ new Set();
-  for (const t of e.supportedSchemes)
-    for (const r of i(e, t)) s.add(r);
-  return Array.from(s);
+function u(t, e) {
+  return e ? {
+    intent: e.intent ?? t.intent,
+    targetSchemes: e.targetSchemes ?? t.targetSchemes,
+    transport: e.transport ?? t.transport
+  } : t;
 }
-function c(e, s) {
-  return Object.entries(e).map(([t, r]) => ({
-    providerId: t,
-    description: r,
-    intents: p(r)
-  }));
+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 r;
 }
-function A(e, s) {
-  return s.filter((t) => t.intents.includes(e));
+function y(t, e) {
+  return e.filter((r) => r.capability.intent === t);
 }
-function I(e, s) {
-  return s.filter((t) => t.description.supportedSchemes.includes(e.scheme));
+function p(t, e) {
+  return e.filter((r) => r.capability.targetSchemes.includes(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 b(t, e) {
+  return p(t.scheme, e);
+}
+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 {
-  n as CommunicationScheme,
-  c as buildResolvedCapabilities,
-  f as getContactEndpoints,
-  T as getShortTitle,
-  E as getUrgencyScore,
-  p as intentsForProvider,
-  i as intentsForScheme,
-  a as isAssigned,
+  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,
-  h as resolveForContact,
-  I as resolveForEndpoint,
-  A as resolveForIntent
+  E as matchContactToIntents,
+  l as resolveChannelIntents
 };

package/dist/platform/capabilities.d.ts

@@ -1,31 +1,48 @@
+import { Channel } from '../entities/channel/types';
 import { ContactEndpoint } from '../entities/contact/types';
-import { CommsAccount, 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;
+/**
+ * A channel's effective intent — the resolved IntentCapability for this
+ * specific channel, ready for routing/UI decisions.
+ */
+export interface ChannelIntent {
+    channel: Channel;
     description: ProviderDescription;
-    intents: CommunicationIntent[];
+    capability: IntentCapability;
 }
-export interface ResolvedCapabilityMatch {
-    capability: ResolvedCapability;
+export interface ChannelIntentMatch {
+    channelIntent: ChannelIntent;
     endpoint: ContactEndpoint;
 }
 /**
- * Returns which intents a provider offers for a given scheme.
+ * Pure resolution of a channel's effective intents.
  *
- * 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.
+ * 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`)
  *
- * When a scheme has no explicit intent rows, the conventional default
- * mapping kicks in so providers can ship just `supportedSchemes`.
+ * No fallback heuristics, no scheme-based defaults — provider declares the
+ * source of truth, channel patches it.
+ */
+export declare function resolveChannelIntents(channel: Channel, description: ProviderDescription): IntentCapability[];
+/**
+ * Builds the full set of (channel × intent) entries across all channels —
+ * the source for the starter palette.
  */
-export declare function intentsForScheme(description: ProviderDescription, scheme: CommunicationScheme): CommunicationIntent[];
+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[];
 /**
- * Unions intents across all schemes a provider supports.
+ * Cross-product of contact endpoints × channel intents for one specific
+ * intent. One match = one row in the starter palette / contact buttons.
  */
-export declare function intentsForProvider(description: ProviderDescription): CommunicationIntent[];
-export declare function buildResolvedCapabilities(descriptions: Record<string, ProviderDescription>, _accounts?: CommsAccount[]): ResolvedCapability[];
-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 matchContactToIntents(endpoints: ContactEndpoint[], intent: string, items: ChannelIntent[]): ChannelIntentMatch[];

package/dist/platform/communication.d.ts

@@ -40,11 +40,7 @@ export interface ITransportProvider {
     setOutgoingStream(sessionId: string, stream: MediaStream | null): Promise<void>;
     handleAction(sessionId: string, actionId: string, ...args: any[]): void;
 }
-export interface Capability {
-    scheme: string;
-    key: string;
-    value: boolean;
-}
+export type CommunicationDispatch = "transport" | "compose";
 export declare enum CommunicationScheme {
     MAILTO = "mailto",
     SIP = "sip",
@@ -61,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.17.0",
+  "version": "1.18.1",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",