zcw-shared 2.23.6 → 2.25.0

package/dist/functions/im/imChatMessageLookup.d.ts

@@ -0,0 +1,3 @@
+import type { ChatMessage } from '../../../types/im-chat';
+export declare function findChatMessageIndexByClientMessageId(messages: readonly ChatMessage[], clientMessageId: string): number;
+export declare function isSameTrimmedConversationId(conversationId: string, activeConversationId: string | null | undefined, idsEqual: (a: string, b: string) => boolean): boolean;

package/dist/functions/im/imChatMessageLookup.js

@@ -0,0 +1,13 @@
+export function findChatMessageIndexByClientMessageId(messages, clientMessageId) {
+    const cmid = clientMessageId.trim();
+    if (!cmid)
+        return -1;
+    return messages.findIndex((m) => m.clientMessageId === cmid);
+}
+export function isSameTrimmedConversationId(conversationId, activeConversationId, idsEqual) {
+    const cid = conversationId.trim();
+    if (!cid || activeConversationId == null)
+        return false;
+    return idsEqual(cid, activeConversationId);
+}
+//# sourceMappingURL=imChatMessageLookup.js.map

package/dist/functions/im/imChatMessageLookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imChatMessageLookup.js","sourceRoot":"","sources":["../../../src/functions/im/imChatMessageLookup.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,qCAAqC,CACnD,QAAgC,EAChC,eAAuB;IAEvB,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,EAAE,CAAA;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC,CAAA;IACpB,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,KAAK,IAAI,CAAC,CAAA;AAC9D,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,cAAsB,EACtB,oBAA+C,EAC/C,QAA2C;IAE3C,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,EAAE,CAAA;IACjC,IAAI,CAAC,GAAG,IAAI,oBAAoB,IAAI,IAAI;QAAE,OAAO,KAAK,CAAA;IACtD,OAAO,QAAQ,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAA;AAC5C,CAAC"}

package/dist/functions/im/imChatMessageMap.d.ts

@@ -0,0 +1,13 @@
+import type { ChatMessage } from '../../../types/im-chat';
+export declare function mapImTypeToChat(t: string): ChatMessage['type'];
+export interface ChatStickerMetaFromExtra {
+    packId?: number;
+    stickerId?: number;
+    name?: string;
+    url?: string;
+    width?: number;
+    height?: number;
+}
+export declare function parseStickerFromExtra(extra: Record<string, unknown> | undefined): ChatStickerMetaFromExtra;
+export declare function readVoiceDurationSecFromExtra(extra: Record<string, unknown> | undefined): number | undefined;
+export declare function imChatShortId(id: string): string;

package/dist/functions/im/imChatMessageMap.js

@@ -0,0 +1,62 @@
+import { pickPositiveNumber } from './imImagePixelExtra.js';
+export function mapImTypeToChat(t) {
+    if (t === 'forward_bundle')
+        return 'forward_bundle';
+    if (t === 'markdown')
+        return 'markdown';
+    if (t === 'sticker')
+        return 'sticker';
+    if (t === 'transfer')
+        return 'transfer';
+    if (t === 'red_envelope')
+        return 'red_envelope';
+    if (t === 'image' || t === 'file' || t === 'video')
+        return t;
+    if (t === 'audio')
+        return 'voice';
+    if (t === 'system')
+        return 'system';
+    return 'text';
+}
+export function parseStickerFromExtra(extra) {
+    if (!extra)
+        return {};
+    const raw = extra.sticker;
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return {};
+    const rec = raw;
+    const packId = Number(rec.pack_id);
+    const stickerId = Number(rec.sticker_id);
+    const url = typeof rec.url === 'string' ? rec.url.trim() : undefined;
+    const name = typeof rec.name === 'string' ? rec.name.trim() : undefined;
+    const width = pickPositiveNumber(rec.width);
+    const height = pickPositiveNumber(rec.height);
+    return {
+        ...(Number.isFinite(packId) && packId > 0 ? { packId } : {}),
+        ...(Number.isFinite(stickerId) && stickerId > 0 ? { stickerId } : {}),
+        ...(name ? { name } : {}),
+        ...(url ? { url } : {}),
+        ...(width != null ? { width } : {}),
+        ...(height != null ? { height } : {}),
+    };
+}
+export function readVoiceDurationSecFromExtra(extra) {
+    if (!extra)
+        return undefined;
+    const raw = extra.duration_ms ?? extra.durationMs ?? extra.voice_duration_ms;
+    if (typeof raw === 'number' && Number.isFinite(raw) && raw > 0) {
+        return Math.max(1, Math.round(raw / 1000));
+    }
+    if (typeof raw === 'string' && raw.trim()) {
+        const n = Number(raw.trim());
+        if (Number.isFinite(n) && n > 0)
+            return Math.max(1, Math.round(n / 1000));
+    }
+    return undefined;
+}
+export function imChatShortId(id) {
+    if (id.length <= 12)
+        return id;
+    return `${id.slice(0, 8)}…`;
+}
+//# sourceMappingURL=imChatMessageMap.js.map

