neozip-cli 0.75.2-beta → 0.90.0

package/CHANGELOG.md

@@ -5,6 +5,84 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+**Release notes** for each version are documented here (not in a separate “what’s new” file).
+
+## [0.90.0] - 2026-03-18
+
+### Added
+
+- **Full AES-256 encryption support** — create, list, and extract password-protected archives with WinZip-compatible AES-256 (default) or legacy PKZIP encryption.
+
+#### Creating encrypted archives
+
+- **AES-256 (default)** — use `-e` / `--encrypt` or `--aes256`.
+
+  ```bash
+  neozip -e secure.nzip file.txt
+  neozip -e -P "mypassword" secure.nzip file.txt
+  neozip --aes256 -P "mypassword" secure.nzip file.txt folder/
+  ```
+
+- **Legacy PKZIP** — use `--pkzip` or `--pkzip-encrypt` only for older-tool compatibility (weak; prefer AES-256 for sensitive data).
+
+  ```bash
+  neozip --pkzip -P "mypassword" legacy.nzip file.txt
+  ```
+
+#### Listing encrypted archives
+
+- **neolist** lists contents; filenames are visible without a password. Encryption method (AES-256 or PKZIP) is shown where applicable. Extraction requires the password.
+
+#### Extracting encrypted archives
+
+- **neounzip** auto-detects AES-256 vs PKZIP. Use `-P` / `--password`.
+
+  ```bash
+  neounzip -P "mypassword" secure.nzip output/
+  neounzip --in-memory -P "mypassword" secure.nzip output/
+  ```
+
+- Wrong password yields a clear error (e.g. bad password / decryption failed).
+
+#### Compatibility
+
+- **AES-256**: WinZip, 7-Zip, and other tools supporting ZIP AES extension (AE-2).
+- **PKZIP** (ZipCrypto): create/extract legacy archives only.
+
+#### Encryption options summary
+
+| Command   | Option             | Effect |
+|-----------|--------------------|--------|
+| neozip    | `-e`, `--encrypt`  | AES-256 (default); prompt if no `-P` |
+| neozip    | `--aes256`         | Explicit AES-256 |
+| neozip    | `--pkzip`          | Legacy PKZIP encryption |
+| neozip    | `-P`, `--password`| Encryption password |
+| neounzip  | `-P`, `--password` | Decryption password (AES-256/PKZIP auto-detected) |
+| neounzip  | `--pkzip-decrypt`  | Force legacy PKZip 2.0 decryption |
+
+See [README.md](README.md) and [DOCUMENTATION.md](DOCUMENTATION.md) for more examples.
+
+---
+
+## [0.80.0] - 2026-03-04
+
+### Added
+
+- **Zipstamp (blockchain timestamping)**
+  - Display Zipstamp server URL when submitting timestamp proof (configurable via `ZIPSTAMP_SERVER_URL`)
+  - `neozip verify-email` command and npm script for Zipstamp email configuration
+  - Post-mint summary after `neozip mint`: status, token ID, network, contract, transaction, block, and block timestamp (minted) in the same style as Zipstamp verification
+- **Scripts**
+  - `scripts/remove-env-from-history.sh` to remove `.env.local` and `.env.local.rem` from git history (see `scripts/README.md`)
+- **Configuration**
+  - `neozip config` and `neozip init` work when run via ts-node (fixed dynamic import resolution for `.ts` vs `.js`)
+
+### Fixed
+
+- `neozip config` / `neozip init` no longer fail with "Cannot find module './config/ConfigSetup.js'" when run via `yarn neozip-config` or ts-node
+
+---
+
 ## [0.70.0-alpha] - 2025-11-21
 
 ### ⚠️ Alpha Release Notice

package/DOCUMENTATION.md

@@ -17,7 +17,7 @@ npm install -g neozip-cli@alpha
 neozip archive.nzip file1.txt file2.txt folder/
 
 # Extract files from archive
-neounzip archive.nzip extracted/
+neounzip archive.nzip tests/extracted/
 
 # List archive contents
 neolist archive.nzip
@@ -47,11 +47,9 @@ neolist --help     # Show listing help
   - NeoZip ecosystem overview
   - Technical innovations
 
