@opencxh/domain 1.1.4

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

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

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

@@ -0,0 +1,212 @@
+import { AIMessage } from '../ai-message/types';
+import { Transcript } from '../transcript/types';
+
+export type CallStatus = "new" | "connecting" | "ringing" | "connected" | "held" | "ended" | "failed";
+export type CallDirection = "inbound" | "outbound";
+export type CallType = "audio" | "video" | "data" | "screen-share";
+export type ActivityType = "VOICE_CALL_STARTED" | "VOICE_CALL_ANSWERED" | "VOICE_CALL_HOLD" | "VOICE_CALL_UNHOLD" | "VOICE_CALL_ENDED" | "VOICE_CALL_MISSED" | "VOICE_CALL_VOICEMAIL" | "VIDEO_CALL_STARTED" | "VIDEO_CALL_ANSWERED" | "VIDEO_CALL_HOLD" | "VIDEO_CALL_UNHOLD" | "VIDEO_CALL_ENDED" | "VIDEO_CALL_MISSED" | "EMAIL_RECEIVED" | "EMAIL_SENT" | "CHAT_MESSAGE_SENT" | "CHAT_MESSAGE_RECEIVED" | "AI_MESSAGE_ADDED" | "MEETING_SCHEDULED" | "MEETING_STARTED" | "MEETING_ENDED" | "MEETING_PARTICIPANT_JOINED" | "MEETING_PARTICIPANT_LEFT" | "COMMENT_ADDED" | "FILE_UPLOADED" | "INTERACTION_CREATED" | "INTERACTION_STATUS_CHANGED" | "INTERACTION_ASSIGNED" | "VOICE_CALL_FAILED" | "VIDEO_CALL_FAILED" | "TRANSCRIPT_ADDED";
+export interface BaseActivity {
+    id: string;
+    interactionId: string;
+    organizationId: string;
+    createdAt: number;
+    provider: {
+        id?: string;
+        name?: string;
+        externalId?: string;
+    };
+    author: {
+        type: "user" | "contact" | "system";
+        id?: string;
+        name: string;
+    };
+    direction: "inbound" | "outbound" | "internal" | "none";
+}
+export type VoiceCallPayload = {
+    from: string;
+    to: string;
+    callId: string;
+    type: CallType;
+    direction: CallDirection;
+    status: CallStatus;
+    accountId: string;
+};
+export type VoiceCallEndedPayload = VoiceCallPayload & {
+    duration: number;
+    recordingUrl?: string;
+    quality?: "good" | "average" | "poor";
+};
+export type VoiceCallVoicemailPayload = VoiceCallPayload & {
+    voicemailUrl: string;
+    transcription?: string;
+    duration: number;
+};
+export type VideoCallPayload = VoiceCallPayload & {
+    type: "video";
+    callId: string;
+    status: CallStatus;
+    direction: CallDirection;
+    accountId: string;
+};
+export type VideoCallEndedPayload = VideoCallPayload & {
+    duration: number;
+    recordingUrl?: string;
+    quality?: "good" | "average" | "poor";
+};
+export type EmailPayload = {
+    from: {
+        email: string;
+        name?: string;
+    };
+    to: {
+        email: string;
+        name?: string;
+    }[];
+    cc?: {
+        email: string;
+        name?: string;
+    }[];
+    subject: string;
+    body: string;
+    bodySnippet?: string;
+    attachmentCount: number;
+    emailId: string;
+};
+export type ChatMessagePayload = {
+    text: string;
+    conversationId: string;
+};
+export type TranscriptAddedPayload = {
+    transcript: Transcript;
+};
+export type MeetingPayload = {
+    title: string;
+    meetingId: string;
+    participants: {
+        id?: string;
+        name: string;
+    }[];
+};
+export type MeetingEndedPayload = MeetingPayload & {
+    duration: number;
+    recordingUrl?: string;
+};
+export type CommentAddedPayload = {
+    text: string;
+    mentions?: string[];
+};
+export type FileUploadedPayload = {
+    fileName: string;
+    fileUrl: string;
+    fileType: string;
+    size: number;
+};
+export type InteractionStatusChangedPayload = {
+    fromStatus: "open" | "pending" | "closed";
+    toStatus: "open" | "pending" | "closed";
+};
+export type InteractionAssignedPayload = {
+    userId: string;
+    teamId?: string;
+};
+export type MeetingParticipantPayload = {
+    name: string;
+    id?: string;
+};
+export type AIMessageAddedPayload = {
+    message: AIMessage;
+};
+export type Activity = (BaseActivity & {
+    type: "VOICE_CALL_STARTED";
+    payload: VoiceCallPayload;
+}) | (BaseActivity & {
+    type: "VOICE_CALL_ANSWERED";
+    payload: VoiceCallPayload;
+}) | (BaseActivity & {
+    type: "VOICE_CALL_HOLD";
+    payload: VoiceCallPayload;
+}) | (BaseActivity & {
+    type: "VOICE_CALL_UNHOLD";
+    payload: VoiceCallPayload;
+}) | (BaseActivity & {
+    type: "VOICE_CALL_ENDED";
+    payload: VoiceCallEndedPayload;
+}) | (BaseActivity & {
+    type: "VOICE_CALL_MISSED";
+    payload: VoiceCallPayload;
+}) | (BaseActivity & {
+    type: "VOICE_CALL_FAILED";
+    payload: VoiceCallPayload;
+}) | (BaseActivity & {
+    type: "VOICE_CALL_VOICEMAIL";
+    payload: VoiceCallVoicemailPayload;
+}) | (BaseActivity & {
+    type: "VIDEO_CALL_STARTED";
+    payload: VideoCallPayload;
+}) | (BaseActivity & {
+    type: "VIDEO_CALL_ANSWERED";
+    payload: VideoCallPayload;
+}) | (BaseActivity & {
+    type: "VIDEO_CALL_HOLD";
+    payload: VideoCallPayload;
+}) | (BaseActivity & {
+    type: "VIDEO_CALL_UNHOLD";
+    payload: VideoCallPayload;
+}) | (BaseActivity & {
+    type: "VIDEO_CALL_ENDED";
+    payload: VideoCallEndedPayload;
+}) | (BaseActivity & {
+    type: "VIDEO_CALL_FAILED";
+    payload: VideoCallPayload;
+}) | (BaseActivity & {
+    type: "VIDEO_CALL_MISSED";
+    payload: VideoCallPayload;
+}) | (BaseActivity & {
+    type: "EMAIL_RECEIVED";
+    payload: EmailPayload;
+}) | (BaseActivity & {
+    type: "EMAIL_SENT";
+    payload: EmailPayload;
+}) | (BaseActivity & {
+    type: "CHAT_MESSAGE_SENT";
+    payload: ChatMessagePayload;
+}) | (BaseActivity & {
+    type: "CHAT_MESSAGE_RECEIVED";
+    payload: ChatMessagePayload;
+}) | (BaseActivity & {
+    type: "TRANSCRIPT_ADDED";
+    payload: TranscriptAddedPayload;
+}) | (BaseActivity & {
+    type: "AI_MESSAGE_ADDED";
+    payload: AIMessageAddedPayload;
+}) | (BaseActivity & {
+    type: "MEETING_SCHEDULED";
+    payload: MeetingPayload;
+}) | (BaseActivity & {
+    type: "MEETING_STARTED";
+    payload: MeetingPayload;
+}) | (BaseActivity & {
+    type: "MEETING_ENDED";
+    payload: MeetingEndedPayload;
+}) | (BaseActivity & {
+    type: "MEETING_PARTICIPANT_JOINED";
+    payload: MeetingParticipantPayload;
+}) | (BaseActivity & {
+    type: "MEETING_PARTICIPANT_LEFT";
+    payload: MeetingParticipantPayload;
+}) | (BaseActivity & {
+    type: "COMMENT_ADDED";
+    payload: CommentAddedPayload;
+}) | (BaseActivity & {
+    type: "FILE_UPLOADED";
+    payload: FileUploadedPayload;
+}) | (BaseActivity & {
+    type: "INTERACTION_CREATED";
+    payload: {};
+}) | (BaseActivity & {
+    type: "INTERACTION_STATUS_CHANGED";
+    payload: InteractionStatusChangedPayload;
+}) | (BaseActivity & {
+    type: "INTERACTION_ASSIGNED";
+    payload: InteractionAssignedPayload;
+});

