@wix/media 1.0.99 → 1.0.100

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/media",
-  "version": "1.0.99",
+  "version": "1.0.100",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
@@ -20,7 +20,7 @@
   "dependencies": {
     "@wix/media_enterprise-media-categories": "1.0.24",
     "@wix/media_enterprise-media-items": "1.0.27",
-    "@wix/media_files": "1.0.36",
+    "@wix/media_files": "1.0.37",
     "@wix/media_folders": "1.0.27"
   },
   "devDependencies": {
@@ -45,5 +45,5 @@
       "fqdn": ""
     }
   },
-  "falconPackageHash": "e5841a18caf169746ec11327ddec9ad82d5c95cee90cba2cc853d489"
+  "falconPackageHash": "e037ed493c4a9b4b99feb5b7bc046c8cb76ab20c7421d7b9c73a7495"
 }

package/type-bundles/context.bundle.d.ts

@@ -1379,6 +1379,7 @@ interface ImportFileRequest {
     displayName?: string | null;
     /**
      * ID of the file's parent folder. <br />
+     * This folder is the path root for the `filePath`. <br />
      * Default: `media-root`.
      */
     parentFolderId?: string | null;
@@ -1395,11 +1396,10 @@ interface ImportFileRequest {
     /** Optional headers that should be sent with the external URL. */
     urlHeaders?: Record<string, any> | null;
     /**
-     * The path by folder names to create the file under.
-     * In case a folder in the path does not exist it will be created
-     * If multiple folders with the same name exist, the first one will be used
-     * If `parentFolderId` is provided, the path will be nested under the folder specified by the `parentFolderId`
-     * example: 'videos/2024/december'
+     * Path to the folder where the file will be stored.
+     * For example, `/videos/2024/december`. <br/>
+     * If `parentFolderId` is defined, the parent folder is used as the path root. Otherwise, the root is `media-root`.
+     * The folders in the path will be created if they don't already exist.  <br />
      */
     filePath?: string | null;
 }
@@ -2103,6 +2103,7 @@ interface GenerateFileUploadUrlOptions {
     sizeInBytes?: string | null;
     /**
      * ID of the file's parent folder. <br />
+     * This folder is the path root for the `filePath`.<br />
      * Default: `media-root`.
      */
     parentFolderId?: string | null;
@@ -2113,11 +2114,10 @@ interface GenerateFileUploadUrlOptions {
     /** Information sent to the `onFileDescriptorFileReady( )` and `onFileDescriptorFileFailed( )` events. See the Importing Files article to learn more. */
     externalInfo?: ExternalInfo;
     /**
-     * The path by folder names to create the file under.
-     * In case a folder in the path does not exist it will be created
-     * If multiple folders with the same name exist, the first one will be used
-     * If `parentFolderId` is provided, the path will be nested under the folder specified by the `parentFolderId`
-     * example: 'videos/2024/december'
+     * Path to the folder where the file will be stored.
+     * For example, `/videos/2024/december`. <br/>
+     * If `parentFolderId` is defined, the parent folder is used as the path root. Otherwise, the root is `media-root`.
+     * The folders in the path will be created if they don't already exist.  <br />
      */
     filePath?: string | null;
 }
@@ -2134,6 +2134,7 @@ interface GenerateFileResumableUploadUrlOptions {
     sizeInBytes?: string | null;
     /**
      * ID of the file's parent folder. <br />
+     * This folder is the path root for the `filePath`.<br />
      * Default: `media-root`.
      */
     parentFolderId?: string | null;
@@ -2148,11 +2149,10 @@ interface GenerateFileResumableUploadUrlOptions {
      */
     uploadProtocol?: UploadProtocol;
     /**
-     * The path by folder names to create the file under.
-     * In case a folder in the path does not exist it will be created
-     * If multiple folders with the same name exist, the first one will be used
-     * If `parentFolderId` is provided, the path will be nested under the folder specified by the `parentFolderId`
-     * example: 'videos/2024/december'
+     * Path to the folder where the file will be stored.
+     * For example, `/videos/2024/december`. <br/>
+     * If `parentFolderId` is defined, the parent folder is used as the path root. Otherwise, the root is `media-root`.
+     * The folders in the path will be created if they don't already exist.  <br />
      */
     filePath?: string | null;
 }
@@ -2163,6 +2163,7 @@ interface ImportFileOptions {
     displayName?: string | null;
     /**
      * ID of the file's parent folder. <br />
+     * This folder is the path root for the `filePath`. <br />
      * Default: `media-root`.
      */
     parentFolderId?: string | null;
@@ -2179,11 +2180,10 @@ interface ImportFileOptions {
     /** Optional headers that should be sent with the external URL. */
     urlHeaders?: Record<string, any> | null;
     /**
-     * The path by folder names to create the file under.
-     * In case a folder in the path does not exist it will be created
-     * If multiple folders with the same name exist, the first one will be used
-     * If `parentFolderId` is provided, the path will be nested under the folder specified by the `parentFolderId`
-     * example: 'videos/2024/december'
+     * Path to the folder where the file will be stored.
+     * For example, `/videos/2024/december`. <br/>
+     * If `parentFolderId` is defined, the parent folder is used as the path root. Otherwise, the root is `media-root`.
+     * The folders in the path will be created if they don't already exist.  <br />
      */
     filePath?: string | null;
 }

package/type-bundles/index.bundle.d.ts

@@ -2010,6 +2010,7 @@ interface GenerateFileUploadUrlRequest {
     sizeInBytes?: string | null;
     /**
      * ID of the file's parent folder. <br />
+     * This folder is the path root for the `filePath`.<br />
      * Default: `media-root`.
      */
     parentFolderId?: string | null;
@@ -2020,11 +2021,10 @@ interface GenerateFileUploadUrlRequest {
     /** Information sent to the `onFileDescriptorFileReady( )` and `onFileDescriptorFileFailed( )` events. See the Importing Files article to learn more. */
     externalInfo?: ExternalInfo;
     /**
-     * The path by folder names to create the file under.
-     * In case a folder in the path does not exist it will be created
-     * If multiple folders with the same name exist, the first one will be used
-     * If `parentFolderId` is provided, the path will be nested under the folder specified by the `parentFolderId`
-     * example: 'videos/2024/december'
+     * Path to the folder where the file will be stored.
+     * For example, `/videos/2024/december`. <br/>
+     * If `parentFolderId` is defined, the parent folder is used as the path root. Otherwise, the root is `media-root`.
+     * The folders in the path will be created if they don't already exist.  <br />
      */
     filePath?: string | null;
 }
@@ -2047,6 +2047,7 @@ interface GenerateFileResumableUploadUrlRequest {
     sizeInBytes?: string | null;
     /**
      * ID of the file's parent folder. <br />
+     * This folder is the path root for the `filePath`.<br />
      * Default: `media-root`.
      */
     parentFolderId?: string | null;
@@ -2057,11 +2058,10 @@ interface GenerateFileResumableUploadUrlRequest {
     /** The upload protocol to use for implementing the resumable upload. */
     uploadProtocol?: UploadProtocol;
     /**
-     * The path by folder names to create the file under.
-     * In case a folder in the path does not exist it will be created
-     * If multiple folders with the same name exist, the first one will be used
-     * If `parentFolderId` is provided, the path will be nested under the folder specified by the `parentFolderId`
-     * example: 'videos/2024/december'
+     * Path to the folder where the file will be stored.
+     * For example, `/videos/2024/december`. <br/>
+     * If `parentFolderId` is defined, the parent folder is used as the path root. Otherwise, the root is `media-root`.
+     * The folders in the path will be created if they don't already exist.  <br />
      */
     filePath?: string | null;
 }
@@ -2090,6 +2090,7 @@ interface ImportFileRequest {
     displayName?: string | null;
     /**
      * ID of the file's parent folder. <br />
+     * This folder is the path root for the `filePath`. <br />
      * Default: `media-root`.
      */
     parentFolderId?: string | null;
@@ -2106,11 +2107,10 @@ interface ImportFileRequest {
     /** Optional headers that should be sent with the external URL. */
     urlHeaders?: Record<string, any> | null;
     /**
-     * The path by folder names to create the file under.
-     * In case a folder in the path does not exist it will be created
-     * If multiple folders with the same name exist, the first one will be used
-     * If `parentFolderId` is provided, the path will be nested under the folder specified by the `parentFolderId`
-     * example: 'videos/2024/december'
+     * Path to the folder where the file will be stored.
+     * For example, `/videos/2024/december`. <br/>
+     * If `parentFolderId` is defined, the parent folder is used as the path root. Otherwise, the root is `media-root`.
+     * The folders in the path will be created if they don't already exist.  <br />
      */
     filePath?: string | null;
 }
@@ -2442,7 +2442,7 @@ interface DomainEventBodyOneOf$1 {
 interface EntityCreatedEvent$1 {
     entity?: string;
 }
-interface UndeleteInfo {
+interface RestoreInfo {
     deletedDate?: Date;
 }
 interface EntityUpdatedEvent$1 {
@@ -3176,6 +3176,7 @@ interface GenerateFileUploadUrlOptions {
     sizeInBytes?: string | null;
     /**
      * ID of the file's parent folder. <br />
+     * This folder is the path root for the `filePath`.<br />
      * Default: `media-root`.
      */
     parentFolderId?: string | null;
@@ -3186,11 +3187,10 @@ interface GenerateFileUploadUrlOptions {
     /** Information sent to the `onFileDescriptorFileReady( )` and `onFileDescriptorFileFailed( )` events. See the Importing Files article to learn more. */
     externalInfo?: ExternalInfo;
     /**
-     * The path by folder names to create the file under.
-     * In case a folder in the path does not exist it will be created
-     * If multiple folders with the same name exist, the first one will be used
-     * If `parentFolderId` is provided, the path will be nested under the folder specified by the `parentFolderId`
-     * example: 'videos/2024/december'
+     * Path to the folder where the file will be stored.
+     * For example, `/videos/2024/december`. <br/>
+     * If `parentFolderId` is defined, the parent folder is used as the path root. Otherwise, the root is `media-root`.
+     * The folders in the path will be created if they don't already exist.  <br />
      */
     filePath?: string | null;
 }
@@ -3207,6 +3207,7 @@ interface GenerateFileResumableUploadUrlOptions {
     sizeInBytes?: string | null;
     /**
      * ID of the file's parent folder. <br />
+     * This folder is the path root for the `filePath`.<br />
      * Default: `media-root`.
      */
     parentFolderId?: string | null;
@@ -3221,11 +3222,10 @@ interface GenerateFileResumableUploadUrlOptions {
      */
     uploadProtocol?: UploadProtocol;
     /**
-     * The path by folder names to create the file under.
-     * In case a folder in the path does not exist it will be created
-     * If multiple folders with the same name exist, the first one will be used
-     * If `parentFolderId` is provided, the path will be nested under the folder specified by the `parentFolderId`
-     * example: 'videos/2024/december'
+     * Path to the folder where the file will be stored.
+     * For example, `/videos/2024/december`. <br/>
+     * If `parentFolderId` is defined, the parent folder is used as the path root. Otherwise, the root is `media-root`.
+     * The folders in the path will be created if they don't already exist.  <br />
      */
     filePath?: string | null;
 }
@@ -3236,6 +3236,7 @@ interface ImportFileOptions {
     displayName?: string | null;
     /**
      * ID of the file's parent folder. <br />
+     * This folder is the path root for the `filePath`. <br />
      * Default: `media-root`.
      */
     parentFolderId?: string | null;
@@ -3252,11 +3253,10 @@ interface ImportFileOptions {
     /** Optional headers that should be sent with the external URL. */
     urlHeaders?: Record<string, any> | null;
     /**
-     * The path by folder names to create the file under.
-     * In case a folder in the path does not exist it will be created
-     * If multiple folders with the same name exist, the first one will be used
-     * If `parentFolderId` is provided, the path will be nested under the folder specified by the `parentFolderId`
-     * example: 'videos/2024/december'
+     * Path to the folder where the file will be stored.
+     * For example, `/videos/2024/december`. <br/>
+     * If `parentFolderId` is defined, the parent folder is used as the path root. Otherwise, the root is `media-root`.
+     * The folders in the path will be created if they don't already exist.  <br />
      */
     filePath?: string | null;
 }
@@ -3619,13 +3619,13 @@ type index_d$1_Model3D = Model3D;
 type index_d$1_OperationStatus = OperationStatus;
 declare const index_d$1_OperationStatus: typeof OperationStatus;
 type index_d$1_OtherMedia = OtherMedia;
+type index_d$1_RestoreInfo = RestoreInfo;
 type index_d$1_SearchFilesOptions = SearchFilesOptions;
 type index_d$1_SearchFilesRequest = SearchFilesRequest;
 type index_d$1_SearchFilesResponse = SearchFilesResponse;
 type index_d$1_SearchFilesResponseNonNullableFields = SearchFilesResponseNonNullableFields;
 type index_d$1_StreamFormat = StreamFormat;
 declare const index_d$1_StreamFormat: typeof StreamFormat;
-type index_d$1_UndeleteInfo = UndeleteInfo;
 type index_d$1_UpdateFileDescriptorRequest = UpdateFileDescriptorRequest;
 type index_d$1_UpdateFileDescriptorResponse = UpdateFileDescriptorResponse;
 type index_d$1_UpdateFileDescriptorResponseNonNullableFields = UpdateFileDescriptorResponseNonNullableFields;
@@ -3655,7 +3655,7 @@ declare const index_d$1_onFileDescriptorUpdated: typeof onFileDescriptorUpdated;
 declare const index_d$1_searchFiles: typeof searchFiles;
 declare const index_d$1_updateFileDescriptor: typeof updateFileDescriptor;
 declare namespace index_d$1 {
-  export { type ActionEvent$1 as ActionEvent, type index_d$1_ApplicationError as ApplicationError, type index_d$1_Archive as Archive, type index_d$1_AudioV2 as AudioV2, type BaseEventMetadata$1 as BaseEventMetadata, type index_d$1_BulkActionMetadata as BulkActionMetadata, type index_d$1_BulkDeleteFilesOptions as BulkDeleteFilesOptions, type index_d$1_BulkDeleteFilesRequest as BulkDeleteFilesRequest, type index_d$1_BulkDeleteFilesResponse as BulkDeleteFilesResponse, type index_d$1_BulkImportFileOptions as BulkImportFileOptions, type index_d$1_BulkImportFileRequest as BulkImportFileRequest, type index_d$1_BulkImportFileResponse as BulkImportFileResponse, type index_d$1_BulkImportFileResponseNonNullableFields as BulkImportFileResponseNonNullableFields, type index_d$1_BulkImportFileResult as BulkImportFileResult, type index_d$1_BulkImportFilesRequest as BulkImportFilesRequest, type index_d$1_BulkImportFilesResponse as BulkImportFilesResponse, type index_d$1_BulkImportFilesResponseNonNullableFields as BulkImportFilesResponseNonNullableFields, type index_d$1_BulkRestoreFilesFromTrashBinRequest as BulkRestoreFilesFromTrashBinRequest, type index_d$1_BulkRestoreFilesFromTrashBinResponse as BulkRestoreFilesFromTrashBinResponse, type index_d$1_Color as Color, type index_d$1_ColorRGB as ColorRGB, type index_d$1_Colors as Colors, index_d$1_ContentDisposition as ContentDisposition, type CursorPaging$1 as CursorPaging, type Cursors$1 as Cursors, type DomainEvent$1 as DomainEvent, type DomainEventBodyOneOf$1 as DomainEventBodyOneOf, type index_d$1_DownloadUrl as DownloadUrl, type EntityCreatedEvent$1 as EntityCreatedEvent, type EntityDeletedEvent$1 as EntityDeletedEvent, type EntityUpdatedEvent$1 as EntityUpdatedEvent, type EventMetadata$1 as EventMetadata, type index_d$1_ExternalInfo as ExternalInfo, type index_d$1_FaceRecognition as FaceRecognition, type index_d$1_FileDescriptor as FileDescriptor, type index_d$1_FileDescriptorDeletedEnvelope as FileDescriptorDeletedEnvelope, type index_d$1_FileDescriptorFileFailedEnvelope as FileDescriptorFileFailedEnvelope, type index_d$1_FileDescriptorFileReadyEnvelope as FileDescriptorFileReadyEnvelope, type index_d$1_FileDescriptorUpdatedEnvelope as FileDescriptorUpdatedEnvelope, type index_d$1_FileFailed as FileFailed, type index_d$1_FileMedia as FileMedia, type index_d$1_FileMediaMediaOneOf as FileMediaMediaOneOf, type index_d$1_FileReady as FileReady, type index_d$1_GenerateFileDownloadUrlOptions as GenerateFileDownloadUrlOptions, type index_d$1_GenerateFileDownloadUrlRequest as GenerateFileDownloadUrlRequest, type index_d$1_GenerateFileDownloadUrlResponse as GenerateFileDownloadUrlResponse, type index_d$1_GenerateFileDownloadUrlResponseNonNullableFields as GenerateFileDownloadUrlResponseNonNullableFields, type index_d$1_GenerateFileResumableUploadUrlOptions as GenerateFileResumableUploadUrlOptions, type index_d$1_GenerateFileResumableUploadUrlRequest as GenerateFileResumableUploadUrlRequest, type index_d$1_GenerateFileResumableUploadUrlResponse as GenerateFileResumableUploadUrlResponse, type index_d$1_GenerateFileResumableUploadUrlResponseNonNullableFields as GenerateFileResumableUploadUrlResponseNonNullableFields, type index_d$1_GenerateFileUploadUrlOptions as GenerateFileUploadUrlOptions, type index_d$1_GenerateFileUploadUrlRequest as GenerateFileUploadUrlRequest, type index_d$1_GenerateFileUploadUrlResponse as GenerateFileUploadUrlResponse, type index_d$1_GenerateFileUploadUrlResponseNonNullableFields as GenerateFileUploadUrlResponseNonNullableFields, type index_d$1_GenerateFilesDownloadUrlRequest as GenerateFilesDownloadUrlRequest, type index_d$1_GenerateFilesDownloadUrlResponse as GenerateFilesDownloadUrlResponse, type index_d$1_GenerateFilesDownloadUrlResponseNonNullableFields as GenerateFilesDownloadUrlResponseNonNullableFields, type index_d$1_GenerateVideoStreamingUrlOptions as GenerateVideoStreamingUrlOptions, type index_d$1_GenerateVideoStreamingUrlRequest as GenerateVideoStreamingUrlRequest, type index_d$1_GenerateVideoStreamingUrlResponse as GenerateVideoStreamingUrlResponse, type index_d$1_GenerateVideoStreamingUrlResponseNonNullableFields as GenerateVideoStreamingUrlResponseNonNullableFields, type index_d$1_GenerateWebSocketTokenRequest as GenerateWebSocketTokenRequest, type index_d$1_GenerateWebSocketTokenResponse as GenerateWebSocketTokenResponse, type index_d$1_GetFileDescriptorRequest as GetFileDescriptorRequest, type index_d$1_GetFileDescriptorResponse as GetFileDescriptorResponse, type index_d$1_GetFileDescriptorResponseNonNullableFields as GetFileDescriptorResponseNonNullableFields, type index_d$1_GetFileDescriptorsRequest as GetFileDescriptorsRequest, type index_d$1_GetFileDescriptorsResponse as GetFileDescriptorsResponse, type index_d$1_GetFileDescriptorsResponseNonNullableFields as GetFileDescriptorsResponseNonNullableFields, type IdentificationData$1 as IdentificationData, type IdentificationDataIdOneOf$1 as IdentificationDataIdOneOf, type index_d$1_IdentityInfo as IdentityInfo, index_d$1_IdentityType as IdentityType, type index_d$1_ImageMedia as ImageMedia, type index_d$1_ImportFileOptions as ImportFileOptions, type index_d$1_ImportFileRequest as ImportFileRequest, type index_d$1_ImportFileResponse as ImportFileResponse, type index_d$1_ImportFileResponseNonNullableFields as ImportFileResponseNonNullableFields, type index_d$1_ItemMetadata as ItemMetadata, type index_d$1_ListDeletedFilesOptions as ListDeletedFilesOptions, type index_d$1_ListDeletedFilesRequest as ListDeletedFilesRequest, type index_d$1_ListDeletedFilesResponse as ListDeletedFilesResponse, type index_d$1_ListDeletedFilesResponseNonNullableFields as ListDeletedFilesResponseNonNullableFields, type index_d$1_ListFilesOptions as ListFilesOptions, type index_d$1_ListFilesRequest as ListFilesRequest, type index_d$1_ListFilesResponse as ListFilesResponse, type index_d$1_ListFilesResponseNonNullableFields as ListFilesResponseNonNullableFields, index_d$1_MediaType as MediaType, type MessageEnvelope$1 as MessageEnvelope, type index_d$1_Model3D as Model3D, Namespace$1 as Namespace, index_d$1_OperationStatus as OperationStatus, type index_d$1_OtherMedia as OtherMedia, type PagingMetadataV2$1 as PagingMetadataV2, RootFolder$1 as RootFolder, type index_d$1_SearchFilesOptions as SearchFilesOptions, type index_d$1_SearchFilesRequest as SearchFilesRequest, type index_d$1_SearchFilesResponse as SearchFilesResponse, type index_d$1_SearchFilesResponseNonNullableFields as SearchFilesResponseNonNullableFields, SortOrder$1 as SortOrder, type Sorting$1 as Sorting, State$1 as State, index_d$1_StreamFormat as StreamFormat, type index_d$1_UndeleteInfo as UndeleteInfo, type index_d$1_UpdateFileDescriptorRequest as UpdateFileDescriptorRequest, type index_d$1_UpdateFileDescriptorResponse as UpdateFileDescriptorResponse, type index_d$1_UpdateFileDescriptorResponseNonNullableFields as UpdateFileDescriptorResponseNonNullableFields, type index_d$1_UpdateFileRequest as UpdateFileRequest, type index_d$1_UpdateFileResponse as UpdateFileResponse, index_d$1_UploadProtocol as UploadProtocol, type index_d$1_VideoResolution as VideoResolution, WebhookIdentityType$1 as WebhookIdentityType, __metadata$1 as __metadata, index_d$1_bulkDeleteFiles as bulkDeleteFiles, index_d$1_bulkImportFile as bulkImportFile, index_d$1_bulkImportFiles as bulkImportFiles, index_d$1_bulkRestoreFilesFromTrashBin as bulkRestoreFilesFromTrashBin, index_d$1_generateFileDownloadUrl as generateFileDownloadUrl, index_d$1_generateFileResumableUploadUrl as generateFileResumableUploadUrl, index_d$1_generateFileUploadUrl as generateFileUploadUrl, index_d$1_generateFilesDownloadUrl as generateFilesDownloadUrl, index_d$1_generateVideoStreamingUrl as generateVideoStreamingUrl, index_d$1_getFileDescriptor as getFileDescriptor, index_d$1_getFileDescriptors as getFileDescriptors, index_d$1_importFile as importFile, index_d$1_listDeletedFiles as listDeletedFiles, index_d$1_listFiles as listFiles, index_d$1_onFileDescriptorDeleted as onFileDescriptorDeleted, index_d$1_onFileDescriptorFileFailed as onFileDescriptorFileFailed, index_d$1_onFileDescriptorFileReady as onFileDescriptorFileReady, index_d$1_onFileDescriptorUpdated as onFileDescriptorUpdated, index_d$1_searchFiles as searchFiles, index_d$1_updateFileDescriptor as updateFileDescriptor };
+  export { type ActionEvent$1 as ActionEvent, type index_d$1_ApplicationError as ApplicationError, type index_d$1_Archive as Archive, type index_d$1_AudioV2 as AudioV2, type BaseEventMetadata$1 as BaseEventMetadata, type index_d$1_BulkActionMetadata as BulkActionMetadata, type index_d$1_BulkDeleteFilesOptions as BulkDeleteFilesOptions, type index_d$1_BulkDeleteFilesRequest as BulkDeleteFilesRequest, type index_d$1_BulkDeleteFilesResponse as BulkDeleteFilesResponse, type index_d$1_BulkImportFileOptions as BulkImportFileOptions, type index_d$1_BulkImportFileRequest as BulkImportFileRequest, type index_d$1_BulkImportFileResponse as BulkImportFileResponse, type index_d$1_BulkImportFileResponseNonNullableFields as BulkImportFileResponseNonNullableFields, type index_d$1_BulkImportFileResult as BulkImportFileResult, type index_d$1_BulkImportFilesRequest as BulkImportFilesRequest, type index_d$1_BulkImportFilesResponse as BulkImportFilesResponse, type index_d$1_BulkImportFilesResponseNonNullableFields as BulkImportFilesResponseNonNullableFields, type index_d$1_BulkRestoreFilesFromTrashBinRequest as BulkRestoreFilesFromTrashBinRequest, type index_d$1_BulkRestoreFilesFromTrashBinResponse as BulkRestoreFilesFromTrashBinResponse, type index_d$1_Color as Color, type index_d$1_ColorRGB as ColorRGB, type index_d$1_Colors as Colors, index_d$1_ContentDisposition as ContentDisposition, type CursorPaging$1 as CursorPaging, type Cursors$1 as Cursors, type DomainEvent$1 as DomainEvent, type DomainEventBodyOneOf$1 as DomainEventBodyOneOf, type index_d$1_DownloadUrl as DownloadUrl, type EntityCreatedEvent$1 as EntityCreatedEvent, type EntityDeletedEvent$1 as EntityDeletedEvent, type EntityUpdatedEvent$1 as EntityUpdatedEvent, type EventMetadata$1 as EventMetadata, type index_d$1_ExternalInfo as ExternalInfo, type index_d$1_FaceRecognition as FaceRecognition, type index_d$1_FileDescriptor as FileDescriptor, type index_d$1_FileDescriptorDeletedEnvelope as FileDescriptorDeletedEnvelope, type index_d$1_FileDescriptorFileFailedEnvelope as FileDescriptorFileFailedEnvelope, type index_d$1_FileDescriptorFileReadyEnvelope as FileDescriptorFileReadyEnvelope, type index_d$1_FileDescriptorUpdatedEnvelope as FileDescriptorUpdatedEnvelope, type index_d$1_FileFailed as FileFailed, type index_d$1_FileMedia as FileMedia, type index_d$1_FileMediaMediaOneOf as FileMediaMediaOneOf, type index_d$1_FileReady as FileReady, type index_d$1_GenerateFileDownloadUrlOptions as GenerateFileDownloadUrlOptions, type index_d$1_GenerateFileDownloadUrlRequest as GenerateFileDownloadUrlRequest, type index_d$1_GenerateFileDownloadUrlResponse as GenerateFileDownloadUrlResponse, type index_d$1_GenerateFileDownloadUrlResponseNonNullableFields as GenerateFileDownloadUrlResponseNonNullableFields, type index_d$1_GenerateFileResumableUploadUrlOptions as GenerateFileResumableUploadUrlOptions, type index_d$1_GenerateFileResumableUploadUrlRequest as GenerateFileResumableUploadUrlRequest, type index_d$1_GenerateFileResumableUploadUrlResponse as GenerateFileResumableUploadUrlResponse, type index_d$1_GenerateFileResumableUploadUrlResponseNonNullableFields as GenerateFileResumableUploadUrlResponseNonNullableFields, type index_d$1_GenerateFileUploadUrlOptions as GenerateFileUploadUrlOptions, type index_d$1_GenerateFileUploadUrlRequest as GenerateFileUploadUrlRequest, type index_d$1_GenerateFileUploadUrlResponse as GenerateFileUploadUrlResponse, type index_d$1_GenerateFileUploadUrlResponseNonNullableFields as GenerateFileUploadUrlResponseNonNullableFields, type index_d$1_GenerateFilesDownloadUrlRequest as GenerateFilesDownloadUrlRequest, type index_d$1_GenerateFilesDownloadUrlResponse as GenerateFilesDownloadUrlResponse, type index_d$1_GenerateFilesDownloadUrlResponseNonNullableFields as GenerateFilesDownloadUrlResponseNonNullableFields, type index_d$1_GenerateVideoStreamingUrlOptions as GenerateVideoStreamingUrlOptions, type index_d$1_GenerateVideoStreamingUrlRequest as GenerateVideoStreamingUrlRequest, type index_d$1_GenerateVideoStreamingUrlResponse as GenerateVideoStreamingUrlResponse, type index_d$1_GenerateVideoStreamingUrlResponseNonNullableFields as GenerateVideoStreamingUrlResponseNonNullableFields, type index_d$1_GenerateWebSocketTokenRequest as GenerateWebSocketTokenRequest, type index_d$1_GenerateWebSocketTokenResponse as GenerateWebSocketTokenResponse, type index_d$1_GetFileDescriptorRequest as GetFileDescriptorRequest, type index_d$1_GetFileDescriptorResponse as GetFileDescriptorResponse, type index_d$1_GetFileDescriptorResponseNonNullableFields as GetFileDescriptorResponseNonNullableFields, type index_d$1_GetFileDescriptorsRequest as GetFileDescriptorsRequest, type index_d$1_GetFileDescriptorsResponse as GetFileDescriptorsResponse, type index_d$1_GetFileDescriptorsResponseNonNullableFields as GetFileDescriptorsResponseNonNullableFields, type IdentificationData$1 as IdentificationData, type IdentificationDataIdOneOf$1 as IdentificationDataIdOneOf, type index_d$1_IdentityInfo as IdentityInfo, index_d$1_IdentityType as IdentityType, type index_d$1_ImageMedia as ImageMedia, type index_d$1_ImportFileOptions as ImportFileOptions, type index_d$1_ImportFileRequest as ImportFileRequest, type index_d$1_ImportFileResponse as ImportFileResponse, type index_d$1_ImportFileResponseNonNullableFields as ImportFileResponseNonNullableFields, type index_d$1_ItemMetadata as ItemMetadata, type index_d$1_ListDeletedFilesOptions as ListDeletedFilesOptions, type index_d$1_ListDeletedFilesRequest as ListDeletedFilesRequest, type index_d$1_ListDeletedFilesResponse as ListDeletedFilesResponse, type index_d$1_ListDeletedFilesResponseNonNullableFields as ListDeletedFilesResponseNonNullableFields, type index_d$1_ListFilesOptions as ListFilesOptions, type index_d$1_ListFilesRequest as ListFilesRequest, type index_d$1_ListFilesResponse as ListFilesResponse, type index_d$1_ListFilesResponseNonNullableFields as ListFilesResponseNonNullableFields, index_d$1_MediaType as MediaType, type MessageEnvelope$1 as MessageEnvelope, type index_d$1_Model3D as Model3D, Namespace$1 as Namespace, index_d$1_OperationStatus as OperationStatus, type index_d$1_OtherMedia as OtherMedia, type PagingMetadataV2$1 as PagingMetadataV2, type index_d$1_RestoreInfo as RestoreInfo, RootFolder$1 as RootFolder, type index_d$1_SearchFilesOptions as SearchFilesOptions, type index_d$1_SearchFilesRequest as SearchFilesRequest, type index_d$1_SearchFilesResponse as SearchFilesResponse, type index_d$1_SearchFilesResponseNonNullableFields as SearchFilesResponseNonNullableFields, SortOrder$1 as SortOrder, type Sorting$1 as Sorting, State$1 as State, index_d$1_StreamFormat as StreamFormat, type index_d$1_UpdateFileDescriptorRequest as UpdateFileDescriptorRequest, type index_d$1_UpdateFileDescriptorResponse as UpdateFileDescriptorResponse, type index_d$1_UpdateFileDescriptorResponseNonNullableFields as UpdateFileDescriptorResponseNonNullableFields, type index_d$1_UpdateFileRequest as UpdateFileRequest, type index_d$1_UpdateFileResponse as UpdateFileResponse, index_d$1_UploadProtocol as UploadProtocol, type index_d$1_VideoResolution as VideoResolution, WebhookIdentityType$1 as WebhookIdentityType, __metadata$1 as __metadata, index_d$1_bulkDeleteFiles as bulkDeleteFiles, index_d$1_bulkImportFile as bulkImportFile, index_d$1_bulkImportFiles as bulkImportFiles, index_d$1_bulkRestoreFilesFromTrashBin as bulkRestoreFilesFromTrashBin, index_d$1_generateFileDownloadUrl as generateFileDownloadUrl, index_d$1_generateFileResumableUploadUrl as generateFileResumableUploadUrl, index_d$1_generateFileUploadUrl as generateFileUploadUrl, index_d$1_generateFilesDownloadUrl as generateFilesDownloadUrl, index_d$1_generateVideoStreamingUrl as generateVideoStreamingUrl, index_d$1_getFileDescriptor as getFileDescriptor, index_d$1_getFileDescriptors as getFileDescriptors, index_d$1_importFile as importFile, index_d$1_listDeletedFiles as listDeletedFiles, index_d$1_listFiles as listFiles, index_d$1_onFileDescriptorDeleted as onFileDescriptorDeleted, index_d$1_onFileDescriptorFileFailed as onFileDescriptorFileFailed, index_d$1_onFileDescriptorFileReady as onFileDescriptorFileReady, index_d$1_onFileDescriptorUpdated as onFileDescriptorUpdated, index_d$1_searchFiles as searchFiles, index_d$1_updateFileDescriptor as updateFileDescriptor };
 }
 
 interface Folder {

package/type-bundles/meta.bundle.d.ts

@@ -2265,6 +2265,7 @@ interface GenerateFileUploadUrlRequest$1 {
     sizeInBytes?: string | null;
     /**
      * ID of the file's parent folder. <br />
+     * This folder is the path root for the `filePath`.<br />
      * Default: `media-root`.
      */
     parentFolderId?: string | null;
@@ -2275,11 +2276,10 @@ interface GenerateFileUploadUrlRequest$1 {
     /** A place to map an external entity to an uploaded file in the Wix Media Manager. */
     externalInfo?: ExternalInfo$1;
     /**
-     * The path by folder names to create the file under.
-     * In case a folder in the path does not exist it will be created
-     * If multiple folders with the same name exist, the first one will be used
-     * If `parentFolderId` is provided, the path will be nested under the folder specified by the `parentFolderId`
-     * example: 'videos/2024/december'
+     * Path to the folder where the file will be stored.
+     * For example, `/videos/2024/december`. <br/>
+     * If `parentFolderId` is defined, the parent folder is used as the path root. Otherwise, the root is `media-root`.
+     * The folders in the path will be created if they don't already exist.  <br />
      */
     filePath?: string | null;
 }
@@ -2302,6 +2302,7 @@ interface GenerateFileResumableUploadUrlRequest$1 {
     sizeInBytes?: string | null;
     /**
      * ID of the file's parent folder. <br />
+     * This folder is the path root for the `filePath`.<br />
      * Default: `media-root`.
      */
     parentFolderId?: string | null;
@@ -2312,11 +2313,10 @@ interface GenerateFileResumableUploadUrlRequest$1 {
     /** The upload protocol to use for implementing the resumable upload. */
     uploadProtocol?: UploadProtocol$1;
     /**
-     * The path by folder names to create the file under.
-     * In case a folder in the path does not exist it will be created
-     * If multiple folders with the same name exist, the first one will be used
-     * If `parentFolderId` is provided, the path will be nested under the folder specified by the `parentFolderId`
-     * example: 'videos/2024/december'
+     * Path to the folder where the file will be stored.
+     * For example, `/videos/2024/december`. <br/>
+     * If `parentFolderId` is defined, the parent folder is used as the path root. Otherwise, the root is `media-root`.
+     * The folders in the path will be created if they don't already exist.  <br />
      */
     filePath?: string | null;
 }
@@ -2344,6 +2344,7 @@ interface ImportFileRequest$1 {
     displayName?: string | null;
     /**
      * ID of the file's parent folder. <br />
+     * This folder is the path root for the `filePath`. <br />
      * Default: `media-root`.
      */
     parentFolderId?: string | null;
@@ -2360,11 +2361,10 @@ interface ImportFileRequest$1 {
     /** Optional headers that should be sent with the external URL. */
     urlHeaders?: Record<string, any> | null;
     /**
-     * The path by folder names to create the file under.
-     * In case a folder in the path does not exist it will be created
-     * If multiple folders with the same name exist, the first one will be used
-     * If `parentFolderId` is provided, the path will be nested under the folder specified by the `parentFolderId`
-     * example: 'videos/2024/december'
+     * Path to the folder where the file will be stored.
+     * For example, `/videos/2024/december`. <br/>
+     * If `parentFolderId` is defined, the parent folder is used as the path root. Otherwise, the root is `media-root`.
+     * The folders in the path will be created if they don't already exist.  <br />
      */
     filePath?: string | null;
 }
@@ -4117,6 +4117,7 @@ interface GenerateFileUploadUrlRequest {
     sizeInBytes?: string | null;
     /**
      * ID of the file's parent folder. <br />
+     * This folder is the path root for the `filePath`.<br />
      * Default: `media-root`.
      */
     parentFolderId?: string | null;
@@ -4127,11 +4128,10 @@ interface GenerateFileUploadUrlRequest {
     /** Information sent to the `onFileDescriptorFileReady( )` and `onFileDescriptorFileFailed( )` events. See the Importing Files article to learn more. */
     externalInfo?: ExternalInfo;
     /**
-     * The path by folder names to create the file under.
-     * In case a folder in the path does not exist it will be created
-     * If multiple folders with the same name exist, the first one will be used
-     * If `parentFolderId` is provided, the path will be nested under the folder specified by the `parentFolderId`
-     * example: 'videos/2024/december'
+     * Path to the folder where the file will be stored.
+     * For example, `/videos/2024/december`. <br/>
+     * If `parentFolderId` is defined, the parent folder is used as the path root. Otherwise, the root is `media-root`.
+     * The folders in the path will be created if they don't already exist.  <br />
      */
     filePath?: string | null;
 }
@@ -4154,6 +4154,7 @@ interface GenerateFileResumableUploadUrlRequest {
     sizeInBytes?: string | null;
     /**
      * ID of the file's parent folder. <br />
+     * This folder is the path root for the `filePath`.<br />
      * Default: `media-root`.
      */
     parentFolderId?: string | null;
@@ -4164,11 +4165,10 @@ interface GenerateFileResumableUploadUrlRequest {
     /** The upload protocol to use for implementing the resumable upload. */
     uploadProtocol?: UploadProtocol;
     /**
-     * The path by folder names to create the file under.
-     * In case a folder in the path does not exist it will be created
-     * If multiple folders with the same name exist, the first one will be used
-     * If `parentFolderId` is provided, the path will be nested under the folder specified by the `parentFolderId`
-     * example: 'videos/2024/december'
+     * Path to the folder where the file will be stored.
+     * For example, `/videos/2024/december`. <br/>
+     * If `parentFolderId` is defined, the parent folder is used as the path root. Otherwise, the root is `media-root`.
+     * The folders in the path will be created if they don't already exist.  <br />
      */
     filePath?: string | null;
 }
@@ -4197,6 +4197,7 @@ interface ImportFileRequest {
     displayName?: string | null;
     /**
      * ID of the file's parent folder. <br />
+     * This folder is the path root for the `filePath`. <br />
      * Default: `media-root`.
      */
     parentFolderId?: string | null;
@@ -4213,11 +4214,10 @@ interface ImportFileRequest {
     /** Optional headers that should be sent with the external URL. */
     urlHeaders?: Record<string, any> | null;
     /**
-     * The path by folder names to create the file under.
-     * In case a folder in the path does not exist it will be created
-     * If multiple folders with the same name exist, the first one will be used
-     * If `parentFolderId` is provided, the path will be nested under the folder specified by the `parentFolderId`
-     * example: 'videos/2024/december'
+     * Path to the folder where the file will be stored.
+     * For example, `/videos/2024/december`. <br/>
+     * If `parentFolderId` is defined, the parent folder is used as the path root. Otherwise, the root is `media-root`.
+     * The folders in the path will be created if they don't already exist.  <br />
      */
     filePath?: string | null;
 }