@messenger-box/platform-server 10.0.3-alpha.2 → 10.0.3-alpha.201

package/lib/channels/registry.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Channel registry - inspired by openclaw's registry,
+ * adapted to messenger-box's Props architecture.
+ *
+ * Defines the available channel types with metadata, capabilities,
+ * and dock configuration. Extends the existing RoomType enum with
+ * rich metadata and capability definitions.
+ */
+import type { IChannelCapabilities, IChannelDock, IChannelMeta } from './types';
+/**
+ * The ordered list of available channel types in the platform.
+ * Maps to RoomType enum values with extended metadata.
+ */
+export declare const CHANNEL_TYPE_ORDER: readonly ["direct", "channel", "group", "public", "private", "service", "aiassistant", "visitor"];
+export type ChannelTypeId = (typeof CHANNEL_TYPE_ORDER)[number];
+export declare const DEFAULT_CHANNEL_TYPE: ChannelTypeId;
+export declare const CHANNEL_TYPE_ALIASES: Record<string, ChannelTypeId>;
+export declare function listChannelTypes(): IChannelMeta[];
+export declare function getChannelTypeMeta(id: ChannelTypeId): IChannelMeta;
+export declare function normalizeChannelTypeId(raw?: string | null): ChannelTypeId | null;
+export declare function getChannelDock(id: ChannelTypeId): IChannelDock;
+export declare function getChannelCapabilities(id: ChannelTypeId): IChannelCapabilities;
+export declare function listChannelDocks(): IChannelDock[];

package/lib/channels/registry.js