package/dist/entities/ai-account/index.d.ts

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

package/dist/entities/ai-account/types.d.ts

@@ -0,0 +1,6 @@
+export interface AiAccount {
+    id: string;
+    organizationId: string;
+    vendor: string;
+    apiKey: string;
+}

package/dist/entities/ai-message/index.d.ts

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

package/dist/entities/ai-message/types.d.ts

@@ -0,0 +1,35 @@
+export interface AIMessageInput {
+    text: string;
+    type: "text";
+}
+export interface AIMessageOutput {
+    text: string;
+    type: "text";
+}
+export interface AIMessage {
+    id: string;
+    organizationId: string;
+    interactionId: string;
+    sender: "user" | "assistant" | "system";
+    timestamp: number;
+    input: AIMessageInput;
+    output: AIMessageOutput;
+    accountId?: string;
+    model?: string;
+    externalId?: string;
+}
+export interface AIMessageAskPayload {
+    interactionId: string;
+    input: AIMessageInput;
+    model: string;
+    accountId: string;
+    previousExternalId?: string;
+    providerConfig?: Record<string, any>;
+    instructions?: string;
+    systemPrompt?: string;
+    context?: Record<string, any>;
+}
+export interface AIMessageAskResponse {
+    output: AIMessageOutput;
+    externalId: string;
+}

