@uipath/uipath-typescript 1.0.0-beta.10

package/dist/services/maestro/process-instances.js

@@ -0,0 +1,190 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseService } from '../base';
+import { createProcessInstanceWithMethods } from '../../models/maestro';
+import { MAESTRO_ENDPOINTS } from '../../utils/constants/endpoints';
+import { createHeaders } from '../../utils/http/headers';
+import { FOLDER_KEY, CONTENT_TYPES } from '../../utils/constants/headers';
+import { transformData } from '../../utils/transform';
+import { ProcessInstanceMap, ProcessInstanceExecutionHistoryMap } from '../../models/maestro/process-instances.constants';
+import { PaginationHelpers } from '../../utils/pagination/helpers';
+import { PaginationType } from '../../utils/pagination/internal-types';
+import { PROCESS_INSTANCE_PAGINATION, PROCESS_INSTANCE_TOKEN_PARAMS } from '../../utils/constants/common';
+import { track } from '../../core/telemetry';
+export class ProcessInstancesService extends BaseService {
+    /**
+     * @hideconstructor
+     */
+    constructor(config, executionContext, tokenManager) {
+        super(config, executionContext, tokenManager);
+    }
+    /**
+     * Get all process instances with optional filtering and pagination
+     *
+     * The method returns either:
+     * - A NonPaginatedResponse with items array (when no pagination parameters are provided)
+     * - A PaginatedResponse with navigation cursors (when any pagination parameter is provided)
+     *
+     * @param options Query parameters for filtering instances and pagination
+     * @returns Promise resolving to process instances or paginated result
+     *
+     * @example
+     * ```typescript
+     * // Get all instances (non-paginated)
+     * const instances = await sdk.maestro.processes.instances.getAll();
+     *
+     * // Cancel faulted instances using methods directly on instances
+     * for (const instance of instances.items) {
+     *   if (instance.latestRunStatus === 'Faulted') {
+     *     await instance.cancel({ comment: 'Cancelling faulted instance' });
+     *   }
+     * }
+     *
+     * // With filtering
+     * const instances = await sdk.maestro.processes.instances.getAll({
+     *   processKey: 'MyProcess'
+     * });
+     *
+     * // First page with pagination
+     * const page1 = await sdk.maestro.processes.instances.getAll({ pageSize: 10 });
+     *
+     * // Navigate using cursor
+     * if (page1.hasNextPage) {
+     *   const page2 = await sdk.maestro.processes.instances.getAll({ cursor: page1.nextCursor });
+     * }
+     * ```
+     */
+    async getAll(options) {
+        // Transformation function for process instances
+        const transformProcessInstance = (item) => {
+            const rawInstance = transformData(item, ProcessInstanceMap);
+            return createProcessInstanceWithMethods(rawInstance, this);
+        };
+        return PaginationHelpers.getAll({
+            serviceAccess: this.createPaginationServiceAccess(),
+            getEndpoint: () => MAESTRO_ENDPOINTS.INSTANCES.GET_ALL,
+            transformFn: transformProcessInstance,
+            pagination: {
+                paginationType: PaginationType.TOKEN,
+                itemsField: PROCESS_INSTANCE_PAGINATION.ITEMS_FIELD,
+                continuationTokenField: PROCESS_INSTANCE_PAGINATION.CONTINUATION_TOKEN_FIELD,
+                paginationParams: {
+                    pageSizeParam: PROCESS_INSTANCE_TOKEN_PARAMS.PAGE_SIZE_PARAM,
+                    tokenParam: PROCESS_INSTANCE_TOKEN_PARAMS.TOKEN_PARAM
+                }
+            },
+            excludeFromPrefix: Object.keys(options || {}) // All process instance params are not OData
+        }, options);
+    }
+    /**
+     * Get a process instance by ID with operation methods (cancel, pause, resume)
+     * @param id The ID of the instance to retrieve
+     * @param folderKey The folder key for authorization
+     * @returns Promise<ProcessInstanceGetResponse>
+     */
+    async getById(id, folderKey) {
+        const response = await this.get(MAESTRO_ENDPOINTS.INSTANCES.GET_BY_ID(id), {
+            headers: createHeaders({ [FOLDER_KEY]: folderKey })
+        });
+        const rawInstance = transformData(response.data, ProcessInstanceMap);
+        return createProcessInstanceWithMethods(rawInstance, this);
+    }
+    /**
+     * Get execution history (spans) for a process instance
+     * @param instanceId The ID of the instance to get history for
+     * @returns Promise<ProcessInstanceExecutionHistoryResponse[]>
+     */
+    async getExecutionHistory(instanceId) {
+        const response = await this.get(MAESTRO_ENDPOINTS.INSTANCES.GET_EXECUTION_HISTORY(instanceId));
+        return response.data.map(historyItem => transformData(historyItem, ProcessInstanceExecutionHistoryMap));
+    }
+    /**
+     * Get BPMN XML file for a process instance
+     * @param instanceId The ID of the instance to get BPMN for
+     * @param folderKey The folder key for authorization
+     * @returns Promise<BpmnXmlString> The BPMN XML contents as a string
+     */
+    async getBpmn(instanceId, folderKey) {
+        const response = await this.get(MAESTRO_ENDPOINTS.INSTANCES.GET_BPMN(instanceId), {
+            headers: createHeaders({
+                [FOLDER_KEY]: folderKey,
+                'Accept': CONTENT_TYPES.XML
+            })
+        });
+        return response.data;
+    }
+    /**
+     * Cancel a process instance
+     * @param instanceId The ID of the instance to cancel
+     * @param folderKey The folder key for authorization
+     * @param options Optional cancellation options with comment
+     * @returns Promise resolving to operation result with updated instance data
+     */
+    async cancel(instanceId, folderKey, options) {
+        const response = await this.post(MAESTRO_ENDPOINTS.INSTANCES.CANCEL(instanceId), options || {}, {
+            headers: createHeaders({ [FOLDER_KEY]: folderKey })
+        });
+        return {
+            success: true,
+            data: response.data
+        };
+    }
+    /**
+     * Pause a process instance
+     * @param instanceId The ID of the instance to pause
+     * @param folderKey The folder key for authorization
+     * @param options Optional pause options with comment
+     * @returns Promise resolving to operation result with updated instance data
+     */
+    async pause(instanceId, folderKey, options) {
+        const response = await this.post(MAESTRO_ENDPOINTS.INSTANCES.PAUSE(instanceId), options || {}, {
+            headers: createHeaders({ [FOLDER_KEY]: folderKey })
+        });
+        return {
+            success: true,
+            data: response.data
+        };
+    }
+    /**
+     * Resume a process instance
+     * @param instanceId The ID of the instance to resume
+     * @param folderKey The folder key for authorization
+     * @param options Optional resume options with comment
+     * @returns Promise resolving to operation result with updated instance data
+     */
+    async resume(instanceId, folderKey, options) {
+        const response = await this.post(MAESTRO_ENDPOINTS.INSTANCES.RESUME(instanceId), options || {}, {
+            headers: createHeaders({ [FOLDER_KEY]: folderKey })
+        });
+        return {
+            success: true,
+            data: response.data
+        };
+    }
+}
+__decorate([
+    track('GetAll')
+], ProcessInstancesService.prototype, "getAll", null);
+__decorate([
+    track('GetById')
+], ProcessInstancesService.prototype, "getById", null);
+__decorate([
+    track('GetExecutionHistory')
+], ProcessInstancesService.prototype, "getExecutionHistory", null);
+__decorate([
+    track('GetBpmn')
+], ProcessInstancesService.prototype, "getBpmn", null);
+__decorate([
+    track('Cancel')
+], ProcessInstancesService.prototype, "cancel", null);
+__decorate([
+    track('Pause')
+], ProcessInstancesService.prototype, "pause", null);
+__decorate([
+    track('Resume')
+], ProcessInstancesService.prototype, "resume", null);
+//# sourceMappingURL=process-instances.js.map

