@flusys/nestjs-storage 5.1.1 → 5.1.2

package/cjs/dtos/file-manager.dto.js

@@ -26,6 +26,7 @@ _export(exports, {
     }
 });
 const _swagger = require("@nestjs/swagger");
+const _classtransformer = require("class-transformer");
 const _classvalidator = require("class-validator");
 const _enums = require("../enums");
 function _define_property(obj, key, value) {
@@ -164,44 +165,82 @@ let FileManagerResponseDto = class FileManagerResponseDto {
     }
 };
 _ts_decorate([
-    (0, _swagger.ApiProperty)(),
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)({
+        description: 'Unique identifier of the file',
+        example: 'f2e9c8d0-7a2a-11eb-9439-0242ac130002'
+    }),
     _ts_metadata("design:type", String)
 ], FileManagerResponseDto.prototype, "id", void 0);
 _ts_decorate([
-    (0, _swagger.ApiProperty)(),
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)({
+        description: 'Original filename as uploaded',
+        example: 'profile-photo.png'
+    }),
     _ts_metadata("design:type", String)
 ], FileManagerResponseDto.prototype, "name", void 0);
 _ts_decorate([
-    (0, _swagger.ApiProperty)(),
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)({
+        description: 'Storage key / path used to retrieve the file from the provider',
+        example: 'uploads/users/abc123/profile-photo.png'
+    }),
     _ts_metadata("design:type", String)
 ], FileManagerResponseDto.prototype, "key", void 0);
 _ts_decorate([
-    (0, _swagger.ApiProperty)(),
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)({
+        description: 'File size in bytes',
+        example: '204800'
+    }),
     _ts_metadata("design:type", String)
 ], FileManagerResponseDto.prototype, "size", void 0);
 _ts_decorate([
-    (0, _swagger.ApiProperty)(),
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)({
+        description: 'MIME type of the file',
+        example: 'image/png'
+    }),
     _ts_metadata("design:type", String)
 ], FileManagerResponseDto.prototype, "contentType", void 0);
 _ts_decorate([
-    (0, _swagger.ApiProperty)(),
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)({
+        description: 'Whether the file is private and requires signed URL access',
+        example: false
+    }),
     _ts_metadata("design:type", Boolean)
 ], FileManagerResponseDto.prototype, "isPrivate", void 0);
 _ts_decorate([
-    (0, _swagger.ApiPropertyOptional)(),
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiPropertyOptional)({
+        description: 'ID of the folder this file belongs to; absent if in root',
+        example: 'a1b2c3d4-0000-0000-0000-000000000001'
+    }),
     _ts_metadata("design:type", String)
 ], FileManagerResponseDto.prototype, "folderId", void 0);
 _ts_decorate([
-    (0, _swagger.ApiPropertyOptional)(),
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiPropertyOptional)({
+        description: 'ID of the storage configuration used to store this file',
+        example: 'a1b2c3d4-0000-0000-0000-000000000002'
+    }),
     _ts_metadata("design:type", String)
 ], FileManagerResponseDto.prototype, "storageConfigId", void 0);
 _ts_decorate([
-    (0, _swagger.ApiPropertyOptional)(),
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiPropertyOptional)({
+        description: 'Storage provider type (e.g. s3, gcs, local)',
+        example: 's3'
+    }),
     _ts_metadata("design:type", String)
 ], FileManagerResponseDto.prototype, "location", void 0);
 _ts_decorate([
+    (0, _classtransformer.Expose)(),
     (0, _swagger.ApiPropertyOptional)({
-        description: 'Name of the storage provider'
+        description: 'Human-readable name of the storage provider',
+        example: 'AWS S3 — Production Bucket'
     }),
     _ts_metadata("design:type", String)
 ], FileManagerResponseDto.prototype, "providerName", void 0);