-- **[CHANGELOG.md](CHANGELOG.md)** - Version history
-  - Release notes
-  - Feature additions
-  - Known limitations
-  - Breaking changes
+- **[CHANGELOG.md](CHANGELOG.md)** - Version history and release notes
+  - Detailed changes per version (including feature guides, e.g. AES-256 in v0.90.0)
+  - Known limitations and breaking changes
 
 - **[env.example](env.example)** - Environment variable configuration
   - Wallet configuration
@@ -98,10 +96,15 @@ neolist --help     # Show listing help
   - No compression (fastest)
   - Useful for already-compressed files
 
-- **PKZIP Encryption**
-  - Legacy encryption for maximum compatibility
+- **AES-256 Encryption** (default, recommended)
+  - Strong WinZip-compatible AES-256 encryption
   - Password-protected archives
-  - InfoZip-compatible encrypted archives
+  - Compatible with WinZip, 7-Zip, and other AES-capable tools
+
+- **PKZIP Encryption** (legacy)
+  - Traditional encryption for maximum compatibility
+  - Use `--pkzip` flag to select
+  - Not recommended for sensitive data
 
 ### Blockchain Features
 
@@ -116,6 +119,11 @@ neolist --help     # Show listing help
   - Cryptographic proof of archive existence
   - Timestamp verification
 
+- **Zipstamp**
+  - Ethereum blockchain timestamping via Zipstamp server
+  - Pending timestamps (TS-SUBMIT.NZIP) can be upgraded to confirmed (TIMESTAMP.NZIP)
+  - Use `neozip upgrade <archive> [output] [--wait]` to upgrade pending timestamps
+
 - **Wallet Integration**
   - Interactive wallet setup wizard (`neozip init`)
   - Configuration management (`neozip config`)
@@ -144,6 +152,9 @@ neozip init
 
 # View or modify configuration
 neozip config
+
+# Upgrade pending Zipstamp timestamp to confirmed
+neozip upgrade archive.nzip [output.nzip] [--wait]
 ```
 
 Configuration is stored in `~/.neozip/wallet.json` and supports:

package/README.md

@@ -6,9 +6,9 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js Version](https://img.shields.io/badge/node-%3E%3D16.0.0-brightgreen)](https://nodejs.org/)
 
-## ⚠️ Beta Release Notice
+## Release Notice
 
-**This is a beta release (v0.75.0-beta).** This software is in active development and may contain bugs or incomplete features. While more stable than alpha releases, please use with caution in production environments.
+**Current version: v0.90.0.** This release adds full AES-256 encryption support. See [CHANGELOG.md](CHANGELOG.md) for details.
 
 - **API Stability**: Command-line interface is becoming more stable but may still change
 - **Testing**: Please test thoroughly and report any issues
@@ -21,7 +21,7 @@ NeoZip CLI is a modern, full-featured ZIP utility that provides:
 - **Standard ZIP Compatibility**: ~99% compatible with InfoZip utilities
 - **Blockchain Integration**: Tokenize archives and verify integrity on-chain
 - **Advanced Compression**: Zstd, Deflate, and Store compression methods
-- **Encryption Support**: PKZIP encryption
+- **Encryption Support**: AES-256 (default) and PKZIP encryption
 - **Cross-Platform**: Works on macOS, Linux, and Windows
 
 ## Features
@@ -42,13 +42,15 @@ NeoZip CLI is a modern, full-featured ZIP utility that provides:
 - Compression levels: 0-9 (0=store, 9=best compression)
 
 ### Encryption
-- **PKZIP**: Legacy encryption (maximum compatibility)
+- **AES-256**: Strong encryption (default, recommended)
+- **PKZIP**: Legacy encryption (for compatibility only)
 - Password-protected archives
-- InfoZip-compatible encrypted archives
+- Auto-detection of encryption method during extraction
 
 ### Blockchain Features
 - **Tokenization**: Create on-chain tokens for archives
 - **OpenTimestamp**: Bitcoin blockchain timestamping
+- **Zipstamp**: Ethereum blockchain timestamping (Zipstamp server)
 - **Integrity Verification**: Verify archive integrity on-chain
 - **Network Support**: Base Sepolia, Base Mainnet, Arbitrum, and more
 
@@ -69,10 +71,10 @@ NeoZip CLI is a modern, full-featured ZIP utility that provides:
 - Node.js 16.0.0 or higher
 - npm or yarn package manager
 
-### Install from npm (Beta Release)
+### Install from npm
 
 ```bash
