apify-client 2.20.1-beta.6 → 2.20.1-beta.8

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 (118) hide show
  1. package/dist/apify_client.d.ts +237 -25
  2. package/dist/apify_client.d.ts.map +1 -1
  3. package/dist/apify_client.js +234 -25
  4. package/dist/apify_client.js.map +1 -1
  5. package/dist/bundle.js +2042 -253
  6. package/dist/bundle.js.map +1 -1
  7. package/dist/resource_clients/actor.d.ts +322 -31
  8. package/dist/resource_clients/actor.d.ts.map +1 -1
  9. package/dist/resource_clients/actor.js +167 -19
  10. package/dist/resource_clients/actor.js.map +1 -1
  11. package/dist/resource_clients/actor_collection.d.ts +34 -3
  12. package/dist/resource_clients/actor_collection.d.ts.map +1 -1
  13. package/dist/resource_clients/actor_collection.js +34 -3
  14. package/dist/resource_clients/actor_collection.js.map +1 -1
  15. package/dist/resource_clients/actor_env_var.d.ts +34 -3
  16. package/dist/resource_clients/actor_env_var.d.ts.map +1 -1
  17. package/dist/resource_clients/actor_env_var.js +34 -3
  18. package/dist/resource_clients/actor_env_var.js.map +1 -1
  19. package/dist/resource_clients/actor_env_var_collection.d.ts +37 -3
  20. package/dist/resource_clients/actor_env_var_collection.d.ts.map +1 -1
  21. package/dist/resource_clients/actor_env_var_collection.js +37 -3
  22. package/dist/resource_clients/actor_env_var_collection.js.map +1 -1
  23. package/dist/resource_clients/actor_version.d.ts +42 -6
  24. package/dist/resource_clients/actor_version.d.ts.map +1 -1
  25. package/dist/resource_clients/actor_version.js +42 -6
  26. package/dist/resource_clients/actor_version.js.map +1 -1
  27. package/dist/resource_clients/actor_version_collection.d.ts +35 -3
  28. package/dist/resource_clients/actor_version_collection.d.ts.map +1 -1
  29. package/dist/resource_clients/actor_version_collection.js +35 -3
  30. package/dist/resource_clients/actor_version_collection.js.map +1 -1
  31. package/dist/resource_clients/build.d.ts +123 -11
  32. package/dist/resource_clients/build.d.ts.map +1 -1
  33. package/dist/resource_clients/build.js +93 -11
  34. package/dist/resource_clients/build.js.map +1 -1
  35. package/dist/resource_clients/build_collection.d.ts +27 -2
  36. package/dist/resource_clients/build_collection.d.ts.map +1 -1
  37. package/dist/resource_clients/build_collection.js +27 -2
  38. package/dist/resource_clients/build_collection.js.map +1 -1
  39. package/dist/resource_clients/dataset.d.ts +221 -15
  40. package/dist/resource_clients/dataset.d.ts.map +1 -1
  41. package/dist/resource_clients/dataset.js +185 -15
  42. package/dist/resource_clients/dataset.js.map +1 -1
  43. package/dist/resource_clients/dataset_collection.d.ts +32 -3
  44. package/dist/resource_clients/dataset_collection.d.ts.map +1 -1
  45. package/dist/resource_clients/dataset_collection.js +32 -3
  46. package/dist/resource_clients/dataset_collection.js.map +1 -1
  47. package/dist/resource_clients/key_value_store.d.ts +219 -26
  48. package/dist/resource_clients/key_value_store.d.ts.map +1 -1
  49. package/dist/resource_clients/key_value_store.js +172 -25
  50. package/dist/resource_clients/key_value_store.js.map +1 -1
  51. package/dist/resource_clients/key_value_store_collection.d.ts +32 -3
  52. package/dist/resource_clients/key_value_store_collection.d.ts.map +1 -1
  53. package/dist/resource_clients/key_value_store_collection.js +32 -3
  54. package/dist/resource_clients/key_value_store_collection.js.map +1 -1
  55. package/dist/resource_clients/log.d.ts +34 -3
  56. package/dist/resource_clients/log.d.ts.map +1 -1
  57. package/dist/resource_clients/log.js +34 -3
  58. package/dist/resource_clients/log.js.map +1 -1
  59. package/dist/resource_clients/request_queue.d.ts +290 -19
  60. package/dist/resource_clients/request_queue.d.ts.map +1 -1
  61. package/dist/resource_clients/request_queue.js +233 -19
  62. package/dist/resource_clients/request_queue.js.map +1 -1
  63. package/dist/resource_clients/request_queue_collection.d.ts +31 -3
  64. package/dist/resource_clients/request_queue_collection.d.ts.map +1 -1
  65. package/dist/resource_clients/request_queue_collection.js +31 -3
  66. package/dist/resource_clients/request_queue_collection.js.map +1 -1
  67. package/dist/resource_clients/run.d.ts +224 -27
  68. package/dist/resource_clients/run.d.ts.map +1 -1
  69. package/dist/resource_clients/run.js +200 -27
  70. package/dist/resource_clients/run.js.map +1 -1
  71. package/dist/resource_clients/run_collection.d.ts +27 -2
  72. package/dist/resource_clients/run_collection.d.ts.map +1 -1
  73. package/dist/resource_clients/run_collection.js +27 -2
  74. package/dist/resource_clients/run_collection.js.map +1 -1
  75. package/dist/resource_clients/schedule.d.ts +65 -4
  76. package/dist/resource_clients/schedule.d.ts.map +1 -1
  77. package/dist/resource_clients/schedule.js +42 -4
  78. package/dist/resource_clients/schedule.js.map +1 -1
  79. package/dist/resource_clients/schedule_collection.d.ts +35 -3
  80. package/dist/resource_clients/schedule_collection.d.ts.map +1 -1
  81. package/dist/resource_clients/schedule_collection.js +35 -3
  82. package/dist/resource_clients/schedule_collection.js.map +1 -1
  83. package/dist/resource_clients/store_collection.d.ts +26 -2
  84. package/dist/resource_clients/store_collection.d.ts.map +1 -1
  85. package/dist/resource_clients/store_collection.js +26 -2
  86. package/dist/resource_clients/store_collection.js.map +1 -1
  87. package/dist/resource_clients/task.d.ts +110 -11
  88. package/dist/resource_clients/task.d.ts.map +1 -1
  89. package/dist/resource_clients/task.js +83 -11
  90. package/dist/resource_clients/task.js.map +1 -1
  91. package/dist/resource_clients/task_collection.d.ts +35 -8
  92. package/dist/resource_clients/task_collection.d.ts.map +1 -1
  93. package/dist/resource_clients/task_collection.js +35 -8
  94. package/dist/resource_clients/task_collection.js.map +1 -1
  95. package/dist/resource_clients/user.d.ts +41 -4
  96. package/dist/resource_clients/user.d.ts.map +1 -1
  97. package/dist/resource_clients/user.js +41 -4
  98. package/dist/resource_clients/user.js.map +1 -1
  99. package/dist/resource_clients/webhook.d.ts +66 -5
  100. package/dist/resource_clients/webhook.d.ts.map +1 -1
  101. package/dist/resource_clients/webhook.js +48 -5
  102. package/dist/resource_clients/webhook.js.map +1 -1
  103. package/dist/resource_clients/webhook_collection.d.ts +34 -3
  104. package/dist/resource_clients/webhook_collection.d.ts.map +1 -1
  105. package/dist/resource_clients/webhook_collection.js +34 -3
  106. package/dist/resource_clients/webhook_collection.js.map +1 -1
  107. package/dist/resource_clients/webhook_dispatch.d.ts +22 -1
  108. package/dist/resource_clients/webhook_dispatch.d.ts.map +1 -1
  109. package/dist/resource_clients/webhook_dispatch.js +22 -1
  110. package/dist/resource_clients/webhook_dispatch.js.map +1 -1
  111. package/dist/resource_clients/webhook_dispatch_collection.d.ts +24 -2
  112. package/dist/resource_clients/webhook_dispatch_collection.d.ts.map +1 -1
  113. package/dist/resource_clients/webhook_dispatch_collection.js +24 -2
  114. package/dist/resource_clients/webhook_dispatch_collection.js.map +1 -1
  115. package/dist/utils.d.ts +42 -0
  116. package/dist/utils.d.ts.map +1 -1
  117. package/dist/utils.js.map +1 -1
  118. package/package.json +1 -1
