@or-sdk/hitl 0.40.0 → 0.40.1-beta.4180.0

package/dist/types/api/Conferences.d.ts

@@ -1,9 +1,129 @@
 import { GetConferenceMembersOptions, GetConferenceMembersResponse, ConferenceMember, AddOrUpdateConferenceMemberOptions, CleanUpConferenceOptions } from '../types/conferences';
 import { HITLBase } from './HITLBase';
+/**
+ * Manages voice conference members in the system
+ *
+ * This class provides functionality to manage conference participants, including retrieving,
+ * adding, updating, and removing conference members.
+ *
+ * Key features:
+ * - Manage conference member states and statuses
+ * - Track member connection states
+ * - Support for cleanup operations
+ *
+ * @remarks
+ * - All methods in this class interact with the `/conferences` endpoint
+ * @public
+ */
 export declare class Conferences extends HITLBase {
     protected static MODULE_URL: string;
+    /**
+     * Gets a list of conference members or a specific member
+     *
+     * @param options - Configuration parameters for the conference members request
+     *
+     * Required parameters:
+     * - `hitlSessionId` - (string) ID of the HitL session
+     *
+     * Optional parameters:
+     * - `memberId` - (string) Get specific member by ID
+     * - `timeout` - (number) Request timeout in milliseconds
+     * - `version` - (string | number) API version to use
+     *
+     * @returns {Promise<GetConferenceMembersResponse | ConferenceMember>} Promise resolving to:
+     * - Either a list of conference members or a single member if memberId is provided
+     *
+     * @example
+     * ```typescript
+     * // Get all members in a conference
+     * const response = await hitlApi.conferences.getConferenceMembers({
+     *   hitlSessionId: 'session-id'
+     * });
+     *
+     * // Get a specific member
+     * const member = await hitlApi.conferences.getConferenceMembers({
+     *   hitlSessionId: 'session-id',
+     *   memberId: 'member-id'
+     * });
+     * ```
+     *
+     * @remarks
+     * Makes a GET request to the `/conferences` endpoint
+     * @public
+     */
     static getConferenceMembers({ hitlSessionId, memberId, ...options }: GetConferenceMembersOptions): Promise<GetConferenceMembersResponse | ConferenceMember>;
+    /**
+     * Adds or updates a conference member
+     *
+     * @param options - Configuration parameters for adding/updating the conference member
+     *
+     * Required parameters:
+     * - `hitlSessionId` - (string) ID of the HitL session
+     * - `identifier` - (string) Unique identifier for the member
+     * - `type` - (string) Type of the conference member
+     *
+     * Optional parameters:
+     * - `memberId` - (string) ID of the member to update
+     * - `status` - (string) Member's status
+     * - `state` - (string) Member's state
+     * - `disconnectedAt` - (Date) Timestamp when member disconnected
+     * - `timeout` - (number) Request timeout in milliseconds
+     * - `version` - (string | number) API version to use
+     *
+     * @returns {Promise<ConferenceMember>} Promise resolving to the created/updated conference member
+     *
+     * @example
+     * ```typescript
+     * const member = await hitlApi.conferences.addOrUpdateConferenceMember({
+     *   hitlSessionId: 'session-id',
+     *   identifier: '+1234567890',
+     *   type: 'contact',
+     *   status: 'JOINED',
+     *   state: {
+     *     isMuted: false,
+     *     isOnHold: false
+     *   }
+     * });
+     * ```
+     *
+     * @remarks
+     * Makes a POST request to the `/conferences` endpoint
+     * @public
+     */
     static addOrUpdateConferenceMember({ hitlSessionId, memberId, identifier, type, status, state, disconnectedAt, ...options }: AddOrUpdateConferenceMemberOptions): Promise<ConferenceMember>;
+    /**
+     * Removes conference members from a session
+     *
+     * @param options - Configuration parameters for cleaning up the conference
+     *
+     * Required parameters:
+     * - `hitlSessionId` - (string) ID of the HitL session
+     *
+     * Optional parameters:
+     * - `memberId` - (string) Specific member to remove
+     * - `timeout` - (number) Request timeout in milliseconds
+     * - `version` - (string | number) API version to use
+     *
+     * @returns {Promise<void>} Promise that resolves when cleanup is complete
+     *
+     * @example
+     * ```typescript
+     * // Clean up all conference members
+     * await hitlApi.conferences.cleanUpConference({
+     *   hitlSessionId: 'session-id'
+     * });
+     *
+     * // Remove specific member
+     * await hitlApi.conferences.cleanUpConference({
+     *   hitlSessionId: 'session-id',
+     *   memberId: 'member-id'
+     * });
+     * ```
+     *
+     * @remarks
+     * Makes a DELETE request to the `/conferences` endpoint
+     * @public
+     */
     static cleanUpConference({ hitlSessionId, memberId, ...options }: CleanUpConferenceOptions): Promise<void>;
 }
 //# sourceMappingURL=Conferences.d.ts.map

