@uipath/uipath-typescript 1.1.1 → 1.1.3

package/dist/entities/index.d.ts

@@ -400,6 +400,31 @@ interface EntityDownloadAttachmentOptions {
     /** Field name containing the attachment */
     fieldName: string;
 }
+/**
+ * Options for uploading an attachment to an entity record
+ */
+interface EntityUploadAttachmentOptions {
+    /** Entity name */
+    entityName: string;
+    /** Record ID (UUID) */
+    recordId: string;
+    /** Field name of the File-type field */
+    fieldName: string;
+    /**
+     * File to upload. Accepts the native types supported by FormData:
+     * - `Blob` / `File`: standard browser and Node.js ≥ 18 types accepted directly by FormData.
+     *   `File` is a subclass of `Blob` and is typically obtained from a browser file input.
+     * - `Uint8Array`: raw binary buffer (e.g. from `fs.readFileSync` or a Node.js Buffer).
+     *   Converted to a `Blob` internally before appending to FormData.
+     */
+    file: Blob | File | Uint8Array;
+    /** Optional expansion level (default: 0) */
+    expansionLevel?: number;
+}
+/**
+ * Response from uploading an attachment to an entity record
+ */
+type EntityUploadAttachmentResponse = Record<string, unknown>;
 /**
  * Represents a failure record in an entity operation
  */
@@ -920,6 +945,42 @@ interface EntityServiceModel {
      * ```
      */
     downloadAttachment(options: EntityDownloadAttachmentOptions): Promise<Blob>;
+    /**
+     * Uploads an attachment to a File-type field of an entity record.
+     *
+     * Uses multipart/form-data to upload the file content to the specified field.
+     *
+     * @param options - Options containing entityName, recordId, fieldName, file, and optional expansionLevel
+     * @returns Promise resolving to the upload response
+     * {@link EntityUploadAttachmentResponse}
+     * @example
+     * ```typescript
+     * import { Entities } from '@uipath/uipath-typescript/entities';
+     *
+     * const entities = new Entities(sdk);
+     *
+     * // Browser: Upload a file from an input element
+     * const fileInput = document.getElementById('file-input') as HTMLInputElement;
+     * const file = fileInput.files[0];
+     * const response = await entities.uploadAttachment({
+     *   entityName: 'Invoice',
+     *   recordId: '<recordId>',
+     *   fieldName: 'Documents',
+     *   file: file
+     * });
+     *
+     * // Node.js: Upload a file from disk
+     * const fileBuffer = fs.readFileSync('document.pdf');
+     * const blob = new Blob([fileBuffer], { type: 'application/pdf' });
+     * const response = await entities.uploadAttachment({
+     *   entityName: 'Invoice',
+     *   recordId: '<recordId>',
+     *   fieldName: 'Documents',
+     *   file: blob
+     * });
+     * ```
+     */
+    uploadAttachment(options: EntityUploadAttachmentOptions): Promise<EntityUploadAttachmentResponse>;
 }
 /**
  * Entity methods interface - defines operations that can be performed on an entity
@@ -987,6 +1048,16 @@ interface EntityMethods {
      * @returns Promise resolving to Blob containing the file content
      */
     downloadAttachment(recordId: string, fieldName: string): Promise<Blob>;
+    /**
+     * Uploads an attachment to a File-type field of an entity record
+     *
+     * @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 expansionLevel - Optional expansion level (default: 0)
+     * @returns Promise resolving to the upload response
+     */
+    uploadAttachment(recordId: string, fieldName: string, file: Blob | File | Uint8Array, expansionLevel?: number): Promise<EntityUploadAttachmentResponse>;
     /**
      * @deprecated Use {@link insertRecord} instead.
      * @hidden
@@ -1259,6 +1330,28 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * });
      */
     downloadAttachment(options: EntityDownloadAttachmentOptions): Promise<Blob>;
+    /**
+     * Uploads an attachment to a File-type field of an entity record
+     *
+     * @param options - Options containing entityName, recordId, fieldName, file, and optional expansionLevel
+     * @returns Promise resolving to the upload response
+     *
+     * @example
+     * ```typescript
+     * import { Entities } from '@uipath/uipath-typescript/entities';
+     *
+     * const entities = new Entities(sdk);
+     *
+     * // Upload a file attachment
+     * const response = await entities.uploadAttachment({
+     *   entityName: 'Invoice',
+     *   recordId: '<record-uuid>',
+     *   fieldName: 'Documents',
+     *   file: file
+     * });
+     * ```
+     */
+    uploadAttachment(options: EntityUploadAttachmentOptions): Promise<EntityUploadAttachmentResponse>;
     /**
    * @hidden
    * @deprecated Use {@link getAllRecords} instead.
@@ -1510,4 +1603,4 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
 }
 
 export { ChoiceSetService, ChoiceSetService as ChoiceSets, DataDirectionType, EntityService as Entities, EntityFieldDataType, EntityService, EntityType, FieldDisplayType, JoinType, ReferenceType, createEntityWithMethods };
-export type { ChoiceSetGetAllResponse, ChoiceSetGetByIdOptions, ChoiceSetGetResponse, ChoiceSetServiceModel, EntityBatchInsertOptions, EntityBatchInsertResponse, EntityDeleteOptions, EntityDeleteRecordsOptions, EntityDeleteResponse, EntityDownloadAttachmentOptions, EntityGetAllRecordsOptions, EntityGetRecordByIdOptions, EntityGetRecordsByIdOptions, EntityGetResponse, EntityInsertOptions, EntityInsertRecordOptions, EntityInsertRecordsOptions, EntityInsertResponse, EntityMethods, EntityOperationOptions, EntityOperationResponse, EntityRecord, EntityServiceModel, EntityUpdateOptions, EntityUpdateRecordsOptions, EntityUpdateResponse, ExternalConnection, ExternalField, ExternalFieldMapping, ExternalObject, ExternalSourceFields, FailureRecord, Field, FieldDataType, FieldMetaData, RawEntityGetResponse, SourceJoinCriteria };
+export type { ChoiceSetGetAllResponse, ChoiceSetGetByIdOptions, ChoiceSetGetResponse, ChoiceSetServiceModel, EntityBatchInsertOptions, EntityBatchInsertResponse, EntityDeleteOptions, EntityDeleteRecordsOptions, EntityDeleteResponse, EntityDownloadAttachmentOptions, EntityGetAllRecordsOptions, EntityGetRecordByIdOptions, EntityGetRecordsByIdOptions, EntityGetResponse, EntityInsertOptions, EntityInsertRecordOptions, EntityInsertRecordsOptions, EntityInsertResponse, EntityMethods, EntityOperationOptions, EntityOperationResponse, EntityRecord, EntityServiceModel, EntityUpdateOptions, EntityUpdateRecordsOptions, EntityUpdateResponse, EntityUploadAttachmentOptions, EntityUploadAttachmentResponse, ExternalConnection, ExternalField, ExternalFieldMapping, ExternalObject, ExternalSourceFields, FailureRecord, Field, FieldDataType, FieldMetaData, RawEntityGetResponse, SourceJoinCriteria };

package/dist/entities/index.mjs

@@ -546,15 +546,6 @@ class ApiClient {
     async getDefaultHeaders() {
         // Get headers from execution context first
         const contextHeaders = this.executionContext.getHeaders();
-        // If Authorization header is already set in context, use that
-        if (contextHeaders['Authorization']) {
-            return {
-                ...contextHeaders,
-                'Content-Type': CONTENT_TYPES.JSON,
-                ...this.defaultHeaders,
-                ...this.clientConfig.headers
-            };
-        }
         const token = await this.getValidToken();
         return {
             ...contextHeaders,
@@ -569,8 +560,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
@@ -581,11 +577,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) {
@@ -681,6 +681,7 @@ function filterUndefined(obj) {
  * Checks if code is running in a browser environment
  */
 const isBrowser = typeof window !== 'undefined' && typeof window.document !== 'undefined';
+isBrowser && window.self != window.top && window.location.href.includes('source=ActionCenter');
 
 /**
  * Base64 encoding/decoding
@@ -1680,6 +1681,17 @@ function createEntityMethods(entityData, service) {
                 fieldName
             });
         },
+        async uploadAttachment(recordId, fieldName, file, expansionLevel) {
+            if (!entityData.name)
+                throw new Error('Entity name is undefined');
+            return service.uploadAttachment({
+                entityName: entityData.name,
+                recordId,
+                fieldName,
+                file,
+                expansionLevel
+            });
+        },
         async insert(data, options) {
             return this.insertRecord(data, options);
         },
@@ -1731,6 +1743,7 @@ const DATA_FABRIC_ENDPOINTS = {
         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}`,
+        UPLOAD_ATTACHMENT: (entityName, recordId, fieldName) => `${DATAFABRIC_BASE}/api/Attachment/${entityName}/${recordId}/${fieldName}`,
     },
     CHOICESETS: {
         GET_ALL: `${DATAFABRIC_BASE}/api/Entity/choiceset`,
@@ -1887,7 +1900,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.1";
+const SDK_VERSION = "1.1.3";
 const VERSION = "Version";
 const SERVICE = "Service";
 const CLOUD_ORGANIZATION_NAME = "CloudOrganizationName";
@@ -2486,6 +2499,42 @@ class EntityService extends BaseService {
         });
         return response.data;
     }