package/dist/functions/im/imChatMessageMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imChatMessageMap.js","sourceRoot":"","sources":["../../../src/functions/im/imChatMessageMap.ts"],"names":[],"mappings":"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"}

package/dist/functions/im/imChatMessageMediaAsset.d.ts

@@ -0,0 +1,5 @@
+import type { ChatMessage } from '../../../types/im-chat';
+export declare function chatMessagePrimaryAssetUrl(m: ChatMessage): string | null;
+export declare function chatMessageSupportsDownload(m: ChatMessage): boolean;
+export declare function defaultExtForChatMessageMediaType(t: ChatMessage['type']): string;
+export declare function buildChatMessageDownloadFilename(m: ChatMessage): string | null;

package/dist/functions/im/imChatMessageMediaAsset.js

@@ -0,0 +1,32 @@
+import { isInlinePreviewableAssetUrl } from '../url/assetUrlGuards.js';
+import { suggestFilenameFromUrl } from '../file/suggestFilenameFromUrl.js';
+export function chatMessagePrimaryAssetUrl(m) {
+    const c = m.content?.trim() ?? '';
+    if (!c)
+        return null;
+    if (isInlinePreviewableAssetUrl(c))
+        return c;
+    return null;
+}
+export function chatMessageSupportsDownload(m) {
+    return (['image', 'video', 'file', 'voice'].includes(m.type) &&
+        chatMessagePrimaryAssetUrl(m) != null);
+}
+export function defaultExtForChatMessageMediaType(t) {
+    if (t === 'image')
+        return '.jpg';
+    if (t === 'video')
+        return '.mp4';
+    if (t === 'voice')
+        return '.mp3';
+    return '';
+}
+export function buildChatMessageDownloadFilename(m) {
+    const url = chatMessagePrimaryAssetUrl(m);
+    if (!url)
+        return null;
+    const fromMeta = m.mediaOriginalFileName?.trim();
+    const fallback = `${m.type}-${String(m.id).replace(/[/\\?*:|"<>]/g, '_').slice(0, 40)}${defaultExtForChatMessageMediaType(m.type)}`;
+    return fromMeta || suggestFilenameFromUrl(url, fallback || 'download');
+}
+//# sourceMappingURL=imChatMessageMediaAsset.js.map

package/dist/functions/im/imChatMessageMediaAsset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imChatMessageMediaAsset.js","sourceRoot":"","sources":["../../../src/functions/im/imChatMessageMediaAsset.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAA;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AAGvE,MAAM,UAAU,0BAA0B,CAAC,CAAc;IACvD,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IACjC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IACnB,IAAI,2BAA2B,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAA;IAC5C,OAAO,IAAI,CAAA;AACb,CAAC;AAGD,MAAM,UAAU,2BAA2B,CAAC,CAAc;IACxD,OAAO,CACL,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;QACpD,0BAA0B,CAAC,CAAC,CAAC,IAAI,IAAI,CACtC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,CAAsB;IACtE,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,MAAM,CAAA;IAChC,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,MAAM,CAAA;IAChC,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,MAAM,CAAA;IAChC,OAAO,EAAE,CAAA;AACX,CAAC;AAGD,MAAM,UAAU,gCAAgC,CAAC,CAAc;IAC7D,MAAM,GAAG,GAAG,0BAA0B,CAAC,CAAC,CAAC,CAAA;IACzC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAA;IACrB,MAAM,QAAQ,GAAG,CAAC,CAAC,qBAAqB,EAAE,IAAI,EAAE,CAAA;IAChD,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,iCAAiC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAA;IACnI,OAAO,QAAQ,IAAI,sBAAsB,CAAC,GAAG,EAAE,QAAQ,IAAI,UAAU,CAAC,CAAA;AACxE,CAAC"}

