o2g-node-sdk 2.5.5 → 2.5.6

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.
Files changed (36) hide show
  1. package/README.md +5 -0
  2. package/dist/o2g-node-sdk.js +799 -693
  3. package/dist/o2g-node-sdk.js.map +1 -1
  4. package/dist/types/services/o2g-analytics.d.ts +40 -31
  5. package/dist/types/services/o2g-analytics.d.ts.map +1 -1
  6. package/dist/types/services/o2g-cc-agent.d.ts +11 -7
  7. package/dist/types/services/o2g-cc-agent.d.ts.map +1 -1
  8. package/dist/types/services/o2g-cc-mngt.d.ts +61 -40
  9. package/dist/types/services/o2g-cc-mngt.d.ts.map +1 -1
  10. package/dist/types/services/o2g-cc-pilot.d.ts +7 -5
  11. package/dist/types/services/o2g-cc-pilot.d.ts.map +1 -1
  12. package/dist/types/services/o2g-cc-rt.d.ts +4 -3
  13. package/dist/types/services/o2g-cc-rt.d.ts.map +1 -1
  14. package/dist/types/services/o2g-cc-stat.d.ts +160 -163
  15. package/dist/types/services/o2g-cc-stat.d.ts.map +1 -1
  16. package/dist/types/services/o2g-comlog.d.ts +68 -67
  17. package/dist/types/services/o2g-comlog.d.ts.map +1 -1
  18. package/dist/types/services/o2g-directory.d.ts +35 -40
  19. package/dist/types/services/o2g-directory.d.ts.map +1 -1
  20. package/dist/types/services/o2g-eventSummary.d.ts +7 -8
  21. package/dist/types/services/o2g-eventSummary.d.ts.map +1 -1
  22. package/dist/types/services/o2g-maint.d.ts +10 -10
  23. package/dist/types/services/o2g-messaging.d.ts +3 -2
  24. package/dist/types/services/o2g-messaging.d.ts.map +1 -1
  25. package/dist/types/services/o2g-routing.d.ts +37 -19
  26. package/dist/types/services/o2g-routing.d.ts.map +1 -1
  27. package/dist/types/services/o2g-rsi.d.ts +62 -54
  28. package/dist/types/services/o2g-rsi.d.ts.map +1 -1
  29. package/dist/types/services/o2g-telephony.d.ts +255 -224
  30. package/dist/types/services/o2g-telephony.d.ts.map +1 -1
  31. package/dist/types/services/o2g-users-mngt.d.ts +21 -13
  32. package/dist/types/services/o2g-users-mngt.d.ts.map +1 -1
  33. package/dist/types/services/o2g-users.d.ts +8 -5
  34. package/dist/types/services/o2g-users.d.ts.map +1 -1
  35. package/dist/types/types/telephony/call/ccd/call-profile.d.ts.map +1 -1
  36. package/package.json +2 -2
@@ -4,9 +4,17 @@ import { QueryFilter } from '../types/comlog/query-filter';
4
4
  import { QueryResult } from '../types/comlog/query-result';
5
5
  import { ComRecord } from '../types/comlog/com-record';
6
6
  /**
7
- * The CommunicationLog service allows a user to retrieve their last communication
8
- * history records and to manage them. Using this service requires having a
7
+ * The CommunicationLog service provides operations to retrieve, manage, and manipulate
8
+ * a user's communication log (com records). Using this service requires having a
9
9
  * <b>TELEPHONY_ADVANCED</b> license.
10
+ * <p>
11
+ * Communication records are generated by the O2G server and provide detailed information
12
+ * about calls, participants, call outcomes, and durations. The communication log has a
13
+ * depth of 100 records maximum per user; when the limit is reached, the oldest records
14
+ * are removed.
15
+ * <p>
16
+ * Acknowledgement and unacknowledgement of an incoming missed call using O2G is
17
+ * <b>NOT synchronized</b> with the OmniPCX Enterprise.
10
18
  *
11
19
  * @example
12
20
  * ```typescript
@@ -64,20 +72,19 @@ export declare class CommunicationLog extends EventEmitter {
64
72
  */
65
73
  static readonly ON_COM_RECORDS_UNACK = "OnComRecordsUnAck";