+    /**
+     * Uploads an attachment to a File-type field of an entity record
+     *
+     * @param options - Options containing entityName, recordId, fieldName, file, and optional expansionLevel
+     * @returns Promise resolving to the upload response
+     *
+     * @example
+     * ```typescript
+     * import { Entities } from '@uipath/uipath-typescript/entities';
+     *
+     * const entities = new Entities(sdk);
+     *
+     * // Upload a file attachment
+     * const response = await entities.uploadAttachment({
+     *   entityName: 'Invoice',
+     *   recordId: '<record-uuid>',
+     *   fieldName: 'Documents',
+     *   file: file
+     * });
+     * ```
+     */
+    async uploadAttachment(options) {
+        const { entityName, recordId, fieldName, file, expansionLevel } = 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 });
+        const response = await this.post(DATA_FABRIC_ENDPOINTS.ENTITY.UPLOAD_ATTACHMENT(entityName, recordId, fieldName), formData, { params });
+        // Convert PascalCase response to camelCase
+        const camelResponse = pascalToCamelCaseKeys(response.data);
+        return camelResponse;
+    }
     /**
    * @hidden
    * @deprecated Use {@link getAllRecords} instead.
@@ -2619,6 +2668,9 @@ __decorate([
 __decorate([
     track('Entities.DownloadAttachment')
 ], EntityService.prototype, "downloadAttachment", null);
+__decorate([
+    track('Entities.UploadAttachment')
+], EntityService.prototype, "uploadAttachment", null);
 
 class ChoiceSetService extends BaseService {
     /**