package/dist/functions/im/imChatMessagePagination.d.ts

@@ -0,0 +1,27 @@
+import type { ImMessage } from '../../../types/im-api';
+import type { ChatMessage } from '../../../types/im-chat';
+export declare const CHAT_MESSAGE_PAGE_MIN = 6;
+export declare const CHAT_MESSAGE_PAGE_MAX = 30;
+export declare const CHAT_MESSAGE_PAGE_DEFAULT = 12;
+export declare const CHAT_MESSAGE_FALLBACK_ROW_PX = 68;
+export declare const CHAT_MESSAGE_ESTIMATED_ROW_PX = 68;
+export declare const CHAT_MESSAGE_VIEWPORT_FILL_RATIO = 1;
+export declare const CHAT_MESSAGE_MAX_FILL_PASSES = 2;
+export declare const CHAT_MESSAGE_SCROLL_TOP_TRIGGER_PX = 180;
+export type ChatMessageViewportSource = {
+    clientHeight: number;
+    scrollHeight?: number;
+} | null | undefined;
+export declare function estimateImMessageRowPx(m: ImMessage): number;
+export declare function estimateChatMessageRowPx(m: ChatMessage): number;
+export declare function estimateInitialMessageLimit(viewport: ChatMessageViewportSource, imRows?: readonly ImMessage[], chatMessages?: readonly ChatMessage[]): number;
+export declare function estimateFillOlderMessageLimit(viewport: ChatMessageViewportSource, chatMessages: readonly ChatMessage[]): number;
+export declare function resolveRecentMessageRefreshLimit(viewport: ChatMessageViewportSource, priorDisplayed: readonly ChatMessage[]): number;
+export declare function resolveInitialMessagesPageLimitFromLocal(viewport: ChatMessageViewportSource, localRows: readonly ImMessage[], baseLimit?: number): number;
+export declare function resolveLoadOlderMessagesLimit(viewport: ChatMessageViewportSource, priorDisplayed: readonly ChatMessage[], opts?: {
+    fillGap?: boolean;
+}): number;
+export declare function isChatMessageViewportUnderfilled(viewport: {
+    clientHeight: number;
+    scrollHeight: number;
+} | null | undefined, gapPx?: number): boolean;

package/dist/functions/im/imChatMessagePagination.js

