@kadoa/node-sdk 0.5.0 → 0.7.0

package/dist/index.mjs

@@ -1,8 +1,9 @@
 import { EventEmitter } from 'events';
 import globalAxios3, { isAxiosError } from 'axios';
 import { URL, URLSearchParams } from 'url';
+import { merge } from 'es-toolkit';
 
-// src/core/events/event-emitter.ts
+// src/internal/runtime/events/event-emitter.ts
 var KadoaEventEmitter = class extends EventEmitter {
   /**
    * Emit a typed SDK event
@@ -43,7 +44,7 @@ var KadoaEventEmitter = class extends EventEmitter {
   }
 };
 
-// src/core/exceptions/base.exception.ts
+// src/internal/runtime/exceptions/base.exception.ts
 var _KadoaSdkException = class _KadoaSdkException extends Error {
   constructor(message, options) {
     super(message);
@@ -2270,11 +2271,11 @@ var Configuration = class {
   }
 };
 
-// src/core/patterns/command.ts
+// src/internal/runtime/patterns/command.ts
 var Command = class {
 };
 
-// src/core/pagination/paginator.ts
+// src/internal/runtime/pagination/paginator.ts
 var PagedIterator = class {
   constructor(fetchPage) {
     this.fetchPage = fetchPage;
@@ -2394,7 +2395,7 @@ var FetchDataQuery = class {
   }
 };
 
-// src/core/config/constants.ts
+// src/internal/runtime/config/constants.ts
 var DEFAULT_API_BASE_URL = "https://api.kadoa.com";
 
 // src/modules/extraction/services/entity-detector.service.ts
@@ -2620,10 +2621,7 @@ var RunExtractionCommand = class extends Command {
    */
   async execute(options) {
     this.validateOptions(options);
-    const config = {
-      ...DEFAULT_OPTIONS,
-      ...options
-    };
+    const config = merge(DEFAULT_OPTIONS, options);
     try {
       const entityPrediction = await this.entityDetector.fetchEntityFields({
         link: config.urls[0],
@@ -2657,6 +2655,11 @@ var RunExtractionCommand = class extends Command {
         },
         "extraction"
       );
+      if (options.mode === "submit") {
+        return {
+          workflowId
+        };
+      }
       const workflow = await this.workflowManager.waitForWorkflowCompletion(
         workflowId,
         config.pollingInterval,
@@ -2771,7 +2774,10 @@ var ExtractionModule = class {
    * ```
    */
   async run(options) {
-    return this.runExtractionCommand.execute(options);
+    return this.runExtractionCommand.execute({ ...options, mode: "run" });
+  }
+  async submit(options) {
+    return this.runExtractionCommand.execute({ ...options, mode: "submit" });
   }
   /**
    * Fetch paginated data from a workflow
@@ -2831,8 +2837,125 @@ var ExtractionModule = class {
   }
 };
 
+// src/internal/domains/workflows/workflows-core.service.ts
+var TERMINAL_RUN_STATES2 = /* @__PURE__ */ new Set([
+  "FINISHED",
+  "SUCCESS",
+  "FAILED",
+  "ERROR",
+  "STOPPED",
+  "CANCELLED"
+]);
+var WorkflowsCoreService = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async create(input, _idempotencyKey) {
+    const request = {
+      urls: input.urls,
+      navigationMode: input.navigationMode,
+      entity: input.entity,
+      name: input.name,
+      fields: input.fields,
+      bypassPreview: true,
+      tags: input.tags ?? ["sdk"]
+    };
+    try {
+      const response = await this.client.workflows.v4WorkflowsPost({
+        v4WorkflowsPostRequest: request
+      });
+      const workflowId = response.data?.workflowId;
+      if (!workflowId) {
+        throw new KadoaSdkException(ERROR_MESSAGES.NO_WORKFLOW_ID, {
+          code: "INTERNAL_ERROR",
+          details: {
+            response: response.data
+          }
+        });
+      }
+      return { id: workflowId };
+    } catch (error) {
+      throw KadoaHttpException.wrap(error, {
+        message: ERROR_MESSAGES.WORKFLOW_CREATE_FAILED,
+        details: request
+      });
+    }
+  }
+  async get(id) {
+    try {
+      const response = await this.client.workflows.v4WorkflowsWorkflowIdGet({
+        workflowId: id
+      });
+      return response.data;
+    } catch (error) {
+      throw KadoaHttpException.wrap(error, {
+        message: ERROR_MESSAGES.PROGRESS_CHECK_FAILED,
+        details: { workflowId: id }
+      });
+    }
+  }
+  async cancel(id) {
+    try {
+      await this.client.workflows.v4WorkflowsWorkflowIdDelete({
+        workflowId: id
+      });
+    } catch (error) {
+      throw KadoaHttpException.wrap(error, {
+        message: ERROR_MESSAGES.WORKFLOW_CREATE_FAILED,
+        details: { workflowId: id }
+      });
+    }
+  }
+  async wait(id, options) {
+    const pollInterval = Math.max(250, options?.pollIntervalMs ?? 1e3);
+    const timeoutMs = options?.timeoutMs ?? 5 * 60 * 1e3;
+    const start = Date.now();
+    let last;
+    while (Date.now() - start < timeoutMs) {
+      if (options?.abortSignal?.aborted) {
+        throw new KadoaSdkException("Aborted");
+      }
+      const current = await this.get(id);
+      if (last?.state !== current.state || last?.runState !== current.runState) ;
+      if (current.runState && TERMINAL_RUN_STATES2.has(current.runState.toUpperCase())) {
+        return current;
+      }
+      last = current;
+      await new Promise((r) => setTimeout(r, pollInterval));
+    }
+    throw new KadoaSdkException(ERROR_MESSAGES.WORKFLOW_TIMEOUT, {
+      details: {
+        workflowId: id,
+        lastState: last?.state,
+        lastRunState: last?.runState,
+        timeoutMs
+      }
+    });
+  }
+};
+
+// src/modules/workflows/workflows.module.ts
+var WorkflowsModule = class {
+  constructor(client) {
+    this.core = new WorkflowsCoreService(client);
+  }
+  async submit(input, options) {
+    const { id } = await this.core.create(input, options?.idempotencyKey);
+    return { workflowId: id };
+  }
+  async get(workflowId) {
+    return this.core.get(workflowId);
+  }
+  async cancel(workflowId) {
+    return this.core.cancel(workflowId);
+  }
+  async wait(workflowId, options) {
+    return this.core.wait(workflowId, options);
+  }
+};
+
 // src/version.ts
-var SDK_VERSION = "0.5.0";
+var SDK_VERSION = "0.7.0";
 var SDK_NAME = "kadoa-node-sdk";
 var SDK_LANGUAGE = "node";
 
@@ -2865,6 +2988,7 @@ var KadoaClient = class {
     this._workflowsApi = config.apiOverrides?.workflows || new WorkflowsApi(this._configuration, this._baseUrl, this._axiosInstance);
     this._crawlApi = config.apiOverrides?.crawl || new CrawlApi(this._configuration, this._baseUrl, this._axiosInstance);
     this.extraction = new ExtractionModule(this);
+    this.workflow = new WorkflowsModule(this);
   }
   /**
    * Register an event listener