apify 3.7.3-beta.9 → 4.0.0-beta.13

package/dist/actor.d.ts

@@ -1,11 +1,12 @@
-import type { ConfigurationOptions, EventManager, EventTypeName, RecordOptions, UseStateOptions } from '@crawlee/core';
+import type { EventManager, EventTypeName, RecordOptions, UseStateOptions } from '@crawlee/core';
 import { Dataset, RequestQueue } from '@crawlee/core';
 import type { Awaitable, Dictionary, SetStatusMessageOptions, StorageClient } from '@crawlee/types';
-import type { ActorCallOptions, ActorStartOptions, ApifyClient, ApifyClientOptions, RunAbortOptions, TaskCallOptions, Webhook, WebhookEventType } from 'apify-client';
-import { ActorRun as ClientActorRun } from 'apify-client';
+import type { ActorCallOptions, ActorStartOptions, ApifyClientOptions, RunAbortOptions, TaskCallOptions, Webhook, WebhookEventType } from 'apify-client';
+import { ActorRun as ClientActorRun, ApifyClient } from 'apify-client';
 import { type ACTOR_PERMISSION_LEVEL } from '@apify/consts';
 import type { ChargeOptions, ChargeResult } from './charging.js';
 import { ChargingManager } from './charging.js';
+import type { ConfigurationOptions } from './configuration.js';
 import { Configuration } from './configuration.js';
 import { KeyValueStore } from './key_value_store.js';
 import type { ProxyConfigurationOptions } from './proxy_configuration.js';
@@ -26,6 +27,20 @@ export interface InitOptions {
      */
     gracefulShutdownDelayMillis?: number;
 }
+/**
+ * Options accepted by the {@link Actor} constructor. Either pass field-level
+ * overrides (`token`, `inputKey`, …) — which the Actor turns into a fresh
+ * {@link Configuration} — or pass a pre-built `configuration` instance. When
+ * both are present, `configuration` wins and the field-level overrides are
+ * ignored.
+ */
+export type ActorOptions = ConfigurationOptions & {
+    /**
+     * Pre-built {@link Configuration} instance the Actor should use. Takes
+     * precedence over any field-level overrides also passed in `options`.
+     */
+    configuration?: Configuration;
+};
 export interface ExitOptions {
     /** Exit with given status message */
     statusMessage?: string;
@@ -328,7 +343,7 @@ export declare class Actor<Data extends Dictionary = Dictionary> {
      * @internal
      */
     purgedStorageAliases: Set<string>;
-    constructor(options?: ConfigurationOptions);
+    constructor(options?: ActorOptions);
     /**
      * Runs the main user function that performs the job of the Actor
      * and terminates the process when the user function finishes.