@acorex/cdk 21.0.2-next.4 → 21.0.2-next.41

package/types/acorex-cdk-uploader.d.ts

@@ -1,47 +1,44 @@
 import * as _angular_core from '@angular/core';
 import { OnInit, OnDestroy, TemplateRef } from '@angular/core';
 import { AXEvent } from '@acorex/cdk/common';
+import { AXValidationRuleResult } from '@acorex/core/validation';
 import * as rxjs from 'rxjs';
 import { Subject, BehaviorSubject } from 'rxjs';
 
 /**
- * A directive that provides browse functionality for file uploads.
- * When applied to an element, clicking it will trigger the file browser dialog.
+ * Triggers the nearest {@link AXUploaderZoneDirective} file dialog on click.
+ * Resolves the zone via DI when possible, otherwise walks the DOM (supports content projection).
  * @category Directives
  */
 declare class AXUploaderBrowseDirective implements OnInit, OnDestroy {
-    /**
-     * The uploader zone directive instance.
-     * @ignore
-     */
-    private uploaderZone;
-    /**
-     * The element reference for the directive host.
-     * @ignore
-     */
-    private elementRef;
-    /**
-     * Platform ID for browser detection.
-     * @ignore
-     */
-    private platformID;
-    /**
-     * Initializes the directive by adding click event listener and data attribute.
-     */
+    private readonly elementRef;
+    private readonly platformID;
+    /** When browse + zone share the same host element. */
+    private readonly zoneFromInjector;
+    private readonly onClick;
     ngOnInit(): void;
-    /**
-     * Cleans up the directive by removing event listeners.
-     */
     ngOnDestroy(): void;
-    /**
-     * Handles the click event to trigger file browser.
-     * @private
-     */
+    private resolveZone;
     private handleClick;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXUploaderBrowseDirective, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AXUploaderBrowseDirective, "[axUploaderBrowseHandle]", never, {}, {}, never, never, true, never>;
 }
 