@@ -0,0 +1,170 @@
+export const CHAT_MESSAGE_PAGE_MIN = 6;
+export const CHAT_MESSAGE_PAGE_MAX = 30;
+export const CHAT_MESSAGE_PAGE_DEFAULT = 12;
+export const CHAT_MESSAGE_FALLBACK_ROW_PX = 68;
+export const CHAT_MESSAGE_ESTIMATED_ROW_PX = CHAT_MESSAGE_FALLBACK_ROW_PX;
+export const CHAT_MESSAGE_VIEWPORT_FILL_RATIO = 1;
+export const CHAT_MESSAGE_MAX_FILL_PASSES = 2;
+export const CHAT_MESSAGE_SCROLL_TOP_TRIGGER_PX = 180;
+const ROW_BASE_PX = 52;
+const ROW_LINE_HEIGHT_PX = 21;
+const TEXT_CHARS_PER_LINE = 28;
+const ROW_MIN_PX = 44;
+const ROW_MAX_PX = 480;
+function clampMessageLimit(n) {
+    return Math.min(CHAT_MESSAGE_PAGE_MAX, Math.max(CHAT_MESSAGE_PAGE_MIN, Math.ceil(n)));
+}
+function clampRowPx(px) {
+    return Math.min(ROW_MAX_PX, Math.max(ROW_MIN_PX, px));
+}
+function imDisplayCharLength(extra) {
+    const raw = extra?.im_display;
+    if (!Array.isArray(raw) || raw.length === 0)
+        return 0;
+    let total = 0;
+    for (const seg of raw) {
+        if (!seg || typeof seg !== 'object' || Array.isArray(seg))
+            continue;
+        total += String(seg.content ?? '').length;
+    }
+    return total;
+}
+function effectiveCharLength(h) {
+    const type = String(h.type ?? 'text').toLowerCase();
+    if (type === 'forward_bundle') {
+        const count = h.forwardBundleCount ?? 0;
+        if (count > 0)
+            return count * 36;
+        return Math.min(160, Math.floor((h.content?.length ?? 0) / 24));
+    }
+    const displayLen = imDisplayCharLength(h.extra_data);
+    if (displayLen > 0)
+        return displayLen;
+    return h.content?.length ?? 0;
+}
+function estimateRowPxFromHint(h) {
+    const type = String(h.type ?? 'text').toLowerCase();
+    if (type === 'image' || type === 'video') {
+        return clampRowPx(228 + (h.hasReplyQuote ? 28 : 0));
+    }
+    if (type === 'sticker')
+        return clampRowPx(128);
+    if (type === 'file' || type === 'audio' || type === 'voice')
+        return clampRowPx(76);
+    if (type === 'system')
+        return clampRowPx(40);
+    if (type === 'transfer' || type === 'red_envelope')
+        return clampRowPx(96);
+    if (type === 'forward_bundle') {
+        const count = h.forwardBundleCount ?? 1;
+        return clampRowPx(64 + Math.min(5, count) * 38 + (h.hasReplyQuote ? 28 : 0));
+    }
+    const len = effectiveCharLength(h);
+    const lines = Math.max(1, Math.ceil(len / TEXT_CHARS_PER_LINE));
+    let px = ROW_BASE_PX + lines * ROW_LINE_HEIGHT_PX;
+    const inlineCount = h.inlineAttachmentCount ?? 0;
+    if (inlineCount > 0) {
+        px += 40 + inlineCount * 30;
+    }
+    if (h.hasReplyQuote)
+        px += 36;
+    if (h.hasLlmContextMeta)
+        px += 18;
+    return clampRowPx(px);
+}
+function imMessageToHeightHint(m) {
+    const ex = m.extra_data && typeof m.extra_data === 'object' && !Array.isArray(m.extra_data)
+        ? m.extra_data
+        : undefined;
+    let forwardBundleCount;
+    const bundle = ex?.forward_bundle;
+    if (bundle && typeof bundle === 'object' && !Array.isArray(bundle)) {
+        const items = bundle.items;
+        if (Array.isArray(items))
+            forwardBundleCount = items.length;
+    }
+    const attachments = ex?.attachments;
+    return {
+        type: m.type,
+        content: m.content,
+        extra_data: ex,
+        forwardBundleCount,
+        inlineAttachmentCount: Array.isArray(attachments) ? attachments.length : 0,
+        hasReplyQuote: Boolean(ex?.reply_to),
+        hasLlmContextMeta: Boolean(ex?.llm_context),
+    };
+}
+export function estimateImMessageRowPx(m) {
+    return estimateRowPxFromHint(imMessageToHeightHint(m));
+}
+export function estimateChatMessageRowPx(m) {
+    return estimateRowPxFromHint({
+        type: m.type,
+        content: m.content,
+        forwardBundleCount: m.forwardBundle?.length,
+        inlineAttachmentCount: m.inlineAttachmentCount ?? m.inlineAttachments?.length ?? 0,
+        hasReplyQuote: Boolean(m.replyToMessageId?.trim()),
+        hasLlmContextMeta: Boolean(m.llmContext),
+    });
+}
+function countRowsToFillViewport(viewportHeight, estimateRow, rows) {
+    if (viewportHeight <= 0 || rows.length === 0)
+        return 0;
+    const target = viewportHeight * CHAT_MESSAGE_VIEWPORT_FILL_RATIO;
+    let sum = 0;
+    let count = 0;
+    for (let i = rows.length - 1; i >= 0; i--) {
+        sum += estimateRow(rows[i]);
+        count++;
+        if (sum >= target)
+            break;
+    }
+    return count;
+}
+export function estimateInitialMessageLimit(viewport, imRows, chatMessages) {
+    const h = viewport?.clientHeight ?? 0;
+    if (imRows && imRows.length > 0 && h > 0) {
+        const count = countRowsToFillViewport(h, estimateImMessageRowPx, imRows);
+        if (count > 0)
+            return clampMessageLimit(count);
+    }
+    if (chatMessages && chatMessages.length > 0 && h > 0) {
+        const count = countRowsToFillViewport(h, estimateChatMessageRowPx, chatMessages);
+        if (count > 0)
+            return clampMessageLimit(count);
+    }
+    if (h <= 0)
+        return CHAT_MESSAGE_PAGE_DEFAULT;
+    return clampMessageLimit((h * CHAT_MESSAGE_VIEWPORT_FILL_RATIO) / CHAT_MESSAGE_FALLBACK_ROW_PX);
+}
+export function estimateFillOlderMessageLimit(viewport, chatMessages) {
+    const el = viewport;
+    if (!el || chatMessages.length === 0) {
+        return estimateInitialMessageLimit(viewport, undefined, chatMessages);
+    }
+    const gap = el.clientHeight - (el.scrollHeight ?? 0) + 8;
+    if (gap <= 0)
+        return CHAT_MESSAGE_PAGE_MIN;
+    const avg = chatMessages.reduce((sum, m) => sum + estimateChatMessageRowPx(m), 0) /
+        chatMessages.length;
+    const rowPx = Math.max(ROW_MIN_PX, avg);
+    return clampMessageLimit(Math.ceil(gap / rowPx) + 2);
+}
+export function resolveRecentMessageRefreshLimit(viewport, priorDisplayed) {
+    return Math.max(priorDisplayed.length, estimateInitialMessageLimit(viewport, undefined, priorDisplayed));
+}
+export function resolveInitialMessagesPageLimitFromLocal(viewport, localRows, baseLimit) {
+    const pageLimit = baseLimit ?? estimateInitialMessageLimit(viewport);
+    return Math.max(pageLimit, estimateInitialMessageLimit(viewport, localRows));
+}
+export function resolveLoadOlderMessagesLimit(viewport, priorDisplayed, opts) {
+    return opts?.fillGap
+        ? estimateFillOlderMessageLimit(viewport, priorDisplayed)
+        : estimateInitialMessageLimit(viewport, undefined, priorDisplayed);
+}
+export function isChatMessageViewportUnderfilled(viewport, gapPx = 4) {
+    if (!viewport)
+        return false;
+    return viewport.scrollHeight <= viewport.clientHeight + gapPx;
+}
+//# sourceMappingURL=imChatMessagePagination.js.map