@@ -0,0 +1,282 @@
+// ---------------------------------------------------------------------------
+// Channel Registry
+// ---------------------------------------------------------------------------
+/**
+ * The ordered list of available channel types in the platform.
+ * Maps to RoomType enum values with extended metadata.
+ */
+const CHANNEL_TYPE_ORDER = ['direct', 'channel', 'group', 'public', 'private', 'service', 'aiassistant', 'visitor'];
+const DEFAULT_CHANNEL_TYPE = 'channel';
+// ---------------------------------------------------------------------------
+// Channel Type Metadata
+// ---------------------------------------------------------------------------
+const CHANNEL_TYPE_META = {
+  direct: {
+    id: 'direct',
+    label: 'Direct Message',
+    selectionLabel: 'Direct Message (DM)',
+    detailLabel: 'Direct Message',
+    blurb: 'One-on-one private conversation between two users.',
+    systemImage: 'person.2',
+    order: 1
+  },
+  channel: {
+    id: 'channel',
+    label: 'Channel',
+    selectionLabel: 'Channel',
+    detailLabel: 'Organization Channel',
+    blurb: 'Standard channel for team communication within an organization.',
+    systemImage: 'number',
+    order: 2
+  },
+  group: {
+    id: 'group',
+    label: 'Group',
+    selectionLabel: 'Group Chat',
+    detailLabel: 'Group Conversation',
+    blurb: 'Group conversation with multiple participants.',
+    systemImage: 'person.3',
+    order: 3
+  },
+  public: {
+    id: 'public',
+    label: 'Public',
+    selectionLabel: 'Public Channel',
+    detailLabel: 'Public Channel',
+    blurb: 'Open channel visible and joinable by members from other organizations.',
+    systemImage: 'globe',
+    order: 4
+  },
+  private: {
+    id: 'private',
+    label: 'Private',
+    selectionLabel: 'Private Channel',
+    detailLabel: 'Private Channel',
+    blurb: 'Invite-only channel with restricted access.',
+    systemImage: 'lock',
+    order: 5
+  },
+  service: {
+    id: 'service',
+    label: 'Service',
+    selectionLabel: 'Service Channel',
+    detailLabel: 'Service Channel',
+    blurb: 'Automated service channel for system messages and integrations.',
+    systemImage: 'gearshape',
+    order: 6
+  },
+  aiassistant: {
+    id: 'aiassistant',
+    label: 'AI Assistant',
+    selectionLabel: 'AI Assistant Channel',
+    detailLabel: 'AI Assistant',
+    blurb: 'AI-powered assistant channel for automated responses.',
+    systemImage: 'brain',
+    order: 7
+  },
+  visitor: {
+    id: 'visitor',
+    label: 'Visitor',
+    selectionLabel: 'Visitor Channel',
+    detailLabel: 'Visitor Channel',
+    blurb: 'Channel for external visitors and guest interactions.',
+    systemImage: 'person.badge.plus',
+    order: 8
+  }
+};
+// ---------------------------------------------------------------------------
+// Channel Type Aliases
+// ---------------------------------------------------------------------------
+const CHANNEL_TYPE_ALIASES = {
+  dm: 'direct',
+  'direct-message': 'direct',
+  pub: 'public',
+  priv: 'private',
+  svc: 'service',
+  ai: 'aiassistant',
+  bot: 'aiassistant'
+};
+// ---------------------------------------------------------------------------
+// Registry API
+// ---------------------------------------------------------------------------
+function listChannelTypes() {
+  return CHANNEL_TYPE_ORDER.map(id => CHANNEL_TYPE_META[id]);
+}
+function getChannelTypeMeta(id) {
+  return CHANNEL_TYPE_META[id];
+}
+function normalizeChannelTypeId(raw) {
+  const normalized = raw?.trim().toLowerCase();
+  if (!normalized) return null;
+  const resolved = CHANNEL_TYPE_ALIASES[normalized] ?? normalized;
+  return CHANNEL_TYPE_ORDER.includes(resolved) ? resolved : null;
+}
+// ---------------------------------------------------------------------------
+// Channel Docks (lightweight behavior/metadata per channel type)
+// ---------------------------------------------------------------------------
+const DOCKS = {
+  direct: {
+    id: 'direct',
+    capabilities: {
+      chatTypes: ['direct'],
+      reactions: true,
+      edit: true,
+      reply: true,
+      threads: true,
+      media: true,
+      typingIndicators: true,
+      readReceipts: true,
+      presence: true,
+      forwarding: true,
+      pinning: true,
+      bookmarks: true,
+      search: true
+    }
+  },
+  channel: {
+    id: 'channel',
+    capabilities: {
+      chatTypes: ['channel', 'thread'],
+      reactions: true,
+      edit: true,
+      reply: true,
+      threads: true,
+      media: true,
+      typingIndicators: true,
+      readReceipts: true,
+      presence: true,
+      forwarding: true,
+      pinning: true,
+      bookmarks: true,
+      search: true,
+      groupManagement: true,
+      nativeCommands: true
+    },
+    threading: {
+      replyToMode: 'all'
+    }
+  },
+  group: {
+    id: 'group',
+    capabilities: {
+      chatTypes: ['group', 'thread'],
+      reactions: true,
+      edit: true,
+      reply: true,
+      threads: true,
+      media: true,
+      typingIndicators: true,
+      readReceipts: true,
+      presence: true,
+      forwarding: true,
+      pinning: true,
+      groupManagement: true,
+      search: true
+    },
+    threading: {
+      replyToMode: 'all'
+    }
+  },
+  public: {
+    id: 'public',
+    capabilities: {
+      chatTypes: ['channel', 'thread'],
+      reactions: true,
+      edit: true,
+      reply: true,
+      threads: true,
+      media: true,
+      typingIndicators: true,
+      readReceipts: false,
+      presence: false,
+      forwarding: true,
+      pinning: true,
+      bookmarks: true,
+      search: true,
+      groupManagement: true
+    },
+    threading: {
+      replyToMode: 'first'
+    }
+  },
+  private: {
+    id: 'private',
+    capabilities: {
+      chatTypes: ['channel', 'thread'],
+      reactions: true,
+      edit: true,
+      reply: true,
+      threads: true,
+      media: true,
+      typingIndicators: true,
+      readReceipts: true,
+      presence: true,
+      forwarding: true,
+      pinning: true,
+      bookmarks: true,
+      search: true,
+      groupManagement: true
+    },
+    threading: {
+      replyToMode: 'all'
+    }
+  },
+  service: {
+    id: 'service',
+    capabilities: {
+      chatTypes: ['channel'],
+      reactions: false,
+      edit: false,
+      reply: false,
+      threads: false,
+      media: true,
+      typingIndicators: false,
+      readReceipts: false,
+      presence: false,
+      nativeCommands: true
+    }
+  },
+  aiassistant: {
+    id: 'aiassistant',
+    capabilities: {
+      chatTypes: ['direct', 'thread'],
+      reactions: true,
+      edit: false,
+      reply: true,
+      threads: true,
+      media: true,
+      typingIndicators: true,
+      readReceipts: true,
+      blockStreaming: true,
+      nativeCommands: true
+    },
+    streaming: {
+      blockStreamingCoalesceDefaults: {
+        minChars: 100,
+        idleMs: 500
+      }
+    }
+  },
+  visitor: {
+    id: 'visitor',
+    capabilities: {
+      chatTypes: ['direct'],
+      reactions: false,
+      edit: false,
+      reply: true,
+      media: true,
+      typingIndicators: true,
+      readReceipts: false,
+      presence: false
+    }
+  }
+};
+function getChannelDock(id) {
+  return DOCKS[id];
+}
+function getChannelCapabilities(id) {
+  return DOCKS[id].capabilities;
+}
+function listChannelDocks() {
+  return CHANNEL_TYPE_ORDER.map(id => DOCKS[id]);
+}export{CHANNEL_TYPE_ALIASES,CHANNEL_TYPE_ORDER,DEFAULT_CHANNEL_TYPE,getChannelCapabilities,getChannelDock,getChannelTypeMeta,listChannelDocks,listChannelTypes,normalizeChannelTypeId};//# sourceMappingURL=registry.js.map

