# Changelog ## 2025-08-15 - 3.3.9 - fix(docs) Revise README with detailed usage examples and add local Claude settings - Revamped README: reorganized content, added emojis and clearer headings for install, getting started, bucket/file/directory operations, streaming, metadata, trash/recovery, locking, and advanced configuration. - Added many concrete code examples for SmartBucket, Bucket, Directory, File, streaming (node/web), RxJS replay subjects, metadata handling, trash workflow, file locking, magic-bytes detection, JSON operations, and cleaning bucket contents. - Included testing instructions (pnpm test) and a Best Practices section with recommendations for strict mode, streaming, metadata, trash usage, and locking. - Added .claude/settings.local.json to include local Claude configuration and tool permissions. - No source code or public API changes; documentation and local tooling config only. ## 2025-08-15 - 3.3.8 - fix(tests) Update tests to use @git.zone/tstest, upgrade dependencies, remove GitLab CI and add local CI/workspace config - Tests: replace imports from @push.rocks/tapbundle with @git.zone/tstest/tapbundle and switch tap.start() to export default tap.start() - Dependencies: bump @aws-sdk/client-s3 and several @push.rocks packages; upgrade @tsclass/tsclass to a newer major - DevDependencies: upgrade @git.zone/tsbuild, @git.zone/tstest, @push.rocks/qenv, and @push.rocks/tapbundle - CI/config: remove .gitlab-ci.yml, add .claude/settings.local.json - Workspace: add pnpm-workspace.yaml and packageManager field in package.json ## 2024-12-02 - 3.3.7 - fix(package) Update author field in package.json - Corrected the author field from 'Lossless GmbH' to 'Task Venture Capital GmbH' in the package.json file. ## 2024-12-02 - 3.3.6 - fix(package) Fix license field in package.json to reflect MIT licensing ## 2024-11-25 - 3.3.5 - fix(test) Refactor trash test to improve metadata validation - Added new checks in trash tests to ensure metadata files are correctly moved to trash. - Validated the presence and integrity of metadata within trashed files. ## 2024-11-25 - 3.3.4 - fix(core) Minor refactoring and cleanup of TypeScript source files for improved readability and maintainability. ## 2024-11-24 - 3.3.3 - fix(documentation) Improved documentation accuracy and consistency - Updated the project description to reflect the cloud-agnostic nature and advanced capabilities - Enhanced the README with detailed explanations and code examples for advanced features like trash management - Clarified the handling and importance of metadata using the MetaData utility ## 2024-11-24 - 3.3.2 - fix(documentation) Updated keywords and description for clarity and consistency. - Modified keywords and description in package.json and npmextra.json. - Enhanced readme.md file structure and examples ## 2024-11-24 - 3.3.1 - fix(File) Fixed issue with file restore metadata operations. - Corrected the order of operations in the file restore function to ensure custom metadata is appropriately deleted after moving the file. ## 2024-11-24 - 3.3.0 - feat(core) Enhanced directory handling and file restoration from trash - Refined getSubDirectoryByName to handle file paths treated as directories. - Introduced file restoration function from trash to original or specified paths. ## 2024-11-24 - 3.2.2 - fix(core) Refactor Bucket class for improved error handling - Ensured safe access using non-null assertions when finding a bucket. - Enhanced fastPut method by adding fastPutStrict for safer operations. - Added explicit error handling and type checking in fastExists method. ## 2024-11-24 - 3.2.1 - fix(metadata) Fix metadata handling for deleted files - Ensured metadata is correctly stored and managed when files are deleted into the trash. ## 2024-11-24 - 3.2.0 - feat(bucket) Enhanced SmartBucket with trash management and metadata handling - Added functionality to move files to a trash directory. - Introduced methods to handle file metadata more robustly. - Implemented a method to clean all contents from a bucket. - Enhanced directory retrieval to handle non-existent directories with options. - Improved handling of file paths and metadata within the storage system. ## 2024-11-18 - 3.1.0 - feat(file) Added functionality to retrieve magic bytes from files and detect file types using magic bytes. - Introduced method `getMagicBytes` in `File` and `Bucket` classes to retrieve a specific number of bytes from a file. - Enhanced file type detection by utilizing magic bytes in `MetaData` class. - Updated dependencies for better performance and compatibility. ## 2024-11-18 - 3.0.24 - fix(metadata) Fix metadata handling to address type assertion and data retrieval. - Fixed type assertion issues in `MetaData` class properties with type non-null assertions. - Corrected the handling of JSON data retrieval in `MetaData.storeCustomMetaData` function. ## 2024-10-16 - 3.0.23 - fix(dependencies) Update package dependencies for improved functionality and security. - Updated @aws-sdk/client-s3 to version ^3.670.0 for enhanced S3 client capabilities. - Updated @push.rocks/smartstream to version ^3.2.4. - Updated the dev dependency @push.rocks/tapbundle to version ^5.3.0. ## 2024-07-28 - 3.0.22 - fix(dependencies) Update dependencies and improve bucket retrieval logging - Updated @aws-sdk/client-s3 to ^3.620.0 - Updated @git.zone/tsbuild to ^2.1.84 - Updated @git.zone/tsrun to ^1.2.49 - Updated @push.rocks/smartpromise to ^4.0.4 - Updated @tsclass/tsclass to ^4.1.2 - Added a log for when a bucket is not found by name in getBucketByName method ## 2024-07-04 - 3.0.21 - fix(test) Update endpoint configuration in tests to use environment variable - Modified `qenv.yml` to include `S3_ENDPOINT` as a required environment variable. - Updated test files to fetch `S3_ENDPOINT` from environment instead of hardcoding. ## 2024-06-19 - 3.0.20 - Fix and Stability Updates Improved overall stability and consistency. ## 2024-06-18 - 3.0.18 - Delete Functions Consistency Ensured more consistency between delete methods and trash behavior. ## 2024-06-17 - 3.0.17 to 3.0.16 - Fix and Update Routine updates and fixes performed. ## 2024-06-11 - 3.0.15 to 3.0.14 - Fix and Update Routine updates and fixes performed. ## 2024-06-10 - 3.0.13 - Trash Feature Completion Finished work on trash feature. ## 2024-06-09 - 3.0.12 - Fix and Update Routine updates and fixes performed. ## 2024-06-08 - 3.0.11 to 3.0.10 - Fix and Update Routine updates and fixes performed. ## 2024-06-03 - 3.0.10 - Fix and Update Routine updates and fixes performed. ## 2024-05-29 - 3.0.9 - Update Description Updated project description. ## 2024-05-27 - 3.0.8 to 3.0.6 - Pathing and Core Updates Routine updates and fixes performed. - S3 paths' pathing differences now correctly handled with a reducePath method. ## 2024-05-21 - 3.0.5 to 3.0.4 - Fix and Update Routine updates and fixes performed. ## 2024-05-17 - 3.0.3 to 3.0.2 - Fix and Update Routine updates and fixes performed. ## 2024-05-17 - 3.0.0 - Major Release Introduced breaking changes in core and significant improvements. ## 2024-05-05 - 2.0.5 - Breaking Changes Introduced breaking changes in core functionality. ## 2024-04-14 - 2.0.4 - TSConfig Update Updated TypeScript configuration. ## 2024-01-01 - 2.0.2 - Organization Scheme Update Switched to the new organizational scheme.