@halix/action-sdk 1.0.24 → 1.0.26

package/lib/cjs/types/data-aggregate.d.ts

@@ -0,0 +1,140 @@
+import { Observable } from 'rxjs';
+/**
+ * TransformType specifies the type of transformation to apply to a group field.
+ */
+export type TransformType = 'Year' | 'Month' | 'Week' | 'Day' | 'Hour' | 'Minute' | 'Substring';
+/**
+ * AggregationType specifies the type of aggregation to perform on a field.
+ */
+export type AggregationType = 'Average' | 'Count' | 'Sum' | 'Max' | 'Min' | 'Median';
+/**
+ * AggregationGroupTransform represents a transform function with parameters to be applied to a group field.
+ */
+export interface AggregationGroupTransform {
+    /** The transformation function to apply */
+    transform: TransformType;
+    /** Arguments for the transformation function */
+    args?: {
+        [key: string]: any;
+    };
+}
+/**
+ * AggregationGroup defines a grouping field with optional transforms and sort direction.
+ */
+export interface AggregationGroup {
+    /** The field to group by (can include relationship paths with dots, e.g. "customer.lastName") */
+    groupField: string;
+    /** Sort direction for this group ('asc' or 'desc') */
+    groupDirection: 'asc' | 'desc';
+    /** Optional transforms to apply to the grouping field */
+    transforms?: AggregationGroupTransform[];
+}
+/**
+ * AggregationSort defines a secondary sort field for aggregated results.
+ */
+export interface AggregationSort {
+    /** The field to sort by (can include relationship paths with dots) */
+    sortField: string;
+    /** Sort direction ('asc' or 'desc') */
+    sortDirection: 'asc' | 'desc';
+    /** The aggregation type to sort by (must match an aggregation in the request) */
+    sortAggregation: AggregationType;
+}
+/**
+ * Aggregation defines an aggregation operation to perform on a field.
+ */
+export interface Aggregation {
+    /** The aggregation function to apply ('Average', 'Count', 'Sum', 'Max', 'Min', 'Median') */
+    aggregation: AggregationType;
+    /** The field to aggregate (can include relationship paths with dots) */
+    aggregationField: string;
+}
+/**
+ * AggregationRequest defines the parameters for an aggregation query.
+ * The data scope is controlled by parentDataElementId, parentKey, and dataElementId.
+ */
+export interface AggregationRequest {
+    /**
+     * The ID of the data element to aggregate.
+     */
+    dataElementId: string;
+    /**
+     * The ID of the parent data element that defines the overall scope of records.
+     * The dataElementId must be related to this through a foreign key or key array.
+     */
+    parentDataElementId?: string;
+    /**
+     * The key of a parent object that all records must be related to.
+     * Works with parentDataElementId to scope results.
+     */
+    parentKey?: string;
+    /**
+     * Optional field to specify the foreign key field on the data element that defines
+     * the relationship to the parent. If omitted, a derived key is assumed.
+     */
+    parentKeyField?: string;
+    /**
+     * Filter expression to limit records before aggregation.
+     * @see the filter-expressions module for filter syntax and examples
+     */
+    filter?: string;
+    /**
+     * List of grouping specifications. Groups are formed by field values with optional transforms.
+     * Results will be grouped by these fields in the order specified.
+     */
+    groups: AggregationGroup[];
+    /**
+     * List of secondary sort specifications for the aggregated results.
+     * Groups are the primary sorts; these are additional sorting criteria.
+     */
+    sort?: AggregationSort[];
+    /**
+     * List of aggregation operations to perform on the grouped data.
+     */
+    aggregations: Aggregation[];
+}
+/**
+ * AggregationResponse wraps the aggregated data results.
+ */
+export interface AggregationResponse {
+    /** The aggregated data results */
+    data: any[];
+}
+/**
+ * Performs data aggregation operations (count, sum, average, etc.) on grouped data.
+ * Supports filtering, grouping with transforms, sorting, and multiple aggregations.
+ *
+ * @param request - Aggregation configuration including dataElementId, parent scope, groups, aggregations
+ * @returns Promise<AggregationResponse> with aggregated data array
+ *
+ * @example
+ * const results = await getAggregateData({
+ *   dataElementId: 'order',
+ *   parentDataElementId: 'company',
+ *   parentKey: orgProxyKey,
+ *   groups: [{
+ *     groupField: 'status',
+ *     groupDirection: 'asc'
+ *   }],
+ *   aggregations: [{
+ *     aggregation: 'Count',
+ *     aggregationField: 'objKey'
+ *   }, {
+ *     aggregation: 'Sum',
+ *     aggregationField: 'totalAmount'
+ *   }]
+ * });
+ */
+export declare function getAggregateData(request: AggregationRequest): Promise<AggregationResponse>;
+/**
+ * Observable version of getAggregateData. See getAggregateData for details.
+ *
+ * @example
+ * getAggregateDataAsObservable({
+ *   dataElementId: 'order',
+ *   groups: [{ groupField: 'status', groupDirection: 'asc' }],
+ *   aggregations: [{ aggregation: 'Count', aggregationField: 'objKey' }]
+ * }).subscribe(response => console.log(response.data));
+ */
+export declare function getAggregateDataAsObservable(request: AggregationRequest): Observable<AggregationResponse>;
+//# sourceMappingURL=data-aggregate.d.ts.map

