@unboundcx/sdk 4.13.14 → 4.13.15

package/index.js

@@ -40,6 +40,10 @@ import { SearchService } from './services/search.js';
 import { DirectoryService } from './services/directory.js';
 import { ChatService } from './services/chat.js';
 import { DeveloperApisService } from './services/developerApis.js';
+import {
+  DataImportService,
+  DataExportService,
+} from './services/dataImport.js';
 
 class UnboundSDK extends BaseSDK {
   constructor(options = {}) {
@@ -121,6 +125,8 @@ class UnboundSDK extends BaseSDK {
     this.directory = new DirectoryService(this);
     this.chat = new ChatService(this);
     this.developerApis = new DeveloperApisService(this);
+    this.dataImport = new DataImportService(this);
+    this.dataExport = new DataExportService(this);
 
     // Add additional services that might be missing
     this._initializeAdditionalServices();
@@ -316,4 +322,8 @@ export { SearchService } from './services/search.js';
 export { DirectoryService } from './services/directory.js';
 export { ChatService } from './services/chat.js';
 export { DeveloperApisService } from './services/developerApis.js';
+export {
+  DataImportService,
+  DataExportService,
+} from './services/dataImport.js';
 export { BaseSDK } from './base.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.13.14",
+  "version": "4.13.15",
   "description": "Official JavaScript SDK for the Unbound API - A comprehensive toolkit for integrating with Unbound's communication, AI, and data management services",
   "main": "index.js",
   "type": "module",

package/services/dataImport.js

@@ -0,0 +1,233 @@
+export class DataImportService {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+
+  /**
+   * Create a draft import/export job.
+   * @param {Object} [body]
+   */
+  async createJob(body = {}) {
+    return this.sdk._fetch('/dataImport/jobs', 'POST', { body });
+  }
+
+  /**
+   * Get a job by id.
+   * @param {string} id
+   */
+  async getJob(id) {
+    this.sdk.validateParams({ id }, { id: { type: 'string', required: true } });
+    return this.sdk._fetch(`/dataImport/jobs/${id}`, 'GET');
+  }
+
+  /**
+   * List jobs.
+   * @param {Object} [query]
+   */
+  async listJobs(query) {
+    if (query) {
+      return this.sdk._fetch('/dataImport/jobs', 'GET', { query });
+    }
+    return this.sdk._fetch('/dataImport/jobs', 'GET');
+  }
+
+  /**
+   * Attach a storage source file to a draft job.
+   * @param {string} jobId
+   * @param {Object} body
+   */
+  async attachSource(jobId, body = {}) {
+    this.sdk.validateParams(
+      { jobId },
+      { jobId: { type: 'string', required: true } },
+    );
+    return this.sdk._fetch(`/dataImport/jobs/${jobId}/sources`, 'POST', {
+      body,
+    });
+  }
+
+  /**
+   * Mapped+matched preview of a job's source.
+   * @param {string} jobId
+   * @param {Object} body
+   */
+  async preview(jobId, body = {}) {
+    this.sdk.validateParams(
+      { jobId },
+      { jobId: { type: 'string', required: true } },
+    );
+    return this.sdk._fetch(`/dataImport/jobs/${jobId}/preview`, 'POST', {
+      body,
+    });
+  }
+
+  /**
+   * Start a job (snapshot mapping, ACL, Zeus launch).
+   * @param {string} jobId
+   * @param {Object} [body]
+   */
+  async start(jobId, body) {
+    this.sdk.validateParams(
+      { jobId },
+      { jobId: { type: 'string', required: true } },
+    );
+    if (body !== undefined) {
+      return this.sdk._fetch(`/dataImport/jobs/${jobId}/start`, 'POST', {
+        body,
+      });
+    }
+    return this.sdk._fetch(`/dataImport/jobs/${jobId}/start`, 'POST');
+  }
+
+  /**
+   * Pause a running job.
+   * @param {string} jobId
+   */
+  async pause(jobId) {
+    this.sdk.validateParams(
+      { jobId },
+      { jobId: { type: 'string', required: true } },
+    );
+    return this.sdk._fetch(`/dataImport/jobs/${jobId}/pause`, 'POST');
+  }
+
+  /**
+   * Resume a paused job.
+   * @param {string} jobId
+   */
+  async resume(jobId) {
+    this.sdk.validateParams(
+      { jobId },
+      { jobId: { type: 'string', required: true } },
+    );
+    return this.sdk._fetch(`/dataImport/jobs/${jobId}/resume`, 'POST');
+  }
+
+  /**
+   * Cancel a job.
+   * @param {string} jobId
+   */
+  async cancel(jobId) {
+    this.sdk.validateParams(
+      { jobId },
+      { jobId: { type: 'string', required: true } },
+    );
+    return this.sdk._fetch(`/dataImport/jobs/${jobId}/cancel`, 'POST');
+  }
+
+  /**
+   * List job rows, optionally filtered.
+   * @param {string} jobId
+   * @param {Object} [query]
+   */
+  async listRows(jobId, query) {
+    this.sdk.validateParams(
+      { jobId },
+      { jobId: { type: 'string', required: true } },
+    );
+    if (query) {
+      return this.sdk._fetch(`/dataImport/jobs/${jobId}/rows`, 'GET', {
+        query,
+      });
+    }
+    return this.sdk._fetch(`/dataImport/jobs/${jobId}/rows`, 'GET');
+  }
+
+  /**
+   * Resolve an errored row.
+   * @param {string} jobId
+   * @param {string} rowId
+   * @param {Object} body
+   */
+  async resolveRow(jobId, rowId, body = {}) {
+    this.sdk.validateParams(
+      { jobId, rowId },
+      {
+        jobId: { type: 'string', required: true },
+        rowId: { type: 'string', required: true },
+      },
+    );
+    return this.sdk._fetch(
+      `/dataImport/jobs/${jobId}/rows/${rowId}/resolve`,
+      'POST',
+      { body },
+    );
+  }
+
+  /**
+   * Get a signed download URL for a completed export job.
+   * @param {string} jobId
+   */
+  async download(jobId) {
+    this.sdk.validateParams(
+      { jobId },
+      { jobId: { type: 'string', required: true } },
+    );
+    return this.sdk._fetch(`/dataImport/jobs/${jobId}/download`, 'GET');
+  }
+
+  /**
+   * Save a mapping template.
+   * @param {Object} body
+   */
+  async createMapping(body = {}) {
+    return this.sdk._fetch('/dataImport/mappings', 'POST', { body });
+  }
+
+  /**
+   * List mapping templates.
+   */
+  async listMappings() {
+    return this.sdk._fetch('/dataImport/mappings', 'GET');
+  }
+
+  /**
+   * Get a mapping template by id.
+   * @param {string} id
+   */
+  async getMapping(id) {
+    this.sdk.validateParams({ id }, { id: { type: 'string', required: true } });
+    return this.sdk._fetch(`/dataImport/mappings/${id}`, 'GET');
+  }
+
+  /**
+   * Update a mapping template.
+   * @param {string} id
+   * @param {Object} body
+   */
+  async updateMapping(id, body = {}) {
+    this.sdk.validateParams({ id }, { id: { type: 'string', required: true } });
+    return this.sdk._fetch(`/dataImport/mappings/${id}`, 'PUT', { body });
+  }
+}
+
+/**
+ * Export facade. Jobs are still dataImportJobs rows; createJob forces mode=export.
+ */
+export class DataExportService {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+
+  /**
+   * Create a draft export job (POST /dataImport/jobs with mode=export).
+   * @param {Object} [body]
+   */
+  async createJob(body = {}) {
+    return this.sdk._fetch('/dataImport/jobs', 'POST', {
+      body: { ...body, mode: 'export' },
+    });
+  }
+
+  /**
+   * Get a signed download URL for a completed export job.
+   * @param {string} jobId
+   */
+  async download(jobId) {
+    this.sdk.validateParams(
+      { jobId },
+      { jobId: { type: 'string', required: true } },
+    );
+    return this.sdk._fetch(`/dataImport/jobs/${jobId}/download`, 'GET');
+  }
+}