package/lib/channels/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sources":["../../src/channels/registry.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/lib/channels/sender-identity.d.ts

@@ -0,0 +1,11 @@
+export interface ISenderContext {
+    chatType?: string;
+    senderId?: string;
+    senderName?: string;
+    senderUsername?: string;
+    senderEmail?: string;
+}
+/**
+ * Validates sender identity fields, returning a list of issues found
+ */
+export declare function validateSenderIdentity(ctx: ISenderContext): string[];

package/lib/channels/sender-identity.js

@@ -0,0 +1,48 @@
+import {normalizeChatType}from'./types.js';/**
+ * Sender identity validation - inspired by openclaw's sender-identity,
+ * adapted to messenger-box's domain model.
+ *
+ * Validates sender identity fields for inbound messages to ensure
+ * proper attribution and security.
+ */
+// ---------------------------------------------------------------------------
+// Validation (mirrors openclaw's validateSenderIdentity)
+// ---------------------------------------------------------------------------
+/**
+ * Validates sender identity fields, returning a list of issues found
+ */
+function validateSenderIdentity(ctx) {
+  const issues = [];
+  const chatType = normalizeChatType(ctx.chatType);
+  const isDirect = chatType === 'direct';
+  const senderId = ctx.senderId?.trim() || '';
+  const senderName = ctx.senderName?.trim() || '';
+  const senderUsername = ctx.senderUsername?.trim() || '';
+  const senderEmail = ctx.senderEmail?.trim() || '';
+  // In non-direct contexts, require at least one identity field
+  if (!isDirect) {
+    if (!senderId && !senderName && !senderUsername && !senderEmail) {
+      issues.push('missing sender identity (senderId/senderName/senderUsername/senderEmail)');
+    }
+  }
+  // Validate email format if provided
+  if (senderEmail) {
+    if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(senderEmail)) {
+      issues.push(`invalid senderEmail: ${senderEmail}`);
+    }
+  }
+  // Validate username format if provided
+  if (senderUsername) {
+    if (senderUsername.includes('@')) {
+      issues.push(`senderUsername should not include "@": ${senderUsername}`);
+    }
+    if (/\s/.test(senderUsername)) {
+      issues.push(`senderUsername should not include whitespace: ${senderUsername}`);
+    }
+  }
+  // Check for empty-but-set fields
+  if (ctx.senderId != null && !senderId) {
+    issues.push('senderId is set but empty');
+  }
+  return issues;
+}export{validateSenderIdentity};//# sourceMappingURL=sender-identity.js.map

