@or-sdk/hitl 0.36.1 → 0.36.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,160 +1,15 @@
1
1
  import { GetNewEventsCountOptions, GetNewEventsCountResponse, SaveLastReadEventOptions } from '../types/read-events';
2
2
  import { GetSessionEventsOptions, GetSessionEventsResponse, AddEventsOptions, AddEventsResponse, GetBulkSessionEventsOptions, GetBulkSessionsEventsResponse } from '../types/session-events';
3
3
  import { HITLBase } from './HITLBase';
4
- /**
5
- * Manages events for Human-in-the-Loop (HitL) sessions
6
- *
7
- * This class provides functionality to:
8
- * - Retrieve and manage session events
9
- * - Track event read status
10
- * - Handle bulk event operations
11
- * - Manage event counts
12
- *
13
- * @remarks
14
- * - All methods interact with the `/session-events` endpoint
15
- * @public
16
- */
17
4
  export declare class SessionEvents extends HITLBase {
18
5
  protected static MODULE_URL: string;
19
6
  protected static GET_BULK_EVENTS_URL: string;
20
7
  protected static GET_EVENTS_COUNT_URL: string;
21
8
  protected static SAVE_READ_EVENT_URL: string;
22
- /**
23
- * Retrieves events for a specific HitL session
24
- *
25
- * @param options - Configuration parameters for retrieving session events
26
- *
27
- * Required parameters:
28
- * - `sessionId` - (string) ID of the session to retrieve events for
29
- *
30
- * Optional parameters:
31
- * - `timeout` - (number) Request timeout in milliseconds
32
- * - `version` - (string | number) API version to use
33
- *
34
- * @returns {Promise<SessionEvent[]>} Promise resolving to the list of session events
35
- *
36
- * @example
37
- * ```typescript
38
- * const events = await hitlApi.sessionEvents.getSessionEventsList({
39
- * sessionId: 'session-id'
40
- * });
41
- * ```
42
- *
43
- * @remarks Makes a GET request to `/session-events`
44
- * @public
45
- */
46
9
  static getSessionEventsList(options: GetSessionEventsOptions): Promise<GetSessionEventsResponse>;
47
- /**
48
- * Retrieves events for multiple HitL sessions in bulk
49
- *
50
- * @param options - Configuration parameters for bulk event retrieval
51
- *
52
- * Required parameters:
53
- * - `sessionIds` - (string[]) Array of session IDs to retrieve events for
54
- *
55
- * Optional parameters:
56
- * - `timeout` - (number) Request timeout in milliseconds
57
- * - `version` - (string | number) API version to use
58
- *
59
- * @returns {Promise<GetBulkSessionsEventsResponse>} Promise resolving to events for multiple sessions
60
- *
61
- * @example
62
- * ```typescript
63
- * const bulkEvents = await hitlApi.sessionEvents.getBulkSessionEventsList({
64
- * sessionIds: ['session-id-1', 'session-id-2']
65
- * });
66
- * ```
67
- *
68
- * @remarks Makes a POST request to `/session-events/bulk`
69
- * @public
70
- */
71
10
  static getBulkSessionEventsList(options: GetBulkSessionEventsOptions): Promise<GetBulkSessionsEventsResponse>;
72
- /**
73
- * Adds new events to a HITL session
74
- *
75
- * @param options - Configuration parameters for adding session events
76
- *
77
- * Required parameters:
78
- * - `events` - (Partial<SessionEvent>[]) Array of partial event objects
79
- * - `sessionId` - (string) ID of the session to add events to
80
- *
81
- * Optional parameters:
82
- * - `timeout` - (number) Request timeout in milliseconds
83
- * - `version` - (string | number) API version to use
84
- *
85
- * @returns {Promise<AddEventsResult>} Promise resolving to the add operation result
86
- *
87
- * @example
88
- * ```typescript
89
- * const result = await hitlApi.sessionEvents.addEvents({
90
- * sessionId: 'session-id',
91
- * events: [
92
- * { type: 'message', content: 'Hello' },
93
- * { type: 'status', content: 'typing' }
94
- * ]
95
- * });
96
- * ```
97
- *
98
- * @remarks Makes a POST request to `/session-events`
99
- * @public
100
- */
101
11
  static addEvents({ sessionId, events, ...options }: AddEventsOptions): Promise<AddEventsResponse>;
102
- /**
103
- * Retrieves count of unread events for specified sessions
104
- *
105
- * @param options - Configuration parameters for retrieving unread events count
106
- *
107
- * Required parameters:
108
- * - `sessionIds` - (string[]) Array of session IDs to get events count for
109
- *
110
- * Optional parameters:
111
- * - `agentId` - (string) ID of the agent to get unread events for
112
- * - `timeout` - (number) Request timeout in milliseconds
113
- * - `version` - (string | number) API version to use
114
- *
115
- * @returns {Promise<NewEventsCount>} Promise resolving to the unread events count
116
- *
117
- * @example
118
- * ```typescript
119
- * // Basic usage with required parameters
120
- * const count = await hitlApi.sessionEvents.getNewEventsCount({
121
- * sessionIds: ['session-id-1', 'session-id-2']
122
- * });
123
- * ```
124
- *
125
- * @remarks Makes a GET request to `/sessions-events/get-new-events`
126
- * @public
127
- */
128
12
  static getNewEventsCount({ agentId, ...options }: GetNewEventsCountOptions): Promise<GetNewEventsCountResponse>;
129
- /**
130
- * Records the last read event for a specific session
131
- *
132
- * @param options - Configuration parameters for saving last read event
133
- *
134
- * Required parameters:
135
- * - `eventId` - (string) ID of the last read event
136
- * - `eventTimestamp` - (string | number) Timestamp of the last read event
137
- * - `sessionId` - (string) ID of the session
138
- *
139
- * Optional parameters:
140
- * - `agentId` - (string) ID of the agent who read the event
141
- * - `timeout` - (number) Request timeout in milliseconds
142
- * - `version` - (string | number) API version to use
143
- *
144
- * @returns {Promise<void>} Promise resolving when the read status is saved
145
- *
146
- * @example
147
- * ```typescript
148
- * await hitlApi.sessionEvents.saveLastReadEvent({
149
- * sessionId: 'session-id-1',
150
- * eventId: 'event-id-2',
151
- * eventTimestamp: Date.now()
152
- * });
153
- * ```
154
- *
155
- * @remarks Makes a POST request to `/sessions-events/save-read-event`
156
- * @public
157
- */
158
13
  static saveReadEventByUserId({ agentId, ...options }: SaveLastReadEventOptions): Promise<void>;
159
14
  }