@@ -9,6 +9,26 @@ const utils_1 = require("../utils");
9
9
  const run_1 = require("./run");
10
10
  const run_collection_1 = require("./run_collection");
11
11
  const webhook_collection_1 = require("./webhook_collection");
12
+ /**
13
+ * Client for managing a specific Actor task.
14
+ *
15
+ * Tasks are pre-configured Actor runs with saved input and options. This client provides methods
16
+ * to start, call, update, and delete tasks, as well as manage their runs and webhooks.
17
+ *
18
+ * @example
19
+ * ```javascript
20
+ * const client = new ApifyClient({ token: 'my-token' });
21
+ * const taskClient = client.task('my-task-id');
22
+ *
23
+ * // Start a task
24
+ * const run = await taskClient.start();
25
+ *
26
+ * // Call a task and wait for it to finish
27
+ * const finishedRun = await taskClient.call();
28
+ * ```
29
+ *
30
+ * @see https://docs.apify.com/platform/actors/running/tasks
31
+ */
12
32
  class TaskClient extends resource_client_1.ResourceClient {
13
33
  /**
14
34
  * @hidden
@@ -20,27 +40,48 @@ class TaskClient extends resource_client_1.ResourceClient {
20
40
  });
21
41
  }
22
42
  /**
23
- * https://docs.apify.com/api/v2#/reference/actor-tasks/task-object/get-task
43
+ * Retrieves the Actor task.
44
+ *
45
+ * @returns The task object, or `undefined` if it does not exist.
46
+ * @see https://docs.apify.com/api/v2/actor-task-get
24
47
  */
25
48
  async get() {
26
49
  return this._get();
27
50
  }
28
51
  /**
29
- * https://docs.apify.com/api/v2#/reference/actor-tasks/task-object/update-task
52
+ * Updates the task with the specified fields.
53
+ *
54
+ * @param newFields - Fields to update.
55
+ * @returns The updated task object.
56
+ * @see https://docs.apify.com/api/v2/actor-task-put
30
57
  */
31
58
  async update(newFields) {
32
59
  (0, ow_1.default)(newFields, ow_1.default.object);
33
60
  return this._update(newFields);
34
61
  }
35
62
  /**
36
- * https://docs.apify.com/api/v2#/reference/actor-tasks/task-object/delete-task
63
+ * Deletes the Task.
64
+ *
65
+ * @see https://docs.apify.com/api/v2/actor-task-delete
37
66
  */
38
67
  async delete() {
39
68
  return this._delete();
40
69
  }
41
70
  /**
42
- * Starts a task and immediately returns the Run object.
43
- * https://docs.apify.com/api/v2#/reference/actor-tasks/run-collection/run-task
71
+ * Starts an Actor task and immediately returns the Run object.
72
+ *
73
+ * @param input - Input overrides for the task. If not provided, the task's saved input is used.
74
+ * @param options - Run options.
75
+ * @param options.build - Tag or number of the Actor build to run (e.g., `'beta'` or `'1.2.345'`).
76
+ * @param options.memory - Memory in megabytes allocated for the run.
77
+ * @param options.timeout - Timeout for the run in seconds. Zero means no timeout.
78
+ * @param options.waitForFinish - Maximum time to wait (in seconds, max 60s) for the run to finish before returning.
79
+ * @param options.webhooks - Webhooks to trigger for specific Actor run events.
80
+ * @param options.maxItems - Maximum number of dataset items (for pay-per-result Actors).
81
+ * @param options.maxTotalChargeUsd - Maximum cost in USD (for pay-per-event Actors).
82
+ * @param options.restartOnError - Whether to restart the run on error.
83
+ * @returns The Actor Run object.
84
+ * @see https://docs.apify.com/api/v2/actor-task-runs-post
44
85
  */
45
86
  async start(input, options = {}) {
46
87
  (0, ow_1.default)(input, ow_1.default.optional.object);
@@ -83,7 +124,19 @@ class TaskClient extends resource_client_1.ResourceClient {
83
124
  /**
84
125
  * Starts a task and waits for it to finish before returning the Run object.
85
126
  * It waits indefinitely, unless the `waitSecs` option is provided.
86
- * https://docs.apify.com/api/v2#/reference/actor-tasks/run-collection/run-task
127
+ *
128
+ * @param input - Input overrides for the task. If not provided, the task's saved input is used.
129
+ * @param options - Run and wait options.
130
+ * @param options.build - Tag or number of the Actor build to run.
131
+ * @param options.memory - Memory in megabytes allocated for the run.
132
+ * @param options.timeout - Timeout for the run in seconds.
133
+ * @param options.waitSecs - Maximum time to wait for the run to finish, in seconds. If omitted, waits indefinitely.
134
+ * @param options.webhooks - Webhooks to trigger for specific Actor run events.
135
+ * @param options.maxItems - Maximum number of dataset items (for pay-per-result Actors).
136
+ * @param options.maxTotalChargeUsd - Maximum cost in USD (for pay-per-event Actors).
137
+ * @param options.restartOnError - Whether to restart the run on error.
138
+ * @returns The Actor run object.
139
+ * @see https://docs.apify.com/api/v2/actor-task-runs-post
87
140
  */
88
141
  async call(input, options = {}) {
89
142
  (0, ow_1.default)(input, ow_1.default.optional.object);
@@ -105,7 +158,10 @@ class TaskClient extends resource_client_1.ResourceClient {
105
158
  return this.apifyClient.run(id).waitForFinish({ waitSecs });
106
159
  }
107
160
  /**
108
- * https://docs.apify.com/api/v2#/reference/actor-tasks/task-input-object/get-task-input
161
+ * Retrieves the Actor task's input object.
162
+ *
163
+ * @returns The Task's input, or `undefined` if it does not exist.
164
+ * @see https://docs.apify.com/api/v2/actor-task-input-get
109
165
  */
110
166
  async getInput() {
111
167
  const requestOpts = {
@@ -123,7 +179,11 @@ class TaskClient extends resource_client_1.ResourceClient {
123
179
  return undefined;
124
180
  }
125
181
  /**
126
- * https://docs.apify.com/api/v2#/reference/actor-tasks/task-input-object/update-task-input
182
+ * Updates the Actor task's input object.
183
+ *
184
+ * @param newFields - New input data for the task.
185
+ * @returns The updated task input.
186
+ * @see https://docs.apify.com/api/v2/actor-task-input-put
127
187
  */
128
188
  async updateInput(newFields) {
129
189
  const response = await this.httpClient.call({
@@ -135,7 +195,13 @@ class TaskClient extends resource_client_1.ResourceClient {
135
195
  return (0, utils_1.cast)(response.data);
136
196
  }
137
197
  /**
138
- * https://docs.apify.com/api/v2#/reference/actor-tasks/last-run-object-and-its-storages
198
+ * Returns a client for the last run of this task.
199
+ *
200
+ * @param options - Filter options for the last run.
201
+ * @param options.status - Filter by run status (e.g., `'SUCCEEDED'`, `'FAILED'`, `'RUNNING'`).
202
+ * @param options.origin - Filter by run origin (e.g., `'WEB'`, `'API'`, `'SCHEDULE'`).
203
+ * @returns A client for the last run.
204
+ * @see https://docs.apify.com/api/v2/actor-task-runs-last-get
139
205
  */
140
206
  lastRun(options = {}) {
141
207
  (0, ow_1.default)(options, ow_1.default.object.exactShape({
@@ -149,7 +215,10 @@ class TaskClient extends resource_client_1.ResourceClient {
149
215
  }));
150
216
  }
151
217
  /**
152
- * https://docs.apify.com/api/v2#/reference/actor-tasks/run-collection
218
+ * Returns a client for the Runs of this Task.
219
+ *
220
+ * @returns A client for the task's runs.
221
+ * @see https://docs.apify.com/api/v2/actor-task-runs-get
153
222
  */
154
223
  runs() {
155
224
  return new run_collection_1.RunCollectionClient(this._subResourceOptions({
@@ -157,7 +226,10 @@ class TaskClient extends resource_client_1.ResourceClient {
157
226
  }));
158
227
  }
159
228
  /**
160
- * https://docs.apify.com/api/v2#/reference/actor-tasks/webhook-collection
229
+ * Returns a client for the Webhooks of this Task.
230
+ *
231
+ * @returns A client for the task's webhooks.
232
+ * @see https://docs.apify.com/api/v2/actor-task-webhooks-get
161
233
  */
162
234
  webhooks() {
163
235
  return new webhook_collection_1.WebhookCollectionClient(this._subResourceOptions());
@@ -1 +1 @@
1
- {"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/resource_clients/task.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/resource_clients/task.ts"],"names":[],"mappings":"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"}
@@ -2,24 +2,43 @@ import type { ApiClientSubResourceOptions } from '../base/api_client';
2
2
  import { ResourceCollectionClient } from '../base/resource_collection_client';
3
3
  import type { PaginatedIterator, PaginationOptions } from '../utils';
4
4
  import type { Task, TaskUpdateData } from './task';
5
+ /**
6
+ * Client for managing the collection of Actor tasks in your account.
7
+ *
8
+ * Tasks are pre-configured Actor runs with saved input and options. This client provides
9
+ * methods to list and create tasks.
10
+ *
11
+ * @example
12
+ * ```javascript
13
+ * const client = new ApifyClient({ token: 'my-token' });
14
+ * const tasksClient = client.tasks();
15
+ *
16
+ * // List all tasks
17
+ * const { items } = await tasksClient.list();
18
+ *
19
+ * // Create a new task
20
+ * const newTask = await tasksClient.create({
21
+ * actId: 'my-actor-id',
22
+ * name: 'my-task',
23
+ * input: { url: 'https://example.com' }
24
+ * });
25
+ * ```
26
+ *
27
+ * @see https://docs.apify.com/platform/actors/running/tasks
28
+ */
5
29
  export declare class TaskCollectionClient extends ResourceCollectionClient {
6
30
  /**
7
31
  * @hidden
8
32
  */
9
33
  constructor(options: ApiClientSubResourceOptions);
10
34
  /**
11
- * https://docs.apify.com/api/v2#/reference/actor-tasks/task-collection/get-list-of-tasks
12
- * @param {object} [options]
13
- * @param {number} [options.limit]
14
- * @param {number} [options.offset]
15
- * @param {boolean} [options.desc]
16
- * @return {PaginatedIterator<TaskList>}
35
+ * Lists all Tasks.
17
36
  *
18
37
  * Awaiting the return value (as you would with a Promise) will result in a single API call. The amount of fetched
19
38
  * items in a single API call is limited.
20
39
  * ```javascript
21
40
  * const paginatedList = await client.list(options);
22
- *```
41
+ * ```
23
42
  *
24
43
  * Asynchronous iteration is also supported. This will fetch additional pages if needed until all items are
25
44
  * retrieved.
@@ -27,10 +46,18 @@ export declare class TaskCollectionClient extends ResourceCollectionClient {
27
46
  * ```javascript
28
47
  * for await (const singleItem of client.list(options)) {...}
29
48
  * ```
49
+ *
50
+ * @param options - Pagination and sorting options.
51
+ * @returns A paginated iterator of tasks.
52
+ * @see https://docs.apify.com/api/v2/actor-tasks-get
30
53
  */
31
54
  list(options?: TaskCollectionListOptions): PaginatedIterator<TaskList>;
32
55
  /**
33
- * https://docs.apify.com/api/v2#/reference/actor-tasks/task-collection/create-task
56
+ * Creates a new task.
57
+ *
58
+ * @param task - The task data.
59
+ * @returns The created task object.
60
+ * @see https://docs.apify.com/api/v2/actor-tasks-post
34
61
  */
35
62
  create(task: TaskCreateData): Promise<Task>;
36
63
  }
@@ -1 +1 @@
1
- {"version":3,"file":"task_collection.d.ts","sourceRoot":"","sources":["../../src/resource_clients/task_collection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAEnD,qBAAa,oBAAqB,SAAQ,wBAAwB;IAC9D;;OAEG;gBACS,OAAO,EAAE,2BAA2B;IAOhD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,IAAI,CAAC,OAAO,GAAE,yBAA8B,GAAG,iBAAiB,CAAC,QAAQ,CAAC;IAa1E;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAKpD;AAED,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAChE,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC;AAEvD,MAAM,WAAW,cAAe,SAAQ,cAAc;IAClD,KAAK,EAAE,MAAM,CAAC;CACjB"}
1
+ {"version":3,"file":"task_collection.d.ts","sourceRoot":"","sources":["../../src/resource_clients/task_collection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,oBAAqB,SAAQ,wBAAwB;IAC9D;;OAEG;gBACS,OAAO,EAAE,2BAA2B;IAOhD;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,CAAC,OAAO,GAAE,yBAA8B,GAAG,iBAAiB,CAAC,QAAQ,CAAC;IAa1E;;;;;;OAMG;IACG,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAKpD;AAED,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAChE,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC;AAEvD,MAAM,WAAW,cAAe,SAAQ,cAAc;IAClD,KAAK,EAAE,MAAM,CAAC;CACjB"}
@@ -4,6 +4,30 @@ exports.TaskCollectionClient = void 0;
4
4
  const tslib_1 = require("tslib");
5
5
  const ow_1 = tslib_1.__importDefault(require("ow"));
6
6
  const resource_collection_client_1 = require("../base/resource_collection_client");
7
+ /**
8
+ * Client for managing the collection of Actor tasks in your account.
9
+ *
10
+ * Tasks are pre-configured Actor runs with saved input and options. This client provides
11
+ * methods to list and create tasks.
12
+ *
13
+ * @example
14
+ * ```javascript
15
+ * const client = new ApifyClient({ token: 'my-token' });
16
+ * const tasksClient = client.tasks();
17
+ *
18
+ * // List all tasks
19
+ * const { items } = await tasksClient.list();
20
+ *
21
+ * // Create a new task
22
+ * const newTask = await tasksClient.create({
23
+ * actId: 'my-actor-id',
24
+ * name: 'my-task',
25
+ * input: { url: 'https://example.com' }
26
+ * });
27
+ * ```
28
+ *
29
+ * @see https://docs.apify.com/platform/actors/running/tasks
30
+ */
7
31
  class TaskCollectionClient extends resource_collection_client_1.ResourceCollectionClient {
8
32
  /**
9
33
  * @hidden
@@ -15,18 +39,13 @@ class TaskCollectionClient extends resource_collection_client_1.ResourceCollecti
15
39
  });
16
40
  }
17
41
  /**
18
- * https://docs.apify.com/api/v2#/reference/actor-tasks/task-collection/get-list-of-tasks
19
- * @param {object} [options]
20
- * @param {number} [options.limit]
21
- * @param {number} [options.offset]
22
- * @param {boolean} [options.desc]
23
- * @return {PaginatedIterator<TaskList>}
42
+ * Lists all Tasks.
24
43
  *
25
44
  * Awaiting the return value (as you would with a Promise) will result in a single API call. The amount of fetched
26
45
  * items in a single API call is limited.
27
46
  * ```javascript
28
47
  * const paginatedList = await client.list(options);
29
- *```
48
+ * ```
30
49
  *
31
50
  * Asynchronous iteration is also supported. This will fetch additional pages if needed until all items are
32
51
  * retrieved.
@@ -34,6 +53,10 @@ class TaskCollectionClient extends resource_collection_client_1.ResourceCollecti
34
53
  * ```javascript
35
54
  * for await (const singleItem of client.list(options)) {...}
36
55
  * ```
56
+ *
57
+ * @param options - Pagination and sorting options.
58
+ * @returns A paginated iterator of tasks.
59
+ * @see https://docs.apify.com/api/v2/actor-tasks-get
37
60
  */
38
61
  list(options = {}) {
39
62
  (0, ow_1.default)(options, ow_1.default.object.exactShape({
@@ -44,7 +67,11 @@ class TaskCollectionClient extends resource_collection_client_1.ResourceCollecti
44
67
  return this._listPaginated(options);
45
68
  }
46
69
  /**
47
- * https://docs.apify.com/api/v2#/reference/actor-tasks/task-collection/create-task
70
+ * Creates a new task.
71
+ *
72
+ * @param task - The task data.
73
+ * @returns The created task object.
74
+ * @see https://docs.apify.com/api/v2/actor-tasks-post
48
75
  */
49
76
  async create(task) {
50
77
  (0, ow_1.default)(task, ow_1.default.object);
@@ -1 +1 @@
1
- {"version":3,"file":"task_collection.js","sourceRoot":"","sources":["../../src/resource_clients/task_collection.ts"],"names":[],"mappings":";;;;AAAA,oDAAoB;AAGpB,mFAA8E;AAI9E,MAAa,oBAAqB,SAAQ,qDAAwB;IAC9D;;OAEG;IACH,YAAY,OAAoC;QAC5C,KAAK,CAAC;YACF,YAAY,EAAE,aAAa;YAC3B,GAAG,OAAO;SACb,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,IAAI,CAAC,UAAqC,EAAE;QACxC,IAAA,YAAE,EACE,OAAO,EACP,YAAE,CAAC,MAAM,CAAC,UAAU,CAAC;YACjB,KAAK,EAAE,YAAE,CAAC,QAAQ,CAAC,MAAM;YACzB,MAAM,EAAE,YAAE,CAAC,QAAQ,CAAC,MAAM;YAC1B,IAAI,EAAE,YAAE,CAAC,QAAQ,CAAC,OAAO;SAC5B,CAAC,CACL,CAAC;QAEF,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,IAAoB;QAC7B,IAAA,YAAE,EAAC,IAAI,EAAE,YAAE,CAAC,MAAM,CAAC,CAAC;QAEpB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;CACJ;AArDD,oDAqDC"}
1
+ {"version":3,"file":"task_collection.js","sourceRoot":"","sources":["../../src/resource_clients/task_collection.ts"],"names":[],"mappings":";;;;AAAA,oDAAoB;AAGpB,mFAA8E;AAI9E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,oBAAqB,SAAQ,qDAAwB;IAC9D;;OAEG;IACH,YAAY,OAAoC;QAC5C,KAAK,CAAC;YACF,YAAY,EAAE,aAAa;YAC3B,GAAG,OAAO;SACb,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,CAAC,UAAqC,EAAE;QACxC,IAAA,YAAE,EACE,OAAO,EACP,YAAE,CAAC,MAAM,CAAC,UAAU,CAAC;YACjB,KAAK,EAAE,YAAE,CAAC,QAAQ,CAAC,MAAM;YACzB,MAAM,EAAE,YAAE,CAAC,QAAQ,CAAC,MAAM;YAC1B,IAAI,EAAE,YAAE,CAAC,QAAQ,CAAC,OAAO;SAC5B,CAAC,CACL,CAAC;QAEF,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CAAC,IAAoB;QAC7B,IAAA,YAAE,EAAC,IAAI,EAAE,YAAE,CAAC,MAAM,CAAC,CAAC;QAEpB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;CACJ;AAxDD,oDAwDC"}
@@ -1,26 +1,63 @@
1
1
  import type { ApiClientSubResourceOptions } from '../base/api_client';
2
2
  import { ResourceClient } from '../base/resource_client';
3
+ /**
4
+ * Client for managing user account information.
5
+ *
6
+ * Provides methods to retrieve user details, monthly usage statistics, and account limits.
7
+ * When using an API token, you can access your own user information or public information
8
+ * about other users.
9
+ *
10
+ * @example
11
+ * ```javascript
12
+ * const client = new ApifyClient({ token: 'my-token' });
13
+ * const userClient = client.user('my-user-id');
14
+ *
15
+ * // Get user information
16
+ * const user = await userClient.get();
17
+ *
18
+ * // Get monthly usage
19
+ * const usage = await userClient.monthlyUsage();
20
+ *
21
+ * // Get account limits
22
+ * const limits = await userClient.limits();
23
+ * ```
24
+ *
25
+ * @see https://docs.apify.com/platform/actors/running
26
+ */
3
27
  export declare class UserClient extends ResourceClient {
4
28
  /**
5
29
  * @hidden
6
30
  */
7
31
  constructor(options: ApiClientSubResourceOptions);
8
32
  /**
33
+ * Retrieves the user data.
34
+ *
9
35
  * Depending on whether ApifyClient was created with a token,
10
36
  * the method will either return public or private user data.
11
- * https://docs.apify.com/api/v2#/reference/users
37
+ *
38
+ * @returns The user object.
39
+ * @see https://docs.apify.com/api/v2/user-get
12
40
  */
13
41
  get(): Promise<User>;
14
42
  /**
15
- * https://docs.apify.com/api/v2/#/reference/users/monthly-usage
43
+ * Retrieves the user's monthly usage data.
44
+ *
45
+ * @returns The monthly usage object, or `undefined` if it does not exist.
46
+ * @see https://docs.apify.com/api/v2/user-usage-monthly-get
16
47
  */
17
48
  monthlyUsage(): Promise<MonthlyUsage | undefined>;
18
49
  /**
19
- * https://docs.apify.com/api/v2/#/reference/users/account-and-usage-limits
50
+ * Retrieves the user's account and usage limits.
51
+ *
52
+ * @returns The account and usage limits object, or `undefined` if it does not exist.
53
+ * @see https://docs.apify.com/api/v2/user-limits-get
20
54
  */
21
55
  limits(): Promise<AccountAndUsageLimits | undefined>;
22
56
  /**
23
- * https://docs.apify.com/api/v2/#/reference/users/account-and-usage-limits
57
+ * Updates the user's account and usage limits.
58
+ *
59
+ * @param options - The new limits to set.
60
+ * @see https://docs.apify.com/api/v2/user-limits-put
24
61
  */
25
62
  updateLimits(options: LimitsUpdateOptions): Promise<void>;
26
63
  }
@@ -1 +1 @@
1
- {"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/resource_clients/user.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/resource_clients/user.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAIzD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,UAAW,SAAQ,cAAc;IAC1C;;OAEG;gBACS,OAAO,EAAE,2BAA2B;IAOhD;;;;;;;;OAQG;IACG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1B;;;;;OAKG;IACG,YAAY,IAAI,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAsBvD;;;;;OAKG;IACG,MAAM,IAAI,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC;IAgB1D;;;;;OAKG;IACG,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CASlE;AAOD,MAAM,WAAW,IAAI;IAEjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE;QACL,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;IAEF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;IACtD,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,QAAQ;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uBAAuB,EAAE,eAAe,EAAE,CAAC;IAC3C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,2BAA2B,EAAE,MAAM,CAAC;IACpC,gCAAgC,EAAE,MAAM,CAAC;IACzC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oCAAoC,EAAE,MAAM,CAAC;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,OAAO,EAAE,CAAC;CAC9B;AAED,oBAAY,eAAe;IACvB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,UAAU,gBAAgB;IAC1B,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,mBAAmB,0BAA0B;CAChD;AAED,UAAU,wBAAwB;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,IAAI,GAAG,IAAI,CAAC;CAClC;AAED,UAAU,yBAAyB;IAC/B,MAAM,EAAE,wBAAwB,CAAC;IACjC,OAAO,EAAE,wBAAwB,CAAC;IAClC,SAAS,EAAE,wBAAwB,CAAC;IACpC,KAAK,EAAE,wBAAwB,CAAC;IAChC,qBAAqB,EAAE,wBAAwB,CAAC;IAChD,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,WAAW,EAAE,wBAAwB,CAAC;IACtC,QAAQ,EAAE,wBAAwB,CAAC;IACnC,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,uBAAuB,EAAE,wBAAwB,CAAC;CACrD;AAMD,MAAM,WAAW,YAAY;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,mBAAmB,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,CAAA;KAAE,CAAC;IAChE,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IACxC,wCAAwC,EAAE,MAAM,CAAC;IACjD,uCAAuC,EAAE,MAAM,CAAC;CACnD;AAED,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,EAAE,IAAI,CAAC;CACf;AAED,wCAAwC;AACxC,UAAU,uBAAuB;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,4BAA4B,EAAE,MAAM,CAAC;IACrC,UAAU,EAAE,SAAS,EAAE,CAAC;CAC3B;AAED,UAAU,SAAS;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,iBAAiB;IACvB,IAAI,EAAE,IAAI,CAAC;IACX,YAAY,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAAA;KAAE,CAAC;IACvD,oBAAoB,EAAE,MAAM,CAAC;CAChC;AAED,sCAAsC;AACtC,UAAU,qBAAqB;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACzB;AAMD,MAAM,WAAW,qBAAqB;IAClC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,MAAM;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2BAA2B,EAAE,MAAM,CAAC;IACpC,oCAAoC,EAAE,MAAM,CAAC;IAC7C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gCAAgC,EAAE,MAAM,CAAC;IACzC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,uBAAuB,EAAE,MAAM,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,MAAM,EAAE,oBAAoB,GAAG,mBAAmB,CAAC,CAAC;AAE3F,MAAM,WAAW,OAAO;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,wBAAwB,EAAE,MAAM,CAAC;IACjC,iCAAiC,EAAE,MAAM,CAAC;IAC1C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,6BAA6B,EAAE,MAAM,CAAC;IACtC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;CAChC"}
@@ -3,6 +3,30 @@ Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.PlatformFeature = exports.UserClient = void 0;
4
4
  const resource_client_1 = require("../base/resource_client");
5
5
  const utils_1 = require("../utils");
6
+ /**
7
+ * Client for managing user account information.
8
+ *
9
+ * Provides methods to retrieve user details, monthly usage statistics, and account limits.
10
+ * When using an API token, you can access your own user information or public information
11
+ * about other users.
12
+ *
13
+ * @example
14
+ * ```javascript
15
+ * const client = new ApifyClient({ token: 'my-token' });
16
+ * const userClient = client.user('my-user-id');
17
+ *
18
+ * // Get user information
19
+ * const user = await userClient.get();
20
+ *
21
+ * // Get monthly usage
22
+ * const usage = await userClient.monthlyUsage();
23
+ *
24
+ * // Get account limits
25
+ * const limits = await userClient.limits();
26
+ * ```
27
+ *
28
+ * @see https://docs.apify.com/platform/actors/running
29
+ */
6
30
  class UserClient extends resource_client_1.ResourceClient {
7
31
  /**
8
32
  * @hidden
@@ -14,15 +38,22 @@ class UserClient extends resource_client_1.ResourceClient {
14
38
  });
15
39
  }
16
40
  /**
41
+ * Retrieves the user data.
42
+ *
17
43
  * Depending on whether ApifyClient was created with a token,
18
44
  * the method will either return public or private user data.
19
- * https://docs.apify.com/api/v2#/reference/users
45
+ *
46
+ * @returns The user object.
47
+ * @see https://docs.apify.com/api/v2/user-get
20
48
  */
21
49
  async get() {
22
50
  return this._get();
23
51
  }
24
52
  /**
25
- * https://docs.apify.com/api/v2/#/reference/users/monthly-usage
53
+ * Retrieves the user's monthly usage data.
54
+ *
55
+ * @returns The monthly usage object, or `undefined` if it does not exist.
56
+ * @see https://docs.apify.com/api/v2/user-usage-monthly-get
26
57
  */
27
58
  async monthlyUsage() {
28
59
  const requestOpts = {
@@ -42,7 +73,10 @@ class UserClient extends resource_client_1.ResourceClient {
42
73
  return undefined;
43
74
  }
44
75
  /**
45
- * https://docs.apify.com/api/v2/#/reference/users/account-and-usage-limits
76
+ * Retrieves the user's account and usage limits.
77
+ *
78
+ * @returns The account and usage limits object, or `undefined` if it does not exist.
79
+ * @see https://docs.apify.com/api/v2/user-limits-get
46
80
  */
47
81
  async limits() {
48
82
  const requestOpts = {
@@ -60,7 +94,10 @@ class UserClient extends resource_client_1.ResourceClient {
60
94
  return undefined;
61
95
  }
62
96
  /**
63
- * https://docs.apify.com/api/v2/#/reference/users/account-and-usage-limits
97
+ * Updates the user's account and usage limits.
98
+ *
99
+ * @param options - The new limits to set.
100
+ * @see https://docs.apify.com/api/v2/user-limits-put
64
101
  */
65
102
  async updateLimits(options) {
66
103
  const requestOpts = {
@@ -1 +1 @@
1
- {"version":3,"file":"user.js","sourceRoot":"","sources":["../../src/resource_clients/user.ts"],"names":[],"mappings":";;;AAEA,6DAAyD;AAEzD,oCAAkF;AAElF,MAAa,UAAW,SAAQ,gCAAc;IAC1C;;OAEG;IACH,YAAY,OAAoC;QAC5C,KAAK,CAAC;YACF,YAAY,EAAE,OAAO;YACrB,GAAG,OAAO;SACb,CAAC,CAAC;IACP,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,EAAmB,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY;QACd,MAAM,WAAW,GAAuB;YACpC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC;YAC/B,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE;SACzB,CAAC;QACF,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACzD,OAAO,IAAA,YAAI,EACP,IAAA,uBAAe,EACX,IAAA,iBAAS,EAAC,QAAQ,CAAC,IAAI,CAAC;YACxB,uGAAuG;YACvG,wBAAwB,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,MAAM,CACnD,CACJ,CAAC;QACN,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,IAAA,4BAAoB,EAAC,GAAoB,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,SAAS,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM;QACR,MAAM,WAAW,GAAuB;YACpC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;YACxB,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE;SACzB,CAAC;QACF,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACzD,OAAO,IAAA,YAAI,EAAC,IAAA,uBAAe,EAAC,IAAA,iBAAS,EAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,IAAA,4BAAoB,EAAC,GAAoB,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,SAAS,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,OAA4B;QAC3C,MAAM,WAAW,GAAuB;YACpC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;YACxB,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE;YACtB,IAAI,EAAE,OAAO;SAChB,CAAC;QACF,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5C,CAAC;CACJ;AA5ED,gCA4EC;AA8DD,IAAY,eAQX;AARD,WAAY,eAAe;IACvB,oCAAiB,CAAA;IACjB,sCAAmB,CAAA;IACnB,6CAA0B,CAAA;IAC1B,0CAAuB,CAAA;IACvB,wCAAqB,CAAA;IACrB,kCAAe,CAAA;IACf,gEAA6C,CAAA;AACjD,CAAC,EARW,eAAe,+BAAf,eAAe,QAQ1B"}
1
+ {"version":3,"file":"user.js","sourceRoot":"","sources":["../../src/resource_clients/user.ts"],"names":[],"mappings":";;;AAEA,6DAAyD;AAEzD,oCAAkF;AAElF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,UAAW,SAAQ,gCAAc;IAC1C;;OAEG;IACH,YAAY,OAAoC;QAC5C,KAAK,CAAC;YACF,YAAY,EAAE,OAAO;YACrB,GAAG,OAAO;SACb,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,EAAmB,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY;QACd,MAAM,WAAW,GAAuB;YACpC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC;YAC/B,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE;SACzB,CAAC;QACF,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACzD,OAAO,IAAA,YAAI,EACP,IAAA,uBAAe,EACX,IAAA,iBAAS,EAAC,QAAQ,CAAC,IAAI,CAAC;YACxB,uGAAuG;YACvG,wBAAwB,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,MAAM,CACnD,CACJ,CAAC;QACN,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,IAAA,4BAAoB,EAAC,GAAoB,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,SAAS,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM;QACR,MAAM,WAAW,GAAuB;YACpC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;YACxB,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE;SACzB,CAAC;QACF,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACzD,OAAO,IAAA,YAAI,EAAC,IAAA,uBAAe,EAAC,IAAA,iBAAS,EAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,IAAA,4BAAoB,EAAC,GAAoB,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,SAAS,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAAC,OAA4B;QAC3C,MAAM,WAAW,GAAuB;YACpC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;YACxB,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE;YACtB,IAAI,EAAE,OAAO;SAChB,CAAC;QACF,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5C,CAAC;CACJ;AAzFD,gCAyFC;AA8DD,IAAY,eAQX;AARD,WAAY,eAAe;IACvB,oCAAiB,CAAA;IACjB,sCAAmB,CAAA;IACnB,6CAA0B,CAAA;IAC1B,0CAAuB,CAAA;IACvB,wCAAqB,CAAA;IACrB,kCAAe,CAAA;IACf,gEAA6C,CAAA;AACjD,CAAC,EARW,eAAe,+BAAf,eAAe,QAQ1B"}
@@ -3,32 +3,81 @@ import type { ApiClientSubResourceOptions } from '../base/api_client';
3
3
  import { ResourceClient } from '../base/resource_client';
4
4
  import type { WebhookDispatch } from './webhook_dispatch';
5
5
  import { WebhookDispatchCollectionClient } from './webhook_dispatch_collection';
6
+ /**
7
+ * Client for managing a specific webhook.
8
+ *
9
+ * Webhooks allow you to receive notifications when specific events occur in your Actors or tasks.
10
+ * This client provides methods to get, update, delete, and test webhooks, as well as retrieve
11
+ * webhook dispatches.
12
+ *
13
+ * @example
14
+ * ```javascript
15
+ * const client = new ApifyClient({ token: 'my-token' });
16
+ * const webhookClient = client.webhook('my-webhook-id');
17
+ *
18
+ * // Get webhook details
19
+ * const webhook = await webhookClient.get();
20
+ *
21
+ * // Update webhook
22
+ * await webhookClient.update({
23
+ * isEnabled: true,
24
+ * eventTypes: ['ACTOR.RUN.SUCCEEDED'],
25
+ * requestUrl: 'https://example.com/webhook'
26
+ * });
27
+ *
28
+ * // Test webhook
29
+ * await webhookClient.test();
30
+ * ```
31
+ *
32
+ * @see https://docs.apify.com/platform/integrations/webhooks
33
+ */
6
34
  export declare class WebhookClient extends ResourceClient {
7
35
  /**
8
36
  * @hidden
9
37
  */
10
38
  constructor(options: ApiClientSubResourceOptions);
11
39
  /**
12
- * https://docs.apify.com/api/v2#/reference/webhooks/webhook-object/get-webhook
40
+ * Retrieves the webhook.
41
+ *
42
+ * @returns The webhook object, or `undefined` if it does not exist.
43
+ * @see https://docs.apify.com/api/v2/webhook-get
13
44
  */
14
45
  get(): Promise<Webhook | undefined>;
15
46
  /**
16
- * https://docs.apify.com/api/v2#/reference/webhooks/webhook-object/update-webhook
47
+ * Updates the webhook with the specified fields.
48
+ *
49
+ * @param newFields - Fields to update.
50
+ * @returns The updated webhook object.
51
+ * @see https://docs.apify.com/api/v2/webhook-put
17
52
  */
18
53
  update(newFields: WebhookUpdateData): Promise<Webhook>;
19
54
  /**
20
- * https://docs.apify.com/api/v2#/reference/webhooks/webhook-object/delete-webhook
55
+ * Deletes the webhook.
56
+ *
57
+ * @see https://docs.apify.com/api/v2/webhook-delete
21
58
  */
22
59
  delete(): Promise<void>;
23
60
  /**
24
- * https://docs.apify.com/api/v2#/reference/webhooks/webhook-test/test-webhook
61
+ * Tests the webhook by dispatching a test event.
62
+ *
63
+ * @returns The webhook dispatch object, or `undefined` if the test fails.
64
+ * @see https://docs.apify.com/api/v2/webhook-test-post
25
65
  */
26
66
  test(): Promise<WebhookDispatch | undefined>;
27
67
  /**
28
- * https://docs.apify.com/api/v2#/reference/webhooks/dispatches-collection
68
+ * Returns a client for the dispatches of this webhook.
69
+ *
70
+ * @returns A client for the webhook's dispatches.
71
+ * @see https://docs.apify.com/api/v2/webhook-webhook-dispatches-get
29
72
  */
30
73
  dispatches(): WebhookDispatchCollectionClient;
31
74
  }
75
+ /**
76
+ * Represents a webhook for receiving notifications about Actor events.
77
+ *
78
+ * Webhooks send HTTP POST requests to specified URLs when certain events occur
79
+ * (e.g., Actor run succeeds, fails, or times out).
80
+ */
32
81
  export interface Webhook {
33
82
  id: string;
34
83
  userId: string;
@@ -51,11 +100,23 @@ export interface Webhook {
51
100
  export interface WebhookIdempotencyKey {
52
101
  idempotencyKey?: string;
53
102
  }
103
+ /**
104
+ * Data for updating a webhook.
105
+ */
54
106
  export type WebhookUpdateData = Partial<Pick<Webhook, 'isAdHoc' | 'eventTypes' | 'condition' | 'ignoreSslErrors' | 'doNotRetry' | 'requestUrl' | 'payloadTemplate' | 'shouldInterpolateStrings' | 'isApifyIntegration' | 'headersTemplate' | 'description'>> & WebhookIdempotencyKey;
107
+ /**
108
+ * Statistics about webhook usage.
109
+ */
55
110
  export interface WebhookStats {
56
111
  totalDispatches: number;
57
112
  }
113
+ /**
114
+ * Event types that can trigger webhooks.
115
+ */
58
116
  export type WebhookEventType = (typeof WEBHOOK_EVENT_TYPES)[keyof typeof WEBHOOK_EVENT_TYPES];
117
+ /**
118
+ * Condition that determines when a webhook should be triggered.
119
+ */
59
120
  export type WebhookCondition = WebhookAnyRunOfActorCondition | WebhookAnyRunOfActorTaskCondition | WebhookCertainRunCondition;
60
121
  export interface WebhookAnyRunOfActorCondition {
61
122
  actorId: string;
@@ -1 +1 @@
1
- {"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../src/resource_clients/webhook.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGzD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAEhF,qBAAa,aAAc,SAAQ,cAAc;IAC7C;;OAEG;gBACS,OAAO,EAAE,2BAA2B;IAOhD;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAIzC;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAM5D;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAiBlD;;OAEG;IACH,UAAU,IAAI,+BAA+B;CAOhD;AAED,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,UAAU,EAAE,IAAI,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,YAAY,CAAC;IACpB,wBAAwB,EAAE,OAAO,CAAC;IAClC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,iBAAiB,GAAG,OAAO,CACnC,IAAI,CACA,OAAO,EACL,SAAS,GACT,YAAY,GACZ,WAAW,GACX,iBAAiB,GACjB,YAAY,GACZ,YAAY,GACZ,iBAAiB,GACjB,0BAA0B,GAC1B,oBAAoB,GACpB,iBAAiB,GACjB,aAAa,CAClB,CACJ,GACG,qBAAqB,CAAC;AAE1B,MAAM,WAAW,YAAY;IACzB,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAE9F,MAAM,MAAM,gBAAgB,GACtB,6BAA6B,GAC7B,iCAAiC,GACjC,0BAA0B,CAAC;AAEjC,MAAM,WAAW,6BAA6B;IAC1C,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iCAAiC;IAC9C,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,0BAA0B;IACvC,UAAU,EAAE,MAAM,CAAC;CACtB"}
1
+ {"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../src/resource_clients/webhook.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGzD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC7C;;OAEG;gBACS,OAAO,EAAE,2BAA2B;IAOhD;;;;;OAKG;IACG,GAAG,IAAI,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAIzC;;;;;;OAMG;IACG,MAAM,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAM5D;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAiBlD;;;;;OAKG;IACH,UAAU,IAAI,+BAA+B;CAOhD;AAED;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,UAAU,EAAE,IAAI,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,YAAY,CAAC;IACpB,wBAAwB,EAAE,OAAO,CAAC;IAClC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,CACnC,IAAI,CACA,OAAO,EACL,SAAS,GACT,YAAY,GACZ,WAAW,GACX,iBAAiB,GACjB,YAAY,GACZ,YAAY,GACZ,iBAAiB,GACjB,0BAA0B,GAC1B,oBAAoB,GACpB,iBAAiB,GACjB,aAAa,CAClB,CACJ,GACG,qBAAqB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAE9F;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACtB,6BAA6B,GAC7B,iCAAiC,GACjC,0BAA0B,CAAC;AAEjC,MAAM,WAAW,6BAA6B;IAC1C,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iCAAiC;IAC9C,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,0BAA0B;IACvC,UAAU,EAAE,MAAM,CAAC;CACtB"}