+interface AXUploaderChooseFilesResult {
+    accepted: File[];
+    rejected: {
+        file: File;
+        errors: AXValidationRuleResult[];
+    }[];
+}
+interface AXUploaderFileChangeEvent {
+    event: Event;
+    files: File[];
+    rejected?: {
+        file: File;
+        errors: AXValidationRuleResult[];
+    }[];
+}
 type AXUploadStatus = 'new' | 'inprogress' | 'completed' | 'failed' | 'canceled';
 interface AXUploaderChangedEvent extends AXEvent {
     requests: AXUploadRequest[];
@@ -119,6 +116,11 @@ declare class AXUploaderZoneDirective implements OnDestroy {
      * @defaultValue null
      */
     accept: _angular_core.InputSignal<string>;
+    /**
+     * Logical file type name from {@link AXFileService} (e.g. `conversation-image`).
+     * Required for browse handles and validated selection.
+     */
+    fileType: _angular_core.InputSignal<string>;
     /**
      * Custom template for the drag overlay. If provided, this will be used instead of the default overlay.
      */
@@ -177,10 +179,7 @@ declare class AXUploaderZoneDirective implements OnDestroy {
      * Emitted when files are selected or dropped (like HTML file input).
      * Emits an event with files property containing the selected files.
      */
-    fileChange: _angular_core.OutputEmitterRef<{
-        event: Event;
-        files: File[];
-    }>;
+    fileChange: _angular_core.OutputEmitterRef<AXUploaderFileChangeEvent>;
     /**
      * Emitted when files are changed (added, removed, etc.).
      * @deprecated Use fileChange instead for simpler file input-like behavior
@@ -276,103 +275,114 @@ declare class AXUploaderZoneDirective implements OnDestroy {
      */
     browser(): Promise<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXUploaderZoneDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AXUploaderZoneDirective, "[axUploaderZone]", never, { "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "overlayTemplate": { "alias": "overlayTemplate"; "required": false; "isSignal": true; }; "disableBrowse": { "alias": "disableBrowse"; "required": false; "isSignal": true; }; "disableDragDrop": { "alias": "disableDragDrop"; "required": false; "isSignal": true; }; }, { "fileChange": "fileChange"; "onChanged": "onChanged"; "dragEnter": "dragEnter"; "dragLeave": "dragLeave"; "dragOver": "dragOver"; "onFileUploadComplete": "onFileUploadComplete"; "onFilesUploadComplete": "onFilesUploadComplete"; }, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AXUploaderZoneDirective, "[axUploaderZone]", never, { "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "fileType": { "alias": "fileType"; "required": false; "isSignal": true; }; "overlayTemplate": { "alias": "overlayTemplate"; "required": false; "isSignal": true; }; "disableBrowse": { "alias": "disableBrowse"; "required": false; "isSignal": true; }; "disableDragDrop": { "alias": "disableDragDrop"; "required": false; "isSignal": true; }; }, { "fileChange": "fileChange"; "onChanged": "onChanged"; "dragEnter": "dragEnter"; "dragLeave": "dragLeave"; "dragOver": "dragOver"; "onFileUploadComplete": "onFileUploadComplete"; "onFilesUploadComplete": "onFilesUploadComplete"; }, never, never, true, never>;
 }
 
+/** Reference to stored file/media (url and/or mediaId). */
+interface AXUploadReference {
+    url?: string;
+    mediaId?: string;
+    mimeType?: string;
+    size?: number;
+    expiresAt?: number;
+    metadata?: Record<string, unknown>;
+}
+interface AXFileUploadOptions {
+    source: File | Blob;
+    fileName?: string;
+    mimeType?: string;
+    metadata?: Record<string, unknown>;
+    onProgress?: (percent: number) => void;
+    signal?: AbortSignal;
+}
+interface AXUploadResult {
+    url: string;
+    thumbnailUrl?: string;
+    mediaId?: string;
+    size: number;
+    mimeType: string;
+    metadata?: Record<string, unknown>;
+}
+/** Emitted when {@link AXUploaderService.upload} is called. */
+interface AXUploaderUploadEvent extends AXEvent {
+    options: AXFileUploadOptions;
+    resolve: (result: AXUploadResult) => void;
+    reject: (reason: unknown) => void;
+}
+/** Emitted when {@link AXUploaderService.resolveUrl} is called. */
+interface AXUploaderResolveUrlEvent extends AXEvent {
+    reference: AXUploadReference;
+    signal?: AbortSignal;
+    resolve: (url: string) => void;
+    reject: (reason: unknown) => void;
+}
+/** Emitted when {@link AXUploaderService.deleteMedia} is called. */
+interface AXUploaderDeleteMediaEvent extends AXEvent {
+    reference: AXUploadReference;
+    resolve: () => void;
+    reject: (reason: unknown) => void;
+}
+interface AXUploaderBrowseOptions {
+    multiple?: boolean;
+    accept?: string;
+    /** Logical file type name(s) registered in {@link AXFileService}. */
+    fileType?: string | string[];
+}
+interface AXUploaderAddOptions {
+    fileType?: string | string[];
+}
 /**
- * Service for managing file uploads with drag-and-drop support, progress tracking, and dialog management.
+ * File upload queue and validation via {@link AXFileService}.
+ * Storage is implemented by subscribing to upload/resolve/delete events.
  * @category Services
  */
 declare class AXUploaderService {
-    /**
-     * Translation service for localized text.
-     * @ignore
-     */
-    private translateService;
-    /**
-     * File service for file operations.
-     * @ignore
-     */
-    private fileService;
-    /**
-     * Behavior subject for managing upload requests.
-     * @ignore
-     */
+    private readonly fileService;
     private readonly _files$;
-    /**
-     * Gets the files behavior subject for observing upload requests.
-     */
     readonly files: rxjs.Observable<AXUploadRequest[]>;
-    /**
-     * Subject for file upload start events.
-     */
     readonly onFileUploadStart: Subject<AXUploaderFileStartEvent>;
-    /**
-     * Subject for file upload complete events.
-     */
     readonly onFileUploadComplete: Subject<AXUploaderFileCompleteEvent>;
-    /**
-     * Subject for all files upload complete events.
-     */
     readonly onFilesUploadComplete: Subject<AXUploaderFilesCompleteEvent>;
-    /**
-     * Subject for file upload canceled events.
-     */
     readonly onFileUploadCanceled: Subject<AXUploaderFileCancelEvent>;
-    /**
-     * Signal indicating if any upload has determined progress.
-     */
-    readonly isAnyDetermined: _angular_core.Signal<boolean>;
-    /**
-     * Observable for total estimated upload time.
-     */
+    /** Subscribe to perform uploads (e.g. HTTP, IndexedDB). */
+    readonly onUpload: Subject<AXUploaderUploadEvent>;
+    /** Subscribe to resolve a stored reference to a playback URL. */
+    readonly onResolveUrl: Subject<AXUploaderResolveUrlEvent>;
+    /** Subscribe to delete stored media. */
+    readonly onDeleteMedia: Subject<AXUploaderDeleteMediaEvent>;
     readonly totalEstimateTime: rxjs.Observable<number>;
-    /**
-     * Converts a File object to an AXUploadRequest.
-     * @private
-     */
-    private convertFileToRequest;
-    /**
-     * Starts uploading files that are in 'new' status.
-     * @private
-     */
-    private startUpload;
-    /**
-     * Binds event handlers to an upload request.
-     * @private
-     */
-    private bindEvents;
-    /**
-     * Opens the file browser dialog and returns selected files as upload requests.
-     * @param options - Configuration options for file selection
-     * @returns Promise that resolves to an array of upload requests
-     */
-    browse(options?: {
-        multiple?: boolean;
-        accept?: string;
-    }): Promise<AXUploadRequest[]>;
-    /**
-     * Adds files to the upload queue and starts the upload process.
-     * @param files - Files to add to the upload queue
-     * @returns Promise that resolves to an array of upload requests
-     */
-    add(files: FileList | File[]): Promise<AXUploadRequest[]>;
-    /**
-     * Cancels all pending and in-progress uploads.
-     */
+    isAnyDetermined(): boolean;
+    validateFiles(files: File[], fileType: string): Promise<{
+        accepted: File[];
+        rejected: {
+            file: File;
+            errors: AXValidationRuleResult[];
+        }[];
+    }>;
+    getAcceptAttribute(fileType: string | string[]): Promise<string>;
+    upload(options: AXFileUploadOptions): Promise<AXUploadResult>;
+    resolveUrl(reference: AXUploadReference, signal?: AbortSignal): Promise<string>;
+    resolvePlaybackUrl(reference: AXUploadReference, signal?: AbortSignal): Promise<string>;
+    deleteMedia(reference: AXUploadReference): Promise<void>;
+    private hasUploadHandler;
+    private hasResolveUrlHandler;
+    private hasDeleteMediaHandler;
+    add(files: FileList | File[], options?: AXUploaderAddOptions): Promise<AXUploadRequest[]>;
+    /**
+     * Opens the file dialog and returns selected files without enqueueing uploads.
+     * With `fileType`, applies catalog validation; otherwise uses legacy accept-only selection.
+     */
+    chooseFiles(options?: AXUploaderBrowseOptions): Promise<AXUploaderChooseFilesResult>;
+    browse(options?: AXUploaderBrowseOptions): Promise<AXUploadRequest[]>;
     cancelAll(): Promise<void>;
-    /**
-     * Clears all completed uploads from the queue.
-     */
     clearAll(): void;
-    /**
-     * Removes a specific upload request from the queue.
-     * @param item - The upload request to remove
-     */
     remove(item: AXUploadRequest): void;
+    private startUpload;
+    private bindEvents;
+    private applyFileTypeValidation;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXUploaderService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXUploaderService>;
 }
 
 export { AXUploadRequest, AXUploaderBrowseDirective, AXUploaderService, AXUploaderZoneDirective };
-export type { AXUploadStatus, AXUploaderChangedEvent, AXUploaderFileCancelEvent, AXUploaderFileCompleteEvent, AXUploaderFileStartEvent, AXUploaderFilesCompleteEvent };
+export type { AXFileUploadOptions, AXUploadReference, AXUploadResult, AXUploadStatus, AXUploaderAddOptions, AXUploaderBrowseOptions, AXUploaderChangedEvent, AXUploaderChooseFilesResult, AXUploaderDeleteMediaEvent, AXUploaderFileCancelEvent, AXUploaderFileChangeEvent, AXUploaderFileCompleteEvent, AXUploaderFileStartEvent, AXUploaderFilesCompleteEvent, AXUploaderResolveUrlEvent, AXUploaderUploadEvent };