@plyaz/config 1.7.21 → 1.8.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/storage/constants.ts"],"names":[],"mappings":"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;;;QAQH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;;;QAQH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;;;QAQH;;WAEG;;QAGH;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;;;QAQH;;WAEG;;QAGH;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;;;QAQH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;QAGH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;QAQH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;QAQH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;QAGH;;;WAGG;;;;QAQH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;QAQH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;;;QAQH;;;WAGG;;QAGH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;QAQH;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;;;QAQH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;QASH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;;;QAQH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;;;QAQH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;;;QAQH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;;;QAQH;;WAEG;;QAGH;;WAEG;;;;QAQH;;WAEG;;QAGH;;WAEG;;;CA2BK,CAAC"}

package/dist/storage/defaults.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Storage Default Configurations
+ *
+ * Sensible default configurations for the storage system.
+ * These defaults provide production-ready compliance and operational behavior.
+ *
+ * @module src/storage/defaults
+ */
+import type { StorageComplianceConfig, StorageRetentionPolicy, StoragePresetConfig, StorageVariantConfig } from '@plyaz/types';
+import { FILE_CATEGORY, STORAGE_VARIANT_NAME } from '@plyaz/types';
+/**
+ * Default retention policy - FINANCE/CRYPTO FOCUSED
+ *
+ * - 7 years retention (financial/tax compliance requirement)
+ * - Soft delete enabled with 60-day grace period
+ * - Not immutable by default (allows correction of errors)
+ * - Financial industry standard retention
+ *
+ * This policy is designed for crypto/blockchain platforms and provides:
+ * - IRS/SEC compliance (7-year retention)
+ * - Extended grace period for financial data recovery (60 days)
+ * - Audit trail for regulatory requirements
+ * - Transaction record preservation
+ *
+ * Suitable for: Crypto wallets, blockchain platforms, financial services
+ */
+export declare const DEFAULT_RETENTION_POLICY: StorageRetentionPolicy;
+/**
+ * Default compliance configuration - CRYPTO/FINANCE PLATFORM
+ *
+ * Compliance is enabled by default with finance-focused defaults:
+ * - 7-year retention (IRS/SEC/FinCEN compliance)
+ * - Soft delete with 60-day grace period
+ * - Financial transaction audit trails
+ * - Not in strict mode (warnings instead of errors)
+ *
+ * Designed for crypto wallets, blockchain platforms, and financial services.
+ *
+ * Override this configuration for specific categories:
+ * - Transaction records: 7+ years retention, audit trail
+ * - Wallet backups: 7+ years retention, immutable
+ * - KYC/AML documents: 5-7 years retention per jurisdiction
+ * - Tax documents: 7+ years retention, immutable
+ * - Audit logs: 7+ years retention, immutable
+ * - Legal documents: 7+ years retention, immutable
+ * - Personal data: GDPR/CCPA-compliant deletion (user request)
+ */
+export declare const DEFAULT_COMPLIANCE_CONFIG: StorageComplianceConfig;
+/**
+ * Preset retention policies for common use cases
+ *
+ * These can be used as templates or applied directly to file categories.
+ */
+export declare const PRESET_RETENTION_POLICIES: {
+    /**
+     * Legal document retention
+     * - 7 years retention (common legal requirement)
+     * - Immutable during retention period
+     * - Soft delete with grace period
+     * - Compliant with SOX, GDPR, and other frameworks
+     */
+    LEGAL: StorageRetentionPolicy;
+    /**
+     * Financial document retention
+     * - 7 years retention (IRS, SEC requirements)
+     * - Immutable during retention period
+     * - Soft delete with extended grace period
+     */
+    FINANCIAL: StorageRetentionPolicy;
+    /**
+     * Tax document retention
+     * - 7 years retention (IRS requirement)
+     * - Immutable during retention period
+     * - Soft delete enabled
+     */
+    TAX: StorageRetentionPolicy;
+    /**
+     * Medical/health record retention
+     * - 10 years retention (HIPAA recommendation)
+     * - Immutable during retention period
+     * - Strict soft delete
+     */
+    MEDICAL: StorageRetentionPolicy;
+    /**
+     * Audit log retention
+     * - 1 year retention (security best practice)
+     * - Immutable (cannot be modified or deleted)
+     * - No grace period (permanent)
+     */
+    AUDIT: StorageRetentionPolicy;
+    /**
+     * Temporary file retention
+     * - No retention requirement
+     * - Can be deleted immediately
+     * - 7-day grace period for recovery
+     */
+    TEMPORARY: StorageRetentionPolicy;
+    /**
+     * Personal data retention (GDPR/CCPA)
+     * - No mandatory retention
+     * - Can be deleted on user request
+     * - 30-day grace period for accidental deletion
+     */
+    PERSONAL_DATA: StorageRetentionPolicy;
+    /**
+     * Crypto transaction records
+     * - 7 years retention (IRS/SEC/FinCEN requirement)
+     * - Immutable for audit trail integrity
+     * - Extended grace period for recovery
+     * - Blockchain transaction records, wallet operations, trades
+     */
+    CRYPTO_TRANSACTION: StorageRetentionPolicy;
+    /**
+     * KYC/AML documents
+     * - 7 years retention (FinCEN/BSA requirement)
+     * - Immutable for regulatory audit
+     * - Extended grace period (90 days)
+     * - Identity verification, proof of address, source of funds
+     */
+    KYC_AML: StorageRetentionPolicy;
+    /**
+     * Wallet backups & recovery seeds
+     * - 7 years retention (security best practice)
+     * - Immutable for security
+     * - Extended grace period (90 days)
+     * - Encrypted wallet backups, recovery phrases, private key backups
+     */
+    WALLET_BACKUP: StorageRetentionPolicy;
+};
+/**
+ * Built-in Variant Presets
+ *
+ * Standard transformation presets optimized for common use cases.
+ * Each preset includes device-aware variants for optimal performance
+ * across mobile, tablet, desktop, and 4K displays.
+ *
+ * Available presets:
+ * - profile-picture: Square images for user profiles (1:1)
+ * - post-image: Feed/content images with flexible aspect ratios
+ * - hero-banner: Large banner images with 16:9 aspect ratio
+ * - video-streaming: Multi-resolution video transcoding
+ * - social-share: Optimized for social media platforms
+ * - product-image: E-commerce product photos
+ */
+export declare const BUILT_IN_PRESETS: StoragePresetConfig[];
+/**
+ * Default Variants by File Category
+ *
+ * Automatic variant generation based on file category.
+ * When no preset is specified, these defaults are applied.
+ *
+ * Device-aware: Variants are automatically filtered based on target device
+ * to avoid generating unnecessary files and reduce storage costs.
+ */
+export declare const DEFAULT_VARIANTS_BY_CATEGORY: Partial<Record<FILE_CATEGORY, string[]>>;
+/**
+ * Device-specific Variant Overrides
+ *
+ * These mappings override the category defaults when a specific device is targeted.
+ * Useful for mobile-first or desktop-first optimizations.
+ */
+export declare const DEVICE_SPECIFIC_VARIANT_OVERRIDES: Partial<Record<string, Partial<Record<FILE_CATEGORY, string[]>>>>;
+/**
+ * Minimum Variant Requirements
+ *
+ * These categories must always generate at least these variants,
+ * regardless of device targeting, for fallback compatibility.
+ */
+export declare const MINIMUM_VARIANTS_BY_CATEGORY: Partial<Record<FILE_CATEGORY, string[]>>;
+/**
+ * Standard Variant Definitions
+ *
+ * Maps variant names to their configuration.
+ * Used by PresetManager to resolve variant names like 'thumbnail', 'mobile', '720p'
+ * to actual variant configurations with dimensions, format, quality, etc.
+ *
+ * This is the source of truth for all standard variant names across the platform.
+ */
+export declare const STANDARD_VARIANT_DEFINITIONS: Record<STORAGE_VARIANT_NAME, Partial<StorageVariantConfig>>;
+//# sourceMappingURL=defaults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/storage/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAGL,aAAa,EACb,oBAAoB,EAErB,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,wBAAwB,EAAE,sBAetC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,yBAAyB,EAAE,uBAwDvC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;IACpC;;;;;;OAMG;WAeE,sBAAsB;IAE3B;;;;;OAKG;eAeE,sBAAsB;IAE3B;;;;;OAKG;SAWE,sBAAsB;IAE3B;;;;;OAKG;aAWE,sBAAsB;IAE3B;;;;;OAKG;WASE,sBAAsB;IAE3B;;;;;OAKG;eASE,sBAAsB;IAE3B;;;;;OAKG;mBAWE,sBAAsB;IAE3B;;;;;;OAMG;wBAiBE,sBAAsB;IAE3B;;;;;;OAMG;aAkBE,sBAAsB;IAE3B;;;;;;OAMG;mBAcE,sBAAsB;CAC5B,CAAC;AAMF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB,EAAE,mBAAmB,EA6YjD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,CAsCjF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,EAAE,OAAO,CACrD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAmDzD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,CAIjF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAC/C,oBAAoB,EACpB,OAAO,CAAC,oBAAoB,CAAC,CAiI9B,CAAC"}