package/dist/entities/ai-profile/index.d.ts

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

package/dist/entities/ai-profile/types.d.ts

@@ -0,0 +1,15 @@
+export interface PredefinedPrompt {
+    name: string;
+    prompt: string;
+}
+export interface AIProfile<T extends Record<string, any> = Record<string, any>> {
+    id: string;
+    organizationId: string;
+    name: string;
+    description?: string;
+    accountId: string;
+    model: string;
+    providerConfig?: T;
+    systemPrompt: string;
+    predefinedPrompts?: PredefinedPrompt[];
+}

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

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

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

@@ -0,0 +1,17 @@
+import { Uri } from '../communication/types';
+
+export interface Channel {
+    id: string;
+    organizationId: string;
+    providerId: string;
+    name: string;
+    description?: string;
+    icon?: string;
+    color?: string;
+    addressUri: Uri;
+    inboxId?: string;
+    ownerId: string;
+    settings: Record<string, any>;
+    enabled: boolean;
+    verified: boolean;
+}

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

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

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

@@ -0,0 +1,84 @@
+export type CommunicationProtocol = "sip" | "webrtc" | "custom";
+export type SessionType = "audio" | "video" | "data" | "screen-share";
+export type SessionDirection = "inbound" | "outbound";
+export type SessionState = "new" | "connecting" | "ringing" | "connected" | "held" | "ended" | "failed";
+export type AccountStatus = "registering" | "registered" | "unregistered" | "failed";
+export type AuthType = "password" | "token" | "certificate" | "custom";
+export interface Participant {
+    id: string;
+    user?: string;
+    displayName?: string;
+    avatar?: string;
+    status?: "connected" | "ringing" | "held" | "disconnected";
+    isMuted?: boolean;
+    isSpeaking?: boolean;
+    metadata?: Record<string, any>;
+    isLocal?: boolean;
+}
+export interface Account<TProviderData = any> {
+    id: string;
+    displayName: string;
+    uri: string;
+    status: AccountStatus;
+    providerId: string;
+    providerData: TProviderData;
+    organizationId: string;
+    userId: string;
+    domain?: string;
+    registeredAt?: Date;
+    metadata: Record<string, any>;
+}
+export interface AccountConfig<TProviderConfig = any> {
+    id?: string;
+    displayName: string;
+    uri: string;
+    domain?: string;
+    auth: {
+        type: AuthType;
+        credentials: Record<string, any>;
+    };
+    endpoints?: string[];
+    providerConfig?: TProviderConfig;
+    metadata?: Record<string, any>;
+    targetFormatter?: (target: string, account: Account) => string;
+    rtcConfiguration?: any;
+}
+export interface SessionOptions {
+    id?: string;
+    type: SessionType;
+    target: string;
+    accountId: string;
+    iceServers?: RTCIceServer[];
+    mediaConstraints?: MediaStreamConstraints;
+    metadata?: Record<string, any>;
+}
+export interface Transcription {
+    startTime: number;
+    endTime: number;
+    text: string;
+    speaker?: string;
+}
+export interface SessionMetadata {
+    [custom: string]: unknown;
+}
+export interface Session<TProviderData = any> {
+    id: string;
+    type: SessionType;
+    direction: SessionDirection;
+    state: SessionState;
+    participants: Participant[];
+    collaborators: string[];
+    accountId: string;
+    organizationId: string;
+    userId: string;
+    providerId: string;
+    providerData: TProviderData;
+    startTime: Date;
+    endTime?: Date;
+    metadata: SessionMetadata;
+}
+export type CommunicationScheme = "sip" | "tel" | "mailto" | "chat" | "internal" | "webhook" | "username" | "id" | "custom" | "url";
+export interface Uri {
+    scheme: CommunicationScheme;
+    resource: string;
+}

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * Data model for a single Contact.
+ */
+export interface Contact {
+    id: string;
+    organizationId: string;
+    firstName: string;
+    lastName?: string;
+    company?: string;
+    email?: string;
+    phone?: string;
+    address?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}

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

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

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