160
15
  //# sourceMappingURL=SessionEvents.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"SessionEvents.d.ts","sourceRoot":"","sources":["../../../src/api/SessionEvents.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,EACjB,2BAA2B,EAC3B,6BAA6B,EAC9B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IACzC,SAAS,CAAC,MAAM,CAAC,UAAU,SAAoB;IAC/C,SAAS,CAAC,MAAM,CAAC,mBAAmB,SAAU;IAC9C,SAAS,CAAC,MAAM,CAAC,oBAAoB,SAAoB;IACzD,SAAS,CAAC,MAAM,CAAC,mBAAmB,SAAqB;IAEzD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;WACiB,oBAAoB,CACtC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,wBAAwB,CAAC;IAcpC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;WACiB,wBAAwB,CAC1C,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,6BAA6B,CAAC;IAezC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;WACW,SAAS,CACrB,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,gBAAgB,GAClD,OAAO,CAAC,iBAAiB,CAAC;IAY7B;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;WACiB,iBAAiB,CACnC,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,wBAAwB,GAChD,OAAO,CAAC,yBAAyB,CAAC;IAgBrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;WACiB,qBAAqB,CACvC,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,wBAAwB,GAChD,OAAO,CAAC,IAAI,CAAC;CAejB"}
1
+ {"version":3,"file":"SessionEvents.d.ts","sourceRoot":"","sources":["../../../src/api/SessionEvents.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,EACjB,2BAA2B,EAC3B,6BAA6B,EAC9B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAetC,qBAAa,aAAc,SAAQ,QAAQ;IACzC,SAAS,CAAC,MAAM,CAAC,UAAU,SAAoB;IAC/C,SAAS,CAAC,MAAM,CAAC,mBAAmB,SAAU;IAC9C,SAAS,CAAC,MAAM,CAAC,oBAAoB,SAAoB;IACzD,SAAS,CAAC,MAAM,CAAC,mBAAmB,SAAqB;WA0BrC,oBAAoB,CACtC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,wBAAwB,CAAC;WAsChB,wBAAwB,CAC1C,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,6BAA6B,CAAC;WA4C3B,SAAS,CACrB,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,gBAAgB,GAClD,OAAO,CAAC,iBAAiB,CAAC;WAsCT,iBAAiB,CACnC,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,wBAAwB,GAChD,OAAO,CAAC,yBAAyB,CAAC;WA6CjB,qBAAqB,CACvC,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,wBAAwB,GAChD,OAAO,CAAC,IAAI,CAAC;CAejB"}
@@ -1,19 +1,5 @@
1
1
  import { Session, GetSessionsOptions, GetSessionByIdOptions, GetSessionsResponse, GetQueueSessionOptions, GetQueueSessionResponse, SearchSessionsOptions, SearchSessionsResponse, SearchSessionsWithContactsOptions, SearchSessionsWithContactsResponse, GetInitTriggersOptions, GetInitTriggersResponse, ClaimSessionByAgentOptions, StartConversationOptions, TransferToBotOptions, UpdateSessionOptions, CloseSessionOptions, ReopenSessionOptions, DeleteClosedSessionOptions, CreateSessionsOptions, CreateSessionsResponse, BulkDeleteSessionsOptions } from '../types/sessions';
2
2
  import { HITLBase } from './HITLBase';
3
- /**
4
- * Manages Human-in-the-Loop sessions and related operations
5
- *
6
- * This class provides functionality to:
7
- * - Manage session lifecycle (create, update, close, reopen, delete)
8
- * - Handle session assignments and transfers
9
- * - Search and retrieve sessions
10
- * - Manage queue sessions
11
- *
12
- * @remarks
13
- * - Makes requests to the `/sessions` endpoints
14
- * - For the methods `claimSessionByAgent` and `searchSessionsWithContacts`, you must include `{ version: 2 }` in the parameters for the method to execute correctly.
15
- * @public
16
- */
17
3
  export declare class Sessions extends HITLBase {
18
4
  protected static MODULE_URL: string;
19
5
  protected static SEARCH_URL: "search";
@@ -25,460 +11,21 @@ export declare class Sessions extends HITLBase {
25
11
  protected static START_CONVERSATION_URL: "start-conversation";
26
12
  protected static CLOSE_URL: "close";
27
13
  protected static REOPEN_URL: "reopen";
28
- /**
29
- * Retrieves a list of HITL sessions
30
- *
31
- * @param options - Configuration parameters for retrieving sessions
32
- *
33
- * Optional parameters:
34
- * - `agentId` - (string) ID of agent to filter sessions by
35
- * - `contactId` - (string) ID of contact to filter sessions by
36
- * - `ignoreRuleTags` - (boolean) Whether to ignore rule tags in filtering
37
- * - `limit` - (number) Maximum number of sessions to return
38
- * - `order` - ('asc' | 'desc') Sort order direction
39
- * - `orderBy` - (string) Field to sort results by
40
- * - `page` - ({@link PageOptions}) Pagination options
41
- * - `projection` - (string[]) Fields to include in the response
42
- * - `status` - (string[]) Filter by session status(es)
43
- * - `timeout` - (number) Request timeout in milliseconds
44
- * - `version` - (string | number) API version to use
45
- *
46
- * @returns {Promise<GetSessionsResponse>} Promise resolving to list of sessions
47
- *
48
- * @example
49
- * ```typescript
50
- * // Get all active sessions for an agent
51
- * const sessions = await hitlApi.sessions.getSessions({
52
- * status: ['ONGOING', 'CLAIMED'],
53
- * limit: 50
54
- * });
55
- * ```
56
- *
57
- * @remarks Makes a GET request to `/hitl/sessions`
58
- */
59
14
  static getSessions(options?: GetSessionsOptions): Promise<GetSessionsResponse>;
60
- /**
61
- * Retrieves a specific HitL session by ID
62
- *
63
- * @param options - Configuration parameters for retrieving a session
64
- *
65
- * Required parameters:
66
- * - `sessionId` - (string) ID of the session to retrieve
67
- *
68
- * Optional parameters:
69
- * - `agentId` - (string) ID of agent accessing the session
70
- * - `ignoreRuleTags` - (boolean) Whether to ignore rule tags in filtering
71
- * - `projection` - (string[]) Fields to include in the response
72
- * - `timeout` - (number) Request timeout in milliseconds
73
- * - `version` - (string | number) API version to use
74
- *
75
- * @returns {Promise<Session>} Promise resolving to session details
76
- *
77
- * @example
78
- * ```typescript
79
- * const session = await hitlApi.sessions.getSessionById({
80
- * sessionId: 'session-id-1',
81
- * projection: ['hitlSessionId', 'status', 'transcript']
82
- * });
83
- * ```
84
- *
85
- * @remarks Makes a GET request to `/sessions/{sessionId}`
86
- */
87
15
  static getSessionById({ agentId, projection, ...options }: GetSessionByIdOptions): Promise<Session>;
88
- /**
89
- * Searches for HitL sessions based on provided criteria
90
- *
91
- * @param options - Search configuration and filters
92
- *
93
- * Optional parameters:
94
- * - `agentId` - (string) Filter by assigned agent
95
- * - `claimedBy` - (string) Filter by currently assigned agent
96
- * - `claimedByHistory` - (string) Filter by previously assigned agent
97
- * - `contactIds` - (string[]) Array of contact IDs to filter by
98
- * - `dateRange` - (DateRangeOptions) Date range filtering options
99
- * - `meta` - (Record<string, string | number | boolean | MetaWithCondition>) Metadata filters
100
- * - `needsAction` - (boolean) Filter sessions requiring action
101
- * - `searchPhrase` - (string) Text search query
102
- * - `sessionIds` - (string[]) Array of session IDs to filter by
103
- * - `sessionsSearchOptions` - (SessionSearchOptions) Additional search configuration
104
- * - `status` - (string[]) Filter by session status(es)
105
- * - `tags` - (TagsQuery | string[]) Filter by tags
106
- * - `timeout` - (number) Request timeout in milliseconds
107
- * - `type` - (string) Filter by session type
108
- * - `version` - (string | number) API version to use
109
- *
110
- * @returns {Promise<SearchSessionsResponse>} Promise resolving to search results
111
- *
112
- * @example
113
- * ```typescript
114
- * // Search by different options
115
- * const results = await hitlApi.sessions.searchSessions({
116
- * claimedBy: BASIC_USER_ID,
117
- * status: ['ONGOING', 'CLAIMED'],
118
- * tags: ['wait_for_agent'],
119
- * type: 'SMS',
120
- * limit: 25
121
- * });
122
- *
123
- * // Search by meta with conditions
124
- * const results = await hitlApi.sessions.searchSessions({
125
- * meta: {
126
- * botIdentifier: { value: botIdentifier, condition: 'IS_EQUAL' },
127
- * hiddenFromHistory: { value: true, condition: 'IS_NOT_EQUAL' },
128
- * userIdentifier: { value: userIdentifier1.slice(3), condition: 'CONTAINS' },
129
- * },
130
- * });
131
- * ```
132
- *
133
- * @remarks Makes a POST request to `/sessions/search`
134
- */
135
16
  static searchSessions({ agentId, ...options }?: SearchSessionsOptions): Promise<SearchSessionsResponse>;
136
- /**
137
- * Searches for HitL sessions and includes associated contact information
138
- *
139
- * @param options - Search configuration including contact-related filters
140
- *
141
- * Optional parameters:
142
- * - `agentId` - (string) Filter by assigned agent
143
- * - `contact` - (ContactSearchParams) Contact search parameters
144
- * - `contactsSearchOptions` - (ContactSearchOptions) Additional contact search configuration
145
- * - `dateRange` - (DateRangeOptions) Date range filtering options
146
- * - `searchPhrase` - (string) Text search query
147
- * - `sessionsSearchOptions` - (SessionSearchOptions) Additional session search configuration
148
- * - `tags` - (string[]) Filter by tags
149
- * - `timeout` - (number) Request timeout in milliseconds
150
- * - `version` - (string | number) API version to use
151
- *
152
- * @returns {Promise<SearchSessionsWithContactsResponse>} Promise resolving to sessions with contact details
153
- *
154
- * @example
155
- * ```typescript
156
- * const results = await hitlApi.sessions.searchSessionsWithContacts({
157
- * searchPhrase: 'billing issue',
158
- * tags: ['vip', 'missed'],
159
- * limit: 10,
160
- * version: 2
161
- * });
162
- *
163
- * // Search sessions by contact info
164
- * const results = await hitlApi.sessions.searchSessionsWithContacts({
165
- * contact: { name: 'Alison' },
166
- * contactsSearchOptions: { size: 2 },
167
- * version: 2
168
- * });
169
- * ```
170
- *
171
- * @remarks Makes a POST request to `/sessions/search-with-contacts`
172
- */
173
17
  static searchSessionsWithContacts({ agentId, ...options }?: SearchSessionsWithContactsOptions): Promise<SearchSessionsWithContactsResponse>;
174
- /**
175
- * Retrieves the next session in NEEDS_ACTION state from the queue
176
- *
177
- * @param options - Queue configuration including agent and rule tags
178
- *
179
- * Required parameters:
180
- * - `agentId` - (string) ID of agent requesting next session
181
- *
182
- * Optional parameters:
183
- * - `ruleTags` - (string[]) Filter sessions by rule tags
184
- * - `ignoreRuleTags` - (boolean) Whether to ignore rule tags in filtering
185
- * - `timeout` - (number) Request timeout in milliseconds
186
- * - `version` - (string | number) API version to use
187
- *
188
- * @returns {Promise<GetQueueSessionResponse>} Promise resolving to next available session
189
- *
190
- * @example
191
- * ```typescript
192
- * // Get next session for agent
193
- * const session = await hitlApi.sessions.getQueueSession({
194
- * agentId: 'agent-id'
195
- * });
196
- * ```
197
- *
198
- * @remarks Makes a GET request to `sessions/helpers/queue`
199
- */
200
18
  static getQueueSession({ agentId, ruleTags, ...options }: GetQueueSessionOptions): Promise<GetQueueSessionResponse>;
201
- /**
202
- * Retrieves available initialization triggers for starting new HitL sessions
203
- *
204
- * @param options - Configuration parameters for trigger retrieval
205
- *
206
- * Optional parameters:
207
- * - `timeout` - (number) Request timeout in milliseconds
208
- * - `version` - (string | number) API version to use
209
- *
210
- * @returns {Promise<GetInitTriggersResponse>} Promise resolving to available triggers
211
- *
212
- * @example
213
- * ```typescript
214
- * // Get all available triggers
215
- * const triggers = await hitlApi.sessions.getSessionInitTriggers();
216
- * ```
217
- *
218
- * @remarks Makes a GET request to `/sessions/helpers/triggers`
219
- */
220
19
  static getSessionInitTriggers(options?: GetInitTriggersOptions): Promise<GetInitTriggersResponse>;
221
- /**
222
- * Claims a session for a specific agent
223
- *
224
- * @param options - Claim configuration including agent and parameters
225
- *
226
- * Required parameters:
227
- * - `sessionId` - (string) ID of session to claim
228
- * - `claimBy` - (string) ID of agent claiming the session
229
- *
230
- * Optional parameters:
231
- * - `params` - (object) Additional claim parameters
232
- * - `timeout` - (number) Request timeout in milliseconds
233
- * - `version` - (string | number) API version to use
234
- *
235
- * @returns {Promise<Session>} Promise resolving to the claimed session
236
- * @remarks Makes a POST request to `/api/v2/hitl/sessions/{sessionId}/claim`
237
- *
238
- * @example
239
- * ```typescript
240
- * // Claim session by current token agent
241
- * const session = await hitlApi.sessions.claimSessionByAgent({
242
- * sessionId: 'session-id',
243
- * version: 2
244
- * });
245
- * ```
246
- */
247
20
  static claimSessionByAgent({ claimBy, params, ...options }: ClaimSessionByAgentOptions): Promise<Session>;
248
- /**
249
- * Transfers session control back to the bot
250
- *
251
- * @param options - Transfer configuration including agent and parameters
252
- *
253
- * Required parameters:
254
- * - `sessionId` - (string) ID of session to transfer
255
- * - `agentId` - (string) ID of agent transferring the session
256
- *
257
- * Optional parameters:
258
- * - `params` - (object) Additional transfer parameters
259
- * - `timeout` - (number) Request timeout in milliseconds
260
- * - `version` - (string | number) API version to use
261
- *
262
- * @returns {Promise<Session>} Promise resolving to transferred session
263
- * @remarks Makes a POST request to `/api/v2/hitl/sessions/{sessionId}/transfer-to-bot`
264
- *
265
- * @example
266
- * ```typescript
267
- * // Basic transfer
268
- * const session = await hitlApi.sessions.transferToBot({
269
- * sessionId: 'session-id',
270
- * });
271
- * ```
272
- */
273
21
  static transferToBot({ agentId, params, ...options }: TransferToBotOptions): Promise<Session>;
274
- /**
275
- * Initiates a new conversation session
276
- *
277
- * @param options - Conversation configuration including contact and trigger details
278
- *
279
- * Required parameters:
280
- * - `contactId` - (string) ID of contact to start conversation with
281
- * - `triggerId` - (string) ID of trigger to initiate conversation
282
- *
283
- * Optional parameters:
284
- * - `params` - (object) Additional conversation parameters
285
- * - `timeout` - (number) Request timeout in milliseconds
286
- * - `version` - (string | number) API version to use
287
- *
288
- * @returns {Promise<Session>} Promise resolving to new session
289
- *
290
- * @example
291
- * ```typescript
292
- * // Start basic conversation
293
- * const session = await hitlApi.sessions.startConversation({
294
- * contactId: 'contact-id-1',
295
- * triggerId: 'trigger-id-2'
296
- * });
297
- *
298
- * // Start conversation with parameters
299
- * const session = await hitlApi.sessions.startConversation({
300
- * contactId: 'contact-id',
301
- * triggerId: 'hitl/init-conversation/voice',
302
- * params: { visibilityTags: [] }
303
- * });
304
- * ```
305
- *
306
- * @remarks Makes a POST request to `/sessions/start-conversation`
307
- */
308
22
  static startConversation({ contactId, triggerId, params, ...options }: StartConversationOptions): Promise<Session>;
309
- /**
310
- * Updates an existing session with new information
311
- *
312
- * @param options - Update configuration including tags and metadata
313
- *
314
- * Required parameters:
315
- * - `sessionId` - (string) ID of session to update
316
- *
317
- * Optional parameters:
318
- * - `tags` - (string[]) New tags for the session
319
- * - `contactId` - (string) Updated contact ID
320
- * - `meta` - (object) Updated metadata
321
- * - `timeout` - (number) Request timeout in milliseconds
322
- * - `version` - (string | number) API version to use
323
- *
324
- * @returns {Promise<Session>} Promise resolving to updated session
325
- *
326
- * @example
327
- * ```typescript
328
- * const session = await hitlApi.sessions.updateSession({
329
- * sessionId: 'session-id',
330
- * tags: ['support'],
331
- * meta: {
332
- * status: 'in-progress',
333
- * priority: 'high',
334
- * notes: 'Customer requesting callback'
335
- * }
336
- * });
337
- * ```
338
- *
339
- * @remarks Makes a PUT request to `/sessions/{sessionId}`
340
- */
341
23
  static updateSession({ sessionId, tags, contactId, meta, ...options }: UpdateSessionOptions): Promise<Session>;
342
- /**
343
- * Creates multiple sessions in bulk
344
- *
345
- * @param options - Bulk creation configuration including session details
346
- *
347
- * Required parameters:
348
- * - `sessions` - ({@link Session}[]) Array of session configurations to create
349
- *
350
- * Optional parameters:
351
- * - `timeout` - (number) Request timeout in milliseconds
352
- * - `version` - (string | number) API version to use
353
- *
354
- * @returns {Promise<CreateSessionsResponse>} Promise resolving to creation results
355
- *
356
- * @example
357
- * ```typescript
358
- * const created = await hitlApi.sessions.createSessions({
359
- * sessions: [
360
- * {
361
- * hitlSessionId: 'session-id',
362
- * contactId: 'contact-id-1',
363
- * status: 'CLOSED',
364
- * isArchived: true,
365
- * createdAt: new Date('1971'),
366
- * ruleTags: ['sms'],
367
- * },
368
- * {
369
- * contactId: 'contact-id-2',
370
- * status: 'ONGOING',
371
- * ruleTags: ['voice'],
372
- * },
373
- * ]
374
- * });
375
- * ```
376
- *
377
- * @remarks Makes a POST request to `/sessions`
378
- */
379
24
  static createSessions({ sessions, ...options }: CreateSessionsOptions): Promise<CreateSessionsResponse>;
380
- /**
381
- * Closes an active session
382
- *
383
- * @param options - Close configuration including session identifier
384
- *
385
- * Required parameters:
386
- * - `sessionId` - (string) ID of session to close
387
- *
388
- * Optional parameters:
389
- * - `timeout` - (number) Request timeout in milliseconds
390
- * - `version` - (string | number) API version to use
391
- *
392
- * @returns {Promise<Session>} Promise resolving to closed session
393
- *
394
- * @example
395
- * ```typescript
396
- * // Close a session
397
- * const session = await hitlApi.sessions.closeSession({
398
- * sessionId: 'session-id'
399
- * });
400
- * ```
401
- *
402
- * @remarks Makes a POST request to `sessions/{sessionId}/close`
403
- */
404
25
  static closeSession(options: CloseSessionOptions): Promise<Session>;
405
- /**
406
- * Reopens a previously closed session
407
- *
408
- * @param options - Reopen configuration including session identifier
409
- *
410
- * Required parameters:
411
- * - `sessionId` - (string) ID of session to reopen
412
- *
413
- * Optional parameters:
414
- * - `timeout` - (number) Request timeout in milliseconds
415
- * - `version` - (string | number) API version to use
416
- *
417
- * @returns {Promise<Session>} Promise resolving to reopened session
418
- *
419
- * @example
420
- * ```typescript
421
- * // Reopen a session
422
- * const session = await hitlApi.sessions.reopenSession({
423
- * sessionId: 'session-id'
424
- * });
425
- * ```
426
- *
427
- * @remarks Makes a POST request to `/sessions/{sessionId}/reopen`
428
- */
429
26
  static reopenSession(options: ReopenSessionOptions): Promise<Session>;
430
- /**
431
- * Deletes a closed session
432
- *
433
- * @param options - Delete configuration including session identifier
434
- *
435
- * Required parameters:
436
- * - `sessionId` - (string) ID of session to delete
437
- *
438
- * Optional parameters:
439
- * - `timeout` - (number) Request timeout in milliseconds
440
- * - `version` - (string | number) API version to use
441
- *
442
- * @returns {Promise<void>} Promise resolving when deletion is complete
443
- *
444
- * @example
445
- * ```typescript
446
- * // Delete a closed session
447
- * await hitlApi.sessions.deleteClosedSession({
448
- * sessionId: 'session-id'
449
- * });
450
- * ```
451
- *
452
- * @remarks Makes a DELETE request to `/sessions/{sessionId}`
453
- */
454
27
  static deleteClosedSession(options: DeleteClosedSessionOptions): Promise<unknown>;
455
- /**
456
- * @deprecated Use bulkDeleteSessions instead
457
- */
458
28
  static buldDeleteSessions({ sessionIds, ...options }: BulkDeleteSessionsOptions): Promise<unknown>;
459
- /**
460
- * Deletes multiple sessions in bulk
461
- *
462
- * @param options - Bulk deletion configuration including session identifiers
463
- *
464
- * Required parameters:
465
- * - `sessionIds` - (string[]) Array of session IDs to delete
466
- *
467
- * Optional parameters:
468
- * - `timeout` - (number) Request timeout in milliseconds
469
- * - `version` - (string | number) API version to use
470
- *
471
- * @returns {Promise<void>} Promise resolving when deletion is complete
472
- * @remarks Makes a DELETE request to `/api/v2/hitl/sessions`
473
- *
474
- * @example
475
- * ```typescript
476
- * // Delete multiple sessions
477
- * await hitlApi.sessions.bulkDeleteSessions({
478
- * sessionIds: ['session-id-1', 'session-id-2', 'session-id-3']
479
- * });
480
- * ```
481
- */
482
29
  static bulkDeleteSessions({ sessionIds, ...options }: BulkDeleteSessionsOptions): Promise<unknown>;
483
30
  }
484
31
  //# sourceMappingURL=Sessions.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"Sessions.d.ts","sourceRoot":"","sources":["../../../src/api/Sessions.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"Sessions.d.ts","sourceRoot":"","sources":["../../../src/api/Sessions.ts"],"names":[],"mappings":"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"}