@openinary/core 1.1.0

package/dist/utils/storage/cloud-storage.js

@@ -0,0 +1,514 @@
+import { StorageCache } from "./cache.js";
+import { KeyGenerator } from "./key-generator.js";
+import { S3ClientWrapper } from "./s3-client.js";
+import logger, { serializeError } from "../logger.js";
+import { FOLDER_SUMMARY_MAX_KEYS, shapeFolderSummary, shapeLevel, } from "../storage-level.js";
+import { adjustBucketStats, } from "./stats-tracker.js";
+// Lives at the bucket root, outside public/ and cache/, so it never shows up
+// in media listings or cache stats
+const STATS_OBJECT_KEY = ".openinary/stats.json";
+function isAggregateStats(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.size === "number" &&
+        typeof value.fileCount === "number");
+}
+export class CloudStorage {
+    s3Client;
+    cache;
+    constructor(config, clientOptions) {
+        this.s3Client = new S3ClientWrapper(config, clientOptions);
+        this.cache = new StorageCache();
+    }
+    /**
+     * Lists objects in storage (cloud only)
+     */
+    async list(prefix) {
+        return await this.s3Client.listObjects(prefix);
+    }
+    /**
+     * Lists one directory level (direct child prefixes + objects) using Delimiter: "/"
+     */
+    async listDelimited(prefix) {
+        return await this.s3Client.listDelimited(prefix);
+    }
+    /**
+     * Lists a single page of one directory level (bounded by maxKeys)
+     */
+    async listDelimitedPage(prefix, maxKeys) {
+        return await this.s3Client.listDelimitedPage(prefix, maxKeys);
+    }
+    /**
+     * Lists all objects under a prefix by fanning out one recursive listing per
+     * top-level folder in parallel, instead of a single sequential pagination
+     */
+    async listAllParallel(prefix) {
+        const topLevel = await this.s3Client.listDelimited(prefix);
+        const results = [...topLevel.objects];
+        const batchSize = 16;
+        for (let i = 0; i < topLevel.prefixes.length; i += batchSize) {
+            const batch = topLevel.prefixes.slice(i, i + batchSize);
+            const nested = await Promise.all(batch.map((folderPrefix) => this.s3Client.listObjects(folderPrefix)));
+            for (const objects of nested) {
+                results.push(...objects);
+            }
+        }
+        return results;
+    }
+    /**
+     * Lists one directory level of original files (under public/)
+     */
+    async listLevel(folderPath) {
+        const storagePrefix = folderPath ? `public/${folderPath}/` : "public/";
+        const delimited = await this.s3Client.listDelimited(storagePrefix);
+        return shapeLevel(storagePrefix, folderPath, delimited);
+    }
+    /**
+     * Gets a bounded summary of a folder (direct child count, truncation flag,
+     * media preview items) from a single delimiter-listed page
+     */
+    async getFolderSummary(folderPath, maxKeys = FOLDER_SUMMARY_MAX_KEYS) {
+        const storagePrefix = `public/${folderPath}/`;
+        const page = await this.s3Client.listDelimitedPage(storagePrefix, maxKeys);
+        return shapeFolderSummary(storagePrefix, folderPath, page);
+    }
+    /**
+     * Creates a folder marker object so empty folders are visible in S3-compatible storage
+     */
+    async createFolder(folderPath) {
+        const normalized = folderPath.replace(/^\/+/, "").replace(/\/+$/, "");
+        const storageKey = `public/${normalized}/`;
+        await this.s3Client.createFolderMarker(storageKey);
+    }
+    /**
+     * Checks whether a folder exists (marker or any object with the folder prefix)
+     */
+    async folderExists(folderPath) {
+        const normalized = folderPath.replace(/^\/+/, "").replace(/\/+$/, "");
+        const markerKey = `public/${normalized}/`;
+        if (await this.s3Client.objectExists(markerKey)) {
+            return true;
+        }
+        const prefixedObjects = await this.s3Client.listObjects(markerKey, 1);
+        return prefixedObjects.length > 0;
+    }
+    /**
+     * Renames/moves all objects under a folder prefix to a new prefix (copy + delete each)
+     */
+    async renameFolder(oldFolderPath, newFolderPath) {
+        const normalizedOld = oldFolderPath.replace(/^\/+/, "").replace(/\/+$/, "");
+        const normalizedNew = newFolderPath.replace(/^\/+/, "").replace(/\/+$/, "");
+        const prefix = `public/${normalizedOld}/`;
+        const objects = await this.s3Client.listObjects(prefix);
+        for (const obj of objects) {
+            const relativeKey = obj.key.slice(prefix.length);
+            const destKey = `public/${normalizedNew}/${relativeKey}`;
+            await this.s3Client.copyObject(obj.key, destKey);
+            await this.s3Client.deleteObject(obj.key);
+        }
+        this.cache.delete(`original:${normalizedOld}`);
+    }
+    /**
+     * Deletes all objects under a folder prefix (marker + contents)
+     */
+    async deleteFolder(folderPath) {
+        const normalized = folderPath.replace(/^\/+/, "").replace(/\/+$/, "");
+        const prefix = `public/${normalized}/`;
+        const objects = await this.s3Client.listObjects(prefix);
+        if (objects.length === 0) {
+            return 0;
+        }
+        const keys = objects.map((obj) => obj.key);
+        const deleted = await this.s3Client.deleteObjects(keys);
+        // Folder markers are excluded from stats, so only count real files
+        let deletedSize = 0;
+        let deletedFiles = 0;
+        for (const obj of objects) {
+            if (obj.key.endsWith("/"))
+                continue;
+            deletedSize += obj.size ?? 0;
+            deletedFiles += 1;
+        }
+        if (deletedFiles > 0) {
+            adjustBucketStats(this, "storage", {
+                size: -deletedSize,
+                fileCount: -deletedFiles,
+            });
+        }
+        // Invalidate in-memory cache for all deleted keys
+        this.cache.delete(`original:${normalized}`);
+        return deleted;
+    }
+    /**
+     * Checks file existence with intelligent caching for transformed files
+     */
+    async exists(originalPath, params) {
+        const key = KeyGenerator.generateKey(originalPath, params);
+        const cacheKey = `exists:${key}`;
+        const cached = this.cache.get(cacheKey);
+        // OPTIMIZATION: Cache hit = 0 Class B operation
+        if (cached) {
+            return cached.exists;
+        }
+        // Only if not in cache
+        const exists = await this.s3Client.objectExists(key);
+        this.cache.set(cacheKey, {
+            exists,
+            timestamp: Date.now(),
+        });
+        return exists;
+    }
+    /**
+     * Checks the existence of an original file with cache (by original path)
+     */
+    async existsOriginal(originalPath) {
+        return this.existsOriginalPath(originalPath);
+    }
+    /**
+     * Checks the existence of an original file WITHOUT using cache
+     * Used after deletion to ensure we don't serve stale cache data
+     */
+    async existsOriginalNoCache(originalPath) {
+        const storageKey = `public/${originalPath}`;
+        try {
+            const exists = await this.s3Client.objectExists(storageKey);
+            // Update cache with the fresh result
+            this.cache.set(`original:${originalPath}`, {
+                exists,
+                timestamp: Date.now(),
+            });
+            return exists;
+        }
+        catch (error) {
+            logger.error({
+                error: error.message,
+                filePath: originalPath,
+                metadata: error.$metadata,
+            }, "Cloud storage error while checking original path (no cache)");
+            return false;
+        }
+    }
+    /**
+     * Checks existence of an arbitrary original-path key (without params),
+     * using the same semantics as uploadOriginal/downloadOriginal.
+     * This is useful for detecting duplicate uploads by full path.
+     */
+    async existsOriginalPath(filePath) {
+        const cacheKey = `original:${filePath}`;
+        const cached = this.cache.get(cacheKey);
+        if (cached) {
+            return cached.exists;
+        }
+        const storageKey = `public/${filePath}`;
+        try {
+            const exists = await this.s3Client.objectExists(storageKey);
+            this.cache.set(cacheKey, {
+                exists,
+                timestamp: Date.now(),
+            });
+            return exists;
+        }
+        catch (error) {
+            logger.error({
+                error: error.message,
+                filePath,
+                metadata: error.$metadata,
+            }, "Cloud storage error while checking original path");
+            this.cache.set(cacheKey, {
+                exists: false,
+                timestamp: Date.now(),
+            });
+            return false;
+        }
+    }
+    /**
+     * Retrieves an original (unprocessed) file from the bucket
+     */
+    async downloadOriginal(originalPath) {
+        // Add public/ prefix for storage
+        const storageKey = `public/${originalPath}`;
+        return await this.s3Client.downloadObject(storageKey);
+    }
+    /**
+     * Retrieves an original (unprocessed) file as a stream, without buffering
+     * it in memory. Used to serve large originals (e.g. videos still being
+     * optimized) directly to clients.
+     */
+    async downloadOriginalStream(originalPath) {
+        const storageKey = `public/${originalPath}`;
+        return await this.s3Client.downloadObjectStream(storageKey);
+    }
+    /**
+     * Uploads an original (unprocessed) file to the bucket
+     */
+    async uploadOriginal(filePath, buffer, contentType) {
+        // Add public/ prefix for storage
+        const storageKey = `public/${filePath}`;
+        await this.s3Client.uploadObject(storageKey, buffer, contentType);
+        adjustBucketStats(this, "storage", { size: buffer.length, fileCount: 1 });
+        // Mark the file as existing in the cache
+        this.cache.set(`original:${filePath}`, {
+            exists: true,
+            timestamp: Date.now(),
+        });
+        // Returns the public URL (without public/ prefix since it's internal)
+        return this.s3Client.getPublicUrl(storageKey);
+    }
+    /**
+     * Upload with cache invalidation
+     */
+    async upload(originalPath, params, buffer, contentType) {
+        const key = KeyGenerator.generateKey(originalPath, params);
+        // Add metadata for easy cleanup later
+        // Encoded because x-amz-meta-* header values must be ASCII-safe;
+        // some S3-compatible providers reject non-ASCII bytes outright.
+        const metadata = {
+            "x-original-path": encodeURIComponent(originalPath),
+        };
+        await this.s3Client.uploadObject(key, buffer, contentType, metadata);
+        adjustBucketStats(this, "cache", { size: buffer.length, fileCount: 1 });
+        // Mark the file as existing in the cache
+        this.cache.set(`exists:${key}`, {
+            exists: true,
+            timestamp: Date.now(),
+        });
+        // Returns the public URL
+        return this.s3Client.getPublicUrl(key);
+    }
+    /**
+     * Retrieves a file from the bucket
+     */
+    async download(originalPath, params) {
+        const key = KeyGenerator.generateKey(originalPath, params);
+        return await this.s3Client.downloadObject(key);
+    }
+    /**
+     * Generates a signed URL for temporary access (optional)
+     */
+    async getSignedUrl(originalPath, params, expiresIn = 3600) {
+        const key = KeyGenerator.generateKey(originalPath, params);
+        return await this.s3Client.getSignedUrl(key, expiresIn);
+    }
+    /**
+     * Deletes an original file from storage
+     */
+    async deleteOriginal(originalPath) {
+        // Add public/ prefix for storage
+        const storageKey = `public/${originalPath}`;
+        // HEAD first: the deleted object's size is needed for stats tracking,
+        // and a delete on a missing key succeeds silently
+        const metadata = await this.s3Client.getObjectMetadata(storageKey);
+        await this.s3Client.deleteObject(storageKey);
+        if (metadata) {
+            adjustBucketStats(this, "storage", {
+                size: -metadata.size,
+                fileCount: -1,
+            });
+        }
+        // Invalidate cache
+        this.cache.delete(`original:${originalPath}`);
+    }
+    /**
+     * Copies an original file to a new path within storage
+     */
+    async copyOriginal(sourcePath, destPath) {
+        const sourceKey = `public/${sourcePath}`;
+        const destKey = `public/${destPath}`;
+        await this.s3Client.copyObject(sourceKey, destKey);
+        const metadata = await this.s3Client.getObjectMetadata(destKey);
+        if (metadata) {
+            adjustBucketStats(this, "storage", {
+                size: metadata.size,
+                fileCount: 1,
+            });
+        }
+        // Mark the new file as existing in the cache
+        this.cache.set(`original:${destPath}`, {
+            exists: true,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Renames/moves an original file to a new path (copy + delete)
+     */
+    async renameOriginal(sourcePath, destPath) {
+        await this.copyOriginal(sourcePath, destPath);
+        await this.deleteOriginal(sourcePath);
+    }
+    /**
+     * Gets metadata for an original file (size, dates)
+     */
+    async getOriginalMetadata(originalPath) {
+        const storageKey = `public/${originalPath}`;
+        const metadata = await this.s3Client.getObjectMetadata(storageKey);
+        if (!metadata) {
+            return null;
+        }
+        // For S3, we use lastModified for both dates since S3 doesn't track creation time separately
+        return {
+            size: metadata.size,
+            createdAt: metadata.lastModified,
+            updatedAt: metadata.lastModified,
+        };
+    }
+    /**
+     * Gets metadata for an optimized/transformed file (size only)
+     */
+    async getOptimizedMetadata(originalPath, params) {
+        const key = KeyGenerator.generateKey(originalPath, params);
+        const metadata = await this.s3Client.getObjectMetadata(key);
+        if (!metadata) {
+            return null;
+        }
+        return {
+            size: metadata.size,
+        };
+    }
+    /**
+     * Invalidates the cache for a specific file
+     */
+    invalidateCache(originalPath, params) {
+        if (params) {
+            const key = KeyGenerator.generateKey(originalPath, params);
+            this.cache.delete(`exists:${key}`);
+        }
+        this.cache.delete(`original:${originalPath}`);
+    }
+    /**
+     * Deletes all cached transformations for an original file from cloud storage
+     * Uses metadata to identify files belonging to the original path
+     */
+    async deleteAllCachedTransformations(originalPath) {
+        try {
+            // List all objects with cache/ prefix
+            const cacheObjects = await this.s3Client.listObjects("cache/");
+            const keysToDelete = [];
+            let sizeToDelete = 0;
+            // Check each object's metadata to see if it belongs to this original path
+            for (const obj of cacheObjects) {
+                try {
+                    const metadata = await this.s3Client.getObjectMetadata(obj.key);
+                    if (metadata?.metadata?.["x-original-path"] ===
+                        encodeURIComponent(originalPath)) {
+                        keysToDelete.push(obj.key);
+                        sizeToDelete += obj.size ?? 0;
+                    }
+                }
+                catch (error) {
+                    // If we can't get metadata, skip this object
+                    logger.warn({ error: serializeError(error), key: obj.key }, "Failed to get metadata for cache object");
+                }
+            }
+            if (keysToDelete.length === 0) {
+                logger.debug({ originalPath }, "No cached transformations found in cloud storage");
+                return 0;
+            }
+            // Delete all identified objects
+            const deletedCount = await this.s3Client.deleteObjects(keysToDelete);
+            adjustBucketStats(this, "cache", {
+                size: -sizeToDelete,
+                fileCount: -keysToDelete.length,
+            });
+            logger.info({ originalPath, deletedCount, totalFound: keysToDelete.length }, "Deleted cached transformations from cloud storage");
+            return deletedCount;
+        }
+        catch (error) {
+            logger.error({ error: serializeError(error), originalPath }, "Failed to delete cached transformations");
+            throw error;
+        }
+    }
+    /**
+     * Loads the persisted aggregate stats object, or null when it doesn't
+     * exist yet or is unreadable (triggering a recomputation)
+     */
+    async loadPersistedStats() {
+        if (!(await this.s3Client.objectExists(STATS_OBJECT_KEY))) {
+            return null;
+        }
+        try {
+            const buffer = await this.s3Client.downloadObject(STATS_OBJECT_KEY);
+            const parsed = JSON.parse(buffer.toString("utf-8"));
+            if (isAggregateStats(parsed?.storage) &&
+                isAggregateStats(parsed?.cache) &&
+                typeof parsed.updatedAt === "string") {
+                return parsed;
+            }
+            logger.warn("Persisted bucket stats have an unexpected shape, recomputing");
+            return null;
+        }
+        catch (error) {
+            logger.warn({ error: serializeError(error) }, "Failed to load persisted bucket stats, recomputing");
+            return null;
+        }
+    }
+    /**
+     * Persists the aggregate stats object to the bucket
+     */
+    async persistStats(stats) {
+        await this.s3Client.uploadObject(STATS_OBJECT_KEY, Buffer.from(JSON.stringify(stats)), "application/json");
+    }
+    /**
+     * Recomputes aggregate stats from full bucket listings. O(n) in object
+     * count - only used to seed the tracker and for explicit reconciliation,
+     * never on the /storage/stats read path.
+     */
+    async computeBucketStats() {
+        const [publicObjects, cacheObjects] = await Promise.all([
+            this.listAllParallel("public/"),
+            this.s3Client.listObjects("cache/"),
+        ]);
+        const storage = { size: 0, fileCount: 0 };
+        for (const obj of publicObjects) {
+            if (obj.key.endsWith("/"))
+                continue; // folder markers
+            storage.size += obj.size ?? 0;
+            storage.fileCount += 1;
+        }
+        const cache = { size: 0, fileCount: 0 };
+        for (const obj of cacheObjects) {
+            cache.size += obj.size ?? 0;
+            cache.fileCount += 1;
+        }
+        return { storage, cache };
+    }
+    /**
+     * Deletes all cached transformations from cloud storage and clears the in-memory cache
+     */
+    async clearAllCache() {
+        const cacheObjects = await this.s3Client.listObjects("cache/");
+        const deletedCount = cacheObjects.length === 0
+            ? 0
+            : await this.s3Client.deleteObjects(cacheObjects.map((obj) => obj.key));
+        if (cacheObjects.length > 0) {
+            adjustBucketStats(this, "cache", {
+                size: -cacheObjects.reduce((sum, obj) => sum + (obj.size ?? 0), 0),
+                fileCount: -cacheObjects.length,
+            });
+        }
+        this.cache.clear();
+        return deletedCount;
+    }
+    /**
+     * Invalidates all cache entries for a given original path
+     * This clears the in-memory cache for both the original file and all its transformations
+     */
+    invalidateAllCacheEntries(originalPath) {
+        // Clear the original file cache
+        this.cache.delete(`original:${originalPath}`);
+        // Clear all transformation caches that might exist
+        // We need to iterate through all cache keys and remove those related to this original path
+        const allKeys = this.cache.getAllKeys();
+        let deletedCount = 0;
+        for (const key of allKeys) {
+            // Keys for transformations contain the original path in their storage key
+            // Format: exists:cache/${originalPath}-${hash}.ext
+            if (key.includes(originalPath) ||
+                key.startsWith(`exists:cache/${originalPath}`)) {
+                this.cache.delete(key);
+                deletedCount++;
+            }
+        }
+        logger.debug({ originalPath, deletedCount }, "Invalidated cache entries for original path");
+    }
+}
+//# sourceMappingURL=cloud-storage.js.map

package/dist/utils/storage/cloud-storage.js.map

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

package/dist/utils/storage/factory.d.ts

@@ -0,0 +1,10 @@
+import { StorageConfig, StorageClientOptions } from './types';
+import { CloudStorage } from './cloud-storage';
+/**
+ * Pure factory: builds a storage client from an explicit config, with no
+ * knowledge of where that config came from (env vars, a database row, a
+ * per-tenant resolver, ...). Callers own resolving the config.
+ */
+export declare function createStorageClient(config: StorageConfig, clientOptions?: StorageClientOptions): CloudStorage | null;
+export declare const createOptimizedStorageClient: typeof createStorageClient;
+//# sourceMappingURL=factory.d.ts.map

package/dist/utils/storage/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/utils/storage/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,aAAa,CAAC,EAAE,oBAAoB,GACnC,YAAY,GAAG,IAAI,CAOrB;AAGD,eAAO,MAAM,4BAA4B,4BAAsB,CAAC"}

package/dist/utils/storage/factory.js

@@ -0,0 +1,17 @@
+import { CloudStorage } from './cloud-storage.js';
+import logger from '../logger.js';
+/**
+ * Pure factory: builds a storage client from an explicit config, with no
+ * knowledge of where that config came from (env vars, a database row, a
+ * per-tenant resolver, ...). Callers own resolving the config.
+ */
+export function createStorageClient(config, clientOptions) {
+    if (!config.accessKeyId || !config.secretAccessKey || !config.bucketName) {
+        logger.warn('Storage configuration incomplete. Cloud storage disabled.');
+        return null;
+    }
+    return new CloudStorage(config, clientOptions);
+}
+// Alias for compatibility
+export const createOptimizedStorageClient = createStorageClient;
+//# sourceMappingURL=factory.js.map

package/dist/utils/storage/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/utils/storage/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,MAAM,MAAM,WAAW,CAAC;AAE/B;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAqB,EACrB,aAAoC;IAEpC,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACzE,MAAM,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;QACzE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,YAAY,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AACjD,CAAC;AAED,0BAA0B;AAC1B,MAAM,CAAC,MAAM,4BAA4B,GAAG,mBAAmB,CAAC"}

package/dist/utils/storage/index.d.ts

@@ -0,0 +1,7 @@
+export type { StorageConfig, CacheEntry } from './types';
+export { CloudStorage } from './cloud-storage';
+export { StorageCache } from './cache';
+export { S3ClientWrapper } from './s3-client';
+export { KeyGenerator } from './key-generator';
+export { createStorageClient, createOptimizedStorageClient } from './factory';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/storage/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGzD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,MAAM,WAAW,CAAC"}

package/dist/utils/storage/index.js

@@ -0,0 +1,8 @@
+// Main classes
+export { CloudStorage } from './cloud-storage.js';
+export { StorageCache } from './cache.js';
+export { S3ClientWrapper } from './s3-client.js';
+export { KeyGenerator } from './key-generator.js';
+// Factory functions
+export { createStorageClient, createOptimizedStorageClient } from './factory.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/storage/index.ts"],"names":[],"mappings":"AAGA,eAAe;AACf,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,oBAAoB;AACpB,OAAO,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,MAAM,WAAW,CAAC"}

package/dist/utils/storage/key-generator.d.ts

@@ -0,0 +1,11 @@
+export declare class KeyGenerator {
+    /**
+     * Generates a unique key for the file based on path and parameters
+     */
+    static generateKey(originalPath: string, params: any): string;
+    /**
+     * Generates cache key for existence check
+     */
+    static generateCacheKey(originalPath: string, params?: any): string;
+}
+//# sourceMappingURL=key-generator.d.ts.map

package/dist/utils/storage/key-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-generator.d.ts","sourceRoot":"","sources":["../../../src/utils/storage/key-generator.ts"],"names":[],"mappings":"AAEA,qBAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,MAAM;IAO7D;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,MAAM;CAOpE"}

package/dist/utils/storage/key-generator.js

@@ -0,0 +1,23 @@
+import { createHash } from 'crypto';
+export class KeyGenerator {
+    /**
+     * Generates a unique key for the file based on path and parameters
+     */
+    static generateKey(originalPath, params) {
+        const paramsString = JSON.stringify(params);
+        const hash = createHash('md5').update(originalPath + paramsString).digest('hex');
+        const ext = originalPath.split('.').pop();
+        return `cache/${hash}.${ext}`;
+    }
+    /**
+     * Generates cache key for existence check
+     */
+    static generateCacheKey(originalPath, params) {
+        if (params) {
+            const key = this.generateKey(originalPath, params);
+            return `exists:${key}`;
+        }
+        return `original:${originalPath}`;
+    }
+}
+//# sourceMappingURL=key-generator.js.map

package/dist/utils/storage/key-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-generator.js","sourceRoot":"","sources":["../../../src/utils/storage/key-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,MAAM,OAAO,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,YAAoB,EAAE,MAAW;QAClD,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,GAAG,YAAY,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjF,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QAC1C,OAAO,SAAS,IAAI,IAAI,GAAG,EAAE,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,YAAoB,EAAE,MAAY;QACxD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YACnD,OAAO,UAAU,GAAG,EAAE,CAAC;QACzB,CAAC;QACD,OAAO,YAAY,YAAY,EAAE,CAAC;IACpC,CAAC;CACF"}

package/dist/utils/storage/listing-cache.d.ts

@@ -0,0 +1,14 @@
+type ListedObject = {
+    key: string;
+    size?: number;
+    lastModified?: Date;
+};
+/**
+ * Returns the cached full bucket listing, fetching it at most once per TTL.
+ * The promise itself is cached so concurrent callers (e.g. GET /storage and
+ * GET /storage/stats firing together on dashboard load) share one S3 fan-out.
+ */
+export declare function getCachedFullListing(fetcher: () => Promise<ListedObject[]>): Promise<ListedObject[]>;
+export declare function invalidateListingCache(): void;
+export {};
+//# sourceMappingURL=listing-cache.d.ts.map