useblocks 1.1.56 → 1.1.62

package/useblocks.d.ts

@@ -5,8 +5,8 @@ interface FileManageErrorInfo$1 {
   raw?: any;
   stack?: string;
 }
-/**
- * Error codes for FileManager API operations.
+/**
+ * Error codes for FileManager API operations.
  */
 type FileManagerErrorCode =
 // --- Files ---
@@ -31,40 +31,40 @@ type FileManagerErrorCode =
 'AIResponseInvalid' | 'AIImageGenerationFailed' | 'AIImageGenerationLimitExceeded' | 'IntegrationError' | 'ThirdPartyError' |
 // --- General / fallback ---
 'UnknownError';
-/**
- * Error interface for FileManager API.
- * Implemented by FileManagerApiError class which is also exported.
- *
- * @example
- * ```typescript
- * // Using the class
- * throw new FileManagerApiError(
- *   'File not found',
- *   'FileNotFound',
- *   404
- * );
- *
- * // Or creating a custom class
- * class MyFileManagerError extends Error implements IFileManagerApiError {
- *   constructor(
- *     message: string,
- *     public code: FileManagerErrorCode,
- *     public status?: number,
- *     public details?: unknown
- *   ) {
- *     super(message);
- *     this.name = 'MyFileManagerError';
- *   }
- * }
- * ```
+/**
+ * Error interface for FileManager API.
+ * Implemented by FileManagerApiError class which is also exported.
+ *
+ * @example
+ * ```typescript
+ * // Using the class
+ * throw new FileManagerApiError(
+ *   'File not found',
+ *   'FileNotFound',
+ *   404
+ * );
+ *
+ * // Or creating a custom class
+ * class MyFileManagerError extends Error implements IFileManagerApiError {
+ *   constructor(
+ *     message: string,
+ *     public code: FileManagerErrorCode,
+ *     public status?: number,
+ *     public details?: unknown
+ *   ) {
+ *     super(message);
+ *     this.name = 'MyFileManagerError';
+ *   }
+ * }
+ * ```
  */
 interface IFileManagerApiError extends Error {
   code: FileManagerErrorCode;
   status?: number;
   details?: unknown;
 }
