@@ -21,6 +21,7 @@ This module provides a service for convenient manipulation with
21
21
* [ .getChallengeSubtracks()] ( #module_services.challenges..ChallengesService+getChallengeSubtracks ) ⇒ <code >Promise</code >
22
22
* [ .getChallengeTags()] ( #module_services.challenges..ChallengesService+getChallengeTags ) ⇒ <code >Promise</code >
23
23
* [ .getChallenges(filters, params)] ( #module_services.challenges..ChallengesService+getChallenges ) ⇒ <code >Promise</code >
24
+ * [ .getMyChallenges(filters, params)] ( #module_services.challenges..ChallengesService+getChallenges ) ⇒ <code >Promise</code >
24
25
* [ .getMarathonMatches(filters, params)] ( #module_services.challenges..ChallengesService+getMarathonMatches ) ⇒ <code >Promise</code >
25
26
* [ .getSrms(params)] ( #module_services.challenges..ChallengesService+getSrms ) ⇒ <code >Promise</code >
26
27
* [ .getUserChallenges(username, filters, params)] ( #module_services.challenges..ChallengesService+getUserChallenges ) ⇒ <code >Promise</code >
@@ -41,8 +42,8 @@ NOTE: It is possible, that this normalization is not necessary after we
41
42
have moved to Topcoder API v3, but it is kept for now to minimize a risk of
42
43
breaking anything.
43
44
44
- ** Kind** : static method of [ <code >services.challenges</code >] ( #module_services.challenges )
45
- ** Returns** : <code >Object</code > - Normalized challenge object.
45
+ ** Kind** : static method of [ <code >services.challenges</code >] ( #module_services.challenges )
46
+ ** Returns** : <code >Object</code > - Normalized challenge object.
46
47
** Todo**
47
48
48
49
- [ ] Why this one is exported? It should be only used internally!
@@ -65,7 +66,7 @@ component. It is possible, that this normalization is not necessary after we
65
66
have moved to Topcoder API v3, but it is kept for now to minimize a risk of
66
67
breaking anything.
67
68
68
- ** Kind** : static method of [ <code >services.challenges</code >] ( #module_services.challenges )
69
+ ** Kind** : static method of [ <code >services.challenges</code >] ( #module_services.challenges )
69
70
** Todo**
70
71
71
72
- [ ] Should be used only internally!
@@ -85,8 +86,8 @@ component. It is possible, that this normalization is not necessary after we
85
86
have moved to Topcoder API v3, but it is kept for now to minimize a risk of
86
87
breaking anything.
87
88
88
- ** Kind** : static method of [ <code >services.challenges</code >] ( #module_services.challenges )
89
- ** Returns** : <code >Object</code > - Normalized challenge.
89
+ ** Kind** : static method of [ <code >services.challenges</code >] ( #module_services.challenges )
90
+ ** Returns** : <code >Object</code > - Normalized challenge.
90
91
91
92
| Param | Type | Description |
92
93
| --- | --- | --- |
@@ -98,8 +99,8 @@ breaking anything.
98
99
### services.challenges.getService(tokenV3, tokenV2) ⇒ <code >ChallengesService</code >
99
100
Returns a new or existing challenges service.
100
101
101
- ** Kind** : static method of [ <code >services.challenges</code >] ( #module_services.challenges )
102
- ** Returns** : <code >ChallengesService</code > - Challenges service object
102
+ ** Kind** : static method of [ <code >services.challenges</code >] ( #module_services.challenges )
103
+ ** Returns** : <code >ChallengesService</code > - Challenges service object
103
104
104
105
| Param | Type | Description |
105
106
| --- | --- | --- |
@@ -111,7 +112,7 @@ Returns a new or existing challenges service.
111
112
### services.challenges~ ChallengesService
112
113
Challenge service.
113
114
114
- ** Kind** : inner class of [ <code >services.challenges</code >] ( #module_services.challenges )
115
+ ** Kind** : inner class of [ <code >services.challenges</code >] ( #module_services.challenges )
115
116
116
117
* [ ~ ChallengesService] ( #module_services.challenges..ChallengesService )
117
118
* [ new ChallengesService(tokenV3, tokenV2)] ( #new_module_services.challenges..ChallengesService_new )
@@ -122,6 +123,7 @@ Challenge service.
122
123
* [ .getChallengeSubtracks()] ( #module_services.challenges..ChallengesService+getChallengeSubtracks ) ⇒ <code >Promise</code >
123
124
* [ .getChallengeTags()] ( #module_services.challenges..ChallengesService+getChallengeTags ) ⇒ <code >Promise</code >
124
125
* [ .getChallenges(filters, params)] ( #module_services.challenges..ChallengesService+getChallenges ) ⇒ <code >Promise</code >
126
+ * [ .getMyChallenges(filters, params)] ( #module_services.challenges..ChallengesService+getMyChallenges ) ⇒ <code >Promise</code >
125
127
* [ .getMarathonMatches(filters, params)] ( #module_services.challenges..ChallengesService+getMarathonMatches ) ⇒ <code >Promise</code >
126
128
* [ .getSrms(params)] ( #module_services.challenges..ChallengesService+getSrms ) ⇒ <code >Promise</code >
127
129
* [ .getUserChallenges(username, filters, params)] ( #module_services.challenges..ChallengesService+getUserChallenges ) ⇒ <code >Promise</code >
@@ -149,22 +151,22 @@ Creates a new ChallengeService instance.
149
151
#### challengesService.activate(challengeId) ⇒ <code >Promise</code >
150
152
Activates the specified challenge.
151
153
152
- ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
154
+ ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
153
155
** Returns** : <code >Promise</code > - Resolves to null value in case of success; otherwise it
154
- is rejected.
156
+ is rejected.
155
157
156
158
| Param | Type |
157
159
| --- | --- |
158
- | challengeId | <code >Number</code > |
160
+ | challengeId | <code >Number</code > |
159
161
160
162
<a name =" module_services.challenges..ChallengesService+close " ></a >
161
163
162
164
#### challengesService.close(challengeId, winnerId) ⇒ <code >Promise</code >
163
165
Closes the specified challenge.
164
166
165
- ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
167
+ ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
166
168
** Returns** : <code >Promise</code > - Resolves to null value in case of success; otherwise it
167
- is rejected.
169
+ is rejected.
168
170
169
171
| Param | Type | Description |
170
172
| --- | --- | --- |
@@ -176,8 +178,8 @@ Closes the specified challenge.
176
178
#### challengesService.createTask(projectId, accountId, title, description, assignee, payment) ⇒ <code >Promise</code >
177
179
Creates a new payment task.
178
180
179
- ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
180
- ** Returns** : <code >Promise</code > - Resolves to the created challenge object (payment task).
181
+ ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
182
+ ** Returns** : <code >Promise</code > - Resolves to the created challenge object (payment task).
181
183
182
184
| Param | Type | Description |
183
185
| --- | --- | --- |
@@ -196,34 +198,45 @@ NOTE: This function also uses API v2 and other v3 endpoints for now, due
196
198
to some information is missing or
197
199
incorrect in the main v3 endpoint. This may change in the future.
198
200
199
- ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
200
- ** Returns** : <code >Promise</code > - Resolves to the challenge object.
201
+ ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
202
+ ** Returns** : <code >Promise</code > - Resolves to the challenge object.
201
203
202
204
| Param | Type |
203
205
| --- | --- |
204
- | challengeId | <code >Number</code > \| <code >String</code > |
206
+ | challengeId | <code >Number</code > \| <code >String</code > |
205
207
206
208
<a name =" module_services.challenges..ChallengesService+getChallengeSubtracks " ></a >
207
209
208
210
#### challengesService.getChallengeSubtracks() ⇒ <code >Promise</code >
209
211
Gets possible challenge subtracks.
210
212
211
- ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
212
- ** Returns** : <code >Promise</code > - Resolves to the array of subtrack names.
213
+ ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
214
+ ** Returns** : <code >Promise</code > - Resolves to the array of subtrack names.
213
215
<a name =" module_services.challenges..ChallengesService+getChallengeTags " ></a >
214
216
215
217
#### challengesService.getChallengeTags() ⇒ <code >Promise</code >
216
218
Gets possible challenge tags (technologies).
217
219
218
- ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
219
- ** Returns** : <code >Promise</code > - Resolves to the array of tag strings.
220
+ ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
221
+ ** Returns** : <code >Promise</code > - Resolves to the array of tag strings.
220
222
<a name =" module_services.challenges..ChallengesService+getChallenges " ></a >
221
223
222
224
#### challengesService.getChallenges(filters, params) ⇒ <code >Promise</code >
223
225
Gets challenges.
224
226
225
- ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
226
- ** Returns** : <code >Promise</code > - Resolves to the api response.
227
+ ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
228
+ ** Returns** : <code >Promise</code > - Resolves to the api response.
229
+
230
+ | Param | Type | Description |
231
+ | --- | --- | --- |
232
+ | filters | <code >Object</code > | Optional. |
233
+ | params | <code >Object</code > | Optional. |
234
+
235
+ #### challengesService.getMyChallenges(filters, params) ⇒ <code >Promise</code >
236
+ Gets my challenges.
237
+
238
+ ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
239
+ ** Returns** : <code >Promise</code > - Resolves to the api response.
227
240
228
241
| Param | Type | Description |
229
242
| --- | --- | --- |
@@ -235,8 +248,8 @@ Gets challenges.
235
248
#### challengesService.getMarathonMatches(filters, params) ⇒ <code >Promise</code >
236
249
Gets marathon matches.
237
250
238
- ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
239
- ** Returns** : <code >Promise</code > - Resolve to the api response.
251
+ ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
252
+ ** Returns** : <code >Promise</code > - Resolve to the api response.
240
253
241
254
| Param | Type | Description |
242
255
| --- | --- | --- |
@@ -248,19 +261,19 @@ Gets marathon matches.
248
261
#### challengesService.getSrms(params) ⇒ <code >Promise</code >
249
262
Gets SRM matches.
250
263
251
- ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
264
+ ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
252
265
253
266
| Param | Type |
254
267
| --- | --- |
255
- | params | <code >Object</code > |
268
+ | params | <code >Object</code > |
256
269
257
270
<a name =" module_services.challenges..ChallengesService+getUserChallenges " ></a >
258
271
259
272
#### challengesService.getUserChallenges(username, filters, params) ⇒ <code >Promise</code >
260
273
Gets challenges of the specified user.
261
274
262
- ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
263
- ** Returns** : <code >Promise</code > - Resolves to the api response.
275
+ ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
276
+ ** Returns** : <code >Promise</code > - Resolves to the api response.
264
277
265
278
| Param | Type | Description |
266
279
| --- | --- | --- |
@@ -273,42 +286,42 @@ Gets challenges of the specified user.
273
286
#### challengesService.getUserSrms(handle, params) ⇒ <code >Promise</code >
274
287
Gets SRM matches related to the user.
275
288
276
- ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
289
+ ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
277
290
278
291
| Param | Type |
279
292
| --- | --- |
280
- | handle | <code >String</code > |
281
- | params | <code >Object</code > |
293
+ | handle | <code >String</code > |
294
+ | params | <code >Object</code > |
282
295
283
296
<a name =" module_services.challenges..ChallengesService+register " ></a >
284
297
285
298
#### challengesService.register(challengeId) ⇒ <code >Promise</code >
286
299
Registers user to the specified challenge.
287
300
288
- ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
301
+ ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
289
302
290
303
| Param | Type |
291
304
| --- | --- |
292
- | challengeId | <code >String</code > |
305
+ | challengeId | <code >String</code > |
293
306
294
307
<a name =" module_services.challenges..ChallengesService+unregister " ></a >
295
308
296
309
#### challengesService.unregister(challengeId) ⇒ <code >Promise</code >
297
310
Unregisters user from the specified challenge.
298
311
299
- ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
312
+ ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
300
313
301
314
| Param | Type |
302
315
| --- | --- |
303
- | challengeId | <code >String</code > |
316
+ | challengeId | <code >String</code > |
304
317
305
318
<a name =" module_services.challenges..ChallengesService+getUserMarathonMatches " ></a >
306
319
307
320
#### challengesService.getUserMarathonMatches(username, filters, params) ⇒ <code >Promise</code >
308
321
Gets marathon matches of the specified user.
309
322
310
- ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
311
- ** Returns** : <code >Promise</code > - Resolves to the api response.
323
+ ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
324
+ ** Returns** : <code >Promise</code > - Resolves to the api response.
312
325
313
326
| Param | Type | Description |
314
327
| --- | --- | --- |
@@ -321,8 +334,8 @@ Gets marathon matches of the specified user.
321
334
#### challengesService.getActiveChallengesCount(handle) ⇒ <code >Action</code >
322
335
Gets count of user's active challenges.
323
336
324
- ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
325
- ** Returns** : <code >Action</code > - Resolves to the api response.
337
+ ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
338
+ ** Returns** : <code >Action</code > - Resolves to the api response.
326
339
327
340
| Param | Type | Description |
328
341
| --- | --- | --- |
@@ -334,7 +347,7 @@ Gets count of user's active challenges.
334
347
Submits a challenge submission. Uses APIV2 for Development submission
335
348
and APIV3 for Design submisisons.
336
349
337
- ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
350
+ ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
338
351
339
352
| Param | Type | Description |
340
353
| --- | --- | --- |
@@ -347,20 +360,20 @@ and APIV3 for Design submisisons.
347
360
#### challengesService.updateChallenge(challenge, tokenV3) ⇒ <code >Promise</code >
348
361
Updates the challenge (saves the give challenge to the API).
349
362
350
- ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
363
+ ** Kind** : instance method of [ <code >ChallengesService</code >] ( #module_services.challenges..ChallengesService )
351
364
352
365
| Param | Type |
353
366
| --- | --- |
354
- | challenge | <code >Object</code > |
355
- | tokenV3 | <code >String</code > |
367
+ | challenge | <code >Object</code > |
368
+ | tokenV3 | <code >String</code > |
356
369
357
370
<a name =" module_services.challenges..normalizeNameConventionForSubtrack " ></a >
358
371
359
372
### services.challenges~ normalizeNameConventionForSubtrack(subTrack) ⇒ <code >String</code >
360
373
Normalize name convention for subtrack
361
374
362
- ** Kind** : inner method of [ <code >services.challenges</code >] ( #module_services.challenges )
363
- ** Returns** : <code >String</code > - Normalized subtrack ID.
375
+ ** Kind** : inner method of [ <code >services.challenges</code >] ( #module_services.challenges )
376
+ ** Returns** : <code >String</code > - Normalized subtrack ID.
364
377
365
378
| Param | Type | Description |
366
379
| --- | --- | --- |
0 commit comments