@webitel/ui-chats 26.8.3 → 26.8.4

package/types/v2/locale/kz.d.ts

@@ -0,0 +1,26 @@
+declare const _default: {
+    composer: {
+        placeholder: string;
+        attach: string;
+        emoji: string;
+        send: string;
+    };
+    history: {
+        today: string;
+        waitingForOperator: string;
+        deletedMessage: string;
+        unsupportedMessage: string;
+        download: string;
+    };
+    systemNotice: {
+        started: string;
+        joined: string;
+        accepted: string;
+        transferred: string;
+        left: string;
+        ended: string;
+        unknown: string;
+        system: string;
+    };
+};
+export default _default;

package/types/v2/locale/pl.d.ts

@@ -0,0 +1,26 @@
+declare const _default: {
+    composer: {
+        placeholder: string;
+        attach: string;
+        emoji: string;
+        send: string;
+    };
+    history: {
+        today: string;
+        waitingForOperator: string;
+        deletedMessage: string;
+        unsupportedMessage: string;
+        download: string;
+    };
+    systemNotice: {
+        started: string;
+        joined: string;
+        accepted: string;
+        transferred: string;
+        left: string;
+        ended: string;
+        unknown: string;
+        system: string;
+    };
+};
+export default _default;

package/types/v2/locale/ro.d.ts

@@ -0,0 +1,26 @@
+declare const _default: {
+    composer: {
+        placeholder: string;
+        attach: string;
+        emoji: string;
+        send: string;
+    };
+    history: {
+        today: string;
+        waitingForOperator: string;
+        deletedMessage: string;
+        unsupportedMessage: string;
+        download: string;
+    };
+    systemNotice: {
+        started: string;
+        joined: string;
+        accepted: string;
+        transferred: string;
+        left: string;
+        ended: string;
+        unknown: string;
+        system: string;
+    };
+};
+export default _default;

package/types/v2/locale/ru.d.ts

@@ -0,0 +1,26 @@
+declare const _default: {
+    composer: {
+        placeholder: string;
+        attach: string;
+        emoji: string;
+        send: string;
+    };
+    history: {
+        today: string;
+        waitingForOperator: string;
+        deletedMessage: string;
+        unsupportedMessage: string;
+        download: string;
+    };
+    systemNotice: {
+        started: string;
+        joined: string;
+        accepted: string;
+        transferred: string;
+        left: string;
+        ended: string;
+        unknown: string;
+        system: string;
+    };
+};
+export default _default;

package/types/v2/locale/uk.d.ts

@@ -0,0 +1,26 @@
+declare const _default: {
+    composer: {
+        placeholder: string;
+        attach: string;
+        emoji: string;
+        send: string;
+    };
+    history: {
+        today: string;
+        waitingForOperator: string;
+        deletedMessage: string;
+        unsupportedMessage: string;
+        download: string;
+    };
+    systemNotice: {
+        started: string;
+        joined: string;
+        accepted: string;
+        transferred: string;
+        left: string;
+        ended: string;
+        unknown: string;
+        system: string;
+    };
+};
+export default _default;

package/types/v2/locale/useChatsV2I18n.d.ts

@@ -0,0 +1,5 @@
+/** `t` scoped to the v2 namespace: `t('composer.placeholder')`. */
+export declare const useChatsV2I18n: () => {
+    t: (path: string, named?: Record<string, unknown>) => any;
+    locale: any;
+};

package/types/v2/locale/uz.d.ts

@@ -0,0 +1,26 @@
+declare const _default: {
+    composer: {
+        placeholder: string;
+        attach: string;
+        emoji: string;
+        send: string;
+    };
+    history: {
+        today: string;
+        waitingForOperator: string;
+        deletedMessage: string;
+        unsupportedMessage: string;
+        download: string;
+    };
+    systemNotice: {
+        started: string;
+        joined: string;
+        accepted: string;
+        transferred: string;
+        left: string;
+        ended: string;
+        unknown: string;
+        system: string;
+    };
+};
+export default _default;

package/types/v2/locale/vi.d.ts

@@ -0,0 +1,26 @@
+declare const _default: {
+    composer: {
+        placeholder: string;
+        attach: string;
+        emoji: string;
+        send: string;
+    };
+    history: {
+        today: string;
+        waitingForOperator: string;
+        deletedMessage: string;
+        unsupportedMessage: string;
+        download: string;
+    };
+    systemNotice: {
+        started: string;
+        joined: string;
+        accepted: string;
+        transferred: string;
+        left: string;
+        ended: string;
+        unknown: string;
+        system: string;
+    };
+};
+export default _default;

