@convokitapp/vue-ui 0.6.0 → 0.8.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Conversation as Conversation$1, InboxPage, MessageListOptions, Message, SendMessageInput, MarkConversationReadOptions, RealtimeConnectionHandlers, RealtimeSubscription, MessageEvent, MessageDeletedEvent, ReadEvent, TypingEvent, ReadPosition, InboxSummary, MessageMedia, ConvoKitClient, InboxEntry } from '@convokitapp/sdk';
+import { Conversation as Conversation$1, InboxPage, MessageListOptions, Message, SendMessageInput, EditMessageInput, MarkConversationReadOptions, ConversationPrivateState, ClearConversationUnreadOptions, ClearUnreadResult, RealtimeConnectionHandlers, RealtimeSubscription, MessageEvent, MessageDeletedEvent, ReadEvent, TypingEvent, ReadPosition, InboxSummary, MessageMedia, ConvoKitClient, InboxEntry } from '@convokitapp/sdk';
 import * as vue from 'vue';
 import { CSSProperties, HTMLAttributes, Ref, VNodeChild, PropType, MaybeRefOrGetter, TextareaHTMLAttributes } from 'vue';
 
@@ -20,17 +20,42 @@ interface ConvoKitUiClient {
         cursor: string | null;
         archived: boolean;
     }): Promise<InboxPage>;
+    /** The room and, from a 0.7 core and backend, the caller's own `membership`; the room store captures
+     * `membership.privateStateVersion` once per open for that open's acknowledgements.
+     */
     getConversation(conversationId: string): Promise<Conversation$1>;
     /** Newest first, with a paired value cursor; never derive an offset from rendered rows. */
     getMessages(options: MessageListOptions): Promise<Message[]>;
     /** Complete authorized message, including related media absent from raw row events. */
     getMessage(id: string): Promise<Message>;
     sendMessage(input: SendMessageInput): Promise<Message>;
-    /** Acknowledge through `options.throughMessageId` (the newest rendered row). Custom adapters must forward it
-     * and reject a missing target with `code: 'MESSAGE_NOT_FOUND'` (or a 404 without a code); the UI never sends a
-     * request without a target. Membership failures keep their error code, if any, so they surface as errors.
+    /** Replace the text of one of the caller's own messages, or clear the caption of a message with attachments with
+     * `text: null` (0.8.0). `revision` is the row's `Message.revision` as the user saw it; a stale value must reject
+     * with `code: 'REVISION_CONFLICT'` (status 409) and a deleted or inaccessible message with `code: 'MESSAGE_NOT_FOUND'`
+     * (status 404). Attachments are never changed. Optional: without it the room store hides the edit affordance and
+     * `saveEdit` rejects.
+     */
+    editMessage?(messageId: string, input: EditMessageInput): Promise<Message>;
+    /** Delete one of the caller's own messages for every member (0.8.0); a message that is already gone must reject
+     * with `code: 'MESSAGE_NOT_FOUND'`. Optional: without it the room store hides the delete affordance and
+     * `deleteMessage` rejects.
+     */
+    deleteMessage?(messageId: string): Promise<void>;
+    /** Acknowledge through `options.throughMessageId` (the newest rendered row). Custom adapters must forward the
+     * options unchanged (0.7 adds `privateStateVersion`, the version captured when the room opened; an adapter that
+     * drops it acknowledges the position but never clears the caller's unread marker) and reject a missing target
+     * with `code: 'MESSAGE_NOT_FOUND'` (or a 404 without a code); the UI never sends a request without a target.
+     * Membership failures keep their error code, if any, so they surface as errors.
      */
     markConversationRead(conversationId: string, options?: MarkConversationReadOptions): Promise<void>;