-/**
- * Parameters for file query operations.
+/**
+ * Parameters for file query operations.
  */
 interface FilesQueryParams {
   folderId?: string;
@@ -77,8 +77,8 @@ interface FilesQueryParams {
   /** Человекочитаемое имя папки для UI (не отправляется на API). */
   folderName?: string;
 }
-/**
- * Context payload for operations involving items (files/folders).
+/**
+ * Context payload for operations involving items (files/folders).
  */
 interface ItemContextPayload$1 {
   itemIds?: string[];
@@ -86,8 +86,8 @@ interface ItemContextPayload$1 {
   folderId?: string | null;
   folderName?: string | null;
 }
-/**
- * Placement options for notification display.
+/**
+ * Placement options for notification display.
  */
 type NotifyPlacement = 'top' | 'topLeft' | 'topRight' | 'bottom' | 'bottomLeft' | 'bottomRight';
 type Notify$1 = {
@@ -111,42 +111,42 @@ type Notify$1 = {
   role?: 'alert' | 'status';
 };
 declare namespace Notify$1 {
-  /**
-   * Payload for successful batch operations.
+  /**
+   * Payload for successful batch operations.
    */
   export interface OperationSuccessPayload extends ItemContextPayload$1 {
     successCount: number;
     totalCount: number;
     eventSource?: UploadEventSource;
   }
-  /**
-   * Details of an error for a single item in a batch operation.
+  /**
+   * Details of an error for a single item in a batch operation.
    */
   export interface OperationErrorDetail {
     itemId?: string;
     itemName?: string;
     error: FileManageErrorInfo$1;
   }
-  /**
-   * Payload for batch operation errors.
-   * Extends ItemContextPayload with error-specific fields.
+  /**
+   * Payload for batch operation errors.
+   * Extends ItemContextPayload with error-specific fields.
    */
   export interface OperationErrorPayload extends ItemContextPayload$1 {
     failCount: number;
     totalCount: number;
     errors?: OperationErrorDetail[];
-    /**
-     * Flag indicating if this is a move-to-trash operation (true) or permanent delete (false).
-     * Used to differentiate between soft delete (trash) and hard delete operations.
+    /**
+     * Flag indicating if this is a move-to-trash operation (true) or permanent delete (false).
+     * Used to differentiate between soft delete (trash) and hard delete operations.
      */
     isTrashMove?: boolean;
     eventSource?: UploadEventSource;
   }
-  /**
-   * Details of a single item in batch operation results.
-   * Used in the `detailed` array for batch operations (deleteItems, moveItems, copyItems, uploadFiles).
-   *
-   * @template T - Type of successful operation result data
+  /**
+   * Details of a single item in batch operation results.
+   * Used in the `detailed` array for batch operations (deleteItems, moveItems, copyItems, uploadFiles).
+   *
+   * @template T - Type of successful operation result data
    */
   export interface BatchOperationDetail<T = unknown> {
     /** Correlation identifier for the request item (preferred) */
@@ -160,11 +160,11 @@ declare namespace Notify$1 {
     /** Error for failed operation */
     error?: FileManageErrorInfo$1;
   }
-  /**
-   * Result of a batch operation with support for detailed results.
-   * Unified type for all batch operations in the file manager.
-   *
-   * @template T - Type of successful operation result data
+  /**
+   * Result of a batch operation with support for detailed results.
+   * Unified type for all batch operations in the file manager.
+   *
+   * @template T - Type of successful operation result data
    */
   export interface BatchOperationResult<T = unknown> {
     /** Overall success flag (true if all items succeeded) */
@@ -174,9 +174,9 @@ declare namespace Notify$1 {
     /** Detailed results for each item */
     detailed?: BatchOperationDetail<T>[];
   }
-  /**
-   * Summary of batch operation results for notifications.
-   * Used for aggregated error and success notifications.
+  /**
+   * Summary of batch operation results for notifications.
+   * Used for aggregated error and success notifications.
    */
   export interface BatchOperationSummary {
     /** Number of successfully processed items */
@@ -188,8 +188,8 @@ declare namespace Notify$1 {
     /** Error details for each item */
     errors: OperationErrorDetail[];
   }
-  /**
-   * Payload for operations involving a single item (file or folder).
+  /**
+   * Payload for operations involving a single item (file or folder).
    */
   export interface SingleItemPayload {
     itemId?: string;
@@ -197,37 +197,37 @@ declare namespace Notify$1 {
     folderId?: string | null;
     folderName?: string | null;
   }
-  /**
-   * Payload for rename operation errors.
+  /**
+   * Payload for rename operation errors.
    */
   export interface RenameErrorPayload extends SingleItemPayload {
     error: FileManageErrorInfo$1;
   }
-  /**
-   * Source of the upload event: 'upload' for file picker/drag-drop, 'uploadByUrl' for URL upload.
+  /**
+   * Source of the upload event: 'upload' for file picker/drag-drop, 'uploadByUrl' for URL upload.
    */
   export type UploadEventSource = 'upload' | 'uploadByUrl' | 'pixie' | 'iconStock' | 'imageStock' | 'gif';
-  /**
-   * Payload for file upload operations.
+  /**
+   * Payload for file upload operations.
    */
   export interface FileUploadPayload extends SingleItemPayload {
     uploadId?: string;
     eventSource?: UploadEventSource;
   }
-  /**
-   * Payload for file upload errors.
+  /**
+   * Payload for file upload errors.
    */
   export interface FileUploadErrorPayload extends FileUploadPayload {
     error?: FileManageErrorInfo$1;
   }
-  /**
-   * Payload for unsupported file type errors.
+  /**
+   * Payload for unsupported file type errors.
    */
   export interface UnsupportedFileTypePayload extends FileUploadErrorPayload {
     fileType: string;
   }
-  /**
-   * Payload for folder operation errors and successes.
+  /**
+   * Payload for folder operation errors and successes.
    */
   export interface FolderOperationPayload extends ItemContextPayload$1 {
     folderId?: string | null;
@@ -235,21 +235,21 @@ declare namespace Notify$1 {
     reason?: string;
     is_force_create?: boolean;
   }
-  /**
-   * Payload for file URL validation errors.
+  /**
+   * Payload for file URL validation errors.
    */
   export interface FileUrlValidationErrorPayload {
     url?: string | null;
     error: FileManageErrorInfo$1;
   }
-  /**
-   * Payload for image file operations.
+  /**
+   * Payload for image file operations.
    */
   export interface ImageFilePayload extends SingleItemPayload {
     thumbnail?: string | null;
   }
-  /**
-   * Payload for URL upload operations.
+  /**
+   * Payload for URL upload operations.
    */
   export interface UrlUploadPayload {
     url?: string | null;
@@ -257,52 +257,52 @@ declare namespace Notify$1 {
     folderName?: string | null;
     eventSource?: UploadEventSource;
   }
-  /**
-   * Payload for URL upload errors.
+  /**
+   * Payload for URL upload errors.
    */
   export interface UrlUploadErrorPayload extends UrlUploadPayload {
     error: FileManageErrorInfo$1;
   }
-  /**
-   * Payload for file fetch errors.
+  /**
+   * Payload for file fetch errors.
    */
   export interface FetchFilesErrorPayload {
     params?: FilesQueryParams;
     /** Отображаемое имя папки списка (после resolve getItem / path / кэша). */
     folderName?: string | null;
   }
-  /**
-   * Base payload for AI image generation operations.
+  /**
+   * Base payload for AI image generation operations.
    */
   interface AIImageGenerationBasePayload {
     request: string;
     taskId?: string | null;
   }
-  /**
-   * Payload for AI image generation started event.
+  /**
+   * Payload for AI image generation started event.
    */
   export interface AIImageGenerationStartedPayload extends AIImageGenerationBasePayload {
     response?: unknown;
   }
-  /**
-   * Payload for successful AI image generation.
+  /**
+   * Payload for successful AI image generation.
    */
   export interface AIImageGenerationSuccessPayload extends AIImageGenerationBasePayload {
     images: string[];
   }
-  /**
-   * Payload for failed AI image generation.
+  /**
+   * Payload for failed AI image generation.
    */
   export interface AIImageGenerationFailedPayload extends AIImageGenerationBasePayload {
     response?: unknown;
     error?: FileManageErrorInfo$1;
   }
-  /**
-   * Base type for error notification events.
-   * Includes innerException field for error details.
-   *
-   * @template TId - Notification event ID type
-   * @template TData - Payload data type
+  /**
+   * Base type for error notification events.
+   * Includes innerException field for error details.
+   *
+   * @template TId - Notification event ID type
+   * @template TData - Payload data type
    */
   export type ErrorEventBase<TId extends string, TData> = {
     id: TId;
@@ -312,29 +312,29 @@ declare namespace Notify$1 {
     title?: string;
     placement?: NotifyPlacement;
     description?: string;
-    /**
-     * Visibility flag for the notification.
-     * If true, notification will be shown; if false, it will be silent.
-     * Derived from the `silent` parameter (visibility = !silent).
-     * Can be modified by event interceptors.
+    /**
+     * Visibility flag for the notification.
+     * If true, notification will be shown; if false, it will be silent.
+     * Derived from the `silent` parameter (visibility = !silent).
+     * Can be modified by event interceptors.
      */
     visibility?: boolean;
-    /**
-     * Level of the operation: 'item' for single item operations, 'batch' for batch operations.
+    /**
+     * Level of the operation: 'item' for single item operations, 'batch' for batch operations.
      */
     level?: 'item' | 'batch';
-    /**
-     * Если true — применять TTL-дедупликацию одинаковых уведомлений (после interceptors).
-     * Для upload/мутаций обычно не задаётся или false.
+    /**
+     * Если true — применять TTL-дедупликацию одинаковых уведомлений (после interceptors).
+     * Для upload/мутаций обычно не задаётся или false.
      */
     notificationDedupe?: boolean;
   };
-  /**
-   * Base type for success, warning, and info notification events.
-   * Does not include innerException field.
-   *
-   * @template TId - Notification event ID type
-   * @template TData - Payload data type
+  /**
+   * Base type for success, warning, and info notification events.
+   * Does not include innerException field.
+   *
+   * @template TId - Notification event ID type
+   * @template TData - Payload data type
    */
   export type NotificationEventBase<TId extends string, TData> = {
     id: TId;
@@ -343,30 +343,30 @@ declare namespace Notify$1 {
     title?: string;
     placement?: NotifyPlacement;
     description?: string;
-    /**
-     * Visibility flag for the notification.
-     * If true, notification will be shown; if false, it will be silent.
-     * Derived from the `silent` parameter (visibility = !silent).
-     * Can be modified by event interceptors.
+    /**
+     * Visibility flag for the notification.
+     * If true, notification will be shown; if false, it will be silent.
+     * Derived from the `silent` parameter (visibility = !silent).
+     * Can be modified by event interceptors.
      */
     visibility?: boolean;
-    /**
-     * Level of the operation: 'item' for single item operations, 'batch' for batch operations.
+    /**
+     * Level of the operation: 'item' for single item operations, 'batch' for batch operations.
      */
     level?: 'item' | 'batch';
   };
-  /**
-   * Map of error notification IDs to their payload types for single item operations.
-   * All item operation errors extend OperationErrorPayload with failCount: 1 and totalCount: 1.
+  /**
+   * Map of error notification IDs to their payload types for single item operations.
+   * All item operation errors extend OperationErrorPayload with failCount: 1 and totalCount: 1.
    */
   export interface ItemErrorMap {
     FILE_DELETE_ERROR: OperationErrorPayload;
     FILE_MOVE_ERROR: OperationErrorPayload;
     FILE_COPY_ERROR: OperationErrorPayload;
   }
-  /**
-   * Map of error notification IDs to their payload types for batch operations.
-   * All batch operation errors extend OperationErrorPayload.
+  /**
+   * Map of error notification IDs to their payload types for batch operations.
+   * All batch operation errors extend OperationErrorPayload.
    */
   export interface BatchErrorMap {
     FILES_DELETE_ERROR: OperationErrorPayload;
@@ -375,18 +375,18 @@ declare namespace Notify$1 {
     FILES_MOVE_ERROR: OperationErrorPayload;
     FILES_COPY_ERROR: OperationErrorPayload;
   }
-  /**
-   * Map of success notification IDs to their payload types for single item operations.
-   * All item operation successes extend OperationSuccessPayload with successCount: 1 and totalCount: 1.
+  /**
+   * Map of success notification IDs to their payload types for single item operations.
+   * All item operation successes extend OperationSuccessPayload with successCount: 1 and totalCount: 1.
    */
   export interface ItemSuccessMap {
     FILE_DELETE_SUCCESS: OperationSuccessPayload;
     FILE_MOVE_SUCCESS: OperationSuccessPayload;
     FILE_COPY_SUCCESS: OperationSuccessPayload;
   }
-  /**
-   * Map of success notification IDs to their payload types for batch operations.
-   * All batch operation successes extend OperationSuccessPayload.
+  /**
+   * Map of success notification IDs to their payload types for batch operations.
+   * All batch operation successes extend OperationSuccessPayload.
    */
   export interface BatchSuccessMap {
     FILES_DELETE_SUCCESS: OperationSuccessPayload;
@@ -395,9 +395,9 @@ declare namespace Notify$1 {
     FOLDER_DELETE_SUCCESS: OperationSuccessPayload;
     FILES_UPLOAD_BATCH_SUCCESS: OperationSuccessPayload;
   }
-  /**
-   * Map of all error notification IDs to their payload types.
-   * Extends ItemErrorMap for single item operations and BatchErrorMap for batch operations.
+  /**
+   * Map of all error notification IDs to their payload types.
+   * Extends ItemErrorMap for single item operations and BatchErrorMap for batch operations.
    */
   export interface ErrorMap extends ItemErrorMap, BatchErrorMap {
     FILE_DOWNLOAD_FAILED: ImageFilePayload;
@@ -439,19 +439,19 @@ declare namespace Notify$1 {
     TRASH_CLEAR_FAILED: OperationErrorPayload;
     TRASH_CLEAR_ERROR: never;
   }
-  /**
-   * Union type of all error events.
+  /**
+   * Union type of all error events.
    */
   export type Error = { [K in keyof ErrorMap]: ErrorEventBase<K, ErrorMap[K]>; }[keyof ErrorMap];
-  /**
-   * Error notification event type.
+  /**
+   * Error notification event type.
    */
   export type ErrorEvent = {
     type: 'error';
   } & Error;
-  /**
-   * Map of all success notification IDs to their payload types.
-   * Extends ItemSuccessMap for single item operations and BatchSuccessMap for batch operations.
+  /**
+   * Map of all success notification IDs to their payload types.
+   * Extends ItemSuccessMap for single item operations and BatchSuccessMap for batch operations.
    */
   export interface SuccessMap extends ItemSuccessMap, BatchSuccessMap {
     AI_IMAGE_GENERATION_STARTED: AIImageGenerationStartedPayload;
@@ -466,51 +466,51 @@ declare namespace Notify$1 {
     TRASH_CLEARED_SUCCESS: never;
     FOLDER_NOT_FOUND_NAVIGATE: never;
   }
-  /**
-   * Union type of all success events.
+  /**
+   * Union type of all success events.
    */
   export type Success = { [K in keyof SuccessMap]: NotificationEventBase<K, SuccessMap[K]>; }[keyof SuccessMap];
-  /**
-   * Success notification event type.
+  /**
+   * Success notification event type.
    */
   export type SuccessEvent = {
     type: 'success';
   } & Success;
-  /**
-   * Map of warning notification IDs to their payload types.
+  /**
+   * Map of warning notification IDs to their payload types.
    */
   export interface WarningMap {
     FILES_UPLOAD_UNSUPPORTED_TYPE: UnsupportedFileTypePayload;
     FOLDER_OPERATION_VALIDATION_FAILED: FolderOperationPayload;
     TRASH_CLEARED_PARTIAL: OperationErrorPayload;
   }
-  /**
-   * Union type of all warning events.
+  /**
+   * Union type of all warning events.
    */
   export type Warning = { [K in keyof WarningMap]: NotificationEventBase<K, WarningMap[K]>; }[keyof WarningMap];
-  /**
-   * Warning notification event type.
+  /**
+   * Warning notification event type.
    */
   export type WarningEvent = {
     type: 'warning';
   } & Warning;
-  /**
-   * Map of info notification IDs to their payload types.
+  /**
+   * Map of info notification IDs to their payload types.
    */
   export interface InfoMap {}
-  /**
-   * Union type of all info events.
+  /**
+   * Union type of all info events.
    */
   export type Info = { [K in keyof InfoMap]: NotificationEventBase<K, InfoMap[K]>; }[keyof InfoMap];
-  /**
-   * Info notification event type.
+  /**
+   * Info notification event type.
    */
   export type InfoEvent = {
     type: 'info';
   } & Info;
 }
-/**
- * Union type of all notification events (error, success, warning, info).
+/**
+ * Union type of all notification events (error, success, warning, info).
  */
 type NotifyEvent$1 = Notify$1.SuccessEvent | Notify$1.ErrorEvent | Notify$1.WarningEvent | Notify$1.InfoEvent;
 declare namespace fileManager_d_exports {
@@ -2038,7 +2038,15 @@ export declare namespace ExportedApi {
     }
   }
   interface Options extends DataMixin.Options {
+    /**
+     * Standalone zip key (base64). Without `standaloneOnAuthFailure` — applied at init (immediate standalone).
+     */
     standaloneKey?: string;
+    /**
+     * When true, try hosted auth + `app_init` first; apply `standaloneKey` only on failure.
+     * Requires top-level `standaloneKey`.
+     */
+    standaloneOnAuthFailure?: boolean;
   }
   interface Instance extends DataMixin.Instance {}
 }