@uipath/uipath-typescript 1.1.2 → 1.2.0

package/dist/entities/index.mjs

@@ -544,11 +544,8 @@ class ApiClient {
         return this.tokenManager.getValidToken();
     }
     async getDefaultHeaders() {
-        // Get headers from execution context first
-        const contextHeaders = this.executionContext.getHeaders();
         const token = await this.getValidToken();
         return {
-            ...contextHeaders,
             'Authorization': `Bearer ${token}`,
             'Content-Type': CONTENT_TYPES.JSON,
             ...this.defaultHeaders,
@@ -560,8 +557,13 @@ class ApiClient {
         const normalizedPath = path.startsWith('/') ? path.substring(1) : path;
         // Construct URL with org and tenant names
         const url = new URL(`${this.config.orgName}/${this.config.tenantName}/${normalizedPath}`, this.config.baseUrl).toString();
+        const isFormData = options.body instanceof FormData;
+        const defaultHeaders = await this.getDefaultHeaders();
+        if (isFormData) {
+            delete defaultHeaders['Content-Type'];
+        }
         const headers = {
-            ...await this.getDefaultHeaders(),
+            ...defaultHeaders,
             ...options.headers
         };
         // Convert params to URLSearchParams
@@ -572,11 +574,15 @@ class ApiClient {
             });
         }
         const fullUrl = searchParams.toString() ? `${url}?${searchParams.toString()}` : url;
+        let body = undefined;
+        if (options.body) {
+            body = isFormData ? options.body : JSON.stringify(options.body);
+        }
         try {
             const response = await fetch(fullUrl, {
                 method,
                 headers,
-                body: options.body ? JSON.stringify(options.body) : undefined,
+                body,
                 signal: options.signal
             });
             if (!response.ok) {
@@ -1664,13 +1670,19 @@ function createEntityMethods(entityData, service) {
             return service.getRecordById(entityData.id, recordId, options);
         },
         async downloadAttachment(recordId, fieldName) {
-            if (!entityData.name)
-                throw new Error('Entity name is undefined');
-            return service.downloadAttachment({
-                entityName: entityData.name,
-                recordId,
-                fieldName
-            });
+            if (!entityData.id)
+                throw new Error('Entity ID is undefined');
+            return service.downloadAttachment(entityData.id, recordId, fieldName);
+        },
+        async uploadAttachment(recordId, fieldName, file, options) {
+            if (!entityData.id)
+                throw new Error('Entity ID is undefined');
+            return service.uploadAttachment(entityData.id, recordId, fieldName, file, options);
+        },
+        async deleteAttachment(recordId, fieldName) {
+            if (!entityData.id)
+                throw new Error('Entity ID is undefined');
+            return service.deleteAttachment(entityData.id, recordId, fieldName);
         },
         async insert(data, options) {
             return this.insertRecord(data, options);
@@ -1722,7 +1734,9 @@ const DATA_FABRIC_ENDPOINTS = {
         BATCH_INSERT_BY_ID: (entityId) => `${DATAFABRIC_BASE}/api/EntityService/entity/${entityId}/insert-batch`,
         UPDATE_BY_ID: (entityId) => `${DATAFABRIC_BASE}/api/EntityService/entity/${entityId}/update-batch`,
         DELETE_BY_ID: (entityId) => `${DATAFABRIC_BASE}/api/EntityService/entity/${entityId}/delete-batch`,
-        DOWNLOAD_ATTACHMENT: (entityName, recordId, fieldName) => `${DATAFABRIC_BASE}/api/Attachment/${entityName}/${recordId}/${fieldName}`,
+        DOWNLOAD_ATTACHMENT: (entityId, recordId, fieldName) => `${DATAFABRIC_BASE}/api/Attachment/entity/${entityId}/${recordId}/${fieldName}`,
+        UPLOAD_ATTACHMENT: (entityId, recordId, fieldName) => `${DATAFABRIC_BASE}/api/Attachment/entity/${entityId}/${recordId}/${fieldName}`,
+        DELETE_ATTACHMENT: (entityId, recordId, fieldName) => `${DATAFABRIC_BASE}/api/Attachment/entity/${entityId}/${recordId}/${fieldName}`,
     },
     CHOICESETS: {
         GET_ALL: `${DATAFABRIC_BASE}/api/Entity/choiceset`,
@@ -1879,7 +1893,7 @@ const EntityFieldTypeMap = {
 // Connection string placeholder that will be replaced during build
 const CONNECTION_STRING = "InstrumentationKey=a6efa11d-1feb-4508-9738-e13e12dcae5e;IngestionEndpoint=https://westeurope-5.in.applicationinsights.azure.com/;LiveEndpoint=https://westeurope.livediagnostics.monitor.azure.com/;ApplicationId=7c58eb1c-9581-4ba6-839e-11725848a037";
 // SDK Version placeholder 
-const SDK_VERSION = "1.1.2";
+const SDK_VERSION = "1.2.0";
 const VERSION = "Version";
 const SERVICE = "Service";
 const CLOUD_ORGANIZATION_NAME = "CloudOrganizationName";
@@ -2455,7 +2469,9 @@ class EntityService extends BaseService {
     /**
      * Downloads an attachment from an entity record field
      *
-     * @param options - Options containing entityName, recordId, and fieldName
+     * @param entityId - UUID of the entity
+     * @param recordId - UUID of the record containing the attachment
+     * @param fieldName - Name of the File-type field containing the attachment
      * @returns Promise resolving to Blob containing the file content
      *
      * @example
@@ -2464,20 +2480,96 @@ class EntityService extends BaseService {
      *
      * const entities = new Entities(sdk);
      *
+     * // Get the entityId from getAll()
+     * const allEntities = await entities.getAll();
+     * const entityId = allEntities[0].id;
+     *
+     * // Get the recordId from getAllRecords()
+     * const records = await entities.getAllRecords(entityId);
+     * const recordId = records[0].id;
+     *
      * // Download attachment for a specific record and field
-     * const blob = await entities.downloadAttachment({
-     *   entityName: 'Invoice',
-     *   recordId: '<record-uuid>',
-     *   fieldName: 'Documents'
-     * });
+     * const blob = await entities.downloadAttachment(entityId, recordId, 'Documents');
+     * ```
      */
-    async downloadAttachment(options) {
-        const { entityName, recordId, fieldName } = options;
-        const response = await this.get(DATA_FABRIC_ENDPOINTS.ENTITY.DOWNLOAD_ATTACHMENT(entityName, recordId, fieldName), {
+    async downloadAttachment(entityId, recordId, fieldName) {
+        const response = await this.get(DATA_FABRIC_ENDPOINTS.ENTITY.DOWNLOAD_ATTACHMENT(entityId, recordId, fieldName), {
             responseType: RESPONSE_TYPES.BLOB
         });
         return response.data;
     }
+    /**
+     * Uploads an attachment to a File-type field of an entity record
+     *
+     * @param entityId - UUID of the entity
+     * @param recordId - UUID of the record to upload the attachment to
+     * @param fieldName - Name of the File-type field
+     * @param file - File to upload (Blob, File, or Uint8Array)
+     * @param options - Optional {@link EntityUploadAttachmentOptions} (e.g. expansionLevel)
+     * @returns Promise resolving to {@link EntityUploadAttachmentResponse}
+     *
+     * @example
+     * ```typescript
+     * import { Entities } from '@uipath/uipath-typescript/entities';
+     *
+     * const entities = new Entities(sdk);
+     *
+     * // Get the entityId from getAll()
+     * const allEntities = await entities.getAll();
+     * const entityId = allEntities[0].id;
+     *
+     * // Get the recordId from getAllRecords()
+     * const records = await entities.getAllRecords(entityId);
+     * const recordId = records[0].id;
+     *
+     * // Upload a file attachment
+     * const response = await entities.uploadAttachment(entityId, recordId, 'Documents', file);
+     * ```
+     */
+    async uploadAttachment(entityId, recordId, fieldName, file, options) {
+        const formData = new FormData();
+        if (file instanceof Uint8Array) {
+            formData.append('file', new Blob([file.buffer]));
+        }
+        else {
+            formData.append('file', file);
+        }
+        const params = createParams({ expansionLevel: options?.expansionLevel });
+        const response = await this.post(DATA_FABRIC_ENDPOINTS.ENTITY.UPLOAD_ATTACHMENT(entityId, recordId, fieldName), formData, { params });
+        // Convert PascalCase response to camelCase
+        const camelResponse = pascalToCamelCaseKeys(response.data);
+        return camelResponse;
+    }
+    /**
+     * Removes an attachment from a File-type field of an entity record
+     *
+     * @param entityId - UUID of the entity
+     * @param recordId - UUID of the record containing the attachment
+     * @param fieldName - Name of the File-type field containing the attachment
+     * @returns Promise resolving to {@link EntityDeleteAttachmentResponse}
+     *
+     * @example
+     * ```typescript
+     * import { Entities } from '@uipath/uipath-typescript/entities';
+     *
+     * const entities = new Entities(sdk);
+     *
+     * // Get the entityId from getAll()
+     * const allEntities = await entities.getAll();
+     * const entityId = allEntities[0].id;
+     *
+     * // Get the recordId from getAllRecords()
+     * const records = await entities.getAllRecords(entityId);
+     * const recordId = records[0].id;
+     *
+     * // Delete attachment for a specific record and field
+     * await entities.deleteAttachment(entityId, recordId, 'Documents');
+     * ```
+     */
+    async deleteAttachment(entityId, recordId, fieldName) {
+        const response = await this.delete(DATA_FABRIC_ENDPOINTS.ENTITY.DELETE_ATTACHMENT(entityId, recordId, fieldName));
+        return response.data;
+    }
     /**
    * @hidden
    * @deprecated Use {@link getAllRecords} instead.
@@ -2611,6 +2703,12 @@ __decorate([
 __decorate([
     track('Entities.DownloadAttachment')
 ], EntityService.prototype, "downloadAttachment", null);
+__decorate([
+    track('Entities.UploadAttachment')
+], EntityService.prototype, "uploadAttachment", null);
+__decorate([
+    track('Entities.DeleteAttachment')
+], EntityService.prototype, "deleteAttachment", null);
 
 class ChoiceSetService extends BaseService {
     /**