package/lib/cjs/types/data-aggregate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-aggregate.d.ts","sourceRoot":"","sources":["../../../src/data-aggregate.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAQ,UAAU,EAAiB,MAAM,MAAM,CAAC;AAOvD;;GAEG;AACH,MAAM,MAAM,aAAa,GACnB,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GACrD,WAAW,CAAC;AAElB;;GAEG;AACH,MAAM,MAAM,eAAe,GACrB,SAAS,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,2CAA2C;IAC3C,SAAS,EAAE,aAAa,CAAC;IACzB,gDAAgD;IAChD,IAAI,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,iGAAiG;IACjG,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,cAAc,EAAE,KAAK,GAAG,MAAM,CAAC;IAC/B,yDAAyD;IACzD,UAAU,CAAC,EAAE,yBAAyB,EAAE,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,aAAa,EAAE,KAAK,GAAG,MAAM,CAAC;IAC9B,iFAAiF;IACjF,eAAe,EAAE,eAAe,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,4FAA4F;IAC5F,WAAW,EAAE,eAAe,CAAC;IAC7B,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAE3B;;;OAGG;IACH,IAAI,CAAC,EAAE,eAAe,EAAE,CAAC;IAEzB;;OAEG;IACH,YAAY,EAAE,WAAW,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,kCAAkC;IAClC,IAAI,EAAE,GAAG,EAAE,CAAC;CACf;AAMD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqBhG;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,kBAAkB,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAEzG"}

package/lib/cjs/types/data-crud.d.ts

