@uploadcare/file-uploader 1.33.2 → 1.34.0

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

@@ -2,8 +2,8 @@ import { LitElement, PropertyValues, TemplateResult, nothing } from 'lit';
 import * as lit_html from 'lit-html';
 import * as lit_html_directives_ref_js from 'lit-html/directives/ref.js';
 import * as _uploadcare_upload_client from '@uploadcare/upload-client';
-import { UploadcareFile, FileFromOptions, Metadata, Tags, UploadError, NetworkError, UploadcareGroup, Queue } from '@uploadcare/upload-client';
-export { Metadata, NetworkError, Tags, UploadError, UploadcareError, UploadcareFile, UploadcareGroup } from '@uploadcare/upload-client';
+import { UploadcareFile, Metadata, Tags, AuthToken, FileFromOptions, UploadError, AuthTokenResolverError, NetworkError, UploadcareGroup, Queue } from '@uploadcare/upload-client';
+export { AuthToken, AuthTokenResolverError, Metadata, NetworkError, Tags, UploadError, UploadcareError, UploadcareFile, UploadcareGroup } from '@uploadcare/upload-client';
 import { Ref } from 'lit/directives/ref.js';
 import { TelemetryRequest } from '@uploadcare/quality-insights';
 
@@ -252,21 +252,6 @@ declare class RouterHooksLayer extends SharedInstance {
     navigateAfterFileAdd(): void;
 }
 
-declare class A11y implements ISharedInstance {
-    private _destroyKeyUX;
-    private readonly _scopedWindow;
-    constructor();
-    registerBlock(scope: LitBlock): void;
-    destroy(): void;
-}
-
-declare class LocaleManager extends SharedInstance {
-    private _localeName;
-    constructor(sharedInstancesBag: SharedInstancesBag);
-    private _applyOverrides;
-    private _applyPluginLocales;
-}
-
 /**
  * Custom configuration options registration system for plugins
  */
