@uipath/uipath-typescript 1.3.6 → 1.3.8

package/dist/core/index.mjs

@@ -5305,7 +5305,7 @@ function normalizeBaseUrl(url) {
 // 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.3.6";
+const SDK_VERSION = "1.3.8";
 const VERSION = "Version";
 const SERVICE = "Service";
 const CLOUD_ORGANIZATION_NAME = "CloudOrganizationName";
@@ -5652,6 +5652,8 @@ var UiPathMetaTags;
     // Asset resolution and routing
     UiPathMetaTags["CDN_BASE"] = "uipath:cdn-base";
     UiPathMetaTags["APP_BASE"] = "uipath:app-base";
+    // Folder context (injected during coded-app deployment)
+    UiPathMetaTags["FOLDER_KEY"] = "uipath:folder-key";
 })(UiPathMetaTags || (UiPathMetaTags = {}));
 
 /**
@@ -5680,12 +5682,13 @@ function loadFromMetaTags() {
         tenantName: getMetaTagContent(UiPathMetaTags.TENANT_NAME),
         baseUrl: getMetaTagContent(UiPathMetaTags.BASE_URL),
         redirectUri: getMetaTagContent(UiPathMetaTags.REDIRECT_URI),
+        folderKey: getMetaTagContent(UiPathMetaTags.FOLDER_KEY),
     };
     const hasAnyValue = Object.values(config).some(Boolean);
     return hasAnyValue ? config : null;
 }
 
-var _UiPath_instances, _UiPath_config, _UiPath_authService, _UiPath_initialized, _UiPath_partialConfig, _UiPath_multiLogin, _UiPath_initializeWithConfig, _UiPath_loadConfig;
+var _UiPath_instances, _UiPath_config, _UiPath_authService, _UiPath_initialized, _UiPath_partialConfig, _UiPath_multiLogin, _UiPath_metaFolderKey, _UiPath_initializeWithConfig, _UiPath_loadConfig;
 /**
  * UiPath - Core SDK class for authentication and configuration management.
  *
@@ -5726,8 +5729,13 @@ class UiPath {
         _UiPath_initialized.set(this, false);
         _UiPath_partialConfig.set(this, void 0);
         _UiPath_multiLogin.set(this, false);
+        // Folder key sourced only from `<meta name="uipath:folder-key">` (coded-app
+        // deployments). Not accepted via the public constructor; lives here so the
+        // SDK can flow it through to BaseService.config without polluting BaseConfig.
+        _UiPath_metaFolderKey.set(this, void 0);
         // Load configuration from meta tags
         const configFromMetaTags = loadFromMetaTags();
+        __classPrivateFieldSet(this, _UiPath_metaFolderKey, configFromMetaTags?.folderKey, "f");
         // Merge configuration: constructor config overrides meta tags
         const mergedConfig = config ? { ...configFromMetaTags, ...config } : configFromMetaTags;
         if (mergedConfig && isCompleteConfig(mergedConfig)) {
@@ -5856,7 +5864,7 @@ class UiPath {
         __classPrivateFieldGet(this, _UiPath_authService, "f")?.updateToken(tokenInfo);
     }
 }
-_UiPath_config = new WeakMap(), _UiPath_authService = new WeakMap(), _UiPath_initialized = new WeakMap(), _UiPath_partialConfig = new WeakMap(), _UiPath_multiLogin = new WeakMap(), _UiPath_instances = new WeakSet(), _UiPath_initializeWithConfig = function _UiPath_initializeWithConfig(config) {
+_UiPath_config = new WeakMap(), _UiPath_authService = new WeakMap(), _UiPath_initialized = new WeakMap(), _UiPath_partialConfig = new WeakMap(), _UiPath_multiLogin = new WeakMap(), _UiPath_metaFolderKey = new WeakMap(), _UiPath_instances = new WeakSet(), _UiPath_initializeWithConfig = function _UiPath_initializeWithConfig(config) {
     // Validate and normalize the configuration
     validateConfig(config);
     const hasSecretAuth = hasSecretConfig(config);
@@ -5869,7 +5877,7 @@ _UiPath_config = new WeakMap(), _UiPath_authService = new WeakMap(), _UiPath_ini
         secret: hasSecretAuth ? config.secret : undefined,
         clientId: hasOAuthAuth ? config.clientId : undefined,
         redirectUri: hasOAuthAuth ? config.redirectUri : undefined,
-        scope: hasOAuthAuth ? config.scope : undefined
+        scope: hasOAuthAuth ? config.scope : undefined,
     });
     const executionContext = new ExecutionContext();
     __classPrivateFieldSet(this, _UiPath_authService, new AuthService(internalConfig, executionContext), "f");
@@ -5877,11 +5885,14 @@ _UiPath_config = new WeakMap(), _UiPath_authService = new WeakMap(), _UiPath_ini
         __classPrivateFieldGet(this, _UiPath_authService, "f").setMultiLogin();
     }
     __classPrivateFieldSet(this, _UiPath_config, internalConfig, "f");
-    // Store internals in SDKInternalsRegistry (not visible on instance)
+    // Store internals in SDKInternalsRegistry (not visible on instance).
+    // `folderKey` is meta-tag-only — kept off `UiPathConfig` (which mirrors
+    // user-passed values) and lives here on the runtime registry instead.
     SDKInternalsRegistry.set(this, {
         config: internalConfig,
         context: executionContext,
-        tokenManager: __classPrivateFieldGet(this, _UiPath_authService, "f").getTokenManager()
+        tokenManager: __classPrivateFieldGet(this, _UiPath_authService, "f").getTokenManager(),
+        folderKey: __classPrivateFieldGet(this, _UiPath_metaFolderKey, "f"),
     });
     // Expose read-only config for user convenience
     this.config = {
@@ -5909,6 +5920,7 @@ _UiPath_config = new WeakMap(), _UiPath_authService = new WeakMap(), _UiPath_ini
 }, _UiPath_loadConfig = function _UiPath_loadConfig() {
     // Load from meta tags
     const metaConfig = loadFromMetaTags();
+    __classPrivateFieldSet(this, _UiPath_metaFolderKey, metaConfig?.folderKey, "f");
     // Merge with any partial config from constructor (constructor overrides meta tags)
     const merged = { ...metaConfig, ...__classPrivateFieldGet(this, _UiPath_partialConfig, "f") };
     if (!isCompleteConfig(merged)) {

package/dist/entities/index.cjs

@@ -651,6 +651,27 @@ var PaginationType;
 /**
  * Collection of utility functions for working with objects
  */