@@ -0,0 +1,9 @@
+export interface Inbox {
+    id: string;
+    organizationId: string;
+    displayName: string;
+    description: string;
+    members: string[];
+    createdAt: string;
+    updatedAt: string;
+}

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

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

package/dist/entities/interaction/logic.d.ts

@@ -0,0 +1,18 @@
+import { Interaction } from './types';
+
+/**
+ * Checks if the interaction is currently assigned to a user or an inbox.
+ */
+export declare const isAssigned: (interaction: Interaction) => boolean;
+/**
+ * Checks if the interaction is closed.
+ */
+export declare const isClosed: (interaction: Interaction) => boolean;
+/**
+ * Gets a numerical urgency score based on priority.
+ */
+export declare const getUrgencyScore: (interaction: Interaction) => number;
+/**
+ * Returns a shortened version of the interaction title.
+ */
+export declare const getShortTitle: (interaction: Interaction, maxLength?: number) => string;

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

@@ -0,0 +1,36 @@
+import { Uri } from '../communication/types';
+
+export interface InteractionSource {
+    activityId?: string;
+    activityType?: string;
+    initiator: "user" | "contact" | "system";
+    initiatorId?: string;
+    provider: {
+        id?: string;
+        name?: string;
+        externalId?: string;
+    };
+}
+export interface InteractionLink {
+    url?: string;
+    providerId?: string;
+    externalId?: string;
+    title: string;
+}
+export interface Interaction {
+    id: string;
+    organizationId: string;
+    assignedInboxId?: string;
+    channelId?: string;
+    title: string;
+    status: "open" | "pending" | "closed" | "snoozed";
+    priority: "urgent" | "high" | "normal" | "low";
+    remoteParty: Uri;
+    source?: InteractionSource;
+    tags: string[];
+    links: InteractionLink[];
+    collaborators: string[];
+    assignedUserId?: string;
+    createdAt: number;
+    updatedAt: number;
+}

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * Data model for a single Note.
+ */
+export interface Note {
+    id: string;
+    organizationId: string;
+    interactionId: string;
+    serviceName: string;
+    authorId: string;
+    authorDisplayName: string;
+    content: string;
+    createdAt: Date;
+    updatedAt: Date;
+}

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

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

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

@@ -0,0 +1,11 @@
+export interface Organization {
+    id: string;
+    name: string;
+    displayName: string;
+    enabledApps: string[];
+    roles: string[];
+    scopes: string[];
+    domain: string;
+    defaultApp?: string;
+    permissions?: string[];
+}

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

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

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

@@ -0,0 +1,10 @@
+export interface Transcript {
+    id: string;
+    organizationId: string;
+    interactionId: string;
+    serviceName: string;
+    text: string;
+    speaker?: string;
+    startTime?: number;
+    endTime?: number;
+}

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

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

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

@@ -0,0 +1,6 @@
+export interface User {
+    id: string;
+    name: string;
+    email: string;
+    availableOrganizations: string[];
+}

package/dist/index.cjs

@@ -0,0 +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))(t||{});exports.CommunicationScheme=t;exports.getShortTitle=d;exports.getUrgencyScore=g;exports.isAssigned=e;exports.isClosed=l;

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+export * from './entities/activity';
+export * from './entities/ai-account';
+export * from './entities/ai-message';
+export * from './entities/ai-profile';
+export * from './entities/channel';
+export * from './entities/contact';
+export * from './entities/inbox';
+export * from './entities/interaction';
+export * from './entities/note';
+export * from './entities/organization';
+export * from './entities/transcript';
+export * from './entities/user';
+export * from './platform/api';
+export * from './platform/common';
+export * from './platform/communication';
+export * from './platform/federated';
+export * from './platform/intents';
+export * from './platform/kernel';
+export * from './platform/lifecycle';
+export * from './platform/localization';
+export * from './platform/manifest';
+export * from './platform/menu';
+export * from './platform/reactive';
+export * from './platform/routing';
+export * from './platform/sdk';
+export * from './platform/service-registry';
+export * from './platform/services';
+export * from './platform/ui';