@@ -327,8 +312,6 @@ declare class CustomConfigRegistry {
 interface CustomConfig {
 }
 
-declare function buildOutputCollectionState<TCollectionStatus extends OutputCollectionStatus, TGroupFlag extends GroupFlag = 'maybe-has-group'>(bag: SharedInstancesBag): OutputCollectionState<TCollectionStatus, TGroupFlag>;
-
 declare class TypedData<T extends Record<string, unknown>> {
     private _ctxId;
     private _data;
@@ -341,6 +324,91 @@ declare class TypedData<T extends Record<string, unknown>> {
     destroy(): void;
 }
 
+interface UploadEntryData extends Record<string, unknown> {
+    file: File | null;
+    externalUrl: string | null;
+    fileName: string | null;
+    fileSize: number | null;
+    lastModified: number;
+    uploadProgress: number;
+    uuid: string | null;
+    isImage: boolean;
+    mimeType: string | null;
+    ctxName: string | null;
+    cdnUrl: string | null;
+    cdnUrlModifiers: string | null;
+    fileInfo: UploadcareFile | null;
+    isUploading: boolean;
+    abortController: AbortController | null;
+    thumbUrl: string | null;
+    silent: boolean;
+    source: string | null;
+    fullPath: string | null;
+    metadata: Metadata | null;
+    tags: Tags | null;
+    errors: OutputErrorFile[];
+    uploadError: Error | null;
+    isRemoved: boolean;
+    isQueuedForUploading: boolean;
+    isValidationPending: boolean;
+    isQueuedForValidation: boolean;
+}
+type UploadEntryTypedData = TypedData<UploadEntryData>;
+type UploadEntryKeys = keyof UploadEntryData;
+
+declare class PluginRegistry {
+    private _sources;
+    private _activities;
+    private _fileActions;
+    private _fileHooks;
+    private _icons;
+    private _l10n;
+    readonly config: CustomConfigRegistry;
+    /**
+     * Notify consumers (LocaleManager, SourceListController, …) that the registry
+     * changed so they re-apply the new state. Coalesces a synchronous burst of
+     * registrations — a plugin's setup() typically registers an icon, a source,
+     * several l10n maps, … in one tick — into a single, deferred notification.
+     * Registrations can also happen lazily, long after setup() ran (e.g. a locale's
+     * strings loaded when `localeName` changes), which is why this exists.
+     */
+    private readonly _scheduleNotify;
+    constructor(onChange?: () => void);
+    /** Drop any pending notification (call on teardown). */
+    destroy(): void;
+    private _own;
+    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;
+    addL10n(pluginId: string, item: PluginL10nRegistration): void;
+    addConfig<T>(pluginId: string, definition: CustomConfigDefinition<T>): void;
+    purge(pluginId: string): void;
+    snapshot(): PluginRegistrySnapshot;
+}
+
+declare class PluginManager extends SharedInstance {
+    private _plugins;
+    private _subscribers;
+    private _pluginsUpdate;
+    private _lazyPluginLoader;
+    readonly registry: PluginRegistry;
+    get configRegistry(): CustomConfigRegistry;
+    constructor(sharedInstancesBag: SharedInstancesBag);
+    pluginsReady(): Promise<void>;
+    onPluginsChange(callback: Unsubscriber): Unsubscriber;
+    private _syncPlugins;
+    private _registerPlugin;
+    private _unregisterPlugin;
+    snapshot(): PluginRegistrySnapshot;
+    runOnAddHooks(entry: UploadEntryTypedData): Promise<void>;
+    destroy(): void;
+    private _notifySubscribers;
+}
+
+declare function buildOutputCollectionState<TCollectionStatus extends OutputCollectionStatus, TGroupFlag extends GroupFlag = 'maybe-has-group'>(bag: SharedInstancesBag): OutputCollectionState<TCollectionStatus, TGroupFlag>;
+
 type FuncFileValidator = (outputEntry: OutputFileEntry, api: UploaderPublicApi, options?: {
     signal?: AbortSignal;
 }) => undefined | OutputErrorFile | Promise<undefined | OutputErrorFile>;
@@ -1351,6 +1419,12 @@ type ApiAddFileCommonOptions = {
 declare class UploaderPublicApi extends SharedInstance {
     private _l10n;
     get _uploadCollection(): TypedCollection<UploadEntryData>;
+    /**
+     * The failure of the last group creation, for the validator that reports it.
+     * Underscored like `_uploadCollection`: internal, but a validator has no
+     * other way to reach the context.
+     */
+    get _groupError(): Error | null;
     get cfg(): Readonly<ConfigType>;
     get l10n(): (str: string, variables?: Record<string, string | number>) => string;
     /**
@@ -1391,6 +1465,26 @@ declare class UploaderPublicApi extends SharedInstance {
     private _pluginsReady;
     setCurrentActivity: <T extends ActivityType>(activityType: T, ...params: T extends keyof ActivityParamsMap ? [ActivityParamsMap[T]] extends [never] ? [] : [ActivityParamsMap[T]] : []) => void;
     on: <T extends EventKey>(type: T, handler: (payload: EventPayload[T]) => void) => (() => void);
+    /**
+     * The auth token as `@uploadcare/upload-client` receives it: the configured
+     * string, or a resolver whose result the uploader already caches.
+     *
+     * Forward this rather than `cfg.authToken` when something else has to
+     * authenticate with the same token — a plugin, say — so it shares this cache
+     * instead of calling your token endpoint again.
+     */
+    getAuthToken: () => AuthToken | undefined;
+    /**
+     * Drop the cached auth token, so the next request asks `authToken` for a new
+     * one.
+     *
+     * Assigning a different function to `authToken` does not do this: a new
+     * function identity is taken to be the same function, which is what lets a
+     * React component pass an inline resolver without refetching on every render.
+     * Call this when the change is real — the signed-in user changed, say — or
+     * rely on short-lived tokens.
+     */
+    invalidateAuthToken: () => void;
     getCurrentActivity: () => ActivityType;
     historyBack: () => void;
     setModalState: (opened: boolean) => void;
@@ -1439,6 +1533,7 @@ declare class LitUploaderBlock extends LitActivityBlock {
         '*collectionErrors': OutputErrorCollection[];
         '*collectionState': OutputCollectionState | null;
         '*groupInfo': _uploadcare_upload_client.UploadcareGroup | null;
+        '*groupError': Error | null;
         '*uploadTrigger': Set<string>;
         '*currentActivity': null;
         '*currentActivityParams': {};
@@ -1453,11 +1548,26 @@ declare class LitUploaderBlock extends LitActivityBlock {
     get api(): UploaderPublicApi;
     get uploadCollection(): TypedCollection<UploadEntryData>;
     get secureUploadsManager(): SecureUploadsManager;
+    get authTokenManager(): AuthTokenManager;
     disconnectedCallback(): void;
     connectedCallback(): void;
     private _initCtxOwner;
     private _observeUploadCollection;
     private _unobserveUploadCollection;
+    /** Bumped whenever the collection changes; see `_flushOutputItems`. */
+    private _groupGeneration;
+    /**
+     * Creates the group for `collectionState` and reports the outcome, whichever
+     * it is. Never rejects: the caller does not wait for the group, so a
+     * rejection would have nowhere to go.
+     *
+     * A request cannot be cancelled once the API has it, so both outcomes are
+     * dropped when the collection has moved on — a group of files that are no
+     * longer the collection is neither its group nor its error. That is what the
+     * generation tracks; `*collectionState` cannot, since it is republished on a
+     * flush rather than on every change, and is still the same object at the
+     * moment a mid-flight response lands.
+     */
     private _createGroup;
     private _flushOutputItems;
     private _handleCollectionUpdate;
@@ -1606,11 +1716,67 @@ declare global {
 }
 
 /**
- * Config keys that can't be passed as attribute (because they are object or function)
+ * How a built-in config key relates to its DOM attribute — the same idea as a
+ * plugin's {@link CustomConfigDefinition.attribute}, declared for built-ins.
+ *
+ * Both default to `true`; a key only appears here to opt out of something.
+ * - `attribute: false` — property only, no attribute representation at all
+ *   (the value is an object or a function).
+ * - `reflect: false` — readable from an attribute, but the value is never
+ *   written back to one.
  */
-declare const complexConfigKeys: readonly ["metadata", "tags", "plugins", "localeDefinitionOverride", "secureUploadsSignatureResolver", "secureDeliveryProxyUrlResolver", "iconHrefResolver", "fileValidators", "collectionValidators", "mediaRecorderOptions"];
+type ConfigAttributeBehavior = {
+    attribute?: boolean;
+    reflect?: boolean;
+};
+declare const configAttributeBehavior: {
+    readonly metadata: {
+        readonly attribute: false;
+    };
+    readonly tags: {
+        readonly attribute: false;
+    };
+    readonly plugins: {
+        readonly attribute: false;
+    };
+    readonly localeDefinitionOverride: {
+        readonly attribute: false;
+    };
+    readonly secureUploadsSignatureResolver: {
+        readonly attribute: false;
+    };
+    readonly secureDeliveryProxyUrlResolver: {
+        readonly attribute: false;
+    };
+    readonly iconHrefResolver: {
+        readonly attribute: false;
+    };
+    readonly fileValidators: {
+        readonly attribute: false;
+    };
+    readonly collectionValidators: {
+        readonly attribute: false;
+    };
+    readonly mediaRecorderOptions: {
+        readonly attribute: false;
+    };
+    /**
+     * Settable either way: the attribute carries a plain token, the property also
+     * accepts a resolver. Never reflected — a resolver has no attribute form, and
+     * a bearer credential is not something to mirror into the DOM unasked.
+     */
+    readonly authToken: {
+        readonly reflect: false;
+    };
+};
+/** Keys of the descriptor whose `field` is declared as `Value`. */
+type KeysWithBehavior<Field extends keyof ConfigAttributeBehavior, Value extends boolean> = {
+    [K in keyof typeof configAttributeBehavior]: (typeof configAttributeBehavior)[K] extends Record<Field, Value> ? K : never;
+}[keyof typeof configAttributeBehavior];
+/** Keys the descriptor marks as having no attribute representation at all. */
+type PropertyOnlyConfigKey = KeysWithBehavior<'attribute', false>;
 declare class Config extends LitBlock {
-    attributesMeta: Partial<ConfigPlainType> & {
+    attributesMeta: Partial<AttributeConfigType> & {
         'ctx-name': string;
     };
     init$: LitBlock["init$"] & ConfigType;
@@ -1642,6 +1808,8 @@ declare class Config extends LitBlock {
      * Get attribute names for a config key (kebab-case and lowercase)
      */
     private _getAttributeNames;
+    /** Whether this key's value is written back to the DOM as an attribute. */
+    private _isReflectedToAttribute;
     private _flushValueToAttribute;
     private _flushValueToState;
     private _setValue;
@@ -2231,6 +2399,12 @@ type ConfigType = {
      * Resolver for secure uploads signature.
      */
     secureUploadsSignatureResolver: SecureUploadsSignatureResolver | null;
+    /**
+     * JWT for the Upload API `Authorization: Bearer <token>` scheme. Accepts a plain token or a resolver function; the
+     * resolver is called before every request, so long-running uploads can supply a fresh token mid-flight. Takes
+     * precedence over `secureSignature`/`secureExpire` and `secureUploadsSignatureResolver`.
+     */
+    authToken: AuthToken | null;
     /**
      * Resolver for secure delivery proxy URL.
      */
@@ -2307,9 +2481,32 @@ type ConfigType = {
     dynamicButtonViewMode: DynamicButtonMode;
     dynamicButtonShowFirstIcon: boolean;
 };
-type ConfigComplexType = Pick<ConfigType, (typeof complexConfigKeys)[number]>;
-type ConfigPlainType = Omit<ConfigType, keyof ConfigComplexType>;
-type ConfigAttributesType = KebabCaseKeys<ConfigPlainType> & LowerCaseKeys<ConfigPlainType>;
+/** Options with no attribute representation: settable only as a DOM property. */
+type PropertyOnlyConfigType = Pick<ConfigType, PropertyOnlyConfigKey>;
+/** Options settable via an attribute (as well as as a property). */
+type AttributeConfigType = Omit<ConfigType, PropertyOnlyConfigKey>;
+/**
+ * @deprecated Renamed to {@link PropertyOnlyConfigType}. Kept as an alias so
+ *   existing imports keep compiling.
+ */
+type ConfigComplexType = PropertyOnlyConfigType;
+/**
+ * @deprecated Renamed to {@link AttributeConfigType}. Kept as an alias so
+ *   existing imports keep compiling.
+ */
+type ConfigPlainType = AttributeConfigType;
+/**
+ * A DOM attribute can only ever carry a primitive, so an option whose value type
+ * also admits an object or a function (`authToken` accepts a token *or* a
+ * resolver) exposes only the primitive half here. Without this, JSX would
+ * type-accept a function and silently stringify it into the DOM. For options
+ * that are already primitive this is the identity.
+ */
+type AttributeValue<T> = Extract<T, string | number | boolean | null | undefined>;
+type ConfigAttributeValues = {
+    [K in keyof AttributeConfigType]: AttributeValue<AttributeConfigType[K]>;
+};
+type ConfigAttributesType = KebabCaseKeys<ConfigAttributeValues> & LowerCaseKeys<ConfigAttributeValues>;
 type KebabCase$1<S extends string> = S extends `${infer C}${infer T}` ? T extends Uncapitalize<T> ? `${Uncapitalize<C>}${KebabCase$1<T>}` : `${Uncapitalize<C>}-${KebabCase$1<T>}` : S;
 type KebabCaseKeys<T extends Record<string, unknown>> = {
     [Key in keyof T as KebabCase$1<Key & string>]: T[Key];
@@ -2320,8 +2517,8 @@ type LowerCaseKeys<T extends Record<string, unknown>> = {
 };
 type OutputFileStatus = 'idle' | 'uploading' | 'success' | 'failed' | 'removed';
 type OutputCustomErrorType = 'CUSTOM_ERROR';
-type OutputFileErrorType = OutputCustomErrorType | 'NOT_AN_IMAGE' | 'FORBIDDEN_FILE_TYPE' | 'FILE_SIZE_EXCEEDED' | 'UPLOAD_ERROR' | 'NETWORK_ERROR' | 'UNKNOWN_ERROR';
-type OutputCollectionErrorType = OutputCustomErrorType | 'SOME_FILES_HAS_ERRORS' | 'TOO_MANY_FILES' | 'TOO_FEW_FILES';
+type OutputFileErrorType = OutputCustomErrorType | 'NOT_AN_IMAGE' | 'FORBIDDEN_FILE_TYPE' | 'FILE_SIZE_EXCEEDED' | 'UPLOAD_ERROR' | 'AUTH_TOKEN_ERROR' | 'NETWORK_ERROR' | 'UNKNOWN_ERROR';
+type OutputCollectionErrorType = OutputCustomErrorType | 'SOME_FILES_HAS_ERRORS' | 'GROUP_ERROR' | 'TOO_MANY_FILES' | 'TOO_FEW_FILES';
 type OutputFileErrorPayload = {
     entry: OutputFileEntry;
 };
@@ -2332,6 +2529,9 @@ type OutputErrorTypePayload = {
     SOME_FILES_HAS_ERRORS: {
         [k: string]: never;
     };
+    GROUP_ERROR: {
+        error: Error;
+    };
     TOO_MANY_FILES: {
         min: number;
         max: number;
@@ -2345,6 +2545,9 @@ type OutputErrorTypePayload = {
     UPLOAD_ERROR: OutputFileErrorPayload & {
         error: UploadError;
     };
+    AUTH_TOKEN_ERROR: OutputFileErrorPayload & {
+        error: AuthTokenResolverError;
+    };
     NETWORK_ERROR: OutputFileErrorPayload & {
         error: NetworkError;
     };
@@ -2648,87 +2851,47 @@ type EventMap = {
     [T in keyof EventPayload]: CustomEvent<EventPayload[T]>;
 };
 
-interface UploadEntryData extends Record<string, unknown> {
-    file: File | null;
-    externalUrl: string | null;
-    fileName: string | null;
-    fileSize: number | null;
-    lastModified: number;
-    uploadProgress: number;
-    uuid: string | null;
-    isImage: boolean;
-    mimeType: string | null;
-    ctxName: string | null;
-    cdnUrl: string | null;
-    cdnUrlModifiers: string | null;
-    fileInfo: UploadcareFile | null;
-    isUploading: boolean;
-    abortController: AbortController | null;
-    thumbUrl: string | null;
-    silent: boolean;
-    source: string | null;
-    fullPath: string | null;
-    metadata: Metadata | null;
-    tags: Tags | null;
-    errors: OutputErrorFile[];
-    uploadError: Error | null;
-    isRemoved: boolean;
-    isQueuedForUploading: boolean;
-    isValidationPending: boolean;
-    isQueuedForValidation: boolean;
+/**
+ * Owns the one long-lived token cache for this uploader context.
+ *
+ * `authToken` may be a resolver, and `@uploadcare/upload-client` calls it
+ * before every authenticated request — so without a cache each upload, each
+ * readiness poll and each multipart start/complete would hit the app's token
+ * endpoint again. (Multipart chunks go to presigned storage URLs and carry no
+ * token, so they are not part of that count.)
+ */
+declare class AuthTokenManager extends SharedInstance {
+    private _cache;
+    /**
+     * One function, the same one for the life of this manager, that reads the
+     * configured resolver when it is called rather than capturing it.
+     *
+     * That stability is the point: whoever we hand this to can keep it, and it
+     * still follows later changes to `authToken`. Returning the cache's own
+     * `getToken` instead would mean re-reading it after every config change to
+     * stay current, which is a rule nothing enforces.
+     */
+    private readonly _resolveAuthToken;
+    /** The value to hand `@uploadcare/upload-client` as `authToken`. */
+    getAuthToken(): AuthToken | undefined;
+    /** Drop the cached token, e.g. once the signed-in user changes. */
+    invalidate(): void;
+    destroy(): void;
 }
-type UploadEntryTypedData = TypedData<UploadEntryData>;
-type UploadEntryKeys = keyof UploadEntryData;
 
-declare class PluginRegistry {
-    private _sources;
-    private _activities;
-    private _fileActions;
-    private _fileHooks;
-    private _icons;
-    private _l10n;
-    readonly config: CustomConfigRegistry;
-    /**
-     * Notify consumers (LocaleManager, SourceListController, …) that the registry
-     * changed so they re-apply the new state. Coalesces a synchronous burst of
-     * registrations — a plugin's setup() typically registers an icon, a source,
-     * several l10n maps, … in one tick — into a single, deferred notification.
-     * Registrations can also happen lazily, long after setup() ran (e.g. a locale's
-     * strings loaded when `localeName` changes), which is why this exists.
-     */
-    private readonly _scheduleNotify;
-    constructor(onChange?: () => void);
-    /** Drop any pending notification (call on teardown). */
+declare class A11y implements ISharedInstance {
+    private _destroyKeyUX;
+    private readonly _scopedWindow;
+    constructor();
+    registerBlock(scope: LitBlock): void;
     destroy(): void;
-    private _own;
-    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;
-    addL10n(pluginId: string, item: PluginL10nRegistration): void;
-    addConfig<T>(pluginId: string, definition: CustomConfigDefinition<T>): void;
-    purge(pluginId: string): void;
-    snapshot(): PluginRegistrySnapshot;
 }
 
-declare class PluginManager extends SharedInstance {
-    private _plugins;
-    private _subscribers;
-    private _pluginsUpdate;
-    private _lazyPluginLoader;
-    readonly registry: PluginRegistry;
-    get configRegistry(): CustomConfigRegistry;
+declare class LocaleManager extends SharedInstance {
+    private _localeName;
     constructor(sharedInstancesBag: SharedInstancesBag);
-    pluginsReady(): Promise<void>;
-    onPluginsChange(callback: Unsubscriber): Unsubscriber;
-    private _syncPlugins;
-    private _registerPlugin;
-    private _unregisterPlugin;
-    snapshot(): PluginRegistrySnapshot;
-    runOnAddHooks(entry: UploadEntryTypedData): Promise<void>;
-    destroy(): void;
-    private _notifySubscribers;
+    private _applyOverrides;
+    private _applyPluginLocales;
 }
 
 type CommonEventType = InternalEventKey | EventKey;
@@ -2795,6 +2958,7 @@ declare const instanceKeyMap: {
     eventEmitter: "*eventEmitter";
     uploadCollection: "*uploadCollection";
     secureUploadsManager: "*secureUploadsManager";
+    authTokenManager: "*authTokenManager";
     api: "*publicApi";
     validationManager: "*validationManager";
 };
@@ -2816,6 +2980,7 @@ declare const createSharedInstancesBag: (getCtx: () => PubSub<SharedState>) => {
     readonly eventEmitter: EventEmitter;
     readonly uploadCollection: TypedCollection<UploadEntryData>;
     readonly secureUploadsManager: SecureUploadsManager;
+    readonly authTokenManager: AuthTokenManager;
     readonly api: UploaderPublicApi;
     readonly validationManager: ValidationManager;
     when<TName extends InstanceName>(name: TName, callback: (instance: NonNullable<InstanceTypeMap[TName]>) => void): () => void;
@@ -2871,6 +3036,8 @@ type UploaderBlockCtxState = ActivityBlockCtxState & {
     '*collectionErrors': OutputErrorCollection[];
     '*collectionState': OutputCollectionState | null;
     '*groupInfo': UploadcareGroup | null;
+    /** The failure of the last group creation, if it failed. */
+    '*groupError': Error | null;
     '*uploadTrigger': Set<Uid>;
 };
 type SolutionBlockCtxState = UploaderBlockCtxState & {
@@ -2944,6 +3111,7 @@ type DynamicUploaderBlockState = {
     '*publicApi': UploaderPublicApi;
     '*validationManager': ValidationManager;
     '*secureUploadsManager': SecureUploadsManager;
+    '*authTokenManager': AuthTokenManager;
 };
 type LocaleState = {
     [K in keyof LocaleDefinition as `*l10n/${K}`]: string;
@@ -2977,9 +3145,10 @@ declare class LitBlock extends LitBlockBase {
         readonly eventEmitter: EventEmitter;
         readonly uploadCollection: TypedCollection<UploadEntryData>;
         readonly secureUploadsManager: SecureUploadsManager;
+        readonly authTokenManager: AuthTokenManager;
         readonly api: UploaderPublicApi;
         readonly validationManager: ValidationManager;
-        when<TName extends "modalManager" | "pluginManager" | "telemetryManager" | "localeManager" | "a11y" | "clipboard" | "routerLayer" | "blocksRegistry" | "eventEmitter" | "uploadCollection" | "secureUploadsManager" | "api" | "validationManager">(name: TName, callback: (instance: NonNullable<{
+        when<TName extends "modalManager" | "pluginManager" | "telemetryManager" | "localeManager" | "a11y" | "clipboard" | "routerLayer" | "blocksRegistry" | "eventEmitter" | "uploadCollection" | "secureUploadsManager" | "authTokenManager" | "api" | "validationManager">(name: TName, callback: (instance: NonNullable<{
             modalManager: ModalManager | null;
             pluginManager: PluginManager;
             telemetryManager: TelemetryManager;
@@ -2991,10 +3160,11 @@ declare class LitBlock extends LitBlockBase {
             eventEmitter: EventEmitter;
             uploadCollection: TypedCollection<UploadEntryData>;
             secureUploadsManager: SecureUploadsManager;
+            authTokenManager: AuthTokenManager;
             api: UploaderPublicApi;
             validationManager: ValidationManager;
         }[TName]>) => void): () => void;
-        wait<TName extends "modalManager" | "pluginManager" | "telemetryManager" | "localeManager" | "a11y" | "clipboard" | "routerLayer" | "blocksRegistry" | "eventEmitter" | "uploadCollection" | "secureUploadsManager" | "api" | "validationManager">(name: TName): Promise<NonNullable<{
+        wait<TName extends "modalManager" | "pluginManager" | "telemetryManager" | "localeManager" | "a11y" | "clipboard" | "routerLayer" | "blocksRegistry" | "eventEmitter" | "uploadCollection" | "secureUploadsManager" | "authTokenManager" | "api" | "validationManager">(name: TName): Promise<NonNullable<{
             modalManager: ModalManager | null;
             pluginManager: PluginManager;
             telemetryManager: TelemetryManager;
@@ -3006,6 +3176,7 @@ declare class LitBlock extends LitBlockBase {
             eventEmitter: EventEmitter;
             uploadCollection: TypedCollection<UploadEntryData>;
             secureUploadsManager: SecureUploadsManager;
+            authTokenManager: AuthTokenManager;
             api: UploaderPublicApi;
             validationManager: ValidationManager;
         }[TName]>>;
@@ -3137,6 +3308,7 @@ declare class LitSolutionBlock extends LitBlock {
         '*collectionErrors': OutputErrorCollection[];
         '*collectionState': OutputCollectionState | null;
         '*groupInfo': _uploadcare_upload_client.UploadcareGroup | null;
+        '*groupError': Error | null;
         '*uploadTrigger': Set<string>;
         '*currentActivity': null;
         '*currentActivityParams': {};
@@ -3465,4 +3637,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, type CustomLocaleDefinition, PubSub as Data, DropArea, DropDown, DynamicBtn, EditorAspectRatioButtonControl, EditorCropButtonControl, EditorFilterControl, EditorFreeformButtonControl, EditorImageCropper, EditorImageFader, EditorOperationControl, EditorScroller, EditorSlider, EditorToolbar, type EventMap, type EventPayload, EventType, ExternalSource, ExternalUploadSource, FileActionButton, 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, NoWrapModeDynamicBtn, 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 PluginIconRegistration, type PluginL10nRegistration, type PluginRegistryApi, type PluginRegistrySnapshot, type PluginRender, type PluginRenderDispose, type PluginSetupParams, type PluginSetupResult, type PluginSourceRegistration, type PluginUploaderApi, PresenceToggle, PrimaryAction, ProgressBar, ProgressBarCommon, type SecureDeliveryProxyUrlResolver, type SecureUploadsSignatureAndExpire, type SecureUploadsSignatureResolver, Select, SimpleBtn, SliderUi, LitSolutionBlock as SolutionBlock, SourceBtn, SourceList, type SourceTypes, Spinner, StartFrom, type TagsCallback, 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, type AttributeConfigType, 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, type CustomLocaleDefinition, PubSub as Data, DropArea, DropDown, DynamicBtn, EditorAspectRatioButtonControl, EditorCropButtonControl, EditorFilterControl, EditorFreeformButtonControl, EditorImageCropper, EditorImageFader, EditorOperationControl, EditorScroller, EditorSlider, EditorToolbar, type EventMap, type EventPayload, EventType, ExternalSource, ExternalUploadSource, FileActionButton, 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, NoWrapModeDynamicBtn, 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 PluginIconRegistration, type PluginL10nRegistration, type PluginRegistryApi, type PluginRegistrySnapshot, type PluginRender, type PluginRenderDispose, type PluginSetupParams, type PluginSetupResult, type PluginSourceRegistration, type PluginUploaderApi, PresenceToggle, PrimaryAction, ProgressBar, ProgressBarCommon, type PropertyOnlyConfigType, type SecureDeliveryProxyUrlResolver, type SecureUploadsSignatureAndExpire, type SecureUploadsSignatureResolver, Select, SimpleBtn, SliderUi, LitSolutionBlock as SolutionBlock, SourceBtn, SourceList, type SourceTypes, Spinner, StartFrom, type TagsCallback, Thumb, UID, UploadCtxProvider, UploadList, UploadSource, LitUploaderBlock as UploaderBlock, type UploaderPlugin, UploaderPublicApi, UrlSource, defineComponents, defineLocale, loadFileUploaderFrom, toKebabCase };