66
74
  /**
67
- * Gets the com records corresponding to the specified filter, using the
68
- * specified page, with a possible optimization.
75
+ * Retrieves communication records based on the specified filter, with pagination
76
+ * support and optional optimization.
69
77
  * <p>
70
- * If `optimized` is set to `true`, the query returns the full identity of a
71
- * participant only the first time it occurs, when the same participant appears
72
- * in several records. When omitted, records are returned with no optimization.
78
+ * If `optimized` is set to `true`, the full identity of a participant is returned
79
+ * only the first time it appears in the records. Subsequent occurrences of the same
80
+ * participant will only include minimal identification (e.g., phone number).
73
81
  * <p>
74
- * The `page` parameter allows querying the communication log by page. The
75
- * {@link QueryResult} contains the same parameters and the total number of
76
- * records retrieved by the query.
82
+ * The `page` parameter allows querying the communication log page by page. The
83
+ * {@link QueryResult} includes the records, paging information, and the total number
84
+ * of matching records.
77
85
  * <p>
78
- * If the session has been opened for a user, the `loginName` parameter is
79
- * ignored, but it is mandatory if the session has been opened by an
80
- * administrator.
86
+ * If the session has been opened for a user, the `loginName` parameter is ignored,
87
+ * but it is mandatory if the session has been opened by an administrator.
81
88
  *
82
89
  * @example
83
90
  * ```typescript
@@ -96,65 +103,63 @@ export declare class CommunicationLog extends EventEmitter {
96
103
  *
97
104
  * @param filter the filter describing the query criteria
98
105
  * @param page the page description
99
- * @param optimized `true` to activate optimization
100
- * @param loginName the user login name
106
+ * @param optimized `true` to enable optimization
107
+ * @param loginName the target user's login name
101
108
  * @returns the {@link QueryResult} on success; `null` otherwise.
102
109
  */
103
110
  getComRecords(filter?: QueryFilter | null, page?: Page | null, optimized?: boolean, loginName?: string | null): Promise<QueryResult | null>;
104
111
  /**
105
- * Gets the specified com record.
112
+ * Retrieves the communication record with the specified identifier.
106
113
  * <p>
107
- * If the session has been opened for a user, the `loginName` parameter is
108
- * ignored, but it is mandatory if the session has been opened by an
109
- * administrator.
114
+ * If the session has been opened for a user, the `loginName` parameter is ignored,
115
+ * but it is mandatory if the session has been opened by an administrator.
110
116
  *
111
117
  * @param recordId the com record identifier
112
- * @param loginName the user login name
118
+ * @param loginName the target user's login name
113
119
  * @returns the {@link ComRecord} on success; `null` otherwise.
114
120
  */
115
121
  getComRecord(recordId: string, loginName?: string | null): Promise<ComRecord | null>;
116
122
  /**
117
- * Deletes the specified com record.
123
+ * Deletes the communication record with the specified identifier.
118
124
  * <p>
119
- * If the session has been opened for a user, the `loginName` parameter is
120
- * ignored, but it is mandatory if the session has been opened by an
121
- * administrator.
125
+ * An {@link ON_COM_RECORDS_DELETED} event is raised when the deletion succeeds.
126
+ * <p>
127
+ * If the session has been opened for a user, the `loginName` parameter is ignored,
128
+ * but it is mandatory if the session has been opened by an administrator.
122
129
  *
123
130
  * @param recordId the com record identifier
124
- * @param loginName the user login name
131
+ * @param loginName the target user's login name
125
132
  * @returns `true` if the operation succeeded; `false` otherwise.
126
133
  * @see deleteComRecordsById
127
134
  * @see deleteComRecords
128
135
  */
129
136
  deleteComRecord(recordId: string, loginName?: string | null): Promise<boolean>;
130
137
  /**
131
- * Deletes the specified list of com records.
138
+ * Deletes the communication records with the specified identifiers.
132
139
  * <p>
133
- * An {@link ON_COM_RECORDS_DELETED} event is raised containing the list of
134
- * com records that have been deleted.
140
+ * An {@link ON_COM_RECORDS_DELETED} event is raised listing the com records that
141
+ * have been deleted.
135
142
  * <p>
136
- * If the session has been opened for a user, the `loginName` parameter is
137
- * ignored, but it is mandatory if the session has been opened by an
138
- * administrator.
143
+ * If the session has been opened for a user, the `loginName` parameter is ignored,
144
+ * but it is mandatory if the session has been opened by an administrator.
139
145
  *
140
146
  * @param recordIds the list of com record identifiers to delete
141
- * @param loginName the user login name
147
+ * @param loginName the target user's login name
142
148
  * @returns `true` if the operation succeeded; `false` otherwise.
143
149
  * @see deleteComRecord
144
150
  * @see deleteComRecords
145
151
  */
