crewly 1.0.0

package/dist/backend/backend/src/services/slack/slack.service.d.ts

@@ -0,0 +1,219 @@
+/**
+ * Slack Service
+ *
+ * Manages Slack bot connection and messaging using Bolt SDK.
+ * Enables bidirectional communication between Slack and Crewly.
+ *
+ * @module services/slack
+ */
+import { EventEmitter } from 'events';
+import type { SlackConfig, SlackIncomingMessage, SlackOutgoingMessage, SlackServiceStatus, SlackConversationContext, SlackNotification, SlackBlock } from '../../types/slack.types.js';
+/**
+ * Events emitted by SlackService
+ */
+export interface SlackServiceEvents {
+    message: (message: SlackIncomingMessage) => void;
+    connected: () => void;
+    disconnected: (error?: Error) => void;
+    error: (error: Error) => void;
+}
+/**
+ * Options for uploading a file to Slack.
+ * Used by both uploadImage() and uploadFile().
+ */
+interface FileUploadOptions {
+    channelId: string;
+    filePath: string;
+    filename?: string;
+    title?: string;
+    initialComment?: string;
+    threadTs?: string;
+}
+/**
+ * SlackService class for managing Slack bot operations
+ */
+export declare class SlackService extends EventEmitter {
+    private app;
+    private client;
+    private config;
+    private status;
+    private conversationContexts;
+    /**
+     * Initialize the Slack service with configuration
+     *
+     * @param config - Slack bot configuration
+     * @returns Promise that resolves when connected
+     */
+    initialize(config: SlackConfig): Promise<void>;
+    /**
+     * Set up Slack event handlers
+     */
+    private setupEventHandlers;
+    /**
+     * Attach listeners to the underlying SocketModeClient to track
+     * connection lifecycle (disconnected, reconnecting, connected).
+     * Updates `status.connected` so health checks reflect actual state.
+     *
+     * The Bolt App stores the receiver at `app.receiver`, and the
+     * SocketModeReceiver exposes `client` (SocketModeClient), which
+     * is an EventEmitter emitting: connected, reconnecting, disconnected, close.
+     */
+    private setupConnectionMonitoring;
+    /**
+     * Send a message to Slack
+     *
+     * @param message - Message to send
+     * @returns Promise with message timestamp
+     */
+    sendMessage(message: SlackOutgoingMessage): Promise<string>;
+    /**
+     * Send a notification to the default channel
+     *
+     * @param notification - Notification to send
+     */
+    sendNotification(notification: SlackNotification): Promise<void>;
+    /**
+     * Format notification as Slack blocks
+     *
+     * @param notification - Notification to format
+     * @returns Slack blocks for the notification
+     */
+    private formatNotificationBlocks;
+    /**
+     * Update a message
+     *
+     * @param channelId - Channel ID
+     * @param messageTs - Message timestamp
+     * @param text - New text
+     * @param blocks - Optional new blocks
+     */
+    updateMessage(channelId: string, messageTs: string, text: string, blocks?: SlackBlock[]): Promise<void>;
+    /**
+     * Add a reaction to a message
+     *
+     * @param channelId - Channel ID
+     * @param messageTs - Message timestamp
+     * @param emoji - Emoji name (without colons)
+     */
+    addReaction(channelId: string, messageTs: string, emoji: string): Promise<void>;
+    /**
+     * Get or create conversation context for a thread
+     *
+     * @param threadTs - Thread timestamp
+     * @param channelId - Channel ID
+     * @param userId - User ID
+     * @returns Conversation context
+     */
+    getConversationContext(threadTs: string, channelId: string, userId: string): SlackConversationContext;
+    /**
+     * Get service status
+     *
+     * @returns Current service status
+     */
+    getStatus(): SlackServiceStatus;
+    /**
+     * Check if service is connected
+     *
+     * @returns True if connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get the bot token used to initialize the Slack client.
+     * Required for downloading private files from Slack.
+     *
+     * @returns The bot token string, or null if not initialized
+     */
+    getBotToken(): string | null;
+    /**
+     * Upload an image file to a Slack channel.
+     *
+     * Delegates to the shared upload-with-retry logic.
+     * Kept as a separate public method for backward compatibility
+     * with callers that use the image-specific endpoint.
+     *
+     * @param options - Upload configuration
+     * @returns Object with the uploaded file ID
+     * @throws Error if the client is not initialized or upload fails
+     */
+    uploadImage(options: FileUploadOptions): Promise<{
+        fileId?: string;
+    }>;
+    /**
+     * Upload any supported file to a Slack channel.
+     *
+     * Delegates to the shared upload-with-retry logic.
+     * Works for PDFs, images, documents, and other file types supported by Slack.
+     *
+     * @param options - Upload configuration
+     * @returns Object with the uploaded file ID
+     * @throws Error if the client is not initialized or upload fails
+     */
+    uploadFile(options: FileUploadOptions): Promise<{
+        fileId?: string;
+    }>;
+    /**
+     * Shared upload logic with retry/backoff for Slack rate limits.
+     *
+     * Reads the file from disk and uploads via files.uploadV2.
+     * Retries on 429 responses with exponential backoff capped at 60s.
+     *
+     * @param options - Upload configuration (channel, path, filename, etc.)
+     * @param constants - Constants object providing UPLOAD_MAX_RETRIES and UPLOAD_DEFAULT_BACKOFF_MS
+     * @returns Object with the uploaded file ID
+     * @throws Error if the client is not initialized, retries exhausted, or a non-rate-limit error occurs
+     */
+    private uploadWithRetry;
+    /**
+     * Check if an error is a Slack 429 rate limit error.
+     *
+     * @param error - The caught error
+     * @returns True if the error represents a 429 rate limit response
+     */
+    private isRateLimitError;
+    /**
+     * Extract the retry-after delay from a Slack rate limit error.
+     *
+     * @param error - The caught error
+     * @returns Retry delay in milliseconds, or null if not found
+     */
+    private extractRetryAfterMs;
+    /**
+     * Disconnect from Slack
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Get file info from Slack via the files.info API.
+     * Requires the bot token to have `files:read` scope.
+     *
+     * @param fileId - Slack file ID (e.g., F0123ABC456)
+     * @returns Object with private download URLs
+     * @throws Error if the client is not initialized or API call fails
+     */
+    getFileInfo(fileId: string): Promise<{
+        url_private: string;
+        url_private_download: string;
+    }>;
+    /**
+     * Get user info from Slack
+     *
+     * @param userId - Slack user ID
+     * @returns User info object
+     */
+    getUserInfo(userId: string): Promise<{
+        name: string;
+        realName: string;
+        email?: string;
+    }>;
+}
+/**
+ * Get the SlackService singleton instance
+ *
+ * @returns SlackService instance
+ */
+export declare function getSlackService(): SlackService;
+/**
+ * Reset the SlackService instance (for testing)
+ */
+export declare function resetSlackService(): void;
+export {};
+//# sourceMappingURL=slack.service.d.ts.map

package/dist/backend/backend/src/services/slack/slack.service.d.ts.map

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