@@ -212,6 +251,7 @@ let GetFilesRequestDto = class GetFilesRequestDto {
 };
 _ts_decorate([
     (0, _swagger.ApiProperty)({
+        description: 'Unique identifier of the file to retrieve',
         example: 'f2e9c8d0-7a2a-11eb-9439-0242ac130002'
     }),
     (0, _classvalidator.IsUUID)(),
@@ -230,36 +270,58 @@ let FilesResponseDto = class FilesResponseDto {
     }
 };
 _ts_decorate([
-    (0, _swagger.ApiProperty)(),
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)({
+        description: 'Unique identifier of the file',
+        example: 'f2e9c8d0-7a2a-11eb-9439-0242ac130002'
+    }),
     _ts_metadata("design:type", String)
 ], FilesResponseDto.prototype, "id", void 0);
 _ts_decorate([
-    (0, _swagger.ApiProperty)(),
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)({
+        description: 'Original filename as uploaded',
+        example: 'quarterly-report.pdf'
+    }),
     _ts_metadata("design:type", String)
 ], FilesResponseDto.prototype, "name", void 0);
 _ts_decorate([
-    (0, _swagger.ApiProperty)(),
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)({
+        description: 'MIME type of the file',
+        example: 'application/pdf'
+    }),
     _ts_metadata("design:type", String)
 ], FilesResponseDto.prototype, "contentType", void 0);
 _ts_decorate([
-    (0, _swagger.ApiProperty)(),
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)({
+        description: 'Publicly accessible or pre-signed URL to download the file',
+        example: 'https://cdn.example.com/uploads/quarterly-report.pdf'
+    }),
     _ts_metadata("design:type", String)
 ], FilesResponseDto.prototype, "url", void 0);
 _ts_decorate([
+    (0, _classtransformer.Expose)(),
     (0, _swagger.ApiPropertyOptional)({
-        description: 'Storage provider type'
+        description: 'Storage provider type (e.g. s3, gcs, local)',
+        example: 'gcs'
     }),
     _ts_metadata("design:type", String)
 ], FilesResponseDto.prototype, "location", void 0);
 _ts_decorate([
+    (0, _classtransformer.Expose)(),
     (0, _swagger.ApiPropertyOptional)({
-        description: 'Storage configuration ID'
+        description: 'ID of the storage configuration used to store this file',
+        example: 'a1b2c3d4-0000-0000-0000-000000000002'
     }),
     _ts_metadata("design:type", String)
 ], FilesResponseDto.prototype, "storageConfigId", void 0);
 _ts_decorate([
+    (0, _classtransformer.Expose)(),
     (0, _swagger.ApiPropertyOptional)({
-        description: 'Name of the storage provider'
+        description: 'Human-readable name of the storage provider',
+        example: 'Google Cloud Storage — EU'
     }),
     _ts_metadata("design:type", String)
 ], FilesResponseDto.prototype, "providerName", void 0);

package/cjs/dtos/folder.dto.js

@@ -20,6 +20,7 @@ _export(exports, {
     }
 });
 const _swagger = require("@nestjs/swagger");
+const _classtransformer = require("class-transformer");
 const _classvalidator = require("class-validator");
 function _define_property(obj, key, value) {
     if (key in obj) {
@@ -79,14 +80,26 @@ let FolderResponseDto = class FolderResponseDto {
     }
 };
 _ts_decorate([
-    (0, _swagger.ApiProperty)(),
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)({
+        description: 'Unique identifier of the folder',
+        example: 'f2e9c8d0-7a2a-11eb-9439-0242ac130002'
+    }),
     _ts_metadata("design:type", String)
 ], FolderResponseDto.prototype, "id", void 0);
 _ts_decorate([
-    (0, _swagger.ApiProperty)(),
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)({
+        description: 'Human-readable name of the folder',
+        example: 'Profile Photos'
+    }),
     _ts_metadata("design:type", String)
 ], FolderResponseDto.prototype, "name", void 0);
 _ts_decorate([
-    (0, _swagger.ApiProperty)(),
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)({
+        description: 'URL-friendly unique identifier derived from the folder name',
+        example: 'profile-photos'
+    }),
     _ts_metadata("design:type", String)
 ], FolderResponseDto.prototype, "slug", void 0);

package/cjs/dtos/storage-config.dto.js

@@ -20,9 +20,10 @@ _export(exports, {
     }
 });
 const _dtos = require("@flusys/nestjs-shared/dtos");
-const _enums = require("../enums");
 const _swagger = require("@nestjs/swagger");
+const _classtransformer = require("class-transformer");
 const _classvalidator = require("class-validator");