+/**
+ * Resolves a field value from an object, supporting both direct keys (e.g., '@odata.count')
+ * and dot-separated nested paths (e.g., 'pagination.totalCount').
+ * Direct key match takes priority over nested traversal.
+ */
+function resolveNestedField(data, fieldPath) {
+    if (!data) {
+        return undefined;
+    }
+    if (fieldPath in data) {
+        return data[fieldPath];
+    }
+    if (!fieldPath.includes('.')) {
+        return undefined;
+    }
+    let value = data;
+    for (const part of fieldPath.split('.')) {
+        value = value?.[part];
+    }
+    return value;
+}
 /**
  * Filters out undefined values from an object
  * @param obj The source object
@@ -912,6 +933,10 @@ const BUCKET_TOKEN_PARAMS = {
     TOKEN_PARAM: 'continuationToken'
 };
 
+/**
+ * Converts a UTC timestamp string (e.g., "5/8/2026 11:20:17 AM") to ISO 8601 UTC format.
+ * Returns the original value if parsing fails.
+ */
 /**
  * Transforms data by mapping fields according to the provided field mapping
  * @param data The source data to transform
@@ -1266,7 +1291,8 @@ class PaginationHelpers {
         // Extract and transform items from response
         // Handle both plain array responses and envelope responses ({ value: [...], totalRecordCount: N })
         const rawItems = Array.isArray(response.data) ? response.data : response.data?.[itemsField];
-        const totalCount = Array.isArray(response.data) ? undefined : response.data?.[totalCountField];
+        const rawTotalCount = Array.isArray(response.data) ? undefined : resolveNestedField(response.data, totalCountField);
+        const totalCount = typeof rawTotalCount === 'number' ? rawTotalCount : undefined;
         // Parse items - automatically handle JSON string responses
         const parsedItems = typeof rawItems === 'string' ? JSON.parse(rawItems) : (rawItems || []);
         const items = transformFn ? parsedItems.map(transformFn) : parsedItems;
@@ -1442,8 +1468,9 @@ class BaseService {
     constructor(instance, headers) {
         // Private field - not visible via Object.keys() or any reflection
         _BaseService_apiClient.set(this, void 0);
-        const { config, context, tokenManager } = SDKInternalsRegistry.get(instance);
+        const { config, context, tokenManager, folderKey } = SDKInternalsRegistry.get(instance);
         __classPrivateFieldSet(this, _BaseService_apiClient, new ApiClient(config, context, tokenManager, headers ? { headers } : {}), "f");
+        this.config = { folderKey };
     }
     /**
      * Gets a valid authentication token, refreshing if necessary.
@@ -1562,9 +1589,17 @@ class BaseService {
                 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;
+                // When true (default), converts pageNumber to a skip/offset value (e.g., page 3 with pageSize 10 → skip 20).
+                // When false, passes pageNumber directly as the offset param — used by APIs that accept a page number instead of a record offset.
+                const convertToSkip = paginationParams?.convertToSkip ?? true;
                 requestParams[pageSizeParam] = limitedPageSize;
-                if (params.pageNumber && params.pageNumber > 1) {
-                    requestParams[offsetParam] = (params.pageNumber - 1) * limitedPageSize;
+                if (convertToSkip) {
+                    if (params.pageNumber && params.pageNumber > 1) {
+                        requestParams[offsetParam] = (params.pageNumber - 1) * limitedPageSize;
+                    }
+                }
+                else {
+                    requestParams[offsetParam] = params.pageNumber || 1;
                 }
                 {
                     requestParams[countParam] = true;
@@ -1595,7 +1630,8 @@ class BaseService {
         // Extract items and metadata
         // Handle both plain array responses and envelope responses ({ value: [...], totalRecordCount: N })
         const items = Array.isArray(response.data) ? response.data : (response.data[itemsField] || []);
-        const totalCount = Array.isArray(response.data) ? undefined : response.data[totalCountField];
+        const rawTotalCount = Array.isArray(response.data) ? undefined : resolveNestedField(response.data, totalCountField);
+        const totalCount = typeof rawTotalCount === 'number' ? rawTotalCount : undefined;
         const continuationToken = response.data[continuationTokenField];
         // Determine if there are more pages
         const hasMore = this.determineHasMorePages(paginationType, {
@@ -1805,6 +1841,17 @@ exports.QueryFilterOperator = void 0;
     QueryFilterOperator["In"] = "in";
     QueryFilterOperator["NotIn"] = "not in";
 })(exports.QueryFilterOperator || (exports.QueryFilterOperator = {}));
+/**
+ * Aggregate functions supported by the Data Fabric query API.
+ */
+exports.EntityAggregateFunction = void 0;
+(function (EntityAggregateFunction) {
+    EntityAggregateFunction["Count"] = "COUNT";
+    EntityAggregateFunction["Sum"] = "SUM";
+    EntityAggregateFunction["Avg"] = "AVG";
+    EntityAggregateFunction["Min"] = "MIN";
+    EntityAggregateFunction["Max"] = "MAX";
+})(exports.EntityAggregateFunction || (exports.EntityAggregateFunction = {}));
 /**
  * Entity type enum
  */
