feat(ui): add attachmentPickerOptionsBuilder
#2415
Conversation
…rResult` Introduces `attachmentPickerOptionsBuilder` to allow for full customization of the attachment picker options. This builder receives the context and a list of default options, which can then be modified, reordered, or extended. The `customAttachmentPickerOptions` property is now deprecated in favor of `attachmentPickerOptionsBuilder`. A new callback, `onAttachmentPickerResult`, is added. This callback is triggered when any result is returned from the attachment picker. It allows developers to handle custom attachment types by returning `true`. If `false` is returned, the default internal handling proceeds.
|
Important Review skippedAuto reviews are disabled on base/target branches other than the default branch. Please check the settings in the CodeRabbit UI or the You can disable this status message by setting the WalkthroughReplaces per-call customOptions with an optionsBuilder pattern for attachment pickers, updates builders and bottom-sheet wiring, changes OnAttachmentPickerResult to return FutureOr, updates StreamMessageInput wiring to respect handler short-circuiting, and updates sample app usage to the new builder/result APIs. Changes
Sequence Diagram(s)sequenceDiagram
autonumber
actor U as User
participant MI as StreamMessageInput
participant BS as AttachmentPickerBottomSheet
participant PK as Picker (Tabbed/System)
participant OB as optionsBuilder
participant AH as onAttachmentPickerResult
U->>MI: Tap attach
MI->>BS: showStreamAttachmentPickerModalBottomSheet(optionsBuilder)
BS->>PK: Build picker (tabbed/system)
PK->>OB: request options (context, defaultOptions)
OB-->>PK: return List<AttachmentPickerOption>
U->>PK: Select option / complete action
PK-->>MI: StreamAttachmentPickerResult
MI->>AH: call onAttachmentPickerResult(result)?
alt AH returns true (handled)
MI-->>U: stop (user handled)
else AH absent or returns false
MI->>MI: internal default handling
MI-->>U: continue default flow
end
Estimated code review effort🎯 3 (Moderate) | ⏱️ ~25 minutes
Possibly related PRs
Suggested reviewers
Poem
Pre-merge checks and finishing touches❌ Failed checks (1 warning)
✅ Passed checks (2 passed)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
|
@coderabbitai review |
✅ Actions performedReview triggered.
|
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 1
🧹 Nitpick comments (7)
packages/stream_chat_flutter/lib/src/message_input/attachment_picker/stream_attachment_picker_result.dart (1)
7-8: Clarify return semantics and minor doc nitPlease document the boolean meaning (true = handled, false = continue default). Also fix “a attachment” -> “an attachment”.
Example:
-/// Signature for a function that is called when a attachment picker result -/// is received. +/// Signature for a function that is called when an attachment picker result +/// is received. +/// +/// Return `true` to indicate the result was handled by the caller; +/// return `false` to let the SDK perform its default handling. typedef OnAttachmentPickerResult<T extends StreamAttachmentPickerResult> = FutureOr<bool> Function(T result);packages/stream_chat_flutter/lib/src/message_input/attachment_picker/stream_attachment_picker.dart (4)
432-433: Docs still reference customOptions; update to optionsBuilderPublic docs above still mention [customOptions]. Please update to [optionsBuilder] to avoid confusion.
Proposed doc tweak (outside this hunk):
-/// [customOptions], [galleryPickerConfig], [pollConfig], and +/// [optionsBuilder], [galleryPickerConfig], [pollConfig], and
494-496: Typo: rename_handleSingePickto_handleSinglePickMinor but public-facing readability. Update call sites.
- final result = await _handleSingePick(controller, file); + final result = await _handleSinglePick(controller, file);- final result = await _handleSingePick(controller, image); + final result = await _handleSinglePick(controller, image);- final result = await _handleSingePick(controller, video); + final result = await _handleSinglePick(controller, video);And update the declaration (outside selected lines):
// rename Future<StreamAttachmentPickerResult> _handleSinglePick( StreamAttachmentPickerController controller, Attachment? attachment, ) async { ... }Also applies to: 511-514, 530-532
571-575: Error text mentions “custom options”; align to builder APIUpdate error message to guide users correctly.
- 'custom options must be of type TabbedAttachmentPickerOption when using ' - 'the tabbed attachment picker (default on mobile).', + 'optionsBuilder must return only TabbedAttachmentPickerOption when using ' + 'the tabbed attachment picker (default on mobile).',
680-683: Error text mentions “custom options”; align to builder APISame here for system picker.
- 'custom options must be of type SystemAttachmentPickerOption when using ' - 'the system attachment picker (enabled explicitly or on web/desktop).', + 'optionsBuilder must return only SystemAttachmentPickerOption when using ' + 'the system attachment picker (enabled explicitly or on web/desktop).',packages/stream_chat_flutter/lib/src/message_input/attachment_picker/stream_attachment_picker_bottom_sheet.dart (1)
71-94: Docs still reference customOptions; update to optionsBuilder and refresh examplesThe function docs still instruct passing [customOptions]. Replace with [optionsBuilder] and adjust examples to show modifying defaultOptions via the builder.
I can submit a doc update patch for the examples if helpful.
sample_app/lib/pages/channel_page.dart (1)
175-184: Rename helper to reflect new API (optional)Rename
_onCustomAttachmentPickerResultto_onAttachmentPickerResultfor consistency.- bool _onCustomAttachmentPickerResult( + bool _onAttachmentPickerResult( Channel channel, StreamAttachmentPickerResult result, ) { // Notify that the result was not handled. if (result is! LocationPicked) return false; _onShareLocationPicked(channel, result.location).ignore(); return true; // Notify that the result was handled. }
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
Disabled knowledge base sources:
- Linear integration is disabled by default for public repositories
You can enable these sources in your CodeRabbit configuration.
📒 Files selected for processing (5)
packages/stream_chat_flutter/lib/src/message_input/attachment_picker/stream_attachment_picker.dart(4 hunks)packages/stream_chat_flutter/lib/src/message_input/attachment_picker/stream_attachment_picker_bottom_sheet.dart(3 hunks)packages/stream_chat_flutter/lib/src/message_input/attachment_picker/stream_attachment_picker_result.dart(1 hunks)packages/stream_chat_flutter/lib/src/message_input/stream_message_input.dart(4 hunks)sample_app/lib/pages/channel_page.dart(2 hunks)
🔇 Additional comments (6)
packages/stream_chat_flutter/lib/src/message_input/attachment_picker/stream_attachment_picker_bottom_sheet.dart (2)
7-16: Good: flexible options builder APIThe generic AttachmentPickerOptionsBuilder signature is clear and future‑proof.
126-139: Correct wiring of builder selection and optionsBuilder passthroughPicker selection by platform flag and passing optionsBuilder looks solid.
sample_app/lib/pages/channel_page.dart (1)
138-140: Correct usage of onAttachmentPickerResult (bool short‑circuit)Early return pattern is correct and matches new API.
packages/stream_chat_flutter/lib/src/message_input/stream_message_input.dart (3)
161-163: New customization points look goodAdding attachmentPickerOptionsBuilder and onAttachmentPickerResult improves extensibility.
991-999: Correctly passes optionsBuilder through to modalGood wiring to the bottom sheet builder.
1003-1006: Good: user handler gets first dibsShort‑circuiting when the handler returns true aligns with the new contract.
packages/stream_chat_flutter/lib/src/message_input/stream_message_input.dart
Show resolved
Hide resolved
|
These changes should address our usecase - which is basically just being able to update the ordering of widgets in the picker. 🍻 |
|
@coderabbitai review |
✅ Actions performedReview triggered.
|
Codecov Report❌ Patch coverage is Additional details and impacted files@@ Coverage Diff @@
## v10.0.0 #2415 +/- ##
==========================================
Coverage ? 65.73%
==========================================
Files ? 421
Lines ? 26260
Branches ? 0
==========================================
Hits ? 17261
Misses ? 8999
Partials ? 0 ☔ View full report in Codecov by Sentry. 🚀 New features to boost your workflow:
|
Description of the pull request
Introduces
attachmentPickerOptionsBuilderto allow for full customization of the attachment picker options. This builder receives the context and a list of default options, which can then be modified, reordered, or extended.The
customAttachmentPickerOptionsproperty is now deprecated in favor ofattachmentPickerOptionsBuilder.A new callback,
onAttachmentPickerResult, is added. This callback is triggered when any result is returned from the attachment picker. It allows developers to handle custom attachment types by returningtrue. Iffalseis returned, the default internal handling proceeds.Summary by CodeRabbit
New Features
Refactor
Documentation