+const _enums = require("../enums");
 function _define_property(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
@@ -121,3 +122,49 @@ let StorageConfigResponseDto = class StorageConfigResponseDto extends _dtos.Iden
         super(...args), _define_property(this, "name", void 0), _define_property(this, "storage", void 0), _define_property(this, "config", void 0), _define_property(this, "isActive", void 0), _define_property(this, "isDefault", void 0);
     }
 };
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)({
+        description: 'Human-readable name for this storage configuration',
+        example: 'AWS S3 — Production Bucket'
+    }),
+    _ts_metadata("design:type", String)
+], StorageConfigResponseDto.prototype, "name", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)({
+        description: 'Storage provider type',
+        example: 's3'
+    }),
+    _ts_metadata("design:type", String)
+], StorageConfigResponseDto.prototype, "storage", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)({
+        description: 'Provider-specific configuration key-value pairs',
+        type: 'object',
+        additionalProperties: true,
+        example: {
+            bucket: 'my-production-bucket',
+            region: 'us-east-1',
+            endpoint: 'https://s3.amazonaws.com'
+        }
+    }),
+    _ts_metadata("design:type", typeof Record === "undefined" ? Object : Record)
+], StorageConfigResponseDto.prototype, "config", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)({
+        description: 'Whether this storage configuration is currently active',
+        example: true
+    }),
+    _ts_metadata("design:type", Boolean)
+], StorageConfigResponseDto.prototype, "isActive", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)({
+        description: 'Whether this is the default storage configuration',
+        example: false
+    }),
+    _ts_metadata("design:type", Boolean)
+], StorageConfigResponseDto.prototype, "isDefault", void 0);

package/cjs/dtos/upload.dto.js

@@ -26,8 +26,8 @@ _export(exports, {
     }
 });
 const _swagger = require("@nestjs/swagger");
-const _classvalidator = require("class-validator");
 const _classtransformer = require("class-transformer");
+const _classvalidator = require("class-validator");
 function _define_property(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
@@ -222,40 +222,51 @@ let FileUploadResponsePayloadDto = class FileUploadResponsePayloadDto {
     }
 };
 _ts_decorate([
+    (0, _classtransformer.Expose)(),
     (0, _swagger.ApiProperty)({
-        example: 'file123.jpg'
+        description: 'Original filename of the uploaded file',
+        example: 'profile-photo.jpg'
     }),
     _ts_metadata("design:type", String)
 ], FileUploadResponsePayloadDto.prototype, "name", void 0);
 _ts_decorate([
+    (0, _classtransformer.Expose)(),
     (0, _swagger.ApiProperty)({
+        description: 'MIME type of the uploaded file',
         example: 'image/jpeg'
     }),
     _ts_metadata("design:type", String)
 ], FileUploadResponsePayloadDto.prototype, "contentType", void 0);
 _ts_decorate([
+    (0, _classtransformer.Expose)(),
     (0, _swagger.ApiProperty)({
-        example: 2048
+        description: 'File size in bytes',
+        example: 204800,
+        minimum: 0
     }),
     _ts_metadata("design:type", Number)
 ], FileUploadResponsePayloadDto.prototype, "size", void 0);
 _ts_decorate([
+    (0, _classtransformer.Expose)(),
     (0, _swagger.ApiProperty)({
-        example: 'uploads/file123.jpg'
+        description: 'Storage key / path used to retrieve the file from the provider',
+        example: 'uploads/users/abc123/profile-photo.jpg'
     }),
     _ts_metadata("design:type", String)
 ], FileUploadResponsePayloadDto.prototype, "key", void 0);
 _ts_decorate([
+    (0, _classtransformer.Expose)(),
     (0, _swagger.ApiProperty)({
-        example: 'local',
-        description: 'Storage provider type'
+        description: 'Storage provider type (e.g. s3, gcs, local)',
+        example: 's3'
     }),
     _ts_metadata("design:type", String)
 ], FileUploadResponsePayloadDto.prototype, "location", void 0);
 _ts_decorate([
+    (0, _classtransformer.Expose)(),
     (0, _swagger.ApiProperty)({
-        example: '123e4567-e89b-12d3-a456-426614174000',
-        description: 'Storage configuration ID'
+        description: 'ID of the storage configuration used to store this file',
+        example: '123e4567-e89b-12d3-a456-426614174000'
     }),
     _ts_metadata("design:type", String)
 ], FileUploadResponsePayloadDto.prototype, "storageConfigId", void 0);

package/fesm/dtos/file-manager.dto.js

