@uipath/uipath-typescript 1.0.0-beta.17 → 1.0.0

package/dist/entities/index.cjs

@@ -0,0 +1,2749 @@
+'use strict';
+
+var sdkLogs = require('@opentelemetry/sdk-logs');
+
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+/* global Reflect, Promise, SuppressedError, Symbol, Iterator */
+
+
+function __decorate(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;
+}
+
+function __classPrivateFieldGet(receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+}
+
+function __classPrivateFieldSet(receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+/**
+ * Base error class for all UiPath SDK errors
+ * Pure TypeScript class with clean interface
+ */
+class UiPathError {
+    constructor(type, params) {
+        this.type = type;
+        this.message = params.message;
+        this.statusCode = params.statusCode;
+        this.requestId = params.requestId;
+        this.timestamp = new Date();
+        // Capture stack trace for debugging
+        this.stack = (new Error()).stack;
+    }
+    /**
+     * Returns a clean JSON representation of the error
+     */
+    toJSON() {
+        return {
+            type: this.type,
+            message: this.message,
+            statusCode: this.statusCode,
+            requestId: this.requestId,
+            timestamp: this.timestamp
+        };
+    }
+    /**
+     * Returns detailed debug information including stack trace
+     */
+    getDebugInfo() {
+        return {
+            ...this.toJSON(),
+            stack: this.stack
+        };
+    }
+}
+
+/**
+ * HTTP status code constants for error handling
+ */
+const HttpStatus = {
+    // Client errors (4xx)
+    BAD_REQUEST: 400,
+    UNAUTHORIZED: 401,
+    FORBIDDEN: 403,
+    NOT_FOUND: 404,
+    TOO_MANY_REQUESTS: 429,
+    // Server errors (5xx)
+    INTERNAL_SERVER_ERROR: 500,
+    BAD_GATEWAY: 502,
+    SERVICE_UNAVAILABLE: 503,
+    GATEWAY_TIMEOUT: 504
+};
+/**
+ * Error type constants for consistent error identification
+ */
+const ErrorType = {
+    AUTHENTICATION: 'AuthenticationError',
+    AUTHORIZATION: 'AuthorizationError',
+    VALIDATION: 'ValidationError',
+    NOT_FOUND: 'NotFoundError',
+    RATE_LIMIT: 'RateLimitError',
+    SERVER: 'ServerError',
+    NETWORK: 'NetworkError'
+};
+/**
+ * HTTP header constants for error handling
+ */
+const HttpHeaders = {
+    X_REQUEST_ID: 'x-request-id'
+};
+/**
+ * Standard error message constants
+ */
+const ErrorMessages = {
+    // Authentication errors
+    AUTHENTICATION_FAILED: 'Authentication failed',
+    // Authorization errors  
+    ACCESS_DENIED: 'Access denied',
+    // Validation errors
+    VALIDATION_FAILED: 'Validation failed',
+    // Not found errors
+    RESOURCE_NOT_FOUND: 'Resource not found',
+    // Rate limit errors
+    RATE_LIMIT_EXCEEDED: 'Rate limit exceeded',
+    // Server errors
+    INTERNAL_SERVER_ERROR: 'Internal Server error occurred',
+    // Network errors
+    NETWORK_ERROR: 'Network error occurred',
+    REQUEST_TIMEOUT: 'Request timed out',
+    REQUEST_ABORTED: 'Request was aborted',
+};
+/**
+ * Error name constants for network error identification
+ */
+const ErrorNames = {
+    ABORT_ERROR: 'AbortError'};
+
+/**
+ * Error thrown when authentication fails (401 errors)
+ * Common scenarios:
+ * - Invalid credentials
+ * - Expired token
+ * - Missing authentication
+ */
+class AuthenticationError extends UiPathError {
+    constructor(params = {}) {
+        super(ErrorType.AUTHENTICATION, {
+            message: params.message || ErrorMessages.AUTHENTICATION_FAILED,
+            statusCode: params.statusCode ?? HttpStatus.UNAUTHORIZED,
+            requestId: params.requestId
+        });
+    }
+}
+
+/**
+ * Error thrown when authorization fails (403 errors)
+ * Common scenarios:
+ * - Insufficient permissions
+ * - Access denied to resource
+ * - Invalid scope
+ */
+class AuthorizationError extends UiPathError {
+    constructor(params = {}) {
+        super(ErrorType.AUTHORIZATION, {
+            message: params.message || ErrorMessages.ACCESS_DENIED,
+            statusCode: params.statusCode ?? HttpStatus.FORBIDDEN,
+            requestId: params.requestId
+        });
+    }
+}
+
+/**
+ * Error thrown when validation fails (400 errors or client-side validation)
+ * Common scenarios:
+ * - Invalid input parameters
+ * - Missing required fields
+ * - Invalid data format
+ */
+class ValidationError extends UiPathError {
+    constructor(params = {}) {
+        super(ErrorType.VALIDATION, {
+            message: params.message || ErrorMessages.VALIDATION_FAILED,
+            statusCode: params.statusCode ?? HttpStatus.BAD_REQUEST,
+            requestId: params.requestId
+        });
+    }
+}
+
+/**
+ * Error thrown when a resource is not found (404 errors)
+ * Common scenarios:
+ * - Resource doesn't exist
+ * - Invalid ID provided
+ * - Resource deleted
+ */
+class NotFoundError extends UiPathError {
+    constructor(params = {}) {
+        super(ErrorType.NOT_FOUND, {
+            message: params.message || ErrorMessages.RESOURCE_NOT_FOUND,
+            statusCode: params.statusCode ?? HttpStatus.NOT_FOUND,
+            requestId: params.requestId
+        });
+    }
+}
+
+/**
+ * Error thrown when rate limit is exceeded (429 errors)
+ * Common scenarios:
+ * - Too many requests in a time window
+ * - API throttling
+ */
+class RateLimitError extends UiPathError {
+    constructor(params = {}) {
+        super(ErrorType.RATE_LIMIT, {
+            message: params.message || ErrorMessages.RATE_LIMIT_EXCEEDED,
+            statusCode: params.statusCode ?? HttpStatus.TOO_MANY_REQUESTS,
+            requestId: params.requestId
+        });
+    }
+}
+
+/**
+ * Error thrown when server encounters an error (5xx errors)
+ * Common scenarios:
+ * - Internal server error
+ * - Service unavailable
+ * - Gateway timeout
+ */
+class ServerError extends UiPathError {
+    constructor(params = {}) {
+        super(ErrorType.SERVER, {
+            message: params.message || ErrorMessages.INTERNAL_SERVER_ERROR,
+            statusCode: params.statusCode ?? HttpStatus.INTERNAL_SERVER_ERROR,
+            requestId: params.requestId
+        });
+    }
+    /**
+     * Checks if this is a temporary error that might succeed on retry
+     */
+    get isRetryable() {
+        return this.statusCode === HttpStatus.BAD_GATEWAY ||
+            this.statusCode === HttpStatus.SERVICE_UNAVAILABLE ||
+            this.statusCode === HttpStatus.GATEWAY_TIMEOUT;
+    }
+}
+
+/**
+ * Error thrown when network/connection issues occur
+ * Common scenarios:
+ * - Connection timeout
+ * - DNS resolution failure
+ * - Network unreachable
+ * - Request aborted
+ */
+class NetworkError extends UiPathError {
+    constructor(params = {}) {
+        super(ErrorType.NETWORK, {
+            message: params.message || ErrorMessages.NETWORK_ERROR,
+            statusCode: params.statusCode, // Network errors typically don't have HTTP status codes
+            requestId: params.requestId
+        });
+    }
+}
+
+/**
+ * Type guards for error response types
+ */
+function isOrchestratorError(error) {
+    return typeof error === 'object' &&
+        error !== null &&
+        'message' in error &&
+        'errorCode' in error &&
+        typeof error.message === 'string' &&
+        typeof error.errorCode === 'number';
+}
+function isEntityError(error) {
+    return typeof error === 'object' &&
+        error !== null &&
+        'error' in error &&
+        typeof error.error === 'string';
+}
+function isPimsError(error) {
+    return typeof error === 'object' &&
+        error !== null &&
+        'type' in error &&
+        'title' in error &&
+        'status' in error &&
+        typeof error.type === 'string' &&
+        typeof error.title === 'string' &&
+        typeof error.status === 'number';
+}
+
+/**
+ * Parser for Orchestrator/Task error format
+ */
+class OrchestratorErrorParser {
+    canParse(errorBody) {
+        return isOrchestratorError(errorBody);
+    }
+    parse(errorBody, response) {
+        const error = errorBody;
+        return {
+            message: error.message,
+            code: response?.status?.toString(),
+            details: {
+                errorCode: error.errorCode,
+                traceId: error.traceId,
+                originalResponse: error
+            },
+            requestId: error.traceId
+        };
+    }
+}
+/**
+ * Parser for Entity (Data Fabric) error format
+ */
+class EntityErrorParser {
+    canParse(errorBody) {
+        return isEntityError(errorBody);
+    }
+    parse(errorBody, response) {
+        const error = errorBody;
+        return {
+            message: error.error,
+            code: response?.status?.toString(),
+            details: {
+                error: error.error,
+                traceId: error.traceId,
+                originalResponse: error
+            },
+            requestId: error.traceId
+        };
+    }
+}
+/**
+ * Parser for PIMS error format
+ */
+class PimsErrorParser {
+    canParse(errorBody) {
+        return isPimsError(errorBody);
+    }
+    parse(errorBody, response) {
+        const error = errorBody;
+        let message = error.title;
+        // If there are validation errors, append them to the message for better visibility
+        if (error.errors && Object.keys(error.errors).length > 0) {
+            const errorMessages = Object.entries(error.errors)
+                .map(([field, messages]) => `${field}: ${messages.join(', ')}`)
+                .join('; ');
+            message += `. Validation errors: ${errorMessages}`;
+        }
+        return {
+            message,
+            code: response?.status?.toString(),
+            details: {
+                type: error.type,
+                title: error.title,
+                status: error.status,
+                errors: error.errors,
+                traceId: error.traceId,
+                originalResponse: error
+            },
+            requestId: error.traceId
+        };
+    }
+}
+/**
+ * Fallback parser for unrecognized formats
+ */
+class GenericErrorParser {
+    canParse(_errorBody) {
+        return true; // Always can parse as last resort
+    }
+    parse(errorBody, response) {
+        // For unknown error formats, just pass through the raw error with fallback message
+        const message = response?.statusText || 'An error occurred';
+        return {
+            message,
+            code: response?.status?.toString(),
+            details: {
+                originalResponse: errorBody
+            },
+        };
+    }
+}
+/**
+ * Main error response parser using Chain of Responsibility pattern
+ *
+ * This parser standardizes error responses from different UiPath services into a
+ * consistent format, regardless of the original error structure.
+ *
+ * Supported formats:
+ * 1. Orchestrator/Task: { message, errorCode, traceId }
+ * 2. Entity (Data Fabric): { error, traceId }
+ * 3. PIMS/Maestro: { type, title, status, errors?, traceId? }
+ * 4. Generic: Fallback for any other format
+ *
+ * @example
+ * const parser = new ErrorResponseParser();
+ * const errorInfo = await parser.parse(response);
+ * // errorInfo will have consistent structure regardless of service
+ */
+class ErrorResponseParser {
+    constructor() {
+        this.strategies = [
+            new OrchestratorErrorParser(),
+            new EntityErrorParser(),
+            new PimsErrorParser(),
+            new GenericErrorParser() // Must be last
+        ];
+    }
+    /**
+     * Parses error response body into standardized format
+     * @param response - The HTTP response object
+     * @returns Standardized error information
+     */
+    async parse(response) {
+        try {
+            const errorBody = await response.json();
+            // Find the first strategy that can parse this error format
+            const strategy = this.strategies.find(s => s.canParse(errorBody));
+            // GenericErrorParser always returns true, so this will never be null
+            return strategy.parse(errorBody, response);
+        }
+        catch {
+            // Handle non-JSON responses
+            const responseText = await response.text().catch(() => '');
+            return {
+                message: response.statusText,
+                code: response.status.toString(),
+                details: {
+                    parseError: 'Failed to parse error response as JSON',
+                    responseText
+                },
+                requestId: response.headers.get(HttpHeaders.X_REQUEST_ID) || undefined
+            };
+        }
+    }
+}
+// Export singleton instance
+const errorResponseParser = new ErrorResponseParser();
+
+/**
+ * Factory for creating typed errors based on HTTP status codes
+ * Follows the Factory pattern for clean error instantiation
+ */
+class ErrorFactory {
+    /**
+     * Creates appropriate error instance based on HTTP status code
+     */
+    static createFromHttpStatus(statusCode, errorInfo) {
+        const { message, requestId } = errorInfo;
+        // Map status codes to error types
+        switch (statusCode) {
+            case HttpStatus.BAD_REQUEST:
+                return new ValidationError({ message, statusCode, requestId });
+            case HttpStatus.UNAUTHORIZED:
+                return new AuthenticationError({ message, statusCode, requestId });
+            case HttpStatus.FORBIDDEN:
+                return new AuthorizationError({ message, statusCode, requestId });
+            case HttpStatus.NOT_FOUND:
+                return new NotFoundError({ message, statusCode, requestId });
+            case HttpStatus.TOO_MANY_REQUESTS:
+                return new RateLimitError({ message, statusCode, requestId });
+            default:
+                // For 5xx errors or any other status code
+                if (statusCode >= HttpStatus.INTERNAL_SERVER_ERROR) {
+                    return new ServerError({ message, statusCode, requestId });
+                }
+                // For unknown client errors, treat as validation error
+                return new ValidationError({
+                    message: `${message} (HTTP ${statusCode})`,
+                    statusCode,
+                    requestId
+                });
+        }
+    }
+    /**
+     * Creates a NetworkError from a fetch/network error
+     */
+    static createNetworkError(error) {
+        let message = ErrorMessages.NETWORK_ERROR;
+        if (error instanceof Error) {
+            if (error.name === ErrorNames.ABORT_ERROR) {
+                message = ErrorMessages.REQUEST_ABORTED;
+            }
+            else if (error.message.includes('timeout')) {
+                message = ErrorMessages.REQUEST_TIMEOUT;
+            }
+            else {
+                message = error.message;
+            }
+        }
+        return new NetworkError({ message });
+    }
+}
+
+const FOLDER_ID = 'X-UIPATH-OrganizationUnitId';
+/**
+ * Content type constants for HTTP requests/responses
+ */
+const CONTENT_TYPES = {
+    JSON: 'application/json',
+    XML: 'application/xml',
+    OCTET_STREAM: 'application/octet-stream'
+};
+/**
+ * Response type constants for HTTP requests
+ */
+const RESPONSE_TYPES = {
+    JSON: 'json',
+    TEXT: 'text',
+    BLOB: 'blob',
+    ARRAYBUFFER: 'arraybuffer'
+};
+
+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.
+     *
+     * @returns The valid token
+     * @throws AuthenticationError if no token available or refresh fails
+     */
+    async getValidToken() {
+        // Try to get token info from context
+        const tokenInfo = this.executionContext.get('tokenInfo');
+        if (!tokenInfo) {
+            throw new AuthenticationError({ message: 'No authentication token available. Make sure to initialize the SDK first.' });
+        }
+        // For secret-based tokens, they never expire
+        if (tokenInfo.type === 'secret') {
+            return tokenInfo.token;
+        }
+        // If token is not expired, return it
+        if (!this.tokenManager.isTokenExpired(tokenInfo)) {
+            return tokenInfo.token;
+        }
+        try {
+            const newToken = await this.tokenManager.refreshAccessToken();
+            return newToken.access_token;
+        }
+        catch (error) {
+            throw new AuthenticationError({
+                message: `Token refresh failed: ${error.message}. Please re-authenticate.`,
+                statusCode: HttpStatus.UNAUTHORIZED
+            });
+        }
+    }
+    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,
+            'Authorization': `Bearer ${token}`,
+            'Content-Type': CONTENT_TYPES.JSON,
+            ...this.defaultHeaders,
+            ...this.clientConfig.headers
+        };
+    }
+    async request(method, path, options = {}) {
+        // Ensure path starts with a forward slash
+        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 headers = {
+            ...await this.getDefaultHeaders(),
+            ...options.headers
+        };
+        // Convert params to URLSearchParams
+        const searchParams = new URLSearchParams();
+        if (options.params) {
+            Object.entries(options.params).forEach(([key, value]) => {
+                searchParams.append(key, value.toString());
+            });
+        }
+        const fullUrl = searchParams.toString() ? `${url}?${searchParams.toString()}` : url;
+        try {
+            const response = await fetch(fullUrl, {
+                method,
+                headers,
+                body: options.body ? JSON.stringify(options.body) : undefined,
+                signal: options.signal
+            });
+            if (!response.ok) {
+                const errorInfo = await errorResponseParser.parse(response);
+                throw ErrorFactory.createFromHttpStatus(response.status, errorInfo);
+            }
+            if (response.status === 204) {
+                return undefined;
+            }
+            // Handle blob response type for binary data (e.g., file downloads)
+            if (options.responseType === RESPONSE_TYPES.BLOB) {
+                const blob = await response.blob();
+                return blob;
+            }
+            // Check if we're expecting XML
+            const acceptHeader = headers['Accept'] || headers['accept'];
+            if (acceptHeader === CONTENT_TYPES.XML) {
+                const text = await response.text();
+                return text;
+            }
+            return response.json();
+        }
+        catch (error) {
+            // If it's already one of our errors, re-throw it
+            if (error.type && error.type.includes('Error')) {
+                throw error;
+            }
+            // Otherwise, it's likely a network error
+            throw ErrorFactory.createNetworkError(error);
+        }
+    }
+    async get(path, options = {}) {
+        return this.request('GET', path, options);
+    }
+    async post(path, data, options = {}) {
+        return this.request('POST', path, { ...options, body: data });
+    }
+    async put(path, data, options = {}) {
+        return this.request('PUT', path, { ...options, body: data });
+    }
+    async patch(path, data, options = {}) {
+        return this.request('PATCH', path, { ...options, body: data });
+    }
+    async delete(path, options = {}) {
+        return this.request('DELETE', path, options);
+    }
+}
+
+/**
+ * Pagination types supported by the SDK
+ */
+var PaginationType;
+(function (PaginationType) {
+    PaginationType["OFFSET"] = "offset";
+    PaginationType["TOKEN"] = "token";
+})(PaginationType || (PaginationType = {}));
+
+/**
+ * Collection of utility functions for working with objects
+ */
+/**
+ * Filters out undefined values from an object
+ * @param obj The source object
+ * @returns A new object without undefined values
+ *
+ * @example
+ * ```typescript
+ * // Object with undefined values
+ * const options = {
+ *   name: 'test',
+ *   count: 5,
+ *   prefix: undefined,
+ *   suffix: null
+ * };
+ * const result = filterUndefined(options);
+ * // result = { name: 'test', count: 5, suffix: null }
+ * ```
+ */
+function filterUndefined(obj) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (value !== undefined) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+
+/**
+ * Utility functions for platform detection
+ */
+/**
+ * Checks if code is running in a browser environment
+ */
+const isBrowser = typeof window !== 'undefined' && typeof window.document !== 'undefined';
+
+/**
+ * Base64 encoding/decoding
+ */
+/**
+ * Encodes a string to base64
+ * @param str - The string to encode
+ * @returns Base64 encoded string
+ */
+function encodeBase64(str) {
+    // TextEncoder for UTF-8 encoding (works in both browser and Node.js)
+    const encoder = new TextEncoder();
+    const data = encoder.encode(str);
+    // Convert Uint8Array to base64
+    if (isBrowser) {
+        // Browser environment
+        // Convert Uint8Array to binary string then to base64
+        const binaryString = Array.from(data, byte => String.fromCharCode(byte)).join('');
+        return btoa(binaryString);
+    }
+    else {
+        // Node.js environment
+        return Buffer.from(data).toString('base64');
+    }
+}
+/**
+ * Decodes a base64 string
+ * @param base64 - The base64 string to decode
+ * @returns Decoded string
+ */
+function decodeBase64(base64) {
+    let bytes;
+    if (isBrowser) {
+        // Browser environment
+        const binaryString = atob(base64);
+        bytes = new Uint8Array(binaryString.length);
+        for (let i = 0; i < binaryString.length; i++) {
+            bytes[i] = binaryString.charCodeAt(i);
+        }
+    }
+    else {
+        // Node.js environment
+        bytes = new Uint8Array(Buffer.from(base64, 'base64'));
+    }
+    // TextDecoder for UTF-8 decoding (works in both browser and Node.js)
+    const decoder = new TextDecoder();
+    return decoder.decode(bytes);
+}
+
+/**
+ * PaginationManager handles the conversion between uniform cursor-based pagination
+ * and the specific pagination type for each service
+ */
+class PaginationManager {
+    /**
+     * Create a pagination cursor for subsequent page requests
+     */
+    static createCursor({ pageInfo, type }) {
+        if (!pageInfo.hasMore) {
+            return undefined;
+        }
+        const cursorData = {
+            type,
+            pageSize: pageInfo.pageSize,
+        };
+        switch (type) {
+            case PaginationType.OFFSET:
+                if (pageInfo.currentPage) {
+                    cursorData.pageNumber = pageInfo.currentPage + 1;
+                }
+                break;
+            case PaginationType.TOKEN:
+                if (pageInfo.continuationToken) {
+                    cursorData.continuationToken = pageInfo.continuationToken;
+                }
+                else {
+                    return undefined; // No continuation token, can't continue
+                }
+                break;
+        }
+        return {
+            value: encodeBase64(JSON.stringify(cursorData))
+        };
+    }
+    /**
+     * Create a paginated response with navigation cursors
+     */
+    static createPaginatedResponse({ pageInfo, type }, items) {
+        const nextCursor = PaginationManager.createCursor({ pageInfo, type });
+        // Create previous page cursor if applicable
+        let previousCursor = undefined;
+        if (pageInfo.currentPage && pageInfo.currentPage > 1) {
+            const prevCursorData = {
+                type,
+                pageNumber: pageInfo.currentPage - 1,
+                pageSize: pageInfo.pageSize,
+            };
+            previousCursor = {
+                value: encodeBase64(JSON.stringify(prevCursorData))
+            };
+        }
+        // Calculate total pages if we have totalCount and pageSize
+        let totalPages = undefined;
+        if (pageInfo.totalCount !== undefined && pageInfo.pageSize) {
+            totalPages = Math.ceil(pageInfo.totalCount / pageInfo.pageSize);
+        }
+        // Determine if this pagination type supports page jumping
+        const supportsPageJump = type === PaginationType.OFFSET;
+        // Create the result object with all fields, then filter out undefined values
+        const result = filterUndefined({
+            items,
+            totalCount: pageInfo.totalCount,
+            hasNextPage: pageInfo.hasMore,
+            nextCursor: nextCursor,
+            previousCursor: previousCursor,
+            currentPage: pageInfo.currentPage,
+            totalPages,
+            supportsPageJump
+        });
+        return result;
+    }
+}
+
+/**
+ * Creates headers object from key-value pairs
+ * @param headersObj - Object containing header key-value pairs
+ * @returns Headers object with all values converted to strings
+ *
+ * @example
+ * ```typescript
+ * // Single header
+ * const headers = createHeaders({ 'X-UIPATH-FolderKey': '1234567890' });
+ *
+ * // Multiple headers
+ * const headers = createHeaders({
+ *   'X-UIPATH-FolderKey': '1234567890',
+ *   'X-UIPATH-OrganizationUnitId': 123,
+ *   'Accept': 'application/json'
+ * });
+ *
+ * // Using constants
+ * import { FOLDER_KEY, FOLDER_ID } from '../constants/headers';
+ * const headers = createHeaders({
+ *   [FOLDER_KEY]: 'abc-123',
+ *   [FOLDER_ID]: 456
+ * });
+ *
+ * // Empty headers
+ * const headers = createHeaders();
+ * ```
+ */
+function createHeaders(headersObj) {
+    const headers = {};
+    for (const [key, value] of Object.entries(headersObj)) {
+        if (value !== undefined && value !== null) {
+            headers[key] = value.toString();
+        }
+    }
+    return headers;
+}
+
+/**
+ * Common constants used across the SDK
+ */
+/**
+ * Prefix used for OData query parameters
+ */
+const ODATA_PREFIX = '$';
+/**
+ * HTTP methods
+ */
+const HTTP_METHODS = {
+    GET: 'GET',
+    POST: 'POST'};
+/**
+ * Entity pagination constants for Data Fabric entities
+ */
+const ENTITY_PAGINATION = {
+    /** Field name for items in entity response */
+    ITEMS_FIELD: 'value',
+    /** Field name for total count in entity response */
+    TOTAL_COUNT_FIELD: 'totalRecordCount'
+};
+/**
+ * Choice Set values endpoint pagination constants
+ * Note: The API returns items as a JSON string in 'jsonValue' field
+ */
+const CHOICESET_VALUES_PAGINATION = {
+    /** Field name for items in choice set values response (contains JSON string) */
+    ITEMS_FIELD: 'jsonValue',
+    /** Field name for total count in choice set values response */
+    TOTAL_COUNT_FIELD: 'totalRecordCount'
+};
+/**
+ * OData OFFSET pagination parameter names (ODATA-style)
+ */
+const ODATA_OFFSET_PARAMS = {
+    /** OData page size parameter name */
+    PAGE_SIZE_PARAM: '$top',
+    /** OData offset parameter name */
+    OFFSET_PARAM: '$skip',
+    /** OData count parameter name */
+    COUNT_PARAM: '$count'
+};
+/**
+ * Entity OFFSET pagination parameter names (limit/start style)
+ */
+const ENTITY_OFFSET_PARAMS = {
+    /** Entity page size parameter name */
+    PAGE_SIZE_PARAM: 'limit',
+    /** Entity offset parameter name */
+    OFFSET_PARAM: 'start',
+    /** Entity count parameter (not used) */
+    COUNT_PARAM: undefined
+};
+/**
+ * Bucket TOKEN pagination parameter names
+ */
+const BUCKET_TOKEN_PARAMS = {
+    /** Bucket page size parameter name */
+    PAGE_SIZE_PARAM: 'takeHint',
+    /** Bucket token parameter name */
+    TOKEN_PARAM: 'continuationToken'
+};
+
+/**
+ * Transforms data by mapping fields according to the provided field mapping
+ * @param data The source data to transform
+ * @param fieldMapping Object mapping source field names to target field names
+ * @returns Transformed data with mapped field names
+ *
+ * @example
+ * ```typescript
+ * // Single object transformation
+ * const data = { id: '123', userName: 'john' };
+ * const mapping = { id: 'userId', userName: 'name' };
+ * const result = transformData(data, mapping);
+ * // result = { userId: '123', name: 'john' }
+ *
+ * // Array transformation
+ * const dataArray = [
+ *   { id: '123', userName: 'john' },
+ *   { id: '456', userName: 'jane' }
+ * ];
+ * const result = transformData(dataArray, mapping);
+ * // result = [
+ * //   { userId: '123', name: 'john' },
+ * //   { userId: '456', name: 'jane' }
+ * // ]
+ * ```
+ */
+function transformData(data, fieldMapping) {
+    // Handle array of objects
+    if (Array.isArray(data)) {
+        return data.map(item => transformData(item, fieldMapping));
+    }
+    // Handle single object
+    const result = { ...data };
+    for (const [sourceField, targetField] of Object.entries(fieldMapping)) {
+        if (sourceField in result) {
+            const value = result[sourceField];
+            delete result[sourceField];
+            result[targetField] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Converts a string from PascalCase to camelCase
+ * @param str The PascalCase string to convert
+ * @returns The camelCase version of the string
+ *
+ * @example
+ * ```typescript
+ * pascalToCamelCase('HelloWorld'); // 'helloWorld'
+ * pascalToCamelCase('TaskAssignmentCriteria'); // 'taskAssignmentCriteria'
+ * ```
+ */
+function pascalToCamelCase(str) {
+    if (!str)
+        return str;
+    return str.charAt(0).toLowerCase() + str.slice(1);
+}
+/**
+ * Generic function to transform object keys using a provided case conversion function
+ * @param data The object to transform
+ * @param convertCase The function to convert each key
+ * @returns A new object with transformed keys
+ */
+function transformCaseKeys(data, convertCase) {
+    // Handle array of objects
+    if (Array.isArray(data)) {
+        return data.map(item => {
+            // If the array element is a primitive (string, number, etc.), return it as is
+            if (item === null || typeof item !== 'object' || typeof item === 'string') {
+                return item;
+            }
+            // Only recursively transform if it's actually an object
+            return transformCaseKeys(item, convertCase);
+        });
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(data)) {
+        const transformedKey = convertCase(key);
+        // Recursively transform nested objects and arrays
+        if (value !== null && typeof value === 'object') {
+            result[transformedKey] = transformCaseKeys(value, convertCase);
+        }
+        else {
+            result[transformedKey] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Transforms an object's keys from PascalCase to camelCase
+ * @param data The object with PascalCase keys
+ * @returns A new object with all keys converted to camelCase
+ *
+ * @example
+ * ```typescript
+ * // Simple object
+ * pascalToCamelCaseKeys({ Id: "123", TaskName: "Invoice" });
+ * // Result: { id: "123", taskName: "Invoice" }
+ *
+ * // Nested object
+ * pascalToCamelCaseKeys({
+ *   TaskId: "456",
+ *   TaskDetails: { AssignedUser: "John", Priority: "High" }
+ * });
+ * // Result: {
+ * //   taskId: "456",
+ * //   taskDetails: { assignedUser: "John", priority: "High" }
+ * // }
+ *
+ * // Array of objects
+ * pascalToCamelCaseKeys([
+ *   { Id: "1", IsComplete: false },
+ *   { Id: "2", IsComplete: true }
+ * ]);
+ * // Result: [
+ * //   { id: "1", isComplete: false },
+ * //   { id: "2", isComplete: true }
+ * // ]
+ * ```
+ */
+function pascalToCamelCaseKeys(data) {
+    return transformCaseKeys(data, pascalToCamelCase);
+}
+/**
+ * Adds a prefix to specified keys in an object, returning a new object.
+ * Only the provided keys are prefixed; all others are left unchanged.
+ *
+ * @param obj The source object
+ * @param prefix The prefix to add (e.g., '$')
+ * @param keys The keys to prefix (e.g., ['expand', 'filter'])
+ * @returns A new object with specified keys prefixed
+ *
+ * @example
+ * addPrefixToKeys({ expand: 'a', foo: 1 }, '$', ['expand']) // { $expand: 'a', foo: 1 }
+ */
+function addPrefixToKeys(obj, prefix, keys) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (keys.includes(key)) {
+            result[`${prefix}${key}`] = value;
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+
+/**
+ * Constants used throughout the pagination system
+ */
+/** Maximum number of items that can be requested in a single page */
+const MAX_PAGE_SIZE = 1000;
+/** Default page size when jumpToPage is used without specifying pageSize */
+const DEFAULT_PAGE_SIZE = 50;
+/** Default field name for items in a paginated response */
+const DEFAULT_ITEMS_FIELD = 'value';
+/** Default field name for total count in a paginated response */
+const DEFAULT_TOTAL_COUNT_FIELD = '@odata.count';
+/**
+ * Limits the page size to the maximum allowed value
+ * @param pageSize - Requested page size
+ * @returns Limited page size value
+ */
+function getLimitedPageSize(pageSize) {
+    if (pageSize === undefined || pageSize === null) {
+        return DEFAULT_PAGE_SIZE;
+    }
+    return Math.max(1, Math.min(pageSize, MAX_PAGE_SIZE));
+}
+
+/**
+ * Helper functions for pagination that can be used across services
+ */
+class PaginationHelpers {
+    /**
+     * Checks if any pagination parameters are provided
+     *
+     * @param options - The options object to check
+     * @returns True if any pagination parameter is defined, false otherwise
+     */
+    static hasPaginationParameters(options = {}) {
+        const { cursor, pageSize, jumpToPage } = options;
+        return cursor !== undefined || pageSize !== undefined || jumpToPage !== undefined;
+    }
+    /**
+     * Parse a pagination cursor string into cursor data
+     */
+    static parseCursor(cursorString) {
+        try {
+            const cursorData = JSON.parse(decodeBase64(cursorString));
+            return cursorData;
+        }
+        catch {
+            throw new Error('Invalid pagination cursor');
+        }
+    }
+    /**
+     * Validates cursor format and structure
+     *
+     * @param paginationOptions - The pagination options containing the cursor
+     * @param paginationType - Optional pagination type to validate against
+     */
+    static validateCursor(paginationOptions, paginationType) {
+        if (paginationOptions.cursor !== undefined) {
+            if (!paginationOptions.cursor || typeof paginationOptions.cursor.value !== 'string' || !paginationOptions.cursor.value) {
+                throw new Error('cursor must contain a valid cursor string');
+            }
+            try {
+                // Try to parse the cursor to validate it
+                const cursorData = PaginationHelpers.parseCursor(paginationOptions.cursor.value);
+                // If type is provided, validate cursor contains expected type information
+                if (paginationType) {
+                    if (!cursorData.type) {
+                        throw new Error('Invalid cursor: missing pagination type');
+                    }
+                    // Check pagination type compatibility
+                    if (cursorData.type !== paginationType) {
+                        throw new Error(`Pagination type mismatch: cursor is for ${cursorData.type} but service uses ${paginationType}`);
+                    }
+                }
+            }
+            catch (error) {
+                if (error instanceof Error) {
+                    // If it's already our error with specific message, pass it through
+                    if (error.message.startsWith('Invalid cursor') ||
+                        error.message.startsWith('Pagination type mismatch')) {
+                        throw error;
+                    }
+                }
+                throw new Error('Invalid pagination cursor format');
+            }
+        }
+    }
+    /**
+     * Comprehensive validation for pagination options
+     *
+     * @param options - The pagination options to validate
+     * @param paginationType - The pagination type these options will be used with
+     * @returns Processed pagination parameters ready for use
+     */
+    static validatePaginationOptions(options, paginationType) {
+        // Validate pageSize
+        if (options.pageSize !== undefined && options.pageSize <= 0) {
+            throw new Error('pageSize must be a positive number');
+        }
+        // Validate jumpToPage
+        if (options.jumpToPage !== undefined && options.jumpToPage <= 0) {
+            throw new Error('jumpToPage must be a positive number');
+        }
+        // Validate cursor
+        PaginationHelpers.validateCursor(options, paginationType);
+        // Validate service compatibility
+        if (options.jumpToPage !== undefined && paginationType === PaginationType.TOKEN) {
+            throw new Error('jumpToPage is not supported for token-based pagination. Use cursor-based navigation instead.');
+        }
+        // Get processed parameters
+        return PaginationHelpers.getRequestParameters(options, paginationType);
+    }
+    /**
+     * Convert a unified pagination options to service-specific parameters
+     */
+    static getRequestParameters(options, paginationType) {
+        // Handle jumpToPage
+        if (options.jumpToPage !== undefined) {
+            const jumpToPageOptions = {
+                pageSize: options.pageSize,
+                pageNumber: options.jumpToPage
+            };
+            return filterUndefined(jumpToPageOptions);
+        }
+        // If no cursor is provided, it's a first page request
+        if (!options.cursor) {
+            const firstPageOptions = {
+                pageSize: options.pageSize,
+                // Only set pageNumber for OFFSET pagination
+                pageNumber: paginationType === PaginationType.OFFSET ? 1 : undefined
+            };
+            return filterUndefined(firstPageOptions);
+        }
+        // Parse the cursor
+        try {
+            const cursorData = PaginationHelpers.parseCursor(options.cursor.value);
+            const cursorBasedOptions = {
+                pageSize: cursorData.pageSize || options.pageSize,
+                pageNumber: cursorData.pageNumber,
+                continuationToken: cursorData.continuationToken,
+                type: cursorData.type,
+            };
+            return filterUndefined(cursorBasedOptions);
+        }
+        catch {
+            throw new Error('Invalid pagination cursor');
+        }
+    }
+    /**
+     * Helper method for paginated resource retrieval
+     *
+     * @param params - Parameters for pagination
+     * @returns Promise resolving to a paginated result
+     */
+    static async getAllPaginated(params) {
+        const { serviceAccess, getEndpoint, folderId, paginationParams, additionalParams, transformFn, method = HTTP_METHODS.GET, options = {} } = params;
+        const endpoint = getEndpoint(folderId);
+        const headers = folderId ? createHeaders({ [FOLDER_ID]: folderId }) : {};
+        const paginatedResponse = await serviceAccess.requestWithPagination(method, endpoint, paginationParams, {
+            headers,
+            params: additionalParams,
+            pagination: {
+                paginationType: options.paginationType || PaginationType.OFFSET,
+                itemsField: options.itemsField || DEFAULT_ITEMS_FIELD,
+                totalCountField: options.totalCountField || DEFAULT_TOTAL_COUNT_FIELD,
+                continuationTokenField: options.continuationTokenField,
+                paginationParams: options.paginationParams
+            }
+        });
+        // Parse items - automatically handle JSON string responses
+        const rawItems = paginatedResponse.items;
+        const parsedItems = typeof rawItems === 'string' ? JSON.parse(rawItems) : (rawItems || []);
+        const transformedItems = transformFn ? parsedItems.map(transformFn) : parsedItems;
+        return {
+            ...paginatedResponse,
+            items: transformedItems
+        };
+    }
+    /**
+     * Helper method for non-paginated resource retrieval
+     *
+     * @param params - Parameters for non-paginated resource retrieval
+     * @returns Promise resolving to an object with data and totalCount
+     */
+    static async getAllNonPaginated(params) {
+        const { serviceAccess, getAllEndpoint, getByFolderEndpoint, folderId, additionalParams, transformFn, method = HTTP_METHODS.GET, options = {} } = params;
+        // Set default field names
+        const itemsField = options.itemsField || DEFAULT_ITEMS_FIELD;
+        const totalCountField = options.totalCountField || DEFAULT_TOTAL_COUNT_FIELD;
+        // Determine endpoint and headers based on folderId
+        const endpoint = folderId ? getByFolderEndpoint : getAllEndpoint;
+        const headers = folderId ? createHeaders({ [FOLDER_ID]: folderId }) : {};
+        // Make the API call based on method
+        let response;
+        if (method === HTTP_METHODS.POST) {
+            response = await serviceAccess.post(endpoint, additionalParams, { headers });
+        }
+        else {
+            response = await serviceAccess.get(endpoint, {
+                params: additionalParams,
+                headers
+            });
+        }
+        // Extract and transform items from response
+        const rawItems = response.data?.[itemsField];
+        const totalCount = response.data?.[totalCountField];
+        // Parse items - automatically handle JSON string responses
+        const parsedItems = typeof rawItems === 'string' ? JSON.parse(rawItems) : (rawItems || []);
+        const items = transformFn ? parsedItems.map(transformFn) : parsedItems;
+        return {
+            items,
+            totalCount
+        };
+    }
+    /**
+     * Centralized getAll implementation that handles both paginated and non-paginated requests
+     *
+     * @param config - Configuration for the getAll operation
+     * @param options - Request options including pagination parameters
+     * @returns Promise resolving to either paginated or non-paginated response based on options
+     */
+    static async getAll(config, options) {
+        const optionsWithDefaults = options || {};
+        const { folderId, ...restOptions } = optionsWithDefaults;
+        const cursor = options?.cursor;
+        const pageSize = options?.pageSize;
+        const jumpToPage = options?.jumpToPage;
+        // Determine if pagination is requested
+        const isPaginationRequested = PaginationHelpers.hasPaginationParameters(options || {});
+        // Process parameters (custom processing if provided, otherwise default)
+        let processedOptions = restOptions;
+        if (config.processParametersFn) {
+            processedOptions = config.processParametersFn(restOptions, folderId);
+        }
+        // Apply ODATA prefix to keys (excluding specified keys)
+        const excludeKeys = config.excludeFromPrefix || [];
+        const keysToPrefix = Object.keys(processedOptions).filter(k => !excludeKeys.includes(k));
+        const prefixedOptions = addPrefixToKeys(processedOptions, ODATA_PREFIX, keysToPrefix);
+        // Default pagination options
+        const paginationOptions = {
+            paginationType: PaginationType.OFFSET,
+            itemsField: DEFAULT_ITEMS_FIELD,
+            totalCountField: DEFAULT_TOTAL_COUNT_FIELD,
+            ...config.pagination
+        };
+        // Paginated flow
+        if (isPaginationRequested) {
+            return PaginationHelpers.getAllPaginated({
+                serviceAccess: config.serviceAccess,
+                getEndpoint: config.getEndpoint,
+                folderId,
+                paginationParams: cursor ? { cursor, pageSize } : jumpToPage ? { jumpToPage, pageSize } : { pageSize },
+                additionalParams: prefixedOptions,
+                transformFn: config.transformFn,
+                method: config.method,
+                options: {
+                    ...paginationOptions,
+                    paginationParams: config.pagination?.paginationParams
+                }
+            }); // Type assertion needed due to conditional return
+        }
+        // Non-paginated flow
+        const byFolderEndpoint = config.getByFolderEndpoint || config.getEndpoint(folderId);
+        return PaginationHelpers.getAllNonPaginated({
+            serviceAccess: config.serviceAccess,
+            getAllEndpoint: config.getEndpoint(),
+            getByFolderEndpoint: byFolderEndpoint,
+            folderId,
+            additionalParams: prefixedOptions,
+            transformFn: config.transformFn,
+            method: config.method,
+            options: {
+                itemsField: paginationOptions.itemsField,
+                totalCountField: paginationOptions.totalCountField
+            }
+        });
+    }
+}
+
+/**
+ * SDK Internals Registry - Internal registry for SDK instances
+ *
+ * This class is NOT exported in the public API.
+ * It provides a secure way to share SDK internals between
+ * the UiPath class and service classes without exposing them publicly.
+ *
+ * @internal
+ */
+// Global symbol key to ensure WeakMap is shared across module instances
+// This prevents issues when core and service modules are bundled separately
+const REGISTRY_KEY = Symbol.for('@uipath/sdk-internals-registry');
+// Get or create the global WeakMap store
+const getGlobalStore = () => {
+    const globalObj = globalThis;
+    if (!globalObj[REGISTRY_KEY]) {
+        globalObj[REGISTRY_KEY] = new WeakMap();
+    }
+    return globalObj[REGISTRY_KEY];
+};
+/**
+ * Internal registry for SDK private components.
+ * Uses WeakMap to prevent memory leaks - entries are automatically
+ * garbage collected when the SDK instance is no longer referenced.
+ *
+ * Uses a global singleton pattern to ensure the same WeakMap is shared
+ * across separately bundled modules (core, entities, tasks, etc.).
+ *
+ * @internal - Not exported in public API
+ */
+class SDKInternalsRegistry {
+    // Use global store to ensure sharing across module bundles
+    static get store() {
+        return getGlobalStore();
+    }
+    /**
+     * Register SDK instance internals
+     * Called by UiPath constructor
+     */
+    static set(instance, internals) {
+        this.store.set(instance, internals);
+    }
+    /**
+     * Retrieve SDK instance internals
+     * Called by BaseService constructor
+     */
+    static get(instance) {
+        const internals = this.store.get(instance);
+        if (!internals) {
+            throw new Error('Invalid SDK instance. Make sure to pass a valid UiPath instance to the service constructor.');
+        }
+        return internals;
+    }
+}
+
+var _BaseService_apiClient;
+/**
+ * Base class for all UiPath SDK services.
+ *
+ * Provides common functionality for authentication, configuration, and API communication.
+ * All service classes extend this base to inherit dependency injection and HTTP client access.
+ *
+ * This class implements the dependency injection pattern where services receive a configured
+ * UiPath instance. The ApiClient is created internally and handles all HTTP operations
+ * including authentication token management.
+ *
+ * @remarks
+ * Service classes should extend this base and call `super(uiPath)` in their constructor.
+ * Protected HTTP methods (get, post, put, patch, delete) are available to all subclasses.
+ *
+ */
+class BaseService {
+    /**
+     * Creates a base service instance with dependency injection.
+     *
+     * Extracts configuration, execution context, and token manager from the UiPath instance
+     * to initialize an authenticated API client. The ApiClient handles all HTTP operations
+     * and token management internally.
+     *
+     * @param instance - UiPath SDK instance providing authentication and configuration.
+     *                    Services receive this via dependency injection in the modular pattern.
+     *
+     * @example
+     * ```typescript
+     * // Services automatically call this via super()
+     * export class EntityService extends BaseService {
+     *   constructor(instance: IUiPath) {
+     *     super(instance); // Initializes the internal ApiClient
+     *   }
+     * }
+     *
+     * // Usage in modular pattern
+     * import { UiPath } from '@uipath/uipath-typescript/core';
+     * import { Entities } from '@uipath/uipath-typescript/entities';
+     *
+     * const sdk = new UiPath(config);
+     * await sdk.initialize();
+     * const entities = new Entities(sdk);
+     * ```
+     */
+    constructor(instance) {
+        // 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");
+    }
+    /**
+     * Gets a valid authentication token, refreshing if necessary.
+     * Use this when you need to manually add Authorization headers (e.g., direct uploads).
+     *
+     * @returns Promise resolving to a valid access token string
+     * @throws AuthenticationError if no token is available or refresh fails
+     */
+    async getValidAuthToken() {
+        return __classPrivateFieldGet(this, _BaseService_apiClient, "f").getValidToken();
+    }
+    /**
+     * Creates a service accessor for pagination helpers
+     * This allows pagination helpers to access protected methods without making them public
+     */
+    createPaginationServiceAccess() {
+        return {
+            get: (path, options) => this.get(path, options || {}),
+            post: (path, body, options) => this.post(path, body, options || {}),
+            requestWithPagination: (method, path, paginationOptions, options) => this.requestWithPagination(method, path, paginationOptions, options)
+        };
+    }
+    async request(method, path, options = {}) {
+        switch (method.toUpperCase()) {
+            case 'GET':
+                return this.get(path, options);
+            case 'POST':
+                return this.post(path, options.body, options);
+            case 'PUT':
+                return this.put(path, options.body, options);
+            case 'PATCH':
+                return this.patch(path, options.body, options);
+            case 'DELETE':
+                return this.delete(path, options);
+            default:
+                throw new Error(`Unsupported HTTP method: ${method}`);
+        }
+    }
+    async requestWithSpec(spec) {
+        if (!spec.method || !spec.url) {
+            throw new Error('Request spec must include method and url');
+        }
+        return this.request(spec.method, spec.url, spec);
+    }
+    async get(path, options = {}) {
+        const response = await __classPrivateFieldGet(this, _BaseService_apiClient, "f").get(path, options);
+        return { data: response };
+    }
+    async post(path, data, options = {}) {
+        const response = await __classPrivateFieldGet(this, _BaseService_apiClient, "f").post(path, data, options);
+        return { data: response };
+    }
+    async put(path, data, options = {}) {
+        const response = await __classPrivateFieldGet(this, _BaseService_apiClient, "f").put(path, data, options);
+        return { data: response };
+    }
+    async patch(path, data, options = {}) {
+        const response = await __classPrivateFieldGet(this, _BaseService_apiClient, "f").patch(path, data, options);
+        return { data: response };
+    }
+    async delete(path, options = {}) {
+        const response = await __classPrivateFieldGet(this, _BaseService_apiClient, "f").delete(path, options);
+        return { data: response };
+    }
+    /**
+     * Execute a request with cursor-based pagination
+     */
+    async requestWithPagination(method, path, paginationOptions, options) {
+        const paginationType = options.pagination.paginationType;
+        // Validate and prepare pagination parameters
+        const params = this.validateAndPreparePaginationParams(paginationType, paginationOptions);
+        // Prepare request parameters based on pagination type
+        const requestParams = this.preparePaginationRequestParams(paginationType, params, options.pagination);
+        // For POST requests, merge pagination params into body; for GET, use query params
+        if (method.toUpperCase() === 'POST') {
+            const existingBody = (options.body && typeof options.body === 'object') ? options.body : {};
+            options.body = {
+                ...existingBody,
+                ...options.params,
+                ...requestParams
+            };
+        }
+        else {
+            // Merge pagination parameters with existing parameters
+            options.params = {
+                ...options.params,
+                ...requestParams
+            };
+        }
+        // Make the request
+        const response = await this.request(method, path, options);
+        // Extract data from the response and create page result
+        return this.createPaginatedResponseFromResponse(response, params, paginationType, {
+            itemsField: options.pagination.itemsField,
+            totalCountField: options.pagination.totalCountField,
+            continuationTokenField: options.pagination.continuationTokenField
+        });
+    }
+    /**
+     * Validates and prepares pagination parameters from options
+     */
+    validateAndPreparePaginationParams(paginationType, paginationOptions) {
+        return PaginationHelpers.validatePaginationOptions(paginationOptions, paginationType);
+    }
+    /**
+     * Prepares request parameters for pagination based on pagination type
+     */
+    preparePaginationRequestParams(paginationType, params, paginationConfig) {
+        const requestParams = {};
+        let limitedPageSize;
+        const paginationParams = paginationConfig?.paginationParams;
+        switch (paginationType) {
+            case PaginationType.OFFSET:
+                limitedPageSize = getLimitedPageSize(params.pageSize);
+                const pageSizeParam = paginationParams?.pageSizeParam || ODATA_OFFSET_PARAMS.PAGE_SIZE_PARAM;
+                const offsetParam = paginationParams?.offsetParam || ODATA_OFFSET_PARAMS.OFFSET_PARAM;
+                const countParam = paginationParams?.countParam || ODATA_OFFSET_PARAMS.COUNT_PARAM;
+                requestParams[pageSizeParam] = limitedPageSize;
+                if (params.pageNumber && params.pageNumber > 1) {
+                    requestParams[offsetParam] = (params.pageNumber - 1) * limitedPageSize;
+                }
+                // Include total count for ODATA APIs
+                {
+                    requestParams[countParam] = true;
+                }
+                break;
+            case PaginationType.TOKEN:
+                const tokenPageSizeParam = paginationParams?.pageSizeParam || BUCKET_TOKEN_PARAMS.PAGE_SIZE_PARAM;
+                const tokenParam = paginationParams?.tokenParam || BUCKET_TOKEN_PARAMS.TOKEN_PARAM;
+                if (params.pageSize) {
+                    requestParams[tokenPageSizeParam] = getLimitedPageSize(params.pageSize);
+                }
+                if (params.continuationToken) {
+                    requestParams[tokenParam] = params.continuationToken;
+                }
+                break;
+        }
+        return requestParams;
+    }
+    /**
+     * Creates a paginated response from API response
+     */
+    createPaginatedResponseFromResponse(response, params, paginationType, fields) {
+        // Extract fields from response
+        const itemsField = fields.itemsField ||
+            (paginationType === PaginationType.TOKEN ? 'items' : 'value');
+        const totalCountField = fields.totalCountField || 'totalRecordCount';
+        const continuationTokenField = fields.continuationTokenField || 'continuationToken';
+        // Extract items and metadata
+        const items = response.data[itemsField] || [];
+        const totalCount = response.data[totalCountField];
+        const continuationToken = response.data[continuationTokenField];
+        // Determine if there are more pages
+        const hasMore = this.determineHasMorePages(paginationType, {
+            totalCount,
+            pageSize: params.pageSize,
+            currentPage: params.pageNumber || 1,
+            itemsCount: items.length,
+            continuationToken
+        });
+        // Create and return the page result
+        return PaginationManager.createPaginatedResponse({
+            pageInfo: {
+                hasMore,
+                totalCount,
+                currentPage: params.pageNumber,
+                pageSize: params.pageSize,
+                continuationToken
+            },
+            type: paginationType,
+        }, items);
+    }
+    /**
+     * Determines if there are more pages based on pagination type and metadata
+     */
+    determineHasMorePages(paginationType, info) {
+        switch (paginationType) {
+            case PaginationType.OFFSET:
+                const effectivePageSize = info.pageSize ?? DEFAULT_PAGE_SIZE;
+                // If totalCount is available, use it for precise calculation
+                if (info.totalCount !== undefined) {
+                    return (info.currentPage * effectivePageSize) < info.totalCount;
+                }
+                // Fallback when totalCount is not available
+                // NOTE: This code path should rarely be executed as the APIs typically return totalCount
+                return info.itemsCount === effectivePageSize;
+            case PaginationType.TOKEN:
+                return !!info.continuationToken;
+            default:
+                return false;
+        }
+    }
+}
+_BaseService_apiClient = new WeakMap();
+
+/**
+ * Creates entity methods that can be attached to entity data
+ *
+ * @param entityData - The entity metadata
+ * @param service - The entity service instance
+ * @returns Object containing entity methods
+ */
+function createEntityMethods(entityData, service) {
+    return {
+        async insertRecord(data, options) {
+            if (!entityData.id)
+                throw new Error('Entity ID is undefined');
+            return service.insertRecordById(entityData.id, data, options);
+        },
+        async insertRecords(data, options) {
+            if (!entityData.id)
+                throw new Error('Entity ID is undefined');
+            return service.insertRecordsById(entityData.id, data, options);
+        },
+        async updateRecords(data, options) {
+            if (!entityData.id)
+                throw new Error('Entity ID is undefined');
+            return service.updateRecordsById(entityData.id, data, options);
+        },
+        async deleteRecords(recordIds, options) {
+            if (!entityData.id)
+                throw new Error('Entity ID is undefined');
+            return service.deleteRecordsById(entityData.id, recordIds, options);
+        },
+        async getAllRecords(options) {
+            if (!entityData.id)
+                throw new Error('Entity ID is undefined');
+            return service.getAllRecords(entityData.id, options);
+        },
+        async getRecord(recordId, options) {
+            if (!entityData.id)
+                throw new Error('Entity ID is undefined');
+            if (!recordId)
+                throw new Error('Record ID is undefined');
+            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
+            });
+        },
+        async insert(data, options) {
+            return this.insertRecord(data, options);
+        },
+        async batchInsert(data, options) {
+            return this.insertRecords(data, options);
+        },
+        async update(data, options) {
+            return this.updateRecords(data, options);
+        },
+        async delete(recordIds, options) {
+            return this.deleteRecords(recordIds, options);
+        },
+        async getRecords(options) {
+            return this.getAllRecords(options);
+        }
+    };
+}
+/**
+ * Creates an actionable entity metadata by combining entity with operational methods
+ *
+ * @param entityData - Entity metadata
+ * @param service - The entity service instance
+ * @returns Entity metadata with added methods
+ */
+function createEntityWithMethods(entityData, service) {
+    const methods = createEntityMethods(entityData, service);
+    return Object.assign({}, entityData, methods);
+}
+
+/**
+ * API Endpoint Constants
+ * Centralized location for all API endpoints used throughout the SDK
+ */
+/**
+ * Base path constants for different services
+ */
+const DATAFABRIC_BASE = 'datafabric_';
+/**
+ * Data Fabric Service Endpoints
+ */
+const DATA_FABRIC_ENDPOINTS = {
+    ENTITY: {
+        GET_ALL: `${DATAFABRIC_BASE}/api/Entity`,
+        GET_ENTITY_RECORDS: (entityId) => `${DATAFABRIC_BASE}/api/EntityService/entity/${entityId}/read`,
+        GET_BY_ID: (entityId) => `${DATAFABRIC_BASE}/api/Entity/${entityId}`,
+        GET_RECORD_BY_ID: (entityId, recordId) => `${DATAFABRIC_BASE}/api/EntityService/entity/${entityId}/read/${recordId}`,
+        INSERT_BY_ID: (entityId) => `${DATAFABRIC_BASE}/api/EntityService/entity/${entityId}/insert`,
+        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}`,
+    },
+    CHOICESETS: {
+        GET_ALL: `${DATAFABRIC_BASE}/api/Entity/choiceset`,
+        GET_BY_ID: (choiceSetId) => `${DATAFABRIC_BASE}/api/EntityService/entity/${choiceSetId}/query_expansion`,
+    },
+};
+
+/**
+ * Creates query parameters object from key-value pairs, filtering out undefined values
+ * @param paramsObj - Object containing parameter key-value pairs
+ * @returns Parameters object with undefined values filtered out
+ *
+ * @example
+ * ```typescript
+ * // Entity service parameters
+ * const params = createParams({
+ *   start: 0,
+ *   limit: 10,
+ *   expansionLevel: 1
+ * });
+ *
+ * // With optional/undefined values (automatically filtered)
+ * const params = createParams({
+ *   start: options.start,        // Could be undefined
+ *   limit: options.limit,        // Could be undefined
+ *   expansionLevel: options.expansionLevel  // Could be undefined
+ * });
+ *
+ * // Empty params
+ * const params = createParams();
+ * ```
+ */
+function createParams(paramsObj = {}) {
+    const params = {};
+    for (const [key, value] of Object.entries(paramsObj)) {
+        if (value !== undefined && value !== null) {
+            params[key] = value;
+        }
+    }
+    return params;
+}
+
+/**
+ * Entity field type names
+ */
+exports.EntityFieldDataType = void 0;
+(function (EntityFieldDataType) {
+    EntityFieldDataType["UUID"] = "UUID";
+    EntityFieldDataType["STRING"] = "STRING";
+    EntityFieldDataType["INTEGER"] = "INTEGER";
+    EntityFieldDataType["DATETIME"] = "DATETIME";
+    EntityFieldDataType["DATETIME_WITH_TZ"] = "DATETIME_WITH_TZ";
+    EntityFieldDataType["DECIMAL"] = "DECIMAL";
+    EntityFieldDataType["FLOAT"] = "FLOAT";
+    EntityFieldDataType["DOUBLE"] = "DOUBLE";
+    EntityFieldDataType["DATE"] = "DATE";
+    EntityFieldDataType["BOOLEAN"] = "BOOLEAN";
+    EntityFieldDataType["BIG_INTEGER"] = "BIG_INTEGER";
+    EntityFieldDataType["MULTILINE_TEXT"] = "MULTILINE_TEXT";
+})(exports.EntityFieldDataType || (exports.EntityFieldDataType = {}));
+/**
+ * Entity type enum
+ */
+exports.EntityType = void 0;
+(function (EntityType) {
+    EntityType["Entity"] = "Entity";
+    EntityType["ChoiceSet"] = "ChoiceSet";
+    EntityType["InternalEntity"] = "InternalEntity";
+    EntityType["SystemEntity"] = "SystemEntity";
+})(exports.EntityType || (exports.EntityType = {}));
+/**
+ * Reference types for fields
+ */
+exports.ReferenceType = void 0;
+(function (ReferenceType) {
+    ReferenceType["ManyToOne"] = "ManyToOne";
+})(exports.ReferenceType || (exports.ReferenceType = {}));
+/**
+ * Field display types
+ */
+exports.FieldDisplayType = void 0;
+(function (FieldDisplayType) {
+    FieldDisplayType["Basic"] = "Basic";
+    FieldDisplayType["Relationship"] = "Relationship";
+    FieldDisplayType["File"] = "File";
+    FieldDisplayType["ChoiceSetSingle"] = "ChoiceSetSingle";
+    FieldDisplayType["ChoiceSetMultiple"] = "ChoiceSetMultiple";
+    FieldDisplayType["AutoNumber"] = "AutoNumber";
+})(exports.FieldDisplayType || (exports.FieldDisplayType = {}));
+/**
+ * Data direction type for external fields
+ */
+exports.DataDirectionType = void 0;
+(function (DataDirectionType) {
+    DataDirectionType["ReadOnly"] = "ReadOnly";
+    DataDirectionType["ReadAndWrite"] = "ReadAndWrite";
+})(exports.DataDirectionType || (exports.DataDirectionType = {}));
+/**
+ * Join type for source join criteria
+ */
+exports.JoinType = void 0;
+(function (JoinType) {
+    JoinType["LeftJoin"] = "LeftJoin";
+})(exports.JoinType || (exports.JoinType = {}));
+
+/**
+ * Entity field data types (SQL types from API)
+ */
+var SqlFieldType;
+(function (SqlFieldType) {
+    SqlFieldType["UNIQUEIDENTIFIER"] = "UNIQUEIDENTIFIER";
+    SqlFieldType["NVARCHAR"] = "NVARCHAR";
+    SqlFieldType["INT"] = "INT";
+    SqlFieldType["DATETIME2"] = "DATETIME2";
+    SqlFieldType["DATETIMEOFFSET"] = "DATETIMEOFFSET";
+    SqlFieldType["FLOAT"] = "FLOAT";
+    SqlFieldType["REAL"] = "REAL";
+    SqlFieldType["BIGINT"] = "BIGINT";
+    SqlFieldType["DATE"] = "DATE";
+    SqlFieldType["BIT"] = "BIT";
+    SqlFieldType["DECIMAL"] = "DECIMAL";
+    SqlFieldType["MULTILINE"] = "MULTILINE";
+})(SqlFieldType || (SqlFieldType = {}));
+/**
+ * Maps fields for Entities
+ */
+const EntityMap = {
+    createTime: 'createdTime',
+    updateTime: 'updatedTime',
+    sqlType: 'fieldDataType',
+    fieldDefinition: 'fieldMetaData'
+};
+/**
+ * Maps SQL field types to friendly display names
+ */
+const EntityFieldTypeMap = {
+    [SqlFieldType.UNIQUEIDENTIFIER]: exports.EntityFieldDataType.UUID,
+    [SqlFieldType.NVARCHAR]: exports.EntityFieldDataType.STRING,
+    [SqlFieldType.INT]: exports.EntityFieldDataType.INTEGER,
+    [SqlFieldType.DATETIME2]: exports.EntityFieldDataType.DATETIME,
+    [SqlFieldType.DATETIMEOFFSET]: exports.EntityFieldDataType.DATETIME_WITH_TZ,
+    [SqlFieldType.FLOAT]: exports.EntityFieldDataType.FLOAT,
+    [SqlFieldType.REAL]: exports.EntityFieldDataType.DOUBLE,
+    [SqlFieldType.BIGINT]: exports.EntityFieldDataType.BIG_INTEGER,
+    [SqlFieldType.DATE]: exports.EntityFieldDataType.DATE,
+    [SqlFieldType.BIT]: exports.EntityFieldDataType.BOOLEAN,
+    [SqlFieldType.DECIMAL]: exports.EntityFieldDataType.DECIMAL,
+    [SqlFieldType.MULTILINE]: exports.EntityFieldDataType.MULTILINE_TEXT
+};
+
+/**
+ * SDK Telemetry constants
+ */
+// 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.0.0";
+const VERSION = "Version";
+const SERVICE = "Service";
+const CLOUD_ORGANIZATION_NAME = "CloudOrganizationName";
+const CLOUD_TENANT_NAME = "CloudTenantName";
+const CLOUD_URL = "CloudUrl";
+const CLOUD_CLIENT_ID = "CloudClientId";
+const CLOUD_REDIRECT_URI = "CloudRedirectUri";
+const APP_NAME = "ApplicationName";
+const CLOUD_ROLE_NAME = "uipath-ts-sdk";
+// Service and logger names
+const SDK_SERVICE_NAME = "UiPath.TypeScript.Sdk";
+const SDK_LOGGER_NAME = "uipath-ts-sdk-telemetry";
+// Event names
+const SDK_RUN_EVENT = "Sdk.Run";
+// Default value for unknown/empty attributes
+const UNKNOWN = "";
+
+/**
+ * Log exporter that sends ALL logs as Application Insights custom events
+ */
+class ApplicationInsightsEventExporter {
+    constructor(connectionString) {
+        this.connectionString = connectionString;
+    }
+    export(logs, resultCallback) {
+        try {
+            logs.forEach(logRecord => {
+                this.sendAsCustomEvent(logRecord);
+            });
+            resultCallback({ code: 0 });
+        }
+        catch (error) {
+            console.debug('Failed to export logs to Application Insights:', error);
+            resultCallback({ code: 2, error });
+        }
+    }
+    shutdown() {
+        return Promise.resolve();
+    }
+    sendAsCustomEvent(logRecord) {
+        // Get event name from body or attributes
+        const eventName = logRecord.body || SDK_RUN_EVENT;
+        const payload = {
+            name: 'Microsoft.ApplicationInsights.Event',
+            time: new Date().toISOString(),
+            iKey: this.extractInstrumentationKey(),
+            data: {
+                baseType: 'EventData',
+                baseData: {
+                    ver: 2,
+                    name: eventName,
+                    properties: this.convertAttributesToProperties(logRecord.attributes || {})
+                }
+            },
+            tags: {
+                'ai.cloud.role': CLOUD_ROLE_NAME,
+                'ai.cloud.roleInstance': SDK_VERSION
+            }
+        };
+        this.sendToApplicationInsights(payload);
+    }
+    extractInstrumentationKey() {
+        const match = this.connectionString.match(/InstrumentationKey=([^;]+)/);
+        return match ? match[1] : '';
+    }
+    convertAttributesToProperties(attributes) {
+        const properties = {};
+        Object.entries(attributes || {}).forEach(([key, value]) => {
+            properties[key] = String(value);
+        });
+        return properties;
+    }
+    async sendToApplicationInsights(payload) {
+        try {
+            const ingestionEndpoint = this.extractIngestionEndpoint();
+            if (!ingestionEndpoint) {
+                console.debug('No ingestion endpoint found in connection string');
+                return;
+            }
+            const url = `${ingestionEndpoint}/v2/track`;
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(payload)
+            });
+            if (!response.ok) {
+                console.debug(`Failed to send event telemetry: ${response.status} ${response.statusText}`);
+            }
+        }
+        catch (error) {
+            console.debug('Error sending event telemetry to Application Insights:', error);
+        }
+    }
+    extractIngestionEndpoint() {
+        const match = this.connectionString.match(/IngestionEndpoint=([^;]+)/);
+        return match ? match[1] : '';
+    }
+}
+/**
+ * Singleton telemetry client
+ */
+class TelemetryClient {
+    constructor() {
+        this.isInitialized = false;
+    }
+    static getInstance() {
+        if (!TelemetryClient.instance) {
+            TelemetryClient.instance = new TelemetryClient();
+        }
+        return TelemetryClient.instance;
+    }
+    /**
+     * Initialize telemetry
+     */
+    initialize(config) {
+        if (this.isInitialized) {
+            return;
+        }
+        this.isInitialized = true;
+        if (config) {
+            this.telemetryContext = config;
+        }
+        try {
+            const connectionString = this.getConnectionString();
+            if (!connectionString) {
+                return;
+            }
+            this.setupTelemetryProvider(connectionString);
+        }
+        catch (error) {
+            // Silent failure - telemetry errors shouldn't break functionality
+            console.debug('Failed to initialize OpenTelemetry:', error);
+        }
+    }
+    getConnectionString() {
+        const connectionString = CONNECTION_STRING;
+        return connectionString;
+    }
+    setupTelemetryProvider(connectionString) {
+        const exporter = new ApplicationInsightsEventExporter(connectionString);
+        const processor = new sdkLogs.BatchLogRecordProcessor(exporter);
+        this.logProvider = new sdkLogs.LoggerProvider({
+            processors: [processor]
+        });
+        this.logger = this.logProvider.getLogger(SDK_LOGGER_NAME);
+    }
+    /**
+     * Track a telemetry event
+     */
+    track(eventName, name, extraAttributes = {}) {
+        try {
+            // Skip if logger not initialized
+            if (!this.logger) {
+                return;
+            }
+            const finalDisplayName = name || eventName;
+            const attributes = this.getEnrichedAttributes(extraAttributes, eventName);
+            // Emit as log 
+            this.logger.emit({
+                body: finalDisplayName,
+                attributes: attributes,
+                timestamp: Date.now(),
+            });
+        }
+        catch (error) {
+            // Silent failure
+            console.debug('Failed to track telemetry event:', error);
+        }
+    }
+    /**
+     * Get enriched attributes for telemetry events
+     */
+    getEnrichedAttributes(extraAttributes, eventName) {
+        const attributes = {
+            ...extraAttributes,
+            [APP_NAME]: SDK_SERVICE_NAME,
+            [VERSION]: SDK_VERSION,
+            [SERVICE]: eventName,
+            [CLOUD_URL]: this.createCloudUrl(),
+            [CLOUD_ORGANIZATION_NAME]: this.telemetryContext?.orgName || UNKNOWN,
+            [CLOUD_TENANT_NAME]: this.telemetryContext?.tenantName || UNKNOWN,
+            [CLOUD_REDIRECT_URI]: this.telemetryContext?.redirectUri || UNKNOWN,
+            [CLOUD_CLIENT_ID]: this.telemetryContext?.clientId || UNKNOWN,
+        };
+        return attributes;
+    }
+    /**
+     * Create cloud URL from base URL, organization ID, and tenant ID
+     */
+    createCloudUrl() {
+        const baseUrl = this.telemetryContext?.baseUrl;
+        const orgId = this.telemetryContext?.orgName;
+        const tenantId = this.telemetryContext?.tenantName;
+        if (!baseUrl || !orgId || !tenantId) {
+            return UNKNOWN;
+        }
+        return `${baseUrl}/${orgId}/${tenantId}`;
+    }
+}
+// Export singleton instance
+const telemetryClient = TelemetryClient.getInstance();
+
+/**
+ * SDK Track decorator and function for telemetry
+ */
+/**
+ * Common tracking logic shared between method and function decorators
+ */
+function createTrackedFunction(originalFunction, nameOrOptions, fallbackName, opts) {
+    return function (...args) {
+        // Determine if we should track this call
+        let shouldTrack = true;
+        if (opts.condition !== undefined) {
+            if (typeof opts.condition === 'function') {
+                shouldTrack = opts.condition.apply(this, args);
+            }
+            else {
+                shouldTrack = opts.condition;
+            }
+        }
+        // Track the event if enabled
+        if (shouldTrack) {
+            // Use the full name provided in the decorator (e.g., "Queue.GetAll")
+            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);
+        }
+        // Execute the original function
+        return originalFunction.apply(this, args);
+    };
+}
+/**
+ * Track decorator that can be used to automatically track function calls
+ *
+ * Usage:
+ * @track("Service.Method")
+ * function myFunction() { ... }
+ *
+ * @track("Queue.GetAll")
+ * async getAll() { ... }
+ *
+ * @track("Tasks.Create")
+ * async create() { ... }
+ *
+ * @track("Assets.Update", { condition: false })
+ * function myFunction() { ... }
+ *
+ * @track("Processes.Start", { attributes: { customProp: "value" } })
+ * function myFunction() { ... }
+ */
+function track(nameOrOptions, options) {
+    return function decorator(_target, propertyKey, descriptor) {
+        const opts = typeof nameOrOptions === 'object' ? nameOrOptions : {};
+        if (descriptor && typeof descriptor.value === 'function') {
+            // Method decorator
+            descriptor.value = createTrackedFunction(descriptor.value, nameOrOptions, propertyKey || 'unknown_method', opts);
+            return descriptor;
+        }
+        // Function decorator
+        return (originalFunction) => createTrackedFunction(originalFunction, nameOrOptions, originalFunction.name || 'unknown_function', opts);
+    };
+}
+
+/**
+ * Service for interacting with the Data Fabric Entity API
+ */
+class EntityService extends BaseService {
+    /**
+     * Gets entity metadata by entity ID with attached operation methods
+     *
+     * @param id - UUID of the entity
+     * @returns Promise resolving to entity metadata with schema information and operation methods
+     *
+     * @example
+     * ```typescript
+     * import { Entities } from '@uipath/uipath-typescript/entities';
+     *
+     * const entities = new Entities(sdk);
+     * const entity = await entities.getById("<entityId>");
+     *
+     * // Call operations directly on the entity
+     * const records = await entity.getAllRecords();
+     *
+     * // Insert a single record
+     * const insertResult = await entity.insertRecord({ name: "John", age: 30 });
+     *
+     * // Or batch insert multiple records
+     * const batchResult = await entity.insertRecords([
+     *     { name: "Jane", age: 25 },
+     *     { name: "Bob", age: 35 }
+     * ]);
+     * ```
+     */
+    async getById(id) {
+        // Get entity metadata
+        const response = await this.get(DATA_FABRIC_ENDPOINTS.ENTITY.GET_BY_ID(id));
+        // Apply EntityMap transformations
+        const metadata = transformData(response.data, EntityMap);
+        // Transform metadata with field mappers
+        this.applyFieldMappings(metadata);
+        // Return the entity metadata with methods attached
+        return createEntityWithMethods(metadata, this);
+    }
+    /**
+     * Gets entity records by entity ID
+     *
+     * @param entityId - UUID of the entity
+     * @param options - Query options including expansionLevel and pagination options
+     * @returns Promise resolving to an array of entity records or paginated response
+     *
+     * @example
+     * ```typescript
+     * import { Entities } from '@uipath/uipath-typescript/entities';
+     *
+     * const entities = new Entities(sdk);
+     *
+     * // Basic usage (non-paginated)
+     * const records = await entities.getAllRecords("<entityId>");
+     *
+     * // With expansion level
+     * const records = await entities.getAllRecords("<entityId>", {
+     *   expansionLevel: 1
+     * });
+     *
+     * // With pagination
+     * const paginatedResponse = await entities.getAllRecords("<entityId>", {
+     *   pageSize: 50,
+     *   expansionLevel: 1
+     * });
+     *
+     * // Navigate to next page
+     * const nextPage = await entities.getAllRecords("<entityId>", {
+     *   cursor: paginatedResponse.nextCursor,
+     *   expansionLevel: 1
+     * });
+     * ```
+     */
+    async getAllRecords(entityId, options) {
+        return PaginationHelpers.getAll({
+            serviceAccess: this.createPaginationServiceAccess(),
+            getEndpoint: () => DATA_FABRIC_ENDPOINTS.ENTITY.GET_ENTITY_RECORDS(entityId),
+            pagination: {
+                paginationType: PaginationType.OFFSET,
+                itemsField: ENTITY_PAGINATION.ITEMS_FIELD,
+                totalCountField: ENTITY_PAGINATION.TOTAL_COUNT_FIELD,
+                paginationParams: {
+                    pageSizeParam: ENTITY_OFFSET_PARAMS.PAGE_SIZE_PARAM,
+                    offsetParam: ENTITY_OFFSET_PARAMS.OFFSET_PARAM,
+                    countParam: ENTITY_OFFSET_PARAMS.COUNT_PARAM
+                }
+            },
+            excludeFromPrefix: ['expansionLevel'] // Don't add ODATA prefix to expansionLevel
+        }, options);
+    }
+    /**
+     * Gets a single entity record by entity ID and record ID
+     *
+     * @param entityId - UUID of the entity
+     * @param recordId - UUID of the record
+     * @param options - Query options including expansionLevel
+     * @returns Promise resolving to the entity record
+     *
+     * @example
+     * ```typescript
+     * // Basic usage
+     * const record = await sdk.entities.getRecordById(<entityId>, <recordId>);
+     *
+     * // With expansion level
+     * const record = await sdk.entities.getRecordById(<entityId>, <recordId>, {
+     *   expansionLevel: 1
+     * });
+     * ```
+     */
+    async getRecordById(entityId, recordId, options = {}) {
+        const params = createParams({
+            expansionLevel: options.expansionLevel
+        });
+        const response = await this.get(DATA_FABRIC_ENDPOINTS.ENTITY.GET_RECORD_BY_ID(entityId, recordId), { params });
+        // Convert PascalCase response to camelCase
+        const camelResponse = pascalToCamelCaseKeys(response.data);
+        // Apply EntityMap transformations
+        const transformedResponse = transformData(camelResponse, EntityMap);
+        return transformedResponse;
+    }
+    /**
+     * Inserts a single record into an entity by entity ID
+     *
+     * @param entityId - UUID of the entity
+     * @param data - Record to insert
+     * @param options - Insert options
+     * @returns Promise resolving to the inserted record with generated record ID
+     *
+     * @example
+     * ```typescript
+     * import { Entities } from '@uipath/uipath-typescript/entities';
+     *
+     * const entities = new Entities(sdk);
+     *
+     * // Basic usage
+     * const result = await entities.insertRecordById("<entityId>", { name: "John", age: 30 });
+     *
+     * // With options
+     * const result = await entities.insertRecordById("<entityId>", { name: "John", age: 30 }, {
+     *   expansionLevel: 1
+     * });
+     * ```
+     */
+    async insertRecordById(id, data, options = {}) {
+        const params = createParams({
+            expansionLevel: options.expansionLevel
+        });
+        const response = await this.post(DATA_FABRIC_ENDPOINTS.ENTITY.INSERT_BY_ID(id), data, {
+            params,
+            ...options
+        });
+        // Convert PascalCase response to camelCase
+        const camelResponse = pascalToCamelCaseKeys(response.data);
+        return camelResponse;
+    }
+    /**
+     * Inserts data into an entity by entity ID using batch insert
+     *
+     * @param entityId - UUID of the entity
+     * @param data - Array of records to insert
+     * @param options - Insert options
+     * @returns Promise resolving to insert response
+     *
+     * @example
+     * ```typescript
+     * import { Entities } from '@uipath/uipath-typescript/entities';
+     *
+     * const entities = new Entities(sdk);
+     *
+     * // Basic usage
+     * const result = await entities.insertRecordsById("<entityId>", [
+     *   { name: "John", age: 30 },
+     *   { name: "Jane", age: 25 }
+     * ]);
+     *
+     * // With options
+     * const result = await entities.insertRecordsById("<entityId>", [
+     *   { name: "John", age: 30 },
+     *   { name: "Jane", age: 25 }
+     * ], {
+     *   expansionLevel: 1,
+     *   failOnFirst: true
+     * });
+     * ```
+     */
+    async insertRecordsById(id, data, options = {}) {
+        const params = createParams({
+            expansionLevel: options.expansionLevel,
+            failOnFirst: options.failOnFirst
+        });
+        const response = await this.post(DATA_FABRIC_ENDPOINTS.ENTITY.BATCH_INSERT_BY_ID(id), data, {
+            params,
+            ...options
+        });
+        // Convert PascalCase response to camelCase
+        const camelResponse = pascalToCamelCaseKeys(response.data);
+        return camelResponse;
+    }
+    /**
+     * Updates data in an entity by entity ID
+     *
+     * @param entityId - UUID of the entity
+     * @param data - Array of records to update. Each record MUST contain the record Id,
+     *               otherwise the update will fail.
+     * @param options - Update options
+     * @returns Promise resolving to update response
+     *
+     * @example
+     * ```typescript
+     * import { Entities } from '@uipath/uipath-typescript/entities';
+     *
+     * const entities = new Entities(sdk);
+     *
+     * // Basic usage
+     * const result = await entities.updateRecordsById("<entityId>", [
+     *   { Id: "123", name: "John Updated", age: 31 },
+     *   { Id: "456", name: "Jane Updated", age: 26 }
+     * ]);
+     *
+     * // With options
+     * const result = await entities.updateRecordsById("<entityId>", [
+     *   { Id: "123", name: "John Updated", age: 31 },
+     *   { Id: "456", name: "Jane Updated", age: 26 }
+     * ], {
+     *   expansionLevel: 1,
+     *   failOnFirst: true
+     * });
+     * ```
+     */
+    async updateRecordsById(id, data, options = {}) {
+        const params = createParams({
+            expansionLevel: options.expansionLevel,
+            failOnFirst: options.failOnFirst
+        });
+        const response = await this.post(DATA_FABRIC_ENDPOINTS.ENTITY.UPDATE_BY_ID(id), data, {
+            params,
+            ...options
+        });
+        // Convert PascalCase response to camelCase
+        const camelResponse = pascalToCamelCaseKeys(response.data);
+        return camelResponse;
+    }
+    /**
+     * Deletes data from an entity by entity ID
+     *
+     * @param entityId - UUID of the entity
+     * @param recordIds - Array of record UUIDs to delete
+     * @param options - Delete options
+     * @returns Promise resolving to delete response
+     *
+     * @example
+     * ```typescript
+     * import { Entities } from '@uipath/uipath-typescript/entities';
+     *
+     * const entities = new Entities(sdk);
+     *
+     * // Basic usage
+     * const result = await entities.deleteRecordsById("<entityId>", [
+     *   "<recordId-1>", "<recordId-2>"
+     * ]);
+     * ```
+     */
+    async deleteRecordsById(id, recordIds, options = {}) {
+        const params = createParams({
+            failOnFirst: options.failOnFirst
+        });
+        const response = await this.post(DATA_FABRIC_ENDPOINTS.ENTITY.DELETE_BY_ID(id), recordIds, {
+            params,
+            ...options
+        });
+        // Convert PascalCase response to camelCase
+        const camelResponse = pascalToCamelCaseKeys(response.data);
+        return camelResponse;
+    }
+    /**
+     * Gets all entities in the system
+     *
+     * @returns Promise resolving to an array of entity metadata
+     *
+     * @example
+     * ```typescript
+     * import { Entities } from '@uipath/uipath-typescript/entities';
+     *
+     * const entities = new Entities(sdk);
+     *
+     * // Get all entities
+     * const allEntities = await entities.getAll();
+     *
+     * // Call operations on an entity
+     * const records = await allEntities[0].getAllRecords();
+     * ```
+     */
+    async getAll() {
+        const response = await this.get(DATA_FABRIC_ENDPOINTS.ENTITY.GET_ALL);
+        // Apply transformations
+        const entities = response.data.map(entity => {
+            // Transform each entity
+            const metadata = transformData(entity, EntityMap);
+            this.applyFieldMappings(metadata);
+            // Attach entity methods
+            return createEntityWithMethods(metadata, this);
+        });
+        return entities;
+    }
+    /**
+     * Downloads an attachment from an entity record field
+     *
+     * @param options - Options containing entityName, recordId, and fieldName
+     * @returns Promise resolving to Blob containing the file content
+     *
+     * @example
+     * ```typescript
+     * import { Entities } from '@uipath/uipath-typescript/entities';
+     *
+     * const entities = new Entities(sdk);
+     *
+     * // Download attachment for a specific record and field
+     * const blob = await entities.downloadAttachment({
+     *   entityName: 'Invoice',
+     *   recordId: '<record-uuid>',
+     *   fieldName: 'Documents'
+     * });
+     */
+    async downloadAttachment(options) {
+        const { entityName, recordId, fieldName } = options;
+        const response = await this.get(DATA_FABRIC_ENDPOINTS.ENTITY.DOWNLOAD_ATTACHMENT(entityName, recordId, fieldName), {
+            responseType: RESPONSE_TYPES.BLOB
+        });
+        return response.data;
+    }
+    /**
+   * @hidden
+   * @deprecated Use {@link getAllRecords} instead.
+   */
+    async getRecordsById(entityId, options) {
+        return this.getAllRecords(entityId, options);
+    }
+    /**
+     * @hidden
+     * @deprecated Use {@link insertRecordById} instead.
+     */
+    async insertById(id, data, options = {}) {
+        return this.insertRecordById(id, data, options);
+    }
+    /**
+     * @hidden
+     * @deprecated Use {@link insertRecordsById} instead.
+     */
+    async batchInsertById(id, data, options = {}) {
+        return this.insertRecordsById(id, data, options);
+    }
+    /**
+     * @hidden
+     * @deprecated Use {@link updateRecordsById} instead.
+     */
+    async updateById(id, data, options = {}) {
+        return this.updateRecordsById(id, data, options);
+    }
+    /**
+     * @hidden
+     * @deprecated Use {@link deleteRecordsById} instead.
+     */
+    async deleteById(id, recordIds, options = {}) {
+        return this.deleteRecordsById(id, recordIds, options);
+    }
+    /**
+     * Orchestrates all field mapping transformations
+     *
+     * @param metadata - Entity metadata to transform
+     * @private
+     */
+    applyFieldMappings(metadata) {
+        this.mapFieldTypes(metadata);
+        this.mapExternalFields(metadata);
+    }
+    /**
+     * Maps SQL field types to friendly EntityFieldTypes
+     *
+     * @param metadata - Entity metadata with fields
+     * @private
+     */
+    mapFieldTypes(metadata) {
+        if (!metadata.fields?.length)
+            return;
+        metadata.fields = metadata.fields.map(field => {
+            // Rename sqlType to fieldDataType
+            let transformedField = transformData(field, EntityMap);
+            // Map SQL field type to friendly name
+            if (transformedField.fieldDataType?.name) {
+                const sqlTypeName = transformedField.fieldDataType.name;
+                if (EntityFieldTypeMap[sqlTypeName]) {
+                    transformedField.fieldDataType.name = EntityFieldTypeMap[sqlTypeName];
+                }
+            }
+            this.transformNestedReferences(transformedField);
+            return transformedField;
+        });
+    }
+    /**
+     * Transforms nested reference objects in field metadata
+     */
+    transformNestedReferences(field) {
+        if (field.referenceEntity) {
+            field.referenceEntity = transformData(field.referenceEntity, EntityMap);
+        }
+        if (field.referenceChoiceSet) {
+            field.referenceChoiceSet = transformData(field.referenceChoiceSet, EntityMap);
+        }
+        if (field.referenceField?.definition) {
+            field.referenceField.definition = transformData(field.referenceField.definition, EntityMap);
+        }
+    }
+    /**
+     * Maps external field names to consistent naming
+     *
+     * @param metadata - Entity metadata with externalFields
+     * @private
+     */
+    mapExternalFields(metadata) {
+        if (!metadata.externalFields?.length)
+            return;
+        metadata.externalFields = metadata.externalFields.map(externalSource => {
+            if (externalSource.fields?.length) {
+                externalSource.fields = externalSource.fields.map(field => {
+                    const transformedField = transformData(field, EntityMap);
+                    if (transformedField.fieldMetaData) {
+                        transformedField.fieldMetaData = transformData(transformedField.fieldMetaData, EntityMap);
+                        this.transformNestedReferences(transformedField.fieldMetaData);
+                    }
+                    return transformedField;
+                });
+            }
+            return externalSource;
+        });
+    }
+}
+__decorate([
+    track('Entities.GetById')
+], EntityService.prototype, "getById", null);
+__decorate([
+    track('Entities.GetAllRecords')
+], EntityService.prototype, "getAllRecords", null);
+__decorate([
+    track('Entities.GetRecordById')
+], EntityService.prototype, "getRecordById", null);
+__decorate([
+    track('Entities.InsertRecordById')
+], EntityService.prototype, "insertRecordById", null);
+__decorate([
+    track('Entities.InsertRecordsById')
+], EntityService.prototype, "insertRecordsById", null);
+__decorate([
+    track('Entities.UpdateRecordsById')
+], EntityService.prototype, "updateRecordsById", null);
+__decorate([
+    track('Entities.DeleteRecordsById')
+], EntityService.prototype, "deleteRecordsById", null);
+__decorate([
+    track('Entities.GetAll')
+], EntityService.prototype, "getAll", null);
+__decorate([
+    track('Entities.DownloadAttachment')
+], EntityService.prototype, "downloadAttachment", null);
+
+class ChoiceSetService extends BaseService {
+    /**
+     * Gets all choice sets in the system
+     *
+     * @returns Promise resolving to an array of choice set metadata
+     *
+     * @example
+     * ```typescript
+     * import { ChoiceSets } from '@uipath/uipath-typescript/entities';
+     *
+     * const choiceSets = new ChoiceSets(sdk);
+     *
+     * // Get all choice sets
+     * const allChoiceSets = await choiceSets.getAll();
+     *
+     * // Iterate through choice sets
+     * allChoiceSets.forEach(choiceSet => {
+     *   console.log(`ChoiceSet: ${choiceSet.displayName} (${choiceSet.name})`);
+     *   console.log(`Description: ${choiceSet.description}`);
+     * });
+     * ```
+     */
+    async getAll() {
+        const rawResponse = await this.get(DATA_FABRIC_ENDPOINTS.CHOICESETS.GET_ALL);
+        // Transform field names
+        const data = rawResponse.data || [];
+        return data.map(choiceSet => transformData(choiceSet, EntityMap));
+    }
+    /**
+     * Gets choice set values by choice set ID with optional 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 choiceSetId - UUID of the choice set
+     * @param options - Pagination options
+     * @returns Promise resolving to choice set values or paginated result
+     *
+     * @example
+     * ```typescript
+     * import { ChoiceSets } from '@uipath/uipath-typescript/choicesets';
+     *
+     * const choiceSets = new ChoiceSets(sdk);
+     *
+     * // First, get the choice set ID using getAll()
+     * const allChoiceSets = await choiceSets.getAll();
+     * const expenseTypes = allChoiceSets.find(cs => cs.name === 'ExpenseTypes');
+     * const choiceSetId = expenseTypes.id;
+     *
+     * // Get all values (non-paginated)
+     * const values = await choiceSets.getById(choiceSetId);
+     *
+     * // Iterate through choice set values
+     * for (const value of values.items) {
+     *   console.log(`Value: ${value.displayName} (${value.name})`);
+     * }
+     *
+     * // First page with pagination
+     * const page1 = await choiceSets.getById(choiceSetId, { pageSize: 10 });
+     *
+     * // Navigate using cursor
+     * if (page1.hasNextPage) {
+     *   const page2 = await choiceSets.getById(choiceSetId, { cursor: page1.nextCursor });
+     * }
+     * ```
+     */
+    async getById(choiceSetId, options) {
+        // Transform a single item from PascalCase to camelCase
+        const transformFn = (item) => {
+            const camelCased = pascalToCamelCaseKeys(item);
+            return transformData(camelCased, EntityMap);
+        };
+        return PaginationHelpers.getAll({
+            serviceAccess: this.createPaginationServiceAccess(),
+            getEndpoint: () => DATA_FABRIC_ENDPOINTS.CHOICESETS.GET_BY_ID(choiceSetId),
+            transformFn,
+            method: HTTP_METHODS.POST,
+            pagination: {
+                paginationType: PaginationType.OFFSET,
+                itemsField: CHOICESET_VALUES_PAGINATION.ITEMS_FIELD,
+                totalCountField: CHOICESET_VALUES_PAGINATION.TOTAL_COUNT_FIELD,
+                paginationParams: {
+                    pageSizeParam: ENTITY_OFFSET_PARAMS.PAGE_SIZE_PARAM,
+                    offsetParam: ENTITY_OFFSET_PARAMS.OFFSET_PARAM,
+                    countParam: ENTITY_OFFSET_PARAMS.COUNT_PARAM
+                }
+            }
+        }, options);
+    }
+}
+__decorate([
+    track('Choicesets.GetAll')
+], ChoiceSetService.prototype, "getAll", null);
+__decorate([
+    track('Choicesets.GetById')
+], ChoiceSetService.prototype, "getById", null);
+
+exports.ChoiceSetService = ChoiceSetService;
+exports.ChoiceSets = ChoiceSetService;
+exports.Entities = EntityService;
+exports.EntityService = EntityService;
+exports.createEntityWithMethods = createEntityWithMethods;