smartarchive/readme.hints.md

Smartarchive Development Hints

Dependency Upgrades (2025-01-25)

Completed Upgrades

• @git.zone/tsbuild: ^2.6.6 → ^3.1.0
• @git.zone/tsrun: ^1.3.3 → ^2.0.0
• @git.zone/tstest: ^2.3.4 → ^3.1.3
• @push.rocks/smartfile: ^11.2.7 → ^13.0.0

Migration Notes

Smartfile v13 Migration

Smartfile v13 removed filesystem operations (fs, memory, fsStream namespaces). These were replaced with Node.js native fs and fs/promises:

Replacements made:

• smartfile.fs.ensureDir(path) → fsPromises.mkdir(path, { recursive: true })
• smartfile.fs.stat(path) → fsPromises.stat(path)
• smartfile.fs.toReadStream(path) → fs.createReadStream(path)
• smartfile.fs.toStringSync(path) → fsPromises.readFile(path, 'utf8')
• smartfile.fs.listFileTree(dir, pattern) → custom listFileTree() helper
• smartfile.fsStream.createReadStream(path) → fs.createReadStream(path)
• smartfile.fsStream.createWriteStream(path) → fs.createWriteStream(path)
• smartfile.memory.toFs(content, path) → fsPromises.writeFile(path, content)

Still using from smartfile v13:

• SmartFile class (in-memory file representation)
• StreamFile class (streaming file handling)

Removed Dependencies

• through@2.3.8 - was unused in the codebase

Architecture Notes

• Uses fflate for ZIP/GZIP compression (pure JS, works in browser)
• Uses tar-stream for TAR archive handling
• Uses file-type for MIME type detection
• Custom BZIP2 implementation in ts/bzip2/ directory