@@ -21,6 +21,7 @@ function _ts_metadata(k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 import { ApiProperty, ApiPropertyOptional, PartialType } from '@nestjs/swagger';
+import { Expose } from 'class-transformer';
 import { IsBoolean, IsEnum, IsNotEmpty, IsOptional, IsString, IsUUID } from 'class-validator';
 import { FileLocationEnum } from '../enums';
 export class CreateFileManagerDto {
@@ -137,44 +138,82 @@ export class FileManagerResponseDto {
     }
 }
 _ts_decorate([
-    ApiProperty(),
+    Expose(),
+    ApiProperty({
+        description: 'Unique identifier of the file',
+        example: 'f2e9c8d0-7a2a-11eb-9439-0242ac130002'
+    }),
     _ts_metadata("design:type", String)
 ], FileManagerResponseDto.prototype, "id", void 0);
 _ts_decorate([
-    ApiProperty(),
+    Expose(),
+    ApiProperty({
+        description: 'Original filename as uploaded',
+        example: 'profile-photo.png'
+    }),
     _ts_metadata("design:type", String)
 ], FileManagerResponseDto.prototype, "name", void 0);
 _ts_decorate([
-    ApiProperty(),
+    Expose(),
+    ApiProperty({
+        description: 'Storage key / path used to retrieve the file from the provider',
+        example: 'uploads/users/abc123/profile-photo.png'
+    }),
     _ts_metadata("design:type", String)
 ], FileManagerResponseDto.prototype, "key", void 0);
 _ts_decorate([
-    ApiProperty(),
+    Expose(),
+    ApiProperty({
+        description: 'File size in bytes',
+        example: '204800'
+    }),
     _ts_metadata("design:type", String)
 ], FileManagerResponseDto.prototype, "size", void 0);
 _ts_decorate([
-    ApiProperty(),
+    Expose(),
+    ApiProperty({
+        description: 'MIME type of the file',
+        example: 'image/png'
+    }),
     _ts_metadata("design:type", String)
 ], FileManagerResponseDto.prototype, "contentType", void 0);
 _ts_decorate([
-    ApiProperty(),
+    Expose(),
+    ApiProperty({
+        description: 'Whether the file is private and requires signed URL access',
+        example: false
+    }),
     _ts_metadata("design:type", Boolean)
 ], FileManagerResponseDto.prototype, "isPrivate", void 0);
 _ts_decorate([
-    ApiPropertyOptional(),
+    Expose(),
+    ApiPropertyOptional({
+        description: 'ID of the folder this file belongs to; absent if in root',
+        example: 'a1b2c3d4-0000-0000-0000-000000000001'
+    }),
     _ts_metadata("design:type", String)
 ], FileManagerResponseDto.prototype, "folderId", void 0);
 _ts_decorate([
-    ApiPropertyOptional(),
+    Expose(),
+    ApiPropertyOptional({
+        description: 'ID of the storage configuration used to store this file',
+        example: 'a1b2c3d4-0000-0000-0000-000000000002'
+    }),
     _ts_metadata("design:type", String)
 ], FileManagerResponseDto.prototype, "storageConfigId", void 0);
 _ts_decorate([
-    ApiPropertyOptional(),
+    Expose(),
+    ApiPropertyOptional({
+        description: 'Storage provider type (e.g. s3, gcs, local)',
+        example: 's3'
+    }),
     _ts_metadata("design:type", String)
 ], FileManagerResponseDto.prototype, "location", void 0);
 _ts_decorate([
+    Expose(),
     ApiPropertyOptional({
-        description: 'Name of the storage provider'
+        description: 'Human-readable name of the storage provider',
+        example: 'AWS S3 — Production Bucket'
     }),
     _ts_metadata("design:type", String)
 ], FileManagerResponseDto.prototype, "providerName", void 0);
@@ -185,6 +224,7 @@ export class GetFilesRequestDto {
 }
 _ts_decorate([
     ApiProperty({
+        description: 'Unique identifier of the file to retrieve',
         example: 'f2e9c8d0-7a2a-11eb-9439-0242ac130002'
     }),
     IsUUID(),
@@ -203,36 +243,58 @@ export class FilesResponseDto {
     }
 }
 _ts_decorate([
-    ApiProperty(),
+    Expose(),
+    ApiProperty({
+        description: 'Unique identifier of the file',
+        example: 'f2e9c8d0-7a2a-11eb-9439-0242ac130002'
+    }),
     _ts_metadata("design:type", String)
 ], FilesResponseDto.prototype, "id", void 0);
 _ts_decorate([
-    ApiProperty(),
+    Expose(),
+    ApiProperty({
+        description: 'Original filename as uploaded',
+        example: 'quarterly-report.pdf'
+    }),
     _ts_metadata("design:type", String)
 ], FilesResponseDto.prototype, "name", void 0);
 _ts_decorate([
-    ApiProperty(),
+    Expose(),
+    ApiProperty({
+        description: 'MIME type of the file',
+        example: 'application/pdf'
+    }),
     _ts_metadata("design:type", String)
 ], FilesResponseDto.prototype, "contentType", void 0);
 _ts_decorate([
-    ApiProperty(),
+    Expose(),
+    ApiProperty({
+        description: 'Publicly accessible or pre-signed URL to download the file',
+        example: 'https://cdn.example.com/uploads/quarterly-report.pdf'
+    }),
     _ts_metadata("design:type", String)
 ], FilesResponseDto.prototype, "url", void 0);
 _ts_decorate([
+    Expose(),
     ApiPropertyOptional({
-        description: 'Storage provider type'
+        description: 'Storage provider type (e.g. s3, gcs, local)',
+        example: 'gcs'
     }),
     _ts_metadata("design:type", String)
 ], FilesResponseDto.prototype, "location", void 0);
 _ts_decorate([
+    Expose(),
     ApiPropertyOptional({
-        description: 'Storage configuration ID'
+        description: 'ID of the storage configuration used to store this file',
+        example: 'a1b2c3d4-0000-0000-0000-000000000002'
     }),
     _ts_metadata("design:type", String)
 ], FilesResponseDto.prototype, "storageConfigId", void 0);
 _ts_decorate([
+    Expose(),
     ApiPropertyOptional({
-        description: 'Name of the storage provider'
+        description: 'Human-readable name of the storage provider',
+        example: 'Google Cloud Storage — EU'
     }),
     _ts_metadata("design:type", String)
 ], FilesResponseDto.prototype, "providerName", void 0);

package/fesm/dtos/folder.dto.js

@@ -21,6 +21,7 @@ function _ts_metadata(k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 import { ApiProperty, PartialType } from '@nestjs/swagger';
+import { Expose } from 'class-transformer';
 import { IsNotEmpty, IsString, IsUUID } from 'class-validator';
 export class CreateFolderDto {
     constructor(){
@@ -58,14 +59,26 @@ export class FolderResponseDto {
     }
 }
 _ts_decorate([
-    ApiProperty(),
+    Expose(),
+    ApiProperty({
+        description: 'Unique identifier of the folder',
+        example: 'f2e9c8d0-7a2a-11eb-9439-0242ac130002'
+    }),
     _ts_metadata("design:type", String)
 ], FolderResponseDto.prototype, "id", void 0);
 _ts_decorate([
-    ApiProperty(),
+    Expose(),
+    ApiProperty({
+        description: 'Human-readable name of the folder',
+        example: 'Profile Photos'
+    }),
     _ts_metadata("design:type", String)
 ], FolderResponseDto.prototype, "name", void 0);
 _ts_decorate([
-    ApiProperty(),
+    Expose(),
+    ApiProperty({
+        description: 'URL-friendly unique identifier derived from the folder name',
+        example: 'profile-photos'
+    }),
     _ts_metadata("design:type", String)
 ], FolderResponseDto.prototype, "slug", void 0);

package/fesm/dtos/storage-config.dto.js

@@ -21,9 +21,10 @@ function _ts_metadata(k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 import { IdentityResponseDto } from '@flusys/nestjs-shared/dtos';
-import { FileLocationEnum } from '../enums';
 import { ApiProperty, ApiPropertyOptional, OmitType, PartialType } from '@nestjs/swagger';
+import { Expose } from 'class-transformer';
 import { IsBoolean, IsEnum, IsNotEmpty, IsObject, IsOptional, IsString, IsUUID, MaxLength } from 'class-validator';
+import { FileLocationEnum } from '../enums';
 export class CreateStorageConfigDto {
     constructor(){
         _define_property(this, "name", void 0);
@@ -100,3 +101,49 @@ export class StorageConfigResponseDto extends IdentityResponseDto {
         super(...args), _define_property(this, "name", void 0), _define_property(this, "storage", void 0), _define_property(this, "config", void 0), _define_property(this, "isActive", void 0), _define_property(this, "isDefault", void 0);
     }
 }
+_ts_decorate([
+    Expose(),
+    ApiProperty({
+        description: 'Human-readable name for this storage configuration',
+        example: 'AWS S3 — Production Bucket'
+    }),
+    _ts_metadata("design:type", String)
+], StorageConfigResponseDto.prototype, "name", void 0);
+_ts_decorate([
+    Expose(),
+    ApiProperty({
+        description: 'Storage provider type',
+        example: 's3'
+    }),
+    _ts_metadata("design:type", String)
+], StorageConfigResponseDto.prototype, "storage", void 0);
+_ts_decorate([
+    Expose(),
+    ApiProperty({
+        description: 'Provider-specific configuration key-value pairs',
+        type: 'object',
+        additionalProperties: true,
+        example: {
+            bucket: 'my-production-bucket',
+            region: 'us-east-1',
+            endpoint: 'https://s3.amazonaws.com'
+        }
+    }),
+    _ts_metadata("design:type", typeof Record === "undefined" ? Object : Record)
+], StorageConfigResponseDto.prototype, "config", void 0);
+_ts_decorate([
+    Expose(),
+    ApiProperty({
+        description: 'Whether this storage configuration is currently active',
+        example: true
+    }),
+    _ts_metadata("design:type", Boolean)
+], StorageConfigResponseDto.prototype, "isActive", void 0);
+_ts_decorate([
+    Expose(),
+    ApiProperty({
+        description: 'Whether this is the default storage configuration',
+        example: false
+    }),
+    _ts_metadata("design:type", Boolean)
+], StorageConfigResponseDto.prototype, "isDefault", void 0);

package/fesm/dtos/upload.dto.js

@@ -21,8 +21,8 @@ function _ts_metadata(k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { Expose, Type } from 'class-transformer';
 import { IsArray, IsBoolean, IsEnum, IsInt, IsNotEmpty, IsOptional, IsString, IsUUID, Matches, Max, Min } from 'class-validator';
-import { Type } from 'class-transformer';
 export var ImageFormat = /*#__PURE__*/ function(ImageFormat) {
     ImageFormat["ORIGINAL"] = "original";
     ImageFormat["JPEG"] = "jpeg";
@@ -195,40 +195,51 @@ export class FileUploadResponsePayloadDto {
     }
 }
 _ts_decorate([
+    Expose(),
     ApiProperty({
-        example: 'file123.jpg'
+        description: 'Original filename of the uploaded file',
+        example: 'profile-photo.jpg'
     }),
     _ts_metadata("design:type", String)
 ], FileUploadResponsePayloadDto.prototype, "name", void 0);
 _ts_decorate([
+    Expose(),
     ApiProperty({
+        description: 'MIME type of the uploaded file',
         example: 'image/jpeg'
     }),
     _ts_metadata("design:type", String)
 ], FileUploadResponsePayloadDto.prototype, "contentType", void 0);
 _ts_decorate([
+    Expose(),
     ApiProperty({
-        example: 2048
+        description: 'File size in bytes',
+        example: 204800,
+        minimum: 0
     }),
     _ts_metadata("design:type", Number)
 ], FileUploadResponsePayloadDto.prototype, "size", void 0);
 _ts_decorate([
+    Expose(),
     ApiProperty({
-        example: 'uploads/file123.jpg'
+        description: 'Storage key / path used to retrieve the file from the provider',
+        example: 'uploads/users/abc123/profile-photo.jpg'
     }),
     _ts_metadata("design:type", String)
 ], FileUploadResponsePayloadDto.prototype, "key", void 0);
 _ts_decorate([
+    Expose(),
     ApiProperty({
-        example: 'local',
-        description: 'Storage provider type'
+        description: 'Storage provider type (e.g. s3, gcs, local)',
+        example: 's3'
     }),
     _ts_metadata("design:type", String)
 ], FileUploadResponsePayloadDto.prototype, "location", void 0);
 _ts_decorate([
+    Expose(),
     ApiProperty({
-        example: '123e4567-e89b-12d3-a456-426614174000',
-        description: 'Storage configuration ID'
+        description: 'ID of the storage configuration used to store this file',
+        example: '123e4567-e89b-12d3-a456-426614174000'
     }),
     _ts_metadata("design:type", String)
 ], FileUploadResponsePayloadDto.prototype, "storageConfigId", void 0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flusys/nestjs-storage",
-  "version": "5.1.1",
+  "version": "5.1.2",
   "description": "Modular storage package with optional AWS S3, Azure Blob, and SFTP providers",
   "main": "cjs/index.js",
   "module": "fesm/index.js",
@@ -129,7 +129,7 @@
     }
   },
   "dependencies": {
-    "@flusys/nestjs-core": "5.1.1",
-    "@flusys/nestjs-shared": "5.1.1"
+    "@flusys/nestjs-core": "5.1.2",
+    "@flusys/nestjs-shared": "5.1.2"
   }
 }