@uipath/uipath-typescript 1.2.2 → 1.3.1

package/dist/jobs/index.cjs

@@ -526,15 +526,11 @@ const RESPONSE_TYPES = {
 
 class ApiClient {
     constructor(config, executionContext, tokenManager, clientConfig = {}) {
-        this.defaultHeaders = {};
         this.config = config;
         this.executionContext = executionContext;
         this.clientConfig = clientConfig;
         this.tokenManager = tokenManager;
     }
-    setDefaultHeaders(headers) {
-        this.defaultHeaders = { ...this.defaultHeaders, ...headers };
-    }
     /**
      * Gets a valid authentication token, refreshing if necessary.
      * Used internally for API requests and exposed for services that need manual auth headers.
@@ -550,7 +546,6 @@ class ApiClient {
         return {
             'Authorization': `Bearer ${token}`,
             'Content-Type': CONTENT_TYPES.JSON,
-            ...this.defaultHeaders,
             ...this.clientConfig.headers
         };
     }
@@ -1390,6 +1385,8 @@ class BaseService {
      *
      * @param instance - UiPath SDK instance providing authentication and configuration.
      *                    Services receive this via dependency injection in the modular pattern.
+     * @param headers - Optional default headers to include in every request (e.g. `x-uipath-external-user-id` for
+     *                  CAS external-app auth)
      *
      * @example
      * ```typescript
@@ -1409,11 +1406,11 @@ class BaseService {
      * const entities = new Entities(sdk);
      * ```
      */
-    constructor(instance) {
+    constructor(instance, headers) {
         // Private field - not visible via Object.keys() or any reflection
         _BaseService_apiClient.set(this, void 0);
         const { config, context, tokenManager } = SDKInternalsRegistry.get(instance);
-        __classPrivateFieldSet(this, _BaseService_apiClient, new ApiClient(config, context, tokenManager), "f");
+        __classPrivateFieldSet(this, _BaseService_apiClient, new ApiClient(config, context, tokenManager, headers ? { headers } : {}), "f");
     }
     /**
      * Gets a valid authentication token, refreshing if necessary.
@@ -1644,6 +1641,36 @@ class FolderScopedService extends BaseService {
     }
 }
 
+/**
+ * Creates methods for a job response object.
+ *
+ * @param jobData - The raw job data from API
+ * @param service - The job service instance
+ * @returns Object containing job methods
+ */
+function createJobMethods(jobData, service) {
+    return {
+        async getOutput() {
+            if (!jobData.key)
+                throw new Error('Job key is undefined');
+            if (!jobData.folderId)
+                throw new Error('Job folderId is undefined');
+            return service.getOutput(jobData.key, jobData.folderId);
+        },
+    };
+}
+/**
+ * Creates a job response with bound methods.
+ *
+ * @param jobData - The raw job data from API
+ * @param service - The job service instance
+ * @returns A job object with added methods
+ */
+function createJobWithMethods(jobData, service) {
+    const methods = createJobMethods(jobData, service);
+    return Object.assign({}, jobData, methods);
+}
+
 /**
  * Base path constants for different services
  */
@@ -1657,6 +1684,13 @@ const ORCHESTRATOR_BASE = 'orchestrator_';
  */
 const JOB_ENDPOINTS = {
     GET_ALL: `${ORCHESTRATOR_BASE}/odata/Jobs`,
+    GET_BY_KEY: (identifier) => `${ORCHESTRATOR_BASE}/odata/Jobs/UiPath.Server.Configuration.OData.GetByKey(identifier=${identifier})`,
+};
+/**
+ * Orchestrator Attachment Service Endpoints
+ */
+const ORCHESTRATOR_ATTACHMENT_ENDPOINTS = {
+    GET_BY_ID: (id) => `${ORCHESTRATOR_BASE}/odata/Attachments(${id})`,
 };
 
 /**
@@ -1680,7 +1714,7 @@ const JobMap = {
 // 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.2.2";
+const SDK_VERSION = "1.3.1";
 const VERSION = "Version";
 const SERVICE = "Service";
 const CLOUD_ORGANIZATION_NAME = "CloudOrganizationName";
@@ -1906,8 +1940,9 @@ function createTrackedFunction(originalFunction, nameOrOptions, fallbackName, op
         // Track the event if enabled
         if (shouldTrack) {
             // Use the full name provided in the decorator (e.g., "Queue.GetAll")
-            const serviceMethod = nameOrOptions
-                ;
+            const serviceMethod = typeof nameOrOptions === 'string'
+                ? nameOrOptions
+                : fallbackName;
             // Use 'Sdk.Run' as the name and serviceMethod as the service
             telemetryClient.track(serviceMethod, SDK_RUN_EVENT, opts.attributes);
         }
@@ -1936,7 +1971,7 @@ function createTrackedFunction(originalFunction, nameOrOptions, fallbackName, op
  */
 function track(nameOrOptions, options) {
     return function decorator(_target, propertyKey, descriptor) {
-        const opts = {};
+        const opts = typeof nameOrOptions === 'object' ? nameOrOptions : {};
         if (descriptor && typeof descriptor.value === 'function') {
             // Method decorator
             descriptor.value = createTrackedFunction(descriptor.value, nameOrOptions, propertyKey || 'unknown_method', opts);
@@ -1947,27 +1982,90 @@ function track(nameOrOptions, options) {
     };
 }
 
+/**
+ * Maps fields for Attachment entities to ensure consistent naming
+ */
+const AttachmentsMap = {
+    creationTime: 'createdTime',
+    lastModificationTime: 'lastModifiedTime'
+};
+
+/**
+ * Maps fields for Bucket entities to ensure consistent naming
+ */
+const BucketMap = {
+    fullPath: 'path',
+    items: 'blobItems',
+    verb: 'httpMethod'
+};
+
+class AttachmentService extends BaseService {
+    /**
+     * Gets an attachment by ID
+     * @param id - The UUID of the attachment to retrieve
+     * @param options - Optional query parameters (expand, select)
+     * @returns Promise resolving to the attachment
+     *
+     * @example
+     * ```typescript
+     * import { Attachments } from '@uipath/uipath-typescript/attachments';
+     *
+     * const attachments = new Attachments(sdk);
+     * const attachment = await attachments.getById('12345678-1234-1234-1234-123456789abc');
+     * ```
+     */
+    async getById(id, options = {}) {
+        if (!id) {
+            throw new ValidationError({ message: 'id is required for getById' });
+        }
+        // Prefix all keys in options with $ for OData
+        const keysToPrefix = Object.keys(options);
+        const apiOptions = addPrefixToKeys(options, ODATA_PREFIX, keysToPrefix);
+        const response = await this.get(ORCHESTRATOR_ATTACHMENT_ENDPOINTS.GET_BY_ID(id), {
+            params: apiOptions,
+        });
+        // Transform response from PascalCase to camelCase, then apply field maps
+        const camelCased = pascalToCamelCaseKeys(response.data);
+        camelCased.blobFileAccess = transformData(camelCased.blobFileAccess, BucketMap);
+        return transformData(camelCased, AttachmentsMap);
+    }
+}
+__decorate([
+    track('Attachments.GetById')
+], AttachmentService.prototype, "getById", null);
+
 /**
  * Service for interacting with UiPath Orchestrator Jobs API
  */
 class JobService extends FolderScopedService {
     /**
-     * Gets all jobs across folders with optional filtering
+     * Creates an instance of the Jobs service.
+     *
+     * @param instance - UiPath SDK instance providing authentication and configuration
+     */
+    constructor(instance) {
+        super(instance);
+        this.attachmentService = new AttachmentService(instance);
+    }
+    /**
+     * Gets all jobs across folders with optional filtering and pagination.
+     *
+     * Returns jobs with full details including state, timing, and input/output arguments.
+     * Pass `folderId` to scope the query to a specific folder.
      *
-     * @param options - Query options including optional folderId and pagination options
-     * @returns Promise resolving to array of jobs or paginated response
+     * !!! info "Input and output fields are not included in `getAll` responses"
+     *     The `inputArguments`, `inputFile`, `outputArguments`, and `outputFile` fields will always be `null` in the `getAll` response. To retrieve a job's output, use the {@link getOutput} method with the job's `key` and `folderId`.
      *
+     * @param options - Query options including optional folderId, filtering, and pagination options
+     * @returns Promise resolving to either an array of jobs {@link NonPaginatedResponse}<{@link JobGetResponse}> or a {@link PaginatedResponse}<{@link JobGetResponse}> when pagination options are used.
+     * {@link JobGetResponse}
      * @example
      * ```typescript
-     * import { Jobs } from '@uipath/uipath-typescript/jobs';
-     *
-     * const jobs = new Jobs(sdk);
-     *
      * // Get all jobs
      * const allJobs = await jobs.getAll();
      *
      * // Get all jobs in a specific folder
-     * const folderJobs = await jobs.getAll({ folderId: 123 });
+     * const folderJobs = await jobs.getAll({ folderId: <folderId> });
      *
      * // With filtering
      * const runningJobs = await jobs.getAll({
@@ -1981,10 +2079,19 @@ class JobService extends FolderScopedService {
      * if (page1.hasNextPage) {
      *   const page2 = await jobs.getAll({ cursor: page1.nextCursor });
      * }
+     *
+     * // Jump to specific page
+     * const page5 = await jobs.getAll({
+     *   jumpToPage: 5,
+     *   pageSize: 10
+     * });
      * ```
      */
     async getAll(options) {
-        const transformJobResponse = (job) => transformData(pascalToCamelCaseKeys(job), JobMap);
+        const transformJobResponse = (job) => {
+            const rawJob = transformData(pascalToCamelCaseKeys(job), JobMap);
+            return createJobWithMethods(rawJob, this);
+        };
         return PaginationHelpers.getAll({
             serviceAccess: this.createPaginationServiceAccess(),
             getEndpoint: () => JOB_ENDPOINTS.GET_ALL,
@@ -2002,10 +2109,144 @@ class JobService extends FolderScopedService {
             },
         }, options);
     }
+    /**
+     * Gets a job by its unique key (GUID).
+     *
+     * Returns the full job details including state, timing, input/output arguments, and error information.
+     * Use `expand` to include related entities like `robot`, or `machine`.
+     *
+     * @param id - The unique key (GUID) of the job to retrieve
+     * @param folderId - The folder ID where the job resides
+     * @param options - Optional query options for expanding or selecting fields
+     * @returns Promise resolving to a {@link JobGetResponse} with full job details and bound methods
+     *
+     * @example
+     * ```typescript
+     * // Get a job by key
+     * const job = await jobs.getById(<id>, <folderId>);
+     * console.log(job.state, job.processName);
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // With expanded related entities
+     * const job = await jobs.getById(<id>, <folderId>, {
+     *   expand: 'robot,machine'
+     * });
+     * console.log(job.robot?.name, job.machine?.name);
+     * ```
+     */
+    async getById(id, folderId, options) {
+        if (!id) {
+            throw new ValidationError({ message: 'id is required for getById' });
+        }
+        if (!folderId) {
+            throw new ValidationError({ message: 'folderId is required for getById' });
+        }
+        const headers = createHeaders({ [FOLDER_ID]: folderId });
+        const keysToPrefix = Object.keys(options ?? {});
+        const apiOptions = options ? addPrefixToKeys(options, ODATA_PREFIX, keysToPrefix) : {};
+        const response = await this.get(JOB_ENDPOINTS.GET_BY_KEY(id), {
+            params: apiOptions,
+            headers,
+        });
+        const rawJob = transformData(pascalToCamelCaseKeys(response.data), JobMap);
+        return createJobWithMethods(rawJob, this);
+    }
+    /**
+     * Gets the output of a completed job.
+     *
+     * Retrieves the job's output arguments, handling both inline output (stored directly on the job
+     * as a JSON string in `outputArguments`) and file-based output (stored as a blob attachment for
+     * large outputs). Returns the parsed JSON output or `null` if the job has no output.
+     *
+     * @param jobKey - The unique key (GUID) of the job to retrieve output from
+     * @param folderId - The folder ID where the job resides
+     * @returns Promise resolving to the parsed output as `Record<string, unknown>`, or `null` if no output exists
+     *
+     * @example
+     * ```typescript
+     * // Get output from a completed job
+     * const output = await jobs.getOutput(<jobKey>, <folderId>);
+     *
+     * if (output) {
+     *   console.log('Job output:', output);
+     * }
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Get output using bound method (jobKey and folderId are taken from the job object)
+     * const allJobs = await jobs.getAll();
+     * const completedJob = allJobs.items.find(j => j.state === JobState.Successful);
+     *
+     * if (completedJob) {
+     *   const output = await completedJob.getOutput();
+     * }
+     * ```
+     */
+    async getOutput(jobKey, folderId) {
+        if (!jobKey) {
+            throw new ValidationError({ message: 'jobKey is required for getOutput' });
+        }
+        const job = await this.getById(jobKey, folderId, { select: 'outputArguments,outputFile' });
+        if (job.outputArguments) {
+            try {
+                return JSON.parse(job.outputArguments);
+            }
+            catch {
+                throw new ServerError({ message: 'Failed to parse job output arguments as JSON' });
+            }
+        }
+        if (job.outputFile) {
+            return this.downloadOutputFile(job.outputFile);
+        }
+        return null;
+    }
+    /**
+     * Downloads the output file content via the Attachments API.
+     * 1. Fetches blob access info from the attachment using AttachmentService
+     * 2. Downloads content from the presigned blob URI
+     * 3. Parses and returns the JSON content
+     */
+    async downloadOutputFile(outputFileKey) {
+        const attachment = await this.attachmentService.getById(outputFileKey);
+        const blobAccess = attachment.blobFileAccess;
+        if (!blobAccess?.uri) {
+            return null;
+        }
+        const blobHeaders = { ...blobAccess.headers };
+        // Add auth header if the blob URI requires authenticated access
+        if (blobAccess.requiresAuth) {
+            const token = await this.getValidAuthToken();
+            blobHeaders['Authorization'] = `Bearer ${token}`;
+        }
+        const blobResponse = await fetch(blobAccess.uri, {
+            method: 'GET',
+            headers: blobHeaders,
+        });
+        if (!blobResponse.ok) {
+            const errorInfo = await errorResponseParser.parse(blobResponse);
+            throw ErrorFactory.createFromHttpStatus(blobResponse.status, errorInfo);
+        }
+        const content = await blobResponse.text();
+        try {
+            return JSON.parse(content);
+        }
+        catch {
+            throw new ServerError({ message: 'Failed to parse job output file as JSON' });
+        }
+    }
 }
 __decorate([
     track('Jobs.GetAll')
 ], JobService.prototype, "getAll", null);
+__decorate([
+    track('Jobs.GetById')
+], JobService.prototype, "getById", null);
+__decorate([
+    track('Jobs.GetOutput')
+], JobService.prototype, "getOutput", null);
 
 /**
  * Enum for job sub-state
@@ -2032,5 +2273,22 @@ exports.ServerlessJobType = void 0;
     ServerlessJobType["PythonAgent"] = "PythonAgent";
 })(exports.ServerlessJobType || (exports.ServerlessJobType = {}));
 
+/**
+ * Common enum for job state used across services
+ */
+exports.JobState = void 0;
+(function (JobState) {
+    JobState["Pending"] = "Pending";
+    JobState["Running"] = "Running";
+    JobState["Stopping"] = "Stopping";
+    JobState["Terminating"] = "Terminating";
+    JobState["Faulted"] = "Faulted";
+    JobState["Successful"] = "Successful";
+    JobState["Stopped"] = "Stopped";
+    JobState["Suspended"] = "Suspended";
+    JobState["Resumed"] = "Resumed";
+})(exports.JobState || (exports.JobState = {}));
+
 exports.JobService = JobService;
 exports.Jobs = JobService;
+exports.createJobWithMethods = createJobWithMethods;