package/dist/storage/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Storage Configuration Module
+ *
+ * Exports all configuration constants and defaults for the storage system.
+ *
+ * @module src/storage
+ */
+export * from './constants';
+export * from './defaults';
+export * from './validation';
+export * from './mime-types';
+export * from './categories';
+export * from './chunked-upload';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC"}

package/dist/storage/mime-types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Storage MIME Type Mappings
+ *
+ * Centralized mapping between output formats, file extensions, and MIME types.
+ * Used for file generation, validation, and content-type handling.
+ *
+ * @module @plyaz/config/storage/mime-types
+ */
+import type { OUTPUT_FORMAT } from '@plyaz/types';
+/**
+ * Map of output formats to file extensions
+ */
+export declare const STORAGE_OUTPUT_FORMAT_TO_EXTENSION: Record<OUTPUT_FORMAT, string>;
+/**
+ * Map of output formats to MIME types
+ */
+export declare const STORAGE_OUTPUT_FORMAT_TO_MIME_TYPE: Record<OUTPUT_FORMAT, string>;
+/**
+ * Get file extension for output format
+ */
+export declare function getStorageExtensionForFormat(format: OUTPUT_FORMAT): string;
+/**
+ * Get MIME type for output format
+ */
+export declare function getStorageMimeTypeForFormat(format: OUTPUT_FORMAT): string;
+/**
+ * Get both extension and MIME type for output format
+ */
+export declare function getStorageFormatInfo(format: OUTPUT_FORMAT): {
+    extension: string;
+    mimeType: string;
+};
+//# sourceMappingURL=mime-types.d.ts.map

