libre-webui 0.25.0 → 0.26.0

package/backend/dist/services/channelService.d.ts

@@ -0,0 +1,195 @@
+import { type ChannelTimelineCursor, type StoredChannelAttachmentRecord, type StoredChannelMemberRecord, type StoredChannelMessageRecord, type StoredChannelRecord } from '../persistence/resourceTypes.js';
+import type { BlobReadResult } from '../platform/storage/index.js';
+import type { Channel, ChannelMemberView, ChannelMessageView, ChannelSummary } from '../types/index.js';
+export declare class ChannelError extends Error {
+    readonly statusCode: number;
+    constructor(message: string, statusCode: number);
+}
+export declare const CHANNEL_ATTACHMENT_BLOB_PURPOSE = "channel-attachment";
+/** Deterministic identity for a DM pair, order-independent. */
+export declare const dmKeyFor: (left: string, right: string) => string;
+export declare class ChannelService {
+    /** Membership gate used by every channel read and write. */
+    requireMember(channelId: string, userId: string): Promise<{
+        channel: StoredChannelRecord;
+        member: StoredChannelMemberRecord;
+    }>;
+    createChannel(actor: {
+        userId: string;
+    }, input: {
+        type: string;
+        name: string;
+        description?: string;
+        memberIds?: readonly string[];
+    }): Promise<Channel>;
+    /** Opens (or returns) the deterministic DM channel between two users. */
+    openDm(actor: {
+        userId: string;
+    }, peerUserId: string): Promise<Channel>;
+    /** The actor's channels with unread counts, newest activity first. */
+    listMine(actor: {
+        userId: string;
+    }): Promise<ChannelSummary[]>;
+    /** Browseable public channels with membership state. */
+    listPublic(actor: {
+        userId: string;
+    }): Promise<ChannelSummary[]>;
+    getChannel(actor: {
+        userId: string;
+    }, channelId: string): Promise<ChannelSummary>;
+    updateChannel(actor: {
+        userId: string;
+    }, channelId: string, updates: {
+        name?: string;
+        description?: string;
+        archived?: boolean;
+    }): Promise<Channel>;
+    deleteChannel(actor: {
+        userId: string;
+    }, channelId: string): Promise<void>;
+    addMember(actor: {
+        userId: string;
+    }, channelId: string, userId: string): Promise<ChannelMemberView>;
+    /** Join a public channel. */
+    join(actor: {
+        userId: string;
+    }, channelId: string): Promise<void>;
+    removeMember(actor: {
+        userId: string;
+    }, channelId: string, userId: string): Promise<void>;
+    listMembers(actor: {
+        userId: string;
+    }, channelId: string): Promise<ChannelMemberView[]>;
+    /**
+     * Idempotent post: the client supplies the message id, so a retried
+     * request lands on the same timeline entry and fans out exactly once.
+     */
+    postMessage(actor: {
+        userId: string;
+    }, channelId: string, input: {
+        id?: string;
+        content: string;
+        parentId?: string;
+        authorKind?: 'user' | 'model';
+        model?: string;
+        metadata?: {
+            pending?: boolean;
+            error?: string;
+        };
+        attachments?: readonly StoredChannelAttachmentRecord[];
+    }): Promise<{
+        message: ChannelMessageView;
+        created: boolean;
+    }>;
+    editMessage(actor: {
+        userId: string;
+    }, messageId: string, content: string): Promise<ChannelMessageView>;
+    /**
+     * Tombstone deletion: the row survives with cleared content so replies
+     * and the ordered timeline stay intact. Attachments are removed.
+     */
+    deleteMessage(actor: {
+        userId: string;
+    }, messageId: string): Promise<void>;
+    setPinned(actor: {
+        userId: string;
+    }, messageId: string, pinned: boolean): Promise<ChannelMessageView>;
+    listPinned(actor: {
+        userId: string;
+    }, channelId: string): Promise<ChannelMessageView[]>;
+    react(actor: {
+        userId: string;
+    }, messageId: string, emoji: string, add: boolean): Promise<void>;
+    /** Root timeline page (newest-first before / oldest-first after). */
+    listTimeline(actor: {
+        userId: string;
+    }, channelId: string, options: {
+        before?: ChannelTimelineCursor;
+        after?: ChannelTimelineCursor;
+        limit?: number;
+    }): Promise<ChannelMessageView[]>;
+    listThread(actor: {
+        userId: string;
+    }, parentId: string): Promise<ChannelMessageView[]>;
+    /** Advance the read cursor; it never moves backwards. */
+    markRead(actor: {
+        userId: string;
+    }, channelId: string, lastReadAt?: number): Promise<void>;
+    findMessage(messageId: string): Promise<StoredChannelMessageRecord | null>;
+    /**
+     * Stores an uploaded file as a blob owned by the uploader and parks its
+     * descriptor in the coordination cache until a message claims it. The
+     * cache is shared across replicas, so upload and post may hit different
+     * nodes.
+     */
+    uploadAttachment(actor: {
+        userId: string;
+    }, channelId: string, file: {
+        buffer: Buffer;
+        filename: string;
+        contentType: string;
+    }): Promise<{
+        id: string;
+        filename: string;
+        contentType: string;
+        size: number;
+    }>;
+    private claimAttachments;
+    /**
+     * The user-facing post: claims uploaded attachments and, when the
+     * composer named a model, appends a pending model reply and enqueues the
+     * durable mention job under the invoking user's identity.
+     */
+    postUserMessage(actor: {
+        userId: string;
+    }, channelId: string, input: {
+        id?: string;
+        content: string;
+        parentId?: string;
+        attachmentIds?: readonly string[];
+        mentionModel?: string;
+        mentionProviderType?: string;
+        mentionProviderId?: string;
+    }): Promise<{
+        message: ChannelMessageView;
+        created: boolean;
+    }>;
+    /**
+     * In-app notifications for a new message: the DM peer, `@username`
+     * mentions of channel members, and the thread-root author.
+     */
+    private notifyForMessage;
+    /** Reply completion used by the durable mention job. */
+    completeModelReply(replyMessageId: string, content: string): Promise<void>;
+    failModelReply(replyMessageId: string, errorSummary: string): Promise<void>;
+    /**
+     * Recent decrypted conversation context for a model mention, oldest
+     * first, ending at the prompting message.
+     */
+    mentionContext(channelId: string, promptMessageId: string): Promise<Array<{
+        author: string;
+        content: string;
+    }>>;
+    openAttachment(actor: {
+        userId: string;
+    }, attachmentId: string): Promise<{
+        attachment: {
+            id: string;
+            filename: string;
+            contentType: string;
+            size: number;
+        };
+        body: BlobReadResult;
+    }>;
+    /** Recent decrypted candidates from the actor's channels, for search. */
+    searchCandidates(actor: {
+        userId: string;
+    }, maximum: number): Promise<Array<{
+        channelId: string;
+        messageId: string;
+        content: string;
+        createdAt: number;
+    }>>;
+}
+export declare const channelService: ChannelService;
+//# sourceMappingURL=channelService.d.ts.map

package/backend/dist/services/channelService.d.ts.map

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