apify-client 2.25.1-beta.0 → 2.25.1-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/dist/apify_client.d.ts +11 -1
  2. package/dist/apify_client.js +4 -0
  3. package/dist/base/api_client.d.ts +3 -0
  4. package/dist/base/api_client.js +3 -0
  5. package/dist/bundle.js +46 -4
  6. package/dist/bundle.js.map +1 -1
  7. package/dist/resource_clients/actor.d.ts +105 -7
  8. package/dist/resource_clients/actor.js +2 -0
  9. package/dist/resource_clients/actor_collection.d.ts +30 -0
  10. package/dist/resource_clients/actor_collection.js +3 -0
  11. package/dist/resource_clients/actor_env_var.d.ts +1 -0
  12. package/dist/resource_clients/actor_env_var.js +1 -0
  13. package/dist/resource_clients/actor_env_var_collection.d.ts +5 -0
  14. package/dist/resource_clients/actor_env_var_collection.js +1 -0
  15. package/dist/resource_clients/actor_version.d.ts +5 -0
  16. package/dist/resource_clients/actor_version.js +2 -0
  17. package/dist/resource_clients/build.d.ts +17 -0
  18. package/dist/resource_clients/build.js +3 -0
  19. package/dist/resource_clients/dataset.d.ts +35 -0
  20. package/dist/resource_clients/dataset.js +2 -0
  21. package/dist/resource_clients/dataset_collection.d.ts +7 -1
  22. package/dist/resource_clients/key_value_store.d.ts +39 -0
  23. package/dist/resource_clients/key_value_store.js +3 -0
  24. package/dist/resource_clients/key_value_store_collection.d.ts +7 -1
  25. package/dist/resource_clients/log.d.ts +8 -0
  26. package/dist/resource_clients/log.js +2 -0
  27. package/dist/resource_clients/request_queue.d.ts +86 -0
  28. package/dist/resource_clients/request_queue.js +8 -0
  29. package/dist/resource_clients/request_queue_collection.d.ts +4 -1
  30. package/dist/resource_clients/run.d.ts +23 -0
  31. package/dist/resource_clients/run.js +5 -0
  32. package/dist/resource_clients/run_collection.d.ts +6 -0
  33. package/dist/resource_clients/schedule.d.ts +10 -0
  34. package/dist/resource_clients/store_collection.d.ts +18 -1
  35. package/dist/resource_clients/store_collection.js +1 -0
  36. package/dist/resource_clients/task.d.ts +18 -0
  37. package/dist/resource_clients/task.js +2 -0
  38. package/dist/resource_clients/task_collection.d.ts +3 -0
  39. package/dist/resource_clients/user.d.ts +33 -0
  40. package/dist/resource_clients/user.js +3 -0
  41. package/dist/resource_clients/webhook.d.ts +12 -0
  42. package/dist/resource_clients/webhook_dispatch.d.ts +6 -0
  43. package/dist/utils.d.ts +2 -0
  44. package/package.json +3 -3
