@opencxh/domain 1.20.0 → 1.27.0

package/dist/entities/calendar-event/index.d.ts

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

package/dist/entities/calendar-event/types.d.ts

@@ -0,0 +1,55 @@
+import { OwnerScope } from '../contact/types';
+export type CalendarEventStatus = "confirmed" | "cancelled" | "tentative";
+export type AttendeeResponse = "accepted" | "declined" | "tentative" | "none";
+export interface EventAttendee {
+    email: string;
+    name?: string;
+    response?: AttendeeResponse;
+    optional?: boolean;
+}
+export interface EventConferencing {
+    provider: "teams" | "meet" | "zoom" | "other";
+    joinUrl: string;
+    conferenceId?: string;
+    passcode?: string;
+}
+export type RecurrenceFrequency = "daily" | "weekly" | "monthly" | "yearly";
+/**
+ * RFC5545-subset. MVP: read-only — provider supplies, we display.
+ */
+export interface RecurrenceRule {
+    frequency: RecurrenceFrequency;
+    interval?: number;
+    count?: number;
+    until?: number;
+    byWeekday?: ("MO" | "TU" | "WE" | "TH" | "FR" | "SA" | "SU")[];
+}
+export interface EventReminder {
+    minutesBefore: number;
+}
+export interface CalendarEvent {
+    id: string;
+    organizationId: string;
+    ownerScope: OwnerScope;
+    title: string;
+    description?: string;
+    location?: string;
+    startTime: number;
+    endTime: number;
+    allDay?: boolean;
+    timezone?: string;
+    organizer?: EventAttendee;
+    attendees?: EventAttendee[];
+    /** Link to a communication Interaction (e.g. Teams meeting chat). */
+    interactionId?: string;
+    /** Channel used for external sync (provider-resolved). */
+    channelId?: string;
+    /** Provider-side IDs for dedupe (e.g. Graph event id, iCalUId). */
+    externalIds?: string[];
+    status: CalendarEventStatus;
+    recurrence?: RecurrenceRule;
+    reminders?: EventReminder[];
+    conferencing?: EventConferencing;
+    createdAt?: number;
+    updatedAt?: number;
+}

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function c(t){return t.endpoints??[]}const u=t=>!!t.assignedUserId||!!t.assignedInboxId,d=t=>t.status==="closed",g=t=>({urgent:10,high:5,normal:2,low:1})[t.priority]||0,p=(t,n=30)=>t.title?.length<=n?t.title:`${t.title.substring(0,n)}...`;function l(t,n){const s=new Set(t.disabledIntents??[]),i=t.intentOverrides??{},e=n.intents.filter(r=>!s.has(r.intent)).map(r=>I(r,i[r.intent]));if(!t.extraIntents||t.extraIntents.length===0)return e;const o=new Set(e.map(r=>r.intent));for(const r of t.extraIntents)o.has(r.intent)||(e.push(r),o.add(r.intent));return e}function I(t,n){return n?{intent:n.intent??t.intent,targetSchemes:n.targetSchemes??t.targetSchemes,transport:n.transport??t.transport}:t}function y(t,n){const s=[];for(const i of t){if(!i.enabled)continue;const e=n[i.providerId];if(e)for(const o of l(i,e))s.push({channel:i,description:e,capability:o})}return s}function b(t,n){return n.filter(s=>s.capability.intent===t)}function a(t,n){return n.filter(s=>s.capability.targetSchemes.includes(t))}function h(t,n){return a(t.scheme,n)}function T(t,n,s){const i=[];for(const e of t)for(const o of s)o.capability.intent===n&&o.capability.targetSchemes.includes(e.scheme)&&i.push({channelIntent:o,endpoint:e});return i}var f=(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||{});exports.CommunicationScheme=f;exports.buildChannelIntents=y;exports.filterByEndpoint=h;exports.filterByIntent=b;exports.filterByTargetScheme=a;exports.getContactEndpoints=c;exports.getShortTitle=p;exports.getUrgencyScore=g;exports.isAssigned=u;exports.isClosed=d;exports.matchContactToIntents=T;exports.resolveChannelIntents=l;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function c(t){return t.endpoints??[]}const d=t=>!!t.assignedUserId||!!t.assignedInboxId,u=t=>t.status==="closed",g=t=>({urgent:10,high:5,normal:2,low:1})[t.priority]||0,p=(t,n=30)=>t.title?.length<=n?t.title:`${t.title.substring(0,n)}...`;function l(t,n){const r=new Set(t.disabledIntents??[]),i=t.intentOverrides??{},e=n.intents.filter(s=>!r.has(s.intent)).map(s=>I(s,i[s.intent]));if(!t.extraIntents||t.extraIntents.length===0)return e;const o=new Set(e.map(s=>s.intent));for(const s of t.extraIntents)o.has(s.intent)||(e.push(s),o.add(s.intent));return e}function I(t,n){return n?{intent:n.intent??t.intent,targetSchemes:n.targetSchemes??t.targetSchemes,transport:n.transport??t.transport}:t}function y(t,n){const r=[];for(const i of t){if(!i.enabled)continue;const e=n[i.providerId];if(e)for(const o of l(i,e))r.push({channel:i,description:e,capability:o})}return r}function b(t,n){return n.filter(r=>r.capability.intent===t)}function a(t,n){return n.filter(r=>r.capability.targetSchemes.includes(t))}function h(t,n){return a(t.scheme,n)}function E(t,n,r){const i=[];for(const e of t)for(const o of r)o.capability.intent===n&&o.capability.targetSchemes.includes(e.scheme)&&i.push({channelIntent:o,endpoint:e});return i}var f=(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.CALENDAR="calendar",t))(f||{});exports.CommunicationScheme=f;exports.buildChannelIntents=y;exports.filterByEndpoint=h;exports.filterByIntent=b;exports.filterByTargetScheme=a;exports.getContactEndpoints=c;exports.getShortTitle=p;exports.getUrgencyScore=g;exports.isAssigned=d;exports.isClosed=u;exports.matchContactToIntents=E;exports.resolveChannelIntents=l;

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export * from './entities/ai-profile';
 export * from './entities/channel';
 export * from './entities/communication';
 export * from './entities/contact';
