@halix/action-sdk 1.0.24 → 1.0.25

package/lib/cjs/content.js

@@ -44,18 +44,9 @@ const sdk_general_1 = require("./sdk-general");
 // CONTENT RESOURCE FUNCTIONS
 // ================================================================================
 /**
- * getOrCreateResource retrieves an existing content resource by its key, or creates a new one
- * if the key is not provided. If a resource key is provided, it attempts to fetch the existing
- * resource from the server. If no key is provided, it creates a new resource with the specified
- * properties.
+ * Retrieves an existing content resource by key, or creates a new one if key is null.
  *
- * @param resourceKey - Optional key of the existing resource to retrieve
- * @param fileToUpload - Optional file or blob to upload
- * @param publicFlag - Whether the resource should be public
- * @param resourceType - The type of resource
- * @param tags - Array of tags for the resource
- *
- * @returns Promise resolving to a ContentResource
+ * @returns Promise<ContentResource>
  */
 function getOrCreateResource(resourceKey, fileToUpload, publicFlag, resourceType, tags) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -96,29 +87,15 @@ function getOrCreateResource(resourceKey, fileToUpload, publicFlag, resourceType
     });
 }
 /**
- * getOrCreateResourceAsObservable retrieves an existing content resource by its key, or creates a new one
- * if the key is not provided. If a resource key is provided, it attempts to fetch the existing
- * resource from the server. If no key is provided, it creates a new resource with the specified
- * properties.
- *
- * @param resourceKey - Optional key of the existing resource to retrieve
- * @param fileToUpload - Optional file or blob to upload
- * @param publicFlag - Whether the resource should be public
- * @param resourceType - The type of resource
- * @param tags - Array of tags for the resource
- *
- * @returns Observable resolving to a ContentResource
+ * Observable version of getOrCreateResource. See getOrCreateResource for details.
  */
 function getOrCreateResourceAsObservable(resourceKey, fileToUpload, publicFlag, resourceType, tags) {
     return (0, rxjs_1.from)(getOrCreateResource(resourceKey, fileToUpload, publicFlag, resourceType, tags));
 }
 /**
- * saveResource saves a content resource to the server. The resource is saved with appropriate
- * ownership parameters based on the current context (solution builder vs regular organization view).
+ * Saves a content resource with appropriate ownership based on context (solution builder vs org view).
  *
- * @param resource - The ContentResource to save
- *
- * @returns Promise resolving to the saved ContentResource
+ * @returns Promise<ContentResource>
  */
 function saveResource(resource) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -146,25 +123,15 @@ function saveResource(resource) {
     });
 }
 /**
- * saveResourceAsObservable saves a content resource to the server. The resource is saved with appropriate
- * ownership parameters based on the current context (solution builder vs regular organization view).
- *
- * @param resource - The ContentResource to save
- *
- * @returns Observable resolving to the saved ContentResource
+ * Observable version of saveResource. See saveResource for details.
  */
 function saveResourceAsObservable(resource) {
     return (0, rxjs_1.from)(saveResource(resource));
 }
 /**
- * sendFileContents uploads file contents to the server for a specific resource. The file is uploaded
- * via FormData with the appropriate scope and public flag settings.
+ * Uploads file contents to a resource via FormData.
  *
- * @param resourceKey - The key of the resource to upload file contents for
- * @param fileToUpload - The file or blob to upload
- * @param publicFlag - Whether the file should be public
- *
- * @returns Promise resolving to true if upload was successful
+ * @returns Promise<boolean> - true if successful
  */
 function sendFileContents(resourceKey, fileToUpload, publicFlag) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -188,30 +155,15 @@ function sendFileContents(resourceKey, fileToUpload, publicFlag) {
     });
 }
 /**
- * sendFileContentsAsObservable uploads file contents to the server for a specific resource. The file is uploaded
- * via FormData with the appropriate scope and public flag settings.
- *
- * @param resourceKey - The key of the resource to upload file contents for
- * @param fileToUpload - The file or blob to upload
- * @param publicFlag - Whether the file should be public
- *
- * @returns Observable resolving to true if upload was successful
+ * Observable version of sendFileContents. See sendFileContents for details.
  */
 function sendFileContentsAsObservable(resourceKey, fileToUpload, publicFlag) {
     return (0, rxjs_1.from)(sendFileContents(resourceKey, fileToUpload, publicFlag));
 }
 /**
- * createOrUpdateResource creates a new content resource or updates an existing one, then uploads
- * the file contents to that resource. If a resourceKey is provided, it updates the existing resource;
- * otherwise, it creates a new resource and uploads the file to the newly created resource.
+ * Creates or updates a content resource and uploads file contents. If resourceKey is provided, updates existing; otherwise creates new.
  *
- * @param resourceKey - Optional key of the existing resource to update; if not provided, a new resource is created
- * @param fileToUpload - The file or blob to upload
- * @param publicFlag - Whether the resource should be public
- * @param resourceType - The type of resource
- * @param tags - Array of tags for the resource
- *
- * @returns Promise resolving to the ContentResource with uploaded file
+ * @returns Promise<ContentResource> with uploaded file metadata
  */
 function createOrUpdateResource(resourceKey, fileToUpload, publicFlag, resourceType, tags) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -240,17 +192,7 @@ function createOrUpdateResource(resourceKey, fileToUpload, publicFlag, resourceT
     });
 }
 /**
- * createOrUpdateResourceAsObservable creates a new content resource or updates an existing one, then uploads
- * the file contents to that resource. If a resourceKey is provided, it updates the existing resource;
- * otherwise, it creates a new resource and uploads the file to the newly created resource.
- *
- * @param resourceKey - Optional key of the existing resource to update; if not provided, a new resource is created
- * @param fileToUpload - The file or blob to upload
- * @param publicFlag - Whether the resource should be public
- * @param resourceType - The type of resource
- * @param tags - Array of tags for the resource
- *
- * @returns Observable resolving to the ContentResource with uploaded file
+ * Observable version of createOrUpdateResource. See createOrUpdateResource for details.
  */
 function createOrUpdateResourceAsObservable(resourceKey, fileToUpload, publicFlag, resourceType, tags) {
     return (0, rxjs_1.from)(createOrUpdateResource(resourceKey, fileToUpload, publicFlag, resourceType, tags));

package/lib/cjs/data-crud.js

@@ -49,13 +49,9 @@ const sdk_general_1 = require("./sdk-general");
 // DATA RETRIEVAL FUNCTIONS
 // ================================================================================
 /**
- * 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
  */
 function getObject(dataElementId, key, fetchedRelationships) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -83,42 +79,20 @@ function getObject(dataElementId, key, fetchedRelationships) {
     });
 }
 /**
- * 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.
  */
 function getObjectAsObservable(dataElementId, key, fetchedRelationships) {
     return (0, rxjs_1.from)(getObject(dataElementId, key, fetchedRelationships));
 }
 /**
- * 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[]>
  */
 function getRelatedObjects(parentElementId, parentKey, elementId, filter, fetchedRelationships) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -149,29 +123,7 @@ function getRelatedObjects(parentElementId, parentKey, elementId, filter, fetche
     });
 }
 /**
- * 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.
  */
 function getRelatedObjectsAsObservable(parentElementId, parentKey, elementId, filter, fetchedRelationships) {
     return (0, rxjs_1.from)(getRelatedObjects(parentElementId, parentKey, elementId, filter, fetchedRelationships));
@@ -180,20 +132,11 @@ function getRelatedObjectsAsObservable(parentElementId, parentKey, elementId, fi
 // DATA SAVE FUNCTIONS
 // ================================================================================
 /**
- * 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
  */
 function saveRelatedObject(parentElementId, parentKey, elementId, objectToSave, opts) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -218,20 +161,7 @@ function saveRelatedObject(parentElementId, parentKey, elementId, objectToSave,
     });
 }
 /**
- * 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.
  */
 function saveRelatedObjectAsObservable(parentElementId, parentKey, elementId, objectToSave, opts) {
     return (0, rxjs_1.from)(saveRelatedObject(parentElementId, parentKey, elementId, objectToSave, opts));
@@ -240,14 +170,9 @@ function saveRelatedObjectAsObservable(parentElementId, parentKey, elementId, ob
 // DATA DELETE FUNCTIONS
 // ================================================================================
 /**
- * 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
  */
 function deleteRelatedObject(parentElementId, parentKey, childElementId, childKey) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -269,27 +194,16 @@ function deleteRelatedObject(parentElementId, parentKey, childElementId, childKe
     });
 }
 /**
- * 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.
  */
 function deleteRelatedObjectAsObservable(parentElementId, parentKey, childElementId, childKey) {
     return (0, rxjs_1.from)(deleteRelatedObject(parentElementId, parentKey, childElementId, childKey));
 }
 /**
- * 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
  */
 function deleteRelatedObjects(parentElementId, parentKey, childElementId, childKeys) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -312,14 +226,7 @@ function deleteRelatedObjects(parentElementId, parentKey, childElementId, childK
     });
 }
 /**
- * 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.
  */
 function deleteRelatedObjectsAsObservable(parentElementId, parentKey, childElementId, childKeys) {
     return (0, rxjs_1.from)(deleteRelatedObjects(parentElementId, parentKey, childElementId, childKeys));

package/lib/cjs/index.js

@@ -8,7 +8,7 @@
 // Unauthorized use outside the Halix platform is prohibited.
 // Full license terms available in the LICENSE file.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.debounceFn = exports.getValueFromObject = exports.compareValues = exports.sortObjectArray = exports.massDeleteAsObservable = exports.massDelete = exports.massEditAsObservable = exports.massEdit = exports.getListDataAsObservable = exports.getListData = exports.sendMessageAsObservable = exports.sendMessage = exports.MessageMethod = exports.createOrUpdateResourceAsObservable = exports.createOrUpdateResource = exports.sendFileContentsAsObservable = exports.sendFileContents = exports.saveResourceAsObservable = exports.saveResource = exports.getOrCreateResourceAsObservable = exports.getOrCreateResource = exports.deleteRelatedObjectsAsObservable = exports.deleteRelatedObjects = exports.deleteRelatedObjectAsObservable = exports.deleteRelatedObject = exports.saveRelatedObjectAsObservable = exports.saveRelatedObject = exports.getRelatedObjectsAsObservable = exports.getRelatedObjects = exports.getObjectAsObservable = exports.getObject = exports.prepareErrorResponse = exports.prepareSuccessResponse = exports.initialize = exports.useBody = exports.params = exports.userContext = exports.actionSubject = exports.serviceAddress = exports.sandboxKey = exports.getAuthToken = void 0;
+exports.debounceFn = exports.getValueFromObject = exports.compareValues = exports.sortObjectArray = exports.massDeleteAsObservable = exports.massDelete = exports.massEditAsObservable = exports.massEdit = exports.getListDataAsObservable = exports.getListData = exports.getPreferenceAsObservable = exports.getPreference = exports.sendMessageAsObservable = exports.sendMessage = exports.MessageMethod = exports.createOrUpdateResourceAsObservable = exports.createOrUpdateResource = exports.sendFileContentsAsObservable = exports.sendFileContents = exports.saveResourceAsObservable = exports.saveResource = exports.getOrCreateResourceAsObservable = exports.getOrCreateResource = exports.deleteRelatedObjectsAsObservable = exports.deleteRelatedObjects = exports.deleteRelatedObjectAsObservable = exports.deleteRelatedObject = exports.saveRelatedObjectAsObservable = exports.saveRelatedObject = exports.getRelatedObjectsAsObservable = exports.getRelatedObjects = exports.getObjectAsObservable = exports.getObject = exports.prepareErrorResponse = exports.prepareSuccessResponse = exports.initialize = exports.useBody = exports.params = exports.userContext = exports.actionSubject = exports.serviceAddress = exports.sandboxKey = exports.getAuthToken = void 0;
 /**
  * @module @halix/action-sdk
  * @description Halix Platform action SDK for developing NodeJS Lambda-based actions on the Halix
@@ -71,6 +71,13 @@ Object.defineProperty(exports, "MessageMethod", { enumerable: true, get: functio
 Object.defineProperty(exports, "sendMessage", { enumerable: true, get: function () { return messaging_1.sendMessage; } });
 Object.defineProperty(exports, "sendMessageAsObservable", { enumerable: true, get: function () { return messaging_1.sendMessageAsObservable; } });
 // ================================================================================
+// PREFERENCE FUNCTIONS
+// ================================================================================
+var preferences_1 = require("./preferences");
+// Preference Functions
+Object.defineProperty(exports, "getPreference", { enumerable: true, get: function () { return preferences_1.getPreference; } });
+Object.defineProperty(exports, "getPreferenceAsObservable", { enumerable: true, get: function () { return preferences_1.getPreferenceAsObservable; } });
+// ================================================================================
 // LIST DATA FUNCTIONS
 // ================================================================================
 var lists_1 = require("./lists");

package/lib/cjs/lists.js

@@ -34,6 +34,7 @@ exports.massDeleteAsObservable = massDeleteAsObservable;
  *
  * Key features:
  * - Efficient retrieval of one page of data at a time
+ * - Supports related object retrieval
  * - Pagination
  * - Sorting
  * - Filtering
@@ -48,24 +49,13 @@ const sdk_general_1 = require("./sdk-general");
 // LIST DATA RETRIEVAL FUNCTIONS
 // ================================================================================
 /**
- * getListData retrieves list data from the Halix platform. This function can operate in four
- * different modes based on the provided options:
+ * Retrieves paginated list data. Supports authenticated/public access, filtering, sorting, and binary search.
  *
- * 1. Authenticated list data retrieval (default)
- * 2. Public list data retrieval (when isPublic is true)
- * 3. Authenticated list data with search (when search options are provided)
- * 4. Public list data with search (when both isPublic and search options are provided)
- *
- * The search functionality uses binary search to efficiently locate items in a sorted list by
- * a specific attribute value.
- *
- * @param request - The list data request containing list configuration and parameters
- * @param options - Optional configuration for the request
- *
- * @returns Promise resolving to the list data response
+ * @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
  *
  * @example
- * // Basic authenticated list data retrieval
  * const listData = await getListData({
  *   dataElementId: 'customer',
  *   parentDataElementId: 'company',
@@ -74,35 +64,6 @@ const sdk_general_1 = require("./sdk-general");
  *   pageSize: 50,
  *   displayFields: ['firstName', 'lastName', 'email']
  * });
- * console.log('Total customers:', listData.total);
- * console.log('Page:', listData.pageNumber);
- * console.log('Data:', listData.data);
- *
- * @example
- * // Public list data retrieval without authentication
- * const publicData = await getListData({
- *   dataElementId: 'product',
- *   parentDataElementId: 'catalog',
- *   parentKey: orgProxyKey,
- *   pageNumber: 1,
- *   pageSize: 20
- * }, { isPublic: true });
- *
- * @example
- * // List data retrieval with binary search
- * const searchData = await getListData({
- *   dataElementId: 'purchases',
- *   parentDataElementId: 'customer',
- *   parentKey: userProxyKey,
- *   sort: [{ attributeId: 'invoiceNumber', descending: false }]
- * }, {
- *   search: {
- *     attributeId: 'invoiceNumber',
- *     value: 'INV-123456',
- *     total: 1000
- *   }
- * });
- * console.log('Selected row index:', searchData.selectedRow);
  */
 function getListData(request, options) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -159,27 +120,11 @@ function getListData(request, options) {
     });
 }
 /**
- * getListDataAsObservable retrieves list data from the Halix platform as an Observable. This
- * function operates in the same four modes as getListData.
- *
- * @param request - The list data request containing list configuration and parameters
- * @param options - Optional configuration for the request
- *
- * @returns Observable resolving to the list data response
+ * Observable version of getListData. See getListData for details.
  *
  * @example
- * // Basic authenticated list data retrieval as Observable
- * getListDataAsObservable({
- *   dataElementId: 'customer',
- *   parentDataElementId: 'company',
- *   parentKey: userContext.orgProxyKey,
- *   pageNumber: 1,
- *   pageSize: 50
- * }).subscribe(response => {
- *   console.log('Total customers:', response.total);
- *   console.log('Page:', response.pageNumber);
- *   console.log('Data:', response.data);
- * });
+ * getListDataAsObservable({ dataElementId: 'customer', parentDataElementId: 'company', parentKey: orgProxyKey })
+ *   .subscribe(response => console.log(response.data));
  */
 function getListDataAsObservable(request, options) {
     return (0, rxjs_1.from)(getListData(request, options));
@@ -188,51 +133,21 @@ function getListDataAsObservable(request, options) {
 // MASS EDIT AND DELETE FUNCTIONS
 // ================================================================================
 /**
- * massEdit performs a bulk update operation on multiple records. This function allows you to
- * update a specific property on multiple objects in a single request.
- *
- * **Security Scoping**: The dataRequest serves as a security boundary. Only records that would
- * be returned by the dataRequest can be updated. The keys array must reference records within
- * this scope. This allows efficient security validation without checking each record individually.
- *
- * The value can be set in two ways based on valueType:
- * - 'literal': Set the property to a literal value
- * - 'property': Copy the value from another property on the same object
- *
- * @param request - The mass edit request specifying what to update and how
+ * 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.
  *
- * @returns Promise resolving to statistics about the operation
+ * @param request - keys[], dataRequest (scope), dataElementId, property, valueType, value
+ * @returns Promise<MassChangeResponse> with tried/succeeded/failed counts
  *
  * @example
- * // Update the status of multiple orders to 'shipped'
  * const result = await massEdit({
- *   keys: ['order-123', 'order-456', 'order-789'],
- *   dataRequest: {
- *     dataElementId: 'order',
- *     parentDataElementId: 'company',
- *     parentKey: orgProxyKey
- *   },
+ *   keys: ['order-123', 'order-456'],
+ *   dataRequest: { dataElementId: 'order', parentDataElementId: 'company', parentKey: orgProxyKey },
  *   dataElementId: 'order',
  *   property: 'status',
  *   valueType: 'literal',
  *   value: 'shipped'
  * });
- * console.log(`Updated ${result.succeeded} of ${result.tried} orders`);
- *
- * @example
- * // Copy shipping address to billing address for multiple customers
- * const result = await massEdit({
- *   keys: selectedCustomerKeys,
- *   dataRequest: {
- *     dataElementId: 'customer',
- *     parentDataElementId: 'company',
- *     parentKey: orgProxyKey
- *   },
- *   dataElementId: 'customer',
- *   property: 'billingAddress',
- *   valueType: 'property',
- *   value: 'shippingAddress'
- * });
  */
 function massEdit(request) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -254,75 +169,24 @@ function massEdit(request) {
     });
 }
 /**
- * massEditAsObservable performs a bulk update operation on multiple records, returning an Observable.
- * See massEdit for detailed documentation.
- *
- * @param request - The mass edit request specifying what to update and how
- *
- * @returns Observable resolving to statistics about the operation
- *
- * @example
- * massEditAsObservable({
- *   keys: ['order-123', 'order-456'],
- *   dataRequest: {
- *     dataElementId: 'order',
- *     parentDataElementId: 'company',
- *     parentKey: orgProxyKey
- *   },
- *   dataElementId: 'order',
- *   property: 'status',
- *   valueType: 'literal',
- *   value: 'shipped'
- * }).subscribe(result => {
- *   console.log(`Updated ${result.succeeded} of ${result.tried} orders`);
- * });
+ * Observable version of massEdit. See massEdit for details.
  */
 function massEditAsObservable(request) {
     return (0, rxjs_1.from)(massEdit(request));
 }
 /**
- * massDelete performs a bulk delete operation on multiple records. This function allows you to
- * soft-delete multiple objects in a single request.
- *
- * **Security Scoping**: The dataRequest serves as a security boundary. Only records that would
- * be returned by the dataRequest can be deleted. The keys array must reference records within
- * this scope. This allows efficient security validation without checking each record individually.
- *
- * If emptyList is set to true, all records returned by the dataRequest will be deleted,
- * ignoring the keys array.
- *
- * @param request - The mass delete request specifying what to delete
+ * Bulk soft-delete multiple records. The dataRequest defines security scope; only records within that scope can be deleted.
+ * Set emptyList: true to delete all records matching dataRequest (ignores keys array).
  *
- * @returns Promise resolving to statistics about the operation
+ * @param request - keys[], dataRequest (scope), dataElementId, emptyList?
+ * @returns Promise<MassChangeResponse> with tried/succeeded/failed counts
  *
  * @example
- * // Delete specific orders
  * const result = await massDelete({
- *   keys: ['order-123', 'order-456', 'order-789'],
- *   dataRequest: {
- *     dataElementId: 'order',
- *     parentDataElementId: 'company',
- *     parentKey: orgProxyKey,
- *     filter: { field: 'status', operator: '==', value: 'cancelled' }
- *   },
+ *   keys: ['order-123', 'order-456'],
+ *   dataRequest: { dataElementId: 'order', parentDataElementId: 'company', parentKey: orgProxyKey },
  *   dataElementId: 'order'
  * });
- * console.log(`Deleted ${result.succeeded} of ${result.tried} orders`);
- *
- * @example
- * // Delete all records matching the filter
- * const result = await massDelete({
- *   keys: [],
- *   dataRequest: {
- *     dataElementId: 'tempRecord',
- *     parentDataElementId: 'company',
- *     parentKey: orgProxyKey,
- *     filter: { field: 'createdDate', operator: '<', value: '2023-01-01' }
- *   },
- *   dataElementId: 'tempRecord',
- *   emptyList: true
- * });
- * console.log(`Deleted ${result.succeeded} old records`);
  */
 function massDelete(request) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -344,25 +208,7 @@ function massDelete(request) {
     });
 }
 /**
- * massDeleteAsObservable performs a bulk delete operation on multiple records, returning an Observable.
- * See massDelete for detailed documentation.
- *
- * @param request - The mass delete request specifying what to delete
- *
- * @returns Observable resolving to statistics about the operation
- *
- * @example
- * massDeleteAsObservable({
- *   keys: ['order-123', 'order-456'],
- *   dataRequest: {
- *     dataElementId: 'order',
- *     parentDataElementId: 'company',
- *     parentKey: orgProxyKey
- *   },
- *   dataElementId: 'order'
- * }).subscribe(result => {
- *   console.log(`Deleted ${result.succeeded} of ${result.tried} orders`);
- * });
+ * Observable version of massDelete. See massDelete for details.
  */
 function massDeleteAsObservable(request) {
     return (0, rxjs_1.from)(massDelete(request));