package/dist/storage/mime-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime-types.d.ts","sourceRoot":"","sources":["../../src/storage/mime-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,kCAAkC,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAS5E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kCAAkC,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAS5E,CAAC;AAEF;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAE1E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAEzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAKnG"}

package/dist/storage/validation.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Storage Validation Configuration
+ *
+ * Defines file size limits and MIME type restrictions per bucket purpose.
+ * Centralized configuration for storage validation across backend and frontend.
+ *
+ * @module @plyaz/config/storage/validation
+ */
+import type { StorageValidationConfig } from '@plyaz/types';
+import { BUCKET_PURPOSE } from '@plyaz/types';
+/**
+ * Default storage validation configuration
+ * Used when adapter config doesn't specify validation rules
+ */
+export declare const STORAGE_DEFAULT_VALIDATION_CONFIG: StorageValidationConfig;
+/**
+ * Get validation rules for a specific bucket purpose
+ * Falls back to default rules if purpose-specific rules not defined
+ *
+ * @param purpose - Bucket purpose
+ * @param config - Optional custom validation config (overrides defaults)
+ * @returns Validation rules for the purpose
+ */
+export declare function getStorageValidationRulesForPurpose(purpose: BUCKET_PURPOSE, config?: StorageValidationConfig): {
+    maxFileSize?: number;
+    allowedMimeTypes?: string[];
+    allowExecutables?: boolean;
+};
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/storage/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAgB9C;;;GAGG;AACH,eAAO,MAAM,iCAAiC,EAAE,uBAoFtC,CAAC;AAEX;;;;;;;GAOG;AAEH,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,uBAAuB,GAC/B;IACD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAeA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plyaz/config",
-  "version": "1.7.21",
+  "version": "1.8.0",
   "author": "Redeemer Pace",
   "license": "ISC",
   "description": "Provides shared configs and constants for @playz ecosystem.",
@@ -139,7 +139,7 @@
   "packageManager": "pnpm@10.11.0",
   "dependencies": {
     "@plyaz/devtools": "^1.9.4",
-    "@plyaz/types": "^1.15.16",
+    "@plyaz/types": "^1.16.0",
     "globals": "^16.4.0",
     "viem": "^2.31.7"
   },