-npm install -g neozip-cli@beta
+npm install -g neozip-cli
 ```
 
 After installation, the following commands will be available:
@@ -103,7 +105,7 @@ neozip -r archive.nzip ./project/
 neozip -b tokenized.nzip file1.txt file2.txt
 
 # Extract files from archive
-neounzip archive.nzip extracted/
+neounzip archive.nzip tests/extracted/
 
 # Extract and verify tokenized archive
 neounzip -t tokenized.nzip
@@ -137,14 +139,20 @@ neozip -0 output.nzip ./src/
 ### Encryption Examples
 
 ```bash
-# Create encrypted archive (will prompt for password)
+# Create AES-256 encrypted archive (default, will prompt for password)
 neozip -e secure.nzip file.txt
 
-# Create encrypted archive with password
+# Create AES-256 encrypted archive with password
 neozip -e -P "mypassword" secure.nzip file.txt
 
-# Extract encrypted archive
-neounzip -P "mypassword" secure.nzip extracted/
+# Explicitly use AES-256
+neozip --aes256 -P "mypassword" secure.nzip file.txt
+
+# Use legacy PKZIP encryption (weak, for compatibility only)
+neozip --pkzip -P "mypassword" legacy.nzip file.txt
+
+# Extract encrypted archive (auto-detects AES-256 or PKZIP)
+neounzip -P "mypassword" secure.nzip tests/extracted/
 ```
 
 ### Blockchain Examples
@@ -153,11 +161,17 @@ neounzip -P "mypassword" secure.nzip extracted/
 # Tokenize archive on Base Sepolia (default)
 neozip -b tokenized.nzip file.txt
 
-# Tokenize with OpenTimestamp proof
+# Tokenize with OpenTimestamp proof (Bitcoin)
 neozip -ots timestamped.nzip file.txt
 
+# Create Zipstamp timestamp (Ethereum)
+neozip -ts zipstamp.nzip file.txt
+
+# Upgrade pending Zipstamp timestamp to confirmed
+neozip upgrade zipstamp.nzip [output.nzip] [--wait]
+
 # Extract and verify blockchain integrity
-neounzip tokenized.nzip extracted/
+neounzip tokenized.nzip tests/extracted/
 ```
 
 ## Commands
@@ -176,10 +190,14 @@ neozip [options] <archive> [files...]
 - `-0` to `-9` - Compression level (0=store, 9=best)
 - `-x, --exclude <pattern>` - Exclude files matching pattern
 - `-i, --include <pattern>` - Include only matching files
-- `-e, --encrypt` - Encrypt files (will prompt for password)
+- `-e, --encrypt` - Encrypt files with AES-256 (default, will prompt for password)
 - `-P, --password <pwd>` - Encrypt with password
+- `--aes256` - Use AES-256 encryption (default, recommended)
+- `--pkzip` - Use legacy PKZIP encryption (weak, for compatibility only)
 - `-b, --blockchain` - Enable blockchain tokenization
-- `-ots, --opentimestamp` - Enable OpenTimestamp proof
+- `-ots, --opentimestamp` - Enable OpenTimestamp proof (Bitcoin)
+- `-ts, --timestamp` - Enable Zipstamp timestamp (Ethereum)
+- `--timestamp-email <email>` - Email for Zipstamp server (some servers require verified email)
 - `-T, --test-integrity` - Test archive after creation
 - `-v, --verbose` - Enable verbose output
 - `-q, --quiet` - Suppress output
@@ -187,7 +205,8 @@ neozip [options] <archive> [files...]
 **Configuration Commands:**
 ```bash
 neozip init      # Interactive wallet setup wizard
-neozip config     # Show current configuration
+neozip config    # Show current configuration
+neozip upgrade <archive> [output] [--wait]  # Upgrade pending Zipstamp timestamp to confirmed
 ```
 
 **Examples:**
