@flusys/ng-storage 1.1.1-beta → 1.2.0-rc.1

package/types/flusys-ng-storage.d.ts

@@ -1,9 +1,14 @@
-import { IBaseEntity, IProfileUploadProvider, IProfileUploadOptions, ISingleResponse, IProfileUploadResult, ApiResourceService, IListResponse } from '@flusys/ng-shared';
-import { Observable } from 'rxjs';
+import { IBaseEntity, TranslateService, IFileProvider, IFileSelectFilter, IListResponse, IFileBasicInfo, IFileUploadOptions, ISingleResponse, IUploadedFile, ISelectFilter, IFolderBasicInfo, IStorageConfigBasicInfo, ApiResourceService, IBulkResponse, RouterTabItem } from '@flusys/ng-shared';
 import * as i0 from '@angular/core';
-import { Provider } from '@angular/core';
+import { DestroyRef, Provider } from '@angular/core';
+import * as _flusys_ng_layout from '@flusys/ng-layout';
+import * as _flusys_ng_core from '@flusys/ng-core';
 import { BaseApiService } from '@flusys/ng-core';
-import { Routes } from '@angular/router';
+import { Router, Routes } from '@angular/router';
+import { MessageService, ConfirmationService } from '@flusys/ng-ui';
+import { Observable } from 'rxjs';
+
+declare const STORAGE_MESSAGES: Record<string, string>;
 
 /**
  * File Location Enum
@@ -29,10 +34,7 @@ declare enum ImageFormat {
 /**
  * File Manager Interface (matches backend IFileManager)
  */