@@ -2093,7 +2140,7 @@ const EntityFieldTypeMap = {
 // Connection string placeholder that will be replaced during build
 const CONNECTION_STRING = "InstrumentationKey=a6efa11d-1feb-4508-9738-e13e12dcae5e;IngestionEndpoint=https://westeurope-5.in.applicationinsights.azure.com/;LiveEndpoint=https://westeurope.livediagnostics.monitor.azure.com/;ApplicationId=7c58eb1c-9581-4ba6-839e-11725848a037";
 // SDK Version placeholder 
-const SDK_VERSION = "1.3.6";
+const SDK_VERSION = "1.3.8";
 const VERSION = "Version";
 const SERVICE = "Service";
 const CLOUD_ORGANIZATION_NAME = "CloudOrganizationName";
@@ -2712,16 +2759,16 @@ class EntityService extends BaseService {
         return entities;
     }
     /**
-     * Queries entity records with filters, sorting, and pagination
+     * Queries entity records with filters, sorting, aggregates, and pagination
      *
      * @param id - UUID of the entity
-     * @param options - Query options including filterGroup, selectedFields, sortOptions, and pagination
+     * @param options - Query options including filterGroup, selectedFields, sortOptions, aggregates, groupBy, and pagination
      * @returns Promise resolving to {@link NonPaginatedResponse} without pagination options,
      *   or {@link PaginatedResponse} when `pageSize`, `cursor`, or `jumpToPage` are provided
      *
      * @example
      * ```typescript
-     * import { Entities, LogicalOperator, QueryFilterOperator } from '@uipath/uipath-typescript/entities';
+     * import { Entities, LogicalOperator, QueryFilterOperator, EntityAggregateFunction } from '@uipath/uipath-typescript/entities';
      *
      * const entities = new Entities(sdk);
      *
@@ -2745,6 +2792,23 @@ class EntityService extends BaseService {
      * if (page1.hasNextPage) {
      *   const page2 = await entities.queryRecordsById("<entityId>", { cursor: page1.nextCursor });
      * }
+     *
+     * // Aggregate: count of records per status
+     * await entities.queryRecordsById("<entityId>", {
+     *   selectedFields: ["status"],
+     *   groupBy: ["status"],
+     *   aggregates: [
+     *     { function: EntityAggregateFunction.Count, field: "Id", alias: "total" },
+     *   ],
+     * });
+     *
+     * // Aggregate: total sum and average across all records (no grouping)
+     * await entities.queryRecordsById("<entityId>", {
+     *   aggregates: [
+     *     { function: EntityAggregateFunction.Sum, field: "amount", alias: "totalAmount" },
+     *     { function: EntityAggregateFunction.Avg, field: "amount", alias: "avgAmount" },
+     *   ],
+     * });
      * ```
      */
     async queryRecordsById(id, options) {
@@ -2762,7 +2826,7 @@ class EntityService extends BaseService {
                     countParam: ENTITY_OFFSET_PARAMS.COUNT_PARAM
                 }
             },
-            excludeFromPrefix: ['expansionLevel', 'filterGroup', 'selectedFields', 'sortOptions']
+            excludeFromPrefix: ['expansionLevel', 'filterGroup', 'selectedFields', 'sortOptions', 'aggregates', 'groupBy']
         }, options);
     }
     /**

package/dist/entities/index.d.ts

@@ -106,6 +106,7 @@ interface RequestWithPaginationOptions extends RequestSpec {
             offsetParam?: string;
             tokenParam?: string;
             countParam?: string;
+            convertToSkip?: boolean;
         };
     };
 }
@@ -218,6 +219,13 @@ interface ApiResponse<T> {
  */
 declare class BaseService {
     #private;
+    /**
+     * SDK configuration (read-only). Available to subclasses so they can
+     * fall back to init-time defaults like `folderKey`.
+     */
+    protected readonly config: {
+        folderKey?: string;
+    };
     /**
      * Creates a base service instance with dependency injection.
      *
@@ -473,7 +481,31 @@ interface EntityQuerySortOption {
     isDescending?: boolean;
 }
 /**
- * Options for querying entity records with filters, sorting, and pagination.
+ * Aggregate functions supported by the Data Fabric query API.
+ */
+declare enum EntityAggregateFunction {
+    Count = "COUNT",
+    Sum = "SUM",
+    Avg = "AVG",
+    Min = "MIN",
+    Max = "MAX"
+}
+/**
+ * A single aggregate expression to apply during a query.
+ *
+ * Aggregate results are returned as fields on each item in the response,
+ * keyed by `alias` when provided.
+ */
+interface EntityAggregate {
+    /** Aggregate function to apply */
+    function: EntityAggregateFunction;
+    /** Field to aggregate on. For `COUNT`, any non-null field works (typically `Id`). */
+    field: string;
+    /** Optional alias for the aggregate result column. */
+    alias?: string;
+}
+/**
+ * Options for querying entity records with filters, sorting, aggregates, and pagination.
  *
  * Use `pageSize`, `cursor`, or `jumpToPage` for SDK-managed pagination.
  * The SDK computes and manages offset parameters automatically.
@@ -487,6 +519,10 @@ type EntityQueryRecordsOptions = {
     sortOptions?: EntityQuerySortOption[];
     /** Level of entity expansion for related fields (default: 0) */
     expansionLevel?: number;
+    /** Aggregate expressions (COUNT, SUM, AVG, MIN, MAX) to apply across the result set. */
+    aggregates?: EntityAggregate[];
+    /** Field names to group aggregate results by. */
+    groupBy?: string[];
 } & PaginationOptions;
 /**
  * Response from querying entity records
@@ -1166,15 +1202,15 @@ interface EntityServiceModel {
      */
     deleteRecordById(entityId: string, recordId: string): Promise<void>;
     /**
-     * Queries entity records with filters, sorting, and SDK-managed pagination
+     * Queries entity records with filters, sorting, aggregates, and SDK-managed pagination
      *
      * @param id - UUID of the entity
-     * @param options - Query options including filterGroup, selectedFields, sortOptions, and pagination
+     * @param options - Query options including filterGroup, selectedFields, sortOptions, aggregates, groupBy, and pagination
      * @returns Promise resolving to {@link NonPaginatedResponse} without pagination options,
      *   or {@link PaginatedResponse} when `pageSize`, `cursor`, or `jumpToPage` are provided
      * @example
      * ```typescript
-     * import { Entities, LogicalOperator, QueryFilterOperator } from '@uipath/uipath-typescript/entities';
+     * import { Entities, LogicalOperator, QueryFilterOperator, EntityAggregateFunction } from '@uipath/uipath-typescript/entities';
      *
      * const entities = new Entities(sdk);
      *
@@ -1193,6 +1229,23 @@ interface EntityServiceModel {
      * if (page1.hasNextPage) {
      *   const page2 = await entities.queryRecordsById(<id>, { cursor: page1.nextCursor });
      * }
+     *
+     * // Aggregate: count of records per status
+     * await entities.queryRecordsById(<id>, {
+     *   selectedFields: ["status"],
+     *   groupBy: ["status"],
+     *   aggregates: [
+     *     { function: EntityAggregateFunction.Count, field: "Id", alias: "total" },
+     *   ],
+     * });
+     *
+     * // Aggregate: total sum and average across all records (no grouping)
+     * await entities.queryRecordsById(<id>, {
+     *   aggregates: [
+     *     { function: EntityAggregateFunction.Sum, field: "amount", alias: "totalAmount" },
+     *     { function: EntityAggregateFunction.Avg, field: "amount", alias: "avgAmount" },
+     *   ],
+     * });
      * ```
      */
     queryRecordsById<T extends EntityQueryRecordsOptions = EntityQueryRecordsOptions>(id: string, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<EntityRecord> : NonPaginatedResponse<EntityRecord>>;
@@ -1542,13 +1595,17 @@ interface EntityMethods {
      */
     batchInsert(data: Record<string, any>[], options?: EntityBatchInsertOptions): Promise<EntityBatchInsertResponse>;
     /**
-     * Queries records in this entity with filters, sorting, and SDK-managed pagination
+     * Queries records in this entity with filters, sorting, aggregates, and SDK-managed pagination
      *
-     * @param options - Query options including filterGroup, selectedFields, sortOptions, and pagination
+     * @param options - Query options including filterGroup, selectedFields, sortOptions, aggregates, groupBy, and pagination
      * @returns Promise resolving to {@link NonPaginatedResponse} without pagination options,
      *   or {@link PaginatedResponse} when `pageSize`, `cursor`, or `jumpToPage` are provided
      * @example
      * ```typescript
+     * import { Entities, LogicalOperator, QueryFilterOperator, EntityAggregateFunction } from '@uipath/uipath-typescript/entities';
+     *
+     * const entities = new Entities(sdk);
+     *
      * const entity = await entities.getById(<entityId>);
      * const result = await entity.queryRecords({
      *   filterGroup: {
@@ -1558,6 +1615,23 @@ interface EntityMethods {
      *   sortOptions: [{ fieldName: "createdTime", isDescending: true }],
      * });
      * console.log(`Found ${result.totalCount} records`);
+     *
+     * // Aggregate: count of records per status
+     * await entity.queryRecords({
+     *   selectedFields: ["status"],
+     *   groupBy: ["status"],
+     *   aggregates: [
+     *     { function: EntityAggregateFunction.Count, field: "Id", alias: "total" },
+     *   ],
+     * });
+     *
+     * // Aggregate: total sum and average across all records (no grouping)
+     * await entity.queryRecords({
+     *   aggregates: [
+     *     { function: EntityAggregateFunction.Sum, field: "amount", alias: "totalAmount" },
+     *     { function: EntityAggregateFunction.Avg, field: "amount", alias: "avgAmount" },
+     *   ],
+     * });
      * ```
      */
     queryRecords<T extends EntityQueryRecordsOptions = EntityQueryRecordsOptions>(options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<EntityRecord> : NonPaginatedResponse<EntityRecord>>;
@@ -1890,16 +1964,16 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      */
     getAll(): Promise<EntityGetResponse[]>;
     /**
-     * Queries entity records with filters, sorting, and pagination
+     * Queries entity records with filters, sorting, aggregates, and pagination
      *
      * @param id - UUID of the entity
-     * @param options - Query options including filterGroup, selectedFields, sortOptions, and pagination
+     * @param options - Query options including filterGroup, selectedFields, sortOptions, aggregates, groupBy, and pagination
      * @returns Promise resolving to {@link NonPaginatedResponse} without pagination options,
      *   or {@link PaginatedResponse} when `pageSize`, `cursor`, or `jumpToPage` are provided
      *
      * @example
      * ```typescript
-     * import { Entities, LogicalOperator, QueryFilterOperator } from '@uipath/uipath-typescript/entities';
+     * import { Entities, LogicalOperator, QueryFilterOperator, EntityAggregateFunction } from '@uipath/uipath-typescript/entities';
      *
      * const entities = new Entities(sdk);
      *
@@ -1923,6 +1997,23 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * if (page1.hasNextPage) {
      *   const page2 = await entities.queryRecordsById("<entityId>", { cursor: page1.nextCursor });
      * }
+     *
+     * // Aggregate: count of records per status
+     * await entities.queryRecordsById("<entityId>", {
+     *   selectedFields: ["status"],
+     *   groupBy: ["status"],
+     *   aggregates: [
+     *     { function: EntityAggregateFunction.Count, field: "Id", alias: "total" },
+     *   ],
+     * });
+     *
+     * // Aggregate: total sum and average across all records (no grouping)
+     * await entities.queryRecordsById("<entityId>", {
+     *   aggregates: [
+     *     { function: EntityAggregateFunction.Sum, field: "amount", alias: "totalAmount" },
+     *     { function: EntityAggregateFunction.Avg, field: "amount", alias: "avgAmount" },
+     *   ],
+     * });
      * ```
      */
     queryRecordsById<T extends EntityQueryRecordsOptions = EntityQueryRecordsOptions>(id: string, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<EntityRecord> : NonPaginatedResponse<EntityRecord>>;
@@ -2407,5 +2498,5 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
     getById<T extends ChoiceSetGetByIdOptions = ChoiceSetGetByIdOptions>(choiceSetId: string, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<ChoiceSetGetResponse> : NonPaginatedResponse<ChoiceSetGetResponse>>;
 }
 
-export { ChoiceSetService, ChoiceSetService as ChoiceSets, DataDirectionType, EntityService as Entities, EntityFieldDataType, EntityService, EntityType, FieldDisplayType, JoinType, LogicalOperator, QueryFilterOperator, ReferenceType, createEntityWithMethods };
-export type { ChoiceSetGetAllResponse, ChoiceSetGetByIdOptions, ChoiceSetGetResponse, ChoiceSetServiceModel, EntityBatchInsertOptions, EntityBatchInsertResponse, EntityCreateFieldOptions, EntityCreateOptions, EntityDeleteAttachmentResponse, EntityDeleteOptions, EntityDeleteRecordsOptions, EntityDeleteResponse, EntityFieldBase, EntityFieldUpdateOptions, EntityFileType, EntityGetAllRecordsOptions, EntityGetRecordByIdOptions, EntityGetRecordsByIdOptions, EntityGetResponse, EntityImportRecordsResponse, EntityInsertOptions, EntityInsertRecordOptions, EntityInsertRecordsOptions, EntityInsertResponse, EntityMethods, EntityOperationOptions, EntityOperationResponse, EntityQueryFilter, EntityQueryFilterGroup, EntityQueryRecordsOptions, EntityQueryRecordsResponse, EntityQuerySortOption, EntityRecord, EntityRemoveFieldOptions, EntityServiceModel, EntityUpdateByIdOptions, EntityUpdateOptions, EntityUpdateRecordOptions, EntityUpdateRecordResponse, EntityUpdateRecordsOptions, EntityUpdateResponse, EntityUploadAttachmentOptions, EntityUploadAttachmentResponse, ExternalConnection, ExternalField, ExternalFieldMapping, ExternalObject, ExternalSourceFields, FailureRecord, Field, FieldDataType, FieldMetaData, RawEntityGetResponse, SourceJoinCriteria, SqlType };
+export { ChoiceSetService, ChoiceSetService as ChoiceSets, DataDirectionType, EntityService as Entities, EntityAggregateFunction, EntityFieldDataType, EntityService, EntityType, FieldDisplayType, JoinType, LogicalOperator, QueryFilterOperator, ReferenceType, createEntityWithMethods };
+export type { ChoiceSetGetAllResponse, ChoiceSetGetByIdOptions, ChoiceSetGetResponse, ChoiceSetServiceModel, EntityAggregate, EntityBatchInsertOptions, EntityBatchInsertResponse, EntityCreateFieldOptions, EntityCreateOptions, EntityDeleteAttachmentResponse, EntityDeleteOptions, EntityDeleteRecordsOptions, EntityDeleteResponse, EntityFieldBase, EntityFieldUpdateOptions, EntityFileType, EntityGetAllRecordsOptions, EntityGetRecordByIdOptions, EntityGetRecordsByIdOptions, EntityGetResponse, EntityImportRecordsResponse, EntityInsertOptions, EntityInsertRecordOptions, EntityInsertRecordsOptions, EntityInsertResponse, EntityMethods, EntityOperationOptions, EntityOperationResponse, EntityQueryFilter, EntityQueryFilterGroup, EntityQueryRecordsOptions, EntityQueryRecordsResponse, EntityQuerySortOption, EntityRecord, EntityRemoveFieldOptions, EntityServiceModel, EntityUpdateByIdOptions, EntityUpdateOptions, EntityUpdateRecordOptions, EntityUpdateRecordResponse, EntityUpdateRecordsOptions, EntityUpdateResponse, EntityUploadAttachmentOptions, EntityUploadAttachmentResponse, ExternalConnection, ExternalField, ExternalFieldMapping, ExternalObject, ExternalSourceFields, FailureRecord, Field, FieldDataType, FieldMetaData, RawEntityGetResponse, SourceJoinCriteria, SqlType };

package/dist/entities/index.mjs

@@ -649,6 +649,27 @@ var PaginationType;
 /**
  * Collection of utility functions for working with objects
  */
+/**
+ * Resolves a field value from an object, supporting both direct keys (e.g., '@odata.count')
+ * and dot-separated nested paths (e.g., 'pagination.totalCount').
+ * Direct key match takes priority over nested traversal.
+ */
+function resolveNestedField(data, fieldPath) {
+    if (!data) {
+        return undefined;
+    }
+    if (fieldPath in data) {
+        return data[fieldPath];
+    }
+    if (!fieldPath.includes('.')) {
+        return undefined;
+    }
+    let value = data;
+    for (const part of fieldPath.split('.')) {
+        value = value?.[part];
+    }
+    return value;
+}
 /**
  * Filters out undefined values from an object
  * @param obj The source object
@@ -910,6 +931,10 @@ const BUCKET_TOKEN_PARAMS = {
     TOKEN_PARAM: 'continuationToken'
 };
 
+/**
+ * Converts a UTC timestamp string (e.g., "5/8/2026 11:20:17 AM") to ISO 8601 UTC format.
+ * Returns the original value if parsing fails.
+ */
 /**
  * Transforms data by mapping fields according to the provided field mapping
  * @param data The source data to transform
@@ -1264,7 +1289,8 @@ class PaginationHelpers {
         // Extract and transform items from response
         // Handle both plain array responses and envelope responses ({ value: [...], totalRecordCount: N })
         const rawItems = Array.isArray(response.data) ? response.data : response.data?.[itemsField];
-        const totalCount = Array.isArray(response.data) ? undefined : response.data?.[totalCountField];
+        const rawTotalCount = Array.isArray(response.data) ? undefined : resolveNestedField(response.data, totalCountField);
+        const totalCount = typeof rawTotalCount === 'number' ? rawTotalCount : undefined;
         // Parse items - automatically handle JSON string responses
         const parsedItems = typeof rawItems === 'string' ? JSON.parse(rawItems) : (rawItems || []);
         const items = transformFn ? parsedItems.map(transformFn) : parsedItems;
@@ -1440,8 +1466,9 @@ class BaseService {
     constructor(instance, headers) {
         // Private field - not visible via Object.keys() or any reflection
         _BaseService_apiClient.set(this, void 0);
-        const { config, context, tokenManager } = SDKInternalsRegistry.get(instance);
+        const { config, context, tokenManager, folderKey } = SDKInternalsRegistry.get(instance);
         __classPrivateFieldSet(this, _BaseService_apiClient, new ApiClient(config, context, tokenManager, headers ? { headers } : {}), "f");
+        this.config = { folderKey };
     }
     /**
      * Gets a valid authentication token, refreshing if necessary.
@@ -1560,9 +1587,17 @@ class BaseService {
                 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;
+                // When true (default), converts pageNumber to a skip/offset value (e.g., page 3 with pageSize 10 → skip 20).
+                // When false, passes pageNumber directly as the offset param — used by APIs that accept a page number instead of a record offset.
+                const convertToSkip = paginationParams?.convertToSkip ?? true;
                 requestParams[pageSizeParam] = limitedPageSize;
-                if (params.pageNumber && params.pageNumber > 1) {
-                    requestParams[offsetParam] = (params.pageNumber - 1) * limitedPageSize;
+                if (convertToSkip) {
+                    if (params.pageNumber && params.pageNumber > 1) {
+                        requestParams[offsetParam] = (params.pageNumber - 1) * limitedPageSize;
+                    }
+                }
+                else {
+                    requestParams[offsetParam] = params.pageNumber || 1;
                 }
                 {
                     requestParams[countParam] = true;
@@ -1593,7 +1628,8 @@ class BaseService {
         // Extract items and metadata
         // Handle both plain array responses and envelope responses ({ value: [...], totalRecordCount: N })
         const items = Array.isArray(response.data) ? response.data : (response.data[itemsField] || []);
-        const totalCount = Array.isArray(response.data) ? undefined : response.data[totalCountField];
+        const rawTotalCount = Array.isArray(response.data) ? undefined : resolveNestedField(response.data, totalCountField);
+        const totalCount = typeof rawTotalCount === 'number' ? rawTotalCount : undefined;
         const continuationToken = response.data[continuationTokenField];
         // Determine if there are more pages
         const hasMore = this.determineHasMorePages(paginationType, {
@@ -1803,6 +1839,17 @@ var QueryFilterOperator;
     QueryFilterOperator["In"] = "in";
     QueryFilterOperator["NotIn"] = "not in";
 })(QueryFilterOperator || (QueryFilterOperator = {}));
+/**
+ * Aggregate functions supported by the Data Fabric query API.
+ */
+var EntityAggregateFunction;
+(function (EntityAggregateFunction) {
+    EntityAggregateFunction["Count"] = "COUNT";
+    EntityAggregateFunction["Sum"] = "SUM";
+    EntityAggregateFunction["Avg"] = "AVG";
+    EntityAggregateFunction["Min"] = "MIN";
+    EntityAggregateFunction["Max"] = "MAX";
+})(EntityAggregateFunction || (EntityAggregateFunction = {}));
 /**
  * Entity type enum
  */
@@ -2091,7 +2138,7 @@ const EntityFieldTypeMap = {
 // Connection string placeholder that will be replaced during build
 const CONNECTION_STRING = "InstrumentationKey=a6efa11d-1feb-4508-9738-e13e12dcae5e;IngestionEndpoint=https://westeurope-5.in.applicationinsights.azure.com/;LiveEndpoint=https://westeurope.livediagnostics.monitor.azure.com/;ApplicationId=7c58eb1c-9581-4ba6-839e-11725848a037";
 // SDK Version placeholder 
-const SDK_VERSION = "1.3.6";
+const SDK_VERSION = "1.3.8";
 const VERSION = "Version";
 const SERVICE = "Service";
 const CLOUD_ORGANIZATION_NAME = "CloudOrganizationName";
@@ -2710,16 +2757,16 @@ class EntityService extends BaseService {
         return entities;
     }
     /**
-     * Queries entity records with filters, sorting, and pagination
+     * Queries entity records with filters, sorting, aggregates, and pagination
      *
      * @param id - UUID of the entity
-     * @param options - Query options including filterGroup, selectedFields, sortOptions, and pagination
+     * @param options - Query options including filterGroup, selectedFields, sortOptions, aggregates, groupBy, and pagination
      * @returns Promise resolving to {@link NonPaginatedResponse} without pagination options,
      *   or {@link PaginatedResponse} when `pageSize`, `cursor`, or `jumpToPage` are provided
      *
      * @example
      * ```typescript
-     * import { Entities, LogicalOperator, QueryFilterOperator } from '@uipath/uipath-typescript/entities';
+     * import { Entities, LogicalOperator, QueryFilterOperator, EntityAggregateFunction } from '@uipath/uipath-typescript/entities';
      *
      * const entities = new Entities(sdk);
      *
@@ -2743,6 +2790,23 @@ class EntityService extends BaseService {
      * if (page1.hasNextPage) {
      *   const page2 = await entities.queryRecordsById("<entityId>", { cursor: page1.nextCursor });
      * }
+     *
+     * // Aggregate: count of records per status
+     * await entities.queryRecordsById("<entityId>", {
+     *   selectedFields: ["status"],
+     *   groupBy: ["status"],
+     *   aggregates: [
+     *     { function: EntityAggregateFunction.Count, field: "Id", alias: "total" },
+     *   ],
+     * });
+     *
+     * // Aggregate: total sum and average across all records (no grouping)
+     * await entities.queryRecordsById("<entityId>", {
+     *   aggregates: [
+     *     { function: EntityAggregateFunction.Sum, field: "amount", alias: "totalAmount" },
+     *     { function: EntityAggregateFunction.Avg, field: "amount", alias: "avgAmount" },
+     *   ],
+     * });
      * ```
      */
     async queryRecordsById(id, options) {
@@ -2760,7 +2824,7 @@ class EntityService extends BaseService {
                     countParam: ENTITY_OFFSET_PARAMS.COUNT_PARAM
                 }
             },
-            excludeFromPrefix: ['expansionLevel', 'filterGroup', 'selectedFields', 'sortOptions']
+            excludeFromPrefix: ['expansionLevel', 'filterGroup', 'selectedFields', 'sortOptions', 'aggregates', 'groupBy']
         }, options);
     }
     /**
@@ -3503,4 +3567,4 @@ __decorate([
     track('Choicesets.GetById')
 ], ChoiceSetService.prototype, "getById", null);
 
-export { ChoiceSetService, ChoiceSetService as ChoiceSets, DataDirectionType, EntityService as Entities, EntityFieldDataType, EntityService, EntityType, FieldDisplayType, JoinType, LogicalOperator, QueryFilterOperator, ReferenceType, createEntityWithMethods };
+export { ChoiceSetService, ChoiceSetService as ChoiceSets, DataDirectionType, EntityService as Entities, EntityAggregateFunction, EntityFieldDataType, EntityService, EntityType, FieldDisplayType, JoinType, LogicalOperator, QueryFilterOperator, ReferenceType, createEntityWithMethods };