package/dist/index.js

@@ -0,0 +1,14 @@
+const l = (s) => !!s.assignedUserId || !!s.assignedInboxId, g = (s) => s.status === "closed", d = (s) => ({
+  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))(t || {});
+export {
+  t as CommunicationScheme,
+  A as getShortTitle,
+  d as getUrgencyScore,
+  l as isAssigned,
+  g as isClosed
+};

package/dist/platform/api.d.ts

@@ -0,0 +1,19 @@
+import { AppManifest } from './manifest';
+
+export interface InvokeOptions {
+    action: string;
+    params?: Record<string, any>;
+    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+    body?: any;
+    timeout?: number;
+    transport?: "ws" | "http";
+    manifest?: AppManifest;
+}
+export type SSEMessage<Payload = {
+    event: string;
+    payload: any;
+}> = {
+    tenant: string;
+    app: string;
+    payload: Payload;
+};

package/dist/platform/common.d.ts

@@ -0,0 +1,7 @@
+export interface IconDefinition {
+    type: "emoji" | "resource" | "iconName";
+    content: string;
+    className?: string;
+    fill?: string;
+    color?: string;
+}

package/dist/platform/communication.d.ts

@@ -0,0 +1,75 @@
+import { Uri } from '../entities/communication/types';
+
+export type SessionState = 'idle' | 'ringing' | 'connecting' | 'connected' | 'on_hold' | 'ended' | 'failed';
+export interface Session {
+    id: string;
+    accountId: string;
+    providerId: string;
+    direction: 'inbound' | 'outbound';
+    remoteIdentity: string;
+    state: SessionState;
+    startTime?: number;
+    hasVideo: boolean;
+    isMuted: boolean;
+    ui: {
+        canvas: `${string}:${string}`;
+        actionTray?: `${string}:${string}`;
+    };
+}
+export interface CommsAccount<T = any> {
+    id: string;
+    providerId: string;
+    label: string;
+    protocol: string;
+    organizationId: string;
+    userId: string;
+    config: T;
+    status: 'registered' | 'unregistered' | 'error';
+}
+export interface ITransportProvider {
+    readonly id: string;
+    subscribeSessions(callback: (sessions: Session[]) => void): () => void;
+    subscribeAccounts(callback: (accounts: CommsAccount[]) => void): () => void;
+    subscribeStreams(callback: (data: {
+        sessionId: string;
+        stream: MediaStream;
+    }) => void): () => void;
+    createSession(target: string, accountId: string): Promise<void>;
+    hangupSession(sessionId: string): Promise<void>;
+    registerAccount(orgId: string, userId: string, config: any): Promise<CommsAccount>;
+    unregisterAccount(accountId: string): Promise<void>;
+    setOutgoingStream(sessionId: string, stream: MediaStream | null): Promise<void>;
+}
+export interface ComposePayload {
+    body: string;
+    channelId: string;
+    recipientUri: Uri;
+    subject?: string;
+    interactionId?: string;
+}
+export interface Capability {
+    scheme: string;
+    key: string;
+    value: boolean;
+}
+export declare enum CommunicationScheme {
+    MAILTO = "mailto",
+    SIP = "sip",
+    TEL = "tel",
+    WEBHOOK = "webhook",
+    USERNAME = "username",
+    ID = "id",
+    CUSTOM = "custom",
+    URL = "url",
+    TELEGRAM = "telegram",
+    WHATSAPP = "whatsapp",
+    VIBER = "viber",
+    SMS = "sms",
+    FAX = "fax"
+}
+export interface ProviderDescription {
+    id?: string;
+    displayName: string;
+    capabilities: Capability[];
+    supportedSchemes: CommunicationScheme[];
+}

package/dist/platform/federated.d.ts

@@ -0,0 +1,10 @@
+export interface MountOptions {
+    container: HTMLElement;
+    props?: Record<string, any>;
+}
+export type MountFn = (options: MountOptions) => void;
+export type UnmountFn = (container: HTMLElement) => void;
+export interface FederatedResource {
+    mount: MountFn;
+    unmount?: UnmountFn;
+}

package/dist/platform/intents.d.ts

@@ -0,0 +1,10 @@
+export interface IntentRequest {
+    protocol: string;
+    value: string;
+    metadata?: Record<string, any>;
+}
+export interface IntentHandler {
+    id: string;
+    protocols: string[];
+    handle: (request: IntentRequest) => Promise<boolean | string>;
+}

package/dist/platform/kernel.d.ts

