@nomad-media/full 1.1.20-alpha.0 → 1.1.23

package/README.md

@@ -1,17 +1,26 @@
-# Nomad Media Full
-This package contains the full version of the Nomad Media SDK. It includes all the methods of the SDK.
+## Prerequisites
 
-## Minimum Requirements
-- Node.js 12.0.0
+- Node package manager (npm).
 
-## Installation
-To use the Nomad SDK, download the npm nomad-media-npm.
+> 📘 Note
+> 
+> You can download npm [here](https://nodejs.org/en/download).
 
+## Setup
+
+To use the Nomad SDK, download the @nomad-media npm. There are two versions, the full version which includes all of the Nomad-Media endpoints, and the public version which only includes the media endpoints.
+
+To install the full version, use the following command:
 ```shell
 npm install @nomad-media/full
 ```
 
-Then to import it, you can either use the default version, or the debug version. The difference is that the debug version isn't compressed and has more documentation and named parameters.
+To install the public version, use the following command:
+```shell
+npm install @nomad-media/public
+```
+
+Then to import it, you can either use the default version, or the debug version. The difference is that the debug version isn't compressed and has more documentation and named parameters. Both full and public have a debug version. Currently the debug version's tooltips don't show up. This is an issue with npm.
 
 To use the default version use:
 
@@ -31,6 +40,10 @@ To initialize the sdk, call the NomadMediaSDK class as shown below:
 const SDK = NomadMediaSDK(config);
 ```
 
+## Logging in
+
+To log in to the sdk, in the config, enter the username/email of your user. Then enter your api key if you are using an api key, or your password.
+
 ## Configure Environmental Variables
 
 Follow this format for the config:
@@ -39,24 +52,42 @@ Follow this format for the config:
 const config = {
     "username": "username",
     "password": "password",
+    "apiKey": "apiKey",
     "serviceApiUrl": "serverApiUrl",
     "apiType": "admin",
-    "debugMode": true
+    "debugMode": true,
+    "singleton": false
 };
 ```
-serviceApiUrl: Specifies the url of the server you are trying to connect to.
 
 apiType: Specifies whether the function you are trying to run is **admin** or **portal**.
 
 debugMode: Specifies when running functions, whether of not to print api call information.
 
+singleton: Whether or not to only create one class instance.
+
+Place the config in a file called config.js and import it into your project.
+
 You are now ready to use the SDK in your project.
 
 > 📘 Contact: Make sure to contact Nomad Media support to get username, password, and url for your enviromnent.
 
 > 🚧 Make sure to keep your configuration options secret and do not share them publicly.
 
-## Nomad SDK Documentation
+## Upgrading NPM
+
+To upgrade the npm, use the following command:
+
+```shell
+npm update @nomad-media/full
+```
+
+## Nomad SDK References
+
+An overview of all of the Nomad SDK methods. Includes prameter details for the methods. Scroll down to the Nomad SDK section.
+
+[Nomad SDK References](https://developer.nomad-cms.com/reference)
+
+## Nomad SDK NPM Samples
 
-- [Nomad SDK Modules](https://developer.nomad-cms.com/docs/nomad-api-modules)
-- [Nomad SDK NPM Samples](https://github.com/Nomad-Media/samples-js)
+[Nomad SDK NPM Samples](https://github.com/Nomad-Media/samples-js)

package/dist/nomad-media-sdk-debug.js

@@ -317,7 +317,10 @@ class NomadMediaSDK {
      */
     async _init() 
     {
-        await this.login();
+        if (this.config.username && this.config.password)
+        {
+            await this.login();
+        }
     }
     
     // account functions
@@ -498,12 +501,14 @@ class NomadMediaSDK {
      * This is ignored if the ExistingAssetId or if the RelatedContentId has a value.
      * @param {string | null} LANGUAGE_ID - The language of the asset to upload. 
      * If this is left blank then the default system language is used.
+     * @param {Array<String> | null} UPLOAD_REPLACE_OPTIONS - Gets or sets if the asset already 
+     * exists on the server, this decides how to handle the situation with related assets.
      * @returns {Promise<string>} - A promise that resolves when the asset is uploaded.
      * Returns the content ID of the uploaded asset.
      * @throws {Error} - An error is thrown if the asset fails to upload.
      */  
     async uploadAsset(NAME, EXISTING_ASSET_ID, RELATED_CONTENT_ID, 
-        UPLOAD_OVERWRITE_OPTION, FILE, PARENT_ID, LANGUAGE_ID)
+        UPLOAD_OVERWRITE_OPTION, FILE, PARENT_ID, LANGUAGE_ID, UPLOAD_REPLACE_OPTIONS)
     {
         if (this.token === null)
         {
@@ -525,7 +530,7 @@ class NomadMediaSDK {
             _printDatetime("Starting upload");
             startUploadInfo = await _startUpload(this, NAME, EXISTING_ASSET_ID, 
                 RELATED_CONTENT_ID, UPLOAD_OVERWRITE_OPTION, FILE_PROPS, PARENT_ID, 
-                LANGUAGE_ID);
+                LANGUAGE_ID, UPLOAD_REPLACE_OPTIONS);
 
             if (!startUploadInfo) throw new Error("Failed to start upload");
 
@@ -565,59 +570,41 @@ class NomadMediaSDK {
      * The option you want to use when uploading the asset. The options are continue, replace, 
      * and cancel. Continue continues the upload from where it left off. Replace replaces an 
      * existing asset. Replace is the one you want to use if you are starting a new upload. 
-     * @param {FILE | string | null} FILE - The FILE object or full or relative path of the file to upload. 
+     * @param {FILE | string} FILE - The FILE object or full or relative path of the file to upload. 
      * This is ignored if the ExistingAssetId or if the RelatedContentId has a value
      * @param {string | null} LANGUAGE_ID - The language of the asset to upload.
      * If this is left blank then the default system language is used.
-     * @param {bytes | null} FILE_CONTENTS - The contents of the file to upload.
-     * This is used to upload the file in memory instead of from a file.
      * @returns {Promise<string>} - A promise that resolves when the related asset is uploaded.
      * Returns the content ID of the uploaded related asset.
      * @throws {Error} - An error is thrown if the related asset fails to upload.
      */
     async uploadRelatedAsset(EXISTING_ASSET_ID, RELATED_ASSET_ID, NEW_RELATED_ASSET_METADATA_TYPE,
-        UPLOAD_OVERWRITE_OPTION, FILE, LANGUAGE_ID, FILE_CONTENTS)
+        UPLOAD_OVERWRITE_OPTION, FILE, LANGUAGE_ID)
     {
         if (this.token === null)
         {
             await this._init();
         }
 
-        if (!FILE && !FILE_CONTENTS)
-        {
-            throw new Error("Either FILE or FILE_CONTENTS must be provided.");
-        }
-
         _printDatetime(`Uploading related asset`);
 
         let startUploadInfo = null;
         try
         {
-            let fileProps = null;
-            if (!FILE_CONTENTS)
-            {
-                const fileProps = await _processFile(FILE);
-                if (!fileProps)
-                {
-                    _printDatetime("File not found");
-                    return;
-                }
-            }
-            else
+            const FILE_PROPS = await _processFile(FILE);
+            if (!FILE_PROPS)
             {
-                fileProps = {
-                    originalname: FILE,
-                    size: FILE_CONTENTS.byteLength
-                };
+                _printDatetime("File not found");
+                return;
             }
 
             startUploadInfo = await _startRelatedAssetUpload(this, EXISTING_ASSET_ID, 
                 RELATED_ASSET_ID, NEW_RELATED_ASSET_METADATA_TYPE, UPLOAD_OVERWRITE_OPTION, 
-                fileProps, LANGUAGE_ID);
+                FILE_PROPS, LANGUAGE_ID);
 
             if (!startUploadInfo) throw new Error("Failed to start related asset upload");
 
-            const response = await _multiThreadUpload(this, fileProps, startUploadInfo, FILE_CONTENTS);
+            const response = await _multiThreadUpload(this, FILE_PROPS, startUploadInfo);
             if (!response) throw new Error("Failed to upload");
 
             await _completeUpload(this, startUploadInfo.id);
@@ -625,9 +612,7 @@ class NomadMediaSDK {
 
             const DETAILS = await _getAssetDetails(this, EXISTING_ASSET_ID);
 
-            const FILE_NAME = FILE_CONTENTS ? FILE : fileProps.originalName;
-
-            const ASSET_INFO = DETAILS.relatedAssets.find(asset => asset.url.includes(FILE_NAME));
+            const ASSET_INFO = DETAILS.relatedAssets.find(asset => asset.url.includes(FILE_PROPS.originalName));
             if (!ASSET_INFO) throw new Error("Asset ID not found");
             return ASSET_INFO.id;
         }
@@ -1085,14 +1070,20 @@ class NomadMediaSDK {
      * @param {string} CONTENT_ID - The ID of the content to add the custom properties to.
      * @param {string | null} NAME - The name of the content to add the custom properties to.
      * @param {string | null} DATE - The display date of the content to add to the custom properties.
-     * @param {JSON} CUSTOM_PROPERTIES - A list of custom properties that should be saved for the 
+     * @param {JSON | null} CUSTOM_PROPERTIES - A list of custom properties that should be saved for the 
      * asset. To remove a property value, set the value to null
+     * @param {string} AVAILABLE_START_DATE - Gets or sets the availability starting date of the asset 
+     * for entitlement purposes MinValue is used to differentiate between null values and missing properties 
+     * We technically want null so we can clear the date.
+     * @param {string} AVAILABLE_END_DATE - Gets or sets the availability ending date of the asset 
+     * for entitlement purposes MaxValue is used to differentiate between null values and missing properties
+     * We technically want null so we can clear the date.
      * @returns {Promise<JSON>} - A promise that resolves when the custom properties are added.
      * Returns the information of the added custom properties.
      * @throws {Error} - An error is thrown if the custom properties fail to add.
      * @throws {Error} - An error is thrown if the API type is not admin.
      */
-    async addCustomProperties(CONTENT_ID, NAME, DATE, CUSTOM_PROPERTIES)
+    async addCustomProperties(CONTENT_ID, NAME, DATE, CUSTOM_PROPERTIES, AVAILABLE_START_DATE, AVAILABLE_END_DATE)
     {
         if (this.token === null)
         {
@@ -1109,7 +1100,7 @@ class NomadMediaSDK {
         try
         {
             const ADD_CUSTOM_PROPERTIES_INFO = await _addCustomProperties(this, 
-                CONTENT_ID, NAME, DATE, CUSTOM_PROPERTIES);
+                CONTENT_ID, NAME, DATE, CUSTOM_PROPERTIES, AVAILABLE_START_DATE, AVAILABLE_END_DATE);
             if (ADD_CUSTOM_PROPERTIES_INFO) _printDatetime(`Custom properties added to content: ${CONTENT_ID}`);
             return ADD_CUSTOM_PROPERTIES_INFO;
         }
@@ -1959,7 +1950,7 @@ class NomadMediaSDK {
 	
 		try
 		{
-			await _createJob(
+			await _createJobId(
 				this, ASSET_ID, JOB_RESULTS_URL, EXTERNAL_ID);
 			_printDatetime(`Job created: ${ASSET_ID}`);
 		} catch (error) {
@@ -6599,7 +6590,7 @@ class NomadMediaSDK {
      * @async
      * @description Gets the asset manifest with cookies for the specified asset ID.
      * @param {string} ASSET_ID - The ID of the asset to get the manifest with cookies for.
-     * @param {sting} COOKIE_ID - The ID of the cookie.
+     * @param {string} COOKIE_ID - The ID of the cookie.
      * @returns {Promise<JSON>} - A promise that resolves when the asset manifest with cookies are retrieved.
      * Returns the asset manifest with cookies.
      * @throws {Error} - An error is thrown if the asset manifest with cookies fail to retrieve.
@@ -7493,13 +7484,12 @@ class NomadMediaSDK {
      * @function ping
      * @async
      * @description Pings the user.
-     * @param {string | null} APPLICATION_ID - The application ID of the user.
-     * @param {string | nul} USER_SESSION_ID - The user session ID of the user.
+     * @param {boolean | null} INCLUDE_HEADERS
      * @returns {Promise<JSON>} - A promise that resolves when the user is pinged.
      * Returns the ping status of the user.
      * @throws {Error} - An error is thrown if the user fails to ping.
      */
-    async ping(APPLICATION_ID, USER_SESSION_ID)
+    async ping(INCLUDE_HEADERS)
     {
         if (this.token === null)
         {
@@ -7510,7 +7500,7 @@ class NomadMediaSDK {
 
         try
         {
-            const PING = await _ping(this, APPLICATION_ID, USER_SESSION_ID);
+            const PING = await _ping(this, INCLUDE_HEADERS);
             if (PING) _printDatetime(`User pinged`);
             return PING;
         }
@@ -7628,7 +7618,7 @@ class NomadMediaSDK {
                 DISTINCT_ON_FIELD_NAME, INCLUDE_VIDEO_CLIPS, USE_LLM_SEARCH, 
                 INCLUDE_INTERNAL_FIELDS_IN_RESULTS);
             if (SEARCH_INFO) _printDatetime(`Search complete`);
-            return SEARCH_INFO.hasItems ? SEARCH_INFO : false
+            return SEARCH_INFO?.hasItems ? SEARCH_INFO : false
         }
         catch (error)
         {
@@ -8444,12 +8434,13 @@ class NomadMediaSDK {
      * @async
      * @description Gets media group.
      * @param {string} MEDIA_GROUP_ID - The ID of the media group.
+     * @param { Array<string> } FILTER_IDS - The IDs of the media group items to filter by.
      * @returns {Promise<JSON>} - A promise that resolves when the media group is gotten.
      * Returns the information of the gotten media group.
      * @throws {Error} - An error is thrown if the media group fails to get.
      * @throws {Error} - An error is thrown if the API type is not portal.
      */
-    async getMediaGroup(MEDIA_GROUP_ID)
+    async getMediaGroup(MEDIA_GROUP_ID, FILTER_IDS)
     {
         if (this.token === null)
         {
@@ -8465,7 +8456,7 @@ class NomadMediaSDK {
 
         try
         {
-            const GET_MEDIA_GROUP_INFO = await _getMediaGroup(this, MEDIA_GROUP_ID);
+            const GET_MEDIA_GROUP_INFO = await _getMediaGroup(this, MEDIA_GROUP_ID, FILTER_IDS);
             if (GET_MEDIA_GROUP_INFO) _printDatetime(`Media group gotten: ${MEDIA_GROUP_ID}`);
             return GET_MEDIA_GROUP_INFO;
         }
@@ -9801,22 +9792,26 @@ class NomadMediaSDK {
      * JSON format: {"id": string, "description": string }
      * @param {JSON | null} SHARED_DURATION - The shared Duration of the share. 
      * JSON format: {"id": string, "description": string }
-     * @param {Array<JSON> | null} SHARED_PERMISSION - The sharedPermissions of the share.
+     * @param {Array<JSON> | null} SHARED_PERMISSIONS - The sharedPermissions of the share.
      * JSON format: {"id": string, "description": string }
      * @param {JSON | null} SHARED_TYPE: - The sharedType of the share. 
      * JSON format: {"id": string, "description": string }
-     * @param {Array<JSON> | null} SHARED_STATUS - The sharedStatus of the share.
+     * @param {JSON | null} SHARED_STATUS - The sharedStatus of the share.
      * JSON format: {"id": string, "description": string }
      * @param {integer | null} SHARED_DURATION_IN_HOURS - The sharedDurationInHours of the share.
      * @param {string | null} SHARED_LINK - The sharedLink of the share.
      * @param {string | null} OWNER_ID - The ownerId of the share.
      * @param {string | null} EXPIRATION_DATE - The expirationDate of the share.
+     * @param {string | null} ASSET_ID - The assetId of the share.
+     * @param {Array<JSON> | null} SHARED_USERS - The sharedUsers of the share. 
+     * JSON format: {"id": string, "description": string }
      * @returns {Promise<object>}
      * @throws {Error} - An error is thrown if share fails.
      * @throws {Error} - An error is the API type is not post.
      */
     async share(ID, NAME, SHARED_CONTENTS, SHARED_DURATION, SHARED_PERMISSIONS, SHARED_TYPE, 
-        SHARED_STATUS, SHARED_DURATION_IN_HOURS, SHARED_LINK, OWNER_ID, EXPIRATION_DATE)
+        SHARED_STATUS, SHARED_DURATION_IN_HOURS, SHARED_LINK, OWNER_ID, EXPIRATION_DATE, 
+        ASSET_ID, SHARED_USERS)
     {
         if (this.token === null)
         {
@@ -9834,7 +9829,8 @@ class NomadMediaSDK {
         {
             const RESPONSE = await _share(this, ID, NAME, SHARED_CONTENTS, 
                 SHARED_DURATION, SHARED_PERMISSIONS, SHARED_TYPE, SHARED_STATUS, 
-                SHARED_DURATION_IN_HOURS, SHARED_LINK, OWNER_ID, EXPIRATION_DATE);
+                SHARED_DURATION_IN_HOURS, SHARED_LINK, OWNER_ID, EXPIRATION_DATE,
+                ASSET_ID, SHARED_USERS);
     
             _printDatetime(`Share called successfully.`);
     
@@ -9942,18 +9938,22 @@ class NomadMediaSDK {
      * JSON format: {"id": string, "description": string }
      * @param {JSON | null} SHARED_TYPE - The sharedType of the updateShare.
      * JSON format: {"id": string, "description": string }
-     * @param {Array<JSON> | null} SHARED_STATUS - The sharedStatus of the updateShare.
+     * @param {JSON | null} SHARED_STATUS - The sharedStatus of the updateShare.
      * JSON format: {"id": string, "description": string }
      * @param {integer | null} SHARED_DURATION_IN_HOURS - The sharedDurationInHours of the updateShare.
      * @param {string | null} SHARED_LINK - The sharedLink of the updateShare.
      * @param {string | null} OWNER_ID - The ownerId of the updateShare.
      * @param {string | null} EXPIRATION_DATE - The expirationDate of the updateShare.
+     * @param {string | null} ASSET_ID - The assetId of the updateShare.
+     * @param {Array<JSON> | null} SHARED_USERS - The sharedUsers of the updateShare.
+     * JSON format: {"id": string, "description": string }
      * @returns {Promise<object>}
      * @throws {Error} - An error is thrown if updateShare fails.
      * @throws {Error} - An error is the API type is not put.
      */
     async updateShare(SHARE_ID, ID, NAME, SHARED_CONTENTS, SHARED_DURATION, SHARED_PERMISSIONS, 
-        SHARED_TYPE, SHARED_STATUS, SHARED_DURATION_IN_HOURS, SHARED_LINK, OWNER_ID, EXPIRATION_DATE)
+        SHARED_TYPE, SHARED_STATUS, SHARED_DURATION_IN_HOURS, SHARED_LINK, OWNER_ID, EXPIRATION_DATE,
+        ASSET_ID, SHARED_USERS)
     {
         if (this.token === null)
         {
@@ -9972,7 +9972,7 @@ class NomadMediaSDK {
             const RESPONSE = await _updateShare(this, SHARE_ID, ID, NAME, 
                 SHARED_CONTENTS, SHARED_DURATION, SHARED_PERMISSIONS, SHARED_TYPE, 
                 SHARED_STATUS, SHARED_DURATION_IN_HOURS, SHARED_LINK, OWNER_ID, 
-                EXPIRATION_DATE);
+                EXPIRATION_DATE, ASSET_ID, SHARED_USERS);
     
             _printDatetime(`Update share called successfully.`);
     
@@ -10127,12 +10127,23 @@ async function _cancelUpload(instance, ID)
 
 const MAX_CONCURRENT_PROMISES = 3;
 
-async function _multiThreadUpload(instance, FILE, UPLOAD_RESPONSE, FILE_CONTENTS) 
+async function _multiThreadUpload(instance, FILE, UPLOAD_RESPONSE) 
 {
     const PARTS = UPLOAD_RESPONSE.parts;
     const LENGTH = PARTS.length;
     const abortController = new AbortController();
 
+    let buffer;
+    try 
+    {
+        buffer = Buffer.from(FILE.buffer, 'binary');
+    } 
+    catch (error) 
+    {
+        console.error("Error converting file buffer to Buffer:", error);
+        return false;
+    }
+
     try {
         for (let INDEX = 0; INDEX < LENGTH; INDEX += MAX_CONCURRENT_PROMISES) 
         {
@@ -10142,7 +10153,7 @@ async function _multiThreadUpload(instance, FILE, UPLOAD_RESPONSE, FILE_CONTENTS
 
                 try {
                     console.log(`Uploading part ${INDEX + 1} of ${LENGTH}...`);
-                    const ETAG = await _uploadPart(FILE, PART, FILE_CONTENTS, instance.debug);
+                    const ETAG = await _uploadPart(buffer, PART, instance.debug);
                     if (!ETAG) {
                         throw new Error("Connection error");
                     }
@@ -10175,7 +10186,7 @@ async function _multiThreadUpload(instance, FILE, UPLOAD_RESPONSE, FILE_CONTENTS
 
 
 async function _startUpload(instance, NAME, EXISTING_ASSET_ID, RELATED_CONTENT_ID, 
-    UPLOAD_OVERWRITE_OPTION, FILE, PARENT_ID, LANGUAGE_ID)
+    UPLOAD_OVERWRITE_OPTION, FILE, PARENT_ID, LANGUAGE_ID, UPLOAD_REPLACE_OPTIONS)
 {
     const API_URL = `${instance.config.serviceApiUrl}/api/asset/upload/start`;
 
@@ -10190,7 +10201,8 @@ async function _startUpload(instance, NAME, EXISTING_ASSET_ID, RELATED_CONTENT_I
         chunkSize: CHUNK_SIZE,
         relatedContentId: RELATED_CONTENT_ID,
         languageId: LANGUAGE_ID,
-        existingAssetId: EXISTING_ASSET_ID
+        existingAssetId: EXISTING_ASSET_ID,
+        uploadReplaceOptions: UPLOAD_REPLACE_OPTIONS
     };
 
     return await _sendRequest(instance, "Start asset upload", API_URL, "POST", undefined, BODY);
@@ -10248,23 +10260,15 @@ async function _uploadPartComplete(instance, PART_ID, ETAG)
 
 import { Buffer } from "buffer";
 
-async function _uploadPart(FILE, PART, FILE_CONTENTS, DEBUG_MODE, maxRetries = 3) 
+async function _uploadPart(BUFFER, PART, DEBUG_MODE, maxRetries = 3) 
 {
-    for (let attempt = 0; attempt < maxRetries; ++attempt) 
-    {
+    for (let attempt = 0; attempt < maxRetries; attempt++) 
+        {
         try 
         {
-            let body;
-            if (FILE_CONTENTS)
-            {
-                body = FILE_CONTENTS.slice(PART.startingPosition, PART.endingPosition + 1);
-            }
-            else
-            {
-                const BUFFER = Buffer.from(FILE.buffer, 'binary');
-                body = BUFFER.slice(PART.startingPosition, PART.endingPosition + 1);
-            }
+            const BODY = BUFFER.slice(PART.startingPosition, PART.endingPosition + 1);
 
+            // Create header for the request
             const HEADERS = new Headers();
             HEADERS.append("Accept", "application/json, text/plain, */*");
 
@@ -10273,7 +10277,7 @@ async function _uploadPart(FILE, PART, FILE_CONTENTS, DEBUG_MODE, maxRetries = 3
             const RESPONSE = await fetch(PART.url, {
                 method: "PUT",
                 headers: HEADERS,
-                body: body
+                body: BODY
             });
 
             if (!RESPONSE.ok) 
@@ -10287,11 +10291,13 @@ async function _uploadPart(FILE, PART, FILE_CONTENTS, DEBUG_MODE, maxRetries = 3
         catch (error) 
         {
             if (attempt < maxRetries - 1) 
-            {
+                {
+                // Retry if there are more attempts left
                 console.error(`Upload attempt ${attempt + 1} failed. Retrying...`);
             } 
             else 
             {
+                // No more retries left, handle the error
                 _apiExceptionHandler(error, "Upload Part Failed");
                 break;
             }
@@ -11459,6 +11465,8 @@ async function _updateLiveInput(instance, ID, NAME, SOURCE, TYPE, IS_STANDARD, V
 
     const INFO = await _sendRequest(instance, "Updating Live Input", API_URL, "PUT", undefined, BODY);
     await _waitForLiveInputStatus(instance, INFO.id, _LIVE_INPUT_STATUSES.Detached, 15, 1);
+
+    return INFO;
 }
 
 
@@ -13605,15 +13613,18 @@ async function _updateAsset(instance, ASSET_ID, DISPLAY_NAME, DISPLAY_DATE, AVAI
 
 
 
-async function _addCustomProperties(instance, ID, NAME, DATE, CUSTOM_PROPERTIES) 
+async function _addCustomProperties(instance, ID, NAME, DATE, CUSTOM_PROPERTIES, 
+    AVAILABLE_START_DATE, AVAILABLE_END_DATE) 
 {
     const API_URL = `${instance.config.serviceApiUrl}/api/admin/asset/${ID}`;
 
     const BODY = {};
 
-    if (NAME) BODY.name = NAME;
-    if (DATE) BODY.date = DATE;
-    if (CUSTOM_PROPERTIES) BODY.customProperties = CUSTOM_PROPERTIES;
+    if (NAME !== undefined) BODY.name = NAME;
+    if (DATE !== undefined) BODY.date = DATE;
+    if (CUSTOM_PROPERTIES !== undefined) BODY.customProperties = CUSTOM_PROPERTIES;
+    if (AVAILABLE_START_DATE !== undefined) BODY.availableStartDate = AVAILABLE_START_DATE;
+    if (AVAILABLE_END_DATE !== undefined) BODY.availableEndDate = AVAILABLE_END_DATE;
 
     return await _sendRequest(instance, "Adding Custom Properties", API_URL, "PATCH", undefined, BODY);
 }
@@ -13970,6 +13981,7 @@ async function _sendRequest(instance, FUNCTION_NAME, URL, METHOD_TYPE, PARAMS, B
     };
 
     if (instance.token) HEADERS["Authorization"] = `Bearer ${instance.token}`;
+    else if (instance.config.apiKey) HEADERS["Authorization"] = `ApiKey ${instance.config.apiKey}`;
 
     if (instance.debug && FUNCTION_NAME !== "Login") console.log(`URL: ${URL}\nMETHOD: ${METHOD_TYPE}` + (PARAMS && PARAMS.size === 0 ? `\nPARAMS: ${JSON.stringify(PARAMS, null, 4)}` : "")  + (BODY ? `\nBODY: ${JSON.stringify(BODY, null, 4)}` : ""));
 
@@ -13980,7 +13992,6 @@ async function _sendRequest(instance, FUNCTION_NAME, URL, METHOD_TYPE, PARAMS, B
     {
         try 
         {
-            refreshedToken = true;
             RESPONSE = await axios({
                 method: METHOD_TYPE,
                 url: URL,
@@ -14597,11 +14608,14 @@ async function _getDynamicContents(instance)
 
 
 
-async function _getMediaGroup(instance, ID) 
+async function _getMediaGroup(instance, ID, FILTER_IDS) 
 {
-    const API_URL = `${instance.config.serviceApiUrl}/api/media/group/${ID}`;
+    let apiUrl = `${instance.config.serviceApiUrl}/api/media/group/${ID}`;
+    if (FILTER_IDS && FILTER_IDS.length > 0) {
+        apiUrl += '?' + FILTER_IDS.map(id => `filterIds=${id}`).join('&');
+    }
 
-    return await _sendRequest(instance, "Get Media Group", API_URL, "GET", undefined, undefined);
+    return await _sendRequest(instance, "Get Media Group", apiUrl, "GET", undefined, undefined);
 }
 
 
@@ -14870,7 +14884,7 @@ async function _shareNotification(instance, SHARE_ID, NOMAD_USERS, EXTERNAL_USER
 
 async function _share(instance, ID, NAME, SHARED_CONTENTS, SHARED_DURATION, SHARED_PERMISSIONS, 
 	SHARED_TYPE, SHARED_STATUS, SHARED_DURATION_IN_HOURS, SHARED_LINK, OWNER_ID, 
-	EXPIRATION_DATE)
+	EXPIRATION_DATE, ASSET_ID, NOMAD_USERS)
 {
 	const API_URL = `${instance.config.serviceApiUrl}/api/share`;
 
@@ -14885,7 +14899,9 @@ async function _share(instance, ID, NAME, SHARED_CONTENTS, SHARED_DURATION, SHAR
 		sharedDurationInHours: SHARED_DURATION_IN_HOURS, 
 		sharedLink: SHARED_LINK, 
 		ownerId: OWNER_ID, 
-		expirationDate: EXPIRATION_DATE
+		expirationDate: EXPIRATION_DATE,
+		assetId: ASSET_ID,
+		nomadUsers: NOMAD_USERS
 	};
 
 	return await _sendRequest(instance, "Share", API_URL, "POST", undefined, BODY);
@@ -14897,7 +14913,7 @@ async function _share(instance, ID, NAME, SHARED_CONTENTS, SHARED_DURATION, SHAR
 
 async function _updateShare(instance, SHARE_ID, ID, NAME, SHARED_CONTENTS, SHARED_DURATION, 
 	SHARED_PERMISSIONS, SHARED_TYPE, SHARED_STATUS, SHARED_DURATION_IN_HOURS, SHARED_LINK, 
-	OWNER_ID, EXPIRATION_DATE)
+	OWNER_ID, EXPIRATION_DATE, ASSET_ID, NOMAD_USERS)
 {
 	const API_URL = `${instance.config.serviceApiUrl}/api/share/${SHARE_ID}?`;
 
@@ -14920,7 +14936,9 @@ async function _updateShare(instance, SHARE_ID, ID, NAME, SHARED_CONTENTS, SHARE
 		sharedDurationInHours: SHARED_DURATION_IN_HOURS || share_info.sharedDurationInHours, 
 		sharedLink: SHARED_LINK || share_info.sharedLink, 
 		ownerId: OWNER_ID || share_info.ownerId, 
-		expirationDate: EXPIRATION_DATE || share_info.expirationDate
+		expirationDate: EXPIRATION_DATE || share_info.expirationDate,
+		assetId: ASSET_ID || share_info.assetId,
+		nomadUsers: NOMAD_USERS || share_info.nomadUsers
 	};
 
 	return await _sendRequest(instance, "Update Share", API_URL, "PUT", undefined, BODY);