v.2.2.0

.github/README.md

@@ -356,7 +356,7 @@ continueOnError | `boolean` | `executeBatch` | **BATCH REQUESTS ONLY!** Sets Pre
 count | `boolean` | `retrieveMultiple`, `retrieveAll` | Boolean that sets the $count system query option with a value of true to include a count of entities that match the filter criteria up to 5000 (per page). Do not use $top with $count!
 data | `Object` or `ArrayBuffer` / `Buffer` (for node.js) | `create`, `update`, `upsert`, `uploadFile` | A JavaScript object that represents Dynamics 365 entity, action, metadata and etc. 
 duplicateDetection | `boolean` | `create`, `update`, `upsert` | **D365 Web API v9+** Boolean that enables duplicate detection. [More Info](https://docs.microsoft.com/en-us/dynamics365/customer-engagement/developer/webapi/update-delete-entities-using-web-api#check-for-duplicate-records)
-expand | `Expand[]` | `retrieve`, `retrieveMultiple`, `create`, `update`, `upsert` | An array of `Expand` Objects (described below the table) representing the $expand OData System Query Option value to control which related records are also returned.
+expand | `string` or `Expand[]` | `retrieve`, `retrieveMultiple`, `create`, `update`, `upsert` | An array of `Expand` Objects (described below the table) representing the $expand OData System Query Option value to control which related records are also returned.
 fetchXml | `string` | `fetch`, `fetchAll` | Property that sets FetchXML - a proprietary query language that provides capabilities to perform aggregation.
 fieldName | `string` | `uploadFile`, `downloadFile`, `deleteRecord` | **D365 Web API v9.1+. Deprecated, use `property` instead** Use this option to specify the name of the file attribute in Dynamics 365. [More Info](https://docs.microsoft.com/en-us/powerapps/developer/common-data-service/file-attributes)
 fileName | `string` | `uploadFile` | **D365 Web API v9.1+** Specifies the name of the file
@@ -398,7 +398,7 @@ The following table describes `Expand` Object properties:
 
 Property Name | Type | Description
 ------------ | ------------- | -------------
-expand | `Expand[]` | An array of `Expand` Objects representing the $expand OData System Query Option value to control which related records are also returned.
+expand | `Expand[]` | An array of `Expand` Objects representing the $expand OData System Query Option value to control which related records are also returned. Can also accept a string.
 filter | `string` | Use the $filter system query option to set criteria for which related entities will be returned.
 orderBy | `string[]` | An Array (of strings) representing the order in which related items are returned using the $orderby system query option. Use the asc or desc suffix to specify ascending or descending order respectively. The default is ascending if the suffix isn't applied.
 property | `string` | A name of a single-valued navigation property which needs to be expanded.
@@ -2534,7 +2534,7 @@ the config option "formatted" will enable developers to retrieve all information
 - [X] Implement [Dataverse Search API 1.0](https://learn.microsoft.com/en-us/power-apps/developer/data-platform/search/legacy). `Added in v.2.0.0`
 - [X] Allow custom headers to be passed to the request [#151](https://github.com/AleksandrRogov/DynamicsWebApi/issues/151). `Added in v.2.1.0`
 - [X] Support Microsoft Power Pages. `Added in v.2.1.0`
-- [ ] Support Search API 2.0 [#174](https://github.com/AleksandrRogov/DynamicsWebApi/issues/174). `Coming with v.2.2.0`
+- [ ] Support Search API 2.0 [#174](https://github.com/AleksandrRogov/DynamicsWebApi/issues/174). `Coming with v.2.3.0`
 - [ ] Custom requests.
 
 Many more features to come!

.github/workflows/build-test-coverage.yml

@@ -16,7 +16,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [16.x, 18.x, 20.x, 22.x]
+        node-version: [18.x, 20.x, 22.x, 23.x]
 
     steps:
     - uses: actions/checkout@v4

.mocharc.js

@@ -1,6 +1,6 @@
 module.exports = {
     diff: true,
-    extension: ["ts", "js"],
-    require: "ts-node/register",
-    spec: ["tests/*.spec.js", "tests/*.spec.ts"],
+    extension: ["ts"],
+    require: "tsx",
+    spec: ["tests/*.spec.ts"],
 };

dist/dynamics-web-api.d.ts

@@ -1,4 +1,4 @@
-/*! dynamics-web-api v2.1.7 (c) 2024 Aleksandr Rogov. License: MIT */
+/*! dynamics-web-api v2.2.0 (c) 2025 Aleksandr Rogov. License: MIT */
 /**
  * Microsoft Dataverse Web API helper library for Node.js and Browser.
  * It is compatible with: Dataverse, Dynamics 365 (online), Dynamics 365 (on-premise), Dynamics CRM 2016, Dynamics CRM Online.
@@ -442,8 +442,8 @@ export interface CreateRequest<T = any> extends CRUDRequest {
     duplicateDetection?: boolean;
     /**A JavaScript object with properties corresponding to the logical name of entity attributes(exceptions are lookups and single-valued navigation properties). */
     data?: T;
-    /**An array of Expand Objects(described below the table) representing the $expand OData System Query Option value to control which related records are also returned. */
-    expand?: Expand[];
+    /**An array of Expand Objects representing the $expand OData System Query Option value to control which related records are also returned. Can also accept a string. */
+    expand?: string | Expand[];
     /**Sets Prefer header with value "odata.include-annotations=" and the specified annotation.Annotations provide additional information about lookups, options sets and other complex attribute types. */
     includeAnnotations?: string;
     /**A String representing the name of a single - valued navigation property. Useful when needed to retrieve information about a related record in a single request. */