@uploadcare/file-uploader 1.28.0-alpha.666 → 1.28.0-alpha.667

package/web/file-uploader.min.d.ts

@@ -2317,10 +2317,17 @@ type PluginFileActionRegistration = {
     shouldRender: (fileEntry: OutputFileEntry) => boolean;
     onClick: (fileEntry: OutputFileEntry) => void | Promise<void>;
 };
-type PluginFileHookContext = {
-    /** The file to transform */
+type PluginFileHookResult = {
+    /** The (optionally transformed) file */
     file: File | Blob;
 };
+type PluginFileHookContext = PluginFileHookResult & {
+    /**
+     * An AbortSignal that fires when the operation is cancelled (e.g. upload aborted or file removed).
+     * Hooks should respect this signal to avoid doing unnecessary work.
+     */
+    signal: AbortSignal;
+};
 type PluginFileHookRegistration = {
     /**
      * When the hook is called:
@@ -2331,15 +2338,20 @@ type PluginFileHookRegistration = {
      * `isImage`, `fileSize`, and `fileName` are all re-derived from the returned file.
      */
     type: 'beforeUpload' | 'onAdd';
-    handler: (context: PluginFileHookContext) => PluginFileHookContext | Promise<PluginFileHookContext>;
+    handler: (context: PluginFileHookContext) => PluginFileHookResult | Promise<PluginFileHookResult>;
+    /**
+     * Maximum time in milliseconds to wait for the hook to complete before skipping it.
+     * @default 30000
+     */
+    timeout?: number;
 };
 type PluginRegistryApi = {
-    registerSource: (source: PluginSourceRegistration) => PluginSourceRegistration;
-    registerActivity: (activity: PluginActivityRegistration) => PluginActivityRegistration;
-    registerFileAction: (fileAction: PluginFileActionRegistration) => PluginFileActionRegistration;
-    registerFileHook: (hook: PluginFileHookRegistration) => PluginFileHookRegistration;
-    registerIcon: (icon: PluginIconRegistration) => PluginIconRegistration;
-    registerI18n: (i18n: PluginI18nRegistration) => PluginI18nRegistration;
+    registerSource: (source: PluginSourceRegistration) => void;
+    registerActivity: (activity: PluginActivityRegistration) => void;
+    registerFileAction: (fileAction: PluginFileActionRegistration) => void;
+    registerFileHook: (hook: PluginFileHookRegistration) => void;
+    registerIcon: (icon: PluginIconRegistration) => void;
+    registerI18n: (i18n: PluginI18nRegistration) => void;
     registerConfig: <T = unknown>(definition: CustomConfigDefinition<T>) => void;
 };
 /**
@@ -2470,12 +2482,12 @@ declare class PluginRegistry {
     private _i18n;
     readonly config: CustomConfigRegistry;
     private _own;
-    addSource(pluginId: string, item: PluginSourceRegistration): PluginSourceRegistration;
-    addActivity(pluginId: string, item: PluginActivityRegistration): PluginActivityRegistration;
-    addFileAction(pluginId: string, item: PluginFileActionRegistration): PluginFileActionRegistration;
-    addFileHook(pluginId: string, item: PluginFileHookRegistration): PluginFileHookRegistration;
-    addIcon(pluginId: string, item: PluginIconRegistration): PluginIconRegistration;
-    addI18n(pluginId: string, item: PluginI18nRegistration): PluginI18nRegistration;
+    addSource(pluginId: string, item: PluginSourceRegistration): void;
+    addActivity(pluginId: string, item: PluginActivityRegistration): void;
+    addFileAction(pluginId: string, item: PluginFileActionRegistration): void;
+    addFileHook(pluginId: string, item: PluginFileHookRegistration): void;
+    addIcon(pluginId: string, item: PluginIconRegistration): void;
+    addI18n(pluginId: string, item: PluginI18nRegistration): void;
     addConfig<T>(pluginId: string, definition: CustomConfigDefinition<T>): void;
     purge(pluginId: string): void;
     snapshot(): PluginRegistrySnapshot;
@@ -3238,4 +3250,4 @@ declare global {
 declare const PACKAGE_NAME = "blocks";
 declare const PACKAGE_VERSION: string;
 
-export { LitActivityBlock as ActivityBlock, ActivityHeader, type ActivityType, type ApiAddFileCommonOptions, BaseComponent, LitBlock as Block, BtnUi, CameraSource, CloudImageEditor, CloudImageEditorActivity, CloudImageEditorBlock, type CollectionValidators, Config, type ConfigAttributesType, type ConfigComplexType, type ConfigPlainType, type ConfigType, Copyright, CropFrame, type CustomActivities, type CustomConfig, type CustomConfigDefinition, PubSub as Data, DropArea, EditorAspectRatioButtonControl, EditorCropButtonControl, EditorFilterControl, EditorFreeformButtonControl, EditorImageCropper, EditorImageFader, EditorOperationControl, EditorScroller, EditorSlider, EditorToolbar, type EventMap, type EventPayload, EventType, ExternalSource, ExternalUploadSource, FileItem, FileUploaderInline, FileUploaderMinimal, FileUploaderRegular, type FileValidator, type FileValidatorDescriptor, type FileValidators, FormInput, type FuncCollectionValidator, type FuncFileValidator, type GroupFlag, Icon, type IconHrefResolver, Img, type KebabCase$1 as KebabCase, type KebabCaseKeys, LineLoaderUi, type LocaleDefinitionOverride, type LowerCase, type LowerCaseKeys, type MetadataCallback, Modal, ModalEvents, type ModalId, type OutputCollectionErrorType, type OutputCollectionState, type OutputCollectionStatus, type OutputCustomErrorType, type OutputError, type OutputErrorCollection, type OutputErrorFile, type OutputErrorTypePayload, type OutputFileEntry, type OutputFileErrorPayload, type OutputFileErrorType, type OutputFileStatus, type Owned, PACKAGE_NAME, PACKAGE_VERSION, type PluginActivityApi, PluginActivityHost, type PluginActivityRegistration, PluginActivityRenderer, type PluginApi, type PluginConfigApi, type PluginFileActionRegistration, type PluginFileEntryUpdate, type PluginFileHookContext, type PluginFileHookRegistration, type PluginFilesApi, type PluginI18nRegistration, type PluginIconRegistration, type PluginRegistryApi, type PluginRegistrySnapshot, type PluginRender, type PluginRenderDispose, type PluginSetupParams, type PluginSetupResult, type PluginSourceRegistration, type PluginUploaderApi, PresenceToggle, ProgressBar, ProgressBarCommon, type SecureDeliveryProxyUrlResolver, type SecureUploadsSignatureAndExpire, type SecureUploadsSignatureResolver, Select, SimpleBtn, SliderUi, LitSolutionBlock as SolutionBlock, SourceBtn, SourceList, type SourceTypes, Spinner, StartFrom, Thumb, UID, UploadCtxProvider, UploadList, UploadSource, LitUploaderBlock as UploaderBlock, type UploaderPlugin, UploaderPublicApi, UrlSource, defineComponents, defineLocale, loadFileUploaderFrom, toKebabCase };
+export { LitActivityBlock as ActivityBlock, ActivityHeader, type ActivityType, type ApiAddFileCommonOptions, BaseComponent, LitBlock as Block, BtnUi, CameraSource, CloudImageEditor, CloudImageEditorActivity, CloudImageEditorBlock, type CollectionValidators, Config, type ConfigAttributesType, type ConfigComplexType, type ConfigPlainType, type ConfigType, Copyright, CropFrame, type CustomActivities, type CustomConfig, type CustomConfigDefinition, PubSub as Data, DropArea, EditorAspectRatioButtonControl, EditorCropButtonControl, EditorFilterControl, EditorFreeformButtonControl, EditorImageCropper, EditorImageFader, EditorOperationControl, EditorScroller, EditorSlider, EditorToolbar, type EventMap, type EventPayload, EventType, ExternalSource, ExternalUploadSource, FileItem, FileUploaderInline, FileUploaderMinimal, FileUploaderRegular, type FileValidator, type FileValidatorDescriptor, type FileValidators, FormInput, type FuncCollectionValidator, type FuncFileValidator, type GroupFlag, Icon, type IconHrefResolver, Img, type KebabCase$1 as KebabCase, type KebabCaseKeys, LineLoaderUi, type LocaleDefinitionOverride, type LowerCase, type LowerCaseKeys, type MetadataCallback, Modal, ModalEvents, type ModalId, type OutputCollectionErrorType, type OutputCollectionState, type OutputCollectionStatus, type OutputCustomErrorType, type OutputError, type OutputErrorCollection, type OutputErrorFile, type OutputErrorTypePayload, type OutputFileEntry, type OutputFileErrorPayload, type OutputFileErrorType, type OutputFileStatus, type Owned, PACKAGE_NAME, PACKAGE_VERSION, type PluginActivityApi, PluginActivityHost, type PluginActivityRegistration, PluginActivityRenderer, type PluginApi, type PluginConfigApi, type PluginFileActionRegistration, type PluginFileEntryUpdate, type PluginFileHookContext, type PluginFileHookRegistration, type PluginFileHookResult, type PluginFilesApi, type PluginI18nRegistration, type PluginIconRegistration, type PluginRegistryApi, type PluginRegistrySnapshot, type PluginRender, type PluginRenderDispose, type PluginSetupParams, type PluginSetupResult, type PluginSourceRegistration, type PluginUploaderApi, PresenceToggle, ProgressBar, ProgressBarCommon, type SecureDeliveryProxyUrlResolver, type SecureUploadsSignatureAndExpire, type SecureUploadsSignatureResolver, Select, SimpleBtn, SliderUi, LitSolutionBlock as SolutionBlock, SourceBtn, SourceList, type SourceTypes, Spinner, StartFrom, Thumb, UID, UploadCtxProvider, UploadList, UploadSource, LitUploaderBlock as UploaderBlock, type UploaderPlugin, UploaderPublicApi, UrlSource, defineComponents, defineLocale, loadFileUploaderFrom, toKebabCase };