package/dist/functions/im/imChatMessagePagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imChatMessagePagination.js","sourceRoot":"","sources":["../../../src/functions/im/imChatMessagePagination.ts"],"names":[],"mappings":"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"}

package/dist/functions/im/imChatMessageTime.d.ts

@@ -0,0 +1,2 @@
+export declare function formatChatMessageTime(iso?: string): string;
+export declare function laterChatActivityIso(clientSentAt: string | undefined, createdAt: string | undefined): string | undefined;

package/dist/functions/im/imChatMessageTime.js

@@ -0,0 +1,24 @@
+export function formatChatMessageTime(iso) {
+    if (!iso)
+        return '';
+    const d = new Date(iso);
+    if (Number.isNaN(d.getTime()))
+        return '';
+    const now = new Date();
+    const pad = (n) => String(n).padStart(2, '0');
+    const hm = `${pad(d.getHours())}:${pad(d.getMinutes())}`;
+    if (d.toDateString() === now.toDateString())
+        return hm;
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${hm}`;
+}
+export function laterChatActivityIso(clientSentAt, createdAt) {
+    const client = clientSentAt?.trim();
+    const created = createdAt?.trim();
+    const clientMs = client ? Date.parse(client) : NaN;
+    const createdMs = created ? Date.parse(created) : NaN;
+    if (Number.isFinite(clientMs) && Number.isFinite(createdMs)) {
+        return clientMs >= createdMs ? client : created;
+    }
+    return client || created;
+}
+//# sourceMappingURL=imChatMessageTime.js.map

package/dist/functions/im/imChatMessageTime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imChatMessageTime.js","sourceRoot":"","sources":["../../../src/functions/im/imChatMessageTime.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAChD,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAA;IACnB,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAA;IACvB,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,EAAE,CAAA;IACxC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;IACtB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACrD,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,CAAA;IACxD,IAAI,CAAC,CAAC,YAAY,EAAE,KAAK,GAAG,CAAC,YAAY,EAAE;QAAE,OAAO,EAAE,CAAA;IACtD,OAAO,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAA;AAChF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,YAAgC,EAChC,SAA6B;IAE7B,MAAM,MAAM,GAAG,YAAY,EAAE,IAAI,EAAE,CAAA;IACnC,MAAM,OAAO,GAAG,SAAS,EAAE,IAAI,EAAE,CAAA;IACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;IACrD,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5D,OAAO,QAAQ,IAAI,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAA;IACjD,CAAC;IACD,OAAO,MAAM,IAAI,OAAO,CAAA;AAC1B,CAAC"}

package/dist/functions/im/imChatViewContextMenu.d.ts

@@ -0,0 +1,12 @@
+import type { ChatConversation, ChatMessage } from '../../../types/im-chat';
+import type { ImUiContextMenuItemSpec } from './imChatContextMenuSpecs';
+export type ImMultiSelectBatchActionKey = 'forward-merge' | 'forward-separate' | 'delete-batch';
+export declare function buildImMultiSelectBatchActionSpecs(count: number, messages: readonly ChatMessage[]): ImUiContextMenuItemSpec[];
+export type ImMessageContextMenuOptions = {
+    showMultiSelect?: boolean;
+    showQuote?: boolean;
+    showForward?: boolean;
+};
+export declare const IM_CODE_WORKSPACE_MESSAGE_CONTEXT_MENU_OPTS: ImMessageContextMenuOptions;
+export declare function buildImMessageContextMenuSpecs(m: ChatMessage, uid: string | null, currentConversation: Pick<ChatConversation, 'adminIds'> | null, bubbleSelectionText?: string, menuOpts?: ImMessageContextMenuOptions): ImUiContextMenuItemSpec[];
+export declare function buildImConversationContextMenuSpecs(c: Pick<ChatConversation, 'memberCount' | 'pinned' | 'muted'>): ImUiContextMenuItemSpec[];

package/dist/functions/im/imChatViewContextMenu.js

@@ -0,0 +1,91 @@
+import { chatMessageAllowsImSocialActions } from './chatMessageSocialActions.js';
+import { chatMessageSupportsContextMenuCopy } from './imChatMessageContextMenuCopy.js';
+import { chatMessageSupportsDownload } from './imChatMessageMediaAsset.js';
+import { chatConversationIsMultiParty } from './imConversationParty.js';
+import { canForwardMessageBatch, chatMessageCanForward } from './imForwardSnapshot.js';
+export function buildImMultiSelectBatchActionSpecs(count, messages) {
+    const canForward = canForwardMessageBatch(messages);
+    const items = [];
+    if (canForward) {
+        items.push({ key: 'forward-merge', label: '合并转发', icon: 'zhuanfa' }, {
+            key: 'forward-separate',
+            label: '逐条转发',
+            icon: 'zhuanfa',
+            dividerAfter: true,
+        });
+    }
+    items.push({
+        key: 'delete-batch',
+        label: count > 0 ? `删除${count}条` : '删除',
+        icon: 'shanchu',
+        danger: true,
+    });
+    return items;
+}
+export const IM_CODE_WORKSPACE_MESSAGE_CONTEXT_MENU_OPTS = {
+    showMultiSelect: false,
+    showQuote: false,
+    showForward: false,
+};
+export function buildImMessageContextMenuSpecs(m, uid, currentConversation, bubbleSelectionText, menuOpts) {
+    const own = !!(uid && m.sender?.id === uid);
+    const adminIds = currentConversation?.adminIds ?? [];
+    const isConvAdmin = !!(uid && adminIds.includes(uid));
+    const canDeleteOthers = isConvAdmin && !!(m.sender?.id && m.sender.id !== uid);
+    const canDelete = own || canDeleteOthers;
+    const canCopy = chatMessageSupportsContextMenuCopy(m, bubbleSelectionText);
+    const canDownload = chatMessageSupportsDownload(m);
+    const canForward = chatMessageCanForward(m);
+    const canSocialAction = chatMessageAllowsImSocialActions(m);
+    const showMultiSelect = menuOpts?.showMultiSelect !== false;
+    const showQuote = menuOpts?.showQuote !== false;
+    const showForward = menuOpts?.showForward !== false;
+    const items = [];
+    if (canCopy) {
+        items.push({ key: 'copy', label: '复制', icon: 'fuzhi' });
+    }
+    if (showQuote && canSocialAction) {
+        items.push({ key: 'quote', label: '引用', icon: 'reply' });
+    }
+    if (showForward && canForward) {
+        items.push({ key: 'forward', label: '转发', icon: 'zhuanfa' });
+    }
+    if (canDownload) {
+        items.push({ key: 'download', label: '下载', icon: 'xiazai' });
+    }
+    if (showMultiSelect && canSocialAction) {
+        items.push({
+            key: 'multi-select',
+            label: '多选',
+            icon: 'xuanze',
+            dividerAfter: true,
+        });
+    }
+    if (canDelete) {
+        items.push({ key: 'delete', label: '删除', icon: 'shanchu', danger: true });
+    }
+    return items;
+}
+export function buildImConversationContextMenuSpecs(c) {
+    const isMultiParty = chatConversationIsMultiParty(c);
+    const pinned = c.pinned === true;
+    const muted = c.muted === true;
+    const tail = isMultiParty
+        ? [{ key: 'dismiss', label: '从列表移除', icon: 'shanchu' }]
+        : [{ key: 'remove', label: '从列表移除', icon: 'shanchu', danger: true }];
+    return [
+        {
+            key: pinned ? 'unpin' : 'pin',
+            label: pinned ? '取消置顶' : '置顶聊天',
+            icon: 'zhiding',
+        },
+        {
+            key: muted ? 'unmute' : 'mute',
+            label: muted ? '关闭免打扰' : '消息免打扰',
+            icon: 'miandarao',
+            dividerAfter: true,
+        },
+        ...tail,
+    ];
+}
+//# sourceMappingURL=imChatViewContextMenu.js.map

package/dist/functions/im/imChatViewContextMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imChatViewContextMenu.js","sourceRoot":"","sources":["../../../src/functions/im/imChatViewContextMenu.ts"],"names":[],"mappings":"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"}

package/dist/functions/im/imClientMessageId.d.ts

@@ -0,0 +1 @@
+export declare function newImClientMessageId(prefix?: string): string;

package/dist/functions/im/imClientMessageId.js

@@ -0,0 +1,4 @@
+export function newImClientMessageId(prefix = 'cm') {
+    return `${prefix}_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+}
+//# sourceMappingURL=imClientMessageId.js.map