@@ -100,6 +100,7 @@ class RunClient extends resource_client_1.ResourceClient {
100
100
  * Deletes the Actor run.
101
101
  *
102
102
  * @see https://docs.apify.com/api/v2/actor-run-delete
103
+ * @since Added in 2.8.1
103
104
  */
104
105
  async delete() {
105
106
  return this._delete();
@@ -174,6 +175,7 @@ class RunClient extends resource_client_1.ResourceClient {
174
175
  * ```javascript
175
176
  * const run = await client.run('run-id').reboot();
176
177
  * ```
178
+ * @since Added in 2.8.0
177
179
  */
178
180
  async reboot() {
179
181
  const request = {
@@ -199,6 +201,7 @@ class RunClient extends resource_client_1.ResourceClient {
199
201
  * statusMessage: 'Processing items: 50/100'
200
202
  * });
201
203
  * ```
204
+ * @since Added in 2.6.0
202
205
  */
203
206
  async update(newFields) {
204
207
  (0, ow_1.default)(newFields, ow_1.default.object);
@@ -252,6 +255,7 @@ class RunClient extends resource_client_1.ResourceClient {
252
255
  * @param options.idempotencyKey - Optional key to ensure the charge is not duplicated. If not provided, one is auto-generated.
253
256
  * @returns Empty response object.
254
257
  * @see https://docs.apify.com/api/v2/post-charge-run
258
+ * @since Added in 2.11.0
255
259
  */
256
260
  async charge(options) {
257
261
  (0, ow_1.default)(options, ow_1.default.object.exactShape({
@@ -382,6 +386,7 @@ class RunClient extends resource_client_1.ResourceClient {
382
386
  }
383
387
  /**
384
388
  * Get StreamedLog for convenient streaming of the run log and their redirection.
389
+ * @since Added in 2.20.0
385
390
  */
386
391
  async getStreamedLog(options = {}) {
387
392
  const { fromStart = true } = options;
@@ -54,6 +54,12 @@ export declare class RunCollectionClient extends ResourceCollectionClient {
54
54
  export interface RunCollectionListOptions extends PaginationOptions {
55
55
  desc?: boolean;
56
56
  status?: (typeof ACTOR_JOB_STATUSES)[keyof typeof ACTOR_JOB_STATUSES] | (typeof ACTOR_JOB_STATUSES)[keyof typeof ACTOR_JOB_STATUSES][];
57
+ /**
58
+ * @since Added in 2.18.0
59
+ */
57
60
  startedBefore?: Date | string;
61
+ /**
62
+ * @since Added in 2.18.0
63
+ */
58
64
  startedAfter?: Date | string;
59
65
  }
@@ -68,6 +68,9 @@ export interface Schedule {
68
68
  id: string;
69
69
  userId: string;
70
70
  name: string;
71
+ /**
72
+ * @since Added in 2.6.1
73
+ */
71
74
  title?: string;
72
75
  cronExpression: string;
73
76
  timezone: Timezone;
@@ -79,12 +82,16 @@ export interface Schedule {
79
82
  nextRunAt: string;
80
83
  lastRunAt: string;
81
84
  actions: ScheduleAction[];
85
+ /**
86
+ * @since Added in 2.9.4
87
+ */
82
88
  notifications: {
83
89
  email: boolean;
84
90
  };
85
91
  }
86
92
  /**
87
93
  * Data for creating or updating a Schedule.
94
+ * @since Added in 2.6.2
88
95
  */
89
96
  export type ScheduleCreateOrUpdateData = Partial<Pick<Schedule, 'name' | 'title' | 'cronExpression' | 'timezone' | 'isEnabled' | 'isExclusive' | 'description' | 'notifications'> & {
90
97
  actions: DistributiveOptional<ScheduleAction, 'id'>[];
@@ -126,6 +133,9 @@ export interface ScheduledActorRunOptions {
126
133
  build: string;
127
134
  timeoutSecs: number;
128
135
  memoryMbytes: number;
136
+ /**
137
+ * @since Added in 2.19.0
138
+ */
129
139
  restartOnError?: boolean;
130
140
  }
131
141
  /**
@@ -21,6 +21,7 @@ import type { ActorStats } from './actor';
21
21
  * ```
22
22
  *
23
23
  * @see https://docs.apify.com/platform/actors/publishing
24
+ * @since Added in 2.7.2
24
25
  */
25
26
  export declare class StoreCollectionClient extends ResourceCollectionClient {
26
27
  /**
@@ -49,9 +50,15 @@ export declare class StoreCollectionClient extends ResourceCollectionClient {
49
50
  */
50
51
  list(options?: StoreCollectionListOptions): PaginatedIterator<ActorStoreList>;
51
52
  }
53
+ /**
54
+ * @since Added in 2.7.2
55
+ */
52
56
  export interface PricingInfo {
53
57
  pricingModel: string;
54
58
  }
59
+ /**
60
+ * @since Added in 2.7.2
61
+ */
55
62
  export interface ActorStoreList {
56
63
  id: string;
57
64
  name: string;
@@ -62,10 +69,19 @@ export interface ActorStoreList {
62
69
  currentPricingInfo: PricingInfo;
63
70
  pictureUrl?: string;
64
71
  userPictureUrl?: string;
72
+ /**
73
+ * @since Added in 2.8.6
74
+ */
65
75
  url: string;
66
- /** A brief, LLM-generated readme summary */
76
+ /**
77
+ * A brief, LLM-generated readme summary
78
+ * @since Added in 2.22.1
79
+ */
67
80
  readmeSummary?: string;
68
81
  }
82
+ /**
83
+ * @since Added in 2.7.2
84
+ */
69
85
  export interface StoreCollectionListOptions extends PaginationOptions {
70
86
  search?: string;
71
87
  sortBy?: string;
@@ -75,6 +91,7 @@ export interface StoreCollectionListOptions extends PaginationOptions {
75
91
  /**
76
92
  * If true, the response will include Actors that cannot be run (e.g., Actors
77
93
  * that require a linked integration account that the current user does not have).
94
+ * @since Added in 2.23.0
78
95
  */
79
96
  includeUnrunnableActors?: boolean;
80
97
  }
@@ -23,6 +23,7 @@ const resource_collection_client_1 = require("../base/resource_collection_client
23
23
  * ```
24
24
  *
25
25
  * @see https://docs.apify.com/platform/actors/publishing
26
+ * @since Added in 2.7.2
26
27
  */
27
28
  class StoreCollectionClient extends resource_collection_client_1.ResourceCollectionClient {
28
29
  /**
@@ -55,6 +55,7 @@ export declare class TaskClient extends ResourceClient {
55
55
  *
56
56
  * @returns The task object.
57
57
  * @see https://docs.apify.com/api/v2/actor-task-put
58
+ * @since Added in 2.25.0
58
59
  */
59
60
  publish(): Promise<Task>;
60
61
  /**
@@ -67,6 +68,7 @@ export declare class TaskClient extends ResourceClient {
67
68
  *
68
69
  * @returns The task object.
69
70
  * @see https://docs.apify.com/api/v2/actor-task-put
71
+ * @since Added in 2.25.0
70
72
  */
71
73
  unpublish(): Promise<Task>;
72
74
  /**
@@ -161,6 +163,9 @@ export interface Task {
161
163
  userId: string;
162
164
  actId: string;
163
165
  name: string;
166
+ /**
167
+ * @since Added in 2.6.1
168
+ */
164
169
  title?: string;
165
170
  description?: string;
166
171
  username?: string;
@@ -169,12 +174,19 @@ export interface Task {
169
174
  stats: TaskStats;
170
175
  options?: TaskOptions;
171
176
  input?: Dictionary | Dictionary[];
177
+ /**
178
+ * @since Added in 2.9.5
179
+ */
172
180
  actorStandby?: Partial<ActorStandby>;
173
181
  /**
174
182
  * Whether the task is published on its public landing page. Derived from
175
183
  * `publicConfig.publishedAt` — set it on update to publish or unpublish the task.
184
+ * @since Added in 2.25.0
176
185
  */
177
186
  isPublic?: boolean;
187
+ /**
188
+ * @since Added in 2.25.0
189
+ */
178
190
  publicConfig?: TaskPublicConfig | null;
179
191
  }
180
192
  /**
@@ -183,6 +195,7 @@ export interface Task {
183
195
  * The task is published when `publishedAt` is set and unpublished when it is `null`. The
184
196
  * `publishedAt` field is read-only - use {@apilink TaskClient.publish} and
185
197
  * {@apilink TaskClient.unpublish} to change the publication state.
198
+ * @since Added in 2.25.0
186
199
  */
187
200
  export interface TaskPublicConfig {
188
201
  publishedAt: Date | null;
@@ -206,6 +219,9 @@ export interface TaskOptions {
206
219
  build?: string;
207
220
  timeoutSecs?: number;
208
221
  memoryMbytes?: number;
222
+ /**
223
+ * @since Added in 2.19.0
224
+ */
209
225
  restartOnError?: boolean;
210
226
  }
211
227
  /**
@@ -224,10 +240,12 @@ export interface TaskLastRunOptions extends ActorLastRunOptions {
224
240
  *
225
241
  * Similar to {@link ActorStartOptions} but without contentType (Task input is predefined)
226
242
  * and forcePermissionLevel.
243
+ * @since Added in 2.0.4
227
244
  */
228
245
  export type TaskStartOptions = Omit<ActorStartOptions, 'contentType' | 'forcePermissionLevel'>;
229
246
  /**
230
247
  * Options for calling a Task and waiting for it to finish.
248
+ * @since Added in 2.6.2
231
249
  */
232
250
  export interface TaskCallOptions extends Omit<TaskStartOptions, 'waitForFinish'> {
233
251
  waitSecs?: number;
@@ -69,6 +69,7 @@ class TaskClient extends resource_client_1.ResourceClient {
69
69
  *
70
70
  * @returns The task object.
71
71
  * @see https://docs.apify.com/api/v2/actor-task-put
72
+ * @since Added in 2.25.0
72
73
  */
73
74
  async publish() {
74
75
  return this.update({ isPublic: true });
@@ -83,6 +84,7 @@ class TaskClient extends resource_client_1.ResourceClient {
83
84
  *
84
85
  * @returns The task object.
85
86
  * @see https://docs.apify.com/api/v2/actor-task-put
87
+ * @since Added in 2.25.0
86
88
  */
87
89
  async unpublish() {
88
90
  return this.update({ isPublic: false });
@@ -65,6 +65,9 @@ export interface TaskCollectionListOptions extends PaginationOptions {
65
65
  desc?: boolean;
66
66
  }
67
67
  export type TaskList = Omit<Task, 'options' | 'input'>;
68
+ /**
69
+ * @since Added in 2.3.0
70
+ */
68
71
  export interface TaskCreateData extends TaskUpdateData {
69
72
  actId: string;
70
73
  }
@@ -44,6 +44,7 @@ export declare class UserClient extends ResourceClient {
44
44
  *
45
45
  * @returns The monthly usage object, or `undefined` if it does not exist.
46
46
  * @see https://docs.apify.com/api/v2/users-me-usage-monthly-get
47
+ * @since Added in 2.9.2
47
48
  */
48
49
  monthlyUsage(): Promise<MonthlyUsage | undefined>;
49
50
  /**
@@ -51,6 +52,7 @@ export declare class UserClient extends ResourceClient {
51
52
  *
52
53
  * @returns The account and usage limits object, or `undefined` if it does not exist.
53
54
  * @see https://docs.apify.com/api/v2/users-me-limits-get
55
+ * @since Added in 2.9.2
54
56
  */
55
57
  limits(): Promise<AccountAndUsageLimits | undefined>;
56
58
  /**
@@ -58,6 +60,7 @@ export declare class UserClient extends ResourceClient {
58
60
  *
59
61
  * @param options - The new limits to set.
60
62
  * @see https://docs.apify.com/api/v2/users-me-limits-put
63
+ * @since Added in 2.10.0
61
64
  */
62
65
  updateLimits(options: LimitsUpdateOptions): Promise<void>;
63
66
  }
@@ -75,8 +78,17 @@ export interface User {
75
78
  email?: string;
76
79
  proxy?: UserProxy;
77
80
  plan?: UserPlan;
81
+ /**
82
+ * @since Added in 2.12.5
83
+ */
78
84
  effectivePlatformFeatures?: EffectivePlatformFeatures;
85
+ /**
86
+ * @since Added in 2.12.5
87
+ */
79
88
  createdAt?: Date;
89
+ /**
90
+ * @since Added in 2.12.5
91
+ */
80
92
  isPaying?: boolean;
81
93
  }
82
94
  export interface UserProxy {
@@ -138,6 +150,9 @@ interface EffectivePlatformFeatures {
138
150
  ACTORS_PUBLIC_ALL: EffectivePlatformFeature;
139
151
  ACTORS_PUBLIC_DEVELOPER: EffectivePlatformFeature;
140
152
  }
153
+ /**
154
+ * @since Added in 2.9.2
155
+ */
141
156
  export interface MonthlyUsage {
142
157
  usageCycle: UsageCycle;
143
158
  monthlyServiceUsage: {
@@ -147,6 +162,9 @@ export interface MonthlyUsage {
147
162
  totalUsageCreditsUsdBeforeVolumeDiscount: number;
148
163
  totalUsageCreditsUsdAfterVolumeDiscount: number;
149
164
  }
165
+ /**
166
+ * @since Added in 2.9.2
167
+ */
150
168
  export interface UsageCycle {
151
169
  startAt: Date;
152
170
  endAt: Date;
@@ -178,15 +196,24 @@ interface DailyServiceUsageData {
178
196
  quantity: number;
179
197
  baseAmountUsd: number;
180
198
  }
199
+ /**
200
+ * @since Added in 2.9.2
201
+ */
181
202
  export interface AccountAndUsageLimits {
182
203
  monthlyUsageCycle: MonthlyUsageCycle;
183
204
  limits: Limits;
184
205
  current: Current;
185
206
  }
207
+ /**
208
+ * @since Added in 2.9.2
209
+ */
186
210
  export interface MonthlyUsageCycle {
187
211
  startAt: Date;
188
212
  endAt: Date;
189
213
  }
214
+ /**
215
+ * @since Added in 2.9.2
216
+ */
190
217
  export interface Limits {
191
218
  maxMonthlyUsageUsd: number;
192
219
  maxMonthlyActorComputeUnits: number;
@@ -200,11 +227,17 @@ export interface Limits {
200
227
  maxTeamAccountSeatCount: number;
201
228
  dataRetentionDays: number;
202
229
  }
230
+ /**
231
+ * @since Added in 2.10.0
232
+ */
203
233
  export type LimitsUpdateOptions = {
204
234
  maxMonthlyUsageUsd: number;
205
235
  } | {
206
236
  dataRetentionDays: number;
207
237
  };
238
+ /**
239
+ * @since Added in 2.9.2
240
+ */
208
241
  export interface Current {
209
242
  monthlyUsageUsd: number;
210
243
  monthlyActorComputeUnits: number;
@@ -54,6 +54,7 @@ class UserClient extends resource_client_1.ResourceClient {
54
54
  *
55
55
  * @returns The monthly usage object, or `undefined` if it does not exist.
56
56
  * @see https://docs.apify.com/api/v2/users-me-usage-monthly-get
57
+ * @since Added in 2.9.2
57
58
  */
58
59
  async monthlyUsage() {
59
60
  const requestOpts = {
@@ -77,6 +78,7 @@ class UserClient extends resource_client_1.ResourceClient {
77
78
  *
78
79
  * @returns The account and usage limits object, or `undefined` if it does not exist.
79
80
  * @see https://docs.apify.com/api/v2/users-me-limits-get
81
+ * @since Added in 2.9.2
80
82
  */
81
83
  async limits() {
82
84
  const requestOpts = {
@@ -98,6 +100,7 @@ class UserClient extends resource_client_1.ResourceClient {
98
100
  *
99
101
  * @param options - The new limits to set.
100
102
  * @see https://docs.apify.com/api/v2/users-me-limits-put
103
+ * @since Added in 2.10.0
101
104
  */
102
105
  async updateLimits(options) {
103
106
  const requestOpts = {
@@ -92,9 +92,21 @@ export interface Webhook {
92
92
  payloadTemplate: string;
93
93
  lastDispatch: string;
94
94
  stats: WebhookStats;
95
+ /**
96
+ * @since Added in 2.7.2
97
+ */
95
98
  shouldInterpolateStrings: boolean;
99
+ /**
100
+ * @since Added in 2.9.4
101
+ */
96
102
  isApifyIntegration?: boolean;
103
+ /**
104
+ * @since Added in 2.8.1
105
+ */
97
106
  headersTemplate?: string;
107
+ /**
108
+ * @since Added in 2.8.1
109
+ */
98
110
  description?: string;
99
111
  }
100
112
  export interface WebhookIdempotencyKey {
@@ -41,6 +41,9 @@ export interface WebhookDispatch {
41
41
  eventType: WebhookEventType;
42
42
  calls: WebhookDispatchCall[];
43
43
  webhook: Pick<Webhook, 'requestUrl' | 'isAdHoc'>;
44
+ /**
45
+ * @since Added in 2.13.0
46
+ */
44
47
  eventData: WebhookDispatchEventData | null;
45
48
  }
46
49
  export declare enum WebhookDispatchStatus {
@@ -55,6 +58,9 @@ export interface WebhookDispatchCall {
55
58
  responseStatus: number | null;
56
59
  responseBody: string | null;
57
60
  }
61
+ /**
62
+ * @since Added in 2.13.0
63
+ */
58
64
  export interface WebhookDispatchEventData {
59
65
  actorRunId?: string;
60
66
  actorId?: string;
package/dist/utils.d.ts CHANGED
@@ -99,6 +99,7 @@ export interface PaginationOptions {
99
99
  * limit is reached or once all items from API have been fetched.
100
100
  *
101
101
  * Chunk size is usually limited by API. Minimum of those two limits will be used.
102
+ * @since Added in 2.21.0
102
103
  * */
103
104
  chunkSize?: number;
104
105
  }
@@ -145,6 +146,7 @@ export declare function asArray<T>(value: T | T[]): T[];
145
146
  * Generic dictionary type (key-value map).
146
147
  *
147
148
  * @template T - The type of values in the dictionary
149
+ * @since Added in 2.0.4
148
150
  */
149
151
  export type Dictionary<T = unknown> = Record<PropertyKey, T>;
150
152
  /**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "apify-client",
3
- "version": "2.25.1-beta.0",
3
+ "version": "2.25.1-beta.2",
4
4
  "description": "Apify API client for JavaScript",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -81,8 +81,8 @@
81
81
  "esbuild": "0.28.2",
82
82
  "express": "^5.0.0",
83
83
  "gen-esm-wrapper": "^1.1.2",
84
- "oxfmt": "0.63.0",
85
- "oxlint": "1.77.0",
84
+ "oxfmt": "0.64.0",
85
+ "oxlint": "1.78.0",
86
86
  "oxlint-tsgolint": "7.0.2001",
87
87
  "puppeteer": "^25.0.0",
88
88
  "rimraf": "^6.0.0",