@@ -8,154 +8,61 @@ export interface SaveOptions {
     bypassValidation?: boolean;
 }
 /**
- * getObject retrieves a single object from the database by its data element ID and key.
+ * Retrieves a single object by dataElementId and key. Optionally fetch related objects.
  *
- * @param dataElementId - The ID of the data element
- * @param key - The key of the object
- * @param fetchedRelationships - Optional array of relationships to fetch; if provided, the returned
- * object will include the specified related objects as nested objects
- * @returns Promise resolving to the object data
+ * @returns Promise<any> - the object data
  */
 export declare function getObject(dataElementId: string, key: string, fetchedRelationships?: string[]): Promise<any>;
 /**
- * getObjectAsObservable retrieves a single object from the database by its data element ID and key.
- *
- * @param dataElementId - The ID of the data element
- * @param key - The key of the object
- * @param fetchedRelationships - Optional array of relationships to fetch; if provided, the returned
- * object will include the specified related objects as nested objects
- *
- * @returns Observable resolving to the object data
+ * Observable version of getObject. See getObject for details.
  */
 export declare function getObjectAsObservable(dataElementId: string, key: string, fetchedRelationships?: string[]): Observable<any>;
 /**
- * getRelatedObjects retrieves an array of objects from the the database. The objects returned are
- * related to a parent through a defined relationship in the schema. In a typical setup, action's
- * auth token must have scope access to the parent object in order to access all of its related
- * objects.
- *
- * It is common to use getRelatedObjects to retrieve all objects belonging to the current user proxy
- * or organization proxy. For example, in a user context where the current user proxy element is
- * "customer," an action might want to retrieve all "purchase" objects related to the current
- * customer. Similarly, in an organization context where the current organization proxy is
- * "business," an action might want to retrieve all "employee" objects related to the current
- * business.
- *
- * @param parentElementId - The ID of the parent element
- * @param parentKey - The key of the parent object
- * @param elementId - The ID of the element
- * @param filter - Optional filter criteria for the query; if not provided, all related objects will
- * be returned
- * @param fetchedRelationships - Optional array of relationships to fetch; if provided, the returned
- * objects will include the specified related objects as nested objects
- *
- * @returns Promise resolving to an array of objects
- *
- * @see {@link FilterExpression} for filter syntax and examples
+ * Retrieves all objects related to a parent through a schema relationship. Commonly used to get objects belonging to current user/org proxy.
+ *
+ * @param parentElementId - Parent element ID
+ * @param parentKey - Parent object key
+ * @param elementId - Child element ID
+ * @param filter - Optional filter (see FilterExpression)
+ * @param fetchedRelationships - Optional relationships to include as nested objects
+ * @returns Promise<any[]>
  */
 export declare function getRelatedObjects(parentElementId: string, parentKey: string, elementId: string, filter?: FilterExpression, fetchedRelationships?: string[]): Promise<any[]>;
 /**
- * getRelatedObjectsAsObservable retrieves an array of objects from the the database. The objects
- * returned are related to a parent through a defined relationship in the schema. In a typical
- * setup, action's auth token must have scope access to the parent object in order to access all of
- * its related objects.
- *
- * It is common to use getRelatedObjects to retrieve all objects belonging to the current user proxy
- * or organization proxy. For example, in a user context where the current user proxy element is
- * "customer," an action might want to retrieve all "purchase" objects related to the current
- * customer. Similarly, in an organization context where the current organization proxy is
- * "business," an action might want to retrieve all "employee" objects related to the current
- * business.
- *
- * @param parentElementId - The ID of the parent element
- * @param parentKey - The key of the parent element
- * @param elementId - The ID of the element
- * @param filter - Optional filter criteria for the query; if not provided, all related objects will
- * be returned
- * @param fetchedRelationships - Optional array of relationships to fetch; if provided, the returned
- * objects will include the specified related objects as nested objects
- *
- * @returns Observable resolving to an array of objects
- *
- * @see {@link FilterExpression} for filter syntax and examples
+ * Observable version of getRelatedObjects. See getRelatedObjects for details.
  */
 export declare function getRelatedObjectsAsObservable(parentElementId: string, parentKey: string, elementId: string, filter?: FilterExpression, fetchedRelationships?: string[]): Observable<any[]>;
 /**
- * saveRelatedObject saves a related object to the database. The objectToSave is saved, and its
- * relationship to the parent object is established based on the relationship specified in the
- * schema. The objectToSave must have a relationship to the parent object and the user must have
- * scope access to the parent object.
+ * Saves a related object and establishes relationship to parent. Returns saved object with any server-assigned values (objKey, calculated fields).
  *
- * @param parentElementId - The ID of the parent element
- * @param parentKey - The key of the parent object
- * @param elementId - The element ID of the object to save
- * @param objectToSave - The object data to save (as a JSON string)
- * @param opts - Optional save options
- *
- * @returns Promise resolving to saved object, including any updates made to the object during the
- * save operation (such as assigning an objKey if the object is new), or the assignment of
- * calculated values
+ * @param objectToSave - JSON string of object data
+ * @param opts - Optional: bypassValidation
+ * @returns Promise<any> - saved object with updates
  */
 export declare function saveRelatedObject(parentElementId: string, parentKey: string, elementId: string, objectToSave: string, opts?: SaveOptions): Promise<any>;
 /**
- * saveRelatedObjectAsObservable saves a related object to the database. The objectToSave is saved,
- * and its relationship to the parent object is established based on the relationship specified in
- * the schema. The objectToSave must have a relationship to the parent object and the user must have
- * scope access to the parent object.
- *
- * @param parentElementId - The ID of the parent element
- * @param parentKey - The key of the parent object
- * @param elementId - The element ID of the object to save
- * @param objectToSave - The object data to save (as a JSON string)
- * @param opts - Optional save options
- *
- * @returns Observable resolving to saved object, including any updates made to the object during
- * the save operation (such as assigning an objKey if the object is new), or the assignment of
- * calculated values
+ * Observable version of saveRelatedObject. See saveRelatedObject for details.
  */
 export declare function saveRelatedObjectAsObservable(parentElementId: string, parentKey: string, elementId: string, objectToSave: string, opts?: SaveOptions): Observable<any>;
 /**
- * deleteRelatedObject deletes a single object related to a specific parent.
+ * Deletes a single object related to a parent.
  *
- * @param parentElementId - The ID of the parent element
- * @param parentKey - The key of the parent object
- * @param childElementId - The ID of the child element to delete
- * @param childKey - The key of the child object to delete
- *
- * @returns Promise resolving to true if deletion was successful
+ * @returns Promise<boolean> - true if successful
  */
 export declare function deleteRelatedObject(parentElementId: string, parentKey: string, childElementId: string, childKey: string): Promise<boolean>;
 /**
- * deleteRelatedObjectAsObservable deletes a single object related to a specific parent.
- *
- * @param parentElementId - The ID of the parent element
- * @param parentKey - The key of the parent object
- * @param childElementId - The ID of the child element to delete
- * @param childKey - The key of the child object to delete
- *
- * @returns Observable resolving to true if deletion was successful
+ * Observable version of deleteRelatedObject. See deleteRelatedObject for details.
  */
 export declare function deleteRelatedObjectAsObservable(parentElementId: string, parentKey: string, childElementId: string, childKey: string): Observable<boolean>;
 /**
- * deleteRelatedObjects deletes multiple objects related to a specific parent.
- *
- * @param parentElementId - The ID of the parent element
- * @param parentKey - The key of the parent object
- * @param childElementId - The ID of the child element to delete
- * @param childKeys - Array of keys of the child objects to delete
+ * Deletes multiple objects related to a parent.
  *
- * @returns Promise resolving to true if deletion was successful
+ * @param childKeys - Array of child object keys to delete
+ * @returns Promise<boolean> - true if successful
  */
 export declare function deleteRelatedObjects(parentElementId: string, parentKey: string, childElementId: string, childKeys: string[]): Promise<boolean>;
 /**
- * deleteRelatedObjectsAsObservable deletes multiple objects related to a specific parent.
- *
- * @param parentElementId - The ID of the parent element
- * @param parentKey - The key of the parent object
- * @param childElementId - The ID of the child element to delete
- * @param childKeys - Array of keys of the child objects to delete
- *
- * @returns Observable resolving to true if deletion was successful
+ * Observable version of deleteRelatedObjects. See deleteRelatedObjects for details.
  */
 export declare function deleteRelatedObjectsAsObservable(parentElementId: string, parentKey: string, childElementId: string, childKeys: string[]): Observable<boolean>;
 //# sourceMappingURL=data-crud.d.ts.map