package/dist/types/api/Conferences.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Conferences.d.ts","sourceRoot":"","sources":["../../../src/api/Conferences.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,gBAAgB,EAChB,kCAAkC,EAClC,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAiBtC,qBAAa,WAAY,SAAQ,QAAQ;IACvC,SAAS,CAAC,MAAM,CAAC,UAAU,SAAiB;WAoC9B,oBAAoB,CAChC,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,EAAE,2BAA2B,GACnE,OAAO,CAAC,4BAA4B,GAAG,gBAAgB,CAAC;WAmD7C,2BAA2B,CACvC,EACE,aAAa,EACb,QAAQ,EACR,UAAU,EACV,IAAI,EACJ,MAAM,EACN,KAAK,EACL,cAAc,EACd,GAAG,OAAO,EACX,EAAE,kCAAkC,GACpC,OAAO,CAAC,gBAAgB,CAAC;WAoDd,iBAAiB,CAC7B,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,EAAE,wBAAwB,GAChE,OAAO,CAAC,IAAI,CAAC;CAajB"}
+{"version":3,"file":"Conferences.d.ts","sourceRoot":"","sources":["../../../src/api/Conferences.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,gBAAgB,EAChB,kCAAkC,EAClC,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;;;;;;;GAcG;AACH,qBAAa,WAAY,SAAQ,QAAQ;IACvC,SAAS,CAAC,MAAM,CAAC,UAAU,SAAiB;IAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;WACW,oBAAoB,CAChC,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,EAAE,2BAA2B,GACnE,OAAO,CAAC,4BAA4B,GAAG,gBAAgB,CAAC;IAa3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;WACW,2BAA2B,CACvC,EACE,aAAa,EACb,QAAQ,EACR,UAAU,EACV,IAAI,EACJ,MAAM,EACN,KAAK,EACL,cAAc,EACd,GAAG,OAAO,EACX,EAAE,kCAAkC,GACpC,OAAO,CAAC,gBAAgB,CAAC;IAmB5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;WACW,iBAAiB,CAC7B,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,EAAE,wBAAwB,GAChE,OAAO,CAAC,IAAI,CAAC;CAajB"}

package/dist/types/api/ContactRuleGroups.d.ts

@@ -1,10 +1,141 @@
 import { SearchRuleGroupsOptions, SearchRuleGroupsResponse, RuleGroup, CreateRuleGroupOptions, UpdateRuleGroupOptions, DeleteRuleGroupOptions } from '../types/rule-groups';
 import { HITLBase } from './HITLBase';
+/**
+ * Manages contact rule groups in the system
+ *
+ * This class provides functionality to manage contact rule groups, including searching,
+ * creating, updating, and deleting contact rule groups.
+ *
+ * Key features:
+ * - Search and retrieve contact rule groups
+ * - Create new contact rule groups
+ * - Update existing contact rule groups
+ * - Delete contact rule groups
+ *
+ * @remarks
+ * - All methods in this class interact with the `/contact-rule-groups` endpoint
+ * @public
+ */
 export declare class ContactRuleGroups extends HITLBase {
     protected static MODULE_URL: string;
+    /**
+     * Searches for contact rule groups or retrieves specific groups
+     *
+     * @param options - Configuration parameters for the rule groups search
+     *
+     * Optional parameters:
+     * - `groupIdList` - (string[]) List of specific group IDs to retrieve
+     * - `timeout` - (number) Request timeout in milliseconds
+     * - `version` - (string | number) API version to use
+     *
+     * @returns {Promise<SearchRuleGroupsResponse | RuleGroup>} Promise resolving to:
+     * - Either a list of rule groups or a single rule group if specific ID is provided
+     *
+     * @example
+     * ```typescript
+     * // Search all rule groups
+     * const response = await hitlApi.contactRuleGroups.searchContactRuleGroups();
+     *
+     * // Search specific rule groups
+     * const groups = await hitlApi.contactRuleGroups.searchContactRuleGroups({
+     *   groupIdList: ['group-1', 'group-2']
+     * });
+     * ```
+     *
+     * @remarks
+     * Makes a GET request to the `/contact-rule-groups` endpoint
+     * @public
+     */
     static searchContactRuleGroups({ groupIdList, ...options }?: SearchRuleGroupsOptions): Promise<SearchRuleGroupsResponse | RuleGroup>;
+    /**
+     * Creates a new contact rule group
+     *
+     * @param options - Configuration parameters for creating the rule group
+     *
+     * Required parameters:
+     * - `groupId` - (string) Unique identifier for the group
+     * - `name` - (string) Name of the rule group
+     * - `rules` - (RuleDefinition[]) Array of rules for the group
+     *
+     * Optional parameters:
+     * - `timeout` - (number) Request timeout in milliseconds
+     * - `version` - (string | number) API version to use
+     *
+     * @returns {Promise<RuleGroup>} Promise resolving to the created rule group
+     *
+     * @example
+     * ```typescript
+     * const newGroup = await hitlApi.contactRuleGroups.createContactRuleGroup({
+     *   groupId: 'group-1',
+     *   name: 'Students',
+     *   rules: [
+     *     'student', 'postgraduate student'
+     *   ]
+     * });
+     * ```
+     *
+     * @remarks
+     * Makes a POST request to the `/contact-rule-groups` endpoint
+     * @public
+     */
     static createContactRuleGroup({ groupId, name, rules, ...options }: CreateRuleGroupOptions): Promise<RuleGroup>;
+    /**
+     * Updates an existing contact rule group
+     *
+     * @param options - Configuration parameters for updating the rule group
+     *
+     * Required parameters:
+     * - `groupId` - (string) ID of the group to update
+     * - `name` - (string) Updated name for the rule group
+     * - `rules` - (RuleDefinition[]) Updated array of rules
+     *
+     * Optional parameters:
+     * - `timeout` - (number) Request timeout in milliseconds
+     * - `version` - (string | number) API version to use
+     *
+     * @returns {Promise<RuleGroup>} Promise resolving to the updated rule group
+     *
+     * @example
+     * ```typescript
+     * const updatedGroup = await hitlApi.contactRuleGroups.updateContactRuleGroup({
+     *   groupId: 'group-1',
+     *   name: 'Updated Students',
+     *   rules: [
+     *     'student'
+     *   ]
+     * });
+     * ```
+     *
+     * @remarks
+     * Makes a PUT request to the `/contact-rule-groups` endpoint
+     * @public
+     */
     static updateContactRuleGroup({ groupId, name, rules, ...options }: UpdateRuleGroupOptions): Promise<RuleGroup>;
+    /**
+     * Deletes a contact rule group
+     *
+     * @param options - Configuration parameters for deleting the rule group
+     *
+     * Required parameters:
+     * - `groupId` - (string) ID of the group to delete
+     *
+     * Optional parameters:
+     * - `timeout` - (number) Request timeout in milliseconds
+     * - `version` - (string | number) API version to use
+     *
+     * @returns {Promise<void>} Promise that resolves when deletion is complete
+     *
+     * @example
+     * ```typescript
+     * await hitlApi.contactRuleGroups.deleteContactRuleGroup({
+     *   groupId: 'group-1'
+     * });
+     * ```
+     *
+     * @remarks
+     * Makes a DELETE request to the `/contact-rule-groups` endpoint
+     * @public
+     */
     static deleteContactRuleGroup({ groupId, ...options }: DeleteRuleGroupOptions): Promise<void>;
 }
 //# sourceMappingURL=ContactRuleGroups.d.ts.map

package/dist/types/api/ContactRuleGroups.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContactRuleGroups.d.ts","sourceRoot":"","sources":["../../../src/api/ContactRuleGroups.ts"],"names":[],"mappings":"AACA,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,SAAS,EACT,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAkBtC,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,SAAS,CAAC,MAAM,CAAC,UAAU,SAAyB;WA8BtC,uBAAuB,CACnC,EAAE,WAAW,EAAE,GAAG,OAAO,EAAE,GAAE,uBAA4B,GACxD,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC;WA6ClC,sBAAsB,CAClC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,EAAE,sBAAsB,GAC3D,OAAO,CAAC,SAAS,CAAC;WA8CP,sBAAsB,CAClC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,EAAE,sBAAsB,GAC3D,OAAO,CAAC,SAAS,CAAC;WAwCP,sBAAsB,CAClC,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,sBAAsB,GAC9C,OAAO,CAAC,IAAI,CAAC;CAUjB"}
+{"version":3,"file":"ContactRuleGroups.d.ts","sourceRoot":"","sources":["../../../src/api/ContactRuleGroups.ts"],"names":[],"mappings":"AACA,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,SAAS,EACT,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,SAAS,CAAC,MAAM,CAAC,UAAU,SAAyB;IAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;WACW,uBAAuB,CACnC,EAAE,WAAW,EAAE,GAAG,OAAO,EAAE,GAAE,uBAA4B,GACxD,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC;IAchD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;WACW,sBAAsB,CAClC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,EAAE,sBAAsB,GAC3D,OAAO,CAAC,SAAS,CAAC;IAerB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;WACW,sBAAsB,CAClC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,EAAE,sBAAsB,GAC3D,OAAO,CAAC,SAAS,CAAC;IAerB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;WACW,sBAAsB,CAClC,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,sBAAsB,GAC9C,OAAO,CAAC,IAAI,CAAC;CAUjB"}

package/dist/types/api/Contacts.d.ts

@@ -1,7 +1,44 @@
 import { SearchContactsOptions, SearchContactsResponse } from '../types/contacts';
 import { HITLBase } from './HITLBase';
+/**
+ * This class provides functionality to search contacts with respect to
+ * agent's permissions and rule groups.
+ *
+ * Key features:
+ * - Search contacts with filtering based on agent's contact rule groups
+ *
+ * @remarks
+ * - All methods in this class interact with the `/contacts` endpoint
+ * @public
+ */
 export declare class Contacts extends HITLBase {
     protected static MODULE_URL: string;
+    /**
+     * Searches for contacts limited by the agent's contact rule groups
+     *
+     * Filters out contact records not visible to a given agent, according
+     * to the contact rule groups the agent is a member of
+     *
+     * @param options - Configuration parameters for the contacts search
+     *
+     * Optional parameters:
+     * - `timeout` - (number) Request timeout in milliseconds
+     * - `version` - (string | number) API version to use
+     *
+     * @returns {Promise<SearchContactsResponse>} Promise resolving to the search results
+     *
+     * @example
+     * ```typescript
+     * const contacts = await hitlApi.contacts.searchContacts({
+     *   contact_book: '0cc3f3bb-a064-4b2d-89d9-4c4846a061e2',
+     *   contactIds: ['contact-id-1', 'contact-id-2']
+     * });
+     * ```
+     *
+     * @remarks
+     * Makes a POST request to the `/contacts` endpoint
+     * @public
+     */
     static searchContacts(options: SearchContactsOptions): Promise<SearchContactsResponse>;
 }
 //# sourceMappingURL=Contacts.d.ts.map

package/dist/types/api/Contacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Contacts.d.ts","sourceRoot":"","sources":["../../../src/api/Contacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAElF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAatC,qBAAa,QAAS,SAAQ,QAAQ;IACpC,SAAS,CAAC,MAAM,CAAC,UAAU,SAAc;WA4BrB,cAAc,CAChC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,sBAAsB,CAAC;CAUnC"}
+{"version":3,"file":"Contacts.d.ts","sourceRoot":"","sources":["../../../src/api/Contacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAElF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;;;GAUG;AACH,qBAAa,QAAS,SAAQ,QAAQ;IACpC,SAAS,CAAC,MAAM,CAAC,UAAU,SAAc;IAEzC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;WACiB,cAAc,CAChC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,sBAAsB,CAAC;CAUnC"}

package/dist/types/api/ContactsMeta.d.ts

@@ -1,8 +1,41 @@
 import { SearchContactsMetaOptions, SearchContactsMetaResponse } from '../types/contacts-meta';
 import { HITLBase } from './HITLBase';
+/**
+ * This class provides functionality to retrieve metadata information about contacts.
+ *
+ * @remarks
+ * - All methods in this class interact with the `/contacts-meta` endpoint
+ * @public
+ */
 export declare class ContactsMeta extends HITLBase {
     protected static MODULE_URL: string;
     protected static SEARCH_URL: string;
+    /**
+     * Retrieves HitL-specific contact parameters (metadata)
+     *
+     * @param options - Configuration parameters for the metadata search
+     *
+     * Required parameters:
+     * - `contactIds` - (string[]) List of specific contact IDs to retrieve
+     *
+     * Optional parameters:
+     * - `timeout` - (number) Request timeout in milliseconds
+     * - `version` - (string | number) API version to use
+     *
+     * @returns {Promise<SearchContactsMetaResponse>} Promise resolving to:
+     * - `data` - Contact last event timestamps
+     *
+     * @example
+     * ```typescript
+     * const metadata = await hitlApi.contactsMeta.searchContactsMeta({
+     *   contactIds: ['contact-id-1', 'contact-id-2']
+     * });
+     * ```
+     *
+     * @remarks
+     * Makes a POST request to the `/contacts-meta/search` endpoint
+     * @public
+     */
     static searchContactsMeta(options: SearchContactsMetaOptions): Promise<SearchContactsMetaResponse>;
 }
 //# sourceMappingURL=ContactsMeta.d.ts.map

package/dist/types/api/ContactsMeta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContactsMeta.d.ts","sourceRoot":"","sources":["../../../src/api/ContactsMeta.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAStC,qBAAa,YAAa,SAAQ,QAAQ;IACxC,SAAS,CAAC,MAAM,CAAC,UAAU,SAAmB;IAC9C,SAAS,CAAC,MAAM,CAAC,UAAU,SAAY;WA4BnB,kBAAkB,CACpC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,0BAA0B,CAAC;CAcvC"}
+{"version":3,"file":"ContactsMeta.d.ts","sourceRoot":"","sources":["../../../src/api/ContactsMeta.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;GAMG;AACH,qBAAa,YAAa,SAAQ,QAAQ;IACxC,SAAS,CAAC,MAAM,CAAC,UAAU,SAAmB;IAC9C,SAAS,CAAC,MAAM,CAAC,UAAU,SAAY;IAEvC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;WACiB,kBAAkB,CACpC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,0BAA0B,CAAC;CAcvC"}

package/dist/types/api/DraftMessages.d.ts

@@ -1,12 +1,212 @@
 import { DraftMessage, GetDraftMessagesOptions, GetDraftMessagesResponse, CreateDraftMessageOptions, UpdateDraftMessageOptions, DeleteDraftMessageOptions, GetDraftMessagesCountResponse, GetDraftMessagesCountOptions } from '../types/draft-messages';
 import { HITLBase } from './HITLBase';
+/**
+ * Manages draft messages in the system
+ *
+ * This class provides functionality to create, retrieve, update, and delete draft messages.
+ * Draft messages are messages that can be sent at a specific time to contacts and sessions.
+ *
+ * Key features:
+ * - Schedule messages for future delivery
+ * - Target specific contacts and sessions
+ * - Support for various channel types for messages
+ *
+ * @example
+ * Basic usage:
+ * ```typescript
+ * // Get all draft messages
+ * const messages = await hitlApi.draftMessages.getDraftMessages();
+ *
+ * // Create a new draft message
+ * const newMessage = await hitlApi.draftMessages.createDraftMessage({
+ *   message: {
+ *     message: 'Hello! This is a draft message.',
+ *     media: []
+ *   },
+ *   type: 'SMS',
+ *   contactIds: ['contact-1', 'contact-2'],
+ *   timestamp: new Date('2024-12-25T10:00:00Z').toISOString()
+ * });
+ * ```
+ *
+ * @remarks
+ * - All methods in this class interact with the `/draft-messages` endpoint
+ * - These methods are available only when you pass `{ version: 1 }` in the parameters.
+ * @public
+ */
 export declare class DraftMessages extends HITLBase {
     protected static MODULE_URL: string;
     protected static COUNT_URL: "count";
+    /**
+     * Gets a list of draft messages
+     *
+     * @param options - Configuration parameters for the draft messages list request
+     *
+     * Optional parameters:
+     * - `id` - (string) Get specific draft message by ID
+     * - `timeout` - (number) Request timeout in milliseconds
+     * - `version` - (string | number) API version to use
+     * - `agentId` - (string) ID of the agent to get specific DM for (for super admin and flow token)
+     *
+     * @returns {Promise<GetDraftMessagesResponse | DraftMessage>} Promise resolving to:
+     * - `data` - Array of draft message objects {@link DraftMessage}
+     *
+     * @example
+     * ```typescript
+     * const response = await hitlApi.draftMessages.getDraftMessages({
+     *   id: 'message-id-1'
+     * });
+     * ```
+     *
+     * @remarks
+     * Makes a GET request to the `/draft-messages` endpoint
+     * @public
+     */
     static getDraftMessages(options?: GetDraftMessagesOptions): Promise<GetDraftMessagesResponse | DraftMessage>;
+    /**
+     * Gets the count of draft messages based on specified criteria
+     *
+     * @param options - Configuration parameters for counting draft messages
+     *
+     * Required parameters:
+     * - `status` - (string) Filter draft messages by status
+     *
+     * Optional parameters:
+     * - `sessionId` - (string) Filter draft messages by session ID
+     * - `contactIds` - (string[]) Array of contact IDs to filter by
+     * - `agentId` - (string) ID of the agent to count draft messages for (for super admin and flow token)
+     * - `timeout` - (number) Request timeout in milliseconds
+     * - `version` - (string | number) API version to use
+     *
+     * @returns {Promise<GetDraftMessagesCountResponse>} Promise resolving to count response
+     *
+     * @example
+     * ```typescript
+     * const countResponse = await hitlApi.draftMessages.getDraftMessagesCount({
+     *   status: 'pending',
+     *   sessionId: 'session-id-1'
+     * });
+     * ```
+     *
+     * @remarks
+     * Makes a GET request to the `/draft-messages/count` endpoint
+     * @public
+     */
     static getDraftMessagesCount({ status, sessionId, contactIds, agentId, ...options }: GetDraftMessagesCountOptions): Promise<GetDraftMessagesCountResponse>;
+    /**
+     * Creates a new draft message
+     *
+     * @param options - Configuration parameters for creating the draft message
+     *
+     * Required parameters:
+     * - `message` - (Message) Message content and media
+     * - `type` - (string) Type of the draft message
+     * - `contactIds` - (string[]) Array of contact IDs to send the message to
+     * - `timestamp` - (Date) When the message should be sent
+     *
+     * Optional parameters:
+     * - `sessionId` - (string) Session ID to associate with
+     * - `meta` - (object) Meta information for message
+     * - `timeout` - (number) Request timeout in milliseconds
+     * - `version` - (string | number) API version to use
+     * - `agentId` - (string) ID of the agent to get specific DM for (for super admin and flow token)
+     *
+     * @returns {Promise<DraftMessage>} Promise resolving to the created draft message
+     *
+     * @example
+     * ```typescript
+     * const newMessage = await hitlApi.draftMessages.createDraftMessage({
+     *   message: {
+     *     message: 'Your appointment is tomorrow at 3 PM',
+     *     media: [
+     *       {
+     *         type: 'image',
+     *         url: 'https://example.com/reminder.jpg'
+     *       }
+     *     ]
+     *   },
+     *   type: 'SMS',
+     *   contactIds: ['contact-123'],
+     *   timestamp: new Date('2024-12-24T15:00:00Z').toISOString(),
+     *   sessionId: 'session-456'
+     * });
+     * ```
+     *
+     * @remarks
+     * Makes a POST request to the `/draft-messages` endpoint
+     * @public
+     */
     static createDraftMessage(options: CreateDraftMessageOptions): Promise<DraftMessage>;
+    /**
+     * Updates an existing draft message
+     *
+     * @param options - Configuration parameters for updating the draft message
+     *
+     * Required parameters:
+     * - `id` - (string) Unique identifier of the message to update
+     *
+     * Optional parameters:
+     * - `message` - (Message) Updated message content and media
+     * - `type` - (string) Updated type of the draft message
+     * - `contactIds` - (string[]) Updated array of contact IDs
+     * - `sessionId` - (string) Updated session ID
+     * - `meta` - (object) Updated meta information for message
+     * - `timestamp` - (Date) Updated send time
+     * - `timeout` - (number) Request timeout in milliseconds
+     * - `version` - (string | number) API version to use
+     * - `agentId` - (string) ID of the agent to get specific DM for (for super admin and flow token)
+     *
+     * System fields (automatically managed):
+     * - `createdAt` - (Date) Creation timestamp
+     * - `updatedAt` - (Date) Last update timestamp
+     * - `agentId` - (string) Agent who created the message
+     * - `status` - (string) Current status of the message
+     *
+     * @returns {Promise<DraftMessage>} Promise resolving to the updated draft message
+     *
+     * @example
+     * ```typescript
+     * const updatedMessage = await hitlApi.draftMessages.updateDraftMessage({
+     *   id: "msg-id-1",
+     *   message: {
+     *     message: "Updated reminder: Your appointment is at 4 PM",
+     *     media: []
+     *   },
+     *   timestamp: new Date('2024-12-24T16:00:00Z').toISOString()
+     * });
+     * ```
+     *
+     * @remarks
+     * Makes a PUT request to the `/draft-messages` endpoint
+     * @public
+     */
     static updateDraftMessage(options: UpdateDraftMessageOptions): Promise<DraftMessage>;
+    /**
+     * Deletes a draft message
+     *
+     * @param options - Configuration parameters for deleting the draft message
+     *
+     * Required parameters:
+     * - `id` - (string) Unique identifier of the message to delete
+     *
+     * Optional parameters:
+     * - `version` - (string | number) API version to use
+     * - `timeout` - (number) Request timeout in milliseconds
+     * - `agentId` - (string) ID of the agent to get specific DM for (for super admin and flow token)
+     *
+     * @returns {Promise<void>} Promise that resolves when deletion is complete
+     *
+     * @example
+     * ```typescript
+     * await hitlApi.draftMessages.deleteDraftMessage({
+     *   id: "msg-id-1"
+     * });
+     * ```
+     *
+     * @remarks
+     * Makes a DELETE request to the `/draft-messages` endpoint
+     * @public
+     */
     static deleteDraftMessage({ id, agentId, ...options }: DeleteDraftMessageOptions): Promise<void>;
 }
 //# sourceMappingURL=DraftMessages.d.ts.map

package/dist/types/api/DraftMessages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DraftMessages.d.ts","sourceRoot":"","sources":["../../../src/api/DraftMessages.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EAAE,6BAA6B,EAAE,4BAA4B,EACvF,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAqCtC,qBAAa,aAAc,SAAQ,QAAQ;IACzC,SAAS,CAAC,MAAM,CAAC,UAAU,SAAoB;IAC/C,SAAS,CAAC,MAAM,CAAC,SAAS,UAAoB;WA2B1B,gBAAgB,CAClC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,wBAAwB,GAAG,YAAY,CAAC;WA2C/B,qBAAqB,CACvC,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,4BAA4B,GACnF,OAAO,CAAC,6BAA6B,CAAC;WA4DrB,kBAAkB,CACpC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,YAAY,CAAC;WA2DJ,kBAAkB,CACpC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,YAAY,CAAC;WA0CJ,kBAAkB,CACpC,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,yBAAyB,GACrD,OAAO,CAAC,IAAI,CAAC;CAajB"}
+{"version":3,"file":"DraftMessages.d.ts","sourceRoot":"","sources":["../../../src/api/DraftMessages.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EAAE,6BAA6B,EAAE,4BAA4B,EACvF,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,qBAAa,aAAc,SAAQ,QAAQ;IACzC,SAAS,CAAC,MAAM,CAAC,UAAU,SAAoB;IAC/C,SAAS,CAAC,MAAM,CAAC,SAAS,UAAoB;IAE9C;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;WACiB,gBAAgB,CAClC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,wBAAwB,GAAG,YAAY,CAAC;IAcnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;WACiB,qBAAqB,CACvC,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,4BAA4B,GACnF,OAAO,CAAC,6BAA6B,CAAC;IAiBzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;WACiB,kBAAkB,CACpC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,YAAY,CAAC;IAgBxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;WACiB,kBAAkB,CACpC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,YAAY,CAAC;IAgBxB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;WACiB,kBAAkB,CACpC,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,yBAAyB,GACrD,OAAO,CAAC,IAAI,CAAC;CAajB"}