146
152
  deleteComRecordsById(recordIds: string[], loginName?: string | null): Promise<boolean>;
147
153
  /**
148
- * Deletes the com records corresponding to the given filter.
154
+ * Deletes the communication records matching the specified filter.
149
155
  * <p>
150
156
  * The `filter` parameter defines the search criteria for the delete operation.
151
157
  * <p>
152
- * An {@link ON_COM_RECORDS_DELETED} event is raised containing the list of
153
- * com records that have been deleted.
158
+ * An {@link ON_COM_RECORDS_DELETED} event is raised listing the com records that
159
+ * have been deleted.
154
160
  * <p>
155
- * If the session has been opened for a user, the `loginName` parameter is
156
- * ignored, but it is mandatory if the session has been opened by an
157
- * administrator.
161
+ * If the session has been opened for a user, the `loginName` parameter is ignored,
162
+ * but it is mandatory if the session has been opened by an administrator.
158
163
  *
159
164
  * @example
160
165
  * ```typescript
@@ -171,72 +176,68 @@ export declare class CommunicationLog extends EventEmitter {
171
176
  * ```
172
177
  *
173
178
  * @param filter the filter describing the query criteria
174
- * @param loginName the user login name
179
+ * @param loginName the target user's login name
175
180
  * @returns `true` if the operation succeeded; `false` otherwise.
176
181
  * @see deleteComRecord
177
182
  * @see deleteComRecordsById
178
183
  */
179
184
  deleteComRecords(filter?: QueryFilter | null, loginName?: string | null): Promise<boolean>;
180
185
  /**
181
- * Acknowledges the specified list of com records.
186
+ * Acknowledges the communication records with the specified identifiers.
182
187
  * <p>
183
- * An {@link ON_COM_RECORDS_ACK} event is raised containing the list of
184
- * com records that have been acknowledged.
188
+ * An {@link ON_COM_RECORDS_ACK} event is raised listing the com records that
189
+ * have been acknowledged.
185
190
  * <p>
186
- * If the session has been opened for a user, the `loginName` parameter is
187
- * ignored, but it is mandatory if the session has been opened by an
188
- * administrator.
191
+ * If the session has been opened for a user, the `loginName` parameter is ignored,
192
+ * but it is mandatory if the session has been opened by an administrator.
189
193
  *
190
194
  * @param recordIds the list of com record identifiers to acknowledge
191
- * @param loginName the user login name
195
+ * @param loginName the target user's login name
192
196
  * @returns `true` if the operation succeeded; `false` otherwise.
193
197
  * @see acknowledgeComRecord
194
198
  */
195
199
  acknowledgeComRecords(recordIds: string[], loginName?: string | null): Promise<boolean>;
196
200
  /**
197
- * Acknowledges the specified com record.
201
+ * Acknowledges the communication record with the specified identifier.
198
202
  * <p>
199
- * An {@link ON_COM_RECORDS_ACK} event is raised containing the list of
200
- * com records that have been acknowledged.
203
+ * An {@link ON_COM_RECORDS_ACK} event is raised listing the com records that
204
+ * have been acknowledged.
201
205
  * <p>
202
- * If the session has been opened for a user, the `loginName` parameter is
203
- * ignored, but it is mandatory if the session has been opened by an
204
- * administrator.
206
+ * If the session has been opened for a user, the `loginName` parameter is ignored,
207
+ * but it is mandatory if the session has been opened by an administrator.
205
208
  *
206
209
  * @param recordId the com record identifier
207
- * @param loginName the user login name
210
+ * @param loginName the target user's login name
208
211
  * @returns `true` if the operation succeeded; `false` otherwise.
209
212
  * @see acknowledgeComRecords
210
213
  */
211
214
  acknowledgeComRecord(recordId: string, loginName?: string | null): Promise<boolean>;
