Document iOS multiple attachments (SDK + UI Kit)

[adityakotasthane07]

SDK:

• send-message: rewrite the multiple-attachments section around the upload-first flow (uploadFiles, MediaCallbackListener, cancelFile), document upload limits (file.count.max / file.size.max), the error codes table, the files-must-stay-nil warning, and keep the direct send form as a legacy sub-section

UI Kit:

• message-composer / compact-message-composer: new Multiple Attachments section (multi-select picking, attachment tray, upload-before-send, per-type message split, clipboard paste, voice-note exception, edit-mode behavior), server-driven limits and validation table, CometChatErrorStateStyle theming, enableMultipleAttachments prop
• message-list: per-type bubbles, batch grouping behavior and the set(enableMultipleAttachments:) toggle
• message-bubble-styling: new Media Grid Bubble, Audio Files Bubble and Files Bubble sections with GalleryBubbleStyle properties
• core-features: Media Sharing rewritten to lead with the multi-attachment flow

Description

Related Issue(s)

Type of Change

• Documentation correction/update
• New documentation
• Improvement to existing documentation
• Typo fix
• Other (please specify)

Checklist

• I have read the CONTRIBUTING document
• My branch name follows the naming convention
• My changes follow the documentation style guide
• I have checked for spelling and grammar errors
• All links in my changes are valid and working
• My changes are accurately described in this pull request

Additional Information

Screenshots (if applicable)

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
cometchat	🟢 Ready	View Preview	Jul 13, 2026, 3:12 PM

[jitvarpatil]

Docs review — ✅ Approve

iOS multi-attachment docs — SDK upload-first flow + UIKit composer/bubble updates (6 files, +309/-27). No file deletions/nav change → no redirect risk. I verified the entire SDK API against the exact matching feature branch (ENG-36750/iossdk-multi-attachment-presigned-upload-support) — every symbol, signature, and default matches. Structurally clean.

✅ SDK API — verified against ENG-36750

• CometChat.uploadFiles(files:listener:) — real public API (CometChat+FileUpload.swift).
• MediaCallbackListener — upload listener with exactly the 4 documented methods: onSuccess(fileId:attachment:), onProgress(fileId:bytesUploaded:totalBytes:), onError(fileId:error:), onFailure(fileId:error:).
• MediaMessage.attachments: [Attachment]? — settable property (MediaMessage.swift:66), matching mediaMessage.attachments = uploadedAttachments.
• getMaxFileCount() → file.count.max, "Defaults to 10" (matches exactly); getMaxFileSize() → file.size.max (100 MB).
• sendMediaMessage, Attachment confirmed. The "leave files nil; an empty files array fails with invalid-message error" note is consistent with the file-count logic.

✅ Structure & UIKit

• 0 nav breaks, 0 orphans, 0 broken links in the changed files; all internal links resolve. (The 2 sdk/ios links the analyzer flagged — default-calling/login-listeners — are pre-existing in unchanged files, not send-message.mdx.)
• UIKit docs use the existing CometChatMessageComposer + attachmentOptions. No placeholders/TODOs.

Note

The SDK feature is on ENG-36750 (freshest branch) — i.e. this documents an in-progress feature. Please confirm the SDK version with uploadFiles/MediaMessage.attachments/getMaxFileCount ships with the release these docs target.

Well-sourced, accurate PR. Ready to merge.

_{🤖 Automated docs review (Mintlify link/redirect/content checks + API verification against CometChatSDK iOS multi-attachment branch).}

[jitvarpatil]

Docs review — ✅ Approve

iOS multi-attachment docs — SDK upload-first flow + UIKit composer/bubble updates (6 files, +309/-27). No file deletions/nav change → no redirect risk. I verified the entire SDK API against the exact matching feature branch (ENG-36750/iossdk-multi-attachment-presigned-upload-support) — every symbol, signature, and default matches. Structurally clean.

✅ SDK API — verified against ENG-36750

• CometChat.uploadFiles(files:listener:) — real public API (CometChat+FileUpload.swift).
• MediaCallbackListener — upload listener with exactly the 4 documented methods: onSuccess(fileId:attachment:), onProgress(fileId:bytesUploaded:totalBytes:), onError(fileId:error:), onFailure(fileId:error:).
• MediaMessage.attachments: [Attachment]? — settable property (MediaMessage.swift:66), matching mediaMessage.attachments = uploadedAttachments.
• getMaxFileCount() → file.count.max, "Defaults to 10" (matches exactly); getMaxFileSize() → file.size.max (100 MB).
• sendMediaMessage, Attachment confirmed. The "leave files nil; an empty files array fails with invalid-message error" note is consistent with the file-count logic.

✅ Structure & UIKit

• 0 nav breaks, 0 orphans, 0 broken links in the changed files; all internal links resolve. (The 2 sdk/ios links the analyzer flagged — default-calling/login-listeners — are pre-existing in unchanged files, not send-message.mdx.)
• UIKit docs use the existing CometChatMessageComposer + attachmentOptions. No placeholders/TODOs.

Note

The SDK feature is on ENG-36750 (freshest branch) — i.e. this documents an in-progress feature. Please confirm the SDK version with uploadFiles/MediaMessage.attachments/getMaxFileCount ships with the release these docs target.

Well-sourced, accurate PR. Ready to merge.

_{🤖 Automated docs review (Mintlify link/redirect/content checks + API verification against CometChatSDK iOS multi-attachment branch).}