@plyaz/config 1.7.21 → 1.8.0

package/dist/storage/categories.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Storage Categories & Bucket Organization
+ *
+ * Provider-agnostic storage organization by PURPOSE and CONTENT TYPE.
+ * Adapters internally translate these purposes to their naming conventions.
+ *
+ * Universal approach:
+ * - Define buckets by PURPOSE (compliance, media-images, backups, etc.)
+ * - Paths are universal across all providers
+ * - Adapters handle their own naming rules internally
+ *
+ * @module @plyaz/config/storage/categories
+ */
+import type { StorageCategory } from '@plyaz/types';
+import { BUCKET_PURPOSE } from '@plyaz/types';
+/**
+ * Constants for storage retention policies (in days)
+ */
+export declare const STORAGE_RETENTION_DAYS: {
+    readonly DAYS_PER_YEAR: 365;
+    readonly COMPLIANCE_YEARS: 7;
+    readonly TEMPORARY_DAYS: 7;
+    readonly BACKUP_DAYS: 90;
+};
+/**
+ * Constants for TTL calculations
+ */
+export declare const STORAGE_TTL_CONSTANTS: {
+    readonly SECONDS_PER_DAY: 86400;
+};
+/**
+ * Storage category definitions
+ * Provider-agnostic organization by purpose
+ */
+export declare const STORAGE_CATEGORIES: Record<BUCKET_PURPOSE, StorageCategory>;
+/**
+ * Example adapter bucket name translation:
+ *
+ * Identifier: "compliance:enterprise:acme-corp:prod"
+ *
+ * CloudflareR2Adapter translates to:
+ * → plyaz-prod-weur-enterprise-acme-corp-records-vault
+ *
+ * SupabaseStorageAdapter translates to:
+ * → compliance-acme-corp (projects handle env)
+ *
+ * S3Adapter translates to:
+ * → plyaz-compliance-enterprise-acme-corp-prod-us-east-1
+ *
+ * All use the SAME paths internally!
+ */
+//# sourceMappingURL=categories.d.ts.map

package/dist/storage/categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../src/storage/categories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EACL,cAAc,EAEf,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;CAKzB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,qBAAqB;;CAExB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,cAAc,EAAE,eAAe,CA2EtE,CAAC;AAEF;;;;;;;;;;;;;;;GAeG"}

package/dist/storage/chunked-upload.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Storage Chunked Upload Configuration
+ *
+ * Configuration constants for multipart/chunked file uploads.
+ * Used by adapters that support chunked uploads (R2, Supabase, S3).
+ *
+ * @module @plyaz/config/storage/chunked-upload
+ */
+/**
+ * Chunk size configuration for multipart uploads
+ * Based on S3/R2 limits: 5MB min, 5GB max per part, 10,000 parts max
+ */
+export declare const STORAGE_CHUNK_SIZE: {
+    readonly MIN: number;
+    readonly MAX: number;
+    readonly DEFAULT_SMALL: number;
+    readonly DEFAULT_MEDIUM: number;
+    readonly DEFAULT_LARGE: number;
+    readonly DEFAULT_HUGE: number;
+};
+/**
+ * File size thresholds for determining chunk strategy
+ */
+export declare const STORAGE_FILE_SIZE_THRESHOLDS: {
+    readonly SMALL: number;
+    readonly MEDIUM: 1073741824;
+    readonly LARGE: number;
+    readonly CHUNKED_UPLOAD: number;
+};
+/**
+ * Check if file should use chunked upload based on size
+ *
+ * @param file - File buffer or stream
+ * @param threshold - Size threshold in bytes (defaults to 100MB)
+ * @returns True if file should use chunked upload
+ *
+ * @example
+ * ```typescript
+ * const shouldChunk = shouldUseStorageChunkedUpload(fileBuffer);
+ * const shouldChunkCustom = shouldUseStorageChunkedUpload(fileBuffer, 50 * 1024 * 1024);
+ * ```
+ */
+export declare function shouldUseStorageChunkedUpload(file: globalThis.Buffer | globalThis.NodeJS.ReadableStream | null | undefined, threshold?: number): boolean;
+/**
+ * Get optimal chunk size based on file size
+ * Follows S3/R2 limits: 5MB min, 5GB max per part, 10,000 parts max
+ *
+ * @param totalSize - Total file size in bytes
+ * @returns Optimal chunk size in bytes
+ *
+ * @example
+ * ```typescript
+ * const chunkSize = getStorageOptimalChunkSize(50 * 1024 * 1024); // 50MB file
+ * console.log(chunkSize); // 5242880 (5MB)
+ * ```
+ */
+export declare function getStorageOptimalChunkSize(totalSize: number): number;
+//# sourceMappingURL=chunked-upload.d.ts.map

package/dist/storage/chunked-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunked-upload.d.ts","sourceRoot":"","sources":["../../src/storage/chunked-upload.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgBH;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;CAOrB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;CAK/B,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,UAAU,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,cAAc,GAAG,IAAI,GAAG,SAAS,EAC7E,SAAS,GAAE,MAAoD,GAC9D,OAAO,CAKT;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAcpE"}