nestjs-r2-storage 1.0.0

package/README.md

@@ -0,0 +1,286 @@
+# nestjs-r2-storage
+
+Production-ready NestJS module for Cloudflare R2 object storage management.
+
+## Features
+
+- **Signed Upload URLs** - Generate presigned URLs for direct file uploads
+- **Signed Download URLs** - Generate presigned URLs for secure file downloads
+- **File Deletion** - Delete files from R2 storage
+- **Nested Field Support** - Handle paths like `shop.logo`, `profile.avatar`
+- **Array Field Support** - Handle paths like `products[].image`, `gallery[].photo`
+- **Storage Usage Tracking** - Track storage used, increased, and decreased
+- **Full CRUD Lifecycle** - Create, Update, Delete file operations
+
+## Installation
+
+```bash
+npm install nestjs-r2-storage
+```
+
+## Quick Start
+
+### 1. Configure the Module
+
+```typescript
+// app.module.ts
+import { Module } from '@nestjs/common';
+import { R2StorageModule } from 'nestjs-r2-storage';
+
+@Module({
+  imports: [
+    R2StorageModule.forRoot({
+      endpoint: process.env.R2_ENDPOINT,
+      accessKeyId: process.env.R2_ACCESS_KEY,
+      secretAccessKey: process.env.R2_SECRET_KEY,
+      bucketName: process.env.R2_BUCKET,
+      region: 'auto',
+      publicUrlBase: `https://${process.env.R2_ACCOUNT_ID}.r2.cloudflarestorage.com/${process.env.R2_BUCKET}`,
+      signedUrlExpiry: 3600,
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+### 2. Use in Your Service
+
+```typescript
+import { Injectable } from '@nestjs/common';
+import { PhotoManagerService, PhotoField, CloudflareService } from 'nestjs-r2-storage';
+
+@Injectable()
+export class ProductService {
+  constructor(
+    private readonly photoManager: PhotoManagerService,
+    private readonly cloudflare: CloudflareService,
+  ) {}
+
+  async createProduct(payload: any) {
+    const photoFields: PhotoField[] = [
+      { field: 'image', urlField: 'image_url', sizeField: 'image_size' },
+      { field: 'gallery[].photo', urlField: 'photo_url', sizeField: 'photo_size' },
+    ];
+
+    const result = await this.photoManager.createObjectWithPhotos(payload, photoFields);
+    
+    // Return upload URLs to client for direct upload
+    return {
+      product: result.updatedPayload,
+      uploadUrls: result.uploadUrls,
+      totalStorageUsed: result.totalStorageUsed,
+    };
+  }
+
+  async getProduct(id: string) {
+    const product = await this.findProduct(id);
+    
+    const photoFields: PhotoField[] = [
+      { field: 'image', urlField: 'image_url' },
+      { field: 'gallery[].photo', urlField: 'photo_url' },
+    ];
+
+    return this.photoManager.appendPhotoUrls(product, photoFields);
+  }
+
+  async updateProduct(id: string, payload: any) {
+    const existing = await this.findProduct(id);
+    
+    const photoFields: PhotoField[] = [
+      { field: 'image', urlField: 'image_url', sizeField: 'image_size' },
+    ];
+
+    const result = await this.photoManager.updateObjectWithPhotos(payload, existing, photoFields);
+    
+    return {
+      product: result.updatedPayload,
+      uploadUrls: result.uploadUrls,
+      storageIncrease: result.storageIncrease,
+      storageDecrease: result.storageDecrease,
+    };
+  }
+
+  async deleteProduct(id: string) {
+    const product = await this.findProduct(id);
+    
+    const photoFields: PhotoField[] = [
+      { field: 'image', urlField: 'image_url' },
+    ];
+
+    await this.photoManager.deletePhotosFromObject(product, photoFields);
+    await this.removeProduct(id);
+  }
+}
+```
+
+## API Reference
+
+### CloudflareService
+
+Direct R2 operations.
+
+```typescript
+// Generate upload URL
+const uploadUrl = await cloudflare.getUploadUrl('avatar.png', 1024000);
+
+// Generate download URL
+const downloadUrl = await cloudflare.getDownloadUrl('uploads/avatar_123.png');
+
+// Delete file
+await cloudflare.deleteFile('uploads/avatar.png');
+
+// Check if file exists
+const exists = await cloudflare.fileExists('uploads/avatar.png');
+```
+
+### PhotoManagerService
+
+High-level photo management.
+
+#### appendPhotoUrls()
+
+Adds signed URLs to response objects.
+
+```typescript
+const photoFields: PhotoField[] = [
+  { field: 'avatar', urlField: 'avatar_url' },
+  { field: 'shop.logo', urlField: 'logo_url' },
+  { field: 'products[].image', urlField: 'image_url' },
+  { field: 'gallery[].photo', urlField: 'photo_url' },
+];
+
+const result = await photoManager.appendPhotoUrls(product, photoFields);
+```
+
+Input:
+```json
+{
+  "name": "Laptop",
+  "image": "laptop.png",
+  "gallery": [
+    { "photo": "photo1.jpg" },
+    { "photo": "photo2.jpg" }
+  ]
+}
+```
+
+Output:
+```json
+{
+  "name": "Laptop",
+  "image": "laptop.png",
+  "image_url": "https://signed-url...",
+  "gallery": [
+    { "photo": "photo1.jpg", "photo_url": "https://signed-url..." },
+    { "photo": "photo2.jpg", "photo_url": "https://signed-url..." }
+  ]
+}
+```
+
+#### createObjectWithPhotos()
+
+Creates object with photo upload URLs.
+
+```typescript
+const payload = {
+  name: "Laptop",
+  image: "laptop.png",
+  image_size: 42000,
+  gallery: [
+    { photo: "photo1.jpg", photo_size: 10000 },
+    { photo: "photo2.jpg", photo_size: 15000 }
+  ]
+};
+
+const photoFields: PhotoField[] = [
+  { field: 'image', sizeField: 'image_size' },
+  { field: 'gallery[].photo', sizeField: 'gallery[].photo_size' },
+];
+
+const result = await photoManager.createObjectWithPhotos(payload, photoFields);
+
+// result = {
+//   updatedPayload: { ...with generated file keys... },
+//   uploadUrls: [{ field, fileKey, uploadUrl, publicUrl }],
+//   totalStorageUsed: 67000
+// }
+```
+
+#### updateObjectWithPhotos()
+
+Updates object with new photos, deletes old files.
+
+```typescript
+const result = await photoManager.updateObjectWithPhotos(
+  newPayload,
+  existingObject,
+  photoFields,
+);
+
+// result = {
+//   updatedPayload: { ... },
+//   uploadUrls: [{ field, fileKey, uploadUrl, publicUrl }],
+//   storageIncrease: 1000,
+//   storageDecrease: 500,
+//   deletedFiles: ['old-file.png']
+// }
+```
+
+#### deletePhotosFromObject()
+
+Deletes all photos from object.
+
+```typescript
+const result = await photoManager.deletePhotosFromObject(product, photoFields);
+
+// result = {
+//   deletedFiles: ['file1.png', 'file2.jpg'],
+//   totalStorageFreed: 25000
+// }
+```
+
+## Field Path Syntax
+
+### Simple Nested Fields
+
+```
+shop.logo
+profile.avatar
+products[].image
+```
+
+### Array Fields
+
+```
+gallery[].photo        -> gallery[0].photo, gallery[1].photo, ...
+products[].images[]    -> products[0].images[0], products[0].images[1], ...
+```
+
+## Configuration Options
+
+| Option | Type | Required | Description |
+|--------|------|----------|-------------|
+| `endpoint` | string | Yes | R2 endpoint URL |
+| `accessKeyId` | string | Yes | R2 access key ID |
+| `secretAccessKey` | string | Yes | R2 secret access key |
+| `bucketName` | string | Yes | R2 bucket name |
+| `region` | string | No | AWS region (default: 'auto') |
+| `publicUrlBase` | string | No | Base URL for public access |
+| `signedUrlExpiry` | number | No | Signed URL expiry in seconds (default: 3600) |
+
+## Async Configuration
+
+```typescript
+R2StorageModule.forRootAsync({
+  useFactory: () => ({
+    endpoint: process.env.R2_ENDPOINT,
+    accessKeyId: process.env.R2_ACCESS_KEY,
+    secretAccessKey: process.env.R2_SECRET_KEY,
+    bucketName: process.env.R2_BUCKET,
+  }),
+})
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { StorageOptions, FileFieldConfig, PhotoFieldConfig, StorageModuleOptions, } from './r2-storage/interfaces/storage-options.interface';
+export { CloudflareService, UploadUrlResult, DownloadUrlResult, FileInfo, } from './r2-storage/cloudflare.service';
+export { PhotoManagerService, PhotoField, PhotoUploadRequest, PhotoUploadResponse, CreatePhotosResult, UpdatePhotosResult, DeletePhotosResult, AppendUrlsOptions, } from './r2-storage/photo-manager.service';
+export { R2StorageModule, } from './r2-storage/r2-storage.module';
+export { PhotoFields, UploadUrls, StorageInfo, } from './r2-storage/decorators/photo-fields.decorator';
+export { parseFieldPath, getNestedValue, setNestedValue, collectNestedValues, isArrayPath, getArrayBasePath, getArrayElementPath, getAllArrayItemPaths, ParsedPath, PathSegment, } from './r2-storage/utils/nested-value.util';

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAllArrayItemPaths = exports.getArrayElementPath = exports.getArrayBasePath = exports.isArrayPath = exports.collectNestedValues = exports.setNestedValue = exports.getNestedValue = exports.parseFieldPath = exports.StorageInfo = exports.UploadUrls = exports.PhotoFields = exports.R2StorageModule = exports.PhotoManagerService = exports.CloudflareService = void 0;
+var cloudflare_service_1 = require("./r2-storage/cloudflare.service");
+Object.defineProperty(exports, "CloudflareService", { enumerable: true, get: function () { return cloudflare_service_1.CloudflareService; } });
+var photo_manager_service_1 = require("./r2-storage/photo-manager.service");
+Object.defineProperty(exports, "PhotoManagerService", { enumerable: true, get: function () { return photo_manager_service_1.PhotoManagerService; } });
+var r2_storage_module_1 = require("./r2-storage/r2-storage.module");
+Object.defineProperty(exports, "R2StorageModule", { enumerable: true, get: function () { return r2_storage_module_1.R2StorageModule; } });
+var photo_fields_decorator_1 = require("./r2-storage/decorators/photo-fields.decorator");
+Object.defineProperty(exports, "PhotoFields", { enumerable: true, get: function () { return photo_fields_decorator_1.PhotoFields; } });
+Object.defineProperty(exports, "UploadUrls", { enumerable: true, get: function () { return photo_fields_decorator_1.UploadUrls; } });
+Object.defineProperty(exports, "StorageInfo", { enumerable: true, get: function () { return photo_fields_decorator_1.StorageInfo; } });
+var nested_value_util_1 = require("./r2-storage/utils/nested-value.util");
+Object.defineProperty(exports, "parseFieldPath", { enumerable: true, get: function () { return nested_value_util_1.parseFieldPath; } });
+Object.defineProperty(exports, "getNestedValue", { enumerable: true, get: function () { return nested_value_util_1.getNestedValue; } });
+Object.defineProperty(exports, "setNestedValue", { enumerable: true, get: function () { return nested_value_util_1.setNestedValue; } });
+Object.defineProperty(exports, "collectNestedValues", { enumerable: true, get: function () { return nested_value_util_1.collectNestedValues; } });
+Object.defineProperty(exports, "isArrayPath", { enumerable: true, get: function () { return nested_value_util_1.isArrayPath; } });
+Object.defineProperty(exports, "getArrayBasePath", { enumerable: true, get: function () { return nested_value_util_1.getArrayBasePath; } });
+Object.defineProperty(exports, "getArrayElementPath", { enumerable: true, get: function () { return nested_value_util_1.getArrayElementPath; } });
+Object.defineProperty(exports, "getAllArrayItemPaths", { enumerable: true, get: function () { return nested_value_util_1.getAllArrayItemPaths; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAOA,sEAKyC;AAJvC,uHAAA,iBAAiB,OAAA;AAMnB,4EAS4C;AAR1C,4HAAA,mBAAmB,OAAA;AAUrB,oEAEwC;AADtC,oHAAA,eAAe,OAAA;AAGjB,yFAIwD;AAHtD,qHAAA,WAAW,OAAA;AACX,oHAAA,UAAU,OAAA;AACV,qHAAA,WAAW,OAAA;AAGb,0EAW8C;AAV5C,mHAAA,cAAc,OAAA;AACd,mHAAA,cAAc,OAAA;AACd,mHAAA,cAAc,OAAA;AACd,wHAAA,mBAAmB,OAAA;AACnB,gHAAA,WAAW,OAAA;AACX,qHAAA,gBAAgB,OAAA;AAChB,wHAAA,mBAAmB,OAAA;AACnB,yHAAA,oBAAoB,OAAA"}

package/dist/r2-storage/cloudflare.service.d.ts

@@ -0,0 +1,41 @@
+import { OnModuleInit, OnModuleDestroy } from '@nestjs/common';
+import { StorageOptions } from './interfaces/storage-options.interface';
+export interface UploadUrlResult {
+    uploadUrl: string;
+    fileKey: string;
+    publicUrl?: string;
+    mimeType: string;
+}
+export interface DownloadUrlResult {
+    downloadUrl: string;
+    publicUrl?: string;
+}
+export interface FileInfo {
+    size: number;
+    lastModified?: Date;
+    contentType?: string;
+}
+export declare class CloudflareService implements OnModuleInit, OnModuleDestroy {
+    private readonly storageOptions;
+    private s3Client;
+    private options;
+    private readonly defaultExpiry;
+    constructor(storageOptions: StorageOptions);
+    onModuleInit(): void;
+    onModuleDestroy(): void;
+    private initializeClient;
+    setOptions(options: StorageOptions): void;
+    getOptions(): StorageOptions;
+    private sanitizeFilename;
+    private detectMimeType;
+    getUploadUrl(fileKey: string, fileSize: number, customFilename?: string, contentType?: string): Promise<UploadUrlResult>;
+    getDownloadUrl(fileKey: string): Promise<DownloadUrlResult>;
+    deleteFile(fileKey: string): Promise<boolean>;
+    deleteFiles(fileKeys: string[]): Promise<{
+        success: string[];
+        failed: string[];
+    }>;
+    getFileInfo(fileKey: string): Promise<FileInfo | null>;
+    fileExists(fileKey: string): Promise<boolean>;
+    generateFileKey(prefix: string, filename: string): string;
+}

package/dist/r2-storage/cloudflare.service.js

@@ -0,0 +1,197 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudflareService = void 0;
+const common_1 = require("@nestjs/common");
+const client_s3_1 = require("@aws-sdk/client-s3");
+const s3_request_presigner_1 = require("@aws-sdk/s3-request-presigner");
+const path = __importStar(require("path"));
+const mime = __importStar(require("mime-types"));
+const constants_1 = require("./constants");
+let CloudflareService = class CloudflareService {
+    constructor(storageOptions) {
+        this.storageOptions = storageOptions;
+        this.defaultExpiry = 3600;
+        this.options = storageOptions;
+    }
+    onModuleInit() {
+        this.initializeClient();
+    }
+    onModuleDestroy() {
+        if (this.s3Client) {
+            this.s3Client.destroy();
+        }
+    }
+    initializeClient() {
+        this.s3Client = new client_s3_1.S3Client({
+            endpoint: this.options.endpoint,
+            region: this.options.region || 'auto',
+            credentials: {
+                accessKeyId: this.options.accessKeyId,
+                secretAccessKey: this.options.secretAccessKey,
+            },
+            forcePathStyle: true,
+        });
+    }
+    setOptions(options) {
+        this.options = options;
+        this.initializeClient();
+    }
+    getOptions() {
+        return this.options;
+    }
+    sanitizeFilename(filename) {
+        const sanitized = filename.replace(/[^a-zA-Z0-9._-]/g, '_');
+        const timestamp = Date.now();
+        const ext = path.extname(sanitized);
+        const basename = path.basename(sanitized, ext);
+        return `${basename}_${timestamp}${ext}`;
+    }
+    detectMimeType(filename, fallbackContentType = 'application/octet-stream') {
+        const mimeType = mime.lookup(filename);
+        return mimeType || fallbackContentType;
+    }
+    async getUploadUrl(fileKey, fileSize, customFilename, contentType) {
+        const filename = customFilename || path.basename(fileKey);
+        const sanitizedFilename = this.sanitizeFilename(filename);
+        const finalFileKey = fileKey.includes('/')
+            ? `${path.dirname(fileKey)}/${sanitizedFilename}`
+            : sanitizedFilename;
+        const mimeType = contentType || this.detectMimeType(sanitizedFilename);
+        const command = new client_s3_1.PutObjectCommand({
+            Bucket: this.options.bucketName,
+            Key: finalFileKey,
+            ContentType: mimeType,
+            ContentLength: fileSize,
+        });
+        const expiry = this.options.signedUrlExpiry || this.defaultExpiry;
+        const uploadUrl = await (0, s3_request_presigner_1.getSignedUrl)(this.s3Client, command, { expiresIn: expiry });
+        let publicUrl;
+        if (this.options.publicUrlBase) {
+            publicUrl = `${this.options.publicUrlBase}/${finalFileKey}`;
+        }
+        return {
+            uploadUrl,
+            fileKey: finalFileKey,
+            publicUrl,
+            mimeType,
+        };
+    }
+    async getDownloadUrl(fileKey) {
+        const command = new client_s3_1.GetObjectCommand({
+            Bucket: this.options.bucketName,
+            Key: fileKey,
+        });
+        const expiry = this.options.signedUrlExpiry || this.defaultExpiry;
+        const downloadUrl = await (0, s3_request_presigner_1.getSignedUrl)(this.s3Client, command, { expiresIn: expiry });
+        let publicUrl;
+        if (this.options.publicUrlBase) {
+            publicUrl = `${this.options.publicUrlBase}/${fileKey}`;
+        }
+        return {
+            downloadUrl,
+            publicUrl,
+        };
+    }
+    async deleteFile(fileKey) {
+        try {
+            const command = new client_s3_1.DeleteObjectCommand({
+                Bucket: this.options.bucketName,
+                Key: fileKey,
+            });
+            await this.s3Client.send(command);
+            return true;
+        }
+        catch (error) {
+            console.error(`Failed to delete file ${fileKey}:`, error);
+            return false;
+        }
+    }
+    async deleteFiles(fileKeys) {
+        const results = await Promise.all(fileKeys.map(async (fileKey) => {
+            const success = await this.deleteFile(fileKey);
+            return { fileKey, success };
+        }));
+        return {
+            success: results.filter((r) => r.success).map((r) => r.fileKey),
+            failed: results.filter((r) => !r.success).map((r) => r.fileKey),
+        };
+    }
+    async getFileInfo(fileKey) {
+        try {
+            const command = new client_s3_1.HeadObjectCommand({
+                Bucket: this.options.bucketName,
+                Key: fileKey,
+            });
+            const response = await this.s3Client.send(command);
+            return {
+                size: response.ContentLength || 0,
+                lastModified: response.LastModified,
+                contentType: response.ContentType,
+            };
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    async fileExists(fileKey) {
+        const fileInfo = await this.getFileInfo(fileKey);
+        return fileInfo !== null;
+    }
+    generateFileKey(prefix, filename) {
+        const timestamp = Date.now();
+        const sanitizedFilename = this.sanitizeFilename(filename);
+        return `${prefix}/${timestamp}_${sanitizedFilename}`;
+    }
+};
+exports.CloudflareService = CloudflareService;
+exports.CloudflareService = CloudflareService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(constants_1.STORAGE_OPTIONS)),
+    __metadata("design:paramtypes", [Object])
+], CloudflareService);
+//# sourceMappingURL=cloudflare.service.js.map

package/dist/r2-storage/cloudflare.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare.service.js","sourceRoot":"","sources":["../../src/r2-storage/cloudflare.service.ts"],"names":[],"mappings":"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"}

package/dist/r2-storage/constants.d.ts

@@ -0,0 +1 @@
+export declare const STORAGE_OPTIONS = "STORAGE_OPTIONS";

package/dist/r2-storage/constants.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STORAGE_OPTIONS = void 0;
+exports.STORAGE_OPTIONS = 'STORAGE_OPTIONS';
+//# sourceMappingURL=constants.js.map

package/dist/r2-storage/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/r2-storage/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,eAAe,GAAG,iBAAiB,CAAC"}

package/dist/r2-storage/decorators/photo-fields.decorator.d.ts

@@ -0,0 +1,24 @@
+export interface PhotoFieldsContext {
+    photoFields: Array<{
+        field: string;
+        urlField?: string;
+        sizeField?: string;
+    }>;
+}
+export declare const PhotoFields: (...dataOrPipes: (PhotoFieldsContext | import("@nestjs/common").PipeTransform<any, any> | import("@nestjs/common").Type<import("@nestjs/common").PipeTransform<any, any>>)[]) => ParameterDecorator;
+export interface UploadUrlsContext {
+    uploadUrls: Array<{
+        field: string;
+        fileKey: string;
+        uploadUrl: string;
+        publicUrl?: string;
+    }>;
+}
+export declare const UploadUrls: (...dataOrPipes: (UploadUrlsContext | import("@nestjs/common").PipeTransform<any, any> | import("@nestjs/common").Type<import("@nestjs/common").PipeTransform<any, any>>)[]) => ParameterDecorator;
+export interface StorageContext {
+    totalStorageUsed?: number;
+    storageIncrease?: number;
+    storageDecrease?: number;
+    totalStorageFreed?: number;
+}
+export declare const StorageInfo: (...dataOrPipes: (StorageContext | import("@nestjs/common").PipeTransform<any, any> | import("@nestjs/common").Type<import("@nestjs/common").PipeTransform<any, any>>)[]) => ParameterDecorator;

package/dist/r2-storage/decorators/photo-fields.decorator.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageInfo = exports.UploadUrls = exports.PhotoFields = void 0;
+const common_1 = require("@nestjs/common");
+exports.PhotoFields = (0, common_1.createParamDecorator)((data, ctx) => {
+    return data.photoFields;
+});
+exports.UploadUrls = (0, common_1.createParamDecorator)((data, ctx) => {
+    return data.uploadUrls;
+});
+exports.StorageInfo = (0, common_1.createParamDecorator)((data, ctx) => {
+    return data;
+});
+//# sourceMappingURL=photo-fields.decorator.js.map

package/dist/r2-storage/decorators/photo-fields.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"photo-fields.decorator.js","sourceRoot":"","sources":["../../../src/r2-storage/decorators/photo-fields.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAAwE;AAU3D,QAAA,WAAW,GAAG,IAAA,6BAAoB,EAC7C,CAAC,IAAwB,EAAE,GAAqB,EAAE,EAAE;IAClD,OAAO,IAAI,CAAC,WAAW,CAAC;AAC1B,CAAC,CACF,CAAC;AAWW,QAAA,UAAU,GAAG,IAAA,6BAAoB,EAC5C,CAAC,IAAuB,EAAE,GAAqB,EAAE,EAAE;IACjD,OAAO,IAAI,CAAC,UAAU,CAAC;AACzB,CAAC,CACF,CAAC;AASW,QAAA,WAAW,GAAG,IAAA,6BAAoB,EAC7C,CAAC,IAAoB,EAAE,GAAqB,EAAE,EAAE;IAC9C,OAAO,IAAI,CAAC;AACd,CAAC,CACF,CAAC"}

package/dist/r2-storage/interfaces/storage-options.interface.d.ts

@@ -0,0 +1,21 @@
+export interface StorageOptions {
+    endpoint: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+    bucketName: string;
+    region?: string;
+    publicUrlBase?: string;
+    signedUrlExpiry?: number;
+}
+export interface FileFieldConfig {
+    field: string;
+    sizeField?: string;
+}
+export interface PhotoFieldConfig {
+    field: string;
+    urlField?: string;
+    sizeField?: string;
+}
+export interface StorageModuleOptions {
+    isGlobal?: boolean;
+}

package/dist/r2-storage/interfaces/storage-options.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=storage-options.interface.js.map

package/dist/r2-storage/interfaces/storage-options.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-options.interface.js","sourceRoot":"","sources":["../../../src/r2-storage/interfaces/storage-options.interface.ts"],"names":[],"mappings":""}