212
215
  /**
213
- * Unacknowledges the specified list of com records.
216
+ * Unacknowledges the communication records with the specified identifiers.
214
217
  * <p>
215
- * An {@link ON_COM_RECORDS_UNACK} event is raised containing the list of
216
- * com records that have been unacknowledged.
218
+ * An {@link ON_COM_RECORDS_UNACK} event is raised listing the com records that
219
+ * have been unacknowledged.
217
220
  * <p>
218
- * If the session has been opened for a user, the `loginName` parameter is
219
- * ignored, but it is mandatory if the session has been opened by an
220
- * administrator.
221
+ * If the session has been opened for a user, the `loginName` parameter is ignored,
222
+ * but it is mandatory if the session has been opened by an administrator.
221
223
  *
222
224
  * @param recordIds the list of com record identifiers to unacknowledge
223
- * @param loginName the user login name
225
+ * @param loginName the target user's login name
224
226
  * @returns `true` if the operation succeeded; `false` otherwise.
225
227
  * @see unacknowledgeComRecord
226
228
  */
227
229
  unacknowledgeComRecords(recordIds: string[], loginName?: string | null): Promise<boolean>;
228
230
  /**
229
- * Unacknowledges the specified com record.
231
+ * Unacknowledges the communication record with the specified identifier.
230
232
  * <p>
231
- * An {@link ON_COM_RECORDS_UNACK} event is raised containing the list of
232
- * com records that have been unacknowledged.
233
+ * An {@link ON_COM_RECORDS_UNACK} event is raised listing the com records that
234
+ * have been unacknowledged.
233
235
  * <p>
234
- * If the session has been opened for a user, the `loginName` parameter is
235
- * ignored, but it is mandatory if the session has been opened by an
236
- * administrator.
236
+ * If the session has been opened for a user, the `loginName` parameter is ignored,
237
+ * but it is mandatory if the session has been opened by an administrator.
237
238
  *
238
239
  * @param recordId the com record identifier
239
- * @param loginName the user login name
240
+ * @param loginName the target user's login name
240
241
  * @returns `true` if the operation succeeded; `false` otherwise.
241
242
  * @see unacknowledgeComRecords
242
243
  */
@@ -1 +1 @@
1
- {"version":3,"file":"o2g-comlog.d.ts","sourceRoot":"","sources":["../../../src/services/o2g-comlog.ts"],"names":[],"mappings":"AAmBA,OAAO,YAAY,MAAM,QAAQ,CAAC;AAElC,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAS3D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;;IAG9C;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,qBAAqB,wBAAwB;IAE7D;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,sBAAsB,yBAAyB;IAE/D;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,sBAAsB,yBAAyB;IAE/D;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,kBAAkB,qBAAqB;IAEvD;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,oBAAoB,uBAAuB;IAgB3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACG,aAAa,CACf,MAAM,GAAE,WAAW,GAAG,IAAW,EACjC,IAAI,GAAE,IAAI,GAAG,IAAW,EACxB,SAAS,GAAE,OAAe,EAC1B,SAAS,GAAE,MAAM,GAAG,IAAW,GAChC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAI9B;;;;;;;;;;OAUG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAIhG;;;;;;;;;;;;OAYG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1F;;;;;;;;;;;;;;;OAeG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACG,gBAAgB,CAAC,MAAM,GAAE,WAAW,GAAG,IAAW,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5G;;;;;;;;;;;;;;OAcG;IACG,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAInG;;;;;;;;;;;;;;OAcG;IACG,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/F;;;;;;;;;;;;;;OAcG;IACG,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrG;;;;;;;;;;;;;;OAcG;IACG,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,CAAC;CAGpG"}
1
+ {"version":3,"file":"o2g-comlog.d.ts","sourceRoot":"","sources":["../../../src/services/o2g-comlog.ts"],"names":[],"mappings":"AAmBA,OAAO,YAAY,MAAM,QAAQ,CAAC;AAElC,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAS3D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;;IAG9C;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,qBAAqB,wBAAwB;IAE7D;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,sBAAsB,yBAAyB;IAE/D;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,sBAAsB,yBAAyB;IAE/D;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,kBAAkB,qBAAqB;IAEvD;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,oBAAoB,uBAAuB;IAgB3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACG,aAAa,CACf,MAAM,GAAE,WAAW,GAAG,IAAW,EACjC,IAAI,GAAE,IAAI,GAAG,IAAW,EACxB,SAAS,GAAE,OAAe,EAC1B,SAAS,GAAE,MAAM,GAAG,IAAW,GAChC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAI9B;;;;;;;;;OASG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAIhG;;;;;;;;;;;;;OAaG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1F;;;;;;;;;;;;;;OAcG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,gBAAgB,CAAC,MAAM,GAAE,WAAW,GAAG,IAAW,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5G;;;;;;;;;;;;;OAaG;IACG,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAInG;;;;;;;;;;;;;OAaG;IACG,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/F;;;;;;;;;;;;;OAaG;IACG,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrG;;;;;;;;;;;;;OAaG;IACG,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,CAAC;CAGpG"}
@@ -1,36 +1,36 @@
1
1
  import { Criteria } from '../types/directory/criteria';