package/dist/functions/im/imClientMessageId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imClientMessageId.js","sourceRoot":"","sources":["../../../src/functions/im/imClientMessageId.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,oBAAoB,CAAC,MAAM,GAAG,IAAI;IAChD,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAA;AAC7E,CAAC"}

package/dist/functions/im/imCodeProjectPath.d.ts

@@ -0,0 +1,6 @@
+import type { ImProject, ImProjectMachineBinding } from '../../../types/im-code-project';
+export declare function projectViewerBinding(p: ImProject | null): ImProjectMachineBinding | null;
+export declare function projectUsesDisk(p: ImProject | null): boolean;
+export declare function projectViewerLocalRootPath(p: ImProject | null): string | null;
+export declare function projectBindingsSummary(p: ImProject | null): string;
+export declare function projectOwnerHasBindings(p: ImProject | null, myUserId: string | null | undefined): boolean;

package/dist/functions/im/imCodeProjectPath.js

@@ -0,0 +1,29 @@
+export function projectViewerBinding(p) {
+    if (!p?.machineBindings?.length)
+        return null;
+    return p.machineBindings.find((b) => b.isViewerMachine) ?? null;
+}
+export function projectUsesDisk(p) {
+    return !!projectViewerBinding(p)?.localRootPath?.trim();
+}
+export function projectViewerLocalRootPath(p) {
+    return projectViewerBinding(p)?.localRootPath?.trim() ?? null;
+}
+export function projectBindingsSummary(p) {
+    const bindings = p?.machineBindings ?? [];
+    if (!bindings.length)
+        return '';
+    return bindings
+        .map((b) => {
+        const name = b.machineLabel?.trim() || b.machineId;
+        const status = b.online ? '在线' : '离线';
+        return `${name} (${status}): ${b.localRootPath}`;
+    })
+        .join('\n');
+}
+export function projectOwnerHasBindings(p, myUserId) {
+    return !!(p?.machineBindings?.length &&
+        myUserId &&
+        p.ownerId === myUserId);
+}
+//# sourceMappingURL=imCodeProjectPath.js.map

