@flusys/nestjs-storage 9.1.2 → 9.2.0

package/README.md

@@ -159,6 +159,19 @@ TypeOrmModule.forRoot({
 });
 ```
 
+## 3. Caching
+
+| What | Cached | Invalidated by |
+| ---- | ------ | -------------- |
+| File `get-all` / `get/:id` | Yes, keyed on the `file_manager` **and** `folder` stamps (reads join the folder name) | Any file or folder write; `get-files` URL refreshes bump the file stamp after saving |
+| Folder `get-all` / `get/:id` | Yes, `folder` stamp | Any folder write |
+| Storage config `get-all` / `get/:id` | **No** - rows carry provider credentials | - |
+| Active local storage roots (public file route) | Yes, `storageConfig` stamp | Any storage-config write, so an edited or deactivated local config stops being served on every instance |
+| Provider clients (`StorageFactoryService`) | Process-local, per provider + config hash | Config content change (new key), 30 min idle, LRU above 50 clients; dropped clients are closed |
+
+Cached file reads keep the `url` column as stored; it may be a presigned URL. Use `get-files` to get a URL that is valid now.
+
+Files served by `GET storage/upload/file/*` are sent with `Cache-Control: private, max-age=3600` - the route is unauthenticated and cannot tell private files apart, so no shared proxy or CDN may keep a copy. The route serves from the roots of **all** active local configs of the tenant, not only the first one. A storage config with `isActive: false` takes no new uploads but still serves, signs and deletes its existing files.
 
 ## License
 

package/controllers/file-manager.controller.d.ts

@@ -7,6 +7,7 @@ declare const FileManagerController_base: abstract new (service: FileManagerServ
     readonly enabledEndpoints: import("@flusys/nestjs-shared").ApiEndpoint[] | "all";
     service: FileManagerService;
     isEnabled(endpoint: import("@flusys/nestjs-shared").ApiEndpoint): boolean;
+    assertEnabled(endpoint: import("@flusys/nestjs-shared").ApiEndpoint): void;
     insert(addDto: CreateFileManagerDto, user: ILoggedUserInfo | null): Promise<SingleResponseDto<FileManagerResponseDto>>;
     insertMany(addDto: CreateFileManagerDto[], user: ILoggedUserInfo | null): Promise<import("@flusys/nestjs-shared").BulkResponseDto<FileManagerResponseDto>>;
     getById(id: string, body: import("@flusys/nestjs-shared").GetByIdBodyDto, user: ILoggedUserInfo | null): Promise<SingleResponseDto<FileManagerResponseDto>>;

package/controllers/folder.controller.d.ts

@@ -4,6 +4,7 @@ declare const FolderController_base: abstract new (service: FolderService) => {
     readonly enabledEndpoints: import("@flusys/nestjs-shared").ApiEndpoint[] | "all";
     service: FolderService;
     isEnabled(endpoint: import("@flusys/nestjs-shared").ApiEndpoint): boolean;
+    assertEnabled(endpoint: import("@flusys/nestjs-shared").ApiEndpoint): void;
     insert(addDto: CreateFolderDto, user: import("@flusys/nestjs-shared").ILoggedUserInfo | null): Promise<import("@flusys/nestjs-shared").SingleResponseDto<FolderResponseDto>>;
     insertMany(addDto: CreateFolderDto[], user: import("@flusys/nestjs-shared").ILoggedUserInfo | null): Promise<import("@flusys/nestjs-shared").BulkResponseDto<FolderResponseDto>>;
     getById(id: string, body: import("@flusys/nestjs-shared").GetByIdBodyDto, user: import("@flusys/nestjs-shared").ILoggedUserInfo | null): Promise<import("@flusys/nestjs-shared").SingleResponseDto<FolderResponseDto>>;

package/controllers/storage-config.controller.d.ts

@@ -4,6 +4,7 @@ declare const StorageConfigController_base: abstract new (service: StorageProvid
     readonly enabledEndpoints: import("@flusys/nestjs-shared").ApiEndpoint[] | "all";
     service: StorageProviderConfigService;
     isEnabled(endpoint: import("@flusys/nestjs-shared").ApiEndpoint): boolean;
+    assertEnabled(endpoint: import("@flusys/nestjs-shared").ApiEndpoint): void;
     insert(addDto: CreateStorageConfigDto, user: import("@flusys/nestjs-shared").ILoggedUserInfo | null): Promise<import("@flusys/nestjs-shared").SingleResponseDto<StorageConfigResponseDto>>;
     insertMany(addDto: CreateStorageConfigDto[], user: import("@flusys/nestjs-shared").ILoggedUserInfo | null): Promise<import("@flusys/nestjs-shared").BulkResponseDto<StorageConfigResponseDto>>;
     getById(id: string, body: import("@flusys/nestjs-shared").GetByIdBodyDto, user: import("@flusys/nestjs-shared").ILoggedUserInfo | null): Promise<import("@flusys/nestjs-shared").SingleResponseDto<StorageConfigResponseDto>>;