2
2
  import { SearchResult } from '../types/directory/search-result';
3
3
  /**
4
- * The DirectoryService is used to search contacts in the OmniPCX
5
- * Enterprise phone book. Using this service requires having a
6
- * <b>TELEPHONY_ADVANCED</b> license.
4
+ * The Directory service allows searching for contacts in the OmniPCX Enterprise
5
+ * phone book. Using this service requires having a <b>TELEPHONY_ADVANCED</b> license.
7
6
  * <p>
8
- * A directory search is a set of 2 or more sequential operations:
7
+ * A directory search involves a sequence of operations:
9
8
  * <ol>
10
- * <li>The first operation initiates the search with a set of criteria.</li>
11
- * <li>The second and subsequent operations retrieve results.</li>
9
+ * <li>Initiate the search with a set of criteria.</li>
10
+ * <li>Retrieve results using one or more subsequent calls to {@link getResults}.</li>
12
11
  * </ol>
13
12
  * <p>
14
- * Note: For each session (user or administrator), only 5 concurrent searches
15
- * are authorized. An unused search context is freed after 1 minute.
13
+ * Note: For each session (user or administrator), only 5 concurrent searches are
14
+ * allowed. An unused search context is automatically freed after 1 minute.
16
15
  *
17
16
  * @example
18
17
  * ```typescript
19
- * await o2g.directory.search(myCriteria);
20
- * while (!finished) {
21
- * let result = await o2g.directory.getResults();
22
- * if (result.getResultCode() == SearchResult.ResultCode.NOK) {
23
- * // Wait for results
24
- * }
25
- * else if ((result.getResultCode() == SearchResult.ResultCode.FINISH) ||
26
- * (result.getResultCode() == SearchResult.ResultCode.TIMEOUT)) {
27
- * // Exit the loop
28
- * finished = true;
29
- * }
30
- * else {
31
- * // Process results
32
- * }
33
- * }
18
+ * await O2G.directory.search(myCriteria);
19
+ *
20
+ * let finished = false;
21
+ * while (!finished) {
22
+ * const result = await O2G.directory.getResults();
23
+ * if (result?.resultCode === SearchResult.ResultCode.NOK) {
24
+ * // Search still in progress, wait before retrying
25
+ * await new Promise(resolve => setTimeout(resolve, 500));
26
+ * } else if (result?.resultCode === SearchResult.ResultCode.OK) {
27
+ * // Process available results
28
+ * result.items.forEach(item => console.log(item.firstName, item.lastName));
29
+ * } else {
30
+ * // FINISH or TIMEOUT — search is complete
31
+ * finished = true;
32
+ * }
33
+ * }
34
34
  * ```
35
35
  */
