changelog.md for @push.rocks/smartstorage

2026-03-23 - 6.3.2 - fix(docs)
update license ownership and correct README license file reference
Adjusts the copyright holder name in the license file
Fixes the README link to match the lowercase license filename
2026-03-21 - 6.3.1 - fix(cluster)
improve shard reconstruction validation and start background healing service
use the erasure read quorum when reconstructing chunks instead of assuming data shard count
verify reconstructed shards before writing healed data back to disk
start the healing service during server initialization with shared local shard stores
simplify QUIC request handling by decoding the full request buffer including trailing shard data
clean up unused variables and imports across cluster modules
2026-03-21 - 6.3.0 - feat(readme)
document distributed cluster mode, erasure coding, and QUIC-based architecture
Expand README overview and feature matrix to highlight clustering, multi-drive awareness, and distributed storage capabilities
Add standalone and cluster mode usage examples plus cluster configuration options
Document clustering internals including erasure coding, quorum behavior, QUIC transport, self-healing, and on-disk layout
2026-03-21 - 6.2.0 - feat(cluster)
add shard healing, drive health heartbeats, and clustered policy directory support
implements manifest-based healing that scans affected shards on offline nodes, reconstructs data with erasure coding, and rewrites recovered shards to local storage
includes drive status reporting in membership heartbeats by wiring DriveManager health checks into cluster heartbeat messages
adds clustered policies directory initialization and exposes policy storage paths from the distributed coordinator
extends distributed coordinator support for remote shard read and delete operations plus multipart upload session metadata
2026-03-21 - 6.1.0 - feat(cluster)
add clustered storage backend with QUIC transport, erasure coding, and shard management
introduces cluster configuration in Rust and TypeScript, including seed nodes, drive paths, heartbeat settings, and erasure coding options
adds core cluster modules for membership, topology state, object manifests, placement, shard storage, drive management, healing scaffolding, and inter-node protocol handling
adds QUIC-based transport for cluster communication and integrates a distributed storage backend alongside the existing standalone FileStore
updates the server startup path to initialize standalone or clustered storage based on configuration and exposes a basic clusterStatus management endpoint
refreshes build and dependency versions to support the new clustered storage implementation
2026-03-14 - 6.0.1 - fix(rust-bridge)
update smartrust and limit RustBridge binary lookup to dist_rust
Bumps @push.rocks/smartrust from ^1.0.0 to ^1.3.2.
Removes rust target debug and release fallback paths from RustBridge local binary resolution, relying on dist_rust/ruststorage.
2026-03-14 - 6.0.0 - BREAKING CHANGE(core)
Rebrand from smarts3 to smartstorage
Package renamed from @push.rocks/smarts3 to @push.rocks/smartstorage
Class renamed from Smarts3 to SmartStorage (no backward-compatible re-export)
Interface renamed from ISmarts3Config to ISmartStorageConfig
Method renamed from getS3Descriptor to getStorageDescriptor
Rust binary renamed from rusts3 to ruststorage
Rust types renamed: S3Error→StorageError, S3Action→StorageAction, S3Config→SmartStorageConfig, S3Server→StorageServer
On-disk file extension changed from ._S3_object to ._storage_object (BREAKING for existing stored data)
Default credentials changed from S3RVER to STORAGE
All internal S3 branding removed; AWS S3 protocol compatibility (IAM actions, ARNs, SigV4) fully maintained
2026-02-17 - 5.3.0 - feat(auth)
add AWS SigV4 authentication and bucket policy support
Implement AWS SigV4 full verification (constant-time comparison, 15-minute clock skew enforcement) and expose default signing region (server.region = 'us-east-1').
Add IAM-style bucket policy engine with Put/Get/Delete policy APIs (GetBucketPolicy/PutBucketPolicy/DeleteBucketPolicy), wildcard action/resource matching, Allow/Deny evaluation, and on-disk persistence under .policies/{bucket}.policy.json.
Documentation and README expanded with policy usage, examples, API table entries, and notes about policy CRUD and behavior for anonymous/authenticated requests.
Rust code refactors: simplify storage/server result structs and multipart handling (removed several unused size/key/bucket fields), remove S3Error::to_response and error_xml helpers, and other internal cleanup to support new auth/policy features.
2026-02-17 - 5.2.0 - feat(auth,policy)
add AWS SigV4 authentication and S3 bucket policy support
Implemented real AWS SigV4 verification (HMAC-SHA256), including x-amz-date handling, clock skew enforcement and constant-time signature comparison
Added bucket policy model, validator and evaluation engine (Deny > Allow > NoOpinion) with a PolicyStore (RwLock cache + disk-backed .policies/*.policy.json)
Integrated action resolution and auth+policy pipeline into the HTTP server: authorization checks run per-request, anonymous requests are denied by default, ListAllMyBuckets requires authentication
Added bucket policy CRUD handlers via ?policy query parameter (GET/PUT/DELETE) and cleanup of policies on bucket deletion
Storage and config updates: created .policies dir and policy path helpers; default region added to server config (TS + Rust)
Added comprehensive tests for auth and policy behavior (policy CRUD, evaluation, per-action enforcement, auth integration)
Updated Rust dependencies and Cargo.toml/Cargo.lock to include hmac, sha2, hex, subtle, cpufeatures
2026-02-13 - 5.1.1 - fix(smarts3)
replace TypeScript server with Rust-powered core and IPC bridge
Major refactor: Node.js/TypeScript in-process server replaced by a Rust crate ('rusts3') with a TypeScript IPC wrapper (RustBridge).
Removed many TypeScript server modules (smarts3-server, filesystem-store, multipart-manager, controllers, router, context, logger, xml utils, etc.); Smarts3Server export removed — public API now proxies to the Rust binary.
Smarts3 now spawns and communicates with the rusts3 binary via RustBridge IPC (commands include start, stop, createBucket).
Build & packaging changes: build script now runs 
tsrust before 
tsbuild; added 
@git.zone/tsrust devDependency; added 
dist_rust artifacts and new cross-compile targets in npmextra.json; .gitignore updated for rust/target.
Dependency changes: added 
@push.rocks/smartrust (RustBridge) and simplified plugins surface; previous smartfs/smartxml usage removed from TS code and replaced by the Rust implementation + IPC.
Added Rust project files (rust/Cargo.toml, rust/src/*) implementing server, IPC management loop, storage, XML responses, errors, and config.
Documentation updated (README and hints) to describe the Rust core, supported prebuilt targets (linux_amd64, linux_arm64), IPC commands, and developer build notes.
2025-11-23 - 5.1.0 - feat(multipart)
Implement full multipart upload support with persistent manager, periodic cleanup, and API integration
Add IMultipartConfig to server config with defaults (expirationDays: 7, cleanupIntervalMinutes: 60) and merge into existing config flow
Introduce MultipartUploadManager: persistent upload metadata on disk, part upload/assembly, restore uploads on startup, listParts/listUploads, abort/cleanup functionality
Start and stop multipart cleanup task from Smarts3Server lifecycle (startCleanupTask on start, stopCleanupTask on stop) with configurable interval and expiration
ObjectController: support multipart endpoints (initiate, upload part, complete, abort) and move assembled final object into the object store on completion; set ETag headers and return proper XML responses
BucketController: support listing in-progress multipart uploads via ?uploads query parameter and return S3-compatible XML
Persist multipart state to disk and restore on initialization to survive restarts; perform automatic cleanup of expired uploads
2025-11-23 - 5.0.2 - fix(readme)
Clarify contribution agreement requirement in README
Updated the Issue Reporting and Security section in readme.md to make it explicit that developers must sign and comply with the contribution agreement (and complete identification) before obtaining a code.foss.global account to submit pull requests.
2025-11-23 - 5.0.1 - fix(docs)
Clarify README wording about S3 compatibility and AWS SDK usage
Update README wording to "Full S3 API compatibility" and clarify it works seamlessly with AWS SDK v3 and other S3 clients
2025-11-23 - 5.0.0 - BREAKING CHANGE(core)
Production-ready S3-compatible server: nested config, multipart uploads, CORS, structured logging, SmartFS migration and improved error handling
Breaking change: configuration format migrated from flat to nested structure (server, storage, auth, cors, logging, limits). Update existing configs accordingly.
Implemented full multipart upload support (initiate, upload part, complete, abort) with on-disk part management and final assembly.
Added CORS middleware with configurable origins, methods, headers, exposed headers, maxAge and credentials support.
Structured, configurable logging (levels: error|warn|info|debug; formats: text|json) and request/response logging middleware.
Simple static credential authentication middleware (configurable list of credentials).
Migrated filesystem operations to @push.rocks/smartfs (Web Streams interoperability) and removed smartbucket from production dependencies.
Improved S3-compatible error handling and XML responses (S3Error class and XML utilities).
Exposed Smarts3Server and made store/multipart managers accessible for tests and advanced usage; added helper methods like getS3Descriptor and createBucket.
2025-11-23 - 4.0.0 - BREAKING CHANGE(Smarts3)
Migrate Smarts3 configuration to nested server/storage objects and remove legacy flat config support
Smarts3.createAndStart() and Smarts3 constructor now accept ISmarts3Config with nested 
server and 
storage objects.
Removed support for the legacy flat config shape (top-level 
port and 
cleanSlate) / ILegacySmarts3Config.
Updated tests to use new config shape (server:{ port, silent } and storage:{ cleanSlate }).
mergeConfig and Smarts3Server now rely on the nested config shape; consumers must update their initialization code.
2025-11-23 - 3.2.0 - feat(multipart)
Add multipart upload support with MultipartUploadManager and controller integration
Introduce MultipartUploadManager (ts/classes/multipart-manager.ts) to manage multipart upload lifecycle and store parts on disk
Wire multipart manager into server and request context (S3Context, Smarts3Server) and initialize multipart storage on server start
Add multipart-related routes and handlers in ObjectController: initiate (POST ?uploads), upload part (PUT ?partNumber&uploadId), complete (POST ?uploadId), and abort (DELETE ?uploadId)
On complete, combine parts into final object and store via existing FilesystemStore workflow
Expose multipart manager on Smarts3Server for controller access
2025-11-23 - 3.1.0 - feat(logging)
Add structured Logger and integrate into Smarts3Server; pass full config to server
Introduce a new Logger class (ts/classes/logger.ts) providing leveled logging (error, warn, info, debug), text/json formats and an enable flag.
Integrate Logger into Smarts3Server: use structured logging for server lifecycle events, HTTP request/response logging and S3 errors instead of direct console usage.
Smarts3 now passes the full merged configuration into Smarts3Server (config.logging can control logging behavior).
Server start/stop messages and internal request/error logs are emitted via the Logger and respect the configured logging level/format and silent option.
2025-11-23 - 3.0.4 - fix(smarts3)
Use filesystem store for bucket creation and remove smartbucket runtime dependency
Switched createBucket to call the internal FilesystemStore.createBucket instead of using @push.rocks/smartbucket
Made Smarts3Server.store public so Smarts3 can access the filesystem store directly
Removed runtime import/export of @push.rocks/smartbucket from plugins and moved @push.rocks/smartbucket to devDependencies in package.json
Updated createBucket to return a simple { name } object after creating the bucket via the filesystem store
2025-11-23 - 3.0.3 - fix(filesystem)
Migrate filesystem implementation to @push.rocks/smartfs and add Web Streams handling
Replace dependency @push.rocks/smartfile with @push.rocks/smartfs and update README references
plugins: instantiate SmartFs with SmartFsProviderNode and export smartfs (remove direct fs export)
Refactor FilesystemStore to use smartfs directory/file APIs for initialize, reset, list, read, write, copy and delete
Implement Web Stream ↔ Node.js stream conversion for uploads/downloads (Readable.fromWeb and writer.write with Uint8Array)
Persist and read metadata (.metadata.json) and cached MD5 (.md5) via smartfs APIs
Update readme.hints and documentation to note successful migration and next steps
2025-11-21 - 3.0.2 - fix(smarts3)
Prepare patch release 3.0.2 — no code changes detected
No source changes in the diff
Bump patch version from 3.0.1 to 3.0.2 for maintenance/release bookkeeping
2025-11-21 - 3.0.1 - fix(readme)
Add Issue Reporting and Security section to README
Add guidance to report bugs, issues, and security vulnerabilities via community.foss.global
Inform developers how to sign a contribution agreement and get a code.foss.global account to submit pull requests
2025-11-21 - 3.0.0 - BREAKING CHANGE(Smarts3)
Remove legacy s3rver backend, simplify Smarts3 server API, and bump dependencies
Remove legacy s3rver backend: s3rver and its types were removed from dependencies and are no longer exported from plugins.
Simplify Smarts3 API: removed useCustomServer option; Smarts3 now always uses the built-in Smarts3Server (s3Instance is Smarts3Server) and stop() always calls Smarts3Server.stop().
Update README to remove legacy s3rver compatibility mention.
Dependency updates: bumped @push.rocks/smartbucket to ^4.3.0 and @push.rocks/smartxml to ^2.0.0 (major upgrades), removed s3rver/@types/s3rver, bumped @aws-sdk/client-s3 to ^3.937.0 and @git.zone/tstest to ^3.1.0.
2025-11-21 - 2.3.0 - feat(smarts3-server)
Introduce native custom S3 server implementation (Smarts3Server) with routing, middleware, context, filesystem store, controllers and XML utilities; add SmartXml and AWS SDK test; keep optional legacy s3rver backend.
Add Smarts3Server: native, Node.js http-based S3-compatible server (ts/classes/smarts3-server.ts)
New routing and middleware system: S3Router and MiddlewareStack for pattern matching and middleware composition (ts/classes/router.ts, ts/classes/middleware-stack.ts)
Introduce request context and helpers: S3Context for parsing requests, sending responses and XML (ts/classes/context.ts)
Filesystem-backed storage: FilesystemStore with bucket/object operations, streaming uploads, MD5 handling and Windows-safe key encoding (ts/classes/filesystem-store.ts)
S3 error handling: S3Error class that maps S3 error codes and produces XML error responses (ts/classes/s3-error.ts)
Controllers for service, bucket and object operations with S3-compatible XML responses and copy/range support (ts/controllers/*.ts)
XML utilities and SmartXml integration for consistent XML generation/parsing (ts/utils/xml.utils.ts, ts/plugins.ts)
Expose native plugins (http, crypto, url, fs) and SmartXml via plugins.ts
ts/index.ts: add useCustomServer option, default to custom server, export Smarts3Server and handle start/stop for both custom and legacy backends
Add AWS SDK v3 integration test (test/test.aws-sdk.node.ts) to validate compatibility
package.json: add @aws-sdk/client-s3 devDependency and @push.rocks/smartxml dependency
Documentation: readme.md updated to describe native custom server and legacy s3rver compatibility
2025-11-20 - 2.2.7 - fix(core)
Update dependencies, code style and project config; add pnpm overrides and ignore AI folders
Bump devDependencies and runtime dependencies (@git.zone/, @push.rocks/, @tsclass/tsclass, s3rver) to newer compatible versions
Add pnpm.overrides entry to package.json and normalize repository URL format
Code style and formatting fixes in TypeScript sources (ts/index.ts, ts/00_commitinfo_data.ts): whitespace, trailing commas, parameter formatting and minor API-return typing preserved
tsconfig.json: simplify compiler options and compact exclude list
Update .gitignore to add AI-related folders (.claude/, .serena/) to avoid accidental commits
Documentation and changelog formatting tweaks (readme.md, changelog.md, npmextra.json) — whitespace/newline cleanups and expanded changelog entries
2025-08-16 - 2.2.6 - fix(Smarts3)
Allow overriding S3 descriptor; update dependencies, test config and documentation
ts/index.ts: getS3Descriptor now accepts an optional Partial<IS3Descriptor> to override defaults (backwards compatible)
package.json: updated devDependencies and runtime dependency versions (tstest, smartpath, tsclass, s3rver, etc.) and added packageManager field
package.json: expanded test script to run tstest with --web --verbose --logfile --timeout 60
test/test.ts: test instance port changed to 3333
readme.md: major rewrite and expansion of usage examples, API reference and guides
added project config files: .claude/settings.local.json and .serena/project.yml
2024-11-06 - 2.2.5 - fix(ci)
Corrected docker image URLs in Gitea workflows to match the correct domain format.
Updated IMAGE environment variable in .gitea/workflows/default_nottags.yaml
Updated IMAGE environment variable in .gitea/workflows/default_tags.yaml
2024-11-06 - 2.2.4 - fix(core)
Improve code style and update dependencies
Updated @push.rocks/tapbundle to version ^5.4.3 in package.json.
Fixed markdown formatting in readme.md.
Improved code consistency in ts/00_commitinfo_data.ts, ts/plugins.ts, and test/test.ts.
2024-11-06 - 2.2.3 - fix(core)
Fix endpoint address from 'localhost' to '127.0.0.1' for better compatibility in Smarts3.getS3Descriptor
Corrected the endpoint address in Smarts3.getS3Descriptor to ensure proper functioning across different environments.
2024-11-06 - 2.2.2 - fix(core)
Fixed function call for fastPut in the test suite to ensure proper file upload handling.
Updated dependencies in package.json to newer versions.
Corrected the function call in test suite for file upload.
2024-10-26 - 2.2.1 - fix(core)
Fix import and typings for improved compatibility
Corrected the type signature for 
getS3Descriptor to return 
IS3Descriptor.
Fixed import structure and updated dependencies for consistent namespace usage across plugins.
2024-10-26 - 2.2.0 - feat(ci)
Migrate CI/CD workflow from GitLab CI to Gitea CI
Added new Gitea CI workflows for both non-tag and tag-based pushes
Removed existing GitLab CI configuration
2024-05-29 - 2.1.1 - Updates and minor changes
Updates and changes based on minor configuration improvements and organizational shifts.
Updated description file.
Updated tsconfig settings.
Updated npmextra.json with new githost configuration.
Shifted to new organizational scheme.
2022-07-30 - 2.1.0 - Core improvements and fixes
Minor improvements and important core changes.
Removed tslint from the core setup.
2022-07-30 - 2.0.2 - Bucket creation improvement
Enhanced file structure management.
Improved bucket creation to store locally within the .nogit directory.
2022-04-14 - 2.0.0 to 2.0.1 - Structural updates and fixes
This release focused on core updates and structural changes.
Reformatted the project structure.
Core updates with minor fixes.
2021-12-20 - 1.0.10 - ESM Transition
Breaking changes and minor fixes, transitioning to ES Modules.
BREAKING CHANGE: Transitioned core setup to ESM.