@@ -0,0 +1,17 @@
+import { Organization } from '../entities/organization/types';
+import { User } from '../entities/user/types';
+
+export interface PlatformContext {
+    user: User | null;
+    activeOrg: Organization | null;
+    env: 'production' | 'staging' | 'dev';
+    locale: string;
+    isAuthenticated: boolean;
+    isOrgSelected: boolean;
+}
+export interface PlatformConfig {
+    httpUrl: string;
+    wsUrl: string;
+    registryUrl: string;
+    shellVersion: string;
+}

package/dist/platform/lifecycle.d.ts

@@ -0,0 +1,13 @@
+export interface AppLifecycle {
+    /** * On-load: Registreer services, menu-items en andere metadata.
+     * Wordt éénmalig uitgevoerd bij het laden van de JS.
+     */
+    setup: () => void;
+    /** * On-mount: Render de UI in de meegeleverde container.
+     * Wordt uitgevoerd wanneer de gebruiker naar de app navigeert.
+     */
+    mount: (container: HTMLElement, props?: any) => void;
+    /** * On-unmount: Ruim eventuele listeners of DOM-elementen op.
+     */
+    unmount: (container: HTMLElement) => void;
+}

package/dist/platform/localization.d.ts

@@ -0,0 +1,7 @@
+export type LocaleTranslations = Record<string, string>;
+export type Translations = Record<string, LocaleTranslations>;
+type Prev = [never, 0, 1, 2, 3, 4, 5, ...0[]];
+export type Paths<T, D extends number = 5> = [D] extends [never] ? never : T extends object ? {
+    [K in keyof T]-?: K extends string | number ? T[K] extends object ? `${K}` | `${K}.${Paths<T[K], Prev[D]>}` : `${K}` : never;
+}[keyof T] : "";
+export {};

package/dist/platform/manifest.d.ts

@@ -0,0 +1,157 @@
+import { IconDefinition } from './common';
+import { Translations } from './localization';
+import { MenuItem } from './menu';
+import { RouteDefinition } from './routing';
+
+export interface ActionDefinition {
+    displayName: string;
+    description: string;
+}
+export interface Modules {
+    sidebar?: ModuleDefinition;
+    tools?: ModuleDefinition[];
+    assets?: ModuleDefinition[];
+    services?: ModuleDefinition[];
+    composers?: ModuleDefinition[];
+    activities?: ModuleDefinition[];
+    modals?: ModuleDefinition[];
+}
+export interface ModuleDefinition {
+    id?: string;
+    displayName: string;
+    description?: string;
+    icon?: IconDefinition;
+    resource?: string;
+    alwaysVisible?: boolean;
+    visibility?: {
+        paths?: string[];
+        permissions?: string[];
+    };
+    actions?: {
+        [key: string]: ActionDefinition[];
+    };
+}
+export type ResourceDefinition<T = any> = T;
+/**
+ * The AppManifest is the central contract between an application and the shell.
+ * It defines the app's identity, its components, its UI contributions,
+ * and most importantly, its security sandbox via the permissions block.
+ */
+export interface AppManifest<TSDK = any> {
+    /**
+     * The namespace of the application.
+     */
+    name: string;
+    /**
+     * The human-readable name of the application.
+     */
+    displayName: string;
+    /**
+     * Version of the application, following semantic versioning.
+     */
+    version: string;
+    /**
+     * The framework of the application.
+     */
+    framework?: 'react' | 'svelte' | 'other';
+    /**
+     * Optional short description of the application.
+     */
+    shortDescription?: string;
+    /**
+     * A brief description of what the application does.
+     */
+    description?: string;
+    /**
+     * Optional icon for the application.
+     */
+    icon?: IconDefinition;
+    /**
+     * Optional default route for the application.
+     */
+    defaultRoute?: string;
+    /**
+     * Optional priority for the application.
+     */
+    priority?: number;
+    /**
+     * Optional author of the application.
+     */
+    author?: string;
+    /**
+     * Optional categories for the application.
+     */
+    categories?: string[];
+    /**
+     * Optional tags for the application.
+     */
+    tags?: string[];
+    /**
+     * Optional support URL for the application.
+     */
+    supportUrl?: string;
+    /**
+     * Optional documentation URL for the application.
+     */
+    visibility?: 'public' | 'private';
+    /**
+     * Defines the security permissions for this app. The SDK will deny any
+     * action not explicitly granted here, following the principle of least privilege.
+     */
+    permissions?: {
+        /**
+         * Glob patterns for storage keys the app can access.
+         * @example ['settings', 'drafts_*', 'user-preferences']
+         */
+        storage?: string[];
+        /**
+         * Names of services the app is allowed to execute commands on.
+         * @example ['transcription-service', 'ai-summary']
+         */
+        services?: string[];
+        /**
+         * Names of remote functions (remotes) the app is allowed to invoke.
+         * @example ['fetch-customer-data']
+         */
+        remotes?: string[];
+        /**
+         * Glob patterns for store slices the app can create/access.
+         * @example ['session-state', 'ui-slice']
+         */
+        store?: string[];
+        /**
+         * Defines which communication actions the app is allowed to perform.
+         * @example ['session:create', 'session:read', 'account:read']
+         */
+        communication?: string[];
+    };
+    /**
+     * All resources that are being exported by this app.
+     */
+    resources?: Record<string, ResourceDefinition>;
+    /**
+     * All modules that are being used by this app.
+     */
+    modules?: Modules;
+    /**
+     * Routes this app contributes to the shell's router.
+     * Paths will be automatically prefixed with `/apps/{appName}`.
+     */
+    routes?: RouteDefinition[];
+    /** An array of menu items provided by this application. */
+    menu?: MenuItem[];
+    /** An array of translations provided by this application. */
+    translations?: Translations;
+    /**
+     * A function that will be called when the application is initialized.
+     */
+    initialize?: () => void;
+}
+export interface RemoteApp {
+    app: string;
+    version: string;
+}
+export interface RemoteAppRegistryResponse {
+    url: string;
+    apps: RemoteApp[];
+}