package/lib/channels/sender-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender-identity.js","sources":["../../src/channels/sender-identity.ts"],"sourcesContent":[null],"names":[],"mappings":"2CAAA;;;;;;AAMG;AAeH;AACA;AACA;AAEA;;AAEG;AACG,SAAU,sBAAsB,CAAC,GAAmB,EAAA;QACtD,MAAM,GAAM,EAAa;QAEzB,QAAM,oBAAW,CAAA,YAAsB,CAAA;AACvC,EAAA,MAAA,QAAM,GAAQ,QAAG,KAAQ;QAEzB,QAAM,GAAQ,GAAG,CAAA,QAAI,EAAQ,IAAE,EAAI,IAAE,EAAI;QACzC,UAAM,GAAU,GAAG,CAAA,UAAI,EAAU,IAAE,EAAI,IAAE,EAAI;QAC7C,cAAM,GAAc,GAAG,CAAA,cAAI,EAAc,IAAE,EAAI,IAAE,EAAI;QACrD,WAAM,GAAW,GAAG,CAAA,WAAI,EAAW,IAAE,EAAI,IAAE,EAAI;;MAG/C,CAAA,QAAK,EAAQ;AACT,IAAA,IAAA,CAAA,QAAK,IAAQ,CAAA,UAAK,IAAU,CAAA,cAAK,IAAc,CAAA,WAAK,EAAA;AAChD,MAAA,MAAA,CAAA,IAAA,CAAM,0EAAM,CAAA;;;;MAKpB,WAAI,EAAW;QACX,CAAA,iCAAkC,CAAA,WAAK,CAAA,EAAA;AACnC,MAAA,MAAA,CAAA,IAAA,CAAM,CAAC,kCAA6B,CAAA,CAAA,CAAA;;;;MAK5C,cAAI,EAAc;AACd,IAAA,IAAA,uBAAmB,CAAA,GAAQ,CAAC,EAAA;AACxB,MAAA,MAAA,CAAA,IAAA,CAAM,CAAC,uDAA+C,CAAA,CAAA,CAAA;;AAE1D,IAAA,IAAA,IAAI,KAAK,CAAA,cAAK,CAAA,EAAA;AACV,MAAA,MAAA,CAAA,IAAA,CAAM,CAAC,8DAAsD,CAAA,CAAA,CAAA;;;;MAKrE,GAAI,CAAA,QAAI,IAAQ,QAAQ,CAAA,QAAK,EAAQ;AACjC,IAAA,MAAA,CAAA,IAAO,CAAA,2BAAK,CAAA;;AAGhB,EAAA,OAAA;AACJ"}

package/lib/channels/session.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Session tracking - inspired by openclaw's session system,
+ * adapted to messenger-box's Props architecture.
+ *
+ * Tracks inbound/outbound sessions for messages, supporting
+ * last-route updates, group key resolution, and delivery context.
+ */
+export interface ISessionEntry {
+    /** Session key (unique per user+channel combo) */
+    sessionKey: string;
+    /** Last active channel */
+    lastChannel?: string;
+    /** Channel type */
+    channelType?: string;
+    /** Last target/destination */
+    lastTo?: string;
+    /** Account ID */
+    accountId?: string;
+    /** Thread ID */
+    threadId?: string;
+    /** Last activity timestamp */
+    lastActivityAt?: Date;
+    /** Session creation timestamp */
+    createdAt: Date;
+    /** Metadata */
+    metadata?: Record<string, unknown>;
+}
+export interface IDeliveryContext {
+    /** Channel through which message was delivered */
+    channel: string;
+    /** Target destination */
+    to: string;
+    /** Account ID used */
+    accountId?: string;
+    /** Thread ID if applicable */
+    threadId?: string;
+}
+export interface ISessionProps {
+    /** Whether session tracking is enabled */
+    enabled: boolean;
+    /** Session timeout in milliseconds */
+    timeoutMs: number;
+    /** Whether to track group conversations */
+    trackGroups: boolean;
+    /** Whether to record delivery context */
+    recordDeliveryContext: boolean;
+}
+export declare const DEFAULT_SESSION_PROPS: ISessionProps;
+/**
+ * Generates a unique session key from channel and user identifiers
+ */
+export declare function generateSessionKey(channelId: string, userId: string): string;
+/**
+ * Generates a group session key
+ */
+export declare function generateGroupSessionKey(channelId: string, groupId: string): string;
+export interface ILastRouteUpdate {
+    sessionKey: string;
+    channel: string;
+    to: string;
+    accountId?: string;
+    threadId?: string;
+}

package/lib/channels/session.js

@@ -0,0 +1,29 @@
+/**
+ * Session tracking - inspired by openclaw's session system,
+ * adapted to messenger-box's Props architecture.
+ *
+ * Tracks inbound/outbound sessions for messages, supporting
+ * last-route updates, group key resolution, and delivery context.
+ */
+const DEFAULT_SESSION_PROPS = {
+  enabled: true,
+  timeoutMs: 30 * 60 * 1000,
+  // 30 minutes
+  trackGroups: true,
+  recordDeliveryContext: true
+};
+// ---------------------------------------------------------------------------
+// Session Key Generation
+// ---------------------------------------------------------------------------
+/**
+ * Generates a unique session key from channel and user identifiers
+ */
+function generateSessionKey(channelId, userId) {
+  return `session:${channelId}:${userId}`.toLowerCase();
+}
+/**
+ * Generates a group session key
+ */
+function generateGroupSessionKey(channelId, groupId) {
+  return `session:group:${channelId}:${groupId}`.toLowerCase();
+}export{DEFAULT_SESSION_PROPS,generateGroupSessionKey,generateSessionKey};//# sourceMappingURL=session.js.map

