@kadoa/node-sdk 0.22.0 → 0.24.0

package/dist/index.d.mts

@@ -385,13 +385,9 @@ type MonitoredFieldOperatorEnum = typeof MonitoredFieldOperatorEnum[keyof typeof
  */
 interface MonitoringConfig {
     /**
-     * Whether monitoring is enabled
+     * Fields to monitor (at least one required)
      */
-    'enabled': boolean;
-    /**
-     * Fields to monitor
-     */
-    'fields'?: Array<MonitoredField>;
+    'fields': Array<MonitoredField>;
     /**
      * Notification channels
      */
@@ -1182,10 +1178,38 @@ interface CreateCrawlerConfigRequestBlueprintInner {
 interface CreateCrawlerConfigRequestCrawlMethod {
     [key: string]: any;
     /**
-     * Crawler execution type (e.g. puppeteer, impit)
+     * Worker selection mode. \'auto\' (default) picks cheapest compatible worker, \'browser\' forces browser.
      */
-    'type': string;
+    'mode'?: CreateCrawlerConfigRequestCrawlMethodModeEnum;
+    /**
+     * Explicit Scrape V2 worker override. BrightData is blocked in crawler runtime.
+     */
+    'worker'?: CreateCrawlerConfigRequestCrawlMethodWorkerEnum;
+    /**
+     * Explicit proxy routing override for Scrape V2
+     */
+    'proxy'?: CreateCrawlerConfigRequestCrawlMethodProxyEnum;
 }
+declare const CreateCrawlerConfigRequestCrawlMethodModeEnum: {
+    readonly Auto: "auto";
+    readonly Browser: "browser";
+};
+type CreateCrawlerConfigRequestCrawlMethodModeEnum = typeof CreateCrawlerConfigRequestCrawlMethodModeEnum[keyof typeof CreateCrawlerConfigRequestCrawlMethodModeEnum];
+declare const CreateCrawlerConfigRequestCrawlMethodWorkerEnum: {
+    readonly Auto: "auto";
+    readonly CurlCffi: "curl-cffi";
+    readonly Patchright: "patchright";
+    readonly Camoufox: "camoufox";
+    readonly Brightdata: "brightdata";
+};
+type CreateCrawlerConfigRequestCrawlMethodWorkerEnum = typeof CreateCrawlerConfigRequestCrawlMethodWorkerEnum[keyof typeof CreateCrawlerConfigRequestCrawlMethodWorkerEnum];
+declare const CreateCrawlerConfigRequestCrawlMethodProxyEnum: {
+    readonly Auto: "auto";
+    readonly Dc: "dc";
+    readonly Resi: "resi";
+    readonly Isp: "isp";
+};
+type CreateCrawlerConfigRequestCrawlMethodProxyEnum = typeof CreateCrawlerConfigRequestCrawlMethodProxyEnum[keyof typeof CreateCrawlerConfigRequestCrawlMethodProxyEnum];
 
 /**
  * Kadoa API
@@ -4137,6 +4161,10 @@ interface V4ChangesGet200ResponseChangesInner {
      * URL where the change was detected
      */
     'url'?: string;
+    /**
+     * AI-generated one-sentence summary of the data change. Null if generation failed, feature is disabled, or change predates the feature.
+     */
+    'summary'?: string | null;
     /**
      * URL of the screenshot taken when the change was detected
      */
@@ -5742,13 +5770,9 @@ type V4WorkflowsWorkflowIdMetadataPutRequestMonitoringFieldsInnerOperatorEnum =
  */
 
 /**
- * The new monitoring config for the workflow
+ * The monitoring config for the workflow
  */
 interface V4WorkflowsWorkflowIdMetadataPutRequestMonitoring {
-    /**
-     * Whether monitoring is enabled for the workflow
-     */
-    'enabled'?: boolean;
     'fields'?: Array<V4WorkflowsWorkflowIdMetadataPutRequestMonitoringFieldsInner>;
     'conditions'?: V4WorkflowsWorkflowIdMetadataPutRequestMonitoringConditions;
 }
@@ -10367,13 +10391,31 @@ declare class ApiRegistry {
     get notifications(): NotificationsApi;
 }
 
+interface TeamInfo {
+    id: string;
+    name: string;
+    memberRole: string;
+    adminEmail: string | null;
+}
+interface BearerAuthOptions {
+    bearerToken: string;
+}
 interface KadoaClientStatus {
     baseUrl: string;
     user: KadoaUser;
     realtimeConnected: boolean;
 }
 interface KadoaClientConfig {
-    apiKey: string;
+    /**
+     * Team API key (`tk-...`). Required unless `bearerToken` is provided.
+     */
+    apiKey?: string;
+    /**
+     * = JWT for Bearer auth. When set, requests send
+     * `Authorization: Bearer <token>` instead of `x-api-key`.
+     * Use {@link KadoaClient.setBearerToken} to update after refresh.
+     */
+    bearerToken?: string;
     /**
      * Override the base URL for the public API.
      *
@@ -10422,6 +10464,7 @@ declare class KadoaClient {
     private readonly _axiosInstance;
     private readonly _baseUrl;
     private readonly _apiKey;
+    private _bearerToken;
     private _realtime?;
     private readonly _extractionBuilderService;
     readonly apis: ApiRegistry;
@@ -10448,9 +10491,15 @@ declare class KadoaClient {
     /**
      * Get the API key
      *
-     * @returns The API key
+     * @returns The API key (empty string when using Bearer auth)
      */
     get apiKey(): string;
+    /**
+     * Update the Bearer token used for authentication.
+     * Call this after a Supabase JWT refresh so that subsequent requests
+     * use the new token.
+     */
+    setBearerToken(token: string): void;
     /**
      * Get the realtime connection (if enabled)
      */
@@ -10486,6 +10535,24 @@ declare class KadoaClient {
      * @returns The status of the client
      */
     status(): Promise<KadoaClientStatus>;
+    /**
+     * List all teams accessible to the authenticated user.
+     *
+     * When called with a Bearer token (Supabase JWT), returns all teams the
+     * human user belongs to. Without it, falls back to x-api-key auth which
+     * only returns teams the service account (API key) belongs to.
+     */
+    listTeams(opts?: BearerAuthOptions): Promise<TeamInfo[]>;
+    /**
+     * Switch the active team for this session.
+     *
+     * Calls `POST /v5/auth/active-team` which updates the server-side
+     * session→team mapping. Subsequent requests with the same JWT are
+     * automatically scoped to the new team — no token refresh needed.
+     *
+     * @param teamId - The team ID to switch to (must be a team the user belongs to)
+     */
+    setActiveTeam(teamId: string): Promise<void>;
     /**
      * Dispose of the client and clean up resources
      */
@@ -10653,4 +10720,4 @@ declare class KadoaHttpException extends KadoaSdkException {
     static mapStatusToCode(errorOrStatus: AxiosError | number): KadoaErrorCode;
 }
 
-export { type ArtifactOptions, type BlueprintItem, type BulkApproveRulesRequest, type BulkApproveRulesResponseData, type BulkDeleteRulesRequest, type BulkDeleteRulesResponseData, type Category, type ChannelConfig, type ChannelSetupRequestConfig, type CrawlMethod, type CrawlerConfig, CrawlerConfigService, type CrawlerDomain, type CrawlerExtractionOptions, type CrawlerSession, CrawlerSessionService, type CreateChannelRequest, type CreateConfigRequest, type CreateSchemaRequest, type CreateSettingsRequest, type CreateWorkflowInput, type CreateWorkflowRequest, type CreateWorkflowWithCustomSchemaRequest, type CreatedExtraction, DataFetcherService, type DataFieldFor, type DataPagination, DataSortOrder, type DataType, type DataTypeNotRequiringExample, type DataTypeRequiringExample, type DeleteAllRulesRequest, type DeleteAllRulesResponseData, type DeleteConfigRequest, type DeleteConfigResult, type DisableRuleRequest, ERROR_MESSAGES, type EmailChannelConfig, EntityResolverService, type ExtractOptions, ExtractionBuilderService, type ExtractionOptions, type ExtractionResult, ExtractionService, FetchDataOptions, type FetchDataResult, type FieldExample, type FieldOptions, type FieldOptionsWithExample, type FieldOptionsWithoutExample, type FieldType, type FinishedExtraction, type GenerateRuleRequest, type GenerateRulesRequest, type GetAllDataOptions, type GetAnomaliesByRuleResponse, type GetAnomalyRulePageResponse, type GetBucketFileOptions, type GetJobResponse, type GetPageOptions, type GetPagesOptions, type GetValidationResponse, type GetWorkflowResponse, type JobId, JobStateEnum, type JobWaitOptions, KadoaClient, type KadoaClientConfig, type KadoaClientStatus, KadoaErrorCode, KadoaHttpException, KadoaSdkException, type KadoaUser, ListChannelsRequest, ListRulesRequest, type ListRulesResponse, type ListSessionsOptions, type ListSessionsResult, ListSettingsRequest, type ListValidationsResponse, ListWorkflowValidationsRequest, ListWorkflowsRequest, type LocationConfig, type MetadataKey, type MonitoringConfig, type MonitoringField, type MonitoringOperator, MonitoringStatus, type NavigationMode, type NavigationOptions, type NotificationChannel, type NotificationChannelConfig, NotificationChannelType, NotificationChannelsService, type NotificationDomain, type NotificationOptions, type NotificationSettings, type NotificationSettingsEventType, V5NotificationsSettingsGetEventTypeEnum as NotificationSettingsEventTypeEnum, NotificationSettingsService, type NotificationSetupRequestChannels, NotificationSetupService, type PageContent, PageStatus, type PaginationInfo, type PollingOptions, type PreparedExtraction, type RawFormat, Realtime, type RealtimeConfig, type RealtimeEvent, ResponseFormat, type Rule, RuleStatus, RuleType, type RunWorkflowRequest, type RunWorkflowResponse, type ScheduleValidationResponse, SchemaBuilder, type SchemaField as SchemaDefinitionField, type SchemaField$1 as SchemaField, SchemaFieldDataType, type SchemaResponse, SchemasService, type SessionDataItem, type SessionDataList, type SessionOperationResult, type SessionPage, type SessionPagesResult, type SessionStatus, type SetupWorkflowNotificationSettingsRequest, type SetupWorkspaceNotificationSettingsRequest, type SlackChannelConfig, type StartCrawlRequest, type StartSessionResult, type StartWithConfigRequest, type SubmitExtractionResult, type SubmittedExtraction, TERMINAL_JOB_STATES, TERMINAL_RUN_STATES, type TestNotificationRequest, type TestNotificationResult, type ToggleValidationResponse, UpdateInterval, type UpdateSchemaRequest, type UpdateWorkflowRequest, type UpdateWorkflowResponse, UserService, ValidationCoreService, type ValidationDomain, ValidationRulesService, ValidationStrategy, type WaitForReadyOptions, type WaitOptions, type WebhookChannelConfig, type WebhookChannelConfigAuth, type WebhookHttpMethod, type WebsocketChannelConfig, type WorkflowDataResponse, type WorkflowDetailsResponse, WorkflowDisplayStateEnum, type WorkflowId, type WorkflowInterval, type WorkflowMonitoringConfig, type WorkflowResponse, WorkflowState, WorkflowStateEnum, type WorkflowsApiInterface, WorkflowsCoreService, createCrawlerDomain, pollUntil, validateAdditionalData };
+export { type ArtifactOptions, type BearerAuthOptions, type BlueprintItem, type BulkApproveRulesRequest, type BulkApproveRulesResponseData, type BulkDeleteRulesRequest, type BulkDeleteRulesResponseData, type Category, type ChannelConfig, type ChannelSetupRequestConfig, type CrawlMethod, type CrawlerConfig, CrawlerConfigService, type CrawlerDomain, type CrawlerExtractionOptions, type CrawlerSession, CrawlerSessionService, type CreateChannelRequest, type CreateConfigRequest, type CreateSchemaRequest, type CreateSettingsRequest, type CreateWorkflowInput, type CreateWorkflowRequest, type CreateWorkflowWithCustomSchemaRequest, type CreatedExtraction, DataFetcherService, type DataFieldFor, type DataPagination, DataSortOrder, type DataType, type DataTypeNotRequiringExample, type DataTypeRequiringExample, type DeleteAllRulesRequest, type DeleteAllRulesResponseData, type DeleteConfigRequest, type DeleteConfigResult, type DisableRuleRequest, ERROR_MESSAGES, type EmailChannelConfig, EntityResolverService, type ExtractOptions, ExtractionBuilderService, type ExtractionOptions, type ExtractionResult, ExtractionService, FetchDataOptions, type FetchDataResult, type FieldExample, type FieldOptions, type FieldOptionsWithExample, type FieldOptionsWithoutExample, type FieldType, type FinishedExtraction, type GenerateRuleRequest, type GenerateRulesRequest, type GetAllDataOptions, type GetAnomaliesByRuleResponse, type GetAnomalyRulePageResponse, type GetBucketFileOptions, type GetJobResponse, type GetPageOptions, type GetPagesOptions, type GetValidationResponse, type GetWorkflowResponse, type JobId, JobStateEnum, type JobWaitOptions, KadoaClient, type KadoaClientConfig, type KadoaClientStatus, KadoaErrorCode, KadoaHttpException, KadoaSdkException, type KadoaUser, ListChannelsRequest, ListRulesRequest, type ListRulesResponse, type ListSessionsOptions, type ListSessionsResult, ListSettingsRequest, type ListValidationsResponse, ListWorkflowValidationsRequest, ListWorkflowsRequest, type LocationConfig, type MetadataKey, type MonitoringConfig, type MonitoringField, type MonitoringOperator, MonitoringStatus, type NavigationMode, type NavigationOptions, type NotificationChannel, type NotificationChannelConfig, NotificationChannelType, NotificationChannelsService, type NotificationDomain, type NotificationOptions, type NotificationSettings, type NotificationSettingsEventType, V5NotificationsSettingsGetEventTypeEnum as NotificationSettingsEventTypeEnum, NotificationSettingsService, type NotificationSetupRequestChannels, NotificationSetupService, type PageContent, PageStatus, type PaginationInfo, type PollingOptions, type PreparedExtraction, type RawFormat, Realtime, type RealtimeConfig, type RealtimeEvent, ResponseFormat, type Rule, RuleStatus, RuleType, type RunWorkflowRequest, type RunWorkflowResponse, type ScheduleValidationResponse, SchemaBuilder, type SchemaField as SchemaDefinitionField, type SchemaField$1 as SchemaField, SchemaFieldDataType, type SchemaResponse, SchemasService, type SessionDataItem, type SessionDataList, type SessionOperationResult, type SessionPage, type SessionPagesResult, type SessionStatus, type SetupWorkflowNotificationSettingsRequest, type SetupWorkspaceNotificationSettingsRequest, type SlackChannelConfig, type StartCrawlRequest, type StartSessionResult, type StartWithConfigRequest, type SubmitExtractionResult, type SubmittedExtraction, TERMINAL_JOB_STATES, TERMINAL_RUN_STATES, type TeamInfo, type TestNotificationRequest, type TestNotificationResult, type ToggleValidationResponse, UpdateInterval, type UpdateSchemaRequest, type UpdateWorkflowRequest, type UpdateWorkflowResponse, UserService, ValidationCoreService, type ValidationDomain, ValidationRulesService, ValidationStrategy, type WaitForReadyOptions, type WaitOptions, type WebhookChannelConfig, type WebhookChannelConfigAuth, type WebhookHttpMethod, type WebsocketChannelConfig, type WorkflowDataResponse, type WorkflowDetailsResponse, WorkflowDisplayStateEnum, type WorkflowId, type WorkflowInterval, type WorkflowMonitoringConfig, type WorkflowResponse, WorkflowState, WorkflowStateEnum, type WorkflowsApiInterface, WorkflowsCoreService, createCrawlerDomain, pollUntil, validateAdditionalData };

package/dist/index.d.ts

@@ -385,13 +385,9 @@ type MonitoredFieldOperatorEnum = typeof MonitoredFieldOperatorEnum[keyof typeof
  */
 interface MonitoringConfig {
     /**
-     * Whether monitoring is enabled
+     * Fields to monitor (at least one required)
      */
-    'enabled': boolean;
-    /**
-     * Fields to monitor
-     */
-    'fields'?: Array<MonitoredField>;
+    'fields': Array<MonitoredField>;
     /**
      * Notification channels
      */
@@ -1182,10 +1178,38 @@ interface CreateCrawlerConfigRequestBlueprintInner {
 interface CreateCrawlerConfigRequestCrawlMethod {
     [key: string]: any;
     /**
-     * Crawler execution type (e.g. puppeteer, impit)
+     * Worker selection mode. \'auto\' (default) picks cheapest compatible worker, \'browser\' forces browser.
      */
-    'type': string;
+    'mode'?: CreateCrawlerConfigRequestCrawlMethodModeEnum;
+    /**
+     * Explicit Scrape V2 worker override. BrightData is blocked in crawler runtime.
+     */
+    'worker'?: CreateCrawlerConfigRequestCrawlMethodWorkerEnum;
+    /**
+     * Explicit proxy routing override for Scrape V2
+     */
+    'proxy'?: CreateCrawlerConfigRequestCrawlMethodProxyEnum;
 }
+declare const CreateCrawlerConfigRequestCrawlMethodModeEnum: {
+    readonly Auto: "auto";
+    readonly Browser: "browser";
+};
+type CreateCrawlerConfigRequestCrawlMethodModeEnum = typeof CreateCrawlerConfigRequestCrawlMethodModeEnum[keyof typeof CreateCrawlerConfigRequestCrawlMethodModeEnum];
+declare const CreateCrawlerConfigRequestCrawlMethodWorkerEnum: {
+    readonly Auto: "auto";
+    readonly CurlCffi: "curl-cffi";
+    readonly Patchright: "patchright";
+    readonly Camoufox: "camoufox";
+    readonly Brightdata: "brightdata";
+};
+type CreateCrawlerConfigRequestCrawlMethodWorkerEnum = typeof CreateCrawlerConfigRequestCrawlMethodWorkerEnum[keyof typeof CreateCrawlerConfigRequestCrawlMethodWorkerEnum];
+declare const CreateCrawlerConfigRequestCrawlMethodProxyEnum: {
+    readonly Auto: "auto";
+    readonly Dc: "dc";
+    readonly Resi: "resi";
+    readonly Isp: "isp";
+};
+type CreateCrawlerConfigRequestCrawlMethodProxyEnum = typeof CreateCrawlerConfigRequestCrawlMethodProxyEnum[keyof typeof CreateCrawlerConfigRequestCrawlMethodProxyEnum];
 
 /**
  * Kadoa API
@@ -4137,6 +4161,10 @@ interface V4ChangesGet200ResponseChangesInner {
      * URL where the change was detected
      */
     'url'?: string;
+    /**
+     * AI-generated one-sentence summary of the data change. Null if generation failed, feature is disabled, or change predates the feature.
+     */
+    'summary'?: string | null;
     /**
      * URL of the screenshot taken when the change was detected
      */
@@ -5742,13 +5770,9 @@ type V4WorkflowsWorkflowIdMetadataPutRequestMonitoringFieldsInnerOperatorEnum =
  */
 
 /**
- * The new monitoring config for the workflow
+ * The monitoring config for the workflow
  */
 interface V4WorkflowsWorkflowIdMetadataPutRequestMonitoring {
-    /**
-     * Whether monitoring is enabled for the workflow
-     */
-    'enabled'?: boolean;
     'fields'?: Array<V4WorkflowsWorkflowIdMetadataPutRequestMonitoringFieldsInner>;
     'conditions'?: V4WorkflowsWorkflowIdMetadataPutRequestMonitoringConditions;
 }
@@ -10367,13 +10391,31 @@ declare class ApiRegistry {
     get notifications(): NotificationsApi;
 }
 
+interface TeamInfo {
+    id: string;
+    name: string;
+    memberRole: string;
+    adminEmail: string | null;
+}
+interface BearerAuthOptions {
+    bearerToken: string;
+}
 interface KadoaClientStatus {
     baseUrl: string;
     user: KadoaUser;
     realtimeConnected: boolean;
 }
 interface KadoaClientConfig {
-    apiKey: string;
+    /**
+     * Team API key (`tk-...`). Required unless `bearerToken` is provided.
+     */
+    apiKey?: string;
+    /**
+     * = JWT for Bearer auth. When set, requests send
+     * `Authorization: Bearer <token>` instead of `x-api-key`.
+     * Use {@link KadoaClient.setBearerToken} to update after refresh.
+     */
+    bearerToken?: string;
     /**
      * Override the base URL for the public API.
      *
@@ -10422,6 +10464,7 @@ declare class KadoaClient {
     private readonly _axiosInstance;
     private readonly _baseUrl;
     private readonly _apiKey;
+    private _bearerToken;
     private _realtime?;
     private readonly _extractionBuilderService;
     readonly apis: ApiRegistry;
@@ -10448,9 +10491,15 @@ declare class KadoaClient {
     /**
      * Get the API key
      *
-     * @returns The API key
+     * @returns The API key (empty string when using Bearer auth)
      */
     get apiKey(): string;
+    /**
+     * Update the Bearer token used for authentication.
+     * Call this after a Supabase JWT refresh so that subsequent requests
+     * use the new token.
+     */
+    setBearerToken(token: string): void;
     /**
      * Get the realtime connection (if enabled)
      */
@@ -10486,6 +10535,24 @@ declare class KadoaClient {
      * @returns The status of the client
      */
     status(): Promise<KadoaClientStatus>;
+    /**
+     * List all teams accessible to the authenticated user.
+     *
+     * When called with a Bearer token (Supabase JWT), returns all teams the
+     * human user belongs to. Without it, falls back to x-api-key auth which
+     * only returns teams the service account (API key) belongs to.
+     */
+    listTeams(opts?: BearerAuthOptions): Promise<TeamInfo[]>;
+    /**
+     * Switch the active team for this session.
+     *
+     * Calls `POST /v5/auth/active-team` which updates the server-side
+     * session→team mapping. Subsequent requests with the same JWT are
+     * automatically scoped to the new team — no token refresh needed.
+     *
+     * @param teamId - The team ID to switch to (must be a team the user belongs to)
+     */
+    setActiveTeam(teamId: string): Promise<void>;
     /**
      * Dispose of the client and clean up resources
      */
@@ -10653,4 +10720,4 @@ declare class KadoaHttpException extends KadoaSdkException {
     static mapStatusToCode(errorOrStatus: AxiosError | number): KadoaErrorCode;
 }
 
-export { type ArtifactOptions, type BlueprintItem, type BulkApproveRulesRequest, type BulkApproveRulesResponseData, type BulkDeleteRulesRequest, type BulkDeleteRulesResponseData, type Category, type ChannelConfig, type ChannelSetupRequestConfig, type CrawlMethod, type CrawlerConfig, CrawlerConfigService, type CrawlerDomain, type CrawlerExtractionOptions, type CrawlerSession, CrawlerSessionService, type CreateChannelRequest, type CreateConfigRequest, type CreateSchemaRequest, type CreateSettingsRequest, type CreateWorkflowInput, type CreateWorkflowRequest, type CreateWorkflowWithCustomSchemaRequest, type CreatedExtraction, DataFetcherService, type DataFieldFor, type DataPagination, DataSortOrder, type DataType, type DataTypeNotRequiringExample, type DataTypeRequiringExample, type DeleteAllRulesRequest, type DeleteAllRulesResponseData, type DeleteConfigRequest, type DeleteConfigResult, type DisableRuleRequest, ERROR_MESSAGES, type EmailChannelConfig, EntityResolverService, type ExtractOptions, ExtractionBuilderService, type ExtractionOptions, type ExtractionResult, ExtractionService, FetchDataOptions, type FetchDataResult, type FieldExample, type FieldOptions, type FieldOptionsWithExample, type FieldOptionsWithoutExample, type FieldType, type FinishedExtraction, type GenerateRuleRequest, type GenerateRulesRequest, type GetAllDataOptions, type GetAnomaliesByRuleResponse, type GetAnomalyRulePageResponse, type GetBucketFileOptions, type GetJobResponse, type GetPageOptions, type GetPagesOptions, type GetValidationResponse, type GetWorkflowResponse, type JobId, JobStateEnum, type JobWaitOptions, KadoaClient, type KadoaClientConfig, type KadoaClientStatus, KadoaErrorCode, KadoaHttpException, KadoaSdkException, type KadoaUser, ListChannelsRequest, ListRulesRequest, type ListRulesResponse, type ListSessionsOptions, type ListSessionsResult, ListSettingsRequest, type ListValidationsResponse, ListWorkflowValidationsRequest, ListWorkflowsRequest, type LocationConfig, type MetadataKey, type MonitoringConfig, type MonitoringField, type MonitoringOperator, MonitoringStatus, type NavigationMode, type NavigationOptions, type NotificationChannel, type NotificationChannelConfig, NotificationChannelType, NotificationChannelsService, type NotificationDomain, type NotificationOptions, type NotificationSettings, type NotificationSettingsEventType, V5NotificationsSettingsGetEventTypeEnum as NotificationSettingsEventTypeEnum, NotificationSettingsService, type NotificationSetupRequestChannels, NotificationSetupService, type PageContent, PageStatus, type PaginationInfo, type PollingOptions, type PreparedExtraction, type RawFormat, Realtime, type RealtimeConfig, type RealtimeEvent, ResponseFormat, type Rule, RuleStatus, RuleType, type RunWorkflowRequest, type RunWorkflowResponse, type ScheduleValidationResponse, SchemaBuilder, type SchemaField as SchemaDefinitionField, type SchemaField$1 as SchemaField, SchemaFieldDataType, type SchemaResponse, SchemasService, type SessionDataItem, type SessionDataList, type SessionOperationResult, type SessionPage, type SessionPagesResult, type SessionStatus, type SetupWorkflowNotificationSettingsRequest, type SetupWorkspaceNotificationSettingsRequest, type SlackChannelConfig, type StartCrawlRequest, type StartSessionResult, type StartWithConfigRequest, type SubmitExtractionResult, type SubmittedExtraction, TERMINAL_JOB_STATES, TERMINAL_RUN_STATES, type TestNotificationRequest, type TestNotificationResult, type ToggleValidationResponse, UpdateInterval, type UpdateSchemaRequest, type UpdateWorkflowRequest, type UpdateWorkflowResponse, UserService, ValidationCoreService, type ValidationDomain, ValidationRulesService, ValidationStrategy, type WaitForReadyOptions, type WaitOptions, type WebhookChannelConfig, type WebhookChannelConfigAuth, type WebhookHttpMethod, type WebsocketChannelConfig, type WorkflowDataResponse, type WorkflowDetailsResponse, WorkflowDisplayStateEnum, type WorkflowId, type WorkflowInterval, type WorkflowMonitoringConfig, type WorkflowResponse, WorkflowState, WorkflowStateEnum, type WorkflowsApiInterface, WorkflowsCoreService, createCrawlerDomain, pollUntil, validateAdditionalData };
+export { type ArtifactOptions, type BearerAuthOptions, type BlueprintItem, type BulkApproveRulesRequest, type BulkApproveRulesResponseData, type BulkDeleteRulesRequest, type BulkDeleteRulesResponseData, type Category, type ChannelConfig, type ChannelSetupRequestConfig, type CrawlMethod, type CrawlerConfig, CrawlerConfigService, type CrawlerDomain, type CrawlerExtractionOptions, type CrawlerSession, CrawlerSessionService, type CreateChannelRequest, type CreateConfigRequest, type CreateSchemaRequest, type CreateSettingsRequest, type CreateWorkflowInput, type CreateWorkflowRequest, type CreateWorkflowWithCustomSchemaRequest, type CreatedExtraction, DataFetcherService, type DataFieldFor, type DataPagination, DataSortOrder, type DataType, type DataTypeNotRequiringExample, type DataTypeRequiringExample, type DeleteAllRulesRequest, type DeleteAllRulesResponseData, type DeleteConfigRequest, type DeleteConfigResult, type DisableRuleRequest, ERROR_MESSAGES, type EmailChannelConfig, EntityResolverService, type ExtractOptions, ExtractionBuilderService, type ExtractionOptions, type ExtractionResult, ExtractionService, FetchDataOptions, type FetchDataResult, type FieldExample, type FieldOptions, type FieldOptionsWithExample, type FieldOptionsWithoutExample, type FieldType, type FinishedExtraction, type GenerateRuleRequest, type GenerateRulesRequest, type GetAllDataOptions, type GetAnomaliesByRuleResponse, type GetAnomalyRulePageResponse, type GetBucketFileOptions, type GetJobResponse, type GetPageOptions, type GetPagesOptions, type GetValidationResponse, type GetWorkflowResponse, type JobId, JobStateEnum, type JobWaitOptions, KadoaClient, type KadoaClientConfig, type KadoaClientStatus, KadoaErrorCode, KadoaHttpException, KadoaSdkException, type KadoaUser, ListChannelsRequest, ListRulesRequest, type ListRulesResponse, type ListSessionsOptions, type ListSessionsResult, ListSettingsRequest, type ListValidationsResponse, ListWorkflowValidationsRequest, ListWorkflowsRequest, type LocationConfig, type MetadataKey, type MonitoringConfig, type MonitoringField, type MonitoringOperator, MonitoringStatus, type NavigationMode, type NavigationOptions, type NotificationChannel, type NotificationChannelConfig, NotificationChannelType, NotificationChannelsService, type NotificationDomain, type NotificationOptions, type NotificationSettings, type NotificationSettingsEventType, V5NotificationsSettingsGetEventTypeEnum as NotificationSettingsEventTypeEnum, NotificationSettingsService, type NotificationSetupRequestChannels, NotificationSetupService, type PageContent, PageStatus, type PaginationInfo, type PollingOptions, type PreparedExtraction, type RawFormat, Realtime, type RealtimeConfig, type RealtimeEvent, ResponseFormat, type Rule, RuleStatus, RuleType, type RunWorkflowRequest, type RunWorkflowResponse, type ScheduleValidationResponse, SchemaBuilder, type SchemaField as SchemaDefinitionField, type SchemaField$1 as SchemaField, SchemaFieldDataType, type SchemaResponse, SchemasService, type SessionDataItem, type SessionDataList, type SessionOperationResult, type SessionPage, type SessionPagesResult, type SessionStatus, type SetupWorkflowNotificationSettingsRequest, type SetupWorkspaceNotificationSettingsRequest, type SlackChannelConfig, type StartCrawlRequest, type StartSessionResult, type StartWithConfigRequest, type SubmitExtractionResult, type SubmittedExtraction, TERMINAL_JOB_STATES, TERMINAL_RUN_STATES, type TeamInfo, type TestNotificationRequest, type TestNotificationResult, type ToggleValidationResponse, UpdateInterval, type UpdateSchemaRequest, type UpdateWorkflowRequest, type UpdateWorkflowResponse, UserService, ValidationCoreService, type ValidationDomain, ValidationRulesService, ValidationStrategy, type WaitForReadyOptions, type WaitOptions, type WebhookChannelConfig, type WebhookChannelConfigAuth, type WebhookHttpMethod, type WebsocketChannelConfig, type WorkflowDataResponse, type WorkflowDetailsResponse, WorkflowDisplayStateEnum, type WorkflowId, type WorkflowInterval, type WorkflowMonitoringConfig, type WorkflowResponse, WorkflowState, WorkflowStateEnum, type WorkflowsApiInterface, WorkflowsCoreService, createCrawlerDomain, pollUntil, validateAdditionalData };

package/dist/index.js

@@ -6209,7 +6209,7 @@ process.env.KADOA_WSS_NEO_API_URI ?? "wss://events.kadoa.com/events/ws";
 var REALTIME_API_URI = process.env.KADOA_REALTIME_API_URI ?? "https://realtime.kadoa.com";
 
 // src/version.ts
-var SDK_VERSION = "0.22.0";
+var SDK_VERSION = "0.24.0";
 var SDK_NAME = "kadoa-node-sdk";
 var SDK_LANGUAGE = "node";
 
@@ -7184,11 +7184,27 @@ function createNotificationDomain(params) {
 // src/client/kadoa-client.ts
 var KadoaClient = class {
   constructor(config) {
+    if (!config.apiKey && !config.bearerToken) {
+      throw new KadoaSdkException(
+        "Either apiKey or bearerToken must be provided",
+        { code: "VALIDATION_ERROR" }
+      );
+    }
     this._baseUrl = config.baseUrl ?? PUBLIC_API_URI;
-    this._apiKey = config.apiKey;
+    this._apiKey = config.apiKey ?? "";
+    this._bearerToken = config.bearerToken;
     const timeout = config.timeout ?? 3e4;
     const headers = createSdkHeaders();
     this._axiosInstance = createAxiosInstance({ timeout, headers });
+    this._axiosInstance.interceptors.request.use((reqConfig) => {
+      if (this._bearerToken) {
+        if (!reqConfig.headers["Authorization"]) {
+          reqConfig.headers["Authorization"] = `Bearer ${this._bearerToken}`;
+        }
+        delete reqConfig.headers["x-api-key"];
+      }
+      return reqConfig;
+    });
     this.apis = new ApiRegistry(
       this._apiKey,
       this._baseUrl,
@@ -7226,11 +7242,19 @@ var KadoaClient = class {
   /**
    * Get the API key
    *
-   * @returns The API key
+   * @returns The API key (empty string when using Bearer auth)
    */
   get apiKey() {
     return this._apiKey;
   }
+  /**
+   * Update the Bearer token used for authentication.
+   * Call this after a Supabase JWT refresh so that subsequent requests
+   * use the new token.
+   */
+  setBearerToken(token) {
+    this._bearerToken = token;
+  }
   /**
    * Get the realtime connection (if enabled)
    */
@@ -7254,6 +7278,12 @@ var KadoaClient = class {
    * @returns The Realtime instance
    */
   async connectRealtime(options) {
+    if (!this._apiKey) {
+      throw new KadoaSdkException(
+        "Realtime requires an API key. Bearer-only auth is not supported for WebSocket connections.",
+        { code: "VALIDATION_ERROR" }
+      );
+    }
     if (!this._realtime) {
       this._realtime = new Realtime({ apiKey: this._apiKey, ...options });
       await this._realtime.connect();
@@ -7289,6 +7319,42 @@ var KadoaClient = class {
       realtimeConnected: this.isRealtimeConnected()
     };
   }
+  /**
+   * List all teams accessible to the authenticated user.
+   *
+   * When called with a Bearer token (Supabase JWT), returns all teams the
+   * human user belongs to. Without it, falls back to x-api-key auth which
+   * only returns teams the service account (API key) belongs to.
+   */
+  async listTeams(opts) {
+    const headers = opts?.bearerToken ? { Authorization: `Bearer ${opts.bearerToken}` } : void 0;
+    const response = await this._axiosInstance.get("/v5/user", {
+      baseURL: this._baseUrl,
+      ...headers && { headers }
+    });
+    return response.data?.teams ?? [];
+  }
+  /**
+   * Switch the active team for this session.
+   *
+   * Calls `POST /v5/auth/active-team` which updates the server-side
+   * session→team mapping. Subsequent requests with the same JWT are
+   * automatically scoped to the new team — no token refresh needed.
+   *
+   * @param teamId - The team ID to switch to (must be a team the user belongs to)
+   */
+  async setActiveTeam(teamId) {
+    if (!teamId?.trim()) {
+      throw new KadoaSdkException("teamId is required", {
+        code: "VALIDATION_ERROR"
+      });
+    }
+    await this._axiosInstance.post(
+      "/v5/auth/active-team",
+      { teamId },
+      { baseURL: this._baseUrl }
+    );
+  }
   /**
    * Dispose of the client and clean up resources
    */