package/dist/platform/menu.d.ts

@@ -0,0 +1,22 @@
+import { IconDefinition } from './common';
+
+export interface MenuItem {
+    /** The label of the menu item. */
+    label: string;
+    /** The description of the menu item. */
+    description?: string;
+    /** The path of the menu item. */
+    path: string;
+    /** The icon of the menu item. */
+    icon?: IconDefinition;
+    /** The group of the menu item. */
+    group?: string;
+    /** The required capabilities of the menu item. */
+    requiredCapabilities?: string[];
+}
+export interface NamespacedMenuItem extends MenuItem {
+    /** The namespace of the menu item. */
+    namespace: string;
+    /** The absolute path of the menu item. */
+    absolutePath: string;
+}

package/dist/platform/reactive.d.ts

@@ -0,0 +1,13 @@
+export interface Subscriber<T> {
+    next: (value?: T) => void;
+    error?: (err: any) => void;
+    complete?: () => void;
+}
+export interface Observable<T> {
+    subscribe(subscriber: Subscriber<T>): () => void;
+}
+export interface Result<T> {
+    success: boolean;
+    value?: T;
+    error?: any;
+}

package/dist/platform/routing.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Defines a route handled by the application.
+ */
+export interface RouteDefinition {
+    /** The path for the route (e.g., "/settings"). */
+    path: string;
+    /** The resource to render for this route. */
+    resource: string;
+    /** If true, the path must match exactly. */
+    exact?: boolean;
+}
+export interface NamespacedRouteDefinition extends RouteDefinition {
+    appName: string;
+    /** The full, namespaced path, e.g., /apps/my-app/settings */
+    absolutePath: string;
+}

package/dist/platform/sdk.d.ts

