@messenger-box/platform-server 10.0.3-alpha.7 → 10.0.3-alpha.74

package/lib/services/proxy-services/messenger-notification-microservice.js

@@ -1,6 +1,30 @@
-import {__decorate,__param,__metadata}from'tslib';import {injectable,inject}from'inversify';import {CommonType}from'@common-stack/core';import {ServiceBroker}from'moleculer';import'@cdm-logger/core';import {MoleculerTopics,MessengerNotificationServiceCommands}from'common';let MessengerNotificationMicroservice = class MessengerNotificationMicroservice {
+import {__decorate,__param,__metadata}from'tslib';import {injectable,inject}from'inversify';import {CommonType}from'@common-stack/core';import {ServiceBroker}from'moleculer';import'@cdm-logger/core';import {DisposableCollection}from'@adminide-stack/core';import {MoleculerTopics,MessengerNotificationServiceCommands}from'common/server';/**
+ * Messenger Notification Microservice Implementation
+ *
+ * This microservice handles comprehensive notification management within the messenger platform,
+ * providing operations for sending various types of notifications including email, SMS,
+ * push notifications, and Expo notifications across different messaging contexts through
+ * service broker delegation.
+ *
+ * Key capabilities:
+ * - Multi-channel notification delivery (email, SMS, push, Expo)
+ * - Unread message notification scheduling and management
+ * - User preference-based notification filtering
+ * - Support service notification handling
+ * - Alert message notification broadcasting
+ * - Thread-based notification management
+ * - Real-time push notification integration
+ * - Template-based notification customization
+ * - Channel and post-based notification routing
+ * - User aggregation and preference management
+ *
+ * The microservice integrates with multiple external services through Moleculer broker
+ * and provides comprehensive error handling and logging for notification workflows.
+ */
+let MessengerNotificationMicroservice = class MessengerNotificationMicroservice {
   broker;
   logger;
+  toDispose = new DisposableCollection();
   topic = MoleculerTopics.MessengerNotificationService;
   constructor(broker, logger) {
     this.broker = broker;
@@ -9,42 +33,313 @@ import {__decorate,__param,__metadata}from'tslib';import {injectable,inject}from
       className: 'MessengerNotificationMicroservice'
     });
   }
+  /**
+   * Disposes of resources used by the service
+   */
+  dispose() {
+    this.toDispose.dispose();
+  }
+  /**
+   * Calls a microservice action with proper error handling
+   *
+   * @description Protected method to handle microservice communication
+   *
+   * @param {string} command - The command to execute
+   * @param {P} params - Parameters for the command
+   * @returns {Promise<T>} - Result from microservice
+   */
   async callAction(command, params) {
     return this.broker.call(`${this.topic}.${command}`, params);
   }
-  sendNotificationOfUnreadMessages(unit, value) {
-    return this.callAction(MessengerNotificationServiceCommands.SendNotificationOfUnreadMessages, {
-      unit,
-      value
-    });
+  /**
+   * Sends notification for unread messages within a specified time frame
+   *
+   * @description Aggregates unread messages across channels and sends notifications
+   * to users based on their preferences within the specified duration
+   *
+   * @param {NotificationDurationUnitEnum} unit - Time unit for the duration
+   * @param {number} value - Number of time units to look back
+   * @returns {Promise<boolean | Error>} - Success status or error
+   */
+  // @ts-ignore - Enhanced error handling pattern with Error union type
+  async sendNotificationOfUnreadMessages(unit, value) {
+    try {
+      this.logger.debug('Sending notification of unread messages via microservice', {
+        unit,
+        value
+      });
+      const result = await this.callAction(MessengerNotificationServiceCommands.SendNotificationOfUnreadMessages, {
+        unit,
+        value
+      });
+      if (typeof result !== 'boolean') {
+        return new Error('Invalid result from microservice');
+      }
+      this.logger.debug('Notification of unread messages sent successfully via microservice', {
+        unit,
+        value,
+        success: result
+      });
+      return result;
+    } catch (error) {
+      this.logger.error('Error sending notification of unread messages via microservice: %o', error);
+      return error instanceof Error ? error : new Error('Unknown error occurred while sending unread message notifications');
+    }
   }
-  sendNotificationOnPost(post) {
-    return this.callAction(MessengerNotificationServiceCommands.SendNotificationOnPost, {
-      post
-    });
+  /**
+   * Sends general notifications for a post
+   *
+   * @description Handles email and SMS notifications for posts with template support
+   *
+   * @param {IPost} post - The post that triggered the notification
+   * @returns {Promise<boolean | Error>} - Success status or error
+   */
+  // @ts-ignore - Enhanced error handling pattern with Error union type
+  async sendNotificationOnPost(post) {
+    try {
+      this.logger.debug('Sending notification on post via microservice', {
+        postId: post.id
+      });
+      const result = await this.callAction(MessengerNotificationServiceCommands.SendNotificationOnPost, {
+        post
+      });
+      if (typeof result !== 'boolean') {
+        return new Error('Invalid result from microservice');
+      }
+      this.logger.debug('Notification on post sent successfully via microservice', {
+        postId: post.id,
+        success: result
+      });
+      return result;
+    } catch (error) {
+      this.logger.error('Error sending notification on post via microservice: %o', error);
+      return error instanceof Error ? error : new Error('Unknown error occurred while sending post notification');
+    }
   }
-  sendNotificationOfAlertMessages(unit, value) {
-    return this.callAction(MessengerNotificationServiceCommands.SendNotificationOfAlertMessages, {
-      unit,
-      value
-    });
+  /**
+   * Sends notifications for alert messages within a time frame
+   *
+   * @description Processes and sends notifications for alert-type messages
+   *
+   * @param {NotificationDurationUnitEnum} unit - Time unit for the duration
+   * @param {number} value - Number of time units to look back
+   * @returns {Promise<boolean | Error>} - Success status or error
+   */
+  // @ts-ignore - Enhanced error handling pattern with Error union type
+  async sendNotificationOfAlertMessages(unit, value) {
+    try {
+      this.logger.debug('Sending notification of alert messages via microservice', {
+        unit,
+        value
+      });
+      const result = await this.callAction(MessengerNotificationServiceCommands.SendNotificationOfAlertMessages, {
+        unit,
+        value
+      });
+      if (typeof result !== 'boolean') {
+        return new Error('Invalid result from microservice');
+      }
+      this.logger.debug('Notification of alert messages sent successfully via microservice', {
+        unit,
+        value,
+        success: result
+      });
+      return result;
+    } catch (error) {
+      this.logger.error('Error sending notification of alert messages via microservice: %o', error);
+      return error instanceof Error ? error : new Error('Unknown error occurred while sending alert notifications');
+    }
   }
-  sendPushNotificationsExpo(data) {
-    return this.callAction(MessengerNotificationServiceCommands.SendPushNotificationsExpo, {
-      data
-    });
+  /**
+   * Sends Expo push notifications
+   *
+   * @description Sends push notifications through the Expo notification service
+   *
+   * @param {IExpoNotificationData} data - Notification data
+   * @returns {Promise<IExpoNotification | Error>} - Notification result or error
+   */
+  async sendPushNotificationsExpo(data) {
+    try {
+      this.logger.debug('Sending Expo push notifications via microservice', {
+        recipients: Array.isArray(data.to) ? data.to.length : 1,
+        hasTitle: !!data.title,
+        hasBody: !!data.body
+      });
+      const result = await this.callAction(MessengerNotificationServiceCommands.SendPushNotificationsExpo, {
+        data
+      });
+      if (!result) {
+        return new Error('Failed to send Expo notification');
+      }
+      this.logger.debug('Expo push notifications sent successfully via microservice', {
+        status: result.status,
+        id: result.id
+      });
+      return result;
+    } catch (error) {
+      this.logger.error('Error sending Expo push notifications via microservice: %o', error);
+      return error instanceof Error ? error : new Error('Unknown error occurred while sending Expo notification');
+    }
   }
-  sendExpoNotificationOnPost(post, notificationData) {
-    return this.callAction(MessengerNotificationServiceCommands.SendExpoNotificationOnPost, {
-      post,
-      notificationData
-    });
+  /**
+   * Sends Expo notification when a post is created
+   *
+   * @description Handles push notification logic for new posts with thread and channel support
+   *
+   * @param {IPost} post - The post that triggered the notification
+   * @param {IExpoNotificationBodyData} notificationData - Optional notification data override
+   * @returns {Promise<boolean | Error>} - Success status or error
+   */
+  // @ts-ignore - Enhanced error handling pattern with Error union type
+  async sendExpoNotificationOnPost(post, notificationData) {
+    try {
+      this.logger.debug('Sending Expo notification on post via microservice', {
+        postId: post.id,
+        channelId: post.channel,
+        hasNotificationData: !!notificationData
+      });
+      const result = await this.callAction(MessengerNotificationServiceCommands.SendExpoNotificationOnPost, {
+        post,
+        notificationData
+      });
+      if (typeof result !== 'boolean') {
+        return new Error('Invalid result from microservice');
+      }
+      this.logger.debug('Expo notification on post sent successfully via microservice', {
+        postId: post.id,
+        success: result
+      });
+      return result;
+    } catch (error) {
+      this.logger.error('Error sending Expo notification on post via microservice: %o', error);
+      return error instanceof Error ? error : new Error('Unknown error occurred while sending post notification');
+    }
   }
-  sendNotificationOfUnreadServiceMessages(unit, value) {
-    return this.callAction(MessengerNotificationServiceCommands.SendNotificationOfUnreadServiceMessages, {
-      unit,
-      value
-    });
+  /**
+   * Sends notifications for unread service messages
+   *
+   * @description Handles notifications for support service channels
+   *
+   * @param {NotificationDurationUnitEnum} unit - Time unit for the duration
+   * @param {number} value - Number of time units to look back
+   * @returns {Promise<boolean | Error>} - Success status or error
+   */
+  // @ts-ignore - Enhanced error handling pattern with Error union type
+  async sendNotificationOfUnreadServiceMessages(unit, value) {
+    try {
+      this.logger.debug('Sending notification of unread service messages via microservice', {
+        unit,
+        value
+      });
+      const result = await this.callAction(MessengerNotificationServiceCommands.SendNotificationOfUnreadServiceMessages, {
+        unit,
+        value
+      });
+      if (typeof result !== 'boolean') {
+        return new Error('Invalid result from microservice');
+      }
+      this.logger.debug('Notification of unread service messages sent successfully via microservice', {
+        unit,
+        value,
+        success: result
+      });
+      return result;
+    } catch (error) {
+      this.logger.error('Error sending notification of unread service messages via microservice: %o', error);
+      return error instanceof Error ? error : new Error('Unknown error occurred while sending service notifications');
+    }
+  }
+  /**
+   * Sets the support service configuration
+   *
+   * @description Updates the support service notification configuration for customized notifications
+   *
+   * @param {ISupportServiceConfig} config - Support service configuration
+   * @returns {Promise<void | Error>} - Void promise or error
+   */
+  // @ts-ignore - Enhanced error handling pattern with Error union type
+  async setSupportServiceConfig(config) {
+    try {
+      this.logger.debug('Setting support service config via microservice', {
+        hasEmail: !!config?.email,
+        hasTemplateId: !!config?.templateId,
+        hasVariables: !!config?.variables
+      });
+      await this.callAction(MessengerNotificationServiceCommands.SetSupportServiceConfig, {
+        config
+      });
+      this.logger.debug('Support service config set successfully via microservice');
+    } catch (error) {
+      this.logger.error('Error setting support service config via microservice: %o', error);
+      return error instanceof Error ? error : new Error('Unknown error occurred while setting support service config');
+    }
+  }
+  /**
+   * Validates notification data
+   *
+   * @description Helper method to validate notification data before processing
+   *
+   * @param {any} data - Data to validate
+   * @returns {Promise<boolean | Error>} - Validation result or error
+   */
+  async validateNotificationData(data) {
+    try {
+      if (!data) {
+        return new Error('Notification data is required');
+      }
+      // Basic validation logic
+      if (data.type === 'email' && !data.email) {
+        return new Error('Email is required for email notifications');
+      }
+      if (data.type === 'sms' && !data.phoneNumber) {
+        return new Error('Phone number is required for SMS notifications');
+      }
+      if (data.type === 'expo' && !data.to) {
+        return new Error('Recipients are required for Expo notifications');
+      }
+      this.logger.debug('Notification data validation passed', {
+        type: data.type
+      });
+      return true;
+    } catch (error) {
+      this.logger.error('Error validating notification data: %o', error);
+      return error instanceof Error ? error : new Error('Unknown error occurred while validating notification data');
+    }
+  }
+  /**
+   * Gets notification statistics
+   *
+   * @description Convenience method to get notification delivery statistics
+   *
+   * @param {string} userId - The user identifier (optional)
+   * @param {Date} startDate - Start date for statistics
+   * @param {Date} endDate - End date for statistics
+   * @returns {Promise<any | Error>} - Notification statistics or error
+   */
+  async getNotificationStatistics(userId, startDate, endDate) {
+    try {
+      this.logger.debug('Getting notification statistics via microservice', {
+        userId,
+        startDate: startDate?.toISOString(),
+        endDate: endDate?.toISOString()
+      });
+      const result = await this.broker.call(`${this.topic}.getNotificationStatistics`, {
+        userId,
+        startDate,
+        endDate
+      });
+      if (!result) {
+        return new Error('Failed to get notification statistics');
+      }
+      this.logger.debug('Notification statistics retrieved successfully via microservice', {
+        userId,
+        hasStats: !!result
+      });
+      return result;
+    } catch (error) {
+      this.logger.error('Error getting notification statistics via microservice: %o', error);
+      return error instanceof Error ? error : new Error('Unknown error occurred while getting notification statistics');
+    }
   }
 };
 MessengerNotificationMicroservice = __decorate([injectable(), __param(0, inject(CommonType.MOLECULER_BROKER)), __param(1, inject('Logger')), __metadata("design:paramtypes", [ServiceBroker, Object])], MessengerNotificationMicroservice);export{MessengerNotificationMicroservice};//# sourceMappingURL=messenger-notification-microservice.js.map

package/lib/services/proxy-services/messenger-notification-microservice.js.map

@@ -1 +1 @@
-{"version":3,"file":"messenger-notification-microservice.js","sources":["../../../src/services/proxy-services/messenger-notification-microservice.ts"],"sourcesContent":[null],"names":[],"mappings":"iRAgBa,IAAA,iCAAiC,GAAvC,MAAM,iCAAiC,CAAA;AAKrB,EAAA,MAAA;AAEA,EAAA,MAAA;AANrB,EAAA,KAAA,GAAQ,eAAA,CAAA,4BAAgB;aAIH,CAAA,MAAA,EAAqB,MAEI,EAAA;QAFzB,CAAM,MAAA,GAAA;QAEN,CAAM,MAAA,GAAA;AAEvB,IAAA,IAAA,CAAA,MAAK,GAAA,MAAS,CAAA,KAAO,CAAA;MACxB,SAAA,EAAA;AAES,KAAA,CAAA;AACN;QACH,UAAA,CAAA,OAAA,EAAA,MAAA,EAAA;IAED,OAAgC,IAAA,CAAA,MAAA,CAAA,IAAA,CAAA,CAAA,EAAA,IAAA,CAAA,KAAmC,CAAA,CAAE,EAAa,OAAA,CAAA,CAAA,EAAA,MAAA,CAAA;AAC9E;kCACQ,CAAA,IAAA,EAAA,KAAA,EAAA;eACC,CAAA,UAAA,CAAA,oCAAA,CAAA,gCAAA,EAAA;AACR,MAAA,IAAC;MACL;AAED,KAAA,CAAA;AACI;wBACQ,CAAA,IAAA,EAAA;AACP,IAAA,OAAE,IAAA,CAAA,UAAA,CAAA,oCAAA,CAAA,sBAAA,EAAA;MACN;KAE8B,CAAA;AAC3B;iCACQ,CAAA,IAAA,EAAA,KAAA,EAAA;eACC,CAAA,UAAA,CAAA,oCAAA,CAAA,+BAAA,EAAA;AACR,MAAA,IAAC;MACL;AAED,KAAA,CAAA;AACI;2BACQ,CAAA,IAAA,EAAA;AACP,IAAA,OAAE,IAAA,CAAA,UAAA,CAAA,oCAAA,CAAA,yBAAA,EAAA;MACN;KAEyB,CAAA;AACtB;4BACQ,CAAA,IAAA,EAAA,gBAAA,EAAA;eACY,CAAA,UAAA,CAAA,oCAAA,CAAA,0BAAA,EAAA;AACnB,MAAA,IAAC;MACL;KAEsC,CAAA;AACnC;yCACQ,CAAA,IAAA,EAAA,KAAA,EAAA;eACC,CAAA,UAAA,CAAA,oCAAA,CAAA,uCAAA,EAAA;AACR,MAAA,IAAC;MACL;KACJ,CAAA;AAvDY;AADZ;AAKQ,iCAAkB,GAAA,UAAA,CAAA,CAAA,UAAiB,EAAA,EAAA,OAAA,CAAA,CAAA,EAAA,MAAA,CAAA,UAAA,CAAA,gBAAA,CAAA,CAAA,EAAA,OAAA,CAAA,CAAA,EAAA,MAAA,CAAA,QAAA,CAAA,CAAA,EAAA,UAAA,CAAA,mBAAA,EAAA,CAAA,aAAA,EAAA,MAAA,CAAA,CAAA,CAAA,EAAA,iCAAA,CAAA"}
+{"version":3,"file":"messenger-notification-microservice.js","sources":["../../../src/services/proxy-services/messenger-notification-microservice.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/lib/services/proxy-services/post-microservice.d.ts

@@ -1,21 +1,216 @@
 import { ServiceBroker } from 'moleculer';
-import { IFileInfo, IMessageIdentifier, MoleculerTopics as MoleculerTopics, IPost, IPostThread, IUploadedFileInput, IPostService, IPostServiceInput, CreatePostThreadOptions } from 'common';
+import { IFileInfo, IMessageIdentifier, MoleculerTopics as MoleculerTopics, IPostModel, IPostThread, IUploadedFileInput, IPostService, IPostServiceInput, CreatePostThreadOptions, AsDomainType, ICodeAgentRequest, IFileUpdateResponse } from 'common/server';
 import { BaseProxyService } from '@common-stack/store-mongo';
 import { CdmLogger } from '@cdm-logger/core';
-export declare class PostProxyService extends BaseProxyService<IPost, IPostServiceInput, Partial<IPost>> implements IPostService {
+import { Disposable, DisposableCollection } from '@adminide-stack/core';
+/**
+ * Post Microservice Implementation
+ *
+ * This microservice handles comprehensive post management within the messenger platform,
+ * providing operations for creating, updating, managing posts and their associated
+ * content including file attachments, notifications, threading, and real-time
+ * message delivery across channels and organizations through service broker delegation.
+ *
+ * Key capabilities:
+ * - Post lifecycle management (creation, updates, deletion)
+ * - File attachment handling and upload management
+ * - Real-time message delivery and notifications
+ * - Post threading and conversation management
+ * - Message status tracking (read, delivered)
+ * - Channel integration and message counting
+ * - Expo push notification integration
+ * - File upload link generation and management
+ */
+export declare class PostProxyService extends BaseProxyService<IPostModel, IPostServiceInput, Partial<IPostModel>> implements IPostService, Disposable {
     protected readonly logger: CdmLogger.ILogger;
+    protected readonly toDispose: DisposableCollection;
     topic: MoleculerTopics;
     constructor(broker: ServiceBroker, logger: CdmLogger.ILogger);
-    attachUploadedFile(postId: string, file: IUploadedFileInput, createdBy: string): Promise<IFileInfo>;
-    createFileUploadLink(postId: string, filename: string, userId: string): Promise<string>;
-    attachUploadedFiles(postId: string, files: IUploadedFileInput[], createdBy: string): Promise<IFileInfo[]>;
-    createFilesUploadLink(postId: string, filenames: string[], userId: string): Promise<string[]>;
-    deleteFile(url: string): Promise<boolean>;
-    readMessage(messageId: IMessageIdentifier, user: string): Promise<boolean>;
-    deliverMessage(messageId: IMessageIdentifier, user: string): Promise<boolean>;
-    createWithoutSubscription(data: IPostServiceInput): Promise<IPost>;
+    /**
+     * Disposes of resources used by the service
+     */
+    dispose(): void;
+    /**
+     * Creates a file upload link for a post
+     *
+     * @description Generates a secure upload URL for attaching files to posts
+     *
+     * @param {string} postId - The post identifier
+     * @param {string} filename - The name of the file to upload
+     * @param {string} userId - The user performing the upload
+     * @returns {Promise<string | Error>} - Upload URL or error
+     */
+    createFileUploadLink(postId: string, filename: string, userId: string): Promise<string | Error>;
+    /**
+     * Attaches an uploaded file to a post
+     *
+     * @description Processes and attaches a completed file upload to a post
+     *
+     * @param {string} postId - The post identifier
+     * @param {IUploadedFileInput} file - The uploaded file information
+     * @param {string} createdBy - The user who uploaded the file
+     * @returns {Promise<IFileInfo | Error>} - File information or error
+     */
+    attachUploadedFile(postId: string, file: IUploadedFileInput, createdBy: string): Promise<IFileInfo | Error>;
+    /**
+     * Creates upload links for multiple files
+     *
+     * @description Generates secure upload URLs for multiple files to be attached to a post
+     *
+     * @param {string} postId - The post identifier
+     * @param {string[]} filenames - Array of file names
+     * @param {string} userId - The user performing the uploads
+     * @returns {Promise<string[] | Error>} - Array of upload URLs or error
+     */
+    createFilesUploadLink(postId: string, filenames: string[], userId: string): Promise<string[] | Error>;
+    /**
+     * Attaches multiple uploaded files to a post
+     *
+     * @description Processes and attaches multiple completed file uploads to a post
+     *
+     * @param {string} postId - The post identifier
+     * @param {IUploadedFileInput[]} files - Array of uploaded file information
+     * @param {string} createdBy - The user who uploaded the files
+     * @returns {Promise<IFileInfo[] | Error>} - Array of file information or error
+     */
+    attachUploadedFiles(postId: string, files: IUploadedFileInput[], createdBy: string): Promise<IFileInfo[] | Error>;
+    /**
+     * Creates a new post with full integration
+     *
+     * @description Creates a post with channel updates, notifications, and real-time publishing
+     *
+     * @param {IPostServiceInput} data - Post creation data
+     * @returns {Promise<AsDomainType<IPostModel> | Error>} - Created post or error
+     */
+    create(data: IPostServiceInput): Promise<AsDomainType<IPostModel> | Error>;
+    /**
+     * Creates a post without real-time subscription
+     *
+     * @description Creates a post with channel updates but without real-time publishing
+     *
+     * @param {IPostServiceInput} data - Post creation data
+     * @returns {Promise<AsDomainType<IPostModel> | Error>} - Created post or error
+     */
+    createWithoutSubscription(data: IPostServiceInput): Promise<AsDomainType<IPostModel> | Error>;
+    /**
+     * Deletes a file by URL
+     *
+     * @description Removes a file from storage using its URL
+     *
+     * @param {string} url - The file URL to delete
+     * @returns {Promise<boolean | Error>} - Success status or error
+     */
+    deleteFile(url: string): Promise<boolean | Error>;
+    /**
+     * Marks a message as read by a user
+     *
+     * @description Updates message status to indicate it has been read by a specific user
+     *
+     * @param {IMessageIdentifier} messageId - Message identifier
+     * @param {string} user - User ID who read the message
+     * @returns {Promise<boolean | Error>} - Success status or error
+     */
+    readMessage(messageId: IMessageIdentifier, user: string): Promise<boolean | Error>;
+    /**
+     * Marks a message as delivered to a user
+     *
+     * @description Updates message status to indicate it has been delivered to a specific user
+     *
+     * @param {IMessageIdentifier} messageId - Message identifier
+     * @param {string} user - User ID who received the message
+     * @returns {Promise<boolean | Error>} - Success status or error
+     */
+    deliverMessage(messageId: IMessageIdentifier, user: string): Promise<boolean | Error>;
+    /**
+     * Creates a post with associated post thread
+     *
+     * @description Creates both a post and its associated thread for threaded conversations
+     *
+     * @param {CreatePostThreadOptions} data - Post and thread creation options
+     * @returns {Promise<{post: AsDomainType<IPostModel>; postThread: IPostThread} | Error>} - Created post and thread or error
+     */
     createPostWithPostThread(data: CreatePostThreadOptions): Promise<{
-        post: IPost;
+        post: AsDomainType<IPostModel>;
         postThread: IPostThread;
-    }>;
+    } | Error>;
+    /**
+     * Retrieves the last message in a channel
+     *
+     * @description Gets the most recent post/message from a specific channel
+     *
+     * @param {string} channelId - The channel identifier
+     * @returns {Promise<AsDomainType<IPostModel> | Error>} - Last message or error
+     */
+    getLastMessage(channelId: string): Promise<AsDomainType<IPostModel> | Error>;
+    /**
+     * Gets posts by channel with pagination
+     *
+     * @description Retrieves posts from a channel with pagination support
+     *
+     * @param {string} channelId - The channel identifier
+     * @param {number} limit - Maximum number of posts to return
+     * @param {number} offset - Number of posts to skip
+     * @returns {Promise<Array<AsDomainType<IPostModel>> | Error>} - Array of posts or error
+     */
+    getPostsByChannel(channelId: string, limit?: number, offset?: number): Promise<Array<AsDomainType<IPostModel>> | Error>;
+    /**
+     * Updates a post
+     *
+     * @description Updates post content and metadata
+     *
+     * @param {string} postId - The post identifier
+     * @param {Partial<IPostServiceInput>} updates - Update data
+     * @returns {Promise<AsDomainType<IPostModel> | Error>} - Updated post or error
+     */
+    updatePost(postId: string, updates: Partial<IPostServiceInput>): Promise<AsDomainType<IPostModel> | Error>;
+    /**
+     * Deletes a post
+     *
+     * @description Soft deletes a post and its associated data
+     *
+     * @param {string} postId - The post identifier
+     * @returns {Promise<boolean | Error>} - Success status or error
+     */
+    deletePost(postId: string): Promise<boolean | Error>;
+    /**
+     * Validates post data for creation or updates
+     *
+     * @description Helper method to validate post data before processing
+     *
+     * @param {IPostServiceInput} data - Data to validate
+     * @returns {Promise<boolean | Error>} - Validation result or error
+     */
+    validatePostData(data: IPostServiceInput): Promise<boolean | Error>;
+    /**
+     * Gets posts by author with pagination
+     *
+     * @description Convenience method to get posts created by a specific author
+     *
+     * @param {string} authorId - The author identifier
+     * @param {number} limit - Maximum number of posts to return
+     * @param {number} offset - Number of posts to skip
+     * @returns {Promise<Array<AsDomainType<IPostModel>> | Error>} - Array of posts or error
+     */
+    getPostsByAuthor(authorId: string, limit?: number, offset?: number): Promise<Array<AsDomainType<IPostModel>> | Error>;
+    /**
+     * Retrieves previous messages for a specific project
+     *
+     * @description Fetches the most recent messages from a project, formatted for AI agent context.
+     *
+     * @param {string} projectId - The unique identifier of the project
+     * @param {number} limit - Maximum number of messages to retrieve (default: 5)
+     * @returns {Promise<Array<IPostModel> | Error>} - Array of formatted messages or error
+     */
+    getPreviousMessagesByProjectId(projectId: string, limit?: number): Promise<Array<IPostModel> | Error>;
+    /**
+     * Saves code agent result with comprehensive data
+     *
+     * @description Saves the result from a code agent operation including message creation,
+     * fragment generation, and project update publishing. Handles both success and error cases
+     * with proper message creation and fragment management.
+     */
+    saveCodeAgentResult(request: ICodeAgentRequest, sandboxUrl: string, fragmentTitle: string, responseContent: string, files: {
+        [path: string]: string;
+    }, summary: string, isError: boolean, canvasLayers?: any[]): Promise<any>;
+    updateSandboxFile(projectId: string, messageId: string, filePath: string, content: string): Promise<IFileUpdateResponse>;
 }