catalist-support-agent 1.0.0

package/dist/intake/postmark.js.map

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

package/dist/intake/slack.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Slack Event Handler
+ *
+ * Receives incoming Slack events via Events API, validates signatures,
+ * and normalizes message events into the standard message format.
+ */
+import type { InboundMessage } from '../types.js';
+import { type SlackMessageEvent, type SlackEventWrapper } from './normalizer.js';
+export interface SlackProcessResult {
+    success: boolean;
+    message?: InboundMessage;
+    contentHash?: string;
+    hasForbiddenTerms: boolean;
+    detectedTerms: string[];
+    error?: string;
+    isChallenge?: boolean;
+    challengeResponse?: string;
+}
+export interface SlackUrlVerification {
+    type: 'url_verification';
+    challenge: string;
+    token: string;
+}
+/**
+ * Validate Slack webhook signature using HMAC-SHA256
+ *
+ * Slack signs webhooks using:
+ * - Signing secret
+ * - Timestamp (to prevent replay attacks)
+ * - Request body
+ */
+export declare function validateSlackSignature(signature: string, timestamp: string, body: string, signingSecret: string): boolean;
+/**
+ * Validate Slack webhook request
+ */
+export declare function validateSlackWebhook(signature: string, timestamp: string, body: string): boolean;
+/**
+ * Check if event is URL verification challenge
+ */
+export declare function isUrlVerification(event: unknown): event is SlackUrlVerification;
+/**
+ * Check if event is a valid message event
+ */
+export declare function isMessageEvent(event: SlackEventWrapper): boolean;
+/**
+ * Check if message is a direct message (DM)
+ */
+export declare function isDirectMessage(event: SlackMessageEvent): boolean;
+/**
+ * Check if message is from a bot
+ */
+export declare function isBotMessage(event: SlackMessageEvent): boolean;
+/**
+ * Process a Slack message event
+ */
+export declare function processSlackMessage(eventWrapper: SlackEventWrapper): Promise<SlackProcessResult>;
+/**
+ * Full webhook handler for Slack events
+ */
+export declare function handleSlackEvent(rawBody: string, signature: string, timestamp: string): Promise<SlackProcessResult>;
+/**
+ * Parse Slack message text to extract mentions
+ */
+export declare function extractMentions(text: string): string[];
+/**
+ * Parse Slack message text to extract channel references
+ */
+export declare function extractChannelReferences(text: string): string[];
+/**
+ * Parse Slack message text to extract links
+ */
+export declare function extractLinks(text: string): Array<{
+    url: string;
+    label?: string;
+}>;
+/**
+ * Clean Slack message text (remove formatting, expand entities)
+ */
+export declare function cleanSlackText(text: string): string;
+/**
+ * Determine if this is a B2B customer DM channel
+ * In practice, this would check against known customer Slack workspaces
+ */
+export declare function isB2BCustomerChannel(teamId: string, channelId: string): {
+    isB2B: boolean;
+    reason?: string;
+};
+/**
+ * Check if message should be processed (not from internal team, etc.)
+ */
+export declare function shouldProcessSlackMessage(eventWrapper: SlackEventWrapper): {
+    shouldProcess: boolean;
+    reason?: string;
+};
+/**
+ * Format text for Slack (basic markdown to Slack mrkdwn)
+ */
+export declare function formatForSlack(text: string): string;
+/**
+ * Generate Slack Block Kit message structure
+ */
+export declare function generateSlackBlocks(text: string, options?: {
+    includeActions?: boolean;
+    conversationId?: string;
+}): unknown[];
+//# sourceMappingURL=slack.d.ts.map

package/dist/intake/slack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../../src/intake/slack.ts"],"names":[],"mappings":"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"}

package/dist/intake/slack.js

