@kadoa/node-sdk 0.2.0 → 0.4.0

package/README.md

@@ -5,27 +5,26 @@ Official Node.js/TypeScript SDK for the Kadoa API, providing easy integration wi
 ## Installation
 
 ```bash
-npm install @kadoa/node-sdk axios
+npm install @kadoa/node-sdk
 # or
-yarn add @kadoa/node-sdk axios
+yarn add @kadoa/node-sdk
 # or
-pnpm add @kadoa/node-sdk axios
+pnpm add @kadoa/node-sdk
 ```
 
-**Note:** `axios` is required as a peer dependency.
 
 ## Quick Start
 
 ```typescript
-import { initializeSdk, runExtraction } from '@kadoa/node-sdk';
+import { KadoaClient } from '@kadoa/node-sdk';
 
-// Initialize the SDK
-const sdk = initializeSdk({
+// Initialize the client
+const client = new KadoaClient({
   apiKey: 'your-api-key'
 });
 
 // Run an extraction
-const result = await runExtraction(sdk, {
+const result = await client.extraction.run({
   urls: ['https://example.com'],
   name: 'My Extraction Workflow'
 });
@@ -40,7 +39,7 @@ if (result) {
 ### Basic Configuration
 
 ```typescript
-const sdk = initializeSdk({
+const client = new KadoaClient({
   apiKey: 'your-api-key',
   baseUrl: 'https://api.kadoa.com', // optional
   timeout: 30000                    // optional, in ms
@@ -56,12 +55,12 @@ KADOA_TIMEOUT=30000
 ```
 
 ```typescript
-import { initializeSdk } from '@kadoa/node-sdk';
+import { KadoaClient } from '@kadoa/node-sdk';
 import { config } from 'dotenv';
 
 config();
 
-const sdk = initializeSdk({
+const client = new KadoaClient({
   apiKey: process.env.KADOA_API_KEY!,
   baseUrl: process.env.KADOA_API_URL,
   timeout: parseInt(process.env.KADOA_TIMEOUT || '30000')
@@ -71,10 +70,10 @@ const sdk = initializeSdk({
 ## Event Handling
 
 ```typescript
-const sdk = initializeSdk({ apiKey: 'your-api-key' });
+const client = new KadoaClient({ apiKey: 'your-api-key' });
 
 // Listen to events
-sdk.onEvent((event) => {
+client.onEvent((event) => {
   console.log('Event:', event);
 });
 
@@ -88,18 +87,18 @@ sdk.onEvent((event) => {
 
 ## API Reference
 
-### initializeSdk(config)
+### new KadoaClient(config)
 - `apiKey` (required): Your Kadoa API key
-- `baseUrl` (optional): API base URL
-- `timeout` (optional): Request timeout in milliseconds
+- `baseUrl` (optional): API base URL (default: 'https://api.kadoa.com')
+- `timeout` (optional): Request timeout in milliseconds (default: 30000)
 
-Returns an SDK instance with:
-- `configuration`: Current configuration
-- `axiosInstance`: Configured HTTP client
+Returns a client instance with:
+- `extraction`: Extraction module with `run()` method
 - `onEvent()`: Subscribe to events
 - `offEvent()`: Unsubscribe from events
+- `dispose()`: Releases resources and removes all event listeners
 
-### runExtraction(sdk, options)
+### client.extraction.run(options)
 - `urls`: Array of URLs to extract from
 - `name`: Workflow name
 - Additional options available in API documentation
@@ -111,7 +110,6 @@ See [examples directory](https://github.com/kadoa-org/kadoa-sdks/tree/main/examp
 ## Requirements
 
 - Node.js 22+
-- TypeScript 5+ (for TypeScript projects)
 
 ## License
 

package/dist/index.d.mts

@@ -1,6 +1,9 @@
 import { EventEmitter } from 'events';
 import { AxiosError, AxiosInstance } from 'axios';
 
+/**
+ * Event payload definitions for entity detection
+ */
 type EntityEventPayloads = {
     "entity:detected": {
         /** Name of the detected entity type (e.g., "Product", "Article", "Job Listing") */
@@ -17,6 +20,9 @@ type EntityEventPayloads = {
         url: string;
     };
 };
+/**
+ * Event payload definitions for extraction workflow
+ */
 type ExtractionEventPayloads = {
     "extraction:started": {
         /** Unique ID of the extraction process */
@@ -61,6 +67,9 @@ type ExtractionEventPayloads = {
         error?: string;
     };
 };
+/**
+ * Combined event payload map for all SDK events
+ */
 type EventPayloadMap = EntityEventPayloads & ExtractionEventPayloads;
 
 /**
@@ -119,11 +128,57 @@ declare class KadoaSdkException extends Error {
     readonly code: KadoaErrorCode;
     readonly details?: Record<string, unknown>;
     readonly cause?: unknown;
+    static readonly ERROR_MESSAGES: {
+        readonly CONFIG_ERROR: "Invalid configuration provided";
+        readonly AUTH_FAILED: "Authentication failed. Please check your API key";
+        readonly RATE_LIMITED: "Rate limit exceeded. Please try again later";
+        readonly NETWORK_ERROR: "Network error occurred";
+        readonly SERVER_ERROR: "Server error occurred";
+        readonly PARSE_ERROR: "Failed to parse response";
+        readonly NO_WORKFLOW_ID: "Failed to start extraction process - no ID received";
+        readonly WORKFLOW_CREATE_FAILED: "Failed to create workflow";
+        readonly WORKFLOW_TIMEOUT: "Workflow processing timed out";
+        readonly WORKFLOW_UNEXPECTED_STATUS: "Extraction completed with unexpected status";
+        readonly PROGRESS_CHECK_FAILED: "Failed to check extraction progress";
+        readonly DATA_FETCH_FAILED: "Failed to retrieve extracted data from workflow";
+        readonly NO_URLS: "At least one URL is required for extraction";
+        readonly NO_API_KEY: "API key is required for entity detection";
+        readonly LINK_REQUIRED: "Link is required for entity field detection";
+        readonly NO_PREDICTIONS: "No entity predictions returned from the API";
+        readonly EXTRACTION_FAILED: "Data extraction failed for the provided URLs";
+        readonly ENTITY_FETCH_FAILED: "Failed to fetch entity fields";
+    };
     constructor(message: string, options?: KadoaSdkExceptionOptions);
     static from(error: unknown, details?: Record<string, unknown>): KadoaSdkException;
     toJSON(): Record<string, unknown>;
     toString(): string;
+    toDetailedString(): string;
+    static isInstance(error: unknown): error is KadoaSdkException;
+    static wrap(error: unknown, extra?: {
+        message?: string;
+        details?: Record<string, unknown>;
+    }): KadoaSdkException;
 }
+declare const ERROR_MESSAGES: {
+    readonly CONFIG_ERROR: "Invalid configuration provided";
+    readonly AUTH_FAILED: "Authentication failed. Please check your API key";
+    readonly RATE_LIMITED: "Rate limit exceeded. Please try again later";
+    readonly NETWORK_ERROR: "Network error occurred";
+    readonly SERVER_ERROR: "Server error occurred";
+    readonly PARSE_ERROR: "Failed to parse response";
+    readonly NO_WORKFLOW_ID: "Failed to start extraction process - no ID received";
+    readonly WORKFLOW_CREATE_FAILED: "Failed to create workflow";
+    readonly WORKFLOW_TIMEOUT: "Workflow processing timed out";
+    readonly WORKFLOW_UNEXPECTED_STATUS: "Extraction completed with unexpected status";
+    readonly PROGRESS_CHECK_FAILED: "Failed to check extraction progress";
+    readonly DATA_FETCH_FAILED: "Failed to retrieve extracted data from workflow";
+    readonly NO_URLS: "At least one URL is required for extraction";
+    readonly NO_API_KEY: "API key is required for entity detection";
+    readonly LINK_REQUIRED: "Link is required for entity field detection";
+    readonly NO_PREDICTIONS: "No entity predictions returned from the API";
+    readonly EXTRACTION_FAILED: "Data extraction failed for the provided URLs";
+    readonly ENTITY_FETCH_FAILED: "Failed to fetch entity fields";
+};
 
 type KadoaHttpExceptionOptions = {
     httpStatus?: number;
@@ -147,12 +202,14 @@ declare class KadoaHttpException extends KadoaSdkException {
         details?: Record<string, unknown>;
     }): KadoaHttpException;
     toJSON(): Record<string, unknown>;
-    private static mapStatusToCode;
+    toDetailedString(): string;
+    static wrap(error: unknown, extra?: {
+        message?: string;
+        details?: Record<string, unknown>;
+    }): KadoaSdkException | KadoaHttpException;
+    static mapStatusToCode(errorOrStatus: AxiosError | number): KadoaErrorCode;
 }
 
-declare function isKadoaSdkException(error: unknown): error is KadoaSdkException;
-declare function isKadoaHttpException(error: unknown): error is KadoaHttpException;
-
 /**
  * Kadoa API
  * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
@@ -812,48 +869,6 @@ declare const V4WorkflowsWorkflowIdGet200ResponseSchemaTypeEnum: {
 };
 type V4WorkflowsWorkflowIdGet200ResponseSchemaTypeEnum = typeof V4WorkflowsWorkflowIdGet200ResponseSchemaTypeEnum[keyof typeof V4WorkflowsWorkflowIdGet200ResponseSchemaTypeEnum];
 
-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 NavigationMode = (typeof WorkflowWithExistingSchemaNavigationModeEnum)[keyof typeof WorkflowWithExistingSchemaNavigationModeEnum];
 interface ExtractionConfig {
     urls: string[];
@@ -864,6 +879,7 @@ interface ExtractionConfig {
     };
     pollingInterval: number;
     maxWaitTime: number;
+    maxRecords: number;
 }
 type ExtractionOptions = {
     urls: string[];
@@ -875,12 +891,115 @@ interface ExtractionResult {
 }
 
 /**
- * Run extraction workflow using dynamic entity detection
+ * ExtractionModule provides extraction-related functionality
+ */
+declare class ExtractionModule {
+    private readonly runExtractionCommand;
+    constructor(client: KadoaClient);
+    /**
+     * Run extraction workflow using dynamic entity detection
+     *
+     * @param options Extraction configuration options
+     * @returns ExtractionResult containing workflow ID, workflow details, and extracted data
+     *
+     * @example
+     * ```typescript
+     * const result = await client.extraction.run({
+     *   urls: ['https://example.com'],
+     *   name: 'My Extraction'
+     * });
+     * ```
+     */
+    run(options: ExtractionOptions): Promise<ExtractionResult>;
+}
+
+interface KadoaClientConfig {
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+/**
+ * KadoaClient provides an object-oriented interface to the Kadoa SDK
+ *
+ * @example
+ * ```typescript
+ * import { KadoaClient } from '@kadoa/sdk';
+ *
+ * const client = new KadoaClient({
+ *   apiKey: 'your-api-key'
+ * });
  *
- * @param sdkInstance The Kadoa SDK instance
- * @param options Extraction configuration options
- * @returns ExtractionResult containing workflow ID, workflow details, and extracted data
+ * const result = await client.extraction.run({
+ *   urls: ['https://example.com'],
+ *   name: 'My Extraction'
+ * });
+ * ```
  */
-declare function runExtraction(sdkInstance: KadoaSDK, options: ExtractionOptions): Promise<ExtractionResult>;
+declare class KadoaClient {
+    private readonly _configuration;
+    private readonly _axiosInstance;
+    private readonly _baseUrl;
+    private readonly _timeout;
+    private readonly _events;
+    readonly extraction: ExtractionModule;
+    constructor(config: KadoaClientConfig);
+    /**
+     * Register an event listener
+     *
+     * @param listener Function to handle events
+     */
+    onEvent(listener: (event: AnyKadoaEvent) => void): void;
+    /**
+     * Remove an event listener
+     *
+     * @param listener Function to remove from event handlers
+     */
+    offEvent(listener: (event: AnyKadoaEvent) => void): void;
+    /**
+     * Emit an event
+     * @internal
+     *
+     * @param eventName The name of the event
+     * @param payload The event payload
+     * @param source Optional source identifier
+     * @param metadata Optional metadata
+     */
+    emit<T extends KadoaEventName>(eventName: T, payload: EventPayloadMap[T], source?: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Get the underlying configuration
+     *
+     * @returns The configuration object
+     */
+    get configuration(): Configuration;
+    /**
+     * Get the axios instance
+     *
+     * @returns The axios instance
+     */
+    get axiosInstance(): AxiosInstance;
+    /**
+     * Get the base URL
+     *
+     * @returns The base URL
+     */
+    get baseUrl(): string;
+    /**
+     * Get the timeout value
+     *
+     * @returns The timeout in milliseconds
+     */
+    get timeout(): number;
+    /**
+     * Get the event emitter
+     * @internal
+     *
+     * @returns The event emitter
+     */
+    get events(): KadoaEventEmitter;
+    /**
+     * Dispose of the client and clean up resources
+     */
+    dispose(): void;
+}
 
-export { type ExtractionOptions, type ExtractionResult, type KadoaConfig, type KadoaErrorCode, type KadoaEvent, KadoaEventEmitter, KadoaHttpException, type KadoaSDK, KadoaSdkException, dispose, initializeSdk, isKadoaHttpException, isKadoaSdkException, runExtraction };
+export { ERROR_MESSAGES, type ExtractionOptions, type ExtractionResult, KadoaClient, type KadoaClientConfig, type KadoaErrorCode, type KadoaEvent, KadoaEventEmitter, KadoaHttpException, KadoaSdkException };

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 import { EventEmitter } from 'events';
 import { AxiosError, AxiosInstance } from 'axios';
 
+/**
+ * Event payload definitions for entity detection
+ */
 type EntityEventPayloads = {
     "entity:detected": {
         /** Name of the detected entity type (e.g., "Product", "Article", "Job Listing") */
@@ -17,6 +20,9 @@ type EntityEventPayloads = {
         url: string;
     };
 };
+/**
+ * Event payload definitions for extraction workflow
+ */
 type ExtractionEventPayloads = {
     "extraction:started": {
         /** Unique ID of the extraction process */
@@ -61,6 +67,9 @@ type ExtractionEventPayloads = {
         error?: string;
     };
 };
+/**
+ * Combined event payload map for all SDK events
+ */
 type EventPayloadMap = EntityEventPayloads & ExtractionEventPayloads;
 
 /**
@@ -119,11 +128,57 @@ declare class KadoaSdkException extends Error {
     readonly code: KadoaErrorCode;
     readonly details?: Record<string, unknown>;
     readonly cause?: unknown;
+    static readonly ERROR_MESSAGES: {
+        readonly CONFIG_ERROR: "Invalid configuration provided";
+        readonly AUTH_FAILED: "Authentication failed. Please check your API key";
+        readonly RATE_LIMITED: "Rate limit exceeded. Please try again later";
+        readonly NETWORK_ERROR: "Network error occurred";
+        readonly SERVER_ERROR: "Server error occurred";
+        readonly PARSE_ERROR: "Failed to parse response";
+        readonly NO_WORKFLOW_ID: "Failed to start extraction process - no ID received";
+        readonly WORKFLOW_CREATE_FAILED: "Failed to create workflow";
+        readonly WORKFLOW_TIMEOUT: "Workflow processing timed out";
+        readonly WORKFLOW_UNEXPECTED_STATUS: "Extraction completed with unexpected status";
+        readonly PROGRESS_CHECK_FAILED: "Failed to check extraction progress";
+        readonly DATA_FETCH_FAILED: "Failed to retrieve extracted data from workflow";
+        readonly NO_URLS: "At least one URL is required for extraction";
+        readonly NO_API_KEY: "API key is required for entity detection";
+        readonly LINK_REQUIRED: "Link is required for entity field detection";
+        readonly NO_PREDICTIONS: "No entity predictions returned from the API";
+        readonly EXTRACTION_FAILED: "Data extraction failed for the provided URLs";
+        readonly ENTITY_FETCH_FAILED: "Failed to fetch entity fields";
+    };
     constructor(message: string, options?: KadoaSdkExceptionOptions);
     static from(error: unknown, details?: Record<string, unknown>): KadoaSdkException;
     toJSON(): Record<string, unknown>;
     toString(): string;
+    toDetailedString(): string;
+    static isInstance(error: unknown): error is KadoaSdkException;
+    static wrap(error: unknown, extra?: {
+        message?: string;
+        details?: Record<string, unknown>;
+    }): KadoaSdkException;
 }
+declare const ERROR_MESSAGES: {
+    readonly CONFIG_ERROR: "Invalid configuration provided";
+    readonly AUTH_FAILED: "Authentication failed. Please check your API key";
+    readonly RATE_LIMITED: "Rate limit exceeded. Please try again later";
+    readonly NETWORK_ERROR: "Network error occurred";
+    readonly SERVER_ERROR: "Server error occurred";
+    readonly PARSE_ERROR: "Failed to parse response";
+    readonly NO_WORKFLOW_ID: "Failed to start extraction process - no ID received";
+    readonly WORKFLOW_CREATE_FAILED: "Failed to create workflow";
+    readonly WORKFLOW_TIMEOUT: "Workflow processing timed out";
+    readonly WORKFLOW_UNEXPECTED_STATUS: "Extraction completed with unexpected status";
+    readonly PROGRESS_CHECK_FAILED: "Failed to check extraction progress";
+    readonly DATA_FETCH_FAILED: "Failed to retrieve extracted data from workflow";
+    readonly NO_URLS: "At least one URL is required for extraction";
+    readonly NO_API_KEY: "API key is required for entity detection";
+    readonly LINK_REQUIRED: "Link is required for entity field detection";
+    readonly NO_PREDICTIONS: "No entity predictions returned from the API";
+    readonly EXTRACTION_FAILED: "Data extraction failed for the provided URLs";
+    readonly ENTITY_FETCH_FAILED: "Failed to fetch entity fields";
+};
 
 type KadoaHttpExceptionOptions = {
     httpStatus?: number;
@@ -147,12 +202,14 @@ declare class KadoaHttpException extends KadoaSdkException {
         details?: Record<string, unknown>;
     }): KadoaHttpException;
     toJSON(): Record<string, unknown>;
-    private static mapStatusToCode;
+    toDetailedString(): string;
+    static wrap(error: unknown, extra?: {
+        message?: string;
+        details?: Record<string, unknown>;
+    }): KadoaSdkException | KadoaHttpException;
+    static mapStatusToCode(errorOrStatus: AxiosError | number): KadoaErrorCode;
 }
 
-declare function isKadoaSdkException(error: unknown): error is KadoaSdkException;
-declare function isKadoaHttpException(error: unknown): error is KadoaHttpException;
-
 /**
  * Kadoa API
  * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
@@ -812,48 +869,6 @@ declare const V4WorkflowsWorkflowIdGet200ResponseSchemaTypeEnum: {
 };
 type V4WorkflowsWorkflowIdGet200ResponseSchemaTypeEnum = typeof V4WorkflowsWorkflowIdGet200ResponseSchemaTypeEnum[keyof typeof V4WorkflowsWorkflowIdGet200ResponseSchemaTypeEnum];
 
-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 NavigationMode = (typeof WorkflowWithExistingSchemaNavigationModeEnum)[keyof typeof WorkflowWithExistingSchemaNavigationModeEnum];
 interface ExtractionConfig {
     urls: string[];
@@ -864,6 +879,7 @@ interface ExtractionConfig {
     };
     pollingInterval: number;
     maxWaitTime: number;
+    maxRecords: number;
 }
 type ExtractionOptions = {
     urls: string[];
@@ -875,12 +891,115 @@ interface ExtractionResult {
 }
 
 /**
- * Run extraction workflow using dynamic entity detection
+ * ExtractionModule provides extraction-related functionality
+ */
+declare class ExtractionModule {
+    private readonly runExtractionCommand;
+    constructor(client: KadoaClient);
+    /**
+     * Run extraction workflow using dynamic entity detection
+     *
+     * @param options Extraction configuration options
+     * @returns ExtractionResult containing workflow ID, workflow details, and extracted data
+     *
+     * @example
+     * ```typescript
+     * const result = await client.extraction.run({
+     *   urls: ['https://example.com'],
+     *   name: 'My Extraction'
+     * });
+     * ```
+     */
+    run(options: ExtractionOptions): Promise<ExtractionResult>;
+}
+
+interface KadoaClientConfig {
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+/**
+ * KadoaClient provides an object-oriented interface to the Kadoa SDK
+ *
+ * @example
+ * ```typescript
+ * import { KadoaClient } from '@kadoa/sdk';
+ *
+ * const client = new KadoaClient({
+ *   apiKey: 'your-api-key'
+ * });
  *
- * @param sdkInstance The Kadoa SDK instance
- * @param options Extraction configuration options
- * @returns ExtractionResult containing workflow ID, workflow details, and extracted data
+ * const result = await client.extraction.run({
+ *   urls: ['https://example.com'],
+ *   name: 'My Extraction'
+ * });
+ * ```
  */
-declare function runExtraction(sdkInstance: KadoaSDK, options: ExtractionOptions): Promise<ExtractionResult>;
+declare class KadoaClient {
+    private readonly _configuration;
+    private readonly _axiosInstance;
+    private readonly _baseUrl;
+    private readonly _timeout;
+    private readonly _events;
+    readonly extraction: ExtractionModule;
+    constructor(config: KadoaClientConfig);
+    /**
+     * Register an event listener
+     *
+     * @param listener Function to handle events
+     */
+    onEvent(listener: (event: AnyKadoaEvent) => void): void;
+    /**
+     * Remove an event listener
+     *
+     * @param listener Function to remove from event handlers
+     */
+    offEvent(listener: (event: AnyKadoaEvent) => void): void;
+    /**
+     * Emit an event
+     * @internal
+     *
+     * @param eventName The name of the event
+     * @param payload The event payload
+     * @param source Optional source identifier
+     * @param metadata Optional metadata
+     */
+    emit<T extends KadoaEventName>(eventName: T, payload: EventPayloadMap[T], source?: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Get the underlying configuration
+     *
+     * @returns The configuration object
+     */
+    get configuration(): Configuration;
+    /**
+     * Get the axios instance
+     *
+     * @returns The axios instance
+     */
+    get axiosInstance(): AxiosInstance;
+    /**
+     * Get the base URL
+     *
+     * @returns The base URL
+     */
+    get baseUrl(): string;
+    /**
+     * Get the timeout value
+     *
+     * @returns The timeout in milliseconds
+     */
+    get timeout(): number;
+    /**
+     * Get the event emitter
+     * @internal
+     *
+     * @returns The event emitter
+     */
+    get events(): KadoaEventEmitter;
+    /**
+     * Dispose of the client and clean up resources
+     */
+    dispose(): void;
+}
 
-export { type ExtractionOptions, type ExtractionResult, type KadoaConfig, type KadoaErrorCode, type KadoaEvent, KadoaEventEmitter, KadoaHttpException, type KadoaSDK, KadoaSdkException, dispose, initializeSdk, isKadoaHttpException, isKadoaSdkException, runExtraction };
+export { ERROR_MESSAGES, type ExtractionOptions, type ExtractionResult, KadoaClient, type KadoaClientConfig, type KadoaErrorCode, type KadoaEvent, KadoaEventEmitter, KadoaHttpException, KadoaSdkException };