package/lib/channels/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sources":["../../src/channels/session.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;AAMG;AAqDI,MAAM,qBAAqB,GAAkB;AAChD,EAAA,OAAA,EAAO,IAAE;AACT,EAAA,SAAA,EAAS,EAAE,GAAE,EAAG,GAAE,IAAG;AACrB;AACA,EAAA,WAAA,EAAA,IAAA;EACF,qBAAA,EAAA;AAEF;AACA;AACA;AAEA;;AAEG;AACH;AACI,SAAO,kBAAoB,CAAI,SAAS,EAAA,MAAA,EAAA;AAC5C,EAAC,OAAA,CAAA,QAAA,EAAA,SAAA,CAAA,CAAA,EAAA,MAAA,CAAA,CAAA,CAAA,WAAA,EAAA;AAED;;AAEG;AACH;AACI,SAAO,uBAA0B,CAAA,WAAc,OAAA,EAAA;AACnD,EAAC,OAAA,CAAA,cAAA,EAAA,SAAA,CAAA,CAAA,EAAA,OAAA,CAAA,CAAA,CAAA,WAAA,EAAA;"}

package/lib/channels/types.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Channel types and capabilities - inspired by openclaw's channel plugin system,
+ * adapted to messenger-box's Props architecture.
+ *
+ * These types define the capability model, metadata, and configuration for
+ * channels, posts, and threads. They follow the existing Props pattern
+ * (e.g., INotificationProps) used throughout the messenger platform.
+ */
+export type ChatType = 'direct' | 'group' | 'channel' | 'thread';
+export declare function normalizeChatType(raw?: string | null): ChatType | undefined;
+export interface IChannelCapabilities {
+    /** Supported chat types */
+    chatTypes: ChatType[];
+    /** Supports polls */
+    polls?: boolean;
+    /** Supports reactions (emoji, etc.) */
+    reactions?: boolean;
+    /** Supports message editing */
+    edit?: boolean;
+    /** Supports unsending messages */
+    unsend?: boolean;
+    /** Supports reply/quote */
+    reply?: boolean;
+    /** Supports message effects (confetti, etc.) */
+    effects?: boolean;
+    /** Supports group management (add/remove members, roles) */
+    groupManagement?: boolean;
+    /** Supports native threads (not just replies) */
+    threads?: boolean;
+    /** Supports media attachments (images, audio, video, files) */
+    media?: boolean;
+    /** Supports native slash commands */
+    nativeCommands?: boolean;
+    /** Supports block/chunked streaming */
+    blockStreaming?: boolean;
+    /** Supports typing indicators */
+    typingIndicators?: boolean;
+    /** Supports read receipts */
+    readReceipts?: boolean;
+    /** Supports presence/status */
+    presence?: boolean;
+    /** Supports message forwarding */
+    forwarding?: boolean;
+    /** Supports pinning messages */
+    pinning?: boolean;
+    /** Supports bookmarks/favorites */
+    bookmarks?: boolean;
+    /** Supports message search */
+    search?: boolean;
+    /** Supports scheduling messages */
+    scheduling?: boolean;
+}
+export interface IChannelMeta {
+    /** Unique channel type identifier */
+    id: string;
+    /** Human-readable label */
+    label: string;
+    /** Label for selection UI */
+    selectionLabel: string;
+    /** Documentation path */
+    docsPath?: string;
+    /** Short description / blurb */
+    blurb?: string;
+    /** Sort order */
+    order?: number;
+    /** Alternative names / aliases */
+    aliases?: string[];
+    /** Detail label for channel info */
+    detailLabel?: string;
+    /** Icon name / system image */
+    systemImage?: string;
+    /** Whether to show in configured list */
+    showConfigured?: boolean;
+}
+export interface IChannelDock {
+    /** Channel type identifier */
+    id: string;
+    /** Channel capabilities */
+    capabilities: IChannelCapabilities;
+    /** Outbound message constraints */
+    outbound?: {
+        textChunkLimit?: number;
+    };
+    /** Streaming configuration */
+    streaming?: {
+        blockStreamingCoalesceDefaults?: {
+            minChars?: number;
+            idleMs?: number;
+        };
+    };
+    /** Threading configuration */
+    threading?: IThreadingConfig;
+}
+export interface IThreadingConfig {
+    /** Reply-to mode: off = no threading, first = reply to first, all = reply to all */
+    replyToMode?: 'off' | 'first' | 'all';
+    /** Allow explicit reply tags when reply-to mode is off */
+    allowExplicitReplyTagsWhenOff?: boolean;
+}
+export interface IThreadingContext {
+    /** Current channel ID */
+    currentChannelId?: string;
+    /** Current thread timestamp/ID */
+    currentThreadTs?: string;
+    /** Reference to whether a reply has been sent */
+    hasRepliedRef?: {
+        value: boolean;
+    };
+    /** Reply-to mode override */
+    replyToMode?: 'off' | 'first' | 'all';
+}
+export type MessagingTargetKind = 'user' | 'channel' | 'group';
+export interface IMessagingTarget {
+    kind: MessagingTargetKind;
+    id: string;
+    raw: string;
+    normalized: string;
+}
+export declare function normalizeTargetId(kind: MessagingTargetKind, id: string): string;
+export declare function buildMessagingTarget(kind: MessagingTargetKind, id: string, raw: string): IMessagingTarget;
+export interface IChannelAccountSnapshot {
+    accountId: string;
+    name?: string;
+    enabled?: boolean;
+    configured?: boolean;
+    connected?: boolean;
+    reconnectAttempts?: number;
+    lastConnectedAt?: number | null;
+    lastMessageAt?: number | null;
+    lastEventAt?: number | null;
+    lastError?: string | null;
+    lastStartAt?: number | null;
+    lastStopAt?: number | null;
+    lastInboundAt?: number | null;
+    lastOutboundAt?: number | null;
+    mode?: string;
+    dmPolicy?: string;
+    allowFrom?: string[];
+}
+export type ChannelStatusKind = 'intent' | 'permissions' | 'config' | 'auth' | 'runtime';
+export interface IChannelStatusIssue {
+    channel: string;
+    accountId: string;
+    kind: ChannelStatusKind;
+    message: string;
+    fix?: string;
+}

