@wix/auto_sdk_media_folders 1.0.11 → 1.0.13

package/build/internal/cjs/index.typings.d.ts

@@ -1 +1,807 @@
-export * from './src/media-site-media-v1-folder-folders.universal.js';
+import { NonNullablePaths } from '@wix/sdk-types';
+
+interface Folder {
+    /**
+     * Folder ID. Generated when a folder is created in the Media Manager.
+     * @maxLength 100
+     */
+    _id?: string;
+    /**
+     * Folder name as it appears in the Media Manager.
+     * @maxLength 256
+     */
+    displayName?: string;
+    /**
+     * ID of the folder's parent folder. <br /> Default: `media-root` folder.
+     * @maxLength 100
+     */
+    parentFolderId?: string;
+    /**
+     * Date the folder was created.
+     * @readonly
+     */
+    _createdDate?: Date | null;
+    /**
+     * Date the folder was updated.
+     * @readonly
+     */
+    _updatedDate?: Date | null;
+    /**
+     * State of the folder.
+     * @readonly
+     */
+    state?: StateWithLiterals;
+}
+declare enum State {
+    OK = "OK",
+    DELETED = "DELETED"
+}
+/** @enumType */
+type StateWithLiterals = State | 'OK' | 'DELETED';
+declare enum Namespace {
+    NO_NAMESPACE = "NO_NAMESPACE",
+    OTHERS = "OTHERS",
+    /** ANY = 2; */
+    WIX_VIDEO = "WIX_VIDEO",
+    /** _nsWixMusic */
+    WIX_MUSIC = "WIX_MUSIC",
+    /** _nsArtStore */
+    ALBUMS_AND_ART_STORE = "ALBUMS_AND_ART_STORE",
+    /** _nsDigitalProduct */
+    WIX_ECOM = "WIX_ECOM",
+    /** _nsPhotoShareApp */
+    PHOTO_SHARE_APP = "PHOTO_SHARE_APP",
+    /** _nsSharingApp, */
+    SHARING_APP = "SHARING_APP",
+    /** engage */
+    CHAT = "CHAT",
+    /** logobuilder */
+    LOGO_BUILDER = "LOGO_BUILDER",
+    /** WixExposure */
+    ALBUMS_OLD = "ALBUMS_OLD",
+    /** chat-mobile-uploads */
+    CHAT_MOBILE = "CHAT_MOBILE",
+    /** _nsWixForms */
+    WIX_FORMS = "WIX_FORMS",
+    /** _nsWixLegends */
+    WIX_LEGENDS = "WIX_LEGENDS"
+}
+/** @enumType */
+type NamespaceWithLiterals = Namespace | 'NO_NAMESPACE' | 'OTHERS' | 'WIX_VIDEO' | 'WIX_MUSIC' | 'ALBUMS_AND_ART_STORE' | 'WIX_ECOM' | 'PHOTO_SHARE_APP' | 'SHARING_APP' | 'CHAT' | 'LOGO_BUILDER' | 'ALBUMS_OLD' | 'CHAT_MOBILE' | 'WIX_FORMS' | 'WIX_LEGENDS';
+interface CreateFolderRequest {
+    /**
+     * Folder name that appears in the Media Manager.
+     * @maxLength 200
+     */
+    displayName: string;
+    /**
+     * ID of the folder's parent folder.
+     * @maxLength 100
+     */
+    parentFolderId?: string | null;
+}
+interface CreateFolderResponse {
+    /** Information about the newly created folder. */
+    folder?: Folder;
+}
+interface GetFolderRequest {
+    /**
+     * Folder ID.
+     * @maxLength 100
+     */
+    folderId: string;
+}
+interface GetFolderResponse {
+    /** Information about the folder. */
+    folder?: Folder;
+}
+interface ListFoldersRequest {
+    /**
+     * ID of the folder's parent folder.
+     * <br /> Default: `media-root` folder.
+     * @maxLength 100
+     */
+    parentFolderId?: string | null;
+    /**
+     * Field name and order to sort by. One of: <br />
+     * * `displayName`
+     * * `updatedDate`
+     * Default: `updatedDate` in `desc` order.
+     */
+    sort?: Sorting;
+    /** Cursor and paging information. */
+    paging?: CursorPaging;
+}
+interface Sorting {
+    /**
+     * Name of the field to sort by.
+     * @maxLength 512
+     */
+    fieldName?: string;
+    /** Sort order. */
+    order?: SortOrderWithLiterals;
+}
+declare enum SortOrder {
+    ASC = "ASC",
+    DESC = "DESC"
+}
+/** @enumType */
+type SortOrderWithLiterals = SortOrder | 'ASC' | 'DESC';
+interface CursorPaging {
+    /**
+     * Maximum number of items to return in the results.
+     * @max 100
+     */
+    limit?: number | null;
+    /**
+     * Pointer to the next or previous page in the list of results.
+     *
+     * Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
+     * Not relevant for the first request.
+     * @maxLength 16000
+     */
+    cursor?: string | null;
+}
+interface ListFoldersResponse {
+    /**
+     * Information about the folders in the requested folder.
+     * @maxSize 200
+     */
+    folders?: Folder[];
+    /** The next cursor if it exists. */
+    nextCursor?: PagingMetadataV2;
+}
+interface PagingMetadataV2 {
+    /** Total number of items that match the query. Returned if offset paging is used and the `tooManyToCount` flag is not set. */
+    total?: number | null;
+    /** Cursors to navigate through the result pages using `next` and `prev`. Returned if cursor paging is used. */
+    cursors?: Cursors;
+}
+interface Cursors {
+    /**
+     * Cursor string pointing to the next page in the list of results.
+     * @maxLength 16000
+     */
+    next?: string | null;
+}
+interface SearchFoldersRequest {
+    /**
+     * A root folder in the Media Manager to search in. <br />
+     * Default: `MEDIA_ROOT`.
+     */
+    rootFolder?: RootFolderWithLiterals;
+    /**
+     * Field name and order to sort by. One of:
+     * * `displayName`
+     * * `updatedDate`
+     * Default: `updatedDate` in `desc` order.
+     */
+    sort?: Sorting;
+    /** Cursor and paging information. */
+    paging?: CursorPaging;
+    /**
+     * Term to search for, such as the value of a folder's `displayName`. <br />
+     * For example, if a folder's `displayName` is 'my-videos-folder', the search term is 'my-videos-folder'.
+     * @maxLength 200
+     */
+    search?: string | null;
+}
+declare enum RootFolder {
+    /** Root of all site media */
+    MEDIA_ROOT = "MEDIA_ROOT",
+    /** Root of the trash system folder */
+    TRASH_ROOT = "TRASH_ROOT",
+    /** Root of all visitor uploads */
+    VISITOR_UPLOADS_ROOT = "VISITOR_UPLOADS_ROOT"
+}
+/** @enumType */
+type RootFolderWithLiterals = RootFolder | 'MEDIA_ROOT' | 'TRASH_ROOT' | 'VISITOR_UPLOADS_ROOT';
+interface SearchFoldersResponse {
+    /**
+     * Information about the folders in the requested folder.
+     * @maxSize 200
+     */
+    folders?: Folder[];
+    /** The next cursor if it exists. */
+    nextCursor?: PagingMetadataV2;
+}
+interface UpdateFolderRequest {
+    /** Folder to update. */
+    folder: Folder;
+}
+interface UpdateFolderResponse {
+    /** Information about the updated folder. */
+    folder?: Folder;
+}
+interface UnsupportedRequestValueError {
+    /**
+     * Optional A list of allowed values
+     * @maxSize 100
+     * @maxLength 200
+     */
+    allowedValues?: string[];
+    /**
+     * The unsupported value send in the request
+     * @maxLength 200
+     */
+    requestValue?: string;
+}
+interface GenerateFolderDownloadUrlRequest {
+    /**
+     * Folder ID.
+     * @maxLength 100
+     */
+    folderId: string;
+}
+interface GenerateFolderDownloadUrlResponse {
+    /**
+     * URL for downloading a specific folder in the Media Manager.
+     * @format WEB_URL
+     */
+    downloadUrl?: string;
+}
+interface BulkDeleteFoldersRequest {
+    /**
+     * IDs of the folders to move to the Media Manager's trash bin.
+     * @maxSize 100
+     * @maxLength 100
+     */
+    folderIds: string[];
+    /**
+     * Whether the specified folders are permanently deleted. <br />
+     * Default: `false`
+     */
+    permanent?: boolean;
+}
+interface BulkDeleteFoldersResponse {
+}
+interface BulkRestoreFoldersFromTrashBinRequest {
+    /**
+     * IDs of the folders to restore from the Media Manager's trash bin.
+     * @maxSize 100
+     * @maxLength 100
+     */
+    folderIds: string[];
+}
+interface BulkRestoreFoldersFromTrashBinResponse {
+}
+interface ListDeletedFoldersRequest {
+    /**
+     * ID of the folder's parent folder.
+     * @maxLength 100
+     */
+    parentFolderId?: string | null;
+    /**
+     * Field name and order to sort by. One of:
+     * * `displayName`
+     * * `updatedDate`
+     * Default: `updatedDate` in `desc` order.
+     */
+    sort?: Sorting;
+    /** Cursor and paging information. */
+    paging?: CursorPaging;
+}
+interface ListDeletedFoldersResponse {
+    /**
+     * List of folders in the Media Manager's trash bin.
+     * @maxSize 200
+     */
+    folders?: Folder[];
+    /** The next cursor if it exists. */
+    nextCursor?: PagingMetadataV2;
+}
+interface DomainEvent extends DomainEventBodyOneOf {
+    createdEvent?: EntityCreatedEvent;
+    updatedEvent?: EntityUpdatedEvent;
+    deletedEvent?: EntityDeletedEvent;
+    actionEvent?: ActionEvent;
+    /** Event ID. With this ID you can easily spot duplicated events and ignore them. */
+    _id?: string;
+    /**
+     * Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities.
+     * For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`.
+     */
+    entityFqdn?: string;
+    /**
+     * Event action name, placed at the top level to make it easier for users to dispatch messages.
+     * For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`.
+     */
+    slug?: string;
+    /** ID of the entity associated with the event. */
+    entityId?: string;
+    /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`. */
+    eventTime?: Date | null;
+    /**
+     * Whether the event was triggered as a result of a privacy regulation application
+     * (for example, GDPR).
+     */
+    triggeredByAnonymizeRequest?: boolean | null;
+    /** If present, indicates the action that triggered the event. */
+    originatedFrom?: string | null;
+    /**
+     * A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at 16:00 and then again at 16:01, the second update will always have a higher sequence number.
+     * You can use this number to make sure you're handling updates in the right order. Just save the latest sequence number on your end and compare it to the one in each new message. If the new message has an older (lower) number, you can safely ignore it.
+     */
+    entityEventSequence?: string | null;
+}
+/** @oneof */
+interface DomainEventBodyOneOf {
+    createdEvent?: EntityCreatedEvent;
+    updatedEvent?: EntityUpdatedEvent;
+    deletedEvent?: EntityDeletedEvent;
+    actionEvent?: ActionEvent;
+}
+interface EntityCreatedEvent {
+    entity?: string;
+}
+interface RestoreInfo {
+    deletedDate?: Date | null;
+}
+interface EntityUpdatedEvent {
+    /**
+     * Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff.
+     * This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects.
+     * We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.
+     */
+    currentEntity?: string;
+}
+interface EntityDeletedEvent {
+    /** Entity that was deleted. */
+    deletedEntity?: string | null;
+}
+interface ActionEvent {
+    body?: string;
+}
+interface MessageEnvelope {
+    /**
+     * App instance ID.
+     * @format GUID
+     */
+    instanceId?: string | null;
+    /**
+     * Event type.
+     * @maxLength 150
+     */
+    eventType?: string;
+    /** The identification type and identity data. */
+    identity?: IdentificationData;
+    /** Stringify payload. */
+    data?: string;
+}
+interface IdentificationData extends IdentificationDataIdOneOf {
+    /**
+     * ID of a site visitor that has not logged in to the site.
+     * @format GUID
+     */
+    anonymousVisitorId?: string;
+    /**
+     * ID of a site visitor that has logged in to the site.
+     * @format GUID
+     */
+    memberId?: string;
+    /**
+     * ID of a Wix user (site owner, contributor, etc.).
+     * @format GUID
+     */
+    wixUserId?: string;
+    /**
+     * ID of an app.
+     * @format GUID
+     */
+    appId?: string;
+    /** @readonly */
+    identityType?: WebhookIdentityTypeWithLiterals;
+}
+/** @oneof */
+interface IdentificationDataIdOneOf {
+    /**
+     * ID of a site visitor that has not logged in to the site.
+     * @format GUID
+     */
+    anonymousVisitorId?: string;
+    /**
+     * ID of a site visitor that has logged in to the site.
+     * @format GUID
+     */
+    memberId?: string;
+    /**
+     * ID of a Wix user (site owner, contributor, etc.).
+     * @format GUID
+     */
+    wixUserId?: string;
+    /**
+     * ID of an app.
+     * @format GUID
+     */
+    appId?: string;
+}
+declare enum WebhookIdentityType {
+    UNKNOWN = "UNKNOWN",
+    ANONYMOUS_VISITOR = "ANONYMOUS_VISITOR",
+    MEMBER = "MEMBER",
+    WIX_USER = "WIX_USER",
+    APP = "APP"
+}
+/** @enumType */
+type WebhookIdentityTypeWithLiterals = WebhookIdentityType | 'UNKNOWN' | 'ANONYMOUS_VISITOR' | 'MEMBER' | 'WIX_USER' | 'APP';
+type UpdateFolderValidationErrors = {
+    ruleName?: 'FIELD_MASK_IS_EMPTY_OR_MISSING';
+};
+interface BaseEventMetadata {
+    /**
+     * App instance ID.
+     * @format GUID
+     */
+    instanceId?: string | null;
+    /**
+     * Event type.
+     * @maxLength 150
+     */
+    eventType?: string;
+    /** The identification type and identity data. */
+    identity?: IdentificationData;
+}
+interface EventMetadata extends BaseEventMetadata {
+    /** Event ID. With this ID you can easily spot duplicated events and ignore them. */
+    _id?: string;
+    /**
+     * Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities.
+     * For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`.
+     */
+    entityFqdn?: string;
+    /**
+     * Event action name, placed at the top level to make it easier for users to dispatch messages.
+     * For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`.
+     */
+    slug?: string;
+    /** ID of the entity associated with the event. */
+    entityId?: string;
+    /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`. */
+    eventTime?: Date | null;
+    /**
+     * Whether the event was triggered as a result of a privacy regulation application
+     * (for example, GDPR).
+     */
+    triggeredByAnonymizeRequest?: boolean | null;
+    /** If present, indicates the action that triggered the event. */
+    originatedFrom?: string | null;
+    /**
+     * A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at 16:00 and then again at 16:01, the second update will always have a higher sequence number.
+     * You can use this number to make sure you're handling updates in the right order. Just save the latest sequence number on your end and compare it to the one in each new message. If the new message has an older (lower) number, you can safely ignore it.
+     */
+    entityEventSequence?: string | null;
+}
+interface FolderCreatedEnvelope {
+    entity: Folder;
+    metadata: EventMetadata;
+}
+/**
+ * Triggered when a folder is created.
+ *
+ * This event is also triggered when a folder is restored from the Media Manager's trash bin.
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
+ * @permissionScope Manage Bookings Services and Settings
+ * @permissionScopeId SCOPE.BOOKINGS.CONFIGURATION
+ * @permissionScope Manage Events
+ * @permissionScopeId SCOPE.EVENTS.MANAGE-EVENTS
+ * @permissionScope Manage Challenges
+ * @permissionScopeId SCOPE.CHALLENGES.MANAGE
+ * @permissionScope Read Media Manager
+ * @permissionScopeId SCOPE.DC-MEDIA.READ-MEDIAMANAGER
+ * @permissionScope Manage Media Manager
+ * @permissionScopeId SCOPE.DC-MEDIA.MANAGE-MEDIAMANAGER
+ * @permissionScope Manage Portfolio
+ * @permissionScopeId SCOPE.PORTFOLIO.MANAGE-PORTFOLIO
+ * @permissionScope Manage Blog
+ * @permissionScopeId SCOPE.BLOG.MANAGE-BLOG
+ * @permissionScope Access Verticals by Automations
+ * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
+ * @permissionScope Set Up Automations
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
+ * @permissionId MEDIA.SITE_MEDIA_FOLDERS_READ
+ * @webhook
+ * @eventType wix.media.site_media.v1.folder_created
+ * @serviceIdentifier com.wix.media.site_media.v1.FoldersService
+ * @slug created
+ */
+declare function onFolderCreated(handler: (event: FolderCreatedEnvelope) => void | Promise<void>): void;
+interface FolderDeletedEnvelope {
+    metadata: EventMetadata;
+}
+/**
+ * Triggered when a folder is deleted.
+ *
+ * If the `movedToTrash` property in the event object is `true`, the folder was moved to the Media Manager's trash bin. If the `movedToTrash` property in the event object is `false`, the folder was permanently deleted.
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
+ * @permissionScope Manage Bookings Services and Settings
+ * @permissionScopeId SCOPE.BOOKINGS.CONFIGURATION
+ * @permissionScope Manage Events
+ * @permissionScopeId SCOPE.EVENTS.MANAGE-EVENTS
+ * @permissionScope Manage Challenges
+ * @permissionScopeId SCOPE.CHALLENGES.MANAGE
+ * @permissionScope Read Media Manager
+ * @permissionScopeId SCOPE.DC-MEDIA.READ-MEDIAMANAGER
+ * @permissionScope Manage Media Manager
+ * @permissionScopeId SCOPE.DC-MEDIA.MANAGE-MEDIAMANAGER
+ * @permissionScope Manage Portfolio
+ * @permissionScopeId SCOPE.PORTFOLIO.MANAGE-PORTFOLIO
+ * @permissionScope Manage Blog
+ * @permissionScopeId SCOPE.BLOG.MANAGE-BLOG
+ * @permissionScope Access Verticals by Automations
+ * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
+ * @permissionScope Set Up Automations
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
+ * @permissionId MEDIA.SITE_MEDIA_FOLDERS_READ
+ * @webhook
+ * @eventType wix.media.site_media.v1.folder_deleted
+ * @serviceIdentifier com.wix.media.site_media.v1.FoldersService
+ * @slug deleted
+ */
+declare function onFolderDeleted(handler: (event: FolderDeletedEnvelope) => void | Promise<void>): void;
+interface FolderUpdatedEnvelope {
+    entity: Folder;
+    metadata: EventMetadata;
+}
+/**
+ * Triggered when a folder is updated, including when a folder is moved to a different parent folder.
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
+ * @permissionScope Manage Bookings Services and Settings
+ * @permissionScopeId SCOPE.BOOKINGS.CONFIGURATION
+ * @permissionScope Manage Events
+ * @permissionScopeId SCOPE.EVENTS.MANAGE-EVENTS
+ * @permissionScope Manage Challenges
+ * @permissionScopeId SCOPE.CHALLENGES.MANAGE
+ * @permissionScope Read Media Manager
+ * @permissionScopeId SCOPE.DC-MEDIA.READ-MEDIAMANAGER
+ * @permissionScope Manage Media Manager
+ * @permissionScopeId SCOPE.DC-MEDIA.MANAGE-MEDIAMANAGER
+ * @permissionScope Manage Portfolio
+ * @permissionScopeId SCOPE.PORTFOLIO.MANAGE-PORTFOLIO
+ * @permissionScope Manage Blog
+ * @permissionScopeId SCOPE.BLOG.MANAGE-BLOG
+ * @permissionScope Access Verticals by Automations
+ * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
+ * @permissionScope Set Up Automations
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
+ * @permissionId MEDIA.SITE_MEDIA_FOLDERS_READ
+ * @webhook
+ * @eventType wix.media.site_media.v1.folder_updated
+ * @serviceIdentifier com.wix.media.site_media.v1.FoldersService
+ * @slug updated
+ */
+declare function onFolderUpdated(handler: (event: FolderUpdatedEnvelope) => void | Promise<void>): void;
+type FolderNonNullablePaths = `_id` | `displayName` | `parentFolderId` | `state`;
+/**
+ * Creates a new folder in the Media Manager. <br/>
+ *
+ * Use the `parentFolderId` parameter to specify in which existing folder you want the new folder to be created.
+ * If no folder is specified, the new folder is created in the `media-root` folder.
+ * @param displayName - Folder name that appears in the Media Manager.
+ * @public
+ * @requiredField displayName
+ * @param options - Options for specifying where to create a folder.
+ * @permissionId MEDIA.SITE_MEDIA_FOLDERS_CREATE
+ * @applicableIdentity APP
+ * @fqn com.wix.media.site_media.v1.FoldersService.CreateFolder
+ */
+declare function createFolder(displayName: string, options?: CreateFolderOptions): Promise<NonNullablePaths<CreateFolderResponse, {
+    [P in FolderNonNullablePaths]: `folder.${P}`;
+}[FolderNonNullablePaths]>>;
+interface CreateFolderOptions {
+    /**
+     * ID of the folder's parent folder.
+     * @maxLength 100
+     */
+    parentFolderId?: string | null;
+}
+/**
+ * Gets information from a specific folder in the Media Manager.
+ * @param folderId - Folder ID.
+ * @public
+ * @requiredField folderId
+ * @permissionId MEDIA.SITE_MEDIA_FOLDERS_READ
+ * @applicableIdentity APP
+ * @returns Information about the folder.
+ * @fqn com.wix.media.site_media.v1.FoldersService.GetFolder
+ */
+declare function getFolder(folderId: string): Promise<NonNullablePaths<Folder, FolderNonNullablePaths>>;
+/**
+ * Retrieves a list of folders in the Media Manager. To retrieve a list of folders within a specific folder in the Media Manager, specify the specific folder's ID in the `parentFolderId` parameter. If no folder is specified, the method retrieves a list of folders within the root folder of the Media Manager.
+ * @public
+ * @param options - Options to use when listing folders from the Media Manager.
+ * @permissionId MEDIA.SITE_MEDIA_FOLDERS_LIST
+ * @applicableIdentity APP
+ * @fqn com.wix.media.site_media.v1.FoldersService.ListFolders
+ */
+declare function listFolders(options?: ListFoldersOptions): Promise<NonNullablePaths<ListFoldersResponse, {
+    [P in FolderNonNullablePaths]: `folders.${number}.${P}`;
+}[FolderNonNullablePaths]>>;
+interface ListFoldersOptions {
+    /**
+     * ID of the folder's parent folder.
+     * <br /> Default: `media-root` folder.
+     * @maxLength 100
+     */
+    parentFolderId?: string | null;
+    /**
+     * Field name and order to sort by. One of: <br />
+     * * `displayName`
+     * * `updatedDate`
+     * Default: `updatedDate` in `desc` order.
+     */
+    sort?: Sorting;
+    /** Cursor and paging information. */
+    paging?: CursorPaging;
+}
+/**
+ * Searches the Media Manager and returns a list of folders that match the terms specified in the parameters. <br/>
+ *
+ * If no parameters are specified, the method returns all folders in the `MEDIA_ROOT` folder.
+ * @public
+ * @param options - Options specifying which folders to search.
+ * @permissionId MEDIA.SITE_MEDIA_FOLDERS_LIST
+ * @applicableIdentity APP
+ * @fqn com.wix.media.site_media.v1.FoldersService.SearchFolders
+ */
+declare function searchFolders(options?: SearchFoldersOptions): Promise<NonNullablePaths<SearchFoldersResponse, {
+    [P in FolderNonNullablePaths]: `folders.${number}.${P}`;
+}[FolderNonNullablePaths]>>;
+interface SearchFoldersOptions {
+    /**
+     * A root folder in the Media Manager to search in. <br />
+     * Default: `MEDIA_ROOT`.
+     */
+    rootFolder?: RootFolderWithLiterals;
+    /**
+     * Field name and order to sort by. One of:
+     * * `displayName`
+     * * `updatedDate`
+     * Default: `updatedDate` in `desc` order.
+     */
+    sort?: Sorting;
+    /** Cursor and paging information. */
+    paging?: CursorPaging;
+    /**
+     * Term to search for, such as the value of a folder's `displayName`. <br />
+     * For example, if a folder's `displayName` is 'my-videos-folder', the search term is 'my-videos-folder'.
+     * @maxLength 200
+     */
+    search?: string | null;
+}
+/**
+ * Updates a folder. <br />
+ *
+ * You can use the `parentFolderId` parameter to move a folder from its current parent folder to a different parent folder.
+ * @param _id - Folder ID. Generated when a folder is created in the Media Manager.
+ * @public
+ * @requiredField _id
+ * @requiredField folder
+ * @param folder - Folder to update.
+ * @permissionId MEDIA.SITE_MEDIA_FOLDERS_UPDATE
+ * @applicableIdentity APP
+ * @returns Information about the updated folder.
+ * @fqn com.wix.media.site_media.v1.FoldersService.UpdateFolder
+ */
+declare function updateFolder(_id: string, folder: UpdateFolder): Promise<NonNullablePaths<Folder, FolderNonNullablePaths> & {
+    __validationErrorsType?: UpdateFolderValidationErrors;
+}>;
+interface UpdateFolder {
+    /**
+     * Folder ID. Generated when a folder is created in the Media Manager.
+     * @maxLength 100
+     */
+    _id?: string;
+    /**
+     * Folder name as it appears in the Media Manager.
+     * @maxLength 256
+     */
+    displayName?: string;
+    /**
+     * ID of the folder's parent folder. <br /> Default: `media-root` folder.
+     * @maxLength 100
+     */
+    parentFolderId?: string;
+    /**
+     * Date the folder was created.
+     * @readonly
+     */
+    _createdDate?: Date | null;
+    /**
+     * Date the folder was updated.
+     * @readonly
+     */
+    _updatedDate?: Date | null;
+    /**
+     * State of the folder.
+     * @readonly
+     */
+    state?: StateWithLiterals;
+}
+/**
+ * Generates a URL for downloading a compressed file containing a specific folder in the Media Manager. <br/>
+ *
+ * The compressed file can contain sub-folders, and up to 1000 files.
+ * @param folderId - Folder ID.
+ * @public
+ * @requiredField folderId
+ * @permissionId MEDIA.SITE_MEDIA_FOLDERS_DOWNLOAD
+ * @applicableIdentity APP
+ * @fqn com.wix.media.site_media.v1.FoldersService.GenerateFolderDownloadUrl
+ */
+declare function generateFolderDownloadUrl(folderId: string): Promise<NonNullablePaths<GenerateFolderDownloadUrlResponse, `downloadUrl`>>;
+/**
+ * Temporarily deletes the specified folders from the Media Manager. <br/>
+ *
+ * The deleted folders are moved to the Media Manager's `trash-root` folder (trash bin) unless permanently deleted. To permanently delete folders, specify the `permanent` parameter with the value `true`. Permanently deleting folders isn't reversible, so make sure that the files in these folders aren't being used in a site or in any other way as the files will no longer be accessible.
+ *
+ * Note the following:
+ * * When a folder is deleted, the files in that folder are deleted.
+ * * The specified folders can be from different parent folders.
+ * * Moving multiple folders at once is an asynchronous action, and may take time for the changes to appear in the Media Manager.
+ * * Attempting to delete folders that are already in the trash bin doesn't result in an error.
+ * * If a site contains files from a deleted media folder, the files still appear on the site as the deleted folder is still in the Media Manager (in the trash bin).
+ * * You can also use the Bulk Restore Folders From Trash Bin ([SDK](https://dev.wix.com/docs/sdk/backend-modules/media/folders/bulk-restore-folders-from-trash-bin) | [REST](https://dev.wix.com/docs/rest/assets/media/media-manager/folders/bulk-restore-folders-from-trash-bin)) method to restore folders from the Media Manager's trash bin.
+ * @param folderIds - IDs of the folders to move to the Media Manager's trash bin.
+ * @public
+ * @requiredField folderIds
+ * @param options - Options to use when deleting folders.
+ * @permissionId MEDIA.SITE_MEDIA_FOLDERS_MOVE_TO_TRASH
+ * @applicableIdentity APP
+ * @fqn com.wix.media.site_media.v1.FoldersService.BulkDeleteFolders
+ */
+declare function bulkDeleteFolders(folderIds: string[], options?: BulkDeleteFoldersOptions): Promise<void>;
+interface BulkDeleteFoldersOptions {
+    /**
+     * Whether the specified folders are permanently deleted. <br />
+     * Default: `false`
+     */
+    permanent?: boolean;
+}
+/**
+ * Restores the specified folders from the Media Manager's trash bin, and moves them to their original locations in the Media Manager.
+ * @param folderIds - IDs of the folders to restore from the Media Manager's trash bin.
+ * @public
+ * @requiredField folderIds
+ * @permissionId MEDIA.SITE_MEDIA_FOLDERS_RESTORE_FROM_TRASH
+ * @applicableIdentity APP
+ * @fqn com.wix.media.site_media.v1.FoldersService.BulkRestoreFoldersFromTrashBin
+ */
+declare function bulkRestoreFoldersFromTrashBin(folderIds: string[]): Promise<void>;
+/**
+ * Retrieves a list of folders in the Media Manager's trash bin.
+ * @public
+ * @param options - Options to use when listing deleted folders from the trash bin.
+ * @permissionId MEDIA.SITE_MEDIA_FOLDERS_LIST_DELETED
+ * @applicableIdentity APP
+ * @fqn com.wix.media.site_media.v1.FoldersService.ListDeletedFolders
+ */
+declare function listDeletedFolders(options?: ListDeletedFoldersOptions): Promise<NonNullablePaths<ListDeletedFoldersResponse, {
+    [P in FolderNonNullablePaths]: `folders.${number}.${P}`;
+}[FolderNonNullablePaths]>>;
+interface ListDeletedFoldersOptions {
+    /**
+     * ID of the folder's parent folder.
+     * @maxLength 100
+     */
+    parentFolderId?: string | null;
+    /**
+     * Field name and order to sort by. One of:
+     * * `displayName`
+     * * `updatedDate`
+     * Default: `updatedDate` in `desc` order.
+     */
+    sort?: Sorting;
+    /** Cursor and paging information. */
+    paging?: CursorPaging;
+}
+
+export { type ActionEvent, type BaseEventMetadata, type BulkDeleteFoldersOptions, type BulkDeleteFoldersRequest, type BulkDeleteFoldersResponse, type BulkRestoreFoldersFromTrashBinRequest, type BulkRestoreFoldersFromTrashBinResponse, type CreateFolderOptions, type CreateFolderRequest, type CreateFolderResponse, type CursorPaging, type Cursors, type DomainEvent, type DomainEventBodyOneOf, type EntityCreatedEvent, type EntityDeletedEvent, type EntityUpdatedEvent, type EventMetadata, type Folder, type FolderCreatedEnvelope, type FolderDeletedEnvelope, type FolderUpdatedEnvelope, type GenerateFolderDownloadUrlRequest, type GenerateFolderDownloadUrlResponse, type GetFolderRequest, type GetFolderResponse, type IdentificationData, type IdentificationDataIdOneOf, type ListDeletedFoldersOptions, type ListDeletedFoldersRequest, type ListDeletedFoldersResponse, type ListFoldersOptions, type ListFoldersRequest, type ListFoldersResponse, type MessageEnvelope, Namespace, type NamespaceWithLiterals, type PagingMetadataV2, type RestoreInfo, RootFolder, type RootFolderWithLiterals, type SearchFoldersOptions, type SearchFoldersRequest, type SearchFoldersResponse, SortOrder, type SortOrderWithLiterals, type Sorting, State, type StateWithLiterals, type UnsupportedRequestValueError, type UpdateFolder, type UpdateFolderRequest, type UpdateFolderResponse, type UpdateFolderValidationErrors, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, bulkDeleteFolders, bulkRestoreFoldersFromTrashBin, createFolder, generateFolderDownloadUrl, getFolder, listDeletedFolders, listFolders, onFolderCreated, onFolderDeleted, onFolderUpdated, searchFolders, updateFolder };