@wix/media 1.0.99 → 1.0.101

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/media",
-  "version": "1.0.99",
+  "version": "1.0.101",
   "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": "c76d28058cb06cdb69d13faed46ebe090783381220604da41c83a9db"
 }

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

@@ -181,41 +181,41 @@ interface EnterpriseOnboardingOptions {
     accountName?: string;
 }
 
-type RESTFunctionDescriptor$3<T extends (...args: any[]) => any = (...args: any[]) => any> = (httpClient: HttpClient$3) => T;
-interface HttpClient$3 {
-    request<TResponse, TData = any>(req: RequestOptionsFactory$3<TResponse, TData>): Promise<HttpResponse$3<TResponse>>;
+type RESTFunctionDescriptor<T extends (...args: any[]) => any = (...args: any[]) => any> = (httpClient: HttpClient) => T;
+interface HttpClient {
+    request<TResponse, TData = any>(req: RequestOptionsFactory<TResponse, TData>): Promise<HttpResponse<TResponse>>;
     fetchWithAuth: (url: string | URL, init?: RequestInit) => Promise<Response>;
 }
-type RequestOptionsFactory$3<TResponse = any, TData = any> = (context: any) => RequestOptions$3<TResponse, TData>;
-type HttpResponse$3<T = any> = {
+type RequestOptionsFactory<TResponse = any, TData = any> = (context: any) => RequestOptions<TResponse, TData>;
+type HttpResponse<T = any> = {
     data: T;
     status: number;
     statusText: string;
     headers: any;
     request?: any;
 };
-type RequestOptions$3<_TResponse = any, Data = any> = {
+type RequestOptions<_TResponse = any, Data = any> = {
     method: 'POST' | 'GET' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
     url: string;
     data?: Data;
     params?: URLSearchParams;
-} & APIMetadata$3;
-type APIMetadata$3 = {
+} & APIMetadata;
+type APIMetadata = {
     methodFqn?: string;
     entityFqdn?: string;
     packageName?: string;
 };
-type BuildRESTFunction$3<T extends RESTFunctionDescriptor$3> = T extends RESTFunctionDescriptor$3<infer U> ? U : never;
-type EventDefinition$3<Payload = unknown, Type extends string = string> = {
+type BuildRESTFunction<T extends RESTFunctionDescriptor> = T extends RESTFunctionDescriptor<infer U> ? U : never;
+type EventDefinition<Payload = unknown, Type extends string = string> = {
     __type: 'event-definition';
     type: Type;
     isDomainEvent?: boolean;
     transformations?: (envelope: unknown) => Payload;
     __payload: Payload;
 };
-declare function EventDefinition$3<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition$3<Payload, Type>;
-type EventHandler$3<T extends EventDefinition$3> = (payload: T['__payload']) => void | Promise<void>;
-type BuildEventDefinition$3<T extends EventDefinition$3<any, string>> = (handler: EventHandler$3<T>) => void;
+declare function EventDefinition<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition<Payload, Type>;
+type EventHandler<T extends EventDefinition> = (payload: T['__payload']) => void | Promise<void>;
+type BuildEventDefinition<T extends EventDefinition<any, string>> = (handler: EventHandler<T>) => void;
 
 declare global {
 	// eslint-disable-next-line @typescript-eslint/consistent-type-definitions -- It has to be an `interface` so that it can be merged.
@@ -224,37 +224,37 @@ declare global {
 	}
 }
 
-declare function createCategory$1(httpClient: HttpClient$3): (category: EnterpriseCategory) => Promise<EnterpriseCategory & {
+declare function createCategory$1(httpClient: HttpClient): (category: EnterpriseCategory) => Promise<EnterpriseCategory & {
     _id: string;
     publishStatus: PublishStatus$1;
 }>;
-declare function deleteCategory$1(httpClient: HttpClient$3): (categoryId: string) => Promise<void>;
-declare function updateCategory$1(httpClient: HttpClient$3): (_id: string, category: UpdateCategory) => Promise<EnterpriseCategory & {
+declare function deleteCategory$1(httpClient: HttpClient): (categoryId: string) => Promise<void>;
+declare function updateCategory$1(httpClient: HttpClient): (_id: string, category: UpdateCategory) => Promise<EnterpriseCategory & {
     _id: string;
     publishStatus: PublishStatus$1;
 }>;
-declare function getCategory$1(httpClient: HttpClient$3): (categoryId: string, options?: GetCategoryOptions) => Promise<EnterpriseCategoryTree & {
+declare function getCategory$1(httpClient: HttpClient): (categoryId: string, options?: GetCategoryOptions) => Promise<EnterpriseCategoryTree & {
     category?: {
         _id: string;
         publishStatus: PublishStatus$1;
     } | undefined;
     subCategories: (any | undefined)[];
 }>;
-declare function enterpriseOnboarding$1(httpClient: HttpClient$3): (accountId: string, options?: EnterpriseOnboardingOptions) => Promise<EnterpriseOnboardingResponse & EnterpriseOnboardingResponseNonNullableFields>;
-declare function getMediaManagerCategories$1(httpClient: HttpClient$3): () => Promise<GetMediaManagerCategoriesResponse & GetMediaManagerCategoriesResponseNonNullableFields>;
-declare const onEnterpriseCategoryCreated$1: EventDefinition$3<EnterpriseCategoryCreatedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_category_created">;
-declare const onEnterpriseCategoryDeleted$1: EventDefinition$3<EnterpriseCategoryDeletedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_category_deleted">;
-declare const onEnterpriseCategoryUpdated$1: EventDefinition$3<EnterpriseCategoryUpdatedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_category_updated">;
+declare function enterpriseOnboarding$1(httpClient: HttpClient): (accountId: string, options?: EnterpriseOnboardingOptions) => Promise<EnterpriseOnboardingResponse & EnterpriseOnboardingResponseNonNullableFields>;
+declare function getMediaManagerCategories$1(httpClient: HttpClient): () => Promise<GetMediaManagerCategoriesResponse & GetMediaManagerCategoriesResponseNonNullableFields>;
+declare const onEnterpriseCategoryCreated$1: EventDefinition<EnterpriseCategoryCreatedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_category_created">;
+declare const onEnterpriseCategoryDeleted$1: EventDefinition<EnterpriseCategoryDeletedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_category_deleted">;
+declare const onEnterpriseCategoryUpdated$1: EventDefinition<EnterpriseCategoryUpdatedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_category_updated">;
 
-declare const createCategory: BuildRESTFunction$3<typeof createCategory$1>;
-declare const deleteCategory: BuildRESTFunction$3<typeof deleteCategory$1>;
-declare const updateCategory: BuildRESTFunction$3<typeof updateCategory$1>;
-declare const getCategory: BuildRESTFunction$3<typeof getCategory$1>;
-declare const enterpriseOnboarding: BuildRESTFunction$3<typeof enterpriseOnboarding$1>;
-declare const getMediaManagerCategories: BuildRESTFunction$3<typeof getMediaManagerCategories$1>;
-declare const onEnterpriseCategoryCreated: BuildEventDefinition$3<typeof onEnterpriseCategoryCreated$1>;
-declare const onEnterpriseCategoryDeleted: BuildEventDefinition$3<typeof onEnterpriseCategoryDeleted$1>;
-declare const onEnterpriseCategoryUpdated: BuildEventDefinition$3<typeof onEnterpriseCategoryUpdated$1>;
+declare const createCategory: BuildRESTFunction<typeof createCategory$1>;
+declare const deleteCategory: BuildRESTFunction<typeof deleteCategory$1>;
+declare const updateCategory: BuildRESTFunction<typeof updateCategory$1>;
+declare const getCategory: BuildRESTFunction<typeof getCategory$1>;
+declare const enterpriseOnboarding: BuildRESTFunction<typeof enterpriseOnboarding$1>;
+declare const getMediaManagerCategories: BuildRESTFunction<typeof getMediaManagerCategories$1>;
+declare const onEnterpriseCategoryCreated: BuildEventDefinition<typeof onEnterpriseCategoryCreated$1>;
+declare const onEnterpriseCategoryDeleted: BuildEventDefinition<typeof onEnterpriseCategoryDeleted$1>;
+declare const onEnterpriseCategoryUpdated: BuildEventDefinition<typeof onEnterpriseCategoryUpdated$1>;
 
 declare const context$3_createCategory: typeof createCategory;
 declare const context$3_deleteCategory: typeof deleteCategory;
@@ -903,55 +903,12 @@ interface OverwriteItemCategoriesOptions {
     categoryIds?: string[];
 }
 
-type RESTFunctionDescriptor$2<T extends (...args: any[]) => any = (...args: any[]) => any> = (httpClient: HttpClient$2) => T;
-interface HttpClient$2 {
-    request<TResponse, TData = any>(req: RequestOptionsFactory$2<TResponse, TData>): Promise<HttpResponse$2<TResponse>>;
-    fetchWithAuth: (url: string | URL, init?: RequestInit) => Promise<Response>;
-}
-type RequestOptionsFactory$2<TResponse = any, TData = any> = (context: any) => RequestOptions$2<TResponse, TData>;
-type HttpResponse$2<T = any> = {
-    data: T;
-    status: number;
-    statusText: string;
-    headers: any;
-    request?: any;
-};
-type RequestOptions$2<_TResponse = any, Data = any> = {
-    method: 'POST' | 'GET' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
-    url: string;
-    data?: Data;
-    params?: URLSearchParams;
-} & APIMetadata$2;
-type APIMetadata$2 = {
-    methodFqn?: string;
-    entityFqdn?: string;
-    packageName?: string;
-};
-type BuildRESTFunction$2<T extends RESTFunctionDescriptor$2> = T extends RESTFunctionDescriptor$2<infer U> ? U : never;
-type EventDefinition$2<Payload = unknown, Type extends string = string> = {
-    __type: 'event-definition';
-    type: Type;
-    isDomainEvent?: boolean;
-    transformations?: (envelope: unknown) => Payload;
-    __payload: Payload;
-};
-declare function EventDefinition$2<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition$2<Payload, Type>;
-type EventHandler$2<T extends EventDefinition$2> = (payload: T['__payload']) => void | Promise<void>;
-type BuildEventDefinition$2<T extends EventDefinition$2<any, string>> = (handler: EventHandler$2<T>) => void;
-
-declare global {
-	// eslint-disable-next-line @typescript-eslint/consistent-type-definitions -- It has to be an `interface` so that it can be merged.
-	interface SymbolConstructor {
-		readonly observable: symbol;
-	}
-}
-
-declare function itemUploadCallback$1(httpClient: HttpClient$2): (options?: ItemUploadCallbackOptions) => Promise<void>;
-declare function generateFileUploadUrl$3(httpClient: HttpClient$2): (options?: GenerateFileUploadUrlOptions$1) => Promise<GenerateFileUploadUrlResponse$1 & GenerateFileUploadUrlResponseNonNullableFields$1>;
-declare function importFile$3(httpClient: HttpClient$2): (url: string, options?: ImportFileOptions$1) => Promise<ImportFileResponse$1 & ImportFileResponseNonNullableFields$1>;
-declare function searchItems$1(httpClient: HttpClient$2): (options?: SearchItemsOptions) => Promise<SearchItemsResponse & SearchItemsResponseNonNullableFields>;
-declare function queryItems$1(httpClient: HttpClient$2): () => ItemsQueryBuilder;
-declare function updateItem$1(httpClient: HttpClient$2): (_id: string, item: UpdateItem) => Promise<EnterpriseMediaItem & {
+declare function itemUploadCallback$1(httpClient: HttpClient): (options?: ItemUploadCallbackOptions) => Promise<void>;
+declare function generateFileUploadUrl$3(httpClient: HttpClient): (options?: GenerateFileUploadUrlOptions$1) => Promise<GenerateFileUploadUrlResponse$1 & GenerateFileUploadUrlResponseNonNullableFields$1>;
+declare function importFile$3(httpClient: HttpClient): (url: string, options?: ImportFileOptions$1) => Promise<ImportFileResponse$1 & ImportFileResponseNonNullableFields$1>;
+declare function searchItems$1(httpClient: HttpClient): (options?: SearchItemsOptions) => Promise<SearchItemsResponse & SearchItemsResponseNonNullableFields>;
+declare function queryItems$1(httpClient: HttpClient): () => ItemsQueryBuilder;
+declare function updateItem$1(httpClient: HttpClient): (_id: string, item: UpdateItem) => Promise<EnterpriseMediaItem & {
     _id: string;
     mediaType: MediaType$1;
     assets?: {
@@ -972,8 +929,8 @@ declare function updateItem$1(httpClient: HttpClient$2): (_id: string, item: Upd
     } | undefined;
     publishStatus: PublishStatus;
 }>;
-declare function bulkUpdateItem$1(httpClient: HttpClient$2): (updateItemRequests: UpdateItemRequest[], options?: BulkUpdateItemOptions) => Promise<BulkUpdateItemResponse & BulkUpdateItemResponseNonNullableFields>;
-declare function getItem$1(httpClient: HttpClient$2): (itemId: string) => Promise<EnterpriseMediaItem & {
+declare function bulkUpdateItem$1(httpClient: HttpClient): (updateItemRequests: UpdateItemRequest[], options?: BulkUpdateItemOptions) => Promise<BulkUpdateItemResponse & BulkUpdateItemResponseNonNullableFields>;
+declare function getItem$1(httpClient: HttpClient): (itemId: string) => Promise<EnterpriseMediaItem & {
     _id: string;
     mediaType: MediaType$1;
     assets?: {
@@ -994,29 +951,29 @@ declare function getItem$1(httpClient: HttpClient$2): (itemId: string) => Promis
     } | undefined;
     publishStatus: PublishStatus;
 }>;
-declare function linkItemToCategories$1(httpClient: HttpClient$2): (itemId: string, options?: LinkItemToCategoriesOptions) => Promise<LinkItemToCategoriesResponse>;
-declare function unlinkItemFromCategories$1(httpClient: HttpClient$2): (itemId: string, options?: UnlinkItemFromCategoriesOptions) => Promise<UnlinkItemFromCategoriesResponse>;
-declare function overwriteItemCategories$1(httpClient: HttpClient$2): (itemId: string, options?: OverwriteItemCategoriesOptions) => Promise<OverwriteItemCategoriesResponse>;
-declare const onEnterpriseItemCreated$1: EventDefinition$2<EnterpriseItemCreatedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_item_created">;
-declare const onEnterpriseItemUpdated$1: EventDefinition$2<EnterpriseItemUpdatedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_item_updated">;
-declare const onEnterpriseItemItemCategoriesChanged$1: EventDefinition$2<EnterpriseItemItemCategoriesChangedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_item_item_categories_changed">;
-declare const onEnterpriseItemPublishStatusChanged$1: EventDefinition$2<EnterpriseItemPublishStatusChangedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_item_publish_status_changed">;
+declare function linkItemToCategories$1(httpClient: HttpClient): (itemId: string, options?: LinkItemToCategoriesOptions) => Promise<LinkItemToCategoriesResponse>;
+declare function unlinkItemFromCategories$1(httpClient: HttpClient): (itemId: string, options?: UnlinkItemFromCategoriesOptions) => Promise<UnlinkItemFromCategoriesResponse>;
+declare function overwriteItemCategories$1(httpClient: HttpClient): (itemId: string, options?: OverwriteItemCategoriesOptions) => Promise<OverwriteItemCategoriesResponse>;
+declare const onEnterpriseItemCreated$1: EventDefinition<EnterpriseItemCreatedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_item_created">;
+declare const onEnterpriseItemUpdated$1: EventDefinition<EnterpriseItemUpdatedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_item_updated">;
+declare const onEnterpriseItemItemCategoriesChanged$1: EventDefinition<EnterpriseItemItemCategoriesChangedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_item_item_categories_changed">;
+declare const onEnterpriseItemPublishStatusChanged$1: EventDefinition<EnterpriseItemPublishStatusChangedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_item_publish_status_changed">;
 
-declare const itemUploadCallback: BuildRESTFunction$2<typeof itemUploadCallback$1>;
-declare const generateFileUploadUrl$2: BuildRESTFunction$2<typeof generateFileUploadUrl$3>;
-declare const importFile$2: BuildRESTFunction$2<typeof importFile$3>;
-declare const searchItems: BuildRESTFunction$2<typeof searchItems$1>;
-declare const queryItems: BuildRESTFunction$2<typeof queryItems$1>;
-declare const updateItem: BuildRESTFunction$2<typeof updateItem$1>;
-declare const bulkUpdateItem: BuildRESTFunction$2<typeof bulkUpdateItem$1>;
-declare const getItem: BuildRESTFunction$2<typeof getItem$1>;
-declare const linkItemToCategories: BuildRESTFunction$2<typeof linkItemToCategories$1>;
-declare const unlinkItemFromCategories: BuildRESTFunction$2<typeof unlinkItemFromCategories$1>;
-declare const overwriteItemCategories: BuildRESTFunction$2<typeof overwriteItemCategories$1>;
-declare const onEnterpriseItemCreated: BuildEventDefinition$2<typeof onEnterpriseItemCreated$1>;
-declare const onEnterpriseItemUpdated: BuildEventDefinition$2<typeof onEnterpriseItemUpdated$1>;
-declare const onEnterpriseItemItemCategoriesChanged: BuildEventDefinition$2<typeof onEnterpriseItemItemCategoriesChanged$1>;
-declare const onEnterpriseItemPublishStatusChanged: BuildEventDefinition$2<typeof onEnterpriseItemPublishStatusChanged$1>;
+declare const itemUploadCallback: BuildRESTFunction<typeof itemUploadCallback$1>;
+declare const generateFileUploadUrl$2: BuildRESTFunction<typeof generateFileUploadUrl$3>;
+declare const importFile$2: BuildRESTFunction<typeof importFile$3>;
+declare const searchItems: BuildRESTFunction<typeof searchItems$1>;
+declare const queryItems: BuildRESTFunction<typeof queryItems$1>;
+declare const updateItem: BuildRESTFunction<typeof updateItem$1>;
+declare const bulkUpdateItem: BuildRESTFunction<typeof bulkUpdateItem$1>;
+declare const getItem: BuildRESTFunction<typeof getItem$1>;
+declare const linkItemToCategories: BuildRESTFunction<typeof linkItemToCategories$1>;
+declare const unlinkItemFromCategories: BuildRESTFunction<typeof unlinkItemFromCategories$1>;
+declare const overwriteItemCategories: BuildRESTFunction<typeof overwriteItemCategories$1>;
+declare const onEnterpriseItemCreated: BuildEventDefinition<typeof onEnterpriseItemCreated$1>;
+declare const onEnterpriseItemUpdated: BuildEventDefinition<typeof onEnterpriseItemUpdated$1>;
+declare const onEnterpriseItemItemCategoriesChanged: BuildEventDefinition<typeof onEnterpriseItemItemCategoriesChanged$1>;
+declare const onEnterpriseItemPublishStatusChanged: BuildEventDefinition<typeof onEnterpriseItemPublishStatusChanged$1>;
 
 declare const context$2_bulkUpdateItem: typeof bulkUpdateItem;
 declare const context$2_getItem: typeof getItem;
@@ -1379,6 +1336,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 +1353,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 +2060,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 +2071,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 +2091,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 +2106,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 +2120,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 +2137,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;
 }
@@ -2287,52 +2244,9 @@ interface ListDeletedFilesOptions {
     paging?: CursorPaging$1;
 }
 
-type RESTFunctionDescriptor$1<T extends (...args: any[]) => any = (...args: any[]) => any> = (httpClient: HttpClient$1) => T;
-interface HttpClient$1 {
-    request<TResponse, TData = any>(req: RequestOptionsFactory$1<TResponse, TData>): Promise<HttpResponse$1<TResponse>>;
-    fetchWithAuth: (url: string | URL, init?: RequestInit) => Promise<Response>;
-}
-type RequestOptionsFactory$1<TResponse = any, TData = any> = (context: any) => RequestOptions$1<TResponse, TData>;
-type HttpResponse$1<T = any> = {
-    data: T;
-    status: number;
-    statusText: string;
-    headers: any;
-    request?: any;
-};
-type RequestOptions$1<_TResponse = any, Data = any> = {
-    method: 'POST' | 'GET' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
-    url: string;
-    data?: Data;
-    params?: URLSearchParams;
-} & APIMetadata$1;
-type APIMetadata$1 = {
-    methodFqn?: string;
-    entityFqdn?: string;
-    packageName?: string;
-};
-type BuildRESTFunction$1<T extends RESTFunctionDescriptor$1> = T extends RESTFunctionDescriptor$1<infer U> ? U : never;
-type EventDefinition$1<Payload = unknown, Type extends string = string> = {
-    __type: 'event-definition';
-    type: Type;
-    isDomainEvent?: boolean;
-    transformations?: (envelope: unknown) => Payload;
-    __payload: Payload;
-};
-declare function EventDefinition$1<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition$1<Payload, Type>;
-type EventHandler$1<T extends EventDefinition$1> = (payload: T['__payload']) => void | Promise<void>;
-type BuildEventDefinition$1<T extends EventDefinition$1<any, string>> = (handler: EventHandler$1<T>) => void;
-
-declare global {
-	// eslint-disable-next-line @typescript-eslint/consistent-type-definitions -- It has to be an `interface` so that it can be merged.
-	interface SymbolConstructor {
-		readonly observable: symbol;
-	}
-}
-
-declare function generateFilesDownloadUrl$1(httpClient: HttpClient$1): (fileIds: string[]) => Promise<GenerateFilesDownloadUrlResponse & GenerateFilesDownloadUrlResponseNonNullableFields>;
-declare function generateFileDownloadUrl$1(httpClient: HttpClient$1): (fileId: string, options?: GenerateFileDownloadUrlOptions) => Promise<GenerateFileDownloadUrlResponse & GenerateFileDownloadUrlResponseNonNullableFields>;
-declare function getFileDescriptor$1(httpClient: HttpClient$1): (fileId: string) => Promise<FileDescriptor & {
+declare function generateFilesDownloadUrl$1(httpClient: HttpClient): (fileIds: string[]) => Promise<GenerateFilesDownloadUrlResponse & GenerateFilesDownloadUrlResponseNonNullableFields>;
+declare function generateFileDownloadUrl$1(httpClient: HttpClient): (fileId: string, options?: GenerateFileDownloadUrlOptions) => Promise<GenerateFileDownloadUrlResponse & GenerateFileDownloadUrlResponseNonNullableFields>;
+declare function getFileDescriptor$1(httpClient: HttpClient): (fileId: string) => Promise<FileDescriptor & {
     _id: string;
     displayName: string;
     url: string;
@@ -2389,8 +2303,8 @@ declare function getFileDescriptor$1(httpClient: HttpClient$1): (fileId: string)
     siteId: string;
     state: State$1;
 }>;
-declare function getFileDescriptors$1(httpClient: HttpClient$1): (fileIds: string[]) => Promise<GetFileDescriptorsResponse & GetFileDescriptorsResponseNonNullableFields>;
-declare function updateFileDescriptor$1(httpClient: HttpClient$1): (file: FileDescriptor) => Promise<FileDescriptor & {
+declare function getFileDescriptors$1(httpClient: HttpClient): (fileIds: string[]) => Promise<GetFileDescriptorsResponse & GetFileDescriptorsResponseNonNullableFields>;
+declare function updateFileDescriptor$1(httpClient: HttpClient): (file: FileDescriptor) => Promise<FileDescriptor & {
     _id: string;
     displayName: string;
     url: string;
@@ -2447,42 +2361,42 @@ declare function updateFileDescriptor$1(httpClient: HttpClient$1): (file: FileDe
     siteId: string;
     state: State$1;
 }>;
-declare function generateFileUploadUrl$1(httpClient: HttpClient$1): (mimeType: string | null, options?: GenerateFileUploadUrlOptions) => Promise<GenerateFileUploadUrlResponse & GenerateFileUploadUrlResponseNonNullableFields>;
-declare function generateFileResumableUploadUrl$1(httpClient: HttpClient$1): (mimeType: string | null, options?: GenerateFileResumableUploadUrlOptions) => Promise<GenerateFileResumableUploadUrlResponse & GenerateFileResumableUploadUrlResponseNonNullableFields>;
-declare function importFile$1(httpClient: HttpClient$1): (url: string, options?: ImportFileOptions) => Promise<ImportFileResponse & ImportFileResponseNonNullableFields>;
-declare function bulkImportFiles$1(httpClient: HttpClient$1): (importFileRequests: ImportFileRequest[]) => Promise<BulkImportFilesResponse & BulkImportFilesResponseNonNullableFields>;
-declare function bulkImportFile$1(httpClient: HttpClient$1): (importFileRequests: ImportFileRequest[], options?: BulkImportFileOptions) => Promise<BulkImportFileResponse & BulkImportFileResponseNonNullableFields>;
-declare function listFiles$1(httpClient: HttpClient$1): (options?: ListFilesOptions) => Promise<ListFilesResponse & ListFilesResponseNonNullableFields>;
-declare function searchFiles$1(httpClient: HttpClient$1): (options?: SearchFilesOptions) => Promise<SearchFilesResponse & SearchFilesResponseNonNullableFields>;
-declare function generateVideoStreamingUrl$1(httpClient: HttpClient$1): (fileId: string, options?: GenerateVideoStreamingUrlOptions) => Promise<GenerateVideoStreamingUrlResponse & GenerateVideoStreamingUrlResponseNonNullableFields>;
-declare function bulkDeleteFiles$1(httpClient: HttpClient$1): (fileIds: string[], options?: BulkDeleteFilesOptions) => Promise<void>;
-declare function bulkRestoreFilesFromTrashBin$1(httpClient: HttpClient$1): (fileIds: string[]) => Promise<void>;
-declare function listDeletedFiles$1(httpClient: HttpClient$1): (options?: ListDeletedFilesOptions) => Promise<ListDeletedFilesResponse & ListDeletedFilesResponseNonNullableFields>;
-declare const onFileDescriptorUpdated$1: EventDefinition$1<FileDescriptorUpdatedEnvelope, "wix.media.site_media.v1.file_descriptor_updated">;
-declare const onFileDescriptorDeleted$1: EventDefinition$1<FileDescriptorDeletedEnvelope, "wix.media.site_media.v1.file_descriptor_deleted">;
-declare const onFileDescriptorFileReady$1: EventDefinition$1<FileDescriptorFileReadyEnvelope, "wix.media.site_media.v1.file_descriptor_file_ready">;
-declare const onFileDescriptorFileFailed$1: EventDefinition$1<FileDescriptorFileFailedEnvelope, "wix.media.site_media.v1.file_descriptor_file_failed">;
+declare function generateFileUploadUrl$1(httpClient: HttpClient): (mimeType: string | null, options?: GenerateFileUploadUrlOptions) => Promise<GenerateFileUploadUrlResponse & GenerateFileUploadUrlResponseNonNullableFields>;
+declare function generateFileResumableUploadUrl$1(httpClient: HttpClient): (mimeType: string | null, options?: GenerateFileResumableUploadUrlOptions) => Promise<GenerateFileResumableUploadUrlResponse & GenerateFileResumableUploadUrlResponseNonNullableFields>;
+declare function importFile$1(httpClient: HttpClient): (url: string, options?: ImportFileOptions) => Promise<ImportFileResponse & ImportFileResponseNonNullableFields>;
+declare function bulkImportFiles$1(httpClient: HttpClient): (importFileRequests: ImportFileRequest[]) => Promise<BulkImportFilesResponse & BulkImportFilesResponseNonNullableFields>;
+declare function bulkImportFile$1(httpClient: HttpClient): (importFileRequests: ImportFileRequest[], options?: BulkImportFileOptions) => Promise<BulkImportFileResponse & BulkImportFileResponseNonNullableFields>;
+declare function listFiles$1(httpClient: HttpClient): (options?: ListFilesOptions) => Promise<ListFilesResponse & ListFilesResponseNonNullableFields>;
+declare function searchFiles$1(httpClient: HttpClient): (options?: SearchFilesOptions) => Promise<SearchFilesResponse & SearchFilesResponseNonNullableFields>;
+declare function generateVideoStreamingUrl$1(httpClient: HttpClient): (fileId: string, options?: GenerateVideoStreamingUrlOptions) => Promise<GenerateVideoStreamingUrlResponse & GenerateVideoStreamingUrlResponseNonNullableFields>;
+declare function bulkDeleteFiles$1(httpClient: HttpClient): (fileIds: string[], options?: BulkDeleteFilesOptions) => Promise<void>;
+declare function bulkRestoreFilesFromTrashBin$1(httpClient: HttpClient): (fileIds: string[]) => Promise<void>;
+declare function listDeletedFiles$1(httpClient: HttpClient): (options?: ListDeletedFilesOptions) => Promise<ListDeletedFilesResponse & ListDeletedFilesResponseNonNullableFields>;
+declare const onFileDescriptorUpdated$1: EventDefinition<FileDescriptorUpdatedEnvelope, "wix.media.site_media.v1.file_descriptor_updated">;
+declare const onFileDescriptorDeleted$1: EventDefinition<FileDescriptorDeletedEnvelope, "wix.media.site_media.v1.file_descriptor_deleted">;
+declare const onFileDescriptorFileReady$1: EventDefinition<FileDescriptorFileReadyEnvelope, "wix.media.site_media.v1.file_descriptor_file_ready">;
+declare const onFileDescriptorFileFailed$1: EventDefinition<FileDescriptorFileFailedEnvelope, "wix.media.site_media.v1.file_descriptor_file_failed">;
 
-declare const generateFilesDownloadUrl: BuildRESTFunction$1<typeof generateFilesDownloadUrl$1>;
-declare const generateFileDownloadUrl: BuildRESTFunction$1<typeof generateFileDownloadUrl$1>;
-declare const getFileDescriptor: BuildRESTFunction$1<typeof getFileDescriptor$1>;
-declare const getFileDescriptors: BuildRESTFunction$1<typeof getFileDescriptors$1>;
-declare const updateFileDescriptor: BuildRESTFunction$1<typeof updateFileDescriptor$1>;
-declare const generateFileUploadUrl: BuildRESTFunction$1<typeof generateFileUploadUrl$1>;
-declare const generateFileResumableUploadUrl: BuildRESTFunction$1<typeof generateFileResumableUploadUrl$1>;
-declare const importFile: BuildRESTFunction$1<typeof importFile$1>;
-declare const bulkImportFiles: BuildRESTFunction$1<typeof bulkImportFiles$1>;
-declare const bulkImportFile: BuildRESTFunction$1<typeof bulkImportFile$1>;
-declare const listFiles: BuildRESTFunction$1<typeof listFiles$1>;
-declare const searchFiles: BuildRESTFunction$1<typeof searchFiles$1>;
-declare const generateVideoStreamingUrl: BuildRESTFunction$1<typeof generateVideoStreamingUrl$1>;
-declare const bulkDeleteFiles: BuildRESTFunction$1<typeof bulkDeleteFiles$1>;
-declare const bulkRestoreFilesFromTrashBin: BuildRESTFunction$1<typeof bulkRestoreFilesFromTrashBin$1>;
-declare const listDeletedFiles: BuildRESTFunction$1<typeof listDeletedFiles$1>;
-declare const onFileDescriptorUpdated: BuildEventDefinition$1<typeof onFileDescriptorUpdated$1>;
-declare const onFileDescriptorDeleted: BuildEventDefinition$1<typeof onFileDescriptorDeleted$1>;
-declare const onFileDescriptorFileReady: BuildEventDefinition$1<typeof onFileDescriptorFileReady$1>;
-declare const onFileDescriptorFileFailed: BuildEventDefinition$1<typeof onFileDescriptorFileFailed$1>;
+declare const generateFilesDownloadUrl: BuildRESTFunction<typeof generateFilesDownloadUrl$1>;
+declare const generateFileDownloadUrl: BuildRESTFunction<typeof generateFileDownloadUrl$1>;
+declare const getFileDescriptor: BuildRESTFunction<typeof getFileDescriptor$1>;
+declare const getFileDescriptors: BuildRESTFunction<typeof getFileDescriptors$1>;
+declare const updateFileDescriptor: BuildRESTFunction<typeof updateFileDescriptor$1>;
+declare const generateFileUploadUrl: BuildRESTFunction<typeof generateFileUploadUrl$1>;
+declare const generateFileResumableUploadUrl: BuildRESTFunction<typeof generateFileResumableUploadUrl$1>;
+declare const importFile: BuildRESTFunction<typeof importFile$1>;
+declare const bulkImportFiles: BuildRESTFunction<typeof bulkImportFiles$1>;
+declare const bulkImportFile: BuildRESTFunction<typeof bulkImportFile$1>;
+declare const listFiles: BuildRESTFunction<typeof listFiles$1>;
+declare const searchFiles: BuildRESTFunction<typeof searchFiles$1>;
+declare const generateVideoStreamingUrl: BuildRESTFunction<typeof generateVideoStreamingUrl$1>;
+declare const bulkDeleteFiles: BuildRESTFunction<typeof bulkDeleteFiles$1>;
+declare const bulkRestoreFilesFromTrashBin: BuildRESTFunction<typeof bulkRestoreFilesFromTrashBin$1>;
+declare const listDeletedFiles: BuildRESTFunction<typeof listDeletedFiles$1>;
+declare const onFileDescriptorUpdated: BuildEventDefinition<typeof onFileDescriptorUpdated$1>;
+declare const onFileDescriptorDeleted: BuildEventDefinition<typeof onFileDescriptorDeleted$1>;
+declare const onFileDescriptorFileReady: BuildEventDefinition<typeof onFileDescriptorFileReady$1>;
+declare const onFileDescriptorFileFailed: BuildEventDefinition<typeof onFileDescriptorFileFailed$1>;
 
 declare const context$1_bulkDeleteFiles: typeof bulkDeleteFiles;
 declare const context$1_bulkImportFile: typeof bulkImportFile;
@@ -2811,49 +2725,6 @@ interface ListDeletedFoldersOptions {
     paging?: CursorPaging;
 }
 
-type RESTFunctionDescriptor<T extends (...args: any[]) => any = (...args: any[]) => any> = (httpClient: HttpClient) => T;
-interface HttpClient {
-    request<TResponse, TData = any>(req: RequestOptionsFactory<TResponse, TData>): Promise<HttpResponse<TResponse>>;
-    fetchWithAuth: (url: string | URL, init?: RequestInit) => Promise<Response>;
-}
-type RequestOptionsFactory<TResponse = any, TData = any> = (context: any) => RequestOptions<TResponse, TData>;
-type HttpResponse<T = any> = {
-    data: T;
-    status: number;
-    statusText: string;
-    headers: any;
-    request?: any;
-};
-type RequestOptions<_TResponse = any, Data = any> = {
-    method: 'POST' | 'GET' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
-    url: string;
-    data?: Data;
-    params?: URLSearchParams;
-} & APIMetadata;
-type APIMetadata = {
-    methodFqn?: string;
-    entityFqdn?: string;
-    packageName?: string;
-};
-type BuildRESTFunction<T extends RESTFunctionDescriptor> = T extends RESTFunctionDescriptor<infer U> ? U : never;
-type EventDefinition<Payload = unknown, Type extends string = string> = {
-    __type: 'event-definition';
-    type: Type;
-    isDomainEvent?: boolean;
-    transformations?: (envelope: unknown) => Payload;
-    __payload: Payload;
-};
-declare function EventDefinition<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition<Payload, Type>;
-type EventHandler<T extends EventDefinition> = (payload: T['__payload']) => void | Promise<void>;
-type BuildEventDefinition<T extends EventDefinition<any, string>> = (handler: EventHandler<T>) => void;
-
-declare global {
-	// eslint-disable-next-line @typescript-eslint/consistent-type-definitions -- It has to be an `interface` so that it can be merged.
-	interface SymbolConstructor {
-		readonly observable: symbol;
-	}
-}
-
 declare function createFolder$1(httpClient: HttpClient): (displayName: string, options?: CreateFolderOptions) => Promise<CreateFolderResponse & CreateFolderResponseNonNullableFields>;
 declare function getFolder$1(httpClient: HttpClient): (folderId: string) => Promise<Folder & {
     _id: string;

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

@@ -347,37 +347,37 @@ interface EnterpriseOnboardingOptions {
     accountName?: string;
 }
 
-interface HttpClient$3 {
-    request<TResponse, TData = any>(req: RequestOptionsFactory$3<TResponse, TData>): Promise<HttpResponse$3<TResponse>>;
+interface HttpClient {
+    request<TResponse, TData = any>(req: RequestOptionsFactory<TResponse, TData>): Promise<HttpResponse<TResponse>>;
     fetchWithAuth: (url: string | URL, init?: RequestInit) => Promise<Response>;
 }
-type RequestOptionsFactory$3<TResponse = any, TData = any> = (context: any) => RequestOptions$3<TResponse, TData>;
-type HttpResponse$3<T = any> = {
+type RequestOptionsFactory<TResponse = any, TData = any> = (context: any) => RequestOptions<TResponse, TData>;
+type HttpResponse<T = any> = {
     data: T;
     status: number;
     statusText: string;
     headers: any;
     request?: any;
 };
-type RequestOptions$3<_TResponse = any, Data = any> = {
+type RequestOptions<_TResponse = any, Data = any> = {
     method: 'POST' | 'GET' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
     url: string;
     data?: Data;
     params?: URLSearchParams;
-} & APIMetadata$3;
-type APIMetadata$3 = {
+} & APIMetadata;
+type APIMetadata = {
     methodFqn?: string;
     entityFqdn?: string;
     packageName?: string;
 };
-type EventDefinition$3<Payload = unknown, Type extends string = string> = {
+type EventDefinition<Payload = unknown, Type extends string = string> = {
     __type: 'event-definition';
     type: Type;
     isDomainEvent?: boolean;
     transformations?: (envelope: unknown) => Payload;
     __payload: Payload;
 };
-declare function EventDefinition$3<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition$3<Payload, Type>;
+declare function EventDefinition<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition<Payload, Type>;
 
 declare global {
 	// eslint-disable-next-line @typescript-eslint/consistent-type-definitions -- It has to be an `interface` so that it can be merged.
@@ -389,27 +389,27 @@ declare global {
 declare const __metadata$3: {
     PACKAGE_NAME: string;
 };
-declare function createCategory(httpClient: HttpClient$3): (category: EnterpriseCategory) => Promise<EnterpriseCategory & {
+declare function createCategory(httpClient: HttpClient): (category: EnterpriseCategory) => Promise<EnterpriseCategory & {
     _id: string;
     publishStatus: PublishStatus$1;
 }>;
-declare function deleteCategory(httpClient: HttpClient$3): (categoryId: string) => Promise<void>;
-declare function updateCategory(httpClient: HttpClient$3): (_id: string, category: UpdateCategory) => Promise<EnterpriseCategory & {
+declare function deleteCategory(httpClient: HttpClient): (categoryId: string) => Promise<void>;
+declare function updateCategory(httpClient: HttpClient): (_id: string, category: UpdateCategory) => Promise<EnterpriseCategory & {
     _id: string;
     publishStatus: PublishStatus$1;
 }>;
-declare function getCategory(httpClient: HttpClient$3): (categoryId: string, options?: GetCategoryOptions) => Promise<EnterpriseCategoryTree & {
+declare function getCategory(httpClient: HttpClient): (categoryId: string, options?: GetCategoryOptions) => Promise<EnterpriseCategoryTree & {
     category?: {
         _id: string;
         publishStatus: PublishStatus$1;
     } | undefined;
     subCategories: (any | undefined)[];
 }>;
-declare function enterpriseOnboarding(httpClient: HttpClient$3): (accountId: string, options?: EnterpriseOnboardingOptions) => Promise<EnterpriseOnboardingResponse & EnterpriseOnboardingResponseNonNullableFields>;
-declare function getMediaManagerCategories(httpClient: HttpClient$3): () => Promise<GetMediaManagerCategoriesResponse & GetMediaManagerCategoriesResponseNonNullableFields>;
-declare const onEnterpriseCategoryCreated: EventDefinition$3<EnterpriseCategoryCreatedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_category_created">;
-declare const onEnterpriseCategoryDeleted: EventDefinition$3<EnterpriseCategoryDeletedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_category_deleted">;
-declare const onEnterpriseCategoryUpdated: EventDefinition$3<EnterpriseCategoryUpdatedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_category_updated">;
+declare function enterpriseOnboarding(httpClient: HttpClient): (accountId: string, options?: EnterpriseOnboardingOptions) => Promise<EnterpriseOnboardingResponse & EnterpriseOnboardingResponseNonNullableFields>;
+declare function getMediaManagerCategories(httpClient: HttpClient): () => Promise<GetMediaManagerCategoriesResponse & GetMediaManagerCategoriesResponseNonNullableFields>;
+declare const onEnterpriseCategoryCreated: EventDefinition<EnterpriseCategoryCreatedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_category_created">;
+declare const onEnterpriseCategoryDeleted: EventDefinition<EnterpriseCategoryDeletedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_category_deleted">;
+declare const onEnterpriseCategoryUpdated: EventDefinition<EnterpriseCategoryUpdatedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_category_updated">;
 
 type index_d$3_CreateCategoryRequest = CreateCategoryRequest;
 type index_d$3_CreateCategoryResponse = CreateCategoryResponse;
@@ -1369,54 +1369,15 @@ interface OverwriteItemCategoriesOptions {
     categoryIds?: string[];
 }
 
-interface HttpClient$2 {
-    request<TResponse, TData = any>(req: RequestOptionsFactory$2<TResponse, TData>): Promise<HttpResponse$2<TResponse>>;
-    fetchWithAuth: (url: string | URL, init?: RequestInit) => Promise<Response>;
-}
-type RequestOptionsFactory$2<TResponse = any, TData = any> = (context: any) => RequestOptions$2<TResponse, TData>;
-type HttpResponse$2<T = any> = {
-    data: T;
-    status: number;
-    statusText: string;
-    headers: any;
-    request?: any;
-};
-type RequestOptions$2<_TResponse = any, Data = any> = {
-    method: 'POST' | 'GET' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
-    url: string;
-    data?: Data;
-    params?: URLSearchParams;
-} & APIMetadata$2;
-type APIMetadata$2 = {
-    methodFqn?: string;
-    entityFqdn?: string;
-    packageName?: string;
-};
-type EventDefinition$2<Payload = unknown, Type extends string = string> = {
-    __type: 'event-definition';
-    type: Type;
-    isDomainEvent?: boolean;
-    transformations?: (envelope: unknown) => Payload;
-    __payload: Payload;
-};
-declare function EventDefinition$2<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition$2<Payload, Type>;
-
-declare global {
-	// eslint-disable-next-line @typescript-eslint/consistent-type-definitions -- It has to be an `interface` so that it can be merged.
-	interface SymbolConstructor {
-		readonly observable: symbol;
-	}
-}
-
 declare const __metadata$2: {
     PACKAGE_NAME: string;
 };
-declare function itemUploadCallback(httpClient: HttpClient$2): (options?: ItemUploadCallbackOptions) => Promise<void>;
-declare function generateFileUploadUrl$1(httpClient: HttpClient$2): (options?: GenerateFileUploadUrlOptions$1) => Promise<GenerateFileUploadUrlResponse$1 & GenerateFileUploadUrlResponseNonNullableFields$1>;
-declare function importFile$1(httpClient: HttpClient$2): (url: string, options?: ImportFileOptions$1) => Promise<ImportFileResponse$1 & ImportFileResponseNonNullableFields$1>;
-declare function searchItems(httpClient: HttpClient$2): (options?: SearchItemsOptions) => Promise<SearchItemsResponse & SearchItemsResponseNonNullableFields>;
-declare function queryItems(httpClient: HttpClient$2): () => ItemsQueryBuilder;
-declare function updateItem(httpClient: HttpClient$2): (_id: string, item: UpdateItem) => Promise<EnterpriseMediaItem & {
+declare function itemUploadCallback(httpClient: HttpClient): (options?: ItemUploadCallbackOptions) => Promise<void>;
+declare function generateFileUploadUrl$1(httpClient: HttpClient): (options?: GenerateFileUploadUrlOptions$1) => Promise<GenerateFileUploadUrlResponse$1 & GenerateFileUploadUrlResponseNonNullableFields$1>;
+declare function importFile$1(httpClient: HttpClient): (url: string, options?: ImportFileOptions$1) => Promise<ImportFileResponse$1 & ImportFileResponseNonNullableFields$1>;
+declare function searchItems(httpClient: HttpClient): (options?: SearchItemsOptions) => Promise<SearchItemsResponse & SearchItemsResponseNonNullableFields>;
+declare function queryItems(httpClient: HttpClient): () => ItemsQueryBuilder;
+declare function updateItem(httpClient: HttpClient): (_id: string, item: UpdateItem) => Promise<EnterpriseMediaItem & {
     _id: string;
     mediaType: MediaType$1;
     assets?: {
@@ -1437,8 +1398,8 @@ declare function updateItem(httpClient: HttpClient$2): (_id: string, item: Updat
     } | undefined;
     publishStatus: PublishStatus;
 }>;
-declare function bulkUpdateItem(httpClient: HttpClient$2): (updateItemRequests: UpdateItemRequest[], options?: BulkUpdateItemOptions) => Promise<BulkUpdateItemResponse & BulkUpdateItemResponseNonNullableFields>;
-declare function getItem(httpClient: HttpClient$2): (itemId: string) => Promise<EnterpriseMediaItem & {
+declare function bulkUpdateItem(httpClient: HttpClient): (updateItemRequests: UpdateItemRequest[], options?: BulkUpdateItemOptions) => Promise<BulkUpdateItemResponse & BulkUpdateItemResponseNonNullableFields>;
+declare function getItem(httpClient: HttpClient): (itemId: string) => Promise<EnterpriseMediaItem & {
     _id: string;
     mediaType: MediaType$1;
     assets?: {
@@ -1459,13 +1420,13 @@ declare function getItem(httpClient: HttpClient$2): (itemId: string) => Promise<
     } | undefined;
     publishStatus: PublishStatus;
 }>;
-declare function linkItemToCategories(httpClient: HttpClient$2): (itemId: string, options?: LinkItemToCategoriesOptions) => Promise<LinkItemToCategoriesResponse>;
-declare function unlinkItemFromCategories(httpClient: HttpClient$2): (itemId: string, options?: UnlinkItemFromCategoriesOptions) => Promise<UnlinkItemFromCategoriesResponse>;
-declare function overwriteItemCategories(httpClient: HttpClient$2): (itemId: string, options?: OverwriteItemCategoriesOptions) => Promise<OverwriteItemCategoriesResponse>;
-declare const onEnterpriseItemCreated: EventDefinition$2<EnterpriseItemCreatedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_item_created">;
-declare const onEnterpriseItemUpdated: EventDefinition$2<EnterpriseItemUpdatedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_item_updated">;
-declare const onEnterpriseItemItemCategoriesChanged: EventDefinition$2<EnterpriseItemItemCategoriesChangedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_item_item_categories_changed">;
-declare const onEnterpriseItemPublishStatusChanged: EventDefinition$2<EnterpriseItemPublishStatusChangedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_item_publish_status_changed">;
+declare function linkItemToCategories(httpClient: HttpClient): (itemId: string, options?: LinkItemToCategoriesOptions) => Promise<LinkItemToCategoriesResponse>;
+declare function unlinkItemFromCategories(httpClient: HttpClient): (itemId: string, options?: UnlinkItemFromCategoriesOptions) => Promise<UnlinkItemFromCategoriesResponse>;
+declare function overwriteItemCategories(httpClient: HttpClient): (itemId: string, options?: OverwriteItemCategoriesOptions) => Promise<OverwriteItemCategoriesResponse>;
+declare const onEnterpriseItemCreated: EventDefinition<EnterpriseItemCreatedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_item_created">;
+declare const onEnterpriseItemUpdated: EventDefinition<EnterpriseItemUpdatedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_item_updated">;
+declare const onEnterpriseItemItemCategoriesChanged: EventDefinition<EnterpriseItemItemCategoriesChangedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_item_item_categories_changed">;
+declare const onEnterpriseItemPublishStatusChanged: EventDefinition<EnterpriseItemPublishStatusChangedEnvelope, "wix.media.enterprise_public_media.v1.enterprise_item_publish_status_changed">;
 
 type index_d$2_BulkItemUpdateResult = BulkItemUpdateResult;
 type index_d$2_BulkUpdateItemOptions = BulkUpdateItemOptions;
@@ -2010,6 +1971,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 +1982,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 +2008,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 +2019,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 +2051,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 +2068,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 +2403,7 @@ interface DomainEventBodyOneOf$1 {
 interface EntityCreatedEvent$1 {
     entity?: string;
 }
-interface UndeleteInfo {
+interface RestoreInfo {
     deletedDate?: Date;
 }
 interface EntityUpdatedEvent$1 {
@@ -3176,6 +3137,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 +3148,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 +3168,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 +3183,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 +3197,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 +3214,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;
 }
@@ -3360,51 +3321,12 @@ interface ListDeletedFilesOptions {
     paging?: CursorPaging$1;
 }
 
-interface HttpClient$1 {
-    request<TResponse, TData = any>(req: RequestOptionsFactory$1<TResponse, TData>): Promise<HttpResponse$1<TResponse>>;
-    fetchWithAuth: (url: string | URL, init?: RequestInit) => Promise<Response>;
-}
-type RequestOptionsFactory$1<TResponse = any, TData = any> = (context: any) => RequestOptions$1<TResponse, TData>;
-type HttpResponse$1<T = any> = {
-    data: T;
-    status: number;
-    statusText: string;
-    headers: any;
-    request?: any;
-};
-type RequestOptions$1<_TResponse = any, Data = any> = {
-    method: 'POST' | 'GET' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
-    url: string;
-    data?: Data;
-    params?: URLSearchParams;
-} & APIMetadata$1;
-type APIMetadata$1 = {
-    methodFqn?: string;
-    entityFqdn?: string;
-    packageName?: string;
-};
-type EventDefinition$1<Payload = unknown, Type extends string = string> = {
-    __type: 'event-definition';
-    type: Type;
-    isDomainEvent?: boolean;
-    transformations?: (envelope: unknown) => Payload;
-    __payload: Payload;
-};
-declare function EventDefinition$1<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition$1<Payload, Type>;
-
-declare global {
-	// eslint-disable-next-line @typescript-eslint/consistent-type-definitions -- It has to be an `interface` so that it can be merged.
-	interface SymbolConstructor {
-		readonly observable: symbol;
-	}
-}
-
 declare const __metadata$1: {
     PACKAGE_NAME: string;
 };
-declare function generateFilesDownloadUrl(httpClient: HttpClient$1): (fileIds: string[]) => Promise<GenerateFilesDownloadUrlResponse & GenerateFilesDownloadUrlResponseNonNullableFields>;
-declare function generateFileDownloadUrl(httpClient: HttpClient$1): (fileId: string, options?: GenerateFileDownloadUrlOptions) => Promise<GenerateFileDownloadUrlResponse & GenerateFileDownloadUrlResponseNonNullableFields>;
-declare function getFileDescriptor(httpClient: HttpClient$1): (fileId: string) => Promise<FileDescriptor & {
+declare function generateFilesDownloadUrl(httpClient: HttpClient): (fileIds: string[]) => Promise<GenerateFilesDownloadUrlResponse & GenerateFilesDownloadUrlResponseNonNullableFields>;
+declare function generateFileDownloadUrl(httpClient: HttpClient): (fileId: string, options?: GenerateFileDownloadUrlOptions) => Promise<GenerateFileDownloadUrlResponse & GenerateFileDownloadUrlResponseNonNullableFields>;
+declare function getFileDescriptor(httpClient: HttpClient): (fileId: string) => Promise<FileDescriptor & {
     _id: string;
     displayName: string;
     url: string;
@@ -3461,8 +3383,8 @@ declare function getFileDescriptor(httpClient: HttpClient$1): (fileId: string) =
     siteId: string;
     state: State$1;
 }>;
-declare function getFileDescriptors(httpClient: HttpClient$1): (fileIds: string[]) => Promise<GetFileDescriptorsResponse & GetFileDescriptorsResponseNonNullableFields>;
-declare function updateFileDescriptor(httpClient: HttpClient$1): (file: FileDescriptor) => Promise<FileDescriptor & {
+declare function getFileDescriptors(httpClient: HttpClient): (fileIds: string[]) => Promise<GetFileDescriptorsResponse & GetFileDescriptorsResponseNonNullableFields>;
+declare function updateFileDescriptor(httpClient: HttpClient): (file: FileDescriptor) => Promise<FileDescriptor & {
     _id: string;
     displayName: string;
     url: string;
@@ -3519,21 +3441,21 @@ declare function updateFileDescriptor(httpClient: HttpClient$1): (file: FileDesc
     siteId: string;
     state: State$1;
 }>;
-declare function generateFileUploadUrl(httpClient: HttpClient$1): (mimeType: string | null, options?: GenerateFileUploadUrlOptions) => Promise<GenerateFileUploadUrlResponse & GenerateFileUploadUrlResponseNonNullableFields>;
-declare function generateFileResumableUploadUrl(httpClient: HttpClient$1): (mimeType: string | null, options?: GenerateFileResumableUploadUrlOptions) => Promise<GenerateFileResumableUploadUrlResponse & GenerateFileResumableUploadUrlResponseNonNullableFields>;
-declare function importFile(httpClient: HttpClient$1): (url: string, options?: ImportFileOptions) => Promise<ImportFileResponse & ImportFileResponseNonNullableFields>;
-declare function bulkImportFiles(httpClient: HttpClient$1): (importFileRequests: ImportFileRequest[]) => Promise<BulkImportFilesResponse & BulkImportFilesResponseNonNullableFields>;
-declare function bulkImportFile(httpClient: HttpClient$1): (importFileRequests: ImportFileRequest[], options?: BulkImportFileOptions) => Promise<BulkImportFileResponse & BulkImportFileResponseNonNullableFields>;
-declare function listFiles(httpClient: HttpClient$1): (options?: ListFilesOptions) => Promise<ListFilesResponse & ListFilesResponseNonNullableFields>;
-declare function searchFiles(httpClient: HttpClient$1): (options?: SearchFilesOptions) => Promise<SearchFilesResponse & SearchFilesResponseNonNullableFields>;
-declare function generateVideoStreamingUrl(httpClient: HttpClient$1): (fileId: string, options?: GenerateVideoStreamingUrlOptions) => Promise<GenerateVideoStreamingUrlResponse & GenerateVideoStreamingUrlResponseNonNullableFields>;
-declare function bulkDeleteFiles(httpClient: HttpClient$1): (fileIds: string[], options?: BulkDeleteFilesOptions) => Promise<void>;
-declare function bulkRestoreFilesFromTrashBin(httpClient: HttpClient$1): (fileIds: string[]) => Promise<void>;
-declare function listDeletedFiles(httpClient: HttpClient$1): (options?: ListDeletedFilesOptions) => Promise<ListDeletedFilesResponse & ListDeletedFilesResponseNonNullableFields>;
-declare const onFileDescriptorUpdated: EventDefinition$1<FileDescriptorUpdatedEnvelope, "wix.media.site_media.v1.file_descriptor_updated">;
-declare const onFileDescriptorDeleted: EventDefinition$1<FileDescriptorDeletedEnvelope, "wix.media.site_media.v1.file_descriptor_deleted">;
-declare const onFileDescriptorFileReady: EventDefinition$1<FileDescriptorFileReadyEnvelope, "wix.media.site_media.v1.file_descriptor_file_ready">;
-declare const onFileDescriptorFileFailed: EventDefinition$1<FileDescriptorFileFailedEnvelope, "wix.media.site_media.v1.file_descriptor_file_failed">;
+declare function generateFileUploadUrl(httpClient: HttpClient): (mimeType: string | null, options?: GenerateFileUploadUrlOptions) => Promise<GenerateFileUploadUrlResponse & GenerateFileUploadUrlResponseNonNullableFields>;
+declare function generateFileResumableUploadUrl(httpClient: HttpClient): (mimeType: string | null, options?: GenerateFileResumableUploadUrlOptions) => Promise<GenerateFileResumableUploadUrlResponse & GenerateFileResumableUploadUrlResponseNonNullableFields>;
+declare function importFile(httpClient: HttpClient): (url: string, options?: ImportFileOptions) => Promise<ImportFileResponse & ImportFileResponseNonNullableFields>;
+declare function bulkImportFiles(httpClient: HttpClient): (importFileRequests: ImportFileRequest[]) => Promise<BulkImportFilesResponse & BulkImportFilesResponseNonNullableFields>;
+declare function bulkImportFile(httpClient: HttpClient): (importFileRequests: ImportFileRequest[], options?: BulkImportFileOptions) => Promise<BulkImportFileResponse & BulkImportFileResponseNonNullableFields>;
+declare function listFiles(httpClient: HttpClient): (options?: ListFilesOptions) => Promise<ListFilesResponse & ListFilesResponseNonNullableFields>;
+declare function searchFiles(httpClient: HttpClient): (options?: SearchFilesOptions) => Promise<SearchFilesResponse & SearchFilesResponseNonNullableFields>;
+declare function generateVideoStreamingUrl(httpClient: HttpClient): (fileId: string, options?: GenerateVideoStreamingUrlOptions) => Promise<GenerateVideoStreamingUrlResponse & GenerateVideoStreamingUrlResponseNonNullableFields>;
+declare function bulkDeleteFiles(httpClient: HttpClient): (fileIds: string[], options?: BulkDeleteFilesOptions) => Promise<void>;
+declare function bulkRestoreFilesFromTrashBin(httpClient: HttpClient): (fileIds: string[]) => Promise<void>;
+declare function listDeletedFiles(httpClient: HttpClient): (options?: ListDeletedFilesOptions) => Promise<ListDeletedFilesResponse & ListDeletedFilesResponseNonNullableFields>;
+declare const onFileDescriptorUpdated: EventDefinition<FileDescriptorUpdatedEnvelope, "wix.media.site_media.v1.file_descriptor_updated">;
+declare const onFileDescriptorDeleted: EventDefinition<FileDescriptorDeletedEnvelope, "wix.media.site_media.v1.file_descriptor_deleted">;
+declare const onFileDescriptorFileReady: EventDefinition<FileDescriptorFileReadyEnvelope, "wix.media.site_media.v1.file_descriptor_file_ready">;
+declare const onFileDescriptorFileFailed: EventDefinition<FileDescriptorFileFailedEnvelope, "wix.media.site_media.v1.file_descriptor_file_failed">;
 
 type index_d$1_ApplicationError = ApplicationError;
 type index_d$1_Archive = Archive;
@@ -3619,13 +3541,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 +3577,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 {
@@ -4175,45 +4097,6 @@ interface ListDeletedFoldersOptions {
     paging?: CursorPaging;
 }
 
-interface HttpClient {
-    request<TResponse, TData = any>(req: RequestOptionsFactory<TResponse, TData>): Promise<HttpResponse<TResponse>>;
-    fetchWithAuth: (url: string | URL, init?: RequestInit) => Promise<Response>;
-}
-type RequestOptionsFactory<TResponse = any, TData = any> = (context: any) => RequestOptions<TResponse, TData>;
-type HttpResponse<T = any> = {
-    data: T;
-    status: number;
-    statusText: string;
-    headers: any;
-    request?: any;
-};
-type RequestOptions<_TResponse = any, Data = any> = {
-    method: 'POST' | 'GET' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
-    url: string;
-    data?: Data;
-    params?: URLSearchParams;
-} & APIMetadata;
-type APIMetadata = {
-    methodFqn?: string;
-    entityFqdn?: string;
-    packageName?: string;
-};
-type EventDefinition<Payload = unknown, Type extends string = string> = {
-    __type: 'event-definition';
-    type: Type;
-    isDomainEvent?: boolean;
-    transformations?: (envelope: unknown) => Payload;
-    __payload: Payload;
-};
-declare function EventDefinition<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition<Payload, Type>;
-
-declare global {
-	// eslint-disable-next-line @typescript-eslint/consistent-type-definitions -- It has to be an `interface` so that it can be merged.
-	interface SymbolConstructor {
-		readonly observable: symbol;
-	}
-}
-
 declare const __metadata: {
     PACKAGE_NAME: string;
 };

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;
 }