stream-chat/src/messageComposer/middleware/textComposer/types.ts

JS SDK for the Stream Chat API

import type { MessageComposer } from '../../messageComposer';
import type { MessageComposerEffect } from '../../messageComposer';
import type { CommandResponse, UserResponse } from '../../../types';
import type { TokenizationPayload } from './textMiddlewareUtils';
import type { SearchSource, SearchSourceSync } from '../../../search';
import type { CustomTextComposerSuggestion } from '../../types.custom';

export type TextComposerSuggestion<T = unknown> = T & {
  id: string;
};

export type BaseSuggestion = {
  id: string;
};

export type CommandSuggestionDisabledReason = 'editing' | 'quoted_message';

export type CommandSuggestion = BaseSuggestion & CommandResponse;
export type UserSuggestion = BaseSuggestion & UserResponse & TokenizationPayload;
export type CustomValidSuggestion = BaseSuggestion & CustomTextComposerSuggestion;
export type Suggestion = CommandSuggestion | UserSuggestion | CustomValidSuggestion;

export type TextComposerStateSnapshot = TextComposerState;

export type TextComposerCommandActivationStateToRestore =
  Partial<TextComposerStateSnapshot>;

export type TextComposerCommandActivationEffect = {
  command: CommandResponse;
  stateToRestore?: TextComposerCommandActivationStateToRestore;
  type: 'command.activate';
};

export type TextComposerCommandClearEffect = {
  type: 'command.clear';
};

export type TextComposerEffect = MessageComposerEffect;

export type TextComposerMiddlewareOptions = {
  minChars: number;
  trigger: string;
};

export type TextComposerMiddlewareExecutorOptions = {
  composer: MessageComposer;
};

export type Suggestions<T extends Suggestion = Suggestion> = {
  query: string;
  searchSource: SearchSource<T> | SearchSourceSync<T>;
  trigger: string;
};

export type TextSelection = { end: number; start: number };

export type TextComposerState<T extends Suggestion = Suggestion> = {
  mentionedUsers: UserResponse[];
  selection: TextSelection;
  text: string;
  command?: CommandResponse | null;
  suggestions?: Suggestions<T>;
};