package/lib/cjs/types/data-crud.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-crud.d.ts","sourceRoot":"","sources":["../../../src/data-crud.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAQ,UAAU,EAAiB,MAAM,MAAM,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAMxD;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,mCAAmC;IACnC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAMD;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,oBAAoB,CAAC,EAAE,MAAM,EAAE,gBA6BlG;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,oBAAoB,CAAC,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,CAE1H;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,iBAAiB,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,EAAE,oBAAoB,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAgCjL;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,6BAA6B,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,EAAE,oBAAoB,CAAC,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,CAE1L;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAwB7J;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,6BAA6B,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC,CAEtK;AAMD;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAsBhJ;AAED;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAEzJ;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAuBpJ;AAED;;;;;;;;;GASG;AACH,wBAAgB,gCAAgC,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,CAE7J"}
+{"version":3,"file":"data-crud.d.ts","sourceRoot":"","sources":["../../../src/data-crud.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAQ,UAAU,EAAiB,MAAM,MAAM,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAMxD;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,mCAAmC;IACnC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAMD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,oBAAoB,CAAC,EAAE,MAAM,EAAE,gBA6BlG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,oBAAoB,CAAC,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,CAE1H;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,EAAE,oBAAoB,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAgCjL;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,EAAE,oBAAoB,CAAC,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,CAE1L;AAMD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAwB7J;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC,CAEtK;AAMD;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAsBhJ;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAEzJ;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAuBpJ;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,CAE7J"}

package/lib/cjs/types/filter-expressions.d.ts

@@ -5,23 +5,15 @@
  */
 /**
  * FilterExpression represents a filter expression string in the Halix dataexpr format.
+ * Used to filter data based on logical comparisons and boolean conditions.
  *
- * Filter expressions are used to filter data based on logical comparisons and boolean conditions.
- * They support a wide range of operators, boolean logic, arrays, and special variables.
- *
- * ## Expression Structure
- *
- * An expression consists of:
- * - One or more comparisons
- * - Optionally combined using boolean operators (`AND`, `OR`)
- * - Grouped using parentheses `(...)` for logical grouping and precedence
- *
- * ### Basic Forms
+ * ## Basic Forms
  * ```
  * <left> <operator> <right>
  * (<expression1>) AND (<expression2>)
  * (<expression1>) OR (<expression2>)
  * ```
+ * Combine comparisons with AND/OR. Each operand must be in parentheses.
  *
  * ## Supported Operators
  *
@@ -43,111 +35,47 @@
  * | `!<empty> $void` | Value is not empty | `notes !<empty> $void` |
  *
  * ## Value Types
- *
- * Values in expressions can be:
- * - **String literals**: Must be wrapped in single quotes - `'value'`
- * - **Attribute references**: Must not be quoted - `status`, `score`
- * - **Arrays**: Literal arrays - `['A', 'B', 'C']`
- * - **Variables**: Special variables - `$today`, `$daysAgo:5`
- * - **Page/group variables**: Must be quoted - `'@{page.fieldName}'`, `'@{group.fieldName}'`
- *
- * ## Boolean Logic
- *
- * Combine comparisons using:
- * - `AND` – all subexpressions must be true
- * - `OR` – at least one subexpression must be true
- *
- * **Important**: Each operand of `AND`/`OR` must be enclosed in parentheses.
- *
- * ### Examples
- * ```
- * (status = 'active') AND (priority = 'high')
- * (status = 'active') AND ((priority = 'high') OR (escalated = 'true'))
- * ```
- *
- * ## Expression Variables
- *
- * Use special `$variables` for dynamic time-based filtering:
- *
- * | Variable | Meaning |
- * |----------|---------|
- * | `$today` | Current date (e.g. `2023-06-25`) |
- * | `$todayTimestamp` | Timestamp for midnight today |
- * | `$todayUnixTimestamp` | Unix timestamp (ms) for today |
- * | `$startOfMonth` | First day of the current month |
- * | `$endOfMonth` | Last day of the current month |
- * | `$yearsAgo:N` | Timestamp N years ago |
- * | `$monthsAgo:N` | Timestamp N months ago |
- * | `$weeksAgo:N` | Timestamp N weeks ago |
- * | `$daysAgo:N` | Timestamp N days ago |
- * | `$hoursAgo:N` | Timestamp N hours ago |
- * | `$minutesAgo:N` | Timestamp N minutes ago |
- * | `$secondsAgo:N` | Timestamp N seconds ago |
- * | `$yearsAhead:N` | Timestamp N years in the future |
- * | `$monthsAhead:N` | Timestamp N months in the future |
- * | `$weeksAhead:N` | Timestamp N weeks in the future |
- * | `$daysAhead:N` | Timestamp N days in the future |
- * | `$hoursAhead:N` | Timestamp N hours in the future |
- * | `$minutesAhead:N` | Timestamp N minutes in the future |
- * | `$secondsAhead:N` | Timestamp N seconds in the future |
- *
- * ## Common Examples
- *
- * ### Simple Comparison
+ * - **String literals**: `'value'` (single quotes required)
+ * - **Attribute references**: `status`, `score` (no quotes)
+ * - **Arrays**: `['A', 'B', 'C']`
+ * - **Variables**: `$today`, `$daysAgo:5`
+ * - **Page/group variables**: `'@{page.fieldName}'` (quoted)
+ *
+ * ## Time Variables
+ * - `$today`, `$todayTimestamp`, `$todayUnixTimestamp`
+ * - `$startOfMonth`, `$endOfMonth`
+ * - `$yearsAgo:N`, `$monthsAgo:N`, `$weeksAgo:N`, `$daysAgo:N`, `$hoursAgo:N`, `$minutesAgo:N`, `$secondsAgo:N`
+ * - `$yearsAhead:N`, `$monthsAhead:N`, `$weeksAhead:N`, `$daysAhead:N`, `$hoursAhead:N`, `$minutesAhead:N`, `$secondsAhead:N`
+ *
+ * ## Examples
  * ```typescript
- * const filter = "status = 'active'";
- * ```
+ * // Simple comparison
+ * "status = 'active'"
  *
- * ### Case-Insensitive Match
- * ```typescript
- * const filter = "role ~ 'ADMIN'";
- * ```
+ * // Case-insensitive
+ * "role ~ 'ADMIN'"
  *
- * ### Contains Check
- * ```typescript
- * const filter = "notes <> 'important'";
- * ```
+ * // Contains
+ * "notes <> 'important'"
  *
- * ### Array Contains
- * ```typescript
- * const filter = "['pending', 'active', 'review'] <> status";
- * ```
- *
- * ### Empty/Not Empty
- * ```typescript
- * const filter = "notes !<empty> $void";  // Has notes
- * ```
- *
- * ### Compound Expression
- * ```typescript
- * const filter = "(status = 'active') AND (priority = 'high')";
- * ```
+ * // Array contains
+ * "['pending', 'active'] <> status"
  *
- * ### Nested Logic
- * ```typescript
- * const filter = "(status = 'active') AND ((score > '90') OR (grade = 'A'))";
- * ```
+ * // Not empty
+ * "notes !<empty> $void"
  *
- * ### Time-Based Filtering
- * ```typescript
- * const filter = "createdAt > $daysAgo:30";  // Created in last 30 days
- * ```
+ * // Compound with AND/OR
+ * "(status = 'active') AND (priority = 'high')"
+ * "(status = 'active') AND ((score > '90') OR (grade = 'A'))"
  *
- * ### Boolean Values
- * ```typescript
- * const filter = "enabled = boolean:true";
- * ```
+ * // Time-based
+ * "createdAt > $daysAgo:30"
  *
- * ### Using Page Variables
- * ```typescript
- * const filter = "category = '@{page.selectedCategory.value}'";
- * ```
+ * // Boolean
+ * "enabled = boolean:true"
  *
- * ### Complex Multi-Condition Filter
- * ```typescript
- * const filter = "(status = 'active') AND " +
- *                "((priority = 'high') OR (dueDate < $today)) AND " +
- *                "(assignedTo !<empty> $void)";
+ * // Page variables
+ * "category = '@{page.selectedCategory.value}'"
  * ```
  */
 export type FilterExpression = string;

package/lib/cjs/types/filter-expressions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter-expressions.d.ts","sourceRoot":"","sources":["../../../src/filter-expressions.ts"],"names":[],"mappings":"AASA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkJG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC"}
+{"version":3,"file":"filter-expressions.d.ts","sourceRoot":"","sources":["../../../src/filter-expressions.ts"],"names":[],"mappings":"AASA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC"}

package/lib/cjs/types/index.d.ts

@@ -7,7 +7,9 @@ export { getAuthToken, sandboxKey, serviceAddress, actionSubject, userContext, p
 export { type SaveOptions, getObject, getObjectAsObservable, getRelatedObjects, getRelatedObjectsAsObservable, saveRelatedObject, saveRelatedObjectAsObservable, deleteRelatedObject, deleteRelatedObjectAsObservable, deleteRelatedObjects, deleteRelatedObjectsAsObservable } from './data-crud';
 export { type ContentResource, getOrCreateResource, getOrCreateResourceAsObservable, saveResource, saveResourceAsObservable, sendFileContents, sendFileContentsAsObservable, createOrUpdateResource, createOrUpdateResourceAsObservable } from './content';
 export { MessageMethod, type MessageRequest, sendMessage, sendMessageAsObservable } from './messaging';
+export { getPreference, getPreferenceAsObservable } from './preferences';
 export { type FilterExpression } from './filter-expressions';
 export { type SortField, type DataSortField, type BaseListDataRequest, type PagedListDataRequest, type ListDataResponse, type ListDataOptions, type ListDataSearchOptions, type MassEditValueType, type MassEditRequest, type MassDeleteRequest, type MassChangeResponse, getListData, getListDataAsObservable, massEdit, massEditAsObservable, massDelete, massDeleteAsObservable } from './lists';
+export { type AggregationRequest, type AggregationResponse, type AggregationGroup, type AggregationSort, type Aggregation, type AggregationGroupTransform, type TransformType, type AggregationType, getAggregateData, getAggregateDataAsObservable } from './data-aggregate';
 export { sortObjectArray, compareValues, getValueFromObject, debounceFn } from './utilities';
 //# sourceMappingURL=index.d.ts.map

package/lib/cjs/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AASA;;;;GAIG;AAMH,OAAO,EAEH,YAAY,EACZ,UAAU,EACV,cAAc,EACd,aAAa,EACb,WAAW,EACX,MAAM,EACN,OAAO,EAGP,UAAU,EAGV,KAAK,WAAW,EAChB,KAAK,iBAAiB,EAGtB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,EAC9B,KAAK,aAAa,EAGlB,sBAAsB,EACtB,oBAAoB,EACvB,MAAM,eAAe,CAAC;AAMvB,OAAO,EAEH,KAAK,WAAW,EAGhB,SAAS,EACT,qBAAqB,EACrB,iBAAiB,EACjB,6BAA6B,EAG7B,iBAAiB,EACjB,6BAA6B,EAG7B,mBAAmB,EACnB,+BAA+B,EAC/B,oBAAoB,EACpB,gCAAgC,EACnC,MAAM,aAAa,CAAC;AAMrB,OAAO,EAEH,KAAK,eAAe,EAGpB,mBAAmB,EACnB,+BAA+B,EAC/B,YAAY,EACZ,wBAAwB,EACxB,gBAAgB,EAChB,4BAA4B,EAC5B,sBAAsB,EACtB,kCAAkC,EACrC,MAAM,WAAW,CAAC;AAMnB,OAAO,EAEH,aAAa,EAGb,KAAK,cAAc,EAGnB,WAAW,EACX,uBAAuB,EAC1B,MAAM,aAAa,CAAC;AAMrB,OAAO,EACH,KAAK,gBAAgB,EACxB,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EAEH,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EAGvB,WAAW,EACX,uBAAuB,EACvB,QAAQ,EACR,oBAAoB,EACpB,UAAU,EACV,sBAAsB,EACzB,MAAM,SAAS,CAAC;AAMjB,OAAO,EACH,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,UAAU,EACb,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AASA;;;;GAIG;AAMH,OAAO,EAEH,YAAY,EACZ,UAAU,EACV,cAAc,EACd,aAAa,EACb,WAAW,EACX,MAAM,EACN,OAAO,EAGP,UAAU,EAGV,KAAK,WAAW,EAChB,KAAK,iBAAiB,EAGtB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,EAC9B,KAAK,aAAa,EAGlB,sBAAsB,EACtB,oBAAoB,EACvB,MAAM,eAAe,CAAC;AAMvB,OAAO,EAEH,KAAK,WAAW,EAGhB,SAAS,EACT,qBAAqB,EACrB,iBAAiB,EACjB,6BAA6B,EAG7B,iBAAiB,EACjB,6BAA6B,EAG7B,mBAAmB,EACnB,+BAA+B,EAC/B,oBAAoB,EACpB,gCAAgC,EACnC,MAAM,aAAa,CAAC;AAMrB,OAAO,EAEH,KAAK,eAAe,EAGpB,mBAAmB,EACnB,+BAA+B,EAC/B,YAAY,EACZ,wBAAwB,EACxB,gBAAgB,EAChB,4BAA4B,EAC5B,sBAAsB,EACtB,kCAAkC,EACrC,MAAM,WAAW,CAAC;AAMnB,OAAO,EAEH,aAAa,EAGb,KAAK,cAAc,EAGnB,WAAW,EACX,uBAAuB,EAC1B,MAAM,aAAa,CAAC;AAMrB,OAAO,EAEH,aAAa,EACb,yBAAyB,EAC5B,MAAM,eAAe,CAAC;AAMvB,OAAO,EACH,KAAK,gBAAgB,EACxB,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EAEH,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EAGvB,WAAW,EACX,uBAAuB,EACvB,QAAQ,EACR,oBAAoB,EACpB,UAAU,EACV,sBAAsB,EACzB,MAAM,SAAS,CAAC;AAMjB,OAAO,EAEH,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,yBAAyB,EAC9B,KAAK,aAAa,EAClB,KAAK,eAAe,EAGpB,gBAAgB,EAChB,4BAA4B,EAC/B,MAAM,kBAAkB,CAAC;AAM1B,OAAO,EACH,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,UAAU,EACb,MAAM,aAAa,CAAC"}