@@ -222,7 +241,7 @@ neounzip [options] <archive> [output]
 - `-o, --overwrite` - Overwrite files without prompting
 - `-t, --test` - Test archive integrity
 - `-l, --list` - List contents without extracting
-- `-P, --password <pwd>` - Password for encrypted archives
+- `-P, --password <pwd>` - Password for encrypted archives (AES-256 and PKZIP auto-detected)
 - `-x, --exclude <pattern>` - Exclude files from extraction
 - `-i, --include <pattern>` - Include only matching files
 - `-j, --junk-paths` - Extract files without directory structure
@@ -235,16 +254,16 @@ neounzip [options] <archive> [output]
 neounzip archive.nzip
 
 # Extract to specific directory
-neounzip archive.nzip ./extracted/
+neounzip archive.nzip tests/extracted/
 
 # Test archive integrity
 neounzip -t archive.nzip
 
 # Extract with exclusions
-neounzip -x "*.log" archive.nzip extracted/
+neounzip -x "*.log" archive.nzip tests/extracted/
 
 # Extract encrypted archive
-neounzip --password "mypassword" secure.nzip extracted/
+neounzip --password "mypassword" secure.nzip tests/extracted/
 ```
 
 ### `neolist` - List Archive Contents
@@ -303,6 +322,8 @@ You can also configure via environment variables:
 ```bash
 export NEOZIP_WALLET_PASSKEY="your-wallet-key"
 export NEOZIP_NETWORK="base-sepolia"  # or base-mainnet, arbitrum-sepolia, etc.
+export ZIPSTAMP_SERVER_URL="https://zipstamp-dev.neozip.io"  # Zipstamp server (optional)
+export NEOZIP_TIMESTAMP_EMAIL="your@email.com"  # Email for Zipstamp (some servers require verified email)
 ```
 
 ### Configuration File
@@ -329,7 +350,7 @@ neozip project.nzip src/ docs/ README.md
 neolist project.nzip
 
 # Extract files
-neounzip project.nzip extracted/
+neounzip project.nzip tests/extracted/
 
 # Test integrity
 neounzip -t project.nzip
@@ -364,10 +385,13 @@ neozip -r -x "node_modules" -x "*.log" project.nzip ./
 ### Encryption
 
 ```bash
-# Create encrypted archive
+# Create AES-256 encrypted archive (default)
 neozip -e -P "secure-password" secret.nzip sensitive-files/
 
-# Extract encrypted archive
+# Create legacy PKZIP encrypted archive
+neozip --pkzip -P "secure-password" legacy.nzip sensitive-files/
+
+# Extract encrypted archive (auto-detects encryption method)
 neounzip -P "secure-password" secret.nzip decrypted/
 ```
 
@@ -467,19 +491,19 @@ neozip init
 # Verify password is correct
 neounzip -P "your-password" archive.nzip
 
-# Try different encryption method
-neozip --pkzip-encrypt -P "password" archive.nzip files/
+# Use legacy PKZIP if AES-256 is not supported by target tool
+neozip --pkzip -P "password" archive.nzip files/
 ```
 
 ## Contributing
 
-We welcome feedback and contributions! Since this is a beta release, we're actively seeking input:
+We welcome feedback and contributions:
 
 1. **Report Issues**: Use [GitHub Issues](https://github.com/NeoWareInc/neozip-support/issues) or email [support@neozip.io](mailto:support@neozip.io)
 2. **Suggest Features**: Share your ideas and use cases
 3. **Test and Provide Feedback**: Help us improve by testing and reporting your experience
 
-**Important**: This is a beta release. API and behavior may still change. Please test thoroughly.
+**Important**: Please test thoroughly and report issues. See [CHANGELOG.md](CHANGELOG.md) for version history.
 
 ## License
 
@@ -499,6 +523,6 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ---
 
-**Version**: 0.75.0-beta  
-**Status**: Beta Release  
-**Last Updated**: December 26, 2025
+**Version**: 0.90.0
+**Status**: Release (see [CHANGELOG.md](CHANGELOG.md) for latest changes)
+**Last Updated**: March 18, 2026