@halix/action-sdk 1.0.51 → 1.0.52

package/lib/esm/lists.js

@@ -32,8 +32,13 @@ import { sandboxKey, serviceAddress, getAuthToken } from './sdk-general';
  * Retrieves paginated list data. Supports authenticated/public access, filtering, sorting, and binary search.
  *
  * Common usage:
+ * - Use `getListData` when you need list-specific behavior: pagination, explicit totals,
+ *   server-side sort/filter, field projection, search, selection, or bulk operations.
+ * - Do not choose `getListData` only because the task is a report. Prefer `getAccessibleObjects`
+ *   for bounded accessible-record reads without list behavior, `getRelatedObjects` when a
+ *   concrete parent key is already known, or `getAggregateData` for grouped counts/sums.
  * - For most custom-element list UIs, start with only `dataElementId`, pagination fields,
- *   and `displayFields`.
+ *   and `fields`.
  * - Omit `parentDataElementId` and `parentKey` when you want the records the current user
  *   can already access.
  * - Add `parentDataElementId` and `parentKey` only when the list must be anchored to a
@@ -41,48 +46,77 @@ import { sandboxKey, serviceAddress, getAuthToken } from './sdk-general';
  * - Most callers should omit `options`. Use `options.search` only for binary-search
  *   navigation scenarios, and use `options.bypassTotal` only when you explicitly do not
  *   need the total count.
+ * - For bounded report reads that genuinely need list behavior, set `pageNumber`, an explicit
+ *   `pageSize`, and `fields` for every field used in filtering, grouping, sorting,
+ *   aggregation, or rendering.
+ *
+ * Response shape:
+ * - `response.data` is the row array.
+ * - `response.total` is the total matching record count across all pages when
+ *   requested. If `response.total > response.data.length`, this response is
+ *   a page slice, not the full result set.
+ * - Do not read `response.objects`, `response.items`, or the response object itself as
+ *   the row array.
+ *
+ * Pagination guidance:
+ * - Use `response.total` to decide whether the current page covers the full
+ *   query. For page 1 with pageSize 100 and total 5,000, local aggregation over
+ *   `response.data` covers only the first 100 rows.
+ * - Do not treat a first page or large page as complete report data just because
+ *   it contains rows.
  *
  * Request shape:
  * - `dataElementId` (required): root data element to retrieve
  * - `pageNumber` / `pageSize` (optional): pagination
- * - `displayFields` (optional): fields to populate in returned objects
+ * - `fields` (optional): fields to populate in returned objects
  * - `sort` (optional): sort fields such as `[{ attributeId: 'name' }]`
  * - `filter` (optional): filter expression
  * - `parentDataElementId` / `parentKey` (optional): explicit parent scope
  *
  * @param request - List configuration including dataElementId, parentDataElementId, parentKey, pagination, sort, filter
  * @param options - Optional: isPublic, bypassTotal, search
- * @returns Promise<ListDataResponse> with data array, total count, pageNumber
+ * @returns Promise<ListDataResponse<TRecord>> with data array, total count, pageNumber
  *
  * @example
  * // Most common case: one page of records the current user can access.
