@memberjunction/ng-file-storage

Angular components for managing file storage in MemberJunction applications, providing a complete file management system with category trees, file grids, upload with overwrite protection, and integration with MemberJunction's pluggable storage providers.

Overview

The @memberjunction/ng-file-storage package provides three core components that together form a file management interface: a hierarchical category tree for organizing files, a Kendo Grid for browsing and managing files within categories, and an upload component with provider integration and overwrite protection. All file operations flow through MemberJunction's entity system and storage provider abstraction, supporting Azure Blob Storage, AWS S3, and other backends.

flowchart TD
    subgraph UI["File Management UI"]
        CT[CategoryTreeComponent] --> FG[FilesGridComponent]
        FG --> FU[FileUploadComponent]
    end

    subgraph Operations["File Operations"]
        FU --> UPLOAD[Upload to Provider]
        FG --> DOWNLOAD[Download via Signed URL]
        FG --> DELETE[Delete with Confirmation]
        FG --> EDIT[Edit Metadata]
        CT --> CREATE[Create Category]
        CT --> DND[Drag & Drop Reorganize]
    end

    subgraph Backend["MJ Integration"]
        ENTITY[Entity Framework] --> GQL[GraphQL API]
        GQL --> PROVIDER[Storage Provider]
        PROVIDER --> AZURE[Azure Blob]
        PROVIDER --> S3[AWS S3]
    end

    Operations --> Backend

    style UI fill:#2d6a9f,stroke:#1a4971,color:#fff
    style Operations fill:#7c5295,stroke:#563a6b,color:#fff
    style Backend fill:#2d8659,stroke:#1a5c3a,color:#fff

Installation

npm install @memberjunction/ng-file-storage

Prerequisites

Before using this package, ensure your MemberJunction database has:

• File Storage Providers configured and active
• File Categories entity permissions for users
• Files entity permissions for users
• GraphQL endpoints configured

Usage

Import the Module

import { FileStorageModule } from '@memberjunction/ng-file-storage';

@NgModule({
  imports: [FileStorageModule]
})
export class YourModule { }

File Browser Layout

<div style="display: flex; height: 600px;">
  <div style="width: 300px; border-right: 1px solid #ccc;">
    <mj-files-category-tree
      (categorySelected)="selectedCategoryId = $event">
    </mj-files-category-tree>
  </div>
  <div style="flex: 1;">
    <mj-files-grid
      [CategoryID]="selectedCategoryId">
    </mj-files-grid>
  </div>
</div>

File Upload

<mj-files-file-upload
  [CategoryID]="selectedCategoryId"
  (uploadStarted)="onUploadStarted()"
  (fileUpload)="onFileUploaded($event)">
</mj-files-file-upload>

Complete Example

import { Component, ViewChild } from '@angular/core';
import { FilesGridComponent, FileUploadEvent } from '@memberjunction/ng-file-storage';

@Component({
  selector: 'app-document-manager',
  template: `
    <div class="file-manager">
      <div class="categories">
        <mj-files-category-tree
          (categorySelected)="onCategorySelected($event)">
        </mj-files-category-tree>
      </div>
      <div class="files">
        <mj-files-file-upload
          [CategoryID]="selectedCategoryId"
          (fileUpload)="onFileUploaded($event)">
        </mj-files-file-upload>
        <mj-files-grid #filesGrid
          [CategoryID]="selectedCategoryId">
        </mj-files-grid>
      </div>
    </div>
  `
})
export class DocumentManagerComponent {
  @ViewChild('filesGrid') filesGrid!: FilesGridComponent;
  selectedCategoryId: string | undefined;

  onCategorySelected(categoryId: string | undefined) {
    this.selectedCategoryId = categoryId;
  }

  onFileUploaded(event: FileUploadEvent) {
    if (event.success) {
      console.log('Uploaded:', event.file.Name);
    }
  }

  refreshFiles() {
    this.filesGrid.Refresh();
  }
}

API Reference

CategoryTreeComponent (mj-files-category-tree)

Hierarchical tree view for managing file categories with drag-and-drop reorganization.

Outputs

| Output | Type | Description | |--------|------|-------------| | categorySelected | EventEmitter<string \| undefined> | Emitted when a category is selected |

Public Methods

| Method | Description | |--------|-------------| | createNewCategory() | Opens dialog to create a category | | deleteCategory(category) | Deletes a category with error handling | | handleDrop(e) | Handles drag-and-drop to move categories | | Refresh() | Refreshes the category tree | | clearSelection() | Clears the current selection |

FilesGridComponent (mj-files-grid)

Kendo Grid for displaying and managing files with inline editing.

Inputs

| Input | Type | Default | Description | |-------|------|---------|-------------| | CategoryID | string \| undefined | undefined | Category ID to filter files by |

Public Methods

| Method | Description | |--------|-------------| | downloadFile(file) | Downloads file via provider's signed URL | | deleteFile(file) | Deletes file with confirmation | | saveEditFile() | Saves changes to file metadata | | resetEditFile() | Cancels metadata editing | | canBeDeleted(file) | Checks if file can be deleted | | Refresh() | Refreshes the files grid |

FileUploadComponent (mj-files-file-upload)

File upload component with storage provider integration and overwrite protection.

Inputs

| Input | Type | Default | Description | |-------|------|---------|-------------| | disabled | boolean | false | Disable the upload component | | CategoryID | string \| undefined | undefined | Category ID for uploaded files |

Outputs

| Output | Type | Description | |--------|------|-------------| | uploadStarted | EventEmitter<void> | Emitted when upload begins | | fileUpload | EventEmitter<FileUploadEvent> | Emitted on upload completion |

Properties

| Property | Type | Description | |----------|------|-------------| | IsUploading | boolean | Whether files are currently uploading |

Types

FileUploadEvent

type FileUploadEvent =
  | { success: true; file: FileEntity }
  | { success: false; file: FileInfo };

Upload Flow

1. User selects a file through the upload component
2. A preliminary file record is created in the MemberJunction system
3. If a file with the same name exists, a confirmation dialog appears
4. On confirmation, the file uploads to the active storage provider
5. The file record status updates to "Uploaded"
6. The fileUpload event emits with success status and file details

Key Behaviors

• File deletion is restricted based on upload status and age (10 minutes for pending files)
• Overwrite protection prompts users before replacing existing files
• Download uses provider-specific signed URLs for security
• Category drag-and-drop supports reorganizing the hierarchy
• All operations include loading state indicators

Dependencies

Runtime Dependencies

| Package | Description | |---------|-------------| | @memberjunction/core | Core metadata and entity access | | @memberjunction/core-entities | File-related entity types | | @memberjunction/global | Global utilities | | @memberjunction/graphql-dataprovider | GraphQL data operations | | @memberjunction/ng-container-directives | Container directives | | @memberjunction/ng-shared | Shared Angular services | | @memberjunction/ng-shared-generic | Shared generic components | | @progress/kendo-angular-grid | Data grid | | @progress/kendo-angular-treeview | Category tree | | @progress/kendo-angular-upload | File upload | | @progress/kendo-angular-dialog | Confirmation dialogs | | @progress/kendo-angular-buttons | Button components | | @progress/kendo-angular-dropdowns | Dropdown components | | @progress/kendo-angular-indicators | Loading indicators | | @progress/kendo-angular-menu | Context menu |

Peer Dependencies

• @angular/common ^21.x
• @angular/core ^21.x
• @angular/forms ^21.x
• @angular/router ^21.x

Build

cd packages/Angular/Generic/file-storage
npm run build

License

ISC