36
36
  export declare class Directory {
@@ -40,12 +40,11 @@ export declare class Directory {
40
40
  * specified number of results.
41
41
  * <p>
42
42
  * If the session has been opened for a user, the `loginName` parameter is
43
- * ignored, but it is mandatory if the session has been opened by an
44
- * administrator.
43
+ * ignored, but it is mandatory if the session has been opened by an administrator.
45
44
  *
46
45
  * @param filter the search filter
47
- * @param limit maximum number of results, in the range [1..100]
48
- * @param loginName the user login name
46
+ * @param limit the maximum number of results, in the range [1..100]
47
+ * @param loginName the target user's login name
49
48
  * @returns `true` if the search was successfully initiated; `false` otherwise.
50
49
  * @see getResults
51
50
  * @see cancel
@@ -55,28 +54,26 @@ export declare class Directory {
55
54
  * Cancels the current search query for the specified user.
56
55
  * <p>
57
56
  * If the session has been opened for a user, the `loginName` parameter is
58
- * ignored, but it is mandatory if the session has been opened by an
59
- * administrator.
57
+ * ignored, but it is mandatory if the session has been opened by an administrator.
60
58
  *
61
- * @param loginName the user login name
62
- * @returns `true` if the operation succeeded; `false` otherwise.
59
+ * @param loginName the target user's login name
60
+ * @returns `true` if the search was successfully cancelled; `false` otherwise.
63
61
  * @see search
64
62
  */
65
63
  cancel(loginName?: string | null): Promise<boolean>;
66
64
  /**
67
- * Gets the next available results for the current search.
65
+ * Retrieves the next available results for the current search.
68
66
  * <p>
69
67
  * `getResults` is generally called in a loop. For each iteration:
70
68
  * <ul>
71
69
  * <li>if the result code is `NOK`, the search is in progress but no results are
72
- * available — it is recommended to wait before the next iteration (e.g. 500ms)</li>
70
+ * available yet — it is recommended to wait before the next iteration (e.g., 500ms)</li>
73
71
  * <li>if the result code is `OK`, results are available and can be processed</li>
74
72
  * <li>if the result code is `FINISH` or `TIMEOUT`, the search has ended — exit the loop</li>
75
73
  * </ul>
76
74
  * <p>
77
75
  * If the session has been opened for a user, the `loginName` parameter is
78
- * ignored, but it is mandatory if the session has been opened by an
79
- * administrator.
76
+ * ignored, but it is mandatory if the session has been opened by an administrator.
80
77
  *
81
78
  * @example
82
79
  * ```typescript
@@ -88,19 +85,17 @@ export declare class Directory {
88
85
  * if (result?.resultCode === SearchResult.ResultCode.NOK) {
89
86
  * // Search still in progress, wait before retrying
90
87
  * await new Promise(resolve => setTimeout(resolve, 500));
91
- * }
92
- * else if (result?.resultCode === SearchResult.ResultCode.OK) {
88
+ * } else if (result?.resultCode === SearchResult.ResultCode.OK) {
93
89
  * // Process available results
94
90
  * result.items.forEach(item => console.log(item.firstName, item.lastName));
95
- * }
96
- * else {
91
+ * } else {
97
92
  * // FINISH or TIMEOUT — search is complete
98
93
  * finished = true;
99
94
  * }
100
95
  * }
101
96
  * ```
102
97
  *
103
- * @param loginName the user login name
98
+ * @param loginName the target user's login name
104
99
  * @returns the {@link SearchResult} on success; `null` otherwise.
105
100
  * @see search
106
101
  */
@@ -1 +1 @@
1
- {"version":3,"file":"o2g-directory.d.ts","sourceRoot":"","sources":["../../../src/services/o2g-directory.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,SAAS;;IAUlB;;;;;;;;;;;;;;OAcG;IACG,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,GAAE,MAAM,GAAG,IAAW,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9G;;;;;;;;;;OAUG;IACG,MAAM,CAAC,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACG,UAAU,CAAC,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;CAGlF"}
1
+ {"version":3,"file":"o2g-directory.d.ts","sourceRoot":"","sources":["../../../src/services/o2g-directory.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,SAAS;;IAUlB;;;;;;;;;;;;;OAaG;IACG,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,GAAE,MAAM,GAAG,IAAW,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9G;;;;;;;;;OASG;IACG,MAAM,CAAC,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACG,UAAU,CAAC,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;CAGlF"}
@@ -1,10 +1,10 @@
1
1
  import { EventEmitter } from 'events';
2
2
  import { EventSummaryCounters } from '../types/eventsummary/event-summary-counter';
3
3
  /**
4
- * The Event summary service allows a user to get its new message
5
- * indicators (missed call, voice mails, callback request, fax).
4
+ * The EventSummary service allows a user to retrieve new message indicators
5
+ * such as missed calls, voice mails, callback requests, and faxes.
6
6
  * <p>
7
- * Using this service requires having a <b>TELEPHONY_ADVANCED</b> license.
7
+ * Using this service requires a <b>TELEPHONY_ADVANCED</b> license.
8
8
  *
9
9
  * @example
10
10
  * ```typescript
@@ -25,19 +25,18 @@ import { EventSummaryCounters } from '../types/eventsummary/event-summary-counte
25
25
  export declare class EventSummary extends EventEmitter {
26
26
  #private;
27
27
  /**
28
- * Event raised each time the user's counters have changed.
28
+ * Occurs each time the user's event counters have changed.
29
29
  * @event
30
30
  */
31
31
  static readonly ON_EVENT_SUMMARY_UPDATED = "OnEventSummaryUpdated";
32
32
  /**
33
- * Retrieves main counters for the specified user.
33
+ * Retrieves the main event counters for the specified user.
34
34
  * <p>
35
35
  * If the session has been opened for a user, the `loginName` parameter is
36
- * ignored, but it is mandatory if the session has been opened by an
37
- * administrator.
36
+ * ignored, but it is mandatory if the session has been opened by an administrator.
38
37
  *
39
38
  * @param loginName the user login name
40
- * @returns the {@link EventSummaryCounters} on success; `null` otherwise.
39
+ * @returns the {@link EventSummaryCounters} containing the event counters on success; `null` otherwise
41
40
  */
42
41
  get(loginName?: string | null): Promise<EventSummaryCounters | null>;
43
42
  }
@@ -1 +1 @@
1
- {"version":3,"file":"o2g-eventSummary.d.ts","sourceRoot":"","sources":["../../../src/services/o2g-eventSummary.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAEnF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,YAAa,SAAQ,YAAY;;IAG1C;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,wBAAwB,2BAA2B;IAYnE;;;;;;;;;OASG;IACH,GAAG,CAAC,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;CAG7E"}
1
+ {"version":3,"file":"o2g-eventSummary.d.ts","sourceRoot":"","sources":["../../../src/services/o2g-eventSummary.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAEnF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,YAAa,SAAQ,YAAY;;IAG1C;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,wBAAwB,2BAA2B;IAYnE;;;;;;;;OAQG;IACH,GAAG,CAAC,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;CAG7E"}
@@ -1,12 +1,12 @@
1
1
  import EventEmitter from 'events';
2
2
  import { SystemStatus } from '../types/maint/sys-status';
3
3
  /**
4
- * The MaintenanceService allows retrieving information about the system state,
5
- * in particular information on the PBX nodes and their connection state.
4
+ * The Maintenance service provides information about the system state,
5
+ * in particular information on the OmniPCX Enterprise nodes and their connection state.
6
6
  * Information about licenses is also provided per item: total allocated licenses,
7
7
  * number currently in use, and expiration date.
8
8
  * <p>
9
- * This service is available to administrator sessions only.
9
+ * This service does not require any specific license on the O2G server.
10
10
  *
11
11
  * @example
12
12
  * ```typescript
@@ -35,12 +35,12 @@ import { SystemStatus } from '../types/maint/sys-status';
35
35
  export declare class Maintenance extends EventEmitter {
36
36
  #private;
37
37
  /**
38
- * Occurs when connection to remote twin server is lost.
38
+ * Occurs when the connection to the remote twin O2G server is lost.
39
39
  * @event
40
40
  */
41
41
  static readonly ON_REMOTE_SERVER_LINK_DOWN = "OnRemoteServerLinkDown";
42
42
  /**
43
- * Occurs when connection to remote twin server is recovered.
43
+ * Occurs when the connection to the remote twin O2G server is recovered.
44
44
  * @event
45
45
  */
46
46
  static readonly ON_REMOTE_SERVER_LINK_UP = "OnRemoteServerLinkUp";
@@ -55,12 +55,12 @@ export declare class Maintenance extends EventEmitter {
55
55
  */
56
56
  static readonly ON_CTI_LINK_UP = "OnCtiLinkUp";
57
57
  /**
58
- * Occurs when a PBX link is down.
58
+ * Occurs when the CMIS link to an OmniPCX Enterprise node goes down.
59
59
  * @event
60
60
  */
61
61
  static readonly ON_PBX_LINK_DOWN = "OnPbxLinkDown";
62
62
  /**
63
- * Occurs when a PBX link is up.
63
+ * Occurs when the CMIS link to an OmniPCX Enterprise node is re-established.
64
64
  * @event
65
65
  */
66
66
  static readonly ON_PBX_LINK_UP = "OnPbxLinkUp";
@@ -70,12 +70,12 @@ export declare class Maintenance extends EventEmitter {
70
70
  */
71
71
  static readonly ON_PBX_LOADED = "OnPbxLoaded";
72
72
  /**
73
- * Occurs when the license file will soon expire or has recently expired.
73
+ * Occurs when a license is about to expire or has expired.
74
74
  * @event
75
75
  */
76
76
  static readonly ON_LICENSE_EXPIRATION = "OnLicenseExpiration";
77
77
  /**
78
- * Occurs when O2G is ready (all OXE nodes are connected and loaded).
78
+ * Occurs when the O2G server has started (all OmniPCX Enterprise nodes are connected and loaded).
79
79
  * @event
80
80
  */
81
81
  static readonly ON_SERVER_STARTED = "OnServerStart";
@@ -85,7 +85,7 @@ export declare class Maintenance extends EventEmitter {
85
85
  * <p>
86
86
  * This operation is restricted to an administrator session only.
87
87
  *
88
- * @returns the {@link SystemStatus} on success; `null` otherwise.
88
+ * @returns the {@link SystemStatus} on success; `null` otherwise
89
89
  */
90
90
  getSystemStatus(): Promise<SystemStatus | null>;
91
91
  }
@@ -7,7 +7,8 @@ import { VoiceMessage } from '../types/messaging/voice-message';
7
7
  * the information and the list of voice mails, and manage the mail box. Using
8
8
  * this service requires having a <b>TELEPHONY_ADVANCED</b> license.
9
9
  * <p>
10
- * It is possible to download a voice mail as a wav file and to delete existing messages.
10
+ * It is possible to download a voice mail as a wav file, acknowledge (mark as
11
+ * read) a voice mail, and delete existing messages.
11
12
  */
12
13
  export declare class Messaging {
13
14
  #private;
@@ -81,7 +82,7 @@ export declare class Messaging {
81
82
  */
82
83
  deleteVoiceMessage(mailboxId: string, voicemailId: string, loginName?: string | null): Promise<boolean>;
83
84
  /**
84
- * Acknowledges the specified voice message.
85
+ * Acknowledges the specified voice message, marking it as read.
85
86
  * <p>
86
87
  * If the session has been opened for a user, the `loginName` parameter is
87
88
  * ignored, but it is mandatory if the session has been opened by an
@@ -1 +1 @@
1
- {"version":3,"file":"o2g-messaging.d.ts","sourceRoot":"","sources":["../../../src/services/o2g-messaging.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE;;;;;;;GAOG;AACH,qBAAa,SAAS;;IAUlB;;;;;;;;;;OAUG;IACG,YAAY,CAAC,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;IAI9E;;;;;;;;;;;;;;;OAeG;IACG,cAAc,CAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAM,GAAG,IAAW,EAC9B,SAAS,GAAE,MAAM,GAAG,IAAW,GAChC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAI9B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,gBAAgB,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,OAAe,EACxB,MAAM,GAAE,MAAM,GAAG,IAAW,EAC5B,KAAK,GAAE,MAAM,GAAG,IAAW,EAC3B,SAAS,GAAE,MAAM,GAAG,IAAW,GAChC,OAAO,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC;IAIjC;;;;;;;;;;;;OAYG;IACG,kBAAkB,CACpB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,MAAM,GAAG,IAAW,GAChC,OAAO,CAAC,OAAO,CAAC;IAInB;;;;;;;;;;;OAWG;IACG,uBAAuB,CACzB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,MAAM,GAAG,IAAW,GAChC,OAAO,CAAC,OAAO,CAAC;IAInB;;;;;;;;;;;;OAYG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjH;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,oBAAoB,CACtB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,GAAE,MAAM,GAAG,IAAW,GAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAG5B"}
1
+ {"version":3,"file":"o2g-messaging.d.ts","sourceRoot":"","sources":["../../../src/services/o2g-messaging.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE;;;;;;;;GAQG;AACH,qBAAa,SAAS;;IAUlB;;;;;;;;;;OAUG;IACG,YAAY,CAAC,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;IAI9E;;;;;;;;;;;;;;;OAeG;IACG,cAAc,CAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAM,GAAG,IAAW,EAC9B,SAAS,GAAE,MAAM,GAAG,IAAW,GAChC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAI9B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,gBAAgB,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,OAAe,EACxB,MAAM,GAAE,MAAM,GAAG,IAAW,EAC5B,KAAK,GAAE,MAAM,GAAG,IAAW,EAC3B,SAAS,GAAE,MAAM,GAAG,IAAW,GAChC,OAAO,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC;IAIjC;;;;;;;;;;;;OAYG;IACG,kBAAkB,CACpB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,MAAM,GAAG,IAAW,GAChC,OAAO,CAAC,OAAO,CAAC;IAInB;;;;;;;;;;;OAWG;IACG,uBAAuB,CACzB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,MAAM,GAAG,IAAW,GAChC,OAAO,CAAC,OAAO,CAAC;IAInB;;;;;;;;;;;;OAYG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjH;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,oBAAoB,CACtB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,GAAE,MAAM,GAAG,IAAW,GAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAG5B"}