@@ -0,0 +1,378 @@
+/**
+ * Slack Event Handler
+ *
+ * Receives incoming Slack events via Events API, validates signatures,
+ * and normalizes message events into the standard message format.
+ */
+import { createHmac, timingSafeEqual } from 'crypto';
+import { config } from '../config.js';
+import { IntakeError, WebhookValidationError } from '../errors.js';
+import { normalizeSlackMessage, generateContentHash, validateMessageContent, scanAndAnnotateMessage, } from './normalizer.js';
+// =============================================================================
+// Signature Validation
+// =============================================================================
+/**
+ * Validate Slack webhook signature using HMAC-SHA256
+ *
+ * Slack signs webhooks using:
+ * - Signing secret
+ * - Timestamp (to prevent replay attacks)
+ * - Request body
+ */
+export function validateSlackSignature(signature, timestamp, body, signingSecret) {
+    if (!signature || !timestamp || !signingSecret) {
+        return false;
+    }
+    // Check timestamp is recent (within 5 minutes)
+    const timestampSeconds = parseInt(timestamp, 10);
+    const now = Math.floor(Date.now() / 1000);
+    if (Math.abs(now - timestampSeconds) > 300) {
+        // Request is older than 5 minutes
+        return false;
+    }
+    // Build the signature base string
+    const sigBase = `v0:${timestamp}:${body}`;
+    // Generate expected signature
+    const expectedSignature = 'v0=' + createHmac('sha256', signingSecret).update(sigBase).digest('hex');
+    // Timing-safe comparison
+    try {
+        const sig1 = Buffer.from(signature);
+        const sig2 = Buffer.from(expectedSignature);
+        if (sig1.length !== sig2.length) {
+            return false;
+        }
+        return timingSafeEqual(sig1, sig2);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Validate Slack webhook request
+ */
+export function validateSlackWebhook(signature, timestamp, body) {
+    const signingSecret = config.slack.signingSecret;
+    if (!signingSecret) {
+        // If no signing secret configured, skip signature validation
+        // This is not recommended for production
+        console.warn('Slack signing secret not configured - skipping signature validation');
+        return true;
+    }
+    return validateSlackSignature(signature, timestamp, body, signingSecret);
+}
+// =============================================================================
+// Event Processing
+// =============================================================================
+/**
+ * Check if event is URL verification challenge
+ */
+export function isUrlVerification(event) {
+    return (typeof event === 'object' &&
+        event !== null &&
+        'type' in event &&
+        event.type === 'url_verification');
+}
+/**
+ * Check if event is a valid message event
+ */
+export function isMessageEvent(event) {
+    return (event.type === 'event_callback' &&
+        event.event?.type === 'message' &&
+        !event.event.subtype && // Ignore edited messages, deleted messages, etc.
+        !!event.event.text &&
+        !!event.event.user);
+}
+/**
+ * Check if message is a direct message (DM)
+ */
+export function isDirectMessage(event) {
+    return event.channel_type === 'im';
+}
+/**
+ * Check if message is from a bot
+ */
+export function isBotMessage(event) {
+    // Messages from bots have a bot_id field or subtype of 'bot_message'
+    return event.subtype === 'bot_message' || ('bot_id' in event && !!event.bot_id);
+}
+/**
+ * Process a Slack message event
+ */
+export async function processSlackMessage(eventWrapper) {
+    try {
+        const event = eventWrapper.event;
+        // Validate it's a processable message
+        if (!event.text?.trim()) {
+            return {
+                success: false,
+                hasForbiddenTerms: false,
+                detectedTerms: [],
+                error: 'Empty message',
+            };
+        }
+        // Skip bot messages
+        if (isBotMessage(event)) {
+            return {
+                success: false,
+                hasForbiddenTerms: false,
+                detectedTerms: [],
+                error: 'Bot message ignored',
+            };
+        }
+        // Normalize the message into standard format
+        const message = normalizeSlackMessage(event, eventWrapper.team_id);
+        // Validate content exists
+        validateMessageContent(message);
+        // Generate content hash for deduplication
+        const contentHash = generateContentHash(message);
+        // Scan for forbidden terms
+        const { hasForbiddenTerms, detectedTerms } = scanAndAnnotateMessage(message);
+        return {
+            success: true,
+            message,
+            contentHash,
+            hasForbiddenTerms,
+            detectedTerms,
+        };
+    }
+    catch (error) {
+        if (error instanceof IntakeError) {
+            return {
+                success: false,
+                hasForbiddenTerms: false,
+                detectedTerms: [],
+                error: error.message,
+            };
+        }
+        return {
+            success: false,
+            hasForbiddenTerms: false,
+            detectedTerms: [],
+            error: error instanceof Error ? error.message : 'Unknown error processing Slack message',
+        };
+    }
+}
+/**
+ * Full webhook handler for Slack events
+ */
+export async function handleSlackEvent(rawBody, signature, timestamp) {
+    // Validate webhook signature
+    if (!validateSlackWebhook(signature, timestamp, rawBody)) {
+        throw new WebhookValidationError('slack', {
+            context: { reason: 'Invalid Slack signature' },
+        });
+    }
+    // Parse JSON body
+    let payload;
+    try {
+        payload = JSON.parse(rawBody);
+    }
+    catch {
+        return {
+            success: false,
+            hasForbiddenTerms: false,
+            detectedTerms: [],
+            error: 'Invalid JSON payload',
+        };
+    }
+    // Handle URL verification challenge
+    if (isUrlVerification(payload)) {
+        return {
+            success: true,
+            hasForbiddenTerms: false,
+            detectedTerms: [],
+            isChallenge: true,
+            challengeResponse: payload.challenge,
+        };
+    }
+    // Validate event structure
+    const eventWrapper = payload;
+    if (!isMessageEvent(eventWrapper)) {
+        return {
+            success: false,
+            hasForbiddenTerms: false,
+            detectedTerms: [],
+            error: 'Not a processable message event',
+        };
+    }
+    // Process the message
+    return processSlackMessage(eventWrapper);
+}
+// =============================================================================
+// Slack Utilities
+// =============================================================================
+/**
+ * Parse Slack message text to extract mentions
+ */
+export function extractMentions(text) {
+    // Slack mentions format: <@U12345678>
+    const mentionPattern = /<@([A-Z0-9]+)>/g;
+    const mentions = [];
+    let match;
+    while ((match = mentionPattern.exec(text)) !== null) {
+        if (match[1]) {
+            mentions.push(match[1]);
+        }
+    }
+    return mentions;
+}
+/**
+ * Parse Slack message text to extract channel references
+ */
+export function extractChannelReferences(text) {
+    // Slack channel format: <#C12345678|channel-name>
+    const channelPattern = /<#([A-Z0-9]+)\|?[^>]*>/g;
+    const channels = [];
+    let match;
+    while ((match = channelPattern.exec(text)) !== null) {
+        if (match[1]) {
+            channels.push(match[1]);
+        }
+    }
+    return channels;
+}
+/**
+ * Parse Slack message text to extract links
+ */
+export function extractLinks(text) {
+    // Slack link format: <https://example.com|Optional Label>
+    const linkPattern = /<(https?:\/\/[^|>]+)(?:\|([^>]+))?>/g;
+    const links = [];
+    let match;
+    while ((match = linkPattern.exec(text)) !== null) {
+        if (match[1]) {
+            links.push({
+                url: match[1],
+                label: match[2],
+            });
+        }
+    }
+    return links;
+}
+/**
+ * Clean Slack message text (remove formatting, expand entities)
+ */
+export function cleanSlackText(text) {
+    return text
+        // Replace user mentions with @user
+        .replace(/<@([A-Z0-9]+)>/g, '@user')
+        // Replace channel mentions with #channel
+        .replace(/<#([A-Z0-9]+)\|([^>]+)>/g, '#$2')
+        .replace(/<#([A-Z0-9]+)>/g, '#channel')
+        // Replace links with just the URL or label
+        .replace(/<(https?:\/\/[^|>]+)\|([^>]+)>/g, '$2')
+        .replace(/<(https?:\/\/[^>]+)>/g, '$1')
+        // Replace special markup
+        .replace(/<!here>/g, '@here')
+        .replace(/<!channel>/g, '@channel')
+        .replace(/<!everyone>/g, '@everyone')
+        // Decode common entities
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>');
+}
+// =============================================================================
+// Slack DM Context
+// =============================================================================
+/**
+ * Determine if this is a B2B customer DM channel
+ * In practice, this would check against known customer Slack workspaces
+ */
+export function isB2BCustomerChannel(teamId, channelId) {
+    // This would typically check against a database of connected B2B accounts
+    // For now, we assume all DMs are from potential B2B customers
+    // Could add logic like:
+    // - Check if team_id is in our list of connected workspace
+    // - Check if the channel is a known customer support channel
+    // - etc.
+    return {
+        isB2B: true,
+        reason: 'Direct message channel',
+    };
+}
+/**
+ * Check if message should be processed (not from internal team, etc.)
+ */
+export function shouldProcessSlackMessage(eventWrapper) {
+    const event = eventWrapper.event;
+    // Skip bot messages
+    if (isBotMessage(event)) {
+        return {
+            shouldProcess: false,
+            reason: 'Bot message',
+        };
+    }
+    // Skip messages without text
+    if (!event.text?.trim()) {
+        return {
+            shouldProcess: false,
+            reason: 'Empty message',
+        };
+    }
+    // Skip non-DM channels (we only handle B2B customer DMs)
+    if (event.channel_type && event.channel_type !== 'im') {
+        return {
+            shouldProcess: false,
+            reason: 'Not a direct message',
+        };
+    }
+    // Check if it's from a B2B customer
+    const b2bCheck = isB2BCustomerChannel(eventWrapper.team_id, event.channel);
+    if (!b2bCheck.isB2B) {
+        return {
+            shouldProcess: false,
+            reason: b2bCheck.reason || 'Not a B2B customer channel',
+        };
+    }
+    return {
+        shouldProcess: true,
+    };
+}
+// =============================================================================
+// Response Formatting for Slack
+// =============================================================================
+/**
+ * Format text for Slack (basic markdown to Slack mrkdwn)
+ */
+export function formatForSlack(text) {
+    return text
+        // Bold: **text** -> *text*
+        .replace(/\*\*([^*]+)\*\*/g, '*$1*')
+        // Italic: _text_ stays the same
+        // Code: `code` stays the same
+        // Links: [text](url) -> <url|text>
+        .replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<$2|$1>');
+}
+/**
+ * Generate Slack Block Kit message structure
+ */
+export function generateSlackBlocks(text, options) {
+    const blocks = [
+        {
+            type: 'section',
+            text: {
+                type: 'mrkdwn',
+                text: formatForSlack(text),
+            },
+        },
+    ];
+    if (options?.includeActions && options.conversationId) {
+        blocks.push({
+            type: 'actions',
+            elements: [
+                {
+                    type: 'button',
+                    text: {
+                        type: 'plain_text',
+                        text: 'View in Portal',
+                        emoji: true,
+                    },
+                    url: `${config.escalation.adminBaseUrl}/support/${options.conversationId}`,
+                    action_id: 'view_in_portal',
+                },
+            ],
+        });
+    }
+    return blocks;
+}
+//# sourceMappingURL=slack.js.map

package/dist/intake/slack.js.map

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

package/dist/intake/twilio.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Twilio SMS Webhook Handler
+ *
+ * Receives incoming SMS messages via Twilio webhook, validates signatures,
+ * and normalizes SMS content into the standard message format.
+ */
+import type { InboundMessage } from '../types.js';
+import { type TwilioInboundSms } from './normalizer.js';
+export interface TwilioProcessResult {
+    success: boolean;
+    message?: InboundMessage;
+    contentHash?: string;
+    hasForbiddenTerms: boolean;
+    detectedTerms: string[];
+    error?: string;
+}
+/**
+ * Validate Twilio webhook signature using HMAC-SHA1
+ *
+ * Twilio signs webhooks using the auth token and the full URL + params
+ */
+export declare function validateTwilioSignature(signature: string, url: string, params: Record<string, string>, authToken: string): boolean;
+/**
+ * Validate Twilio webhook request
+ */
+export declare function validateTwilioWebhook(signature: string, url: string, params: Record<string, string>): boolean;
+/**
+ * Parse Twilio webhook body (URL-encoded)
+ */
+export declare function parseTwilioBody(body: string): TwilioInboundSms;
+/**
+ * Process an inbound Twilio SMS
+ */
+export declare function processTwilioSms(payload: TwilioInboundSms): Promise<TwilioProcessResult>;
+/**
+ * Full webhook handler for Twilio inbound SMS
+ */
+export declare function handleTwilioInbound(rawBody: string, signature: string, webhookUrl: string): Promise<TwilioProcessResult>;
+/**
+ * Check if message is a STOP/unsubscribe request
+ */
+export declare function isOptOutMessage(body: string): boolean;
+/**
+ * Check if message is a help request
+ */
+export declare function isHelpRequest(body: string): boolean;
+/**
+ * Classify SMS message type
+ */
+export declare function classifySms(sms: TwilioInboundSms): {
+    shouldProcess: boolean;
+    reason?: string;
+    classification: 'support' | 'opt_out' | 'help' | 'empty';
+};
+/**
+ * Check if SMS includes media attachments (MMS)
+ */
+export declare function hasMmsAttachments(sms: TwilioInboundSms): boolean;
+/**
+ * Extract MMS media URLs
+ */
+export declare function extractMmsMedia(sms: TwilioInboundSms): Array<{
+    url: string;
+    contentType: string;
+}>;
+/**
+ * Extract country code from phone number
+ */
+export declare function extractCountryCode(phone: string): string | undefined;
+/**
+ * Determine if phone number is US/Canada
+ */
+export declare function isNorthAmericanNumber(phone: string): boolean;
+/**
+ * Generate TwiML response for immediate reply
+ */
+export declare function generateTwimlResponse(message?: string): string;
+/**
+ * Generate TwiML for opt-out confirmation
+ */
+export declare function generateOptOutResponse(): string;
+/**
+ * Generate TwiML for help response
+ */
+export declare function generateHelpResponse(): string;
+//# sourceMappingURL=twilio.d.ts.map

package/dist/intake/twilio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twilio.d.ts","sourceRoot":"","sources":["../../src/intake/twilio.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAC;AAMzB,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,SAAS,EAAE,MAAM,GAChB,OAAO,CA6BT;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,OAAO,CAST;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAS9D;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAsC9B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,mBAAmB,CAAC,CAqB9B;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAerD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKnD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,gBAAgB,GAAG;IAClD,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;CAC1D,CA8BA;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAGhE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,gBAAgB,GACpB,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAiB7C;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAwBpE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAG5D;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAe9D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAI/C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAI7C"}