+    /** Mark the room unread for the caller only (0.7.0). Optional: `markUnread` rejects without it. */
+    markConversationUnread?(conversationId: string): Promise<ConversationPrivateState>;
+    /** Remove the caller's unread marker, only while it still has `options.ifVersion` when given (0.7.0); a mismatch or
+     * an unmarked room answers `cleared: false`, never an error. Optional: `clearUnread` rejects without it, and a room
+     * opened with a marker that renders nothing leaves the marker in place (the room store clears it through this
+     * member, never through an untargeted acknowledgement).
+     */
+    clearConversationUnread?(conversationId: string, options?: ClearConversationUnreadOptions): Promise<ClearUnreadResult>;
     sendTyping(input: {
         conversationId: string;
         isTyping: boolean;
@@ -38,8 +63,9 @@ interface ConvoKitUiClient {
     onConnectionEvent(handlers: RealtimeConnectionHandlers): RealtimeSubscription;
     /** Notify on inbox mutations AND on initial subscription/reconnect. No room data in the signal. */
     onInboxChanged(handler: () => void, onError?: (error: Error) => void): RealtimeSubscription;
-    /** Message inserts/edits and read-position advances in the caller's rooms; never fires on join/rejoin. The list
-     * store throttles these (`activityRefreshWindowMs`); room stores ignore them.
+    /** Message inserts/edits, read-position advances and the caller's own unread-marker changes in the caller's
+     * rooms; never fires on join/rejoin. The list store throttles these (`activityRefreshWindowMs`); room stores
+     * ignore them.
      */
     onInboxActivity?(handler: () => void, onError?: (error: Error) => void): RealtimeSubscription;
     onMessage(conversationId: string, handler: (event: MessageEvent) => void, onError?: (error: Error) => void): RealtimeSubscription;
@@ -64,7 +90,9 @@ interface ConversationPageRequest {
 type ConversationPageLoader = (request: ConversationPageRequest) => Promise<Conversation$1[]>;
 interface ConversationListState {
     conversations: Readonly<Ref<Conversation$1[]>>;
-    /** Per-room preview, unread count and read state by conversation ID; empty on the legacy `getConversations` path. */
+    /** Per-room preview, unread count, read state and private unread marker (`isUnread`, `unreadMarkedAt`,
+     * `privateStateVersion`, 0.7.0) by conversation ID; empty on the legacy `getConversations` path.
+     */
     summaries: Readonly<Ref<ReadonlyMap<string, InboxSummary>>>;
     /** The bound session's user; `''` without a session, on the legacy path and after disposal. */
     currentUserId: Readonly<Ref<string>>;
@@ -91,6 +119,15 @@ interface ConversationState {
     hasLoaded: Readonly<Ref<boolean>>;
     error: Readonly<Ref<unknown>>;
     currentUserId: Readonly<Ref<string>>;
+    /** The row being edited as the user saw it when editing started (0.8.0); its `revision` is what `saveEdit`
+     * sends. Replaced by the current row on a conflict; null when not editing.
+     */
+    editingMessage: Readonly<Ref<Message | null>>;
+    /** Whether the adapter implements `editMessage` / `deleteMessage` (0.8.0). Without it the default rows render no
+     * actions and `startEditing` is a no-op.
+     */
+    canEditMessages: Readonly<Ref<boolean>>;
+    canDeleteMessages: Readonly<Ref<boolean>>;
     readerIdsFor(message: Message): ReadonlySet<string>;
 }
 type ConvoKitUiDensity = 'comfortable' | 'compact';
@@ -106,7 +143,9 @@ interface ConversationItemSlotProps {
     index: number;
     selected: boolean;
     select: () => void;
-    /** Present when the list carries an inbox summary for this row (0.6.0). */
+    /** Present when the list carries an inbox summary for this row (0.6.0); `summary.isUnread` (0.7.0) is the row's
+     * unread state including the viewer's private marker.
+     */
     summary?: InboxSummary;
     /** Present when the list knows the viewer (0.6.0); compare with `summary.latestMessage.senderId`. */
     currentUserId?: string;
@@ -117,6 +156,20 @@ interface MessageSlotProps {
     isCurrentUser: boolean;
     sender: Conversation$1['participants'][number] | undefined;
     readerIds: ReadonlySet<string>;
+    /** `message.revision > 0` (0.8.0): the content changed after the send; never derived from `updatedAt`. */
+    isEdited: boolean;
+    /** Whether the default row would offer the action (0.8.0): the view has the callback and the row is the viewer's
+     * own, confirmed and not read-only (or `canEditMessage` says so).
+     */
+    canEdit: boolean;
+    canDelete: boolean;
+    /** Ask the view to start editing this message (`onEditMessage`); present while `canEdit`. */
+    edit?: () => void;
+    /** Ask the view to delete this message (`onDeleteMessage`) after `confirmDelete` when the view has one, otherwise
+     * at once (a custom row owns its own confirmation); resolves to whether the deletion was accepted. Present while
+     * `canDelete`.
+     */
+    remove?: () => Promise<boolean>;
 }
 interface MediaSlotProps {
     media: MessageMedia;
@@ -128,8 +181,13 @@ interface ComposerSlotProps {
     value: string;
     setValue: (value: string) => void;
     isSending: boolean;
+    /** Sends the draft, or saves the edit in progress while `editing` is present (0.8.0). */
     send: () => void;
     addAttachment?: () => void;
+    /** The message being edited (0.8.0); present while the view is in edit mode. The field already holds its text. */
+    editing?: Message;
+    /** Leave edit mode and restore the unsent draft (0.8.0); present while `editing` is. */
+    cancelEdit?: () => void;
 }
 interface TypingSlotProps {
     userIds: ReadonlySet<string>;
@@ -199,6 +257,21 @@ interface ConversationController extends ConversationState {
         text?: string;
         media?: MessageMedia[];
     }): Promise<Message | null>;
+    /** Enter edit mode on one of the caller's own confirmed messages (0.8.0); a no-op for other rows, for a `READ`
+     * role and for adapters without `editMessage`. Sends nothing (no typing update either).
+     */
+    startEditing(messageId: string): void;
+    /** Leave edit mode without a request. */
+    cancelEditing(): void;
+    /** Save the edit in progress with the snapshot's revision; resolves true when the server accepted it. A stale
+     * revision reloads the row, refreshes `editingMessage` and reports `REVISION_CONFLICT` through `error` (edit mode
+     * and draft kept); see the README for the other outcomes. Rejects when the adapter lacks `editMessage`.
+     */
+    saveEdit(text: string): Promise<boolean>;
+    /** Delete one of the caller's own confirmed messages; resolves true once the row is gone (accepted, or already
+     * unknown to the server). No optimistic removal. Rejects when the adapter lacks `deleteMessage`.
+     */
+    deleteMessage(messageId: string): Promise<boolean>;
     /** Acknowledge through the newest rendered message now; no request is sent while nothing is rendered. */
     markRead(): Promise<void>;
     /** Automatic acknowledgements pause while hidden and resume when the view becomes visible again. */
@@ -224,6 +297,27 @@ interface ConversationViewProps extends ConvoKitAppearanceProps {
     onTypingChange?: (isTyping: boolean) => void | Promise<void>;
     onAddAttachment?: () => void;
     onAttachmentClick?: (media: MessageMedia, message: Message) => void;
+    /** The message being edited (0.8.0), or null. Entering edit mode stashes the unsent draft and prefills the field
+     * with the message text without a typing update; the composer then saves instead of sending.
+     */
+    editingMessage?: Message | null;
+    /** Start editing a message (0.8.0): set `editingMessage` in response. Without it rows offer no edit action. */
+    onEditMessage?: (message: Message) => void;
+    /** Save the edit in progress (0.8.0); the composer's submit calls it instead of `onSendMessage` while
+     * `editingMessage` is set. `false` keeps edit mode and the draft (like `onSendMessage`); any other result
+     * restores the stashed unsent draft. Clear `editingMessage` when the edit is done.
+     */
+    onSaveEdit?: (message: Message, text: string) => boolean | void | Promise<boolean | void>;
+    /** Leave edit mode (0.8.0): clear `editingMessage` in response; the view restores the unsent draft. */
+    onCancelEdit?: () => void;
+    /** Delete a message after confirmation (0.8.0); `false` means it was not accepted. Without it rows offer no
+     * delete action.
+     */
+    onDeleteMessage?: (message: Message) => boolean | void | Promise<boolean | void>;
+    /** Replaces the default row eligibility (own confirmed rows while the viewer's role is not `READ`). */
+    canEditMessage?: (message: Message) => boolean;
+    /** Replaces the inline "Delete this message?" prompt (and confirms `remove()` from custom rows). */
+    confirmDelete?: (message: Message) => boolean | Promise<boolean>;
     isInitialLoading?: boolean;
     isLoadingOlder?: boolean;
     isSending?: boolean;
@@ -303,6 +397,34 @@ declare const ConversationView: vue.DefineComponent<vue.ExtractPropTypes<{
         readonly type: PropType<(media: MessageMedia, message: Message) => void>;
         readonly default: undefined;
     };
+    readonly editingMessage: {
+        readonly type: PropType<Message | null>;
+        readonly default: null;
+    };
+    readonly onEditMessage: {
+        readonly type: PropType<(message: Message) => void>;
+        readonly default: undefined;
+    };
+    readonly onSaveEdit: {
+        readonly type: PropType<(message: Message, text: string) => boolean | void | Promise<boolean | void>>;
+        readonly default: undefined;
+    };
+    readonly onCancelEdit: {
+        readonly type: PropType<() => void>;
+        readonly default: undefined;
+    };
+    readonly onDeleteMessage: {
+        readonly type: PropType<(message: Message) => boolean | void | Promise<boolean | void>>;
+        readonly default: undefined;
+    };
+    readonly canEditMessage: {
+        readonly type: PropType<(message: Message) => boolean>;
+        readonly default: undefined;
+    };
+    readonly confirmDelete: {
+        readonly type: PropType<(message: Message) => boolean | Promise<boolean>>;
+        readonly default: undefined;
+    };
     readonly isInitialLoading: {
         readonly type: BooleanConstructor;
         readonly default: false;
@@ -393,7 +515,7 @@ declare const ConversationView: vue.DefineComponent<vue.ExtractPropTypes<{
     };
 }>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
     [key: string]: any;
-}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, ("load-older" | "attachment-click" | "send-message" | "typing-change" | "back" | "refresh" | "add-attachment" | "update:modelValue")[], "load-older" | "attachment-click" | "send-message" | "typing-change" | "back" | "refresh" | "add-attachment" | "update:modelValue", vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, ("load-older" | "attachment-click" | "edit-message" | "delete-message" | "send-message" | "typing-change" | "back" | "refresh" | "add-attachment" | "update:modelValue" | "save-edit" | "cancel-edit")[], "load-older" | "attachment-click" | "edit-message" | "delete-message" | "send-message" | "typing-change" | "back" | "refresh" | "add-attachment" | "update:modelValue" | "save-edit" | "cancel-edit", vue.PublicProps, Readonly<vue.ExtractPropTypes<{
     readonly conversation: {
         readonly type: PropType<Conversation$1>;
         readonly required: true;
@@ -450,6 +572,34 @@ declare const ConversationView: vue.DefineComponent<vue.ExtractPropTypes<{
         readonly type: PropType<(media: MessageMedia, message: Message) => void>;
         readonly default: undefined;
     };
+    readonly editingMessage: {
+        readonly type: PropType<Message | null>;
+        readonly default: null;
+    };
+    readonly onEditMessage: {
+        readonly type: PropType<(message: Message) => void>;
+        readonly default: undefined;
+    };
+    readonly onSaveEdit: {
+        readonly type: PropType<(message: Message, text: string) => boolean | void | Promise<boolean | void>>;
+        readonly default: undefined;
+    };
+    readonly onCancelEdit: {
+        readonly type: PropType<() => void>;
+        readonly default: undefined;
+    };
+    readonly onDeleteMessage: {
+        readonly type: PropType<(message: Message) => boolean | void | Promise<boolean | void>>;
+        readonly default: undefined;
+    };
+    readonly canEditMessage: {
+        readonly type: PropType<(message: Message) => boolean>;
+        readonly default: undefined;
+    };
+    readonly confirmDelete: {
+        readonly type: PropType<(message: Message) => boolean | Promise<boolean>>;
+        readonly default: undefined;
+    };
     readonly isInitialLoading: {
         readonly type: BooleanConstructor;
         readonly default: false;
@@ -541,12 +691,16 @@ declare const ConversationView: vue.DefineComponent<vue.ExtractPropTypes<{
 }>> & Readonly<{
     "onLoad-older"?: (...args: any[]) => any;
     "onAttachment-click"?: (...args: any[]) => any;
+    "onEdit-message"?: (...args: any[]) => any;
+    "onDelete-message"?: (...args: any[]) => any;
     onBack?: (...args: any[]) => any;
     onRefresh?: (...args: any[]) => any;
     "onSend-message"?: (...args: any[]) => any;
     "onTyping-change"?: (...args: any[]) => any;
     "onAdd-attachment"?: (...args: any[]) => any;
     "onUpdate:modelValue"?: (...args: any[]) => any;
+    "onSave-edit"?: (...args: any[]) => any;
+    "onCancel-edit"?: (...args: any[]) => any;
 }>, {
     readonly typingUserIds: ReadonlySet<string>;
     readonly readAtByUserId: ReadonlyMap<string, Date>;
@@ -555,9 +709,14 @@ declare const ConversationView: vue.DefineComponent<vue.ExtractPropTypes<{
     readonly isLoadingOlder: boolean;
     readonly isSending: boolean;
     readonly hasOlderMessages: boolean;
+    readonly editingMessage: Message | null;
     readonly readersResolver: (message: Message) => ReadonlySet<string>;
     readonly onLoadOlder: () => void | Promise<void>;
     readonly onAttachmentClick: (media: MessageMedia, message: Message) => void;
+    readonly onEditMessage: (message: Message) => void;
+    readonly onDeleteMessage: (message: Message) => boolean | void | Promise<boolean | void>;
+    readonly canEditMessage: (message: Message) => boolean;
+    readonly confirmDelete: (message: Message) => boolean | Promise<boolean>;
     readonly paginationThreshold: number;
     readonly stickToBottom: boolean;
     readonly formatTime: (date: Date) => string;
@@ -570,6 +729,8 @@ declare const ConversationView: vue.DefineComponent<vue.ExtractPropTypes<{
     readonly onRefresh: () => void | Promise<void>;
     readonly onTypingChange: (isTyping: boolean) => void | Promise<void>;
     readonly onAddAttachment: () => void;
+    readonly onSaveEdit: (message: Message, text: string) => boolean | void | Promise<boolean | void>;
+    readonly onCancelEdit: () => void;
     readonly displayNameForUser: (userId: string) => string | null | undefined;
     readonly reverseMessages: boolean;
     readonly composerPlaceholder: string;
@@ -579,7 +740,7 @@ declare const ConversationView: vue.DefineComponent<vue.ExtractPropTypes<{
     readonly defaultDraft: string;
     readonly onDraftChange: (value: string) => void;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
-interface ConversationProps extends Omit<ConversationViewProps, 'conversation' | 'messages' | 'currentUserId' | 'onSendMessage' | 'typingUserIds' | 'readAtByUserId' | 'readPositionByUserId' | 'onRefresh' | 'onLoadOlder' | 'onTypingChange' | 'isInitialLoading' | 'isLoadingOlder' | 'isSending' | 'hasOlderMessages' | 'error'>, Omit<UseConversationOptions, 'client' | 'conversationId'> {
+interface ConversationProps extends Omit<ConversationViewProps, 'conversation' | 'messages' | 'currentUserId' | 'onSendMessage' | 'typingUserIds' | 'readAtByUserId' | 'readPositionByUserId' | 'onRefresh' | 'onLoadOlder' | 'onTypingChange' | 'isInitialLoading' | 'isLoadingOlder' | 'isSending' | 'hasOlderMessages' | 'error' | 'editingMessage' | 'onEditMessage' | 'onSaveEdit' | 'onCancelEdit' | 'onDeleteMessage'>, Omit<UseConversationOptions, 'client' | 'conversationId'> {
     client: ConvoKitUiClient;
     conversationId: string;
     onControllerChange?: (controller: ConversationController) => void;
@@ -602,6 +763,26 @@ declare const Conversation: vue.DefineComponent<vue.ExtractPropTypes<{
         type: PropType<(text: string) => boolean | void | Promise<boolean | void>>;
         default: undefined;
     };
+    editingMessage: {
+        type: PropType<Message | null>;
+        default: undefined;
+    };
+    onEditMessage: {
+        type: PropType<(message: Message) => void>;
+        default: undefined;
+    };
+    onSaveEdit: {
+        type: PropType<(message: Message, text: string) => boolean | void | Promise<boolean | void>>;
+        default: undefined;
+    };
+    onCancelEdit: {
+        type: PropType<() => void>;
+        default: undefined;
+    };
+    onDeleteMessage: {
+        type: PropType<(message: Message) => boolean | void | Promise<boolean | void>>;
+        default: undefined;
+    };
     client: {
         type: PropType<ConvoKitUiClient>;
         required: true;
@@ -674,6 +855,14 @@ declare const Conversation: vue.DefineComponent<vue.ExtractPropTypes<{
         readonly type: PropType<(media: MessageMedia, message: Message) => void>;
         readonly default: undefined;
     };
+    canEditMessage: {
+        readonly type: PropType<(message: Message) => boolean>;
+        readonly default: undefined;
+    };
+    confirmDelete: {
+        readonly type: PropType<(message: Message) => boolean | Promise<boolean>>;
+        readonly default: undefined;
+    };
     isInitialLoading: {
         readonly type: BooleanConstructor;
         readonly default: false;
@@ -764,7 +953,7 @@ declare const Conversation: vue.DefineComponent<vue.ExtractPropTypes<{
     };
 }>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
     [key: string]: any;
-}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, ("load-older" | "attachment-click" | "send-message" | "typing-change" | "back" | "refresh" | "add-attachment" | "update:modelValue" | "controller-change")[], "load-older" | "attachment-click" | "send-message" | "typing-change" | "back" | "refresh" | "add-attachment" | "update:modelValue" | "controller-change", vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, ("load-older" | "attachment-click" | "edit-message" | "delete-message" | "send-message" | "typing-change" | "back" | "refresh" | "add-attachment" | "update:modelValue" | "save-edit" | "cancel-edit" | "controller-change")[], "load-older" | "attachment-click" | "edit-message" | "delete-message" | "send-message" | "typing-change" | "back" | "refresh" | "add-attachment" | "update:modelValue" | "save-edit" | "cancel-edit" | "controller-change", vue.PublicProps, Readonly<vue.ExtractPropTypes<{
     conversation: {
         type: PropType<Conversation$1>;
         default: undefined;
@@ -781,6 +970,26 @@ declare const Conversation: vue.DefineComponent<vue.ExtractPropTypes<{
         type: PropType<(text: string) => boolean | void | Promise<boolean | void>>;
         default: undefined;
     };
+    editingMessage: {
+        type: PropType<Message | null>;
+        default: undefined;
+    };
+    onEditMessage: {
+        type: PropType<(message: Message) => void>;
+        default: undefined;
+    };
+    onSaveEdit: {
+        type: PropType<(message: Message, text: string) => boolean | void | Promise<boolean | void>>;
+        default: undefined;
+    };
+    onCancelEdit: {
+        type: PropType<() => void>;
+        default: undefined;
+    };
+    onDeleteMessage: {
+        type: PropType<(message: Message) => boolean | void | Promise<boolean | void>>;
+        default: undefined;
+    };
     client: {
         type: PropType<ConvoKitUiClient>;
         required: true;
@@ -853,6 +1062,14 @@ declare const Conversation: vue.DefineComponent<vue.ExtractPropTypes<{
         readonly type: PropType<(media: MessageMedia, message: Message) => void>;
         readonly default: undefined;
     };
+    canEditMessage: {
+        readonly type: PropType<(message: Message) => boolean>;
+        readonly default: undefined;
+    };
+    confirmDelete: {
+        readonly type: PropType<(message: Message) => boolean | Promise<boolean>>;
+        readonly default: undefined;
+    };
     isInitialLoading: {
         readonly type: BooleanConstructor;
         readonly default: false;
@@ -944,12 +1161,16 @@ declare const Conversation: vue.DefineComponent<vue.ExtractPropTypes<{
 }>> & Readonly<{
     "onLoad-older"?: (...args: any[]) => any;
     "onAttachment-click"?: (...args: any[]) => any;
+    "onEdit-message"?: (...args: any[]) => any;
+    "onDelete-message"?: (...args: any[]) => any;
     onBack?: (...args: any[]) => any;
     onRefresh?: (...args: any[]) => any;
     "onSend-message"?: (...args: any[]) => any;
     "onTyping-change"?: (...args: any[]) => any;
     "onAdd-attachment"?: (...args: any[]) => any;
     "onUpdate:modelValue"?: (...args: any[]) => any;
+    "onSave-edit"?: (...args: any[]) => any;
+    "onCancel-edit"?: (...args: any[]) => any;
     "onController-change"?: (...args: any[]) => any;
 }>, {
     messages: readonly Message[];
@@ -962,9 +1183,14 @@ declare const Conversation: vue.DefineComponent<vue.ExtractPropTypes<{
     isSending: boolean;
     hasOlderMessages: boolean;
     currentUserId: string;
+    editingMessage: Message | null;
     readersResolver: (message: Message) => ReadonlySet<string>;
     onLoadOlder: () => void | Promise<void>;
     onAttachmentClick: (media: MessageMedia, message: Message) => void;
+    onEditMessage: (message: Message) => void;
+    onDeleteMessage: (message: Message) => boolean | void | Promise<boolean | void>;
+    canEditMessage: (message: Message) => boolean;
+    confirmDelete: (message: Message) => boolean | Promise<boolean>;
     paginationThreshold: number;
     stickToBottom: boolean;
     formatTime: (date: Date) => string;
@@ -978,6 +1204,8 @@ declare const Conversation: vue.DefineComponent<vue.ExtractPropTypes<{
     onRefresh: () => void | Promise<void>;
     onTypingChange: (isTyping: boolean) => void | Promise<void>;
     onAddAttachment: () => void;
+    onSaveEdit: (message: Message, text: string) => boolean | void | Promise<boolean | void>;
+    onCancelEdit: () => void;
     displayNameForUser: (userId: string) => string | null | undefined;
     reverseMessages: boolean;
     composerPlaceholder: string;
@@ -1009,13 +1237,23 @@ interface ConversationListController extends ConversationListState {
     loadMore(): Promise<void>;
     setFilter(filter: ConversationFilter): Promise<void>;
     setQuery(query: string): Promise<void>;
+    /** Mark a room unread for the viewer only (0.7.0); its summary shows the marker at once. Rejects when the adapter
+     * lacks `markConversationUnread`.
+     */
+    markUnread(conversationId: string): Promise<void>;
+    /** Remove the viewer's marker, only while it still has `options.ifVersion` when given; resolves to whether this
+     * request removed it. Rejects when the adapter lacks `clearConversationUnread`.
+     */
+    clearUnread(conversationId: string, options?: ClearConversationUnreadOptions): Promise<boolean>;
     dispose(): Promise<void>;
 }
 declare function useConversationList(options: UseConversationListOptions): ConversationListController;
 
 interface ConversationListViewProps extends ConvoKitAppearanceProps {
     conversations: readonly Conversation$1[];
-    /** Inbox summaries by conversation ID (0.6.0). Rows with one show a preview, time and unread badge. */
+    /** Inbox summaries by conversation ID (0.6.0). Rows with one show a preview, time and unread badge: the count, or
+     * a numberless dot when `isUnread` is set without one (0.7.0).
+     */
     summaries?: ReadonlyMap<string, InboxSummary>;
     /** The viewer; a preview from them reads `You: …`. Absent → no prefix. */
     currentUserId?: string;
@@ -1480,6 +1718,18 @@ interface MessageListViewProps extends ConvoKitAppearanceProps {
     isLoadingOlder?: boolean;
     error?: unknown;
     onAttachmentClick?: (media: MessageMedia, message: Message) => void;
+    /** Start editing a message (0.8.0). Without it no row offers an edit action and the markup is unchanged. */
+    onEditMessage?: (message: Message) => void;
+    /** Delete a message after confirmation (0.8.0); `false` means the deletion was not accepted. Without it no row
+     * offers a delete action.
+     */
+    onDeleteMessage?: (message: Message) => boolean | void | Promise<boolean | void>;
+    /** Replaces the default eligibility (the viewer's own confirmed rows while the viewer's role is not `READ`) for
+     * both actions; pending rows are never eligible.
+     */
+    canEditMessage?: (message: Message) => boolean;
+    /** Replaces the row's inline "Delete this message?" prompt (and confirms `remove()` from custom rows). */
+    confirmDelete?: (message: Message) => boolean | Promise<boolean>;
     scrollElement?: Ref<HTMLElement | null>;
     paginationThreshold?: number;
     reverse?: boolean;
@@ -1535,6 +1785,22 @@ declare const MessageListView: vue.DefineComponent<vue.ExtractPropTypes<{
         type: PropType<(media: MessageMedia, message: Message) => void>;
         default: undefined;
     };
+    onEditMessage: {
+        type: PropType<(message: Message) => void>;
+        default: undefined;
+    };
+    onDeleteMessage: {
+        type: PropType<(message: Message) => boolean | void | Promise<boolean | void>>;
+        default: undefined;
+    };
+    canEditMessage: {
+        type: PropType<(message: Message) => boolean>;
+        default: undefined;
+    };
+    confirmDelete: {
+        type: PropType<(message: Message) => boolean | Promise<boolean>>;
+        default: undefined;
+    };
     scrollElement: {
         type: PropType<Ref<HTMLElement | null>>;
         default: undefined;
@@ -1577,7 +1843,7 @@ declare const MessageListView: vue.DefineComponent<vue.ExtractPropTypes<{
     };
 }>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
     [key: string]: any;
-}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, ("load-older" | "attachment-click")[], "load-older" | "attachment-click", vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, ("load-older" | "attachment-click" | "edit-message" | "delete-message")[], "load-older" | "attachment-click" | "edit-message" | "delete-message", vue.PublicProps, Readonly<vue.ExtractPropTypes<{
     conversation: {
         type: PropType<Conversation$1>;
         required: true;
@@ -1622,6 +1888,22 @@ declare const MessageListView: vue.DefineComponent<vue.ExtractPropTypes<{
         type: PropType<(media: MessageMedia, message: Message) => void>;
         default: undefined;
     };
+    onEditMessage: {
+        type: PropType<(message: Message) => void>;
+        default: undefined;
+    };
+    onDeleteMessage: {
+        type: PropType<(message: Message) => boolean | void | Promise<boolean | void>>;
+        default: undefined;
+    };
+    canEditMessage: {
+        type: PropType<(message: Message) => boolean>;
+        default: undefined;
+    };
+    confirmDelete: {
+        type: PropType<(message: Message) => boolean | Promise<boolean>>;
+        default: undefined;
+    };
     scrollElement: {
         type: PropType<Ref<HTMLElement | null>>;
         default: undefined;
@@ -1665,6 +1947,8 @@ declare const MessageListView: vue.DefineComponent<vue.ExtractPropTypes<{
 }>> & Readonly<{
     "onLoad-older"?: (...args: any[]) => any;
     "onAttachment-click"?: (...args: any[]) => any;
+    "onEdit-message"?: (...args: any[]) => any;
+    "onDelete-message"?: (...args: any[]) => any;
 }>, {
     reverse: boolean;
     readAtByUserId: ReadonlyMap<string, Date>;
@@ -1674,6 +1958,10 @@ declare const MessageListView: vue.DefineComponent<vue.ExtractPropTypes<{
     readersResolver: (message: Message) => ReadonlySet<string>;
     onLoadOlder: () => void | Promise<void>;
     onAttachmentClick: (media: MessageMedia, message: Message) => void;
+    onEditMessage: (message: Message) => void;
+    onDeleteMessage: (message: Message) => boolean | void | Promise<boolean | void>;
+    canEditMessage: (message: Message) => boolean;
+    confirmDelete: (message: Message) => boolean | Promise<boolean>;
     scrollElement: Ref<HTMLElement | null, HTMLElement | null>;
     paginationThreshold: number;
     stickToBottom: boolean;
@@ -1697,7 +1985,7 @@ interface ConvoKitTheme {
     incomingBubble: string;
     outgoingBubble: string;
     outgoingText: string;
-    /** Unread badge background (0.6.0); its label uses `outgoingText`. Defaults to the primary color. */
+    /** Unread badge and dot background (0.6.0); the badge label uses `outgoingText`. Defaults to the primary color. */
     badge: string;
     radius: string;
     avatarSize: string;