smartbucket/changelog.md

# Changelog

## 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.