+export * from './entities/calendar-event';
 export * from './entities/inbox';
 export * from './entities/interaction';
 export * from './entities/note';

package/dist/index.js

@@ -1,7 +1,7 @@
-function c(t) {
+function d(t) {
   return t.endpoints ?? [];
 }
-const d = (t) => !!t.assignedUserId || !!t.assignedInboxId, p = (t) => t.status === "closed", g = (t) => ({
+const p = (t) => !!t.assignedUserId || !!t.assignedInboxId, c = (t) => t.status === "closed", g = (t) => ({
   urgent: 10,
   high: 5,
   normal: 2,
@@ -33,34 +33,34 @@ function b(t, n) {
   }
   return r;
 }
-function y(t, n) {
+function E(t, n) {
   return n.filter((r) => r.capability.intent === t);
 }
 function a(t, n) {
   return n.filter((r) => r.capability.targetSchemes.includes(t));
 }
-function E(t, n) {
+function y(t, n) {
   return a(t.scheme, n);
 }
-function T(t, n, r) {
+function A(t, n, r) {
   const i = [];
   for (const e of t)
     for (const o of r)
       o.capability.intent === n && o.capability.targetSchemes.includes(e.scheme) && i.push({ channelIntent: o, endpoint: e });
   return i;
 }
-var u = /* @__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))(u || {});
+var u = /* @__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.CALENDAR = "calendar", t))(u || {});
 export {
   u as CommunicationScheme,
   b as buildChannelIntents,
-  E as filterByEndpoint,
-  y as filterByIntent,
+  y as filterByEndpoint,
+  E as filterByIntent,
   a as filterByTargetScheme,
-  c as getContactEndpoints,
+  d as getContactEndpoints,
   I as getShortTitle,
   g as getUrgencyScore,
-  d as isAssigned,
-  p as isClosed,
-  T as matchContactToIntents,
+  p as isAssigned,
+  c as isClosed,
+  A as matchContactToIntents,
   f as resolveChannelIntents
 };

package/dist/platform/capabilities.d.ts

@@ -6,7 +6,7 @@ import { CommunicationScheme, IntentCapability, ProviderDescription, Uri } from
  * 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 type CommunicationIntent = "call" | "mail" | "message" | "video" | "calendar";
 /**
  * A channel's effective intent — the resolved IntentCapability for this
  * specific channel, ready for routing/UI decisions.

package/dist/platform/communication.d.ts

@@ -55,7 +55,8 @@ export declare enum CommunicationScheme {
     VIBER = "viber",
     SMS = "sms",
     FAX = "fax",
-    TEAMS = "teams"
+    TEAMS = "teams",
+    CALENDAR = "calendar"
 }
 /**
  * Account selector for `transport: session` intents. Tells the frontend
@@ -63,10 +64,14 @@ export declare enum CommunicationScheme {
  *  - `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)
+ *  - `matcherId` set: defer to a client-registered matcher fn that picks the
+ *    account based on dynamic context (channel, accounts). Lookup by string
+ *    keeps the wire format JSON; fn lives in the runtime registry.
  */
 export interface AccountSelector {
     protocol: string;
     accountId?: string;
+    matcherId?: string;
 }
 export type TransportConfig = {
     kind: "compose";
@@ -85,6 +90,15 @@ export type TransportConfig = {
         canvas: `${string}:${string}`;
         actionTray?: `${string}:${string}`;
     };
+} | {
+    /**
+     * CRUD-on-external-resource transport. Used for entities with a
+     * lifecycle (create/update/cancel) on the provider side — e.g.
+     * calendar events, tasks. Provider exposes a handler-set instead
+     * of a single send. Distinct from `compose` (fire-and-forget) and
+     * `session` (stateful realtime).
+     */
+    kind: "schedule";
 };
 /**
  * One user-facing intent a provider/channel can perform on a target.

package/dist/platform/provider.d.ts

@@ -69,6 +69,40 @@ export interface FindActivityByExternalProviderIdPayload {
     activityType: string;
     interactionId?: string;
 }
+/**
+ * Calendar/schedule transport payloads. Providers that declare an intent
+ * with `transport: { kind: "schedule" }` implement `/provider/schedule/*`
+ * routes. Communication-server dispatches CRUD on CalendarEvents to the
+ * corresponding provider via these payloads.
+ */
+export type ScheduleResponse = "accepted" | "declined" | "tentative";
+export interface SchedulePayload {
+    channelId: string;
+    /** Local CalendarEvent without storage-managed fields. */
+    event: any;
+}
+export interface ScheduleUpdatePayload {
+    channelId: string;
+    externalId: string;
+    patch: any;
+}
+export interface ScheduleCancelPayload {
+    channelId: string;
+    externalId: string;
+    comment?: string;
+}
+export interface ScheduleRespondPayload {
+    channelId: string;
+    externalId: string;
+    response: ScheduleResponse;
+    comment?: string;
+    sendResponse?: boolean;
+}
+export interface ScheduleResult {
+    externalId?: string;
+    /** Provider-side echo for caller persistence (e.g. Graph event id). */
+    providerData?: Record<string, unknown>;
+}
 export interface FileUploadPayload {
     file: Uint8Array;
     filename: string;

package/package.json

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