package/types/v2/scripts/__tests__/fixtures.d.ts

@@ -0,0 +1,7 @@
+import type { ChatParticipant, MessageModel, ThreadModel } from '../../types';
+export declare const operator: ChatParticipant;
+export declare const colleague: ChatParticipant;
+export declare const bot: ChatParticipant;
+export declare const client: ChatParticipant;
+export declare const message: (overrides?: Partial<MessageModel>) => MessageModel;
+export declare const thread: (overrides?: Partial<ThreadModel>) => ThreadModel;

package/types/v2/scripts/attachments.d.ts

@@ -0,0 +1,30 @@
+import type { ChatDocument, ChatImage, MessageModel } from '../types';
+export interface ChatFileCard {
+    key: string;
+    name: string;
+    size?: string;
+    mime?: string;
+    url?: string;
+}
+export interface ClassifiedAttachments {
+    images: Array<{
+        key: string;
+        image: ChatImage;
+    }>;
+    media: Array<{
+        key: string;
+        document: ChatDocument;
+        kind: 'audio' | 'video';
+    }>;
+    files: ChatFileCard[];
+}
+export interface GalleryImage {
+    key: string;
+    src: string;
+}
+export declare const imageKey: (message: MessageModel, image: ChatImage, index: number) => string;
+export declare const isRenderableImage: (image: ChatImage) => boolean;
+export declare const hasAttachments: (message: MessageModel) => boolean;
+export declare const classifyAttachments: (message: MessageModel) => ClassifiedAttachments;
+/** Every drawable image across the history, in history order. */
+export declare const collectGalleryImages: (messages: readonly MessageModel[]) => GalleryImage[];

package/types/v2/scripts/formatDate.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Whether two instants fall on the same calendar day in `timeZone` — the
+ * operator's setting by default, the one the rest of the app formats with.
+ */
+export declare const isSameDayInZone: (a: number, b: number, timeZone?: string) => boolean;
+/** "Today" · "September 15" · "September 15, 2025" (AC_03.02.02). */
+export declare const formatDividerDate: (timestamp: number, { locale, todayLabel, now, timeZone, }: {
+    locale: string;
+    todayLabel: string;
+    now?: number;
+    timeZone?: string;
+}) => string;
+/**
+ * 24h "HH:mm", as in DES-730, in the operator's time zone. Not the shared
+ * formatDate 'time' mode: its uk 'p' pattern drops the leading zero ("9:05").
+ */
+export declare const formatMessageTime: (timestamp: number, timeZone?: string) => string;

package/types/v2/scripts/getMessageStatus.d.ts

@@ -0,0 +1,8 @@
+import type { ChatMessageStatus, MessageModel, ThreadModel } from '../types';
+/**
+ * Sent / delivered / read for the operator's own messages, against the
+ * client's read horizon: the lowest horizon over every client member, so a
+ * message counts as read only once all clients have read it.
+ * `null` when no ticks should show.
+ */
+export declare const getMessageStatus: (message: MessageModel, thread: ThreadModel, selfMemberId: string) => ChatMessageStatus | null;

package/types/v2/scripts/isContactCentreSide.d.ts

@@ -0,0 +1,8 @@
+import type { ChatParticipant } from '../types';
+/**
+ * ⚠ Carried over from v1 (`chat-message.vue`, `member.type === 'webitel'`);
+ * not confirmed for the new IM backend. This is the one place to change it.
+ */
+export declare const INTERNAL_CONTACT_TYPE = "webitel";
+/** Operators and bots speak for the contact centre; everyone else is the client. */
+export declare const isContactCentreSide: (member: ChatParticipant | undefined) => boolean;

package/types/v2/scripts/resolveSystemNotice.d.ts

@@ -0,0 +1,23 @@
+import type { ChatNoticeTone, ChatParticipant, MessageModel, ThreadModel } from '../types';
+export interface SystemNoticeDefinition {
+    /** relative to the v2 locale namespace */
+    textKey: string;
+    tone: ChatNoticeTone;
+}
+/**
+ * ⚠ WS-22 (backend, "Need info"): only `member_added`, `member_removed` and
+ * `transferred` are documented. The started / accepted / closed type strings
+ * are assumed — confirm them there and change only this table.
+ */
+export declare const SYSTEM_NOTICES: Record<string, SystemNoticeDefinition>;
+export interface ResolvedSystemNotice {
+    /** null when `fallbackText` should be shown instead */
+    textKey: string | null;
+    /** the backend's own text, for types the table does not know */
+    fallbackText: string | null;
+    tone: ChatNoticeTone;
+    actor: ChatParticipant | undefined;
+}
+export declare const resolveSystemNotice: (message: MessageModel, thread: ThreadModel) => ResolvedSystemNotice;
+/** Display name, or '' when the participant carries none. */
+export declare const participantName: (member: ChatParticipant | undefined) => string;