package/lib/channels/types.js

@@ -0,0 +1,28 @@
+/**
+ * Channel types and capabilities - inspired by openclaw's channel plugin system,
+ * adapted to messenger-box's Props architecture.
+ *
+ * These types define the capability model, metadata, and configuration for
+ * channels, posts, and threads. They follow the existing Props pattern
+ * (e.g., INotificationProps) used throughout the messenger platform.
+ */
+function normalizeChatType(raw) {
+  const value = raw?.trim().toLowerCase();
+  if (!value) return undefined;
+  if (value === 'direct' || value === 'dm') return 'direct';
+  if (value === 'group') return 'group';
+  if (value === 'channel') return 'channel';
+  if (value === 'thread') return 'thread';
+  return undefined;
+}
+function normalizeTargetId(kind, id) {
+  return `${kind}:${id}`.toLowerCase();
+}
+function buildMessagingTarget(kind, id, raw) {
+  return {
+    kind,
+    id,
+    raw,
+    normalized: normalizeTargetId(kind, id)
+  };
+}export{buildMessagingTarget,normalizeChatType,normalizeTargetId};//# sourceMappingURL=types.js.map

package/lib/channels/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":["../../src/channels/types.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;AAOG;AAQG,SAAU,iBAAiB,CAAC,GAAmB,EAAA;QACjD,KAAM,MAAQ,EAAG,MAAM,CAAA,WAAG,EAAW;AACrC,EAAA,IAAA,CAAA,KAAK,EAAK,OAAA,SAAA;AAAE,EAAA,IAAA,KAAA,aAAgB,IAAC,KAAA,KAAA,IAAA,EAAA,OAAA,QAAA;AAC7B,EAAA,IAAA,UAAS,OAAK,EAAA,OAAY;AAAgB,EAAA,IAAA,KAAA,cAAgB,EAAA,OAAA,SAAA;MAC1D,KAAI,aAAU,EAAO,OAAA,QAAA;AAAE,EAAA,OAAA;;AACE,0BAAiB,CAAA,IAAA,EAAA,EAAA,EAAA;SACtC,CAAA,EAAA,MAAU,EAAA,EAAA,CAAA,CAAA,CAAA,WAAQ,EAAA;AAAE;AACxB,6BAAiB,CAAA,IAAA,EAAA,EAAA,EAAA,GAAA,EAAA;AACrB,EAAC,OAAA;AAuID,IAAA,IAAM;IACF,EAAA;AACJ,IAAC,GAAA;AAED,IAAA,YAAgB,iBAAA,CAAA,QAA8C;AAC1D,GAAA;AACJ"}