@kadoa/node-sdk 0.0.2

package/dist/index.d.mts

@@ -0,0 +1,879 @@
+import { AxiosInstance, AxiosError } from 'axios';
+import { EventEmitter } from 'events';
+
+/**
+ * Kadoa API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 3.0.0
+ * Contact: support@kadoa.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+interface ConfigurationParameters {
+    apiKey?: string | Promise<string> | ((name: string) => string) | ((name: string) => Promise<string>);
+    username?: string;
+    password?: string;
+    accessToken?: string | Promise<string> | ((name?: string, scopes?: string[]) => string) | ((name?: string, scopes?: string[]) => Promise<string>);
+    basePath?: string;
+    serverIndex?: number;
+    baseOptions?: any;
+    formDataCtor?: new () => any;
+}
+declare class Configuration {
+    /**
+     * parameter for apiKey security
+     * @param name security name
+     * @memberof Configuration
+     */
+    apiKey?: string | Promise<string> | ((name: string) => string) | ((name: string) => Promise<string>);
+    /**
+     * parameter for basic security
+     *
+     * @type {string}
+     * @memberof Configuration
+     */
+    username?: string;
+    /**
+     * parameter for basic security
+     *
+     * @type {string}
+     * @memberof Configuration
+     */
+    password?: string;
+    /**
+     * parameter for oauth2 security
+     * @param name security name
+     * @param scopes oauth2 scope
+     * @memberof Configuration
+     */
+    accessToken?: string | Promise<string> | ((name?: string, scopes?: string[]) => string) | ((name?: string, scopes?: string[]) => Promise<string>);
+    /**
+     * override base path
+     *
+     * @type {string}
+     * @memberof Configuration
+     */
+    basePath?: string;
+    /**
+     * override server index
+     *
+     * @type {number}
+     * @memberof Configuration
+     */
+    serverIndex?: number;
+    /**
+     * base options for axios calls
+     *
+     * @type {any}
+     * @memberof Configuration
+     */
+    baseOptions?: any;
+    /**
+     * The FormData constructor that will be used to create multipart form data
+     * requests. You can inject this here so that execution environments that
+     * do not support the FormData class can still run the generated client.
+     *
+     * @type {new () => FormData}
+     */
+    formDataCtor?: new () => any;
+    constructor(param?: ConfigurationParameters);
+    /**
+     * Check if the given MIME is a JSON MIME.
+     * JSON MIME examples:
+     *   application/json
+     *   application/json; charset=UTF8
+     *   APPLICATION/JSON
+     *   application/vnd.company+json
+     * @param mime - MIME (Multipurpose Internet Mail Extensions)
+     * @return True if the given MIME is JSON, false otherwise.
+     */
+    isJsonMime(mime: string): boolean;
+}
+
+/**
+ * Kadoa API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 3.0.0
+ * Contact: support@kadoa.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Scraping location configuration
+ * @export
+ * @interface V4WorkflowsGet200ResponseWorkflowsInnerLocation
+ */
+interface V4WorkflowsGet200ResponseWorkflowsInnerLocation {
+    /**
+     *
+     * @type {string}
+     * @memberof V4WorkflowsGet200ResponseWorkflowsInnerLocation
+     */
+    'type'?: V4WorkflowsGet200ResponseWorkflowsInnerLocationTypeEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof V4WorkflowsGet200ResponseWorkflowsInnerLocation
+     */
+    'isoCode'?: V4WorkflowsGet200ResponseWorkflowsInnerLocationIsoCodeEnum;
+}
+declare const V4WorkflowsGet200ResponseWorkflowsInnerLocationTypeEnum: {
+    readonly Auto: "auto";
+    readonly Manual: "manual";
+};
+type V4WorkflowsGet200ResponseWorkflowsInnerLocationTypeEnum = typeof V4WorkflowsGet200ResponseWorkflowsInnerLocationTypeEnum[keyof typeof V4WorkflowsGet200ResponseWorkflowsInnerLocationTypeEnum];
+declare const V4WorkflowsGet200ResponseWorkflowsInnerLocationIsoCodeEnum: {
+    readonly De: "DE";
+    readonly Us: "US";
+    readonly Gb: "GB";
+    readonly Nl: "NL";
+    readonly Ca: "CA";
+};
+type V4WorkflowsGet200ResponseWorkflowsInnerLocationIsoCodeEnum = typeof V4WorkflowsGet200ResponseWorkflowsInnerLocationIsoCodeEnum[keyof typeof V4WorkflowsGet200ResponseWorkflowsInnerLocationIsoCodeEnum];
+
+/**
+ * Kadoa API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 3.0.0
+ * Contact: support@kadoa.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface V4WorkflowsGet200ResponseWorkflowsInnerNotificationConfigFieldsInner
+ */
+interface V4WorkflowsGet200ResponseWorkflowsInnerNotificationConfigFieldsInner {
+    /**
+     *
+     * @type {string}
+     * @memberof V4WorkflowsGet200ResponseWorkflowsInnerNotificationConfigFieldsInner
+     */
+    'fieldName'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof V4WorkflowsGet200ResponseWorkflowsInnerNotificationConfigFieldsInner
+     */
+    'operator'?: V4WorkflowsGet200ResponseWorkflowsInnerNotificationConfigFieldsInnerOperatorEnum;
+}
+declare const V4WorkflowsGet200ResponseWorkflowsInnerNotificationConfigFieldsInnerOperatorEnum: {
+    readonly Changed: "changed";
+    readonly Added: "added";
+    readonly Removed: "removed";
+};
+type V4WorkflowsGet200ResponseWorkflowsInnerNotificationConfigFieldsInnerOperatorEnum = typeof V4WorkflowsGet200ResponseWorkflowsInnerNotificationConfigFieldsInnerOperatorEnum[keyof typeof V4WorkflowsGet200ResponseWorkflowsInnerNotificationConfigFieldsInnerOperatorEnum];
+
+/**
+ * Kadoa API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 3.0.0
+ * Contact: support@kadoa.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Monitoring configuration
+ * @export
+ * @interface V4WorkflowsGet200ResponseWorkflowsInnerNotificationConfig
+ */
+interface V4WorkflowsGet200ResponseWorkflowsInnerNotificationConfig {
+    /**
+     *
+     * @type {boolean}
+     * @memberof V4WorkflowsGet200ResponseWorkflowsInnerNotificationConfig
+     */
+    'enabled'?: boolean;
+    /**
+     *
+     * @type {Array<V4WorkflowsGet200ResponseWorkflowsInnerNotificationConfigFieldsInner>}
+     * @memberof V4WorkflowsGet200ResponseWorkflowsInnerNotificationConfig
+     */
+    'fields'?: Array<V4WorkflowsGet200ResponseWorkflowsInnerNotificationConfigFieldsInner>;
+}
+
+/**
+ * Kadoa API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 3.0.0
+ * Contact: support@kadoa.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface V4WorkflowsGet200ResponseWorkflowsInnerSchemaInner
+ */
+interface V4WorkflowsGet200ResponseWorkflowsInnerSchemaInner {
+    /**
+     *
+     * @type {string}
+     * @memberof V4WorkflowsGet200ResponseWorkflowsInnerSchemaInner
+     */
+    'name'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof V4WorkflowsGet200ResponseWorkflowsInnerSchemaInner
+     */
+    'description'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof V4WorkflowsGet200ResponseWorkflowsInnerSchemaInner
+     */
+    'example'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof V4WorkflowsGet200ResponseWorkflowsInnerSchemaInner
+     */
+    'dataType'?: V4WorkflowsGet200ResponseWorkflowsInnerSchemaInnerDataTypeEnum;
+    /**
+     *
+     * @type {boolean}
+     * @memberof V4WorkflowsGet200ResponseWorkflowsInnerSchemaInner
+     */
+    'isPrimaryKey'?: boolean;
+    /**
+     *
+     * @type {boolean}
+     * @memberof V4WorkflowsGet200ResponseWorkflowsInnerSchemaInner
+     */
+    'isRequired'?: boolean;
+    /**
+     *
+     * @type {boolean}
+     * @memberof V4WorkflowsGet200ResponseWorkflowsInnerSchemaInner
+     */
+    'isUnique'?: boolean;
+}
+declare const V4WorkflowsGet200ResponseWorkflowsInnerSchemaInnerDataTypeEnum: {
+    readonly String: "STRING";
+    readonly Number: "NUMBER";
+    readonly Boolean: "BOOLEAN";
+    readonly Date: "DATE";
+    readonly Datetime: "DATETIME";
+    readonly Currency: "CURRENCY";
+    readonly Image: "IMAGE";
+    readonly Link: "LINK";
+    readonly Object: "OBJECT";
+    readonly Array: "ARRAY";
+};
+type V4WorkflowsGet200ResponseWorkflowsInnerSchemaInnerDataTypeEnum = typeof V4WorkflowsGet200ResponseWorkflowsInnerSchemaInnerDataTypeEnum[keyof typeof V4WorkflowsGet200ResponseWorkflowsInnerSchemaInnerDataTypeEnum];
+
+/**
+ * Kadoa API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 3.0.0
+ * Contact: support@kadoa.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+declare const WorkflowWithExistingSchemaNavigationModeEnum: {
+    readonly SinglePage: "single-page";
+    readonly PaginatedPage: "paginated-page";
+    readonly PageAndDetail: "page-and-detail";
+    readonly AgenticNavigation: "agentic-navigation";
+};
+type WorkflowWithExistingSchemaNavigationModeEnum = typeof WorkflowWithExistingSchemaNavigationModeEnum[keyof typeof WorkflowWithExistingSchemaNavigationModeEnum];
+
+/**
+ * Kadoa API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 3.0.0
+ * Contact: support@kadoa.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface V4WorkflowsWorkflowIdGet200ResponseDataLinking
+ */
+interface V4WorkflowsWorkflowIdGet200ResponseDataLinking {
+    /**
+     *
+     * @type {boolean}
+     * @memberof V4WorkflowsWorkflowIdGet200ResponseDataLinking
+     */
+    'enabled'?: boolean;
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof V4WorkflowsWorkflowIdGet200ResponseDataLinking
+     */
+    'linkingColumns'?: Array<string>;
+}
+
+/**
+ * Kadoa API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 3.0.0
+ * Contact: support@kadoa.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Data validation configuration
+ * @export
+ * @interface V4WorkflowsWorkflowIdGet200ResponseDataValidation
+ */
+interface V4WorkflowsWorkflowIdGet200ResponseDataValidation {
+    /**
+     * Whether data validation is enabled
+     * @type {boolean}
+     * @memberof V4WorkflowsWorkflowIdGet200ResponseDataValidation
+     */
+    'enabled'?: boolean;
+}
+
+/**
+ * Kadoa API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 3.0.0
+ * Contact: support@kadoa.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Validation statistics
+ * @export
+ * @interface V4WorkflowsWorkflowIdGet200ResponseValidationStatistics
+ */
+interface V4WorkflowsWorkflowIdGet200ResponseValidationStatistics {
+    /**
+     * Overall validation score
+     * @type {number}
+     * @memberof V4WorkflowsWorkflowIdGet200ResponseValidationStatistics
+     */
+    'count'?: number;
+    /**
+     * Change in validation score since last validation
+     * @type {number}
+     * @memberof V4WorkflowsWorkflowIdGet200ResponseValidationStatistics
+     */
+    'change'?: number;
+}
+
+/**
+ * Kadoa API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 3.0.0
+ * Contact: support@kadoa.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ *
+ * @export
+ * @interface V4WorkflowsWorkflowIdGet200Response
+ */
+interface V4WorkflowsWorkflowIdGet200Response {
+    /**
+     * Unique identifier for the workflow
+     * @type {string}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    '_id'?: string;
+    /**
+     * Name of the workflow
+     * @type {string}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'name'?: string;
+    /**
+     * Description of the workflow
+     * @type {string}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'description'?: string;
+    /**
+     * Current state of the workflow
+     * @type {string}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'state'?: V4WorkflowsWorkflowIdGet200ResponseStateEnum;
+    /**
+     * Display state for frontend
+     * @type {string}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'displayState'?: V4WorkflowsWorkflowIdGet200ResponseDisplayStateEnum;
+    /**
+     * ID of the user who owns the workflow
+     * @type {string}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'userId'?: string;
+    /**
+     * Timestamp when the workflow was created
+     * @type {string}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'createdAt'?: string;
+    /**
+     * Update frequency
+     * @type {string}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'updateInterval'?: string;
+    /**
+     * Cron schedules for updates
+     * @type {Array<string>}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'schedules'?: Array<string>;
+    /**
+     * Next scheduled execution time
+     * @type {string}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'nextInvocation'?: string;
+    /**
+     * Whether monitoring is enabled
+     * @type {boolean}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'monitoring'?: boolean;
+    /**
+     *
+     * @type {V4WorkflowsGet200ResponseWorkflowsInnerLocation}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'location'?: V4WorkflowsGet200ResponseWorkflowsInnerLocation;
+    /**
+     * Tags associated with the workflow
+     * @type {Array<string>}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'tags'?: Array<string>;
+    /**
+     * Name of the template used
+     * @type {string}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'templateName'?: string;
+    /**
+     * ID of the template used
+     * @type {string}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'templateId'?: string;
+    /**
+     * ID of the last job
+     * @type {string}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'jobId'?: string;
+    /**
+     * When the last job finished
+     * @type {string}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'finishedAt'?: string;
+    /**
+     * When the last job started
+     * @type {string}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'startedAt'?: string;
+    /**
+     * Protocol information from last job
+     * @type {string}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'protocol'?: string;
+    /**
+     * Database key for the workflow data
+     * @type {string}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'dataKey'?: string;
+    /**
+     * Cost of the last job run in credits
+     * @type {number}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'runCosts'?: number;
+    /**
+     * State of the last job run
+     * @type {string}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'runState'?: string;
+    /**
+     * Total number of records extracted
+     * @type {number}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'totalRecords'?: number;
+    /**
+     * Primary URL being scraped
+     * @type {string}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'url'?: string;
+    /**
+     * List of URLs being scraped
+     * @type {Array<string>}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'urls'?: Array<string>;
+    /**
+     * Extraction schema fields
+     * @type {Array<V4WorkflowsGet200ResponseWorkflowsInnerSchemaInner>}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'schema'?: Array<V4WorkflowsGet200ResponseWorkflowsInnerSchemaInner>;
+    /**
+     * Raw schema without processing
+     * @type {Array<object>}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'rawSchema'?: Array<object>;
+    /**
+     * Type of schema (deprecated)
+     * @type {string}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'schemaType'?: V4WorkflowsWorkflowIdGet200ResponseSchemaTypeEnum;
+    /**
+     * Entity information
+     * @type {object}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'entity'?: object;
+    /**
+     * Whether the schema can be edited
+     * @type {boolean}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'isSchemaEditable'?: boolean;
+    /**
+     * Maximum number of items to scrape
+     * @type {number}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'limit'?: number;
+    /**
+     * Additional static data for the workflow
+     * @type {object}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'additionalData'?: object;
+    /**
+     *
+     * @type {V4WorkflowsWorkflowIdGet200ResponseDataValidation}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'dataValidation'?: V4WorkflowsWorkflowIdGet200ResponseDataValidation;
+    /**
+     * Columns configured for data linking
+     * @type {Array<string>}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'linkingColumns'?: Array<string>;
+    /**
+     *
+     * @type {V4WorkflowsWorkflowIdGet200ResponseDataLinking}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'dataLinking'?: V4WorkflowsWorkflowIdGet200ResponseDataLinking;
+    /**
+     *
+     * @type {V4WorkflowsWorkflowIdGet200ResponseValidationStatistics}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'validationStatistics'?: V4WorkflowsWorkflowIdGet200ResponseValidationStatistics;
+    /**
+     *
+     * @type {V4WorkflowsGet200ResponseWorkflowsInnerNotificationConfig}
+     * @memberof V4WorkflowsWorkflowIdGet200Response
+     */
+    'notificationConfig'?: V4WorkflowsGet200ResponseWorkflowsInnerNotificationConfig;
+}
+declare const V4WorkflowsWorkflowIdGet200ResponseStateEnum: {
+    readonly Active: "ACTIVE";
+    readonly Error: "ERROR";
+    readonly Paused: "PAUSED";
+    readonly NotSupported: "NOT_SUPPORTED";
+    readonly Preview: "PREVIEW";
+    readonly ComplianceReview: "COMPLIANCE_REVIEW";
+    readonly ComplianceRejected: "COMPLIANCE_REJECTED";
+    readonly Queued: "QUEUED";
+    readonly Setup: "SETUP";
+    readonly Deleted: "DELETED";
+};
+type V4WorkflowsWorkflowIdGet200ResponseStateEnum = typeof V4WorkflowsWorkflowIdGet200ResponseStateEnum[keyof typeof V4WorkflowsWorkflowIdGet200ResponseStateEnum];
+declare const V4WorkflowsWorkflowIdGet200ResponseDisplayStateEnum: {
+    readonly Active: "ACTIVE";
+    readonly Error: "ERROR";
+    readonly Paused: "PAUSED";
+    readonly NotSupported: "NOT_SUPPORTED";
+    readonly Preview: "PREVIEW";
+    readonly ComplianceReview: "COMPLIANCE_REVIEW";
+    readonly ComplianceRejected: "COMPLIANCE_REJECTED";
+    readonly Queued: "QUEUED";
+    readonly Setup: "SETUP";
+    readonly Running: "RUNNING";
+};
+type V4WorkflowsWorkflowIdGet200ResponseDisplayStateEnum = typeof V4WorkflowsWorkflowIdGet200ResponseDisplayStateEnum[keyof typeof V4WorkflowsWorkflowIdGet200ResponseDisplayStateEnum];
+declare const V4WorkflowsWorkflowIdGet200ResponseSchemaTypeEnum: {
+    readonly Detail: "DETAIL";
+    readonly Directory: "DIRECTORY";
+};
+type V4WorkflowsWorkflowIdGet200ResponseSchemaTypeEnum = typeof V4WorkflowsWorkflowIdGet200ResponseSchemaTypeEnum[keyof typeof V4WorkflowsWorkflowIdGet200ResponseSchemaTypeEnum];
+
+type EntityEventPayloads = {
+    "entity:detected": {
+        /** Name of the detected entity type (e.g., "Product", "Article", "Job Listing") */
+        entity: string;
+        /** Data fields detected for the entity */
+        fields: Array<{
+            name: string;
+            description: string;
+            example: string;
+            dataType: string | Record<string, unknown>;
+            isPrimaryKey?: boolean;
+        }>;
+        /** URL that was analyzed for entity detection */
+        url: string;
+    };
+};
+type ExtractionEventPayloads = {
+    "extraction:started": {
+        /** Unique ID of the extraction process */
+        workflowId: string;
+        /** Name given to this extraction */
+        name: string;
+        /** URLs to extract data from */
+        urls: string[];
+    };
+    "extraction:status_changed": {
+        /** Unique ID of the extraction process */
+        workflowId: string;
+        /** Previous processing state */
+        previousState?: string;
+        /** Previous execution status */
+        previousRunState?: string;
+        /** Current processing state */
+        currentState?: string;
+        /** Current execution status */
+        currentRunState?: string;
+    };
+    "extraction:data_available": {
+        /** Unique ID of the extraction process */
+        workflowId: string;
+        /** Number of data records retrieved */
+        recordCount: number;
+        /** Whether this is a partial data set */
+        isPartial: boolean;
+    };
+    "extraction:completed": {
+        /** Unique ID of the extraction process */
+        workflowId: string;
+        /** Whether the extraction completed successfully */
+        success: boolean;
+        /** Final execution status */
+        finalRunState?: string;
+        /** Final processing state */
+        finalState?: string;
+        /** Number of records extracted (if successful) */
+        recordCount?: number;
+        /** Error message (if failed) */
+        error?: string;
+    };
+};
+type EventPayloadMap = EntityEventPayloads & ExtractionEventPayloads;
+
+/**
+ * Unified event structure with discriminated union
+ */
+interface KadoaEvent<T extends keyof EventPayloadMap = keyof EventPayloadMap> {
+    /** Event type identifier */
+    type: T;
+    /** ISO timestamp when the event occurred */
+    timestamp: Date;
+    /** Module or component that emitted the event */
+    source: string;
+    /** Event-specific payload */
+    payload: EventPayloadMap[T];
+    /** Optional metadata for debugging and tracking */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Type aliases for convenience
+ */
+type KadoaEventName = keyof EventPayloadMap;
+type KadoaEventPayload<T extends KadoaEventName> = EventPayloadMap[T];
+type AnyKadoaEvent = KadoaEvent<KadoaEventName>;
+/**
+ * Simplified type-safe event emitter for Kadoa SDK events
+ */
+declare class KadoaEventEmitter extends EventEmitter {
+    /**
+     * Emit a typed SDK event
+     */
+    emit<T extends KadoaEventName>(eventName: T, payload: EventPayloadMap[T], source?: string, metadata?: Record<string, unknown>): boolean;
+    /**
+     * Subscribe to SDK events
+     */
+    onEvent(listener: (event: AnyKadoaEvent) => void): this;
+    /**
+     * Subscribe to SDK events (once)
+     */
+    onceEvent(listener: (event: AnyKadoaEvent) => void): this;
+    /**
+     * Unsubscribe from SDK events
+     */
+    offEvent(listener: (event: AnyKadoaEvent) => void): this;
+    /**
+     * Remove all event listeners
+     */
+    removeAllEventListeners(): this;
+}
+
+interface KadoaSDK {
+    configuration: Configuration;
+    axiosInstance: AxiosInstance;
+    baseUrl: string;
+    events: KadoaEventEmitter;
+    emit: <T extends KadoaEventName>(eventName: T, payload: EventPayloadMap[T], source?: string, metadata?: Record<string, unknown>) => void;
+    onEvent: (listener: (event: AnyKadoaEvent) => void) => void;
+    offEvent: (listener: (event: AnyKadoaEvent) => void) => void;
+}
+interface KadoaConfig {
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+/**
+ * Initialize a Kadoa SDK instance
+ * @param config Configuration options for the Kadoa SDK
+ * @returns Initialized KadoaSDK instance
+ *
+ * @example
+ * ```typescript
+ * import { initializeApp } from '@kadoa/sdk';
+ *
+ * const sdkInstance = initializeApp({
+ *   apiKey: 'your-api-key'
+ * });
+ * ```
+ */
+declare function initializeSdk(config: KadoaConfig): KadoaSDK;
+/**
+ * Dispose of a KadoaApp instance and clean up resources
+ * @param sdkInstance The KadoaApp instance to dispose
+ *
+ * @example
+ * ```typescript
+ * const sdkInstance = initializeSdk({ apiKey, enableEvents: true });
+ * // ... use the app
+ * dispose(sdkInstance); // Clean up when done
+ * ```
+ */
+declare function dispose(sdkInstance: KadoaSDK): void;
+
+type ExtractionOptions = {
+    urls: string[];
+    navigationMode?: WorkflowWithExistingSchemaNavigationModeEnum;
+    name?: string;
+    location?: {
+        type: string;
+    };
+    pollingInterval?: number;
+    maxWaitTime?: number;
+};
+type ExtractionResult = {
+    workflowId: string | undefined;
+    workflow?: V4WorkflowsWorkflowIdGet200Response;
+    data?: Array<object>;
+};
+
+/**
+ * Run extraction workflow using dynamic entity detection
+ */
+declare function runExtraction(sdkInstance: KadoaSDK, options: ExtractionOptions): Promise<ExtractionResult>;
+
+type KadoaErrorCode = "UNKNOWN" | "CONFIG_ERROR" | "AUTH_ERROR" | "VALIDATION_ERROR" | "NOT_FOUND" | "RATE_LIMITED" | "TIMEOUT" | "NETWORK_ERROR" | "HTTP_ERROR" | "INTERNAL_ERROR";
+type KadoaSdkExceptionOptions = {
+    code?: KadoaErrorCode;
+    details?: Record<string, unknown>;
+    cause?: unknown;
+};
+declare class KadoaSdkException extends Error {
+    readonly code: KadoaErrorCode;
+    readonly details?: Record<string, unknown>;
+    readonly cause?: unknown;
+    constructor(message: string, options?: KadoaSdkExceptionOptions);
+    static from(error: unknown, details?: Record<string, unknown>): KadoaSdkException;
+    toJSON(): Record<string, unknown>;
+    toString(): string;
+}
+
+type KadoaHttpExceptionOptions = {
+    httpStatus?: number;
+    requestId?: string;
+    endpoint?: string;
+    method?: string;
+    responseBody?: unknown;
+    details?: Record<string, unknown>;
+    code?: KadoaErrorCode;
+    cause?: unknown;
+};
+declare class KadoaHttpException extends KadoaSdkException {
+    readonly httpStatus?: number;
+    readonly requestId?: string;
+    readonly endpoint?: string;
+    readonly method?: string;
+    readonly responseBody?: unknown;
+    constructor(message: string, options?: KadoaHttpExceptionOptions);
+    static fromAxiosError(error: AxiosError, extra?: {
+        message?: string;
+        details?: Record<string, unknown>;
+    }): KadoaHttpException;
+    toJSON(): Record<string, unknown>;
+    private static mapStatusToCode;
+}
+
+declare function isKadoaSdkException(error: unknown): error is KadoaSdkException;
+declare function isKadoaHttpException(error: unknown): error is KadoaHttpException;
+
+export { type AnyKadoaEvent, type ExtractionOptions, type ExtractionResult, type KadoaConfig, type KadoaErrorCode, type KadoaEvent, KadoaEventEmitter, type KadoaEventName, type KadoaEventPayload, KadoaHttpException, type KadoaHttpExceptionOptions, type KadoaSDK, KadoaSdkException, type KadoaSdkExceptionOptions, dispose, initializeSdk, isKadoaHttpException, isKadoaSdkException, runExtraction };