package/types/v2/scripts/toHistoryItems.d.ts

@@ -0,0 +1,19 @@
+import type { MessageModel } from '../types';
+export type ChatHistoryItem = {
+    kind: 'divider';
+    key: string;
+    /** timestamp of the first item of that day */
+    date: number;
+} | {
+    kind: 'message' | 'system';
+    key: string;
+    message: MessageModel;
+};
+/**
+ * Messages (oldest → newest) as render rows, with a divider before the first
+ * item of each calendar day in `timeZone` (the operator's setting by default).
+ * Items without a usable `createdAt` never open a new day.
+ */
+export declare const toHistoryItems: (messages: readonly MessageModel[], { timeZone, }?: {
+    timeZone?: string;
+}) => ChatHistoryItem[];

package/types/v2/scripts/toTimestamp.d.ts

@@ -0,0 +1,7 @@
+/** Backend timestamps are Unix ms as strings; `null` when absent or unusable. */
+export declare const toTimestamp: (value: string | number | undefined | null) => number | null;
+/**
+ * Per-thread message sequence numbers arrive as strings. Compare them as
+ * numbers: as strings, "10" sorts before "9".
+ */
+export declare const toSeq: (value: string | number | null | undefined) => number | null;

package/types/v2/types/index.d.ts

@@ -0,0 +1,54 @@
+import type { MessageModel, ThreadModel } from '@webitel/chat-web-sdk';
+export type { MessageModel, ThreadModel };
+export declare const ChatThreadMode: {
+    /** offered to the operator, not accepted yet: no composer, waiting line */
+    readonly Awaiting: "awaiting";
+    readonly Active: "active";
+    /** closed or otherwise not writable: no composer */
+    readonly Readonly: "readonly";
+};
+export type ChatThreadMode = (typeof ChatThreadMode)[keyof typeof ChatThreadMode];
+export declare const ChatComposerAction: {
+    readonly Attach: "attach";
+    readonly Emoji: "emoji";
+    readonly Send: "send";
+};
+export type ChatComposerAction = (typeof ChatComposerAction)[keyof typeof ChatComposerAction];
+export type ChatMessageStatus = 'sent' | 'delivered' | 'read';
+export type ChatNoticeTone = 'positive' | 'neutral' | 'negative';
+/** A thread member as it arrives on `message.sender` and `thread.members[]`. */
+export type ChatParticipant = NonNullable<MessageModel['sender']>;
+export type ChatImage = NonNullable<MessageModel['images']>[number];
+export type ChatDocument = NonNullable<MessageModel['documents']>[number];
+export type ResolveAvatarUrl = (member: ChatParticipant) => string | undefined;
+export type ChatSendHandler = (text: string) => Promise<unknown>;
+export type ChatAttachHandler = (files: File[]) => Promise<unknown>;
+export type ChatLoadMoreHandler = () => Promise<unknown>;
+export interface ChatComposerSlotProps {
+    /** inserts at the cursor (or appends) and updates the draft */
+    insertText: (text: string) => void;
+    focus: () => void;
+    disabled: boolean;
+}
+export interface ChatHistoryProps {
+    thread: ThreadModel;
+    /** oldest → newest; current and earlier sessions */
+    messages: MessageModel[];
+    /** thread-member id of the operator using the UI */
+    selfMemberId: string;
+    mode?: ChatThreadMode;
+    hasMore?: boolean;
+    onLoadMore?: ChatLoadMoreHandler;
+    resolveAvatarUrl?: ResolveAvatarUrl;
+}
+export interface ChatComposerProps {
+    onSend?: ChatSendHandler;
+    onAttach?: ChatAttachHandler;
+    actions?: ChatComposerAction[];
+    submitOnEnter?: boolean;
+    disabled?: boolean;
+}
+export interface ChatThreadProps extends ChatHistoryProps, ChatComposerProps {
+    /** controlled draft (v-model:draft); omit to let the composer own it */
+    draft?: string;
+}

package/types/v2/ui/__tests__/mountWithChats.d.ts

@@ -0,0 +1,8 @@
+import { mount } from '@vue/test-utils';
+export declare const chatsI18n: () => any;
+export declare const mountWithChats: typeof mount;
+export declare const deferred: <T = void>() => {
+    promise: Promise<T>;
+    resolve: (value: T) => void;
+    reject: (reason?: unknown) => void;
+};