package/dist/functions/im/imCodeProjectPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imCodeProjectPath.js","sourceRoot":"","sources":["../../../src/functions/im/imCodeProjectPath.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,oBAAoB,CAClC,CAAmB;IAEnB,IAAI,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM;QAAE,OAAO,IAAI,CAAA;IAC5C,OAAO,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,IAAI,CAAA;AACjE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,CAAmB;IACjD,OAAO,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAA;AACzD,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,CAAmB;IAC5D,OAAO,oBAAoB,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,IAAI,CAAA;AAC/D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,CAAmB;IACxD,MAAM,QAAQ,GAAG,CAAC,EAAE,eAAe,IAAI,EAAE,CAAA;IACzC,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO,EAAE,CAAA;IAC/B,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,SAAS,CAAA;QAClD,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;QACrC,OAAO,GAAG,IAAI,KAAK,MAAM,MAAM,CAAC,CAAC,aAAa,EAAE,CAAA;IAClD,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAA;AACf,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,CAAmB,EACnB,QAAmC;IAEnC,OAAO,CAAC,CAAC,CACP,CAAC,EAAE,eAAe,EAAE,MAAM;QAC1B,QAAQ;QACR,CAAC,CAAC,OAAO,KAAK,QAAQ,CACvB,CAAA;AACH,CAAC"}