- * const response = await getListData({
+ * type StudentRow = {
+ *   name: string;
+ *   studentNumber: string;
+ *   email: string;
+ *   grade: string;
+ * };
+ * const response = await getListData<StudentRow>({
  *   dataElementId: 'student',
  *   pageNumber: 1,
  *   pageSize: 10,
- *   displayFields: ['name', 'studentNumber', 'email', 'grade']
+ *   fields: ['name', 'studentNumber', 'email', 'grade']
  * });
+ * const rows = response.data;
  *
  * @example
  * // Custom element pagination with an optional sort.
- * const response = await getListData({
+ * type StudentListRow = { name: string; studentNumber: string; email: string; grade: string };
+ * const response = await getListData<StudentListRow>({
  *   dataElementId: 'student',
  *   pageNumber: currentPage,
  *   pageSize: 10,
- *   displayFields: ['name', 'studentNumber', 'email', 'grade'],
+ *   fields: ['name', 'studentNumber', 'email', 'grade'],
  *   sort: [{ attributeId: 'name' }]
  * });
+ * const rows = response.data;
  *
  * @example
  * // Explicit parent scoping when the list must be anchored to a specific parent.
- * const listData = await getListData({
+ * type CustomerRow = { firstName: string; lastName: string; email: string };
+ * const listData = await getListData<CustomerRow>({
  *   dataElementId: 'customer',
  *   parentDataElementId: 'company',
  *   parentKey: orgProxyKey,
  *   pageNumber: 1,
  *   pageSize: 50,
- *   displayFields: ['firstName', 'lastName', 'email']
+ *   fields: ['firstName', 'lastName', 'email']
  * });
+ * const rows = listData.data;
  *
  * @example
  * // options is rarely needed; omit it unless you need one of these behaviors.
@@ -91,7 +125,7 @@ import { sandboxKey, serviceAddress, getAuthToken } from './sdk-general';
  *     dataElementId: 'student',
  *     pageNumber: 1,
  *     pageSize: 10,
- *     displayFields: ['name']
+ *     fields: ['name']
  *   },
  *   {
  *     search: {
@@ -147,7 +181,7 @@ export async function getListData(request, options) {
         console.log("Sending POST request to " + url + " (public endpoint)");
     }
     // Make the API request
-    let response = await axios.post(url, request, {
+    let response = await axios.post(url, _toServerListDataRequest(request), {
         headers,
         params: Object.keys(params).length > 0 ? params : undefined,
     });
@@ -163,6 +197,25 @@ export async function getListData(request, options) {
 export function getListDataAsObservable(request, options) {
     return from(getListData(request, options));
 }
+function _toServerListDataRequest(request) {
+    const { fields, ...rest } = request;
+    return {
+        ...rest,
+        ...(fields ? { displayFields: fields } : {}),
+    };
+}
+function _toServerMassEditRequest(request) {
+    return {
+        ...request,
+        dataRequest: _toServerListDataRequest(request.dataRequest),
+    };
+}
+function _toServerMassDeleteRequest(request) {
+    return {
+        ...request,
+        dataRequest: _toServerListDataRequest(request.dataRequest),
+    };
+}
 // ================================================================================
 // MASS EDIT AND DELETE FUNCTIONS
 // ================================================================================
@@ -197,7 +250,7 @@ export async function massEdit(request) {
     };
     console.log("Sending POST request to " + url + " with token " + authToken);
     // Make the API request
-    let response = await axios.post(url, request, { headers });
+    let response = await axios.post(url, _toServerMassEditRequest(request), { headers });
     return response.data;
 }
 /**
@@ -234,7 +287,7 @@ export async function massDelete(request) {
     };
     console.log("Sending POST request to " + url + " with token " + authToken);
     // Make the API request
-    let response = await axios.post(url, request, { headers });
+    let response = await axios.post(url, _toServerMassDeleteRequest(request), { headers });
     return response.data;
 }
 /**

package/lib/esm/lists.js.map

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

package/lib/esm/sdk-general.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-general.js","sourceRoot":"","sources":["../../src/sdk-general.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,mCAAmC;AACnC,EAAE;AACF,oEAAoE;AACpE,0EAA0E;AAC1E,EAAE;AACF,6DAA6D;AAC7D,oDAAoD;AAEpD;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAc,EAAE,EAAE,MAAM,MAAM,CAAC;AAEtC,mFAAmF;AACnF,sCAAsC;AACtC,mFAAmF;AAEnF;;GAEG;AACH,MAAM,CAAC,IAAI,YAAsC,CAAC;AAElD;;GAEG;AACH,MAAM,CAAC,IAAI,UAAkB,CAAC;AAE9B;;GAEG;AACH,MAAM,CAAC,IAAI,cAAsB,CAAC;AAElC;;GAEG;AACH,MAAM,CAAC,IAAI,aAAkB,CAAC;AAE9B;;GAEG;AACH,MAAM,CAAC,IAAI,WAAwB,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,IAAI,MAAc,CAAC;AAE1B;;GAEG;AACH,MAAM,CAAC,IAAI,OAAgB,CAAC;AAE5B;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAmC;IAE1D,IAAI,IAAI,GAAQ,KAAK,CAAC;IACtB,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACb,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QAClB,OAAO,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,IAAI,EAAE,CAAC;QACP,CAAC,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;QAE5E,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,YAAY,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACjC,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC;QAC3C,CAAC;IACL,CAAC;AACL,CAAC;AAwKD,mFAAmF;AACnF,4BAA4B;AAC5B,mFAAmF;AAEnF;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,eAA+B;IAClE,IAAI,OAAO,EAAE,CAAC;QACV,OAAO;YACH,UAAU,EAAE,GAAG;YACf,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC;SACxC,CAAC;IACN,CAAC;IAED,OAAO,eAAe,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,YAAoB;IACrD,IAAI,OAAO,EAAE,CAAC;QACV,OAAO;YACH,UAAU,EAAE,GAAG;YACf,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;SACzC,CAAC;IACN,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;AACnD,CAAC"}
+{"version":3,"file":"sdk-general.js","sourceRoot":"","sources":["../../src/sdk-general.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,mCAAmC;AACnC,EAAE;AACF,oEAAoE;AACpE,0EAA0E;AAC1E,EAAE;AACF,6DAA6D;AAC7D,oDAAoD;AAEpD;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAc,EAAE,EAAE,MAAM,MAAM,CAAC;AAEtC,mFAAmF;AACnF,sCAAsC;AACtC,mFAAmF;AAEnF;;GAEG;AACH,MAAM,CAAC,IAAI,YAAsC,CAAC;AAElD;;GAEG;AACH,MAAM,CAAC,IAAI,UAAkB,CAAC;AAE9B;;GAEG;AACH,MAAM,CAAC,IAAI,cAAsB,CAAC;AAElC;;GAEG;AACH,MAAM,CAAC,IAAI,aAAkB,CAAC;AAE9B;;GAEG;AACH,MAAM,CAAC,IAAI,WAAwB,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,IAAI,MAAc,CAAC;AAE1B;;GAEG;AACH,MAAM,CAAC,IAAI,OAAgB,CAAC;AAE5B;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAmC;IAE1D,IAAI,IAAI,GAAQ,KAAK,CAAC;IACtB,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACb,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QAClB,OAAO,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,IAAI,EAAE,CAAC;QACP,CAAC,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;QAE5E,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,YAAY,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACjC,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC;QAC3C,CAAC;IACL,CAAC;AACL,CAAC;AAwLD,mFAAmF;AACnF,4BAA4B;AAC5B,mFAAmF;AAEnF;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,eAA+B;IAClE,IAAI,OAAO,EAAE,CAAC;QACV,OAAO;YACH,UAAU,EAAE,GAAG;YACf,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC;SACxC,CAAC;IACN,CAAC;IAED,OAAO,eAAe,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,YAAoB;IACrD,IAAI,OAAO,EAAE,CAAC;QACV,OAAO;YACH,UAAU,EAAE,GAAG;YACf,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;SACzC,CAAC;IACN,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;AACnD,CAAC"}

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

@@ -1,4 +1,5 @@
 import { Observable } from 'rxjs';
+import type { FilterExpression } from './filter-expression';
 /**
  * TransformType specifies the type of transformation to apply to a group field.
  */
@@ -74,10 +75,10 @@ export interface AggregationRequest {
      */
     parentKeyField?: string;
     /**
-     * Filter expression to limit records before aggregation. Call `dataexpr_agent` to generate the
-     * filter expression.
+     * Halix filter expression to limit records before aggregation. This is not SQL or
+     * JavaScript syntax. Call `build_filter_expression` to generate the filter expression.
      */
-    filter?: string;
+    filter?: FilterExpression;
     /**
      * List of grouping specifications. Groups are formed by field values with optional transforms.
      * Results will be grouped by these fields in the order specified.

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

@@ -1,4 +1,5 @@
 import { Observable } from 'rxjs';
+import type { FilterExpression } from './filter-expression';
 /**
  * SaveOptions is an interface for specifying save operation options.
  */
@@ -25,45 +26,45 @@ export declare function getObjectAsObservable(dataElementId: string, key: string
  * @param parentElementId - Parent element ID
  * @param parentKey - Parent object key; important: this establishes the scope of the query; use an appropriate scope key
  * @param elementId - Child element ID
- * @param filter - Optional filter; call `dataexpr_agent` to generate the filter expression. Must be less than 200 characters.
+ * @param filter - Optional Halix filter expression. This is not SQL or JavaScript syntax. Call `build_filter_expression` to generate it. Must be less than 200 characters.
  * @param fetchedRelationships - Optional relationships to include as nested objects
  * @returns Promise<any[]>
  */
-export declare function getRelatedObjects(parentElementId: string, parentKey: string, elementId: string, filter?: string, fetchedRelationships?: string[]): Promise<any[]>;
+export declare function getRelatedObjects(parentElementId: string, parentKey: string, elementId: string, filter?: FilterExpression, fetchedRelationships?: string[]): Promise<any[]>;
 /**
  * Observable version of getRelatedObjects. See getRelatedObjects for details.
  */
-export declare function getRelatedObjectsAsObservable(parentElementId: string, parentKey: string, elementId: string, filter?: string, fetchedRelationships?: string[]): Observable<any[]>;
+export declare function getRelatedObjectsAsObservable(parentElementId: string, parentKey: string, elementId: string, filter?: FilterExpression, fetchedRelationships?: string[]): Observable<any[]>;
 /**
  * Retrieves all objects for a data element that the current user has access to.
  *
  * @param dataElementId - Data element ID
- * @param filter - Optional filter; call `dataexpr_agent` to generate the filter expression. Must be less than 200 characters.
+ * @param filter - Optional Halix filter expression. This is not SQL or JavaScript syntax. Call `build_filter_expression` to generate it. Must be less than 200 characters.
  * @param fetchedRelationships - Optional relationships to include as nested objects
  * @param applyContext - Optional flag to apply navigation context scoping. When true, navigation context is read from UserContext.navigationContext and results are limited by the navigation context org proxy.
  * @returns Promise<any[]>
  */
-export declare function getAccessibleObjects(dataElementId: string, filter?: string, fetchedRelationships?: string[], applyContext?: boolean): Promise<any[]>;
+export declare function getAccessibleObjects(dataElementId: string, filter?: FilterExpression, fetchedRelationships?: string[], applyContext?: boolean): Promise<any[]>;
 /**
  * Observable version of getAccessibleObjects. See getAccessibleObjects for details.
  */
-export declare function getAccessibleObjectsAsObservable(dataElementId: string, filter?: string, fetchedRelationships?: string[], applyContext?: boolean): Observable<any[]>;
+export declare function getAccessibleObjectsAsObservable(dataElementId: string, filter?: FilterExpression, fetchedRelationships?: string[], applyContext?: boolean): Observable<any[]>;
 /**
  * Retrieves accessible objects for a data element from a specific key list.
  * Only objects that are accessible to the current user are returned. If applyContext is true, keyed objects outside the current navigation context are also omitted.
  *
  * @param dataElementId - Data element ID
  * @param keys - Object keys to retrieve
- * @param filter - Optional filter; call `dataexpr_agent` to generate the filter expression. Must be less than 200 characters.
+ * @param filter - Optional Halix filter expression. This is not SQL or JavaScript syntax. Call `build_filter_expression` to generate it. Must be less than 200 characters.
  * @param fetchedRelationships - Optional relationships to include as nested objects
  * @param applyContext - Optional flag to apply navigation context scoping. When true, navigation context is read from UserContext.navigationContext and results are limited by the navigation context org proxy.
  * @returns Promise<any[]>
  */
-export declare function getObjects(dataElementId: string, keys: string[], filter?: string, fetchedRelationships?: string[], applyContext?: boolean): Promise<any[]>;
+export declare function getObjects(dataElementId: string, keys: string[], filter?: FilterExpression, fetchedRelationships?: string[], applyContext?: boolean): Promise<any[]>;
 /**
  * Observable version of getObjects. See getObjects for details.
  */
-export declare function getObjectsAsObservable(dataElementId: string, keys: string[], filter?: string, fetchedRelationships?: string[], applyContext?: boolean): Observable<any[]>;
+export declare function getObjectsAsObservable(dataElementId: string, keys: string[], filter?: FilterExpression, fetchedRelationships?: string[], applyContext?: boolean): Observable<any[]>;
 /**
  * Saves an object without establishing a parent relationship. Returns saved object with any server-assigned values (objKey, calculated fields).
  *

package/lib/esm/types/filter-expression.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Halix data filter expression language string.
+ *
+ * This is not SQL, JavaScript, or an arbitrary query-string syntax. Use the
+ * `build_filter_expression` agent tool to generate filter expressions for SDK
+ * calls, list reads, aggregate queries, choosers, and generated TypeScript.
+ *
+ * Filter expressions are evaluated by Halix services within the request's
+ * normal data-access scope. Most filter parameters must be less than 200
+ * characters.
+ *
+ * @example
+ * // Boolean comparison
+ * const filter: FilterExpression = "archive!=boolean:true";
+ *
+ * @example
+ * // Date and key comparisons
+ * const filter: FilterExpression =
+ *   "(endDate >= date:2025-06-12) AND (courseKey=string:crs~00~abc)";
+ */
+export type FilterExpression = string;

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

@@ -4,6 +4,7 @@
  * platform. This is the main entry point that provides a unified interface for all SDK functionality.
  */
 export { getAuthToken, sandboxKey, serviceAddress, actionSubject, userContext, params, useBody, initialize, type UserContext, type IncomingEventBody, type BaseActionResponse, type ActionResponse, type NotificationConfig, type ListActionResponse, type FormTemplateActionResponse, type PageTemplateActionResponse, type ObjectSaveActionResponse, type CalculatedFieldActionResponse, type SingleValueActionResponse, type ErrorResponse, prepareSuccessResponse, prepareErrorResponse } from './sdk-general';
+export { type FilterExpression } from './filter-expression';
 export { type SaveOptions, getObject, getObjectAsObservable, getRelatedObjects, getRelatedObjectsAsObservable, getAccessibleObjects, getAccessibleObjectsAsObservable, getObjects, getObjectsAsObservable, saveObject, saveObjectAsObservable, saveRelatedObject, saveRelatedObjectAsObservable, deleteObject, deleteObjectAsObservable, deleteRelatedObject, deleteRelatedObjectAsObservable, deleteRelatedObjects, deleteRelatedObjectsAsObservable } from './data-crud';
 export { type ScopeKeyItem, type Role, type BusinessPrivilege, type SandboxUser, type UserAccessWrapper, type LinkUserProxyRequest, type UserProxyAccessRosterRow, type ListUserProxyAccessRosterOptions, type InviteOrLinkUserProxyByEmailRequest, type InviteOrLinkUserProxyAction, type InviteOrLinkUserProxyResult, type SetUserProxyRosterRolesRequest, type UpdateAccessRequest, type BusinessPrivilegeCheckResult, type CurrentBusinessPrivilegesResult, type DataElementAccessMode, type DataElementAccessResult, listRoles, listRolesAsObservable, listBusinessPrivileges, listBusinessPrivilegesAsObservable, listSandboxUsers, listSandboxUsersAsObservable, getUserAccess, getUserAccessAsObservable, linkUserProxy, linkUserProxyAsObservable, listUserProxyAccessRoster, listUserProxyAccessRosterAsObservable, inviteOrLinkUserProxyByEmail, inviteOrLinkUserProxyByEmailAsObservable, setUserProxyRosterRoles, setUserProxyRosterRolesAsObservable, removeUserProxyRosterAccess, removeUserProxyRosterAccessAsObservable, updateUserAccess, updateUserAccessAsObservable, removeUserAccess, removeUserAccessAsObservable, hasBusinessPrivilege, hasBusinessPrivilegeAsObservable, userPrivileges, userPrivilegesAsObservable, dataElementAccess, dataElementAccessAsObservable, hasDataElementAccess, hasDataElementAccessAsObservable, canReadDataElement, canReadDataElementAsObservable, canWriteDataElement, canWriteDataElementAsObservable, canDeleteDataElement, canDeleteDataElementAsObservable, } from './access';
 export { type ContentResource, getOrCreateResource, getOrCreateResourceAsObservable, saveResource, saveResourceAsObservable, sendFileContents, sendFileContentsAsObservable, createOrUpdateResource, createOrUpdateResourceAsObservable, downloadResource, downloadResourceAsObservable } from './content';
@@ -12,5 +13,6 @@ export { getUserPreference, getOrganizationPreference, getUserPreferenceAsObserv
 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 { AggregationResponse, type AggregationRequest, type AggregationRow, type AggregationGroup, type AggregationSort, type Aggregation, type AggregationGroupTransform, type TransformType, type AggregationType, getAggregateData, getAggregateDataAsObservable } from './data-aggregate';
 export { type GatewayPaymentPreauthResult, type StandalonePaymentRequest, type StandalonePaymentResult, submitStandalonePayment, submitStandalonePaymentAsObservable } from './payments';
+export { type InvoiceDueItem, type PayerInvoiceGroup, type ReminderMatchCriteria, type PaymentReminderRecord, type ChannelCoverage, getEnabledPaymentReminders, getInvoicesMatchingReminder, listEnrolledOrganizations, getReminderDeliveryCoverage } from './invoices';
 export { type AIRequestOptions, sendAIMessage, sendAIMessageAsObservable } from './ai';
 export { sortObjectArray, compareValues, getValueFromObject, debounceFn } from './utilities';

package/lib/esm/types/invoices.d.ts

@@ -0,0 +1,71 @@
+export interface InvoiceDueItem {
+    /** Invoice (sales transaction) key. */
+    invoiceKey: string;
+    /** User-facing invoice ID from the SalesTransaction id field. */
+    invoiceId: string;
+    /** Backwards-compatible alias for invoiceId. */
+    invoiceNumber: string;
+    /** User-facing description, e.g. "Down payment on Tuition Kindergarten SY26-27". */
+    description: string;
+    /** Due date — either the invoice's top-level dueDate or an installment's dueDate. */
+    dueDate: string;
+    /** Due date formatted for message display as M/d/yyyy. */
+    dueDateDisplay: string;
+    /** When the matching due date came from an installment, the 0-based index in installmentItems. */
+    installmentIndex?: number;
+    /** Amount remaining for this invoice/installment. */
+    amountDue: number;
+    /** Line-item summaries suitable for inclusion in a reminder message. */
+    lineItems: Array<{
+        description: string;
+        quantity: number;
+        amount: number;
+    }>;
+}
+export interface PayerInvoiceGroup {
+    payerKey: string;
+    payerType: string;
+    payerName: string;
+    items: InvoiceDueItem[];
+    totalBalance: number;
+}
+export interface ReminderMatchCriteria {
+    sendType: 'specificDates' | 'dueDateRelative';
+    specificDates?: string[];
+    dueDateOffsets?: number[];
+}
+export interface PaymentReminderRecord {
+    objKey: string;
+    organizationKey: string;
+    sandboxKey: string;
+    name: string;
+    enabled: boolean;
+    previewMode?: boolean;
+    channel: 'email' | 'sms' | 'both';
+    emailSubject?: string;
+    emailBody?: string;
+    smsBody?: string;
+    sendType: 'specificDates' | 'dueDateRelative';
+    specificDates?: string[];
+    dueDateOffsets?: number[];
+    bccEmail?: string;
+}
+export type ChannelCoverage = 'covered' | 'retryable' | 'unsent';
+export declare function getEnabledPaymentReminders(orgKey: string): Promise<PaymentReminderRecord[]>;
+export declare function getInvoicesMatchingReminder(orgKey: string, criteria: ReminderMatchCriteria, today: string): Promise<PayerInvoiceGroup[]>;
+export declare function listEnrolledOrganizations(solutionKey: string): Promise<{
+    orgKey: string;
+    orgProxyKey: string;
+    orgProxyType: string;
+    orgName: string;
+    timezone?: string;
+}[]>;
+export declare function getReminderDeliveryCoverage(args: {
+    reminderKey: string;
+    payerKey: string;
+    organizationProxyKey: string;
+    organizationProxyType?: string;
+    dayStart: string;
+    nextDayStart: string;
+    channels: ('email' | 'sms')[];
+}): Promise<Record<'email' | 'sms', ChannelCoverage>>;

package/lib/esm/types/lists.d.ts

@@ -1,4 +1,5 @@
 import { Observable } from 'rxjs';
+import type { FilterExpression } from './filter-expression';
 /**
  * SortField is an interface for specifying sort fields.
  */
@@ -64,21 +65,21 @@ export interface BaseListDataRequest {
      */
     childKeysField?: string;
     /**
-     * Filter expression to limit results. Evaluated within the parent key scope.
-     * Call `dataexpr_agent` to generate the filter expression.
-     * Must be less than 200 characters.
+     * Halix filter expression to limit results. Evaluated within the parent key scope.
+     * This is not SQL or JavaScript syntax. Call `build_filter_expression` to generate
+     * the filter expression. Must be less than 200 characters.
      */
-    filter?: string;
+    filter?: FilterExpression;
     /**
-     * List of fields being displayed on the list. Only these fields are populated in
-     * returned objects to reduce payload size. If fields include relationship paths,
-     * those relationships are automatically retrieved.
-     */
-    displayFields?: string[];
-    /**
-     * Additional field values to include that may not be in displayFields, sort, or filters.
+     * Fields to populate in returned rows. If omitted, rows may contain only `objKey`
+     * plus server defaults; every field read from `response.data` should be requested
+     * here. Use this same array for visible fields and fields needed by local
+     * calculations, joins, grouping, charting, sorting, or conditional rendering.
+     *
+     * If fields include relationship paths, those relationships are automatically retrieved.
+     * The SDK sends this to the list service as `displayFields`.
      */
-    additionalFieldsToFetch?: string[];
+    fields?: string[];
 }
 /**
  * PagedListDataRequest extends BaseListDataRequest with pagination properties.
@@ -96,14 +97,26 @@ export interface PagedListDataRequest extends BaseListDataRequest {
 }
 /**
  * ListDataResponse wraps a data provider response to a list data request.
+ *
+ * Rows are returned in the `data` array. Do not read `objects`, `items`, or
+ * the response object itself as the row array. `total` is the total matching
+ * record count across all pages for this request. When `total > data.length`,
+ * the current response is only one page of a larger result set.
  */
-export interface ListDataResponse {
+export interface ListDataResponse<TRecord extends Record<string, unknown> = Record<string, unknown>> {
     /**
-     * A slice of the appropriate runtime struct type containing a single page-worth of data.
-     * The actual type of objects in this array depends on the dataElementId being queried.
+     * A single page of rows for the requested data element. This is the only row array
+     * returned by getListData. Properties such as `objects`, `items`, or `list` are not
+     * part of the SDK response.
+     */
+    data: TRecord[];
+    /**
+     * The total number of matching entries across all pages for this request.
+     * If total is greater than data.length, more pages exist. A caller that is
+     * building a complete report/chart must request additional pages, use an
+     * aggregate endpoint, narrow the query with filters/key lists, or present
+     * the result as a capped/partial view.
      */
-    data: any[];
-    /** The total number of entries across all pages */
     total: number;
     /**
      * The index within the data array of the selected row.
@@ -210,8 +223,13 @@ export interface MassChangeResponse {
  * Retrieves paginated list data. Supports authenticated/public access, filtering, sorting, and binary search.
  *
  * Common usage:
+ * - Use `getListData` when you need list-specific behavior: pagination, explicit totals,
+ *   server-side sort/filter, field projection, search, selection, or bulk operations.
+ * - Do not choose `getListData` only because the task is a report. Prefer `getAccessibleObjects`
+ *   for bounded accessible-record reads without list behavior, `getRelatedObjects` when a
+ *   concrete parent key is already known, or `getAggregateData` for grouped counts/sums.
  * - For most custom-element list UIs, start with only `dataElementId`, pagination fields,
- *   and `displayFields`.
+ *   and `fields`.
  * - Omit `parentDataElementId` and `parentKey` when you want the records the current user
  *   can already access.
  * - Add `parentDataElementId` and `parentKey` only when the list must be anchored to a
@@ -219,48 +237,77 @@ export interface MassChangeResponse {
  * - Most callers should omit `options`. Use `options.search` only for binary-search
  *   navigation scenarios, and use `options.bypassTotal` only when you explicitly do not
  *   need the total count.
+ * - For bounded report reads that genuinely need list behavior, set `pageNumber`, an explicit
+ *   `pageSize`, and `fields` for every field used in filtering, grouping, sorting,
+ *   aggregation, or rendering.
+ *
+ * Response shape:
+ * - `response.data` is the row array.
+ * - `response.total` is the total matching record count across all pages when
+ *   requested. If `response.total > response.data.length`, this response is
+ *   a page slice, not the full result set.
+ * - Do not read `response.objects`, `response.items`, or the response object itself as
+ *   the row array.
+ *
+ * Pagination guidance:
+ * - Use `response.total` to decide whether the current page covers the full
+ *   query. For page 1 with pageSize 100 and total 5,000, local aggregation over
+ *   `response.data` covers only the first 100 rows.
+ * - Do not treat a first page or large page as complete report data just because
+ *   it contains rows.
  *
  * Request shape:
  * - `dataElementId` (required): root data element to retrieve
  * - `pageNumber` / `pageSize` (optional): pagination
- * - `displayFields` (optional): fields to populate in returned objects
+ * - `fields` (optional): fields to populate in returned objects
  * - `sort` (optional): sort fields such as `[{ attributeId: 'name' }]`
  * - `filter` (optional): filter expression
  * - `parentDataElementId` / `parentKey` (optional): explicit parent scope
  *
  * @param request - List configuration including dataElementId, parentDataElementId, parentKey, pagination, sort, filter
  * @param options - Optional: isPublic, bypassTotal, search
- * @returns Promise<ListDataResponse> with data array, total count, pageNumber
+ * @returns Promise<ListDataResponse<TRecord>> with data array, total count, pageNumber
  *
  * @example
  * // Most common case: one page of records the current user can access.
- * const response = await getListData({
+ * type StudentRow = {
+ *   name: string;
+ *   studentNumber: string;
+ *   email: string;
+ *   grade: string;
+ * };
+ * const response = await getListData<StudentRow>({
  *   dataElementId: 'student',
  *   pageNumber: 1,
  *   pageSize: 10,
- *   displayFields: ['name', 'studentNumber', 'email', 'grade']
+ *   fields: ['name', 'studentNumber', 'email', 'grade']
  * });
+ * const rows = response.data;
  *
  * @example
  * // Custom element pagination with an optional sort.
- * const response = await getListData({
+ * type StudentListRow = { name: string; studentNumber: string; email: string; grade: string };
+ * const response = await getListData<StudentListRow>({
  *   dataElementId: 'student',
  *   pageNumber: currentPage,
  *   pageSize: 10,
- *   displayFields: ['name', 'studentNumber', 'email', 'grade'],
+ *   fields: ['name', 'studentNumber', 'email', 'grade'],
  *   sort: [{ attributeId: 'name' }]
  * });
+ * const rows = response.data;
  *
  * @example
  * // Explicit parent scoping when the list must be anchored to a specific parent.
- * const listData = await getListData({
+ * type CustomerRow = { firstName: string; lastName: string; email: string };
+ * const listData = await getListData<CustomerRow>({
  *   dataElementId: 'customer',
  *   parentDataElementId: 'company',
  *   parentKey: orgProxyKey,
  *   pageNumber: 1,
  *   pageSize: 50,
- *   displayFields: ['firstName', 'lastName', 'email']
+ *   fields: ['firstName', 'lastName', 'email']
  * });
+ * const rows = listData.data;
  *
  * @example
  * // options is rarely needed; omit it unless you need one of these behaviors.
@@ -269,7 +316,7 @@ export interface MassChangeResponse {
  *     dataElementId: 'student',
  *     pageNumber: 1,
  *     pageSize: 10,
- *     displayFields: ['name']
+ *     fields: ['name']
  *   },
  *   {
  *     search: {
@@ -280,7 +327,7 @@ export interface MassChangeResponse {
  *   }
  * );
  */
-export declare function getListData(request: PagedListDataRequest, options?: ListDataOptions): Promise<ListDataResponse>;
+export declare function getListData<TRecord extends Record<string, unknown> = Record<string, unknown>>(request: PagedListDataRequest, options?: ListDataOptions): Promise<ListDataResponse<TRecord>>;
 /**
  * Observable version of getListData. See getListData for details.
  *
@@ -288,7 +335,7 @@ export declare function getListData(request: PagedListDataRequest, options?: Lis
  * getListDataAsObservable({ dataElementId: 'customer', parentDataElementId: 'company', parentKey: orgProxyKey })
  *   .subscribe(response => console.log(response.data));
  */
-export declare function getListDataAsObservable(request: PagedListDataRequest, options?: ListDataOptions): Observable<ListDataResponse>;
+export declare function getListDataAsObservable<TRecord extends Record<string, unknown> = Record<string, unknown>>(request: PagedListDataRequest, options?: ListDataOptions): Observable<ListDataResponse<TRecord>>;
 /**
  * Bulk update multiple records. The dataRequest defines security scope; only records within that scope can be updated.
  * Use valueType 'literal' to set a value, or 'property' to copy from another field.

package/lib/esm/types/sdk-general.d.ts

@@ -103,12 +103,35 @@ export interface NotificationConfig {
     notificationDefinitionId: string;
     /** The key of the organization proxy */
     organizationProxyKey: string;
+    /** The object type of the organization proxy; allows notification dispatch to resolve the owning organization efficiently. */
+    organizationProxyType?: string;
     /** The object type of the data associated with the notification */
     dataObjectType: string;
     /** The key of the data object associated with the notification */
     dataObjectKey: string;
     /** The parameters to pass to the notification */
     params: Record<string, any>;
+    /** Correlates generated notification history with a payment reminder or other producer-owned source. */
+    reminderKey?: string;
+    /** When true, render/log recipients but skip actual channel dispatch and quota tracking. */
+    previewMode?: boolean;
+    /** Outstanding balance copied to generated recipient history rows. */
+    totalOutstandingAmount?: number;
+    /** Per-send email content override. `summary` is used as the email subject. */
+    emailContentOverride?: {
+        summary?: string;
+        content?: string;
+        html?: string;
+    };
+    /** Per-send SMS content override. */
+    smsContentOverride?: {
+        content?: string;
+    };
+    /** Per-send push content override. `summary` is used as the push title. */
+    pushContentOverride?: {
+        summary?: string;
+        content?: string;
+    };
     emailConfig?: {
         /** The type of user proxy to send the email to */
         recipientUserProxyType: string;
@@ -122,6 +145,8 @@ export interface NotificationConfig {
         replyEmailAddress?: string;
         /** The email address to send the email to; use when sending emails to non-user proxies/free-form email addresses; can contain a comma-separated list of email addresses */
         recipientEmail?: string;
+        /** Optional BCC address(es); comma-separated list allowed. Envelope-only. */
+        bccEmail?: string;
     };
     smsConfig?: {
         /** The type of user proxy to send the SMS to */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@halix/action-sdk",
-  "version": "1.0.51",
+  "version": "1.0.52",
   "description": "Halix Platform action SDK",
   "types": "./lib/cjs/types/index.d.ts",
   "main": "./lib/cjs/index.js",