package/types/v2/ui/chat-composer/chat-composer.vue.d.ts

@@ -0,0 +1,31 @@
+import { ChatComposerAction, type ChatComposerProps, type ChatComposerSlotProps } from '../../types';
+type __VLS_Props = ChatComposerProps;
+type __VLS_Slots = {
+    actions?: (props: ChatComposerSlotProps) => unknown;
+};
+declare function focus(): void;
+declare function insertText(text: string): void;
+type __VLS_ModelProps = {
+    'draft'?: string;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
+    focus: typeof focus;
+    insertText: typeof insertText;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:draft": (value: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:draft"?: ((value: string) => any) | undefined;
+}>, {
+    actions: ChatComposerAction[];
+    submitOnEnter: boolean;
+    disabled: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/types/v2/ui/chat-history/chat-history.vue.d.ts

@@ -0,0 +1,11 @@
+import { type ChatHistoryProps, ChatThreadMode, type MessageModel } from '../../types';
+declare const __VLS_export: import("vue").DefineComponent<ChatHistoryProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    seen: (message: MessageModel) => any;
+}, string, import("vue").PublicProps, Readonly<ChatHistoryProps> & Readonly<{
+    onSeen?: ((message: MessageModel) => any) | undefined;
+}>, {
+    mode: ChatThreadMode;
+    hasMore: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/types/v2/ui/chat-history/components/chat-date-divider.vue.d.ts

@@ -0,0 +1,6 @@
+type __VLS_Props = {
+    date: number;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/types/v2/ui/chat-history/components/chat-message.vue.d.ts

@@ -0,0 +1,10 @@
+import type { MessageModel, ResolveAvatarUrl, ThreadModel } from '../../../types';
+type __VLS_Props = {
+    message: MessageModel;
+    thread: ThreadModel;
+    selfMemberId: string;
+    resolveAvatarUrl?: ResolveAvatarUrl;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/types/v2/ui/chat-history/components/chat-system-notice.vue.d.ts

@@ -0,0 +1,9 @@
+import type { MessageModel, ResolveAvatarUrl, ThreadModel } from '../../../types';
+type __VLS_Props = {
+    message: MessageModel;
+    thread: ThreadModel;
+    resolveAvatarUrl?: ResolveAvatarUrl;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/types/v2/ui/chat-history/components/message-attachments.vue.d.ts

@@ -0,0 +1,7 @@
+import type { MessageModel } from '../../../types';
+type __VLS_Props = {
+    message: MessageModel;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/types/v2/ui/chat-history/components/message-status.vue.d.ts

@@ -0,0 +1,7 @@
+import type { ChatMessageStatus } from '../../../types';
+type __VLS_Props = {
+    status: ChatMessageStatus;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/types/v2/ui/chat-history/components/message-text.vue.d.ts

@@ -0,0 +1,6 @@
+type __VLS_Props = {
+    text: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/types/v2/ui/chat-history/components/scroll-to-bottom-btn.vue.d.ts

@@ -0,0 +1,12 @@
+type __VLS_Props = {
+    newMessageCount?: number;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    scroll: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onScroll?: (() => any) | undefined;
+}>, {
+    newMessageCount: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/types/v2/ui/chat-history/gallery.d.ts

@@ -0,0 +1,6 @@
+import type { InjectionKey } from 'vue';
+export interface ChatGallery {
+    /** opens the history-wide gallery at the image with this key */
+    open: (imageKey: string) => void;
+}
+export declare const ChatGalleryKey: InjectionKey<ChatGallery>;

package/types/v2/ui/chat-thread/chat-thread.vue.d.ts

@@ -0,0 +1,26 @@
+import { ChatComposerAction, type ChatComposerSlotProps, ChatThreadMode, type ChatThreadProps, type MessageModel } from '../../types';
+type __VLS_Slots = {
+    actions?: (props: ChatComposerSlotProps) => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<ChatThreadProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:draft": (draft: string) => any;
+    seen: (message: MessageModel) => any;
+}, string, import("vue").PublicProps, Readonly<ChatThreadProps> & Readonly<{
+    "onUpdate:draft"?: ((draft: string) => any) | undefined;
+    onSeen?: ((message: MessageModel) => any) | undefined;
+}>, {
+    actions: ChatComposerAction[];
+    submitOnEnter: boolean;
+    mode: ChatThreadMode;
+    draft: string;
+    hasMore: boolean;
+    disabled: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};