package/dist/functions/im/imComposerDraft.d.ts

@@ -0,0 +1,3 @@
+export declare function composerDraftPlainPreview(html: string): string;
+export declare function composerDraftHasContent(html: string | null | undefined): boolean;
+export declare function mergeComposerDraftMaps(fromDb: ReadonlyMap<string, string>, overlay?: ReadonlyMap<string, string>): Map<string, string>;

package/dist/functions/im/imComposerDraft.js

@@ -0,0 +1,30 @@
+import { materializeImRichHtmlToPlainText } from './imRichContentHtml.js';
+export function composerDraftPlainPreview(html) {
+    return materializeImRichHtmlToPlainText(html, {
+        formatImage: () => '[图片]',
+        formatFile: () => '[文件]',
+    })
+        .replace(/\r\n|\n|\r/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+export function composerDraftHasContent(html) {
+    const raw = html?.trim() ?? '';
+    if (!raw)
+        return false;
+    return composerDraftPlainPreview(raw).length > 0;
+}
+export function mergeComposerDraftMaps(fromDb, overlay) {
+    const merged = new Map(fromDb);
+    if (!overlay)
+        return merged;
+    for (const [id, html] of overlay) {
+        const trimmed = html.trim();
+        if (trimmed)
+            merged.set(id, trimmed);
+        else
+            merged.delete(id);
+    }
+    return merged;
+}
+//# sourceMappingURL=imComposerDraft.js.map

package/dist/functions/im/imComposerDraft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imComposerDraft.js","sourceRoot":"","sources":["../../../src/functions/im/imComposerDraft.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAA;AAEtE,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,OAAO,gCAAgC,CAAC,IAAI,EAAE;QAC5C,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM;QACzB,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM;KACzB,CAAC;SACC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAA;AACX,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAA+B;IACrE,MAAM,GAAG,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IAC9B,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAA;IACtB,OAAO,yBAAyB,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;AAClD,CAAC;AAGD,MAAM,UAAU,sBAAsB,CACpC,MAAmC,EACnC,OAAqC;IAErC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAA;IAC9B,IAAI,CAAC,OAAO;QAAE,OAAO,MAAM,CAAA;IAC3B,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QAC3B,IAAI,OAAO;YAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;;YAC/B,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IACxB,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/functions/im/imComposerOutboundExtra.d.ts

@@ -0,0 +1,17 @@
+export declare function asImMessageExtraRecord(value: unknown): Record<string, unknown>;
+export declare function mergeImOutboundExtra(partialExtra?: Record<string, unknown>, replyExtra?: Record<string, unknown>): Record<string, unknown> | undefined;
+export declare function mergeInlineAttachmentPatchExtra(prevEx: Record<string, unknown>, payload: {
+    attachments: unknown;
+    uploading: boolean;
+    uploadedCount: number;
+    totalCount: number;
+}): Record<string, unknown>;
+export declare function stripInlineUploadProgressExtra(ex: Record<string, unknown>): Record<string, unknown>;
+export declare function buildStickerOutboundExtra(payload: {
+    packId: string;
+    stickerId: string;
+    url: string;
+    name?: string;
+    width?: number;
+    height?: number;
+}): Record<string, unknown>;