-interface IFileManager {
-    id: string;
-    createdAt: Date;
-    updatedAt: Date;
+interface IFileManager extends IBaseEntity {
     name: string;
     contentType: string;
     size: string;
@@ -41,7 +43,6 @@ interface IFileManager {
     location: FileLocationEnum;
     storageConfigId: string | null;
     providerName?: string;
-    expiresAt: Date | null;
     isPrivate: boolean;
     companyId?: string;
     folderId?: string | null;
@@ -82,71 +83,41 @@ interface IFilesResponseDto {
     name: string;
     contentType: string;
     url: string;
+    location?: string;
+    storageConfigId?: string;
+    providerName?: string;
 }
 
-/**
- * Folder Interface
- * Matches backend IFolder and FolderResponseDto
- */
 interface IFolder extends IBaseEntity {
     name: string;
     slug: string;
     companyId?: string | null;
 }
-/**
- * Create Folder DTO
- * POST /storage/folder/insert
- */
 interface ICreateFolderDto {
     name: string;
 }
-/**
- * Update Folder DTO
- * POST /storage/folder/update
- */
-interface IUpdateFolderDto {
+interface IUpdateFolderDto extends Partial<ICreateFolderDto> {
     id: string;
-    name?: string;
 }
 
-/**
- * Storage Config Interface
- * Matches backend IStorageConfig and StorageConfigResponseDto
- */
 interface IStorageConfig extends IBaseEntity {
     name: string;
     storage: FileLocationEnum;
-    config: Record<string, any>;
+    config: Record<string, unknown>;
     isActive: boolean;
     isDefault: boolean;
     companyId?: string | null;
 }
-/**
- * Create Storage Config DTO
- * POST /storage/storage-config/insert
- */
 interface ICreateStorageConfigDto {
     name: string;
     storage: FileLocationEnum;
-    config: Record<string, any>;
+    config: Record<string, unknown>;
     isActive?: boolean;
     isDefault?: boolean;
 }
-/**
- * Update Storage Config DTO
- * POST /storage/storage-config/update
- */
-interface IUpdateStorageConfigDto {
+interface IUpdateStorageConfigDto extends Partial<ICreateStorageConfigDto> {
     id: string;
-    name?: string;
-    storage?: FileLocationEnum;
-    config?: Record<string, any>;
-    isActive?: boolean;
-    isDefault?: boolean;
 }
-/**
- * AWS S3 Configuration
- */
 interface IAwsS3Config {
     region: string;
     bucket: string;
@@ -154,17 +125,11 @@ interface IAwsS3Config {
     secretAccessKey: string;
     endpoint?: string;
 }
-/**
- * Azure Blob Storage Configuration
- */
 interface IAzureBlobConfig {
     accountName: string;
     accountKey: string;
     containerName: string;
 }
-/**
- * SFTP Configuration
- */
 interface ISftpConfig {
     host: string;
     port: number;
@@ -173,9 +138,6 @@ interface ISftpConfig {
     privateKey?: string;
     basePath: string;
 }
-/**
- * Local Storage Configuration
- */
 interface ILocalStorageConfig {
     basePath: string;
 }
@@ -200,29 +162,141 @@ interface IUploadedFileInfo {
     key: string;
     size: number;
     contentType: string;
+    location?: string;
+    storageConfigId?: string;
 }
 
 /**
- * Profile Upload Provider Adapter
- *
- * Implements IProfileUploadProvider interface for ng-auth profile page.
- * Uses UploadService.uploadAndRegister() to upload files and register in file manager.
- *
- * @example
- * // In app.config.ts
- * providers: [
- *   ...provideStorageProviders(),
- * ]
+ * Provider label translation keys
  */
-declare class ProfileUploadProviderAdapter implements IProfileUploadProvider {
+declare const PROVIDER_LABEL_KEYS: Record<FileLocationEnum, string>;
+/**
+ * Get provider label translation key
+ */
+declare function getProviderLabelKey(storage: FileLocationEnum | string): string;
+/**
+ * Get provider icon class
+ */
+declare function getProviderIcon(storage: FileLocationEnum | string): string;
+/**
+ * Get provider severity for f-tag
+ */
+declare function getProviderSeverity(storage: FileLocationEnum | string): 'success' | 'info' | 'warn' | 'danger' | 'secondary' | 'contrast';
+/**
+ * Get file icon based on content type
+ */
+declare function getFileIcon(contentType: string): string;
+/** File size unit keys for translation */
+declare const FILE_SIZE_UNIT_KEYS: readonly ["storage.size.bytes", "shared.size.kb", "shared.size.mb", "storage.size.gb"];
+/**
+ * Format file size from bytes to human readable format
+ * Returns an object with value and unitKey for translation
+ */
+declare function formatFileSizeWithKey(bytes: number): {
+    value: string;
+    unitKey: string;
+};
+/**
+ * Format file size from bytes to human readable string
+ * @deprecated Use formatFileSizeWithKey for localization support
+ */
+declare function formatFileSize(bytes: number): string;
+/**
+ * Storage provider options for dropdown selects
+ * Labels are translation keys - components should translate them
+ */
+declare const STORAGE_PROVIDER_OPTIONS: readonly [{
+    readonly labelKey: "storage.aws.title";
+    readonly value: FileLocationEnum.AWS;
+}, {
+    readonly labelKey: "storage.azure.title";
+    readonly value: FileLocationEnum.AZURE;
+}, {
+    readonly labelKey: "storage.sftp.title";
+    readonly value: FileLocationEnum.SFTP;
+}, {
+    readonly labelKey: "storage.local.title";
+    readonly value: FileLocationEnum.LOCAL;
+}];
+type StorageProviderOption = (typeof STORAGE_PROVIDER_OPTIONS)[number];
+
+declare abstract class BaseStoragePage {
+    protected readonly router: Router;
+    protected readonly messageService: MessageService;
+    protected readonly appConfig: _flusys_ng_core.IAppConfig;
+    protected readonly companyContext: _flusys_ng_layout.ILayoutAuthState;
+    protected readonly translateAdapter: TranslateService;
+    readonly isLoading: i0.WritableSignal<boolean>;
+    readonly showCompanyInfo: i0.Signal<boolean>;
+    readonly currentCompanyName: i0.Signal<string>;
+    protected showSuccess(detail: string, summaryKey?: string): void;
+    protected showError(detail: string, summaryKey?: string): void;
+    protected navigateTo(path: string[]): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BaseStoragePage, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<BaseStoragePage, never, never, {}, {}, never, never, true, never>;
+}
+declare abstract class BaseStorageListPage<T> {
+    protected readonly router: Router;
+    protected readonly messageService: MessageService;
+    protected readonly appConfig: _flusys_ng_core.IAppConfig;
+    protected readonly confirmationService: ConfirmationService;
+    protected readonly destroyRef: DestroyRef;
+    protected readonly translateAdapter: TranslateService;
+    protected readonly companyContext: _flusys_ng_layout.ILayoutAuthState;
+    readonly items: i0.WritableSignal<T[]>;
+    readonly isLoading: i0.WritableSignal<boolean>;
+    readonly total: i0.WritableSignal<number>;
+    readonly pageSize: i0.WritableSignal<number>;
+    readonly first: i0.WritableSignal<number>;
+    readonly currentPage: i0.Signal<number>;
+    readonly showCompanyInfo: i0.Signal<boolean>;
+    readonly totalRecords: i0.WritableSignal<number>;
+    readonly currentCompanyName: i0.Signal<string>;
+    abstract loadData(): Promise<void>;
+    abstract getResourceRoute(): string;
+    getDeleteConfirmMessage(item: T): string;
+    onCreate(): void;
+    onEdit(id: string): void;
+    onPageChange(event: {
+        first?: number | null;
+        rows?: number | null;
+    }): void;
+    protected getPaginationParams(): {
+        currentPage: number;
+        pageSize: number;
+    };
+    protected showSuccess(detail: string, summary?: string): void;
+    protected showError(detail: string, summary?: string): void;
+    protected showInfo(detail: string, summary?: string): void;
+    protected showWarn(detail: string, summary?: string): void;
+    onDelete(item: T, idGetter: (item: T) => string, deleteApiCall: (id: string) => Observable<unknown> | Promise<unknown>, options?: {
+        header?: string;
+    }): void;
+    onDeleteAsync(item: T, idGetter: (item: T) => string, deleteApiCall: (id: string) => Promise<unknown>, options?: {
+        header?: string;
+    }): Promise<void>;
+    protected navigateTo(path: string[]): void;
+    protected t(key: string, variables?: Record<string, string | number>): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BaseStorageListPage<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<BaseStorageListPage<any>, never, never, {}, {}, never, never, true, never>;
+}
+
+declare class FileProviderAdapter implements IFileProvider {
+    private readonly fileManagerApi;
     private readonly uploadService;
-    /**
-     * Upload profile picture and register in file manager
-     * Returns file manager ID (UUID) for storing in user.profilePictureId
-     */
-    uploadProfilePicture(file: File, options?: IProfileUploadOptions): Observable<ISingleResponse<IProfileUploadResult>>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ProfileUploadProviderAdapter, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<ProfileUploadProviderAdapter>;
+    private readonly folderApi;
+    private readonly storageConfigApi;
+    loadFiles(filter: IFileSelectFilter): Observable<IListResponse<IFileBasicInfo>>;
+    uploadFile(file: File, options?: IFileUploadOptions): Observable<ISingleResponse<IUploadedFile>>;
+    uploadMultipleFiles(files: File[], options?: IFileUploadOptions): Observable<ISingleResponse<IUploadedFile[]>>;
+    getFileUrls(fileIds: string[]): Observable<ISingleResponse<IFileBasicInfo[]>>;
+    loadFolders(filter: ISelectFilter): Observable<IListResponse<IFolderBasicInfo>>;
+    loadStorageConfigs(filter: ISelectFilter): Observable<IListResponse<IStorageConfigBasicInfo>>;
+    private buildFileFilter;
+    private mapToFileBasicInfo;
+    private mapToUploadedFile;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FileProviderAdapter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<FileProviderAdapter>;
 }
 
 /**
@@ -243,38 +317,11 @@ declare class ProfileUploadProviderAdapter implements IProfileUploadProvider {
  */
 declare function provideStorageProviders(): Provider[];
 
-/**
- * File Manager API Service
- * Handles file metadata CRUD operations
- * Endpoint: POST /storage/file-manager/*
- *
- * Note: Company feature enabled - all queries automatically scoped to user's company
- */
 declare class FileManagerApiService extends ApiResourceService<IUpdateFileManagerDto, IFileManager> {
     constructor();
-    /**
-     * Get multiple files with valid URLs
-     * POST /storage/file-manager/get-files
-     * Regenerates presigned URLs if expired
-     */
     getFiles(fileIds: string[]): Observable<ISingleResponse<IFilesResponseDto[]>>;
-    /**
-     * Get files by folder
-     * POST /storage/file-manager/get-all
-     * Filtered by folder ID and company (if enabled)
-     */
-    getFilesByFolder(folderId: number | null, page?: number, limit?: number): Observable<IListResponse<IFileManager>>;
-    /**
-     * Get private files (requires permission)
-     * POST /storage/file-manager/get-all
-     * Filtered by isPrivate and user permission 'storage.file.viewPrivate'
-     */
-    getPrivateFiles(page?: number, limit?: number): Observable<IListResponse<IFileManager>>;
-    /**
-     * Create new file manager record
-     * POST /storage/file-manager/insert
-     */
-    create(dto: ICreateFileManagerDto): Observable<ISingleResponse<IFileManager>>;
+    createFile(dto: ICreateFileManagerDto): Observable<ISingleResponse<IFileManager>>;
+    createFiles(dtos: ICreateFileManagerDto[]): Observable<IBulkResponse<IFileManager>>;
     static ɵfac: i0.ɵɵFactoryDeclaration<FileManagerApiService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<FileManagerApiService>;
 }
@@ -286,7 +333,7 @@ declare class FileManagerApiService extends ApiResourceService<IUpdateFileManage
  *
  * Note: Company feature enabled - all queries automatically scoped to user's company
  */
-declare class FolderApiService extends ApiResourceService<IUpdateFolderDto, IFolder> {
+declare class FolderApiService extends ApiResourceService<ICreateFolderDto | IUpdateFolderDto, IFolder> {
     constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<FolderApiService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<FolderApiService>;
@@ -299,119 +346,73 @@ declare class FolderApiService extends ApiResourceService<IUpdateFolderDto, IFol
  *
  * Note: Company feature enabled - all queries automatically scoped to user's company
  */
-declare class StorageConfigApiService extends ApiResourceService<IUpdateStorageConfigDto, IStorageConfig> {
+declare class StorageConfigApiService extends ApiResourceService<ICreateStorageConfigDto | IUpdateStorageConfigDto, IStorageConfig> {
     constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<StorageConfigApiService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<StorageConfigApiService>;
 }
 
 /**
- * Upload Service
- * Handles file upload/delete operations
+ * Upload Service - File upload/delete operations
  * Endpoint: POST /storage/upload/*
- *
- * Features:
- * - Company-scoped uploads (if company feature enabled)
- * - Image compression
- * - Multiple storage providers
- * - File validation (size, type)
- * - Default storage config from environment (services.storage.defaultStorageConfigId)
  */
 declare class UploadService extends BaseApiService {
     private readonly fileManagerApi;
     constructor();
-    /**
-     * Get default storage config ID from app config
-     * Used when no storageConfigId is provided in upload options
-     */
+    /** Get default storage config ID from app config */
     getDefaultConfigId(): string | undefined;
-    /**
-     * Upload single file
-     * POST /storage/upload/single-file?storageConfigId=x&folderPath=y
-     *
-     * @param file - File to upload
-     * @param options - Upload options (storage config, compression, etc.)
-     */
+    /** Upload single file - POST /storage/upload/single-file */
     uploadSingleFile(file: File, options?: IUploadOptionsDto): Observable<ISingleResponse<IUploadedFileInfo>>;
-    /**
-     * Upload multiple files (max 50)
-     * POST /storage/upload/multiple-file?storageConfigId=x&folderPath=y
-     *
-     * @param files - Array of files to upload
-     * @param options - Upload options
-     */
+    /** Upload multiple files (max 50) - POST /storage/upload/multiple-file */
     uploadMultipleFiles(files: File[], options?: IUploadOptionsDto): Observable<ISingleResponse<IUploadedFileInfo[]>>;
-    /**
-     * Build query string from upload options
-     * Uses default storageConfigId from app config if not provided in options
-     */
-    private buildQueryParams;
-    /**
-     * Delete single file
-     * POST /storage/upload/delete-single-file
-     *
-     * @param key - File key/path to delete
-     * @param storageConfigId - Optional storage config ID (uses default from config if not provided)
-     */
+    /** Delete single file - POST /storage/upload/delete-single-file */
     deleteSingleFile(key: string, storageConfigId?: string): Observable<ISingleResponse<void>>;
-    /**
-     * Delete multiple files
-     * POST /storage/upload/delete-multiple-file
-     *
-     * @param keys - Array of file keys/paths to delete
-     * @param storageConfigId - Optional storage config ID (uses default from config if not provided)
-     */
+    /** Delete multiple files - POST /storage/upload/delete-multiple-file */
     deleteMultipleFiles(keys: string[], storageConfigId?: string): Observable<ISingleResponse<void>>;
-    /**
-     * Get file download URL
-     * GET /storage/upload/file/:filePath
-     *
-     * @param key - File key/path
-     * @returns URL for direct file access
-     */
+    /** Get file download URL - GET /storage/upload/file/:filePath */
     getFileUrl(key: string): string;
-    /**
-     * Upload file and register in file manager
-     * Returns file manager ID (UUID) for storing in references like profilePictureId
-     *
-     * @param file - File to upload
-     * @param options - Upload options (storage config, compression, etc.)
-     * @returns Observable with file manager record (id is the UUID to store)
-     */
+    /** Upload file and register in file manager - returns file manager ID (UUID) */
     uploadAndRegister(file: File, options?: IUploadOptionsDto & {
         isPrivate?: boolean;
         folderId?: string;
     }): Observable<ISingleResponse<IFileManager>>;
+    /** Upload multiple files and register in file manager - batch upload (2 API calls total) */
+    uploadAndRegisterMultiple(files: File[], options?: IUploadOptionsDto & {
+        isPrivate?: boolean;
+        folderId?: string;
+    }): Observable<ISingleResponse<IFileManager[]>>;
+    private resolveConfigId;
+    private toCreateFileDto;
+    private buildUploadUrl;
+    private buildQueryParams;
+    private buildDeleteBody;
     static ɵfac: i0.ɵɵFactoryDeclaration<UploadService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<UploadService>;
 }
 
 /**
  * Storage Module Routes
- * All storage management routes: configs, files, folders
- *
- * All routes are protected by permission guards to prevent direct URL access.
+ * All routes protected by permission guards
  */
 declare const STORAGE_ROUTES: Routes;
 
-interface ITab {
-    id: string;
-    label: string;
-    icon: string;
-    route: string;
-}
 /**
  * Storage Container Component
  *
  * Main container for Storage module with tab navigation
  * Routes: Files | Folders | Configurations
+ * Tabs are filtered based on user permissions
  */
 declare class StorageContainerComponent {
-    /** All available tabs */
-    readonly tabs: ITab[];
+    private readonly permissionValidator;
+    private readonly translateService;
+    /** All available tabs with required permissions */
+    private readonly allTabs;
+    /** Visible tabs based on user permissions */
+    readonly visibleTabs: i0.Signal<RouterTabItem[]>;
     static ɵfac: i0.ɵɵFactoryDeclaration<StorageContainerComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<StorageContainerComponent, "lib-storage-container", never, {}, {}, never, never, true, never>;
 }
 
-export { FileLocationEnum, FileManagerApiService, FolderApiService, ImageFormat, ProfileUploadProviderAdapter, STORAGE_ROUTES, StorageConfigApiService, StorageContainerComponent, UploadService, provideStorageProviders };
-export type { IAwsS3Config, IAzureBlobConfig, ICreateFileManagerDto, ICreateFolderDto, ICreateStorageConfigDto, IFileManager, IFilesResponseDto, IFolder, IGetFilesRequestDto, ILocalStorageConfig, ISftpConfig, IStorageConfig, IUpdateFileManagerDto, IUpdateFolderDto, IUpdateStorageConfigDto, IUploadOptionsDto, IUploadedFileInfo };
+export { BaseStorageListPage, BaseStoragePage, FILE_SIZE_UNIT_KEYS, FileLocationEnum, FileManagerApiService, FileProviderAdapter, FolderApiService, ImageFormat, PROVIDER_LABEL_KEYS, STORAGE_MESSAGES, STORAGE_PROVIDER_OPTIONS, STORAGE_ROUTES, StorageConfigApiService, StorageContainerComponent, UploadService, formatFileSize, formatFileSizeWithKey, getFileIcon, getProviderIcon, getProviderLabelKey, getProviderSeverity, provideStorageProviders };
+export type { IAwsS3Config, IAzureBlobConfig, ICreateFileManagerDto, ICreateFolderDto, ICreateStorageConfigDto, IFileManager, IFilesResponseDto, IFolder, IGetFilesRequestDto, ILocalStorageConfig, ISftpConfig, IStorageConfig, IUpdateFileManagerDto, IUpdateFolderDto, IUpdateStorageConfigDto, IUploadOptionsDto, IUploadedFileInfo, StorageProviderOption };