Class ConversationAttachmentService

Service for managing conversation attachments. Handles validation, storage, thumbnails, and CRUD operations.

Index

Constructors

Properties

Methods

addAttachment attachmentTypeToModalityName calculateBase64Size createAttachmentRecord createAttachmentReference deleteAttachment deleteStorageFile generateImageThumbnail getAttachmentData getAttachments getAttachmentsBatch getDownloadUrl getModalityByName loadModalitiesIfNeeded uploadToStorage

Constructors

constructor

new ConversationAttachmentService(): ConversationAttachmentService
Returns ConversationAttachmentService
- Defined in AI/Engine/src/services/ConversationAttachmentService.ts:91

Properties

`Private` md

md: Metadata

`Private` modalityCache

modalityCache: ModalityCache = ...

Methods

addAttachment

addAttachment(conversationDetailId, input, agent, model, contextUser, existingCounts?): Promise<AddAttachmentResult>
Add a new attachment to a conversation detail. Handles validation, storage decision, thumbnail generation, and record creation.
Parameters
- conversationDetailId: string
  The ID of the conversation detail
- input: AddAttachmentInput
  The attachment data and metadata
- agent: AIAgentEntity
  The AI agent (for limit overrides)
- model: AIModelEntity
  The AI model (for capability limits)
- contextUser: UserInfo
  The current user context
- existingCounts: {
      audios: number;
      documents: number;
      images: number;
      videos: number;
  } = ...
  Current attachment counts for validation
  - audios: number
  - documents: number
  - images: number
  - videos: number
Returns Promise<AddAttachmentResult>
The result with created attachment or error
- Defined in AI/Engine/src/services/ConversationAttachmentService.ts:149

`Private` attachmentTypeToModalityName

attachmentTypeToModalityName(attachmentType): string
Convert AttachmentType to modality name
Parameters
- attachmentType: AttachmentType
Returns string
- Defined in AI/Engine/src/services/ConversationAttachmentService.ts:128

`Private` calculateBase64Size

calculateBase64Size(base64Data): number
Calculate the decoded size of base64 data
Parameters
- base64Data: string
Returns number
- Defined in AI/Engine/src/services/ConversationAttachmentService.ts:456

`Private` createAttachmentRecord

createAttachmentRecord(data, contextUser): Promise<ConversationDetailAttachmentEntity>
Create an attachment record in the database using strongly-typed entity.
Parameters
- data: {
      conversationDetailId: string;
      displayOrder: number;
      durationSeconds: number;
      fileId: string;
      fileName: string;
      height: number;
      inlineData: string;
      mimeType: string;
      modalityId: string;
      sizeBytes: number;
      thumbnailBase64: string;
      width: number;
  }
  - conversationDetailId: string
  - displayOrder: number
  - durationSeconds: number
  - fileId: string
  - fileName: string
  - height: number
  - inlineData: string
  - mimeType: string
  - modalityId: string
  - sizeBytes: number
  - thumbnailBase64: string
  - width: number
- contextUser: UserInfo
Returns Promise<ConversationDetailAttachmentEntity>
- Defined in AI/Engine/src/services/ConversationAttachmentService.ts:605

createAttachmentReference

createAttachmentReference(attachment): AttachmentContent
Create an AttachmentContent reference for embedding in messages. Maps from entity to the content block type used in AI messages.
Parameters
- attachment: ConversationDetailAttachmentEntity
  The attachment entity
Returns AttachmentContent
The attachment content reference
- Defined in AI/Engine/src/services/ConversationAttachmentService.ts:429

deleteAttachment

deleteAttachment(attachmentId, contextUser): Promise<boolean>
Delete an attachment and its underlying storage.
Parameters
- attachmentId: string
  The attachment ID
- contextUser: UserInfo
  The current user context
Returns Promise<boolean>
Whether deletion succeeded
- Defined in AI/Engine/src/services/ConversationAttachmentService.ts:402

`Private` deleteStorageFile

deleteStorageFile(fileId, contextUser): Promise<boolean>
Delete a file from MJStorage
Parameters
- fileId: string
- contextUser: UserInfo
Returns Promise<boolean>
- Defined in AI/Engine/src/services/ConversationAttachmentService.ts:541

`Private` generateImageThumbnail

generateImageThumbnail(_base64Data, _mimeType, _maxDimension?, _quality?): Promise<string>
Generate a thumbnail for an image. Returns base64-encoded thumbnail data.

Note: This is a placeholder implementation. In production, you'd use a library like sharp or Jimp for server-side image processing, or Canvas API for client-side.
Parameters
- _base64Data: string
- _mimeType: string
- _maxDimension: number = 200
- _quality: number = 0.7
Returns Promise<string>
- Defined in AI/Engine/src/services/ConversationAttachmentService.ts:579

getAttachmentData

