nestjs-r2-storage 1.4.0 → 1.4.2

package/README.md

@@ -332,48 +332,6 @@ const result = await photoManager.deletePhotosFromObject(product, photoFields);
 // }
 ```
 
-## Upload Detection (Update Operations)
-
-The `updateObjectWithPhotos()` method uses intelligent upload detection to prevent unnecessary uploads and file deletions.
-
-### Dual-Mode Detection
-
-**Mode 1: Explicit Size Detection (when `sizeField` is defined)**
-- Only treats a field as a new upload if `sizeField > 0`
-- If `sizeField` is missing, null, or 0 → treats as existing file (no upload)
-
-**Mode 2: Filename Comparison (when `sizeField` is NOT defined)**
-- Compares base filenames between existing fileKey and incoming filename
-- Strips path, extension, and trailing timestamps before comparing
-- Only uploads if the base name differs
-
-```typescript
-// Example: existing fileKey = "product_1776949996526.png"
-// Incoming filename = "product.png"
-// extractBaseFilename returns "product" for both → no upload
-
-// Example: existing fileKey = "product_1776949996526.png"
-// Incoming filename = "new-product.png"
-// extractBaseFilename returns "product" vs "new-product" → upload
-```
-
-### Detection Matrix
-
-| Scenario | `sizeField` defined | Result |
-|----------|---------------------|--------|
-| Existing file unchanged | yes (size=0) | No upload, no delete |
-| Existing file unchanged | no (same base) | No upload, no delete |
-| Same filename resent | yes (size=0) | No upload |
-| Same filename resent | no (same base) | No upload |
-| New file uploaded | yes (size > 0) | Upload + replace old |
-| New file (no sizeField) | no (different base) | Upload + replace old |
-
-### Backward Compatibility
-
-- Existing clients that send `sizeField > 0` continue to work as before
-- Clients that don't send `sizeField` get automatic fallback to filename comparison
-- No changes to DTO structure or API required
-
 ## Field Path Syntax
 
 ### Simple Nested Fields
@@ -448,16 +406,7 @@ R2StorageModule.forRootAsync({
 
 ## Changelog
 
-### v1.4.0 (2026-04-23)
-
-- **Dual-mode upload detection** for `updateObjectWithPhotos()`:
-  - Mode 1: Explicit size detection when `sizeField` is defined (size > 0 = new upload)
-  - Mode 2: Base filename comparison when `sizeField` is NOT defined
-- **Deterministic file replacement** using `extractBaseFilename()` helper
-- **Backward compatible**: Existing clients work unchanged, clients without `sizeField` get automatic fallback
-- Removed heuristic-based upload detection (no longer relies on filename patterns or "/" presence)
-
-### v1.3.4 (2026-04-23)
+### v1.2.6 (2025-04-20)
 
 - Refactored getNestedValue: access key first, then handle array segments
 - Refactored setNestedValue: proper handling of empty brackets [] and indexed arrays [0]

package/dist/r2-storage/photo-manager.service.d.ts

@@ -1,55 +1,54 @@
-import { CloudflareService } from "./cloudflare.service";
-export interface PhotoField {
-    field: string;
-    urlField?: string;
-    sizeField?: string;
-}
-export interface PhotoUploadRequest {
-    field: string;
-    filename: string;
-    size: number;
-    prefix?: string;
-}
-export interface PhotoUploadResponse {
-    field: string;
-    fileKey: string;
-    uploadUrl: string;
-    publicUrl: string | null;
-    filename?: string;
-}
-export interface CreatePhotosResult<T extends Record<string, any>> {
-    updatedPayload: T;
-    uploadUrls: PhotoUploadResponse[];
-    totalStorageUsed: number;
-}
-export interface UpdatePhotosResult<T extends Record<string, any>> {
-    updatedPayload: T;
-    uploadUrls: PhotoUploadResponse[];
-    storageIncrease: number;
-    storageDecrease: number;
-    deletedFiles: string[];
-}
-export interface DeletePhotosResult {
-    deletedFiles: string[];
-    totalStorageFreed: number;
-}
-export interface AppendUrlsOptions {
-    urlField?: (field: string) => string;
-}
-export declare class PhotoManagerService {
-    private readonly cloudflareService;
-    constructor(cloudflareService: CloudflareService);
-    appendPhotoUrls<T extends Record<string, any>>(payload: T[], photoFields: PhotoField[]): Promise<T[]>;
-    private handleSingleFieldUrl;
-    private handleArrayFieldUrls;
-    createObjectWithPhotos<T extends Record<string, any>>(payload: T, photoFields: PhotoField[], filePrefix?: string): Promise<CreatePhotosResult<T>>;
-    updateObjectWithPhotos<T extends Record<string, any>>(payload: T, existingObject: T, photoFields: PhotoField[], filePrefix?: string): Promise<UpdatePhotosResult<T>>;
-    deletePhotosFromObject<T extends Record<string, any>>(object: T, photoFields: PhotoField[]): Promise<DeletePhotosResult>;
-    private extractPhotoUploadRequests;
-    private extractArrayFieldUploadRequests;
-    private extractExistingFiles;
-    extractBaseFilename(fileKey: string): string;
-    private filterNewPhotoRequests;
-    private determineFilesToDelete;
-    private updateArrayFieldWithNewFileKey;
-}
+import { CloudflareService } from "./cloudflare.service";
+export interface PhotoField {
+    field: string;
+    urlField?: string;
+    sizeField?: string;
+}
+export interface PhotoUploadRequest {
+    field: string;
+    filename: string;
+    size: number;
+    prefix?: string;
+}
+export interface PhotoUploadResponse {
+    field: string;
+    fileKey: string;
+    uploadUrl: string;
+    publicUrl: string | null;
+    filename?: string;
+}
+export interface CreatePhotosResult<T extends Record<string, any>> {
+    updatedPayload: T;
+    uploadUrls: PhotoUploadResponse[];
+    totalStorageUsed: number;
+}
+export interface UpdatePhotosResult<T extends Record<string, any>> {
+    updatedPayload: T;
+    uploadUrls: PhotoUploadResponse[];
+    storageIncrease: number;
+    storageDecrease: number;
+    deletedFiles: string[];
+}
+export interface DeletePhotosResult {
+    deletedFiles: string[];
+    totalStorageFreed: number;
+}
+export interface AppendUrlsOptions {
+    urlField?: (field: string) => string;
+}
+export declare class PhotoManagerService {
+    private readonly cloudflareService;
+    constructor(cloudflareService: CloudflareService);
+    appendPhotoUrls<T extends Record<string, any>>(payload: T[], photoFields: PhotoField[]): Promise<T[]>;
+    private handleSingleFieldUrl;
+    private handleArrayFieldUrls;
+    createObjectWithPhotos<T extends Record<string, any>>(payload: T, photoFields: PhotoField[], filePrefix?: string): Promise<CreatePhotosResult<T>>;
+    updateObjectWithPhotos<T extends Record<string, any>>(payload: T, existingObject: T, photoFields: PhotoField[], filePrefix?: string): Promise<UpdatePhotosResult<T>>;
+    deletePhotosFromObject<T extends Record<string, any>>(object: T, photoFields: PhotoField[]): Promise<DeletePhotosResult>;
+    private extractPhotoUploadRequests;
+    private extractArrayFieldUploadRequests;
+    private extractExistingFiles;
+    private determineFilesToDelete;
+    private normalizeFilename;
+    private updateArrayFieldWithNewFileKey;
+}