package/dist/services/maestro/process-instances.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-instances.js","sourceRoot":"","sources":["../../../src/services/maestro/process-instances.ts"],"names":[],"mappings":"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"}

package/dist/services/orchestrator/assets.d.ts

@@ -0,0 +1,63 @@
+import { FolderScopedService } from '../folder-scoped';
+import { Config } from '../../core/config/config';
+import { ExecutionContext } from '../../core/context/execution';
+import { AssetGetResponse, AssetGetAllOptions, AssetGetByIdOptions } from '../../models/orchestrator/assets.types';
+import { AssetServiceModel } from '../../models/orchestrator/assets.models';
+import { TokenManager } from '../../core/auth/token-manager';
+import { PaginatedResponse, NonPaginatedResponse, HasPaginationOptions } from '../../utils/pagination';
+/**
+ * Service for interacting with UiPath Orchestrator Assets API
+ */
+export declare class AssetService extends FolderScopedService implements AssetServiceModel {
+    /**
+     * @hideconstructor
+     */
+    constructor(config: Config, executionContext: ExecutionContext, tokenManager: TokenManager);
+    /**
+     * Gets all assets across folders with optional filtering and folder scoping
+     *
+     * @signature getAll(options?) -> Promise<AssetGetResponse[]>
+     * @param options Query options including optional folderId and pagination options
+     * @returns Promise resolving to array of assets or paginated response
+     *
+     * @example
+     * ```typescript
+     * // Standard array return
+     * const assets = await sdk.assets.getAll();
+     *
+     * // With folder
+     * const folderAssets = await sdk.assets.getAll({ folderId: 123 });
+     *
+     * // First page with pagination
+     * const page1 = await sdk.assets.getAll({ pageSize: 10 });
+     *
+     * // Navigate using cursor
+     * if (page1.hasNextPage) {
+     *   const page2 = await sdk.assets.getAll({ cursor: page1.nextCursor });
+     * }
+     *
+     * // Jump to specific page
+     * const page5 = await sdk.assets.getAll({
+     *   jumpToPage: 5,
+     *   pageSize: 10
+     * });
+     * ```
+     */
+    getAll<T extends AssetGetAllOptions = AssetGetAllOptions>(options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<AssetGetResponse> : NonPaginatedResponse<AssetGetResponse>>;
+    /**
+     * Gets a single asset by ID
+     *
+     * @param id - Asset ID
+     * @param folderId - Required folder ID
+     * @param options - Optional query parameters (expand, select)
+     * @returns Promise resolving to a single asset
+     *
+     * @example
+     * ```typescript
+     * // Get asset by ID
+     * const asset = await sdk.assets.getById(123, 456);
+     * ```
+     */
+    getById(id: number, folderId: number, options?: AssetGetByIdOptions): Promise<AssetGetResponse>;
+}
+//# sourceMappingURL=assets.d.ts.map

package/dist/services/orchestrator/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../../src/services/orchestrator/assets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AACnH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAG5E,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAM7D,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAKvG;;GAEG;AACH,qBAAa,YAAa,SAAQ,mBAAoB,YAAW,iBAAiB;IAChF;;OAEG;gBACS,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY;IAI1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IAEG,MAAM,CAAC,CAAC,SAAS,kBAAkB,GAAG,kBAAkB,EAC5D,OAAO,CAAC,EAAE,CAAC,GACV,OAAO,CACR,CAAC,SAAS,oBAAoB,CAAC,CAAC,CAAC,GAC7B,iBAAiB,CAAC,gBAAgB,CAAC,GACnC,oBAAoB,CAAC,gBAAgB,CAAC,CAC3C;IAuBD;;;;;;;;;;;;;OAaG;IAEG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAkB1G"}

package/dist/services/orchestrator/assets.js

@@ -0,0 +1,110 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { FolderScopedService } from '../folder-scoped';
+import { addPrefixToKeys, pascalToCamelCaseKeys, transformData } from '../../utils/transform';
+import { createHeaders } from '../../utils/http/headers';
+import { FOLDER_ID } from '../../utils/constants/headers';
+import { ASSET_ENDPOINTS } from '../../utils/constants/endpoints';
+import { ODATA_PREFIX, ODATA_OFFSET_PARAMS } from '../../utils/constants/common';
+import { AssetMap } from '../../models/orchestrator/assets.constants';
+import { ODATA_PAGINATION } from '../../utils/constants/common';
+import { PaginationHelpers } from '../../utils/pagination/helpers';
+import { PaginationType } from '../../utils/pagination/internal-types';
+import { track } from '../../core/telemetry';
+/**
+ * Service for interacting with UiPath Orchestrator Assets API
+ */
+export class AssetService extends FolderScopedService {
+    /**
+     * @hideconstructor
+     */
+    constructor(config, executionContext, tokenManager) {
+        super(config, executionContext, tokenManager);
+    }
+    /**
+     * Gets all assets across folders with optional filtering and folder scoping
+     *
+     * @signature getAll(options?) -> Promise<AssetGetResponse[]>
+     * @param options Query options including optional folderId and pagination options
+     * @returns Promise resolving to array of assets or paginated response
+     *
+     * @example
+     * ```typescript
+     * // Standard array return
+     * const assets = await sdk.assets.getAll();
+     *
+     * // With folder
+     * const folderAssets = await sdk.assets.getAll({ folderId: 123 });
+     *
+     * // First page with pagination
+     * const page1 = await sdk.assets.getAll({ pageSize: 10 });
+     *
+     * // Navigate using cursor
+     * if (page1.hasNextPage) {
+     *   const page2 = await sdk.assets.getAll({ cursor: page1.nextCursor });
+     * }
+     *
+     * // Jump to specific page
+     * const page5 = await sdk.assets.getAll({
+     *   jumpToPage: 5,
+     *   pageSize: 10
+     * });
+     * ```
+     */
+    async getAll(options) {
+        // Transformation function for assets
+        const transformAssetResponse = (asset) => transformData(pascalToCamelCaseKeys(asset), AssetMap);
+        return PaginationHelpers.getAll({
+            serviceAccess: this.createPaginationServiceAccess(),
+            getEndpoint: (folderId) => folderId ? ASSET_ENDPOINTS.GET_BY_FOLDER : ASSET_ENDPOINTS.GET_ALL,
+            getByFolderEndpoint: ASSET_ENDPOINTS.GET_BY_FOLDER,
+            transformFn: transformAssetResponse,
+            pagination: {
+                paginationType: PaginationType.OFFSET,
+                itemsField: ODATA_PAGINATION.ITEMS_FIELD,
+                totalCountField: ODATA_PAGINATION.TOTAL_COUNT_FIELD,
+                paginationParams: {
+                    pageSizeParam: ODATA_OFFSET_PARAMS.PAGE_SIZE_PARAM,
+                    offsetParam: ODATA_OFFSET_PARAMS.OFFSET_PARAM,
+                    countParam: ODATA_OFFSET_PARAMS.COUNT_PARAM
+                }
+            }
+        }, options);
+    }
+    /**
+     * Gets a single asset by ID
+     *
+     * @param id - Asset ID
+     * @param folderId - Required folder ID
+     * @param options - Optional query parameters (expand, select)
+     * @returns Promise resolving to a single asset
+     *
+     * @example
+     * ```typescript
+     * // Get asset by ID
+     * const asset = await sdk.assets.getById(123, 456);
+     * ```
+     */
+    async getById(id, folderId, options = {}) {
+        const headers = createHeaders({ [FOLDER_ID]: folderId });
+        const keysToPrefix = Object.keys(options);
+        const apiOptions = addPrefixToKeys(options, ODATA_PREFIX, keysToPrefix);
+        const response = await this.get(ASSET_ENDPOINTS.GET_BY_ID(id), {
+            headers,
+            params: apiOptions
+        });
+        const transformedAsset = transformData(pascalToCamelCaseKeys(response.data), AssetMap);
+        return transformedAsset;
+    }
+}
+__decorate([
+    track('GetAll')
+], AssetService.prototype, "getAll", null);
+__decorate([
+    track('GetById')
+], AssetService.prototype, "getById", null);
+//# sourceMappingURL=assets.js.map

package/dist/services/orchestrator/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../src/services/orchestrator/assets.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAKvD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,4CAA4C,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,mBAAmB;IACnD;;OAEG;IACH,YAAY,MAAc,EAAE,gBAAkC,EAAE,YAA0B;QACxF,KAAK,CAAC,MAAM,EAAE,gBAAgB,EAAE,YAAY,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IAEG,AAAN,KAAK,CAAC,MAAM,CACV,OAAW;QAMX,qCAAqC;QACrC,MAAM,sBAAsB,GAAG,CAAC,KAAU,EAAE,EAAE,CAC5C,aAAa,CAAC,qBAAqB,CAAC,KAAK,CAAqB,EAAE,QAAQ,CAAC,CAAC;QAE5E,OAAO,iBAAiB,CAAC,MAAM,CAAC;YAC9B,aAAa,EAAE,IAAI,CAAC,6BAA6B,EAAE;YACnD,WAAW,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO;YAC7F,mBAAmB,EAAE,eAAe,CAAC,aAAa;YAClD,WAAW,EAAE,sBAAsB;YACnC,UAAU,EAAE;gBACV,cAAc,EAAE,cAAc,CAAC,MAAM;gBACrC,UAAU,EAAE,gBAAgB,CAAC,WAAW;gBACxC,eAAe,EAAE,gBAAgB,CAAC,iBAAiB;gBACnD,gBAAgB,EAAE;oBAChB,aAAa,EAAE,mBAAmB,CAAC,eAAe;oBAClD,WAAW,EAAE,mBAAmB,CAAC,YAAY;oBAC7C,UAAU,EAAE,mBAAmB,CAAC,WAAW;iBAC5C;aACF;SACF,EAAE,OAAO,CAAQ,CAAC;IACrB,CAAC;IAED;;;;;;;;;;;;;OAaG;IAEG,AAAN,KAAK,CAAC,OAAO,CAAC,EAAU,EAAE,QAAgB,EAAE,UAA+B,EAAE;QAC3E,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEzD,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;QAExE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAC7B,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC,EAC7B;YACE,OAAO;YACP,MAAM,EAAE,UAAU;SACnB,CACF,CAAC;QAEF,MAAM,gBAAgB,GAAG,aAAa,CAAC,qBAAqB,CAAC,QAAQ,CAAC,IAAI,CAAqB,EAAE,QAAQ,CAAC,CAAC;QAE3G,OAAO,gBAAgB,CAAC;IAC1B,CAAC;CACF;AA9DO;IADL,KAAK,CAAC,QAAQ,CAAC;0CA4Bf;AAiBK;IADL,KAAK,CAAC,SAAS,CAAC;2CAkBhB"}

package/dist/services/orchestrator/buckets.d.ts

@@ -0,0 +1,186 @@
+import { FolderScopedService } from '../folder-scoped';
+import { Config } from '../../core/config/config';
+import { ExecutionContext } from '../../core/context/execution';
+import { TokenManager } from '../../core/auth/token-manager';
+import { BucketGetResponse, BucketGetAllOptions, BucketGetByIdOptions, BucketGetUriResponse, BucketGetReadUriOptions, BucketGetFileMetaDataWithPaginationOptions, BucketUploadFileOptions, BucketUploadResponse, BlobItem } from '../../models/orchestrator/buckets.types';
+import { BucketServiceModel } from '../../models/orchestrator/buckets.models';
+import { PaginatedResponse, NonPaginatedResponse, HasPaginationOptions } from '../../utils/pagination';
+export declare class BucketService extends FolderScopedService implements BucketServiceModel {
+    protected readonly tokenManager: TokenManager;
+    /**
+     * @hideconstructor
+     */
+    constructor(config: Config, executionContext: ExecutionContext, tokenManager: TokenManager);
+    /**
+     * Gets a bucket by ID
+     * @param bucketId - The ID of the bucket to retrieve
+     * @param folderId - Folder ID for organization unit context
+     * @param options - Optional query parameters (expand, select)
+     * @returns Promise resolving to the bucket
+     *
+     * @example
+     * ```typescript
+     * // Get bucket by ID
+     * const bucket = await sdk.buckets.getById(123, 456);
+     * ```
+     */
+    getById(id: number, folderId: number, options?: BucketGetByIdOptions): Promise<BucketGetResponse>;
+    /**
+     * Gets all buckets across folders with optional filtering and folder scoping
+     *
+     * The method returns either:
+     * - An array of buckets (when no pagination parameters are provided)
+     * - A paginated result with navigation cursors (when any pagination parameter is provided)
+     *
+     * @param options - Query options including optional folderId
+     * @returns Promise resolving to an array of buckets or paginated result
+     *
+     * @example
+     * ```typescript
+     * // Get all buckets across folders
+     * const buckets = await sdk.buckets.getAll();
+     *
+     * // Get buckets within a specific folder
+     * const buckets = await sdk.buckets.getAll({
+     *   folderId: 123
+     * });
+     *
+     * // Get buckets with filtering
+     * const buckets = await sdk.buckets.getAll({
+     *   filter: "name eq 'MyBucket'"
+     * });
+     *
+     * // First page with pagination
+     * const page1 = await sdk.buckets.getAll({ pageSize: 10 });
+     *
+     * // Navigate using cursor
+     * if (page1.hasNextPage) {
+     *   const page2 = await sdk.buckets.getAll({ cursor: page1.nextCursor });
+     * }
+     *
+     * // Jump to specific page
+     * const page5 = await sdk.buckets.getAll({
+     *   jumpToPage: 5,
+     *   pageSize: 10
+     * });
+     * ```
+     */
+    getAll<T extends BucketGetAllOptions = BucketGetAllOptions>(options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<BucketGetResponse> : NonPaginatedResponse<BucketGetResponse>>;
+    /**
+     * Gets metadata for files in a bucket with optional filtering and pagination
+     *
+     * The method returns either:
+     * - A NonPaginatedResponse with items array (when no pagination parameters are provided)
+     * - A PaginatedResponse with navigation cursors (when any pagination parameter is provided)
+     *
+     * @param bucketId - The ID of the bucket to get file metadata from
+     * @param folderId - Required folder ID for organization unit context
+     * @param options - Optional parameters for filtering, pagination and access URL generation
+     * @returns Promise resolving to the list of file metadata in the bucket or paginated result
+     *
+     * @example
+     * ```typescript
+     * // Get metadata for all files in a bucket
+     * const fileMetadata = await sdk.buckets.getFileMetaData(123, 456);
+     *
+     * // Get file metadata with a specific prefix
+     * const fileMetadata = await sdk.buckets.getFileMetaData(123, 456, {
+     *   prefix: '/folder1'
+     * });
+     *
+     * // First page with pagination
+     * const page1 = await sdk.buckets.getFileMetaData(123, 456, { pageSize: 10 });
+     *
+     * // Navigate using cursor
+     * if (page1.hasNextPage) {
+     *   const page2 = await sdk.buckets.getFileMetaData(123, 456, { cursor: page1.nextCursor });
+     * }
+     * ```
+     */
+    getFileMetaData<T extends BucketGetFileMetaDataWithPaginationOptions = BucketGetFileMetaDataWithPaginationOptions>(bucketId: number, folderId: number, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<BlobItem> : NonPaginatedResponse<BlobItem>>;
+    /**
+     * Uploads a file to a bucket
+     *
+     * @param options - Options for file upload including bucket ID, folder ID, path, content, and optional parameters
+     * @returns Promise resolving to a response with success status and HTTP status code
+     *
+     * @example
+     * ```typescript
+     * // Upload a file from browser
+     * const file = new File(['file content'], 'example.txt');
+     * const result = await sdk.buckets.uploadFile({
+     *   bucketId: 123,
+     *   folderId: 456,
+     *   path: '/folder/example.txt',
+     *   content: file
+     * });
+     *
+     * // In Node env with explicit content type
+     * const buffer = Buffer.from('file content');
+     * const result = await sdk.buckets.uploadFile({
+     *   bucketId: 123,
+     *   folderId: 456,
+     *   path: '/folder/example.txt',
+     *   content: buffer,
+     *   contentType: 'text/plain'
+     * });
+     * ```
+     */
+    uploadFile(options: BucketUploadFileOptions): Promise<BucketUploadResponse>;
+    /**
+     * Determines the content type of the file based on the content and path
+     * Uses a hybrid approach:
+     * 1. Checks Blob/File type if available (browser)
+     * 2. Uses content-based detection with file-type (primarily Node.js)
+     * 3. Falls back to extension-based detection with mime-types
+     * 4. Finally defaults to application/octet-stream
+     *
+     * @param content - The file content
+     * @param path - The file path
+     * @returns The determined content type or default
+     */
+    private _determineContentType;
+    /**
+     * Uploads content to the provided URI
+     * @param uriResponse - Response from getWriteUri containing URL and headers
+     * @param content - The content to upload
+     * @param contentType - The content type of the file
+     * @returns The response from the upload request with status info
+     */
+    private _uploadToUri;
+    /**
+     * Private method to handle common URI request logic
+     * @param endpoint - The API endpoint to call
+     * @param bucketId - The bucket ID
+     * @param folderId - The folder ID
+     * @param path - The file path
+     * @param queryOptions - Additional query parameters
+     * @returns Promise resolving to blob file access information
+     */
+    private _getUri;
+    /**
+     * Gets a direct download URL for a file in the bucket
+     *
+     * @param options - Contains bucketId, folderId, file path and optional expiry time
+     * @returns Promise resolving to blob file access information
+     *
+     * @example
+     * ```typescript
+     * // Get download URL for a file
+     * const fileAccess = await sdk.buckets.getReadUri({
+     *   bucketId: 123,
+     *   folderId: 456,
+     *   path: '/folder/file.pdf'
+     * });
+     * ```
+     */
+    getReadUri(options: BucketGetReadUriOptions): Promise<BucketGetUriResponse>;
+    /**
+     * Gets a direct upload URL for a file in the bucket
+     *
+     * @param options - Contains bucketId, folderId, file path, optional expiry time and content type
+     * @returns Promise resolving to blob file access information
+     */
+    private _getWriteUri;
+}
+//# sourceMappingURL=buckets.d.ts.map

package/dist/services/orchestrator/buckets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buckets.d.ts","sourceRoot":"","sources":["../../../src/services/orchestrator/buckets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EAEvB,0CAA0C,EAC1C,uBAAuB,EACvB,oBAAoB,EACpB,QAAQ,EACT,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAY9E,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAkBvG,qBAAa,aAAc,SAAQ,mBAAoB,YAAW,kBAAkB;IAClF,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IAE9C;;OAEG;gBACS,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY;IAK1F;;;;;;;;;;;;OAYG;IAEG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA2B3G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IAEG,MAAM,CAAC,CAAC,SAAS,mBAAmB,GAAG,mBAAmB,EAC9D,OAAO,CAAC,EAAE,CAAC,GACV,OAAO,CACR,CAAC,SAAS,oBAAoB,CAAC,CAAC,CAAC,GAC7B,iBAAiB,CAAC,iBAAiB,CAAC,GACpC,oBAAoB,CAAC,iBAAiB,CAAC,CAC5C;IAuBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IAEG,eAAe,CAAC,CAAC,SAAS,0CAA0C,GAAG,0CAA0C,EACrH,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,CAAC,GACV,OAAO,CACR,CAAC,SAAS,oBAAoB,CAAC,CAAC,CAAC,GAC7B,iBAAiB,CAAC,QAAQ,CAAC,GAC3B,oBAAoB,CAAC,QAAQ,CAAC,CACnC;IA8BD;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IAEG,UAAU,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA6CjF;;;;;;;;;;;OAWG;YACW,qBAAqB;IA6BnC;;;;;;OAMG;YACW,YAAY;IAwD1B;;;;;;;;OAQG;YACW,OAAO;IAiDrB;;;;;;;;;;;;;;;OAeG;IAEG,UAAU,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAiBjF;;;;;OAKG;YACW,YAAY;CAiB3B"}