@nlabs/reaktor 1.8.0 → 1.9.0

package/lib/durableChat/conversations.d.ts

@@ -0,0 +1,62 @@
+import type { ApiContext } from '../types/auth.types.js';
+import type { ChatIdentity, ChatQuery } from './membership.js';
+import type { AcceptInviteInput, ChangeMemberRoleInput, ConversationInvite, ConversationMembership, ConversationSummary, CreateDirectInput, CreateGroupInput, InviteMemberInput, LeaveConversationInput, RemoveMemberInput, TransferOwnershipInput } from './types.js';
+export interface ConversationRecord {
+    readonly _key: string;
+    readonly activeMemberCount: number;
+    readonly chatSchemaVersion: number;
+    readonly kind: 'direct' | 'group';
+    readonly lastSequence: number;
+    readonly membershipRevision: number;
+    readonly name?: string;
+    readonly nameContentVersion?: string;
+    readonly nameDecision?: unknown;
+    readonly state: 'active' | 'closed' | 'forming';
+}
+export interface ChatListInput {
+    readonly after?: string;
+    readonly limit?: number;
+}
+export interface DurableConversationOptions {
+    readonly audience?: 'mobile' | 'web';
+    /** All policy reads must use this query; exceptions fail the transaction. */
+    readonly authorizeIdentity: (read: ChatQuery, identity: ChatIdentity) => Promise<void>;
+    readonly classifyName: (name: string, contentVersion: string) => unknown;
+    readonly projectName: (conversation: ConversationRecord, audience: 'mobile' | 'web') => string | undefined;
+    readonly readCollections?: readonly string[];
+    /** Caller owns transaction/locks/commit when supplied; no independent database access occurs. */
+    readonly query?: ChatQuery;
+}
+export declare const createDurableConversationRepository: (context: ApiContext, identity: ChatIdentity, options: DurableConversationOptions) => {
+    acceptInvite: (input: AcceptInviteInput) => Promise<ConversationSummary>;
+    changeMemberRole: (input: ChangeMemberRoleInput) => Promise<ConversationSummary>;
+    createGroup: (input: CreateGroupInput) => Promise<ConversationSummary>;
+    declineInvite: (input: AcceptInviteInput) => Promise<ConversationInvite>;
+    getOrCreateDirect: (input: CreateDirectInput) => Promise<ConversationSummary>;
+    getParticipants: (input: {
+        readonly conversationId: string;
+    }) => Promise<readonly ConversationMembership[]>;
+    inviteMember: (input: InviteMemberInput) => Promise<ConversationInvite>;
+    leaveConversation: (input: LeaveConversationInput) => Promise<ConversationSummary>;
+    listConversations: (input: ChatListInput) => Promise<readonly ConversationSummary[]>;
+    listInvites: (input: ChatListInput) => Promise<readonly ConversationInvite[]>;
+    removeMember: (input: RemoveMemberInput) => Promise<ConversationSummary>;
+    transferOwnership: (input: TransferOwnershipInput) => Promise<ConversationSummary>;
+};
+export type ChatRepository = ReturnType<typeof createDurableConversationRepository>;
+export declare const createDurableConversationActions: (identity: ChatIdentity, repository: ChatRepository) => {
+    acceptInvite: (input: AcceptInviteInput) => Promise<ConversationSummary>;
+    changeMemberRole: (input: ChangeMemberRoleInput) => Promise<ConversationSummary>;
+    createGroup: (input: CreateGroupInput) => Promise<ConversationSummary>;
+    declineInvite: (input: AcceptInviteInput) => Promise<ConversationInvite>;
+    getOrCreateDirect: (input: CreateDirectInput) => Promise<ConversationSummary>;
+    getParticipants: (input: {
+        readonly conversationId: string;
+    }) => Promise<readonly ConversationMembership[]>;
+    inviteMember: (input: InviteMemberInput) => Promise<ConversationInvite>;
+    leaveConversation: (input: LeaveConversationInput) => Promise<ConversationSummary>;
+    listConversations: (input?: ChatListInput) => Promise<readonly ConversationSummary[]>;
+    listInvites: (input?: ChatListInput) => Promise<readonly ConversationInvite[]>;
+    removeMember: (input: RemoveMemberInput) => Promise<ConversationSummary>;
+    transferOwnership: (input: TransferOwnershipInput) => Promise<ConversationSummary>;
+};