@@ -0,0 +1,46 @@
+import { Observable } from 'rxjs';
+import { InvokeOptions, SSEMessage } from './api';
+import { PlatformConfig, PlatformContext } from './kernel';
+import { ServiceCallOptions, ServiceMap } from './services';
+import { ExtensionConfig, ToastConfig } from './ui';
+
+type ServiceKey<S extends ServiceMap> = keyof S;
+export type ParamsOf<S extends ServiceMap, K extends ServiceKey<S>> = S[K]['params'];
+export type PayloadOf<S extends ServiceMap, K extends ServiceKey<S>> = S[K]['payload'];
+export type ResponseOf<S extends ServiceMap, K extends ServiceKey<S>> = S[K]['response'];
+export type SSEHandlerOf<S extends ServiceMap, K extends ServiceKey<S>> = (payload: SSEMessage<PayloadOf<S, K>>) => Promise<void>;
+export interface InternalSDK<LocalServices extends ServiceMap = {}, TranslationKeys extends string = string, ModalKeys extends string = string, ExtensionKeys extends string = string> {
+    readonly context: PlatformContext;
+    readonly config: PlatformConfig;
+    readonly services: {
+        execute<K extends ServiceKey<LocalServices>>(key: K, options: ServiceCallOptions<ParamsOf<LocalServices, K>, PayloadOf<LocalServices, K>>): Promise<ResponseOf<LocalServices, K>>;
+        observe<K extends ServiceKey<LocalServices>>(key: K, options: ServiceCallOptions<ParamsOf<LocalServices, K>, PayloadOf<LocalServices, K>>): Observable<ResponseOf<LocalServices, K>>;
+    };
+    readonly http: {
+        invoke<R = any>(options: InvokeOptions): Promise<R>;
+    };
+    readonly router: {
+        navigate(path: string, options?: any): void;
+        currentPath: string;
+    };
+    readonly resources: {
+        get<T = any>(appName: string, resourceKey: string): Promise<T>;
+    };
+    readonly localization: {
+        t(key: TranslationKeys, params?: Record<string, any>): string;
+    };
+    readonly ui: {
+        modals: {
+            open(key: ModalKeys, props?: any): void;
+            close(key: ModalKeys): void;
+        };
+        toasts: {
+            show(config: ToastConfig): void;
+            close(id: string): void;
+        };
+        extensions: {
+            getForSlot(slot: string): Observable<ExtensionConfig[]>;
+        };
+    };
+}
+export {};

package/dist/platform/service-registry.d.ts

@@ -0,0 +1,14 @@
+import { Observable } from './reactive';
+
+export interface Command<TParams = any, TResponse = any> {
+    params: TParams;
+    response: TResponse;
+}
+export interface Query<TParams = any, TResponse = any> {
+    params: TParams;
+    response: TResponse;
+}
+export interface ServiceRegistry<TCommands extends Record<string, Command> = any, TQueries extends Record<string, Query> = any> {
+    execute<K extends keyof TCommands>(name: K, params: TCommands[K]["params"]): Promise<TCommands[K]["response"]>;
+    observe<K extends keyof TQueries>(name: K, params: TQueries[K]["params"]): Observable<TQueries[K]["response"]>;
+}

package/dist/platform/services.d.ts

@@ -0,0 +1,42 @@
+export interface ServiceDefinition<TParams = any, TPayload = any, TResponse = any> {
+    params?: TParams;
+    payload?: TPayload;
+    response?: TResponse;
+}
+export type ServiceMap = {
+    [key: string]: ServiceDefinition;
+};
+export interface GlobalServices extends ServiceMap {
+    'platform:router:push': {
+        params: {
+            path: string;
+            options?: any;
+        };
+        response: void;
+    };
+    'platform:auth:expired': {
+        params: {};
+        response: void;
+    };
+    'platform:ui:toast': {
+        params: {
+            message: string;
+            type: 'success' | 'error';
+        };
+        response: void;
+    };
+}
+export interface ServiceInvocation<T = any> {
+    appId: string;
+    data: T;
+    timestamp: number;
+}
+export type ServiceHandlerFn<P = any, T = any, R = any> = (options: ServiceCallOptions<P, T>) => Promise<R>;
+export type ServiceHandlerMetadata<P = any, T = any, R = any> = {
+    appId: string;
+    fn: ServiceHandlerFn<P, T, R>;
+};
+export type ServiceCallOptions<P, T> = {
+    params?: P;
+    payload?: T;
+};

package/dist/platform/ui.d.ts

@@ -0,0 +1,29 @@
+export interface ModalConfig {
+    id: string;
+    displayName: string;
+    resource: string;
+    size?: 'sm' | 'md' | 'lg' | 'xl';
+    position?: 'center' | 'top' | 'bottom' | 'left' | 'right' | 'corner' | 'sidebar';
+}
+export interface ToastConfig {
+    id: string;
+    title?: string;
+    type: 'success' | 'error' | 'warning' | 'info';
+    message?: string;
+    duration?: number;
+    actions?: {
+        label: string;
+        onClick: () => void;
+    }[];
+}
+export interface ExtensionConfig {
+    id: string;
+    slot: string;
+    displayName: string;
+    resource: string;
+    icon?: string;
+    priority?: number;
+    conditions?: {
+        [key: string]: any;
+    };
+}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@opencxh/domain",
+  "version": "1.1.4",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "rxjs": "^7.8.2"
+  },
+  "devDependencies": {
+    "typescript": "^5.2.2",
+    "vite": "^6.3.5",
+    "vite-plugin-dts": "^3.9.1"
+  }
+}