@23blocks/block-conversations 3.3.5 → 3.4.0

package/dist/index.esm.js

@@ -1324,7 +1324,15 @@ function createWebNotificationsService(transport, _config) {
     };
 }
 
-function createConversationsBlock(transport, config) {
+/**
+ * Create the Conversations block.
+ *
+ * @example
+ * ```typescript
+ * const block = createConversationsBlock(transport, { appId: 'xxx' });
+ * const messages = await block.messages.list({ page: 1 });
+ * ```
+ */ function createConversationsBlock(transport, config) {
     return {
         messages: createMessagesService(transport),
         draftMessages: createDraftMessagesService(transport),

package/dist/src/lib/conversations.block.d.ts

@@ -1,26 +1,58 @@
 import type { Transport, BlockConfig, BlockMetadata } from '@23blocks/contracts';
 import { type MessagesService, type DraftMessagesService, type GroupsService, type GroupInvitesService, type NotificationsService, type ConversationsService, type WebSocketTokensService, type ContextsService, type NotificationSettingsService, type AvailabilitiesService, type MessageFilesService, type SourcesService, type UsersService, type MeetingsService, type WebNotificationsService } from './services/index.js';
+/**
+ * Configuration for the Conversations block.
+ */
 export interface ConversationsBlockConfig extends BlockConfig {
+    /** Application ID */
     appId: string;
+    /** Tenant ID (optional, for multi-tenant setups) */
     tenantId?: string;
 }
+/**
+ * Messaging and conversations block interface.
+ */
 export interface ConversationsBlock {
+    /** Message CRUD operations */
     messages: MessagesService;
+    /** Draft message management */
     draftMessages: DraftMessagesService;
+    /** Group chat management */
     groups: GroupsService;
+    /** Group invitation management */
     groupInvites: GroupInvitesService;
+    /** In-app notification management */
     notifications: NotificationsService;
+    /** Conversation thread management */
     conversations: ConversationsService;
+    /** WebSocket token generation */
     websocketTokens: WebSocketTokensService;
+    /** Conversation context management */
     contexts: ContextsService;
+    /** Notification preference management */
     notificationSettings: NotificationSettingsService;
+    /** User availability status management */
     availabilities: AvailabilitiesService;
+    /** Message file attachment management */
     messageFiles: MessageFilesService;
+    /** Message source management */
     sources: SourcesService;
+    /** Conversation user management */
     users: UsersService;
+    /** Meeting management */
     meetings: MeetingsService;
+    /** Web push notification management */
     webNotifications: WebNotificationsService;
 }
+/**
+ * Create the Conversations block.
+ *
+ * @example
+ * ```typescript
+ * const block = createConversationsBlock(transport, { appId: 'xxx' });
+ * const messages = await block.messages.list({ page: 1 });
+ * ```
+ */
 export declare function createConversationsBlock(transport: Transport, config: ConversationsBlockConfig): ConversationsBlock;
 export declare const conversationsBlockMetadata: BlockMetadata;
 //# sourceMappingURL=conversations.block.d.ts.map

package/dist/src/lib/conversations.block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversations.block.d.ts","sourceRoot":"","sources":["../../../src/lib/conversations.block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAgBL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC7B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,wBAAyB,SAAQ,WAAW;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,eAAe,CAAC;IAC1B,aAAa,EAAE,oBAAoB,CAAC;IACpC,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,mBAAmB,CAAC;IAClC,aAAa,EAAE,oBAAoB,CAAC;IACpC,aAAa,EAAE,oBAAoB,CAAC;IACpC,eAAe,EAAE,sBAAsB,CAAC;IACxC,QAAQ,EAAE,eAAe,CAAC;IAC1B,oBAAoB,EAAE,2BAA2B,CAAC;IAClD,cAAc,EAAE,qBAAqB,CAAC;IACtC,YAAY,EAAE,mBAAmB,CAAC;IAClC,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,eAAe,CAAC;IAC1B,gBAAgB,EAAE,uBAAuB,CAAC;CAC3C;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,wBAAwB,GAC/B,kBAAkB,CAkBpB;AAED,eAAO,MAAM,0BAA0B,EAAE,aAkBxC,CAAC"}
+{"version":3,"file":"conversations.block.d.ts","sourceRoot":"","sources":["../../../src/lib/conversations.block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAgBL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC7B,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,WAAW;IAC3D,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,QAAQ,EAAE,eAAe,CAAC;IAC1B,+BAA+B;IAC/B,aAAa,EAAE,oBAAoB,CAAC;IACpC,4BAA4B;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,kCAAkC;IAClC,YAAY,EAAE,mBAAmB,CAAC;IAClC,qCAAqC;IACrC,aAAa,EAAE,oBAAoB,CAAC;IACpC,qCAAqC;IACrC,aAAa,EAAE,oBAAoB,CAAC;IACpC,iCAAiC;IACjC,eAAe,EAAE,sBAAsB,CAAC;IACxC,sCAAsC;IACtC,QAAQ,EAAE,eAAe,CAAC;IAC1B,yCAAyC;IACzC,oBAAoB,EAAE,2BAA2B,CAAC;IAClD,0CAA0C;IAC1C,cAAc,EAAE,qBAAqB,CAAC;IACtC,yCAAyC;IACzC,YAAY,EAAE,mBAAmB,CAAC;IAClC,gCAAgC;IAChC,OAAO,EAAE,cAAc,CAAC;IACxB,mCAAmC;IACnC,KAAK,EAAE,YAAY,CAAC;IACpB,yBAAyB;IACzB,QAAQ,EAAE,eAAe,CAAC;IAC1B,uCAAuC;IACvC,gBAAgB,EAAE,uBAAuB,CAAC;CAC3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,wBAAwB,GAC/B,kBAAkB,CAkBpB;AAED,eAAO,MAAM,0BAA0B,EAAE,aAkBxC,CAAC"}

package/dist/src/lib/services/availabilities.service.d.ts

@@ -1,8 +1,23 @@
 import type { Transport } from '@23blocks/contracts';
 import type { UserAvailability, SetAvailabilityRequest } from '../types/availability.js';
 export interface AvailabilitiesService {
+    /**
+     * Get the availability status of a user
+     * @param userUniqueId - Unique ID of the user to check
+     * @returns UserAvailability with status, last seen timestamp, and optional custom status
+     */
     get(userUniqueId: string): Promise<UserAvailability>;
+    /**
+     * Set the current user's status to online
+     * @param data - Optional availability settings including custom status and payload
+     * @returns Updated UserAvailability reflecting the online state
+     * @note Defaults to status "online" if no specific status is provided in the request
+     */
     goOnline(data?: SetAvailabilityRequest): Promise<UserAvailability>;
+    /**
+     * Set the current user's status to offline
+     * @returns void on successful status change
+     */
     goOffline(): Promise<void>;
 }
 export declare function createAvailabilitiesService(transport: Transport, _config: {

package/dist/src/lib/services/availabilities.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"availabilities.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/availabilities.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnE,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,qBAAqB,CAuCnH"}
+{"version":3,"file":"availabilities.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/availabilities.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAErD;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEnE;;;OAGG;IACH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,qBAAqB,CAuCnH"}

package/dist/src/lib/services/contexts.service.d.ts

@@ -2,10 +2,36 @@ import type { Transport, PageResult } from '@23blocks/contracts';
 import type { Context, CreateContextRequest, UpdateContextRequest, ListContextsParams } from '../types/context.js';
 import type { Group } from '../types/group.js';
 export interface ContextsService {
+    /**
+     * List all contexts
+     * @param params - Optional filtering, sorting, and pagination parameters
+     * @returns Paginated list of Context records with pagination metadata
+     */
     list(params?: ListContextsParams): Promise<PageResult<Context>>;
+    /**
+     * Get a context by unique ID
+     * @param uniqueId - Unique ID of the context to retrieve
+     * @returns The matching Context record
+     */
     get(uniqueId: string): Promise<Context>;
+    /**
+     * Create a new context
+     * @param data - Context creation payload including name, type, and metadata
+     * @returns The newly created Context record
+     */
     create(data: CreateContextRequest): Promise<Context>;
+    /**
+     * Update a context
+     * @param uniqueId - Unique ID of the context to update
+     * @param data - Fields to update on the context
+     * @returns The updated Context record
+     */
     update(uniqueId: string, data: UpdateContextRequest): Promise<Context>;
+    /**
+     * List groups belonging to a context
+     * @param contextUniqueId - Unique ID of the context
+     * @returns Paginated list of Group records within the context
+     */
     listGroups(contextUniqueId: string): Promise<PageResult<Group>>;
 }
 export declare function createContextsService(transport: Transport, _config: {

package/dist/src/lib/services/contexts.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contexts.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/contexts.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,OAAO,EACP,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAI/C,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvE,UAAU,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;CACjE;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAoDvG"}
+{"version":3,"file":"contexts.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/contexts.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,OAAO,EACP,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAI/C,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAEhE;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAExC;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErD;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvE;;;;OAIG;IACH,UAAU,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;CACjE;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAoDvG"}

package/dist/src/lib/services/conversations.service.d.ts

@@ -1,8 +1,22 @@
 import type { Transport } from '@23blocks/contracts';
 import type { Conversation, GetConversationParams } from '../types/conversation.js';
 export interface ConversationsService {
+    /**
+     * Get a conversation by context identifier
+     * @param params - Parameters including context ID, pagination, and optional file inclusion
+     * @returns Conversation object containing messages, files, and metadata
+     */
     get(params: GetConversationParams): Promise<Conversation>;
+    /**
+     * List all available conversation context identifiers
+     * @returns Array of context identifier strings
+     */
     listContexts(): Promise<string[]>;
+    /**
+     * Delete a conversation context and its associated messages
+     * @param context - Context identifier of the conversation to delete
+     * @returns void on successful deletion
+     */
     deleteContext(context: string): Promise<void>;
 }
 export declare function createConversationsService(transport: Transport, _config: {

package/dist/src/lib/services/conversations.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversations.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/conversations.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EACV,YAAY,EACZ,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1D,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAClC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,oBAAoB,CAoCjH"}
+{"version":3,"file":"conversations.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/conversations.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EACV,YAAY,EACZ,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE1D;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAElC;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,oBAAoB,CAoCjH"}

package/dist/src/lib/services/draft-messages.service.d.ts

@@ -1,12 +1,49 @@
 import type { Transport, PageResult } from '@23blocks/contracts';
 import type { DraftMessage, CreateDraftMessageRequest, UpdateDraftMessageRequest, ListDraftMessagesParams } from '../types/draft-message.js';
 export interface DraftMessagesService {
+    /**
+     * List all draft messages
+     * @param params - Optional filtering, sorting, and pagination parameters
+     * @returns Paginated list of DraftMessage records with pagination metadata
+     */
     list(params?: ListDraftMessagesParams): Promise<PageResult<DraftMessage>>;
+    /**
+     * Get a draft message by unique ID
+     * @param uniqueId - Unique ID of the draft message to retrieve
+     * @returns The matching DraftMessage record
+     */
     get(uniqueId: string): Promise<DraftMessage>;
+    /**
+     * Create a new draft message
+     * @param data - Draft message creation payload including content, source, target, and routing fields
+     * @returns The newly created DraftMessage record
+     */
     create(data: CreateDraftMessageRequest): Promise<DraftMessage>;
+    /**
+     * Update a draft message
+     * @param uniqueId - Unique ID of the draft message to update
+     * @param data - Fields to update (content, status, enabled, payload)
+     * @returns The updated DraftMessage record
+     */
     update(uniqueId: string, data: UpdateDraftMessageRequest): Promise<DraftMessage>;
+    /**
+     * Delete a draft message
+     * @param uniqueId - Unique ID of the draft message to delete
+     * @returns void on successful deletion
+     */
     delete(uniqueId: string): Promise<void>;
+    /**
+     * List draft messages filtered by context
+     * @param contextId - Context identifier to filter by
+     * @param params - Optional sorting and pagination parameters
+     * @returns Paginated list of DraftMessage records for the given context
+     */
     listByContext(contextId: string, params?: ListDraftMessagesParams): Promise<PageResult<DraftMessage>>;
+    /**
+     * Publish a draft message, converting it into a sent message
+     * @param uniqueId - Unique ID of the draft message to publish
+     * @returns The published DraftMessage record with updated status
+     */
     publish(uniqueId: string): Promise<DraftMessage>;
 }
 export declare function createDraftMessagesService(transport: Transport, _config: {

package/dist/src/lib/services/draft-messages.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"draft-messages.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/draft-messages.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,YAAY,EACZ,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,2BAA2B,CAAC;AAGnC,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IAC1E,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/D,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACjF,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IACtG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAClD;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,oBAAoB,CAuFjH"}
+{"version":3,"file":"draft-messages.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/draft-messages.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,YAAY,EACZ,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,2BAA2B,CAAC;AAGnC,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IAE1E;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE7C;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE/D;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEjF;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;;OAKG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IAEtG;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAClD;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,oBAAoB,CAuFjH"}

package/dist/src/lib/services/group-invites.service.d.ts

@@ -7,22 +7,37 @@ import type { Group } from '../types/group.js';
 export interface GroupInvitesService {
     /**
      * List all invites for a group
+     * @param groupUniqueId - Unique ID of the group
+     * @param params - Optional filtering and pagination parameters
+     * @returns Paginated list of GroupInvite records with pagination metadata
      */
     list(groupUniqueId: string, params?: ListGroupInvitesParams): Promise<PageResult<GroupInvite>>;
     /**
      * Create a new invite for a group
+     * @param groupUniqueId - Unique ID of the group to create an invite for
+     * @param data - Optional invite configuration including max uses and expiration
+     * @returns The newly created GroupInvite record containing the invite code
      */
     create(groupUniqueId: string, data?: CreateGroupInviteRequest): Promise<GroupInvite>;
     /**
      * Revoke an invite
+     * @param groupUniqueId - Unique ID of the group the invite belongs to
+     * @param code - Invite code to revoke
+     * @returns void on successful revocation
      */
     revoke(groupUniqueId: string, code: string): Promise<void>;
     /**
      * Get QR code for an invite
+     * @param groupUniqueId - Unique ID of the group the invite belongs to
+     * @param code - Invite code to generate a QR code for
+     * @returns QRCodeResponse containing the QR code data and invite URL
      */
     getQRCode(groupUniqueId: string, code: string): Promise<QRCodeResponse>;
     /**
      * Join a group using an invite code
+     * @param code - Invite code to use for joining
+     * @param data - Optional request body with the joining user's unique ID
+     * @returns The Group record that was joined
      */
     join(code: string, data?: JoinGroupRequest): Promise<Group>;
 }

package/dist/src/lib/services/group-invites.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"group-invites.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/group-invites.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,WAAW,EACX,wBAAwB,EACxB,gBAAgB,EAChB,cAAc,EACd,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAI/C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IAE/F;;OAEG;IACH,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAErF;;OAEG;IACH,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D;;OAEG;IACH,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAExE;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CAC7D;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,mBAAmB,CA8C/G"}
+{"version":3,"file":"group-invites.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/group-invites.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,WAAW,EACX,wBAAwB,EACxB,gBAAgB,EAChB,cAAc,EACd,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAI/C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IAE/F;;;;;OAKG;IACH,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAErF;;;;;OAKG;IACH,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D;;;;;OAKG;IACH,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAExE;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CAC7D;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,mBAAmB,CA8C/G"}

package/dist/src/lib/services/groups.service.d.ts

@@ -1,15 +1,69 @@
 import type { Transport, PageResult } from '@23blocks/contracts';
 import type { Group, CreateGroupRequest, UpdateGroupRequest, ListGroupsParams } from '../types/group.js';
 export interface GroupsService {
+    /**
+     * List all groups
+     * @param params - Optional filtering, sorting, and pagination parameters
+     * @returns Paginated list of Group records with pagination metadata
+     */
     list(params?: ListGroupsParams): Promise<PageResult<Group>>;
+    /**
+     * Get a group by unique ID
+     * @param uniqueId - Unique ID of the group to retrieve
+     * @returns The matching Group record
+     */
     get(uniqueId: string): Promise<Group>;
+    /**
+     * Create a new group
+     * @param data - Group creation payload including name, type, and initial members
+     * @returns The newly created Group record
+     */
     create(data: CreateGroupRequest): Promise<Group>;
+    /**
+     * Update a group
+     * @param uniqueId - Unique ID of the group to update
+     * @param data - Fields to update on the group
+     * @returns The updated Group record
+     */
     update(uniqueId: string, data: UpdateGroupRequest): Promise<Group>;
+    /**
+     * Delete a group (soft delete)
+     * @param uniqueId - Unique ID of the group to delete
+     * @returns void on successful deletion
+     */
     delete(uniqueId: string): Promise<void>;
+    /**
+     * Recover a previously deleted group
+     * @param uniqueId - Unique ID of the deleted group to recover
+     * @returns The recovered Group record
+     */
     recover(uniqueId: string): Promise<Group>;
+    /**
+     * Search groups by query string
+     * @param query - Search query text
+     * @param params - Optional pagination parameters
+     * @returns Paginated list of matching Group records with pagination metadata
+     */
     search(query: string, params?: ListGroupsParams): Promise<PageResult<Group>>;
+    /**
+     * List soft-deleted groups
+     * @param params - Optional pagination parameters
+     * @returns Paginated list of deleted Group records with pagination metadata
+     */
     listDeleted(params?: ListGroupsParams): Promise<PageResult<Group>>;
+    /**
+     * Add a member to a group
+     * @param uniqueId - Unique ID of the group
+     * @param memberId - ID of the member to add
+     * @returns The updated Group record
+     */
     addMember(uniqueId: string, memberId: string): Promise<Group>;
+    /**
+     * Remove a member from a group
+     * @param uniqueId - Unique ID of the group
+     * @param memberId - ID of the member to remove
+     * @returns The updated Group record
+     */
     removeMember(uniqueId: string, memberId: string): Promise<Group>;
 }
 export declare function createGroupsService(transport: Transport, _config: {

package/dist/src/lib/services/groups.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"groups.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/groups.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,KAAK,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5D,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACnE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7E,WAAW,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IACnE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9D,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CAClE;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAiGnG"}
+{"version":3,"file":"groups.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/groups.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,KAAK,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAE5D;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAEtC;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAEjD;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAEnE;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAE1C;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAE7E;;;;OAIG;IACH,WAAW,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAEnE;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAE9D;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CAClE;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAiGnG"}

package/dist/src/lib/services/meetings.service.d.ts

@@ -1,21 +1,53 @@
 import type { Transport, PageResult } from '@23blocks/contracts';
 import type { Meeting, MeetingSession, CreateMeetingRequest, UpdateMeetingRequest, ListMeetingsParams } from '../types/meeting.js';
 export interface MeetingsService {
+    /**
+     * List all meetings
+     * @param params - Optional filtering, sorting, and pagination parameters
+     * @returns Paginated list of Meeting records with pagination metadata
+     */
     list(params?: ListMeetingsParams): Promise<PageResult<Meeting>>;
+    /**
+     * Get a meeting by unique ID
+     * @param uniqueId - Unique ID of the meeting to retrieve
+     * @returns The matching Meeting record
+     */
     get(uniqueId: string): Promise<Meeting>;
+    /**
+     * Create a new meeting
+     * @param data - Meeting creation payload including title, schedule, and provider details
+     * @returns The newly created Meeting record
+     */
     create(data: CreateMeetingRequest): Promise<Meeting>;
+    /**
+     * Update a meeting
+     * @param uniqueId - Unique ID of the meeting to update
+     * @param data - Fields to update on the meeting
+     * @returns The updated Meeting record
+     */
     update(uniqueId: string, data: UpdateMeetingRequest): Promise<Meeting>;
+    /**
+     * Delete a meeting
+     * @param uniqueId - Unique ID of the meeting to delete
+     * @returns void on successful deletion
+     */
     delete(uniqueId: string): Promise<void>;
     /**
      * Create a session for joining a meeting
+     * @param uniqueId - Unique ID of the meeting to join
+     * @returns MeetingSession with session ID, token, join URL, and expiration
      */
     createSession(uniqueId: string): Promise<MeetingSession>;
     /**
      * Start a meeting
+     * @param uniqueId - Unique ID of the meeting to start
+     * @returns The updated Meeting record with active status
      */
     start(uniqueId: string): Promise<Meeting>;
     /**
      * End a meeting
+     * @param uniqueId - Unique ID of the meeting to end
+     * @returns The updated Meeting record with ended status
      */
     end(uniqueId: string): Promise<Meeting>;
 }

package/dist/src/lib/services/meetings.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meetings.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/meetings.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEzD;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE1C;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzC;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAkFvG"}
+{"version":3,"file":"meetings.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/meetings.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAEhE;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAExC;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErD;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvE;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;OAIG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEzD;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE1C;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzC;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAkFvG"}

package/dist/src/lib/services/message-files.service.d.ts

@@ -1,9 +1,34 @@
 import type { Transport } from '@23blocks/contracts';
 import type { MessageFile, CreateMessageFileRequest, PresignMessageFileRequest, PresignMessageFileResponse } from '../types/message-file.js';
 export interface MessageFilesService {
+    /**
+     * Get a message file by unique ID
+     * @param conversationUniqueId - Unique ID of the conversation the file belongs to
+     * @param fileUniqueId - Unique ID of the file to retrieve
+     * @returns The matching MessageFile record
+     */
     get(conversationUniqueId: string, fileUniqueId: string): Promise<MessageFile>;
+    /**
+     * Create a new message file record
+     * @param conversationUniqueId - Unique ID of the conversation to attach the file to
+     * @param data - File metadata including name, content type, size, and URL
+     * @returns The newly created MessageFile record
+     */
     create(conversationUniqueId: string, data: CreateMessageFileRequest): Promise<MessageFile>;
+    /**
+     * Delete a message file
+     * @param conversationUniqueId - Unique ID of the conversation the file belongs to
+     * @param fileUniqueId - Unique ID of the file to delete
+     * @returns void on successful deletion
+     */
     delete(conversationUniqueId: string, fileUniqueId: string): Promise<void>;
+    /**
+     * Get a presigned URL for direct file upload
+     * @param conversationUniqueId - Unique ID of the conversation to upload the file to
+     * @param data - File details including filename, content type, and size
+     * @returns PresignMessageFileResponse with upload URL, final file URL, form fields, and expiration
+     * @note Use the returned uploadUrl and fields to perform a direct upload to storage
+     */
     presign(conversationUniqueId: string, data: PresignMessageFileRequest): Promise<PresignMessageFileResponse>;
 }
 export declare function createMessageFilesService(transport: Transport, _config: {

package/dist/src/lib/services/message-files.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-files.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/message-files.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EACV,WAAW,EACX,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,oBAAoB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9E,MAAM,CAAC,oBAAoB,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3F,MAAM,CAAC,oBAAoB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,OAAO,CAAC,oBAAoB,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CAC7G;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,mBAAmB,CA2C/G"}
+{"version":3,"file":"message-files.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/message-files.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EACV,WAAW,EACX,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,GAAG,CAAC,oBAAoB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE9E;;;;;OAKG;IACH,MAAM,CAAC,oBAAoB,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE3F;;;;;OAKG;IACH,MAAM,CAAC,oBAAoB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1E;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CAC7G;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,mBAAmB,CA2C/G"}

package/dist/src/lib/services/messages.service.d.ts

@@ -1,14 +1,62 @@
 import type { Transport, PageResult } from '@23blocks/contracts';
 import type { Message, CreateMessageRequest, UpdateMessageRequest, ListMessagesParams } from '../types/message.js';
 export interface MessagesService {
+    /**
+     * List all messages
+     * @param params - Optional filtering, sorting, and pagination parameters
+     * @returns Paginated list of Message records with pagination metadata
+     */
     list(params?: ListMessagesParams): Promise<PageResult<Message>>;
+    /**
+     * Get a message by unique ID
+     * @param uniqueId - Unique ID of the message to retrieve
+     * @returns The matching Message record
+     */
     get(uniqueId: string): Promise<Message>;
+    /**
+     * Create a new message
+     * @param data - Message creation payload including content, source, target, and routing fields
+     * @returns The newly created Message record
+     */
     create(data: CreateMessageRequest): Promise<Message>;
+    /**
+     * Update a message
+     * @param uniqueId - Unique ID of the message to update
+     * @param data - Fields to update (content, status, enabled, payload)
+     * @returns The updated Message record
+     */
     update(uniqueId: string, data: UpdateMessageRequest): Promise<Message>;
+    /**
+     * Delete a message (soft delete)
+     * @param uniqueId - Unique ID of the message to delete
+     * @returns void on successful deletion
+     */
     delete(uniqueId: string): Promise<void>;
+    /**
+     * Recover a previously deleted message
+     * @param uniqueId - Unique ID of the deleted message to recover
+     * @returns The recovered Message record
+     */
     recover(uniqueId: string): Promise<Message>;
+    /**
+     * List messages filtered by context
+     * @param contextId - Context identifier to filter by
+     * @param params - Optional sorting and pagination parameters
+     * @returns Paginated list of Message records for the given context
+     */
     listByContext(contextId: string, params?: ListMessagesParams): Promise<PageResult<Message>>;
+    /**
+     * List messages filtered by parent message
+     * @param parentId - Parent message ID to filter replies
+     * @param params - Optional sorting and pagination parameters
+     * @returns Paginated list of child Message records for the given parent
+     */
     listByParent(parentId: string, params?: ListMessagesParams): Promise<PageResult<Message>>;
+    /**
+     * List soft-deleted messages
+     * @param params - Optional pagination parameters
+     * @returns Paginated list of deleted Message records with pagination metadata
+     */
     listDeleted(params?: ListMessagesParams): Promise<PageResult<Message>>;
 }
 export declare function createMessagesService(transport: Transport, _config: {

package/dist/src/lib/services/messages.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/messages.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,OAAO,EACP,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5F,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1F,WAAW,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;CACxE;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CA6GvG"}
+{"version":3,"file":"messages.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/messages.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,OAAO,EACP,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAEhE;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAExC;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErD;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvE;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAE5F;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAE1F;;;;OAIG;IACH,WAAW,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;CACxE;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CA6GvG"}

package/dist/src/lib/services/notification-settings.service.d.ts

@@ -1,7 +1,18 @@
 import type { Transport } from '@23blocks/contracts';
 import type { NotificationSettings, UpdateNotificationSettingsRequest } from '../types/notification-settings.js';
 export interface NotificationSettingsService {
+    /**
+     * Get notification settings for a user
+     * @param userUniqueId - Unique ID of the user
+     * @returns NotificationSettings with channel toggles, quiet hours, timezone, and preferences
+     */
     get(userUniqueId: string): Promise<NotificationSettings>;
+    /**
+     * Update notification settings for a user
+     * @param userUniqueId - Unique ID of the user
+     * @param data - Settings fields to update (channel toggles, quiet hours, timezone, preferences)
+     * @returns The updated NotificationSettings record
+     */
     update(userUniqueId: string, data: UpdateNotificationSettingsRequest): Promise<NotificationSettings>;
 }
 export declare function createNotificationSettingsService(transport: Transport, _config: {

package/dist/src/lib/services/notification-settings.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notification-settings.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/notification-settings.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EACV,oBAAoB,EACpB,iCAAiC,EAClC,MAAM,mCAAmC,CAAC;AAE3C,MAAM,WAAW,2BAA2B;IAC1C,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACzD,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,iCAAiC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACtG;AAED,wBAAgB,iCAAiC,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,2BAA2B,CAmD/H"}
+{"version":3,"file":"notification-settings.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/notification-settings.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EACV,oBAAoB,EACpB,iCAAiC,EAClC,MAAM,mCAAmC,CAAC;AAE3C,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEzD;;;;;OAKG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,iCAAiC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACtG;AAED,wBAAgB,iCAAiC,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,2BAA2B,CAmD/H"}

package/dist/src/lib/services/notifications.service.d.ts

@@ -1,14 +1,62 @@
 import type { Transport, PageResult } from '@23blocks/contracts';
 import type { Notification, CreateNotificationRequest, UpdateNotificationRequest, ListNotificationsParams } from '../types/notification.js';
 export interface NotificationsService {
+    /**
+     * List all notifications
+     * @param params - Optional filtering, sorting, and pagination parameters
+     * @returns Paginated list of Notification records with pagination metadata
+     */
     list(params?: ListNotificationsParams): Promise<PageResult<Notification>>;
+    /**
+     * Get a notification by unique ID
+     * @param uniqueId - Unique ID of the notification to retrieve
+     * @returns The matching Notification record
+     */
     get(uniqueId: string): Promise<Notification>;
+    /**
+     * Create a new notification
+     * @param data - Notification creation payload including content, source, target, and delivery options
+     * @returns The newly created Notification record
+     */
     create(data: CreateNotificationRequest): Promise<Notification>;
+    /**
+     * Update a notification
+     * @param uniqueId - Unique ID of the notification to update
+     * @param data - Fields to update (content, url, status, payload)
+     * @returns The updated Notification record
+     */
     update(uniqueId: string, data: UpdateNotificationRequest): Promise<Notification>;
+    /**
+     * Delete a notification
+     * @param uniqueId - Unique ID of the notification to delete
+     * @returns void on successful deletion
+     */
     delete(uniqueId: string): Promise<void>;
+    /**
+     * Mark a notification as read
+     * @param uniqueId - Unique ID of the notification to mark as read
+     * @returns The updated Notification record with read status
+     */
     markAsRead(uniqueId: string): Promise<Notification>;
+    /**
+     * Mark a notification as unread
+     * @param uniqueId - Unique ID of the notification to mark as unread
+     * @returns The updated Notification record with unread status
+     */
     markAsUnread(uniqueId: string): Promise<Notification>;
+    /**
+     * List notifications filtered by target
+     * @param targetId - Target ID to filter notifications for
+     * @param params - Optional sorting and pagination parameters
+     * @returns Paginated list of Notification records for the given target
+     */
     listByTarget(targetId: string, params?: ListNotificationsParams): Promise<PageResult<Notification>>;
+    /**
+     * List unread notifications
+     * @param params - Optional filtering and pagination parameters
+     * @returns Paginated list of unread Notification records
+     * @note Automatically filters by status "pending"
+     */
     listUnread(params?: ListNotificationsParams): Promise<PageResult<Notification>>;
 }
 export declare function createNotificationsService(transport: Transport, _config: {

package/dist/src/lib/services/notifications.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notifications.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/notifications.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,YAAY,EACZ,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IAC1E,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/D,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACjF,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACpD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACtD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IACpG,UAAU,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;CACjF;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,oBAAoB,CA4FjH"}
+{"version":3,"file":"notifications.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/notifications.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,YAAY,EACZ,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IAE1E;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE7C;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE/D;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEjF;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEpD;;;;OAIG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEtD;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IAEpG;;;;;OAKG;IACH,UAAU,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;CACjF;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,oBAAoB,CA4FjH"}

package/dist/src/lib/services/sources.service.d.ts

@@ -1,6 +1,11 @@
 import type { Transport } from '@23blocks/contracts';
 import type { Source } from '../types/source.js';
 export interface SourcesService {
+    /**
+     * Get a source by unique ID
+     * @param uniqueId - Unique ID of the source to retrieve
+     * @returns The matching Source record
+     */
     get(uniqueId: string): Promise<Source>;
 }
 export declare function createSourcesService(transport: Transport, _config: {

package/dist/src/lib/services/sources.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sources.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/sources.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGjD,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,cAAc,CAOrG"}
+{"version":3,"file":"sources.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/sources.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGjD,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,cAAc,CAOrG"}

package/dist/src/lib/services/users.service.d.ts

@@ -3,19 +3,66 @@ import type { ConversationsUser, RegisterUserRequest, UpdateUserRequest, ListUse
 import type { Group } from '../types/group.js';
 import type { Conversation } from '../types/conversation.js';
 export interface UsersService {
+    /**
+     * List all conversations users
+     * @param params - Optional filtering, sorting, and pagination parameters
+     * @returns Paginated list of ConversationsUser records with pagination metadata
+     */
     list(params?: ListUsersParams): Promise<PageResult<ConversationsUser>>;
+    /**
+     * Get a conversations user by unique ID
+     * @param uniqueId - Unique ID of the user to retrieve
+     * @returns The matching ConversationsUser record
+     */
     get(uniqueId: string): Promise<ConversationsUser>;
+    /**
+     * Register a user in the conversations system
+     * @param uniqueId - Unique ID of the user to register
+     * @param data - Optional registration payload with profile details
+     * @returns The newly registered ConversationsUser record
+     */
     register(uniqueId: string, data?: RegisterUserRequest): Promise<ConversationsUser>;
+    /**
+     * Update a conversations user's profile
+     * @param uniqueId - Unique ID of the user to update
+     * @param data - Fields to update on the user profile
+     * @returns The updated ConversationsUser record
+     */
     update(uniqueId: string, data: UpdateUserRequest): Promise<ConversationsUser>;
+    /**
+     * List groups that a user belongs to
+     * @param uniqueId - Unique ID of the user
+     * @returns Paginated list of Group records the user is a member of
+     */
     listGroups(uniqueId: string): Promise<PageResult<Group>>;
+    /**
+     * List conversations for a user
+     * @param uniqueId - Unique ID of the user
+     * @param params - Optional pagination parameters
+     * @returns Paginated list of Conversation records (messages and files are empty; use conversations.get for full data)
+     * @note Returned conversations contain empty messages and files arrays; fetch individual conversations for full content
+     */
     listConversations(uniqueId: string, params?: {
         page?: number;
         perPage?: number;
     }): Promise<PageResult<Conversation>>;
+    /**
+     * List group conversations for a user
+     * @param uniqueId - Unique ID of the user
+     * @param params - Optional pagination parameters
+     * @returns Paginated list of group Conversation records (messages and files are empty)
+     * @note Returned conversations contain empty messages and files arrays; fetch individual conversations for full content
+     */
     listGroupConversations(uniqueId: string, params?: {
         page?: number;
         perPage?: number;
     }): Promise<PageResult<Conversation>>;
+    /**
+     * List groups for a user within a specific context
+     * @param uniqueId - Unique ID of the user
+     * @param contextUniqueId - Unique ID of the context to filter groups by
+     * @returns Paginated list of Group records within the specified context
+     */
     listContextGroups(uniqueId: string, contextUniqueId: string): Promise<PageResult<Group>>;
 }
 export declare function createUsersService(transport: Transport, _config: {

package/dist/src/lib/services/users.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"users.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/users.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAK7D,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACvE,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACnF,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9E,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IACzD,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IACrH,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IAC1H,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;CAC1F;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CA8GjG"}
+{"version":3,"file":"users.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/users.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAK7D,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAEvE;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAElD;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEnF;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE9E;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAEzD;;;;;;OAMG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IAErH;;;;;;OAMG;IACH,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IAE1H;;;;;OAKG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;CAC1F;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CA8GjG"}

package/dist/src/lib/services/web-notifications.service.d.ts

@@ -1,18 +1,58 @@
 import type { Transport, PageResult } from '@23blocks/contracts';
 import type { WebNotification, CreateWebNotificationRequest, BulkWebNotificationRequest, ListWebNotificationsParams } from '../types/web-notification.js';
 export interface WebNotificationsService {
+    /**
+     * List all web notifications
+     * @param params - Optional filtering, sorting, and pagination parameters
+     * @returns Paginated list of WebNotification records with pagination metadata
+     */
     list(params?: ListWebNotificationsParams): Promise<PageResult<WebNotification>>;
+    /**
+     * Get a web notification by unique ID
+     * @param uniqueId - Unique ID of the web notification to retrieve
+     * @returns The matching WebNotification record
+     */
     get(uniqueId: string): Promise<WebNotification>;
+    /**
+     * Send a web notification to a single recipient
+     * @param data - Notification payload including recipient, title, body, and optional action URL
+     * @returns The newly created WebNotification record
+     */
     send(data: CreateWebNotificationRequest): Promise<WebNotification>;
+    /**
+     * Send a web notification to multiple recipients
+     * @param data - Bulk notification payload including recipient IDs, title, body, and optional action URL
+     * @returns Object with sent and failed counts indicating delivery results
+     */
     sendBulk(data: BulkWebNotificationRequest): Promise<{
         sent: number;
         failed: number;
     }>;
+    /**
+     * Mark a web notification as read
+     * @param uniqueId - Unique ID of the web notification to mark as read
+     * @returns The updated WebNotification record with read status
+     */
     markAsRead(uniqueId: string): Promise<WebNotification>;
+    /**
+     * Mark a web notification as clicked
+     * @param uniqueId - Unique ID of the web notification to mark as clicked
+     * @returns The updated WebNotification record with clicked status
+     */
     markAsClicked(uniqueId: string): Promise<WebNotification>;
+    /**
+     * Mark all web notifications as read for a recipient
+     * @param recipientUniqueId - Unique ID of the recipient whose notifications should be marked as read
+     * @returns Object with the count of updated notifications
+     */
     markAllAsRead(recipientUniqueId: string): Promise<{
         updated: number;
     }>;
+    /**
+     * Delete a web notification
+     * @param uniqueId - Unique ID of the web notification to delete
+     * @returns void on successful deletion
+     */
     delete(uniqueId: string): Promise<void>;
 }
 export declare function createWebNotificationsService(transport: Transport, _config: {

package/dist/src/lib/services/web-notifications.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-notifications.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/web-notifications.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,eAAe,EACf,4BAA4B,EAC5B,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,8BAA8B,CAAC;AAGtC,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,MAAM,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC;IAChF,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAChD,IAAI,CAAC,IAAI,EAAE,4BAA4B,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACnE,QAAQ,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtF,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACvD,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1D,aAAa,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,uBAAuB,CAoFvH"}
+{"version":3,"file":"web-notifications.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/web-notifications.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,eAAe,EACf,4BAA4B,EAC5B,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,8BAA8B,CAAC;AAGtC,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC;IAEhF;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAEhD;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,4BAA4B,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAEnE;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEtF;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAEvD;;;;OAIG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE1D;;;;OAIG;IACH,aAAa,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEvE;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,uBAAuB,CAoFvH"}

package/dist/src/lib/services/websocket-tokens.service.d.ts

@@ -1,6 +1,11 @@
 import type { Transport } from '@23blocks/contracts';
 import type { CreateWebSocketTokenRequest, CreateWebSocketTokenResponse } from '../types/websocket-token.js';
 export interface WebSocketTokensService {
+    /**
+     * Create a WebSocket authentication token
+     * @param data - Optional request with channel and user ID
+     * @returns CreateWebSocketTokenResponse with token, channel, URL, and optional expiration
+     */
     create(data?: CreateWebSocketTokenRequest): Promise<CreateWebSocketTokenResponse>;
 }
 export declare function createWebSocketTokensService(transport: Transport, _config: {

package/dist/src/lib/services/websocket-tokens.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"websocket-tokens.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/websocket-tokens.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EACV,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,IAAI,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;CACnF;AAED,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,sBAAsB,CAmBrH"}
+{"version":3,"file":"websocket-tokens.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/websocket-tokens.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EACV,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;CACnF;AAED,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,sBAAsB,CAmBrH"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@23blocks/block-conversations",
-  "version": "3.3.5",
+  "version": "3.4.0",
   "description": "Conversations block for 23blocks SDK - messaging, groups, notifications, and conversations management",
   "license": "MIT",
   "author": "23blocks <hello@23blocks.com>",