getAttachmentData(attachment, contextUser): Promise<AttachmentWithData>
Get attachment data with content URL. For inline attachments, returns the base64 data URL. For MJStorage attachments, returns a pre-authenticated download URL.
Parameters
- attachment: ConversationDetailAttachmentEntity
  The attachment entity
- contextUser: UserInfo
  The current user context
Returns Promise<AttachmentWithData>
The attachment with content URL
- Defined in AI/Engine/src/services/ConversationAttachmentService.ts:272

getAttachments

getAttachments(conversationDetailId, contextUser): Promise<ConversationDetailAttachmentEntity[]>
Get all attachments for a conversation detail.
Parameters
- conversationDetailId: string
  The conversation detail ID
- contextUser: UserInfo
  The current user context
Returns Promise<ConversationDetailAttachmentEntity[]>
Array of attachment entities
- Defined in AI/Engine/src/services/ConversationAttachmentService.ts:335

getAttachmentsBatch

getAttachmentsBatch(conversationDetailIds, contextUser): Promise<Map<string, ConversationDetailAttachmentEntity[]>>
Get attachments for multiple conversation details (batch load).
Parameters
- conversationDetailIds: string[]
  Array of conversation detail IDs
- contextUser: UserInfo
  The current user context
Returns Promise<Map<string, ConversationDetailAttachmentEntity[]>>
Map of conversation detail ID to attachments
- Defined in AI/Engine/src/services/ConversationAttachmentService.ts:361

getDownloadUrl

getDownloadUrl(fileId, contextUser): Promise<string>
Get a pre-authenticated download URL for an MJStorage file.
Parameters
- fileId: string
  The File entity ID
- contextUser: UserInfo
  The current user context
Returns Promise<string>
The download URL or null if unavailable
- Defined in AI/Engine/src/services/ConversationAttachmentService.ts:305

`Private` getModalityByName

getModalityByName(name, contextUser): Promise<AIModalityEntity>
Get modality by name (e.g., 'Image', 'Audio', 'Video', 'File')
Parameters
- name: string
- contextUser: UserInfo
Returns Promise<AIModalityEntity>
- Defined in AI/Engine/src/services/ConversationAttachmentService.ts:120

`Private` loadModalitiesIfNeeded

loadModalitiesIfNeeded(contextUser): Promise<void>
Load and cache modalities for efficient lookup
Parameters
- contextUser: UserInfo
Returns Promise<void>
- Defined in AI/Engine/src/services/ConversationAttachmentService.ts:98

`Private` uploadToStorage

uploadToStorage(base64Data, mimeType, fileName, agent, contextUser): Promise<{
    error?: string;
    fileId?: string;
    success: boolean;
}>
Upload data to MJStorage
Parameters
- base64Data: string
- mimeType: string
- fileName: string
- agent: AIAgentEntity
- contextUser: UserInfo
Returns Promise<{
    error?: string;
    fileId?: string;
    success: boolean;
}>
- Defined in AI/Engine/src/services/ConversationAttachmentService.ts:467

Class ConversationAttachmentService

Index

Constructors

Properties

Methods

Constructors

constructor

Returns ConversationAttachmentService

Properties

Private md

Private modalityCache

Methods

addAttachment

Parameters

audios: number

documents: number

images: number

videos: number

Returns Promise<AddAttachmentResult>

Private attachmentTypeToModalityName

Parameters

Returns string

Private calculateBase64Size

Parameters

Returns number

Private createAttachmentRecord

Parameters

conversationDetailId: string

displayOrder: number

durationSeconds: number

fileId: string

fileName: string

height: number

inlineData: string

mimeType: string

modalityId: string

sizeBytes: number

thumbnailBase64: string

width: number

Returns Promise<ConversationDetailAttachmentEntity>

createAttachmentReference

Parameters

Returns AttachmentContent

deleteAttachment

Parameters

Returns Promise<boolean>

Private deleteStorageFile

Parameters

Returns Promise<boolean>

Private generateImageThumbnail

Parameters

Returns Promise<string>

getAttachmentData

Parameters

Returns Promise<AttachmentWithData>

getAttachments

Parameters

Returns Promise<ConversationDetailAttachmentEntity[]>

getAttachmentsBatch

Parameters

Returns Promise<Map<string, ConversationDetailAttachmentEntity[]>>

getDownloadUrl

Parameters

Returns Promise<string>

Private getModalityByName

Parameters

Returns Promise<AIModalityEntity>

Private loadModalitiesIfNeeded

Parameters

Returns Promise<void>

Private uploadToStorage

Parameters

Returns Promise<{ error?: string; fileId?: string; success: boolean; }>

Settings

Member Visibility

Theme

On This Page

`Private` md

`Private` modalityCache

`Private` attachmentTypeToModalityName

`Private` calculateBase64Size

`Private` createAttachmentRecord

`Private` deleteStorageFile

`Private` generateImageThumbnail

`Private` getModalityByName

`Private` loadModalitiesIfNeeded

`Private` uploadToStorage

Returns Promise<{
error?: string;
fileId?: string;
success: boolean;
}>