@wix/media 1.0.98 → 1.0.100

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/media",
-  "version": "1.0.98",
+  "version": "1.0.100",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
@@ -18,13 +18,12 @@
     "type-bundles"
   ],
   "dependencies": {
-    "@wix/media_enterprise-media-categories": "1.0.23",
-    "@wix/media_enterprise-media-items": "1.0.26",
-    "@wix/media_files": "1.0.35",
-    "@wix/media_folders": "1.0.26"
+    "@wix/media_enterprise-media-categories": "1.0.24",
+    "@wix/media_enterprise-media-items": "1.0.27",
+    "@wix/media_files": "1.0.37",
+    "@wix/media_folders": "1.0.27"
   },
   "devDependencies": {
-    "@wix/sdk": "https://cdn.dev.wixpress.com/@wix/sdk/02e8069ab2fd783e0e6a080fc7d590e76cb26ab93c8389574286305b.tar.gz",
     "glob": "^10.4.1",
     "rollup": "^4.18.0",
     "rollup-plugin-dts": "^6.1.1",
@@ -46,5 +45,5 @@
       "fqdn": ""
     }
   },
-  "falconPackageHash": "f9a34a3b4dc15ab560164024784cf13fb08d6ce308cc9bb822e2b18e"
+  "falconPackageHash": "e037ed493c4a9b4b99feb5b7bc046c8cb76ab20c7421d7b9c73a7495"
 }

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

@@ -181,72 +181,80 @@ interface EnterpriseOnboardingOptions {
     accountName?: string;
 }
 
-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>>;
+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>>;
+    fetchWithAuth: (url: string | URL, init?: RequestInit) => Promise<Response>;
 }
-type RequestOptionsFactory<TResponse = any, TData = any> = (context: any) => RequestOptions<TResponse, TData>;
-type HttpResponse<T = any> = {
+type RequestOptionsFactory$3<TResponse = any, TData = any> = (context: any) => RequestOptions$3<TResponse, TData>;
+type HttpResponse$3<T = any> = {
     data: T;
     status: number;
     statusText: string;
     headers: any;
     request?: any;
 };
-type RequestOptions<_TResponse = any, Data = any> = {
+type RequestOptions$3<_TResponse = any, Data = any> = {
     method: 'POST' | 'GET' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
     url: string;
     data?: Data;
     params?: URLSearchParams;
-} & APIMetadata;
-type APIMetadata = {
+} & APIMetadata$3;
+type APIMetadata$3 = {
     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 BuildRESTFunction$3<T extends RESTFunctionDescriptor$3> = T extends RESTFunctionDescriptor$3<infer U> ? U : never;
+type EventDefinition$3<Payload = unknown, Type extends string = string> = {
     __type: 'event-definition';
     type: Type;
     isDomainEvent?: boolean;
-    transformations?: unknown;
+    transformations?: (envelope: unknown) => Payload;
     __payload: Payload;
 };
-declare function EventDefinition<Type extends string>(type: Type, isDomainEvent?: boolean, _transformations?: 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 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 createCategory$1(httpClient: HttpClient): (category: EnterpriseCategory) => Promise<EnterpriseCategory & {
+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 createCategory$1(httpClient: HttpClient$3): (category: EnterpriseCategory) => Promise<EnterpriseCategory & {
     _id: string;
     publishStatus: PublishStatus$1;
 }>;
-declare function deleteCategory$1(httpClient: HttpClient): (categoryId: string) => Promise<void>;
-declare function updateCategory$1(httpClient: HttpClient): (_id: string, category: UpdateCategory) => Promise<EnterpriseCategory & {
+declare function deleteCategory$1(httpClient: HttpClient$3): (categoryId: string) => Promise<void>;
+declare function updateCategory$1(httpClient: HttpClient$3): (_id: string, category: UpdateCategory) => Promise<EnterpriseCategory & {
     _id: string;
     publishStatus: PublishStatus$1;
 }>;
-declare function getCategory$1(httpClient: HttpClient): (categoryId: string, options?: GetCategoryOptions) => Promise<EnterpriseCategoryTree & {
+declare function getCategory$1(httpClient: HttpClient$3): (categoryId: string, options?: GetCategoryOptions) => Promise<EnterpriseCategoryTree & {
     category?: {
         _id: string;
         publishStatus: PublishStatus$1;
     } | undefined;
     subCategories: (any | undefined)[];
 }>;
-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 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 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 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 context$3_createCategory: typeof createCategory;
 declare const context$3_deleteCategory: typeof deleteCategory;
@@ -895,12 +903,55 @@ interface OverwriteItemCategoriesOptions {
     categoryIds?: string[];
 }
 
-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 & {
+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 & {
     _id: string;
     mediaType: MediaType$1;
     assets?: {
@@ -921,8 +972,8 @@ declare function updateItem$1(httpClient: HttpClient): (_id: string, item: Updat
     } | undefined;
     publishStatus: PublishStatus;
 }>;
-declare function bulkUpdateItem$1(httpClient: HttpClient): (updateItemRequests: UpdateItemRequest[], options?: BulkUpdateItemOptions) => Promise<BulkUpdateItemResponse & BulkUpdateItemResponseNonNullableFields>;
-declare function getItem$1(httpClient: HttpClient): (itemId: string) => Promise<EnterpriseMediaItem & {
+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 & {
     _id: string;
     mediaType: MediaType$1;
     assets?: {
@@ -943,29 +994,29 @@ declare function getItem$1(httpClient: HttpClient): (itemId: string) => Promise<
     } | undefined;
     publishStatus: PublishStatus;
 }>;
-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 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 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 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 context$2_bulkUpdateItem: typeof bulkUpdateItem;
 declare const context$2_getItem: typeof getItem;
@@ -1328,6 +1379,7 @@ interface ImportFileRequest {
     displayName?: string | null;
     /**
      * ID of the file's parent folder. <br />
+     * This folder is the path root for the `filePath`. <br />
      * Default: `media-root`.
      */
     parentFolderId?: string | null;
@@ -1344,11 +1396,10 @@ interface ImportFileRequest {
     /** Optional headers that should be sent with the external URL. */
     urlHeaders?: Record<string, any> | null;
     /**
-     * The path by folder names to create the file under.
-     * In case a folder in the path does not exist it will be created
-     * If multiple folders with the same name exist, the first one will be used
-     * If `parentFolderId` is provided, the path will be nested under the folder specified by the `parentFolderId`
-     * example: 'videos/2024/december'
+     * Path to the folder where the file will be stored.
+     * For example, `/videos/2024/december`. <br/>
+     * If `parentFolderId` is defined, the parent folder is used as the path root. Otherwise, the root is `media-root`.
+     * The folders in the path will be created if they don't already exist.  <br />
      */
     filePath?: string | null;
 }
@@ -2052,6 +2103,7 @@ interface GenerateFileUploadUrlOptions {
     sizeInBytes?: string | null;
     /**
      * ID of the file's parent folder. <br />
+     * This folder is the path root for the `filePath`.<br />
      * Default: `media-root`.
      */
     parentFolderId?: string | null;
@@ -2062,11 +2114,10 @@ interface GenerateFileUploadUrlOptions {
     /** Information sent to the `onFileDescriptorFileReady( )` and `onFileDescriptorFileFailed( )` events. See the Importing Files article to learn more. */
     externalInfo?: ExternalInfo;
     /**
-     * The path by folder names to create the file under.
-     * In case a folder in the path does not exist it will be created
-     * If multiple folders with the same name exist, the first one will be used
-     * If `parentFolderId` is provided, the path will be nested under the folder specified by the `parentFolderId`
-     * example: 'videos/2024/december'
+     * Path to the folder where the file will be stored.
+     * For example, `/videos/2024/december`. <br/>
+     * If `parentFolderId` is defined, the parent folder is used as the path root. Otherwise, the root is `media-root`.
+     * The folders in the path will be created if they don't already exist.  <br />
      */
     filePath?: string | null;
 }
@@ -2083,6 +2134,7 @@ interface GenerateFileResumableUploadUrlOptions {
     sizeInBytes?: string | null;
     /**
      * ID of the file's parent folder. <br />
+     * This folder is the path root for the `filePath`.<br />
      * Default: `media-root`.
      */
     parentFolderId?: string | null;
@@ -2097,11 +2149,10 @@ interface GenerateFileResumableUploadUrlOptions {
      */
     uploadProtocol?: UploadProtocol;
     /**
-     * The path by folder names to create the file under.
-     * In case a folder in the path does not exist it will be created
-     * If multiple folders with the same name exist, the first one will be used
-     * If `parentFolderId` is provided, the path will be nested under the folder specified by the `parentFolderId`
-     * example: 'videos/2024/december'
+     * Path to the folder where the file will be stored.
+     * For example, `/videos/2024/december`. <br/>
+     * If `parentFolderId` is defined, the parent folder is used as the path root. Otherwise, the root is `media-root`.
+     * The folders in the path will be created if they don't already exist.  <br />
      */
     filePath?: string | null;
 }
@@ -2112,6 +2163,7 @@ interface ImportFileOptions {
     displayName?: string | null;
     /**
      * ID of the file's parent folder. <br />
+     * This folder is the path root for the `filePath`. <br />
      * Default: `media-root`.
      */
     parentFolderId?: string | null;
@@ -2128,11 +2180,10 @@ interface ImportFileOptions {
     /** Optional headers that should be sent with the external URL. */
     urlHeaders?: Record<string, any> | null;
     /**
-     * The path by folder names to create the file under.
-     * In case a folder in the path does not exist it will be created
-     * If multiple folders with the same name exist, the first one will be used
-     * If `parentFolderId` is provided, the path will be nested under the folder specified by the `parentFolderId`
-     * example: 'videos/2024/december'
+     * Path to the folder where the file will be stored.
+     * For example, `/videos/2024/december`. <br/>
+     * If `parentFolderId` is defined, the parent folder is used as the path root. Otherwise, the root is `media-root`.
+     * The folders in the path will be created if they don't already exist.  <br />
      */
     filePath?: string | null;
 }
@@ -2236,9 +2287,52 @@ interface ListDeletedFilesOptions {
     paging?: CursorPaging$1;
 }
 
-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 & {
+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 & {
     _id: string;
     displayName: string;
     url: string;
@@ -2295,8 +2389,8 @@ declare function getFileDescriptor$1(httpClient: HttpClient): (fileId: string) =
     siteId: string;
     state: State$1;
 }>;
-declare function getFileDescriptors$1(httpClient: HttpClient): (fileIds: string[]) => Promise<GetFileDescriptorsResponse & GetFileDescriptorsResponseNonNullableFields>;
-declare function updateFileDescriptor$1(httpClient: HttpClient): (file: FileDescriptor) => Promise<FileDescriptor & {
+declare function getFileDescriptors$1(httpClient: HttpClient$1): (fileIds: string[]) => Promise<GetFileDescriptorsResponse & GetFileDescriptorsResponseNonNullableFields>;
+declare function updateFileDescriptor$1(httpClient: HttpClient$1): (file: FileDescriptor) => Promise<FileDescriptor & {
     _id: string;
     displayName: string;
     url: string;
@@ -2353,42 +2447,42 @@ declare function updateFileDescriptor$1(httpClient: HttpClient): (file: FileDesc
     siteId: string;
     state: State$1;
 }>;
-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 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 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 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 context$1_bulkDeleteFiles: typeof bulkDeleteFiles;
 declare const context$1_bulkImportFile: typeof bulkImportFile;
@@ -2717,6 +2811,49 @@ 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;