smartnpm/changelog.md

# Changelog

## 2025-08-18 - 2.0.6 - fix(readme)
Expand README with detailed usage examples, API reference and features; add local assistant settings

- Expanded README.md: added badges, features list, installation instructions (including pnpm), quick start, detailed usage examples (package info, search, download, extraction, version management, virtual directory), caching info, API reference, and common use cases.
- Added .claude/settings.local.json to define local assistant permissions

## 2025-08-18 - 2.0.5 - fix(smartnpm)
Fix file extraction & streaming, types and caching; update deps and CI; skip flaky tests

- Replace deprecated smartarchive APIs: use SmartArchive.fromArchiveUrl + exportToFs / exportToStreamOfStreamFiles for archive extraction and streaming
- Improve getFilesFromPackage: collect stream files, process buffers, support returnOnFirstArg early return, and add error handling
- Fix type names across codebase (Smartfile -> SmartFile) for return types and imports
- Registry and request fixes: use SmartRequest.create().url(...).get() and response.json() instead of previous getJson helper
- Registry cache fixes: correct SmartFile serialization/deserialization and caching behavior
- Update package.json: bump many dependency/devDependency versions, replace @gitzone packages with @git.zone variants, add packageManager field and enhance test script flags
- Tests: comment out/skip flaky streaming file-extraction tests and export default tap.start() to stabilize test runs
- CI/workflow and tooling: update .gitea workflow tsdoc installer path, add pnpm-workspace.yaml, .claude permissions and Serena project configuration

## 2024-05-29 - 2.0.4 - packaging & build
Packaging and build metadata updates for the 2.0.4 line.

- Update package description.
- Update TypeScript configuration (tsconfig).
- Update npmextra.json githost (packaging metadata updates applied across April 2024).

## 2023-07-10 - 2.0.3 - org migration
Repository re-organization and small maintenance changes preparing the 2.x line.

- Switched to new organization scheme.
- Minor core updates and cleanup related to the org migration.

## 2022-06-09 - 2.0.3 - 2.0.x maintenance (2.0.0 → 2.0.3)
2.0.0 major release followed by maintenance updates in the 2.0.x series.

- 2.0.0 released with subsequent fixes in 2.0.1–2.0.3.
- Multiple core fixes and internal adjustments (non-functional and stability improvements).

## 2022-04-13 - 1.0.40 - 1.0.x maintenance (2018-11-07 → 2022-04-13)
Accumulated maintenance across the 1.0.x series: test fixes, small fixes and routine updates.

- Test fixes and stability improvements (including 1.0.39).
- General core maintenance and minor updates across 1.0.10–1.0.40.

## 2021-05-06 - 1.0.31 - bugfix (version matching)
Fix addressing package version-matching edge cases.

- Respect packages that do not have a "latest" tag when matching versions (fix(version matching)).

## 2018-09-01 - 1.0.7 - CI & dependency updates
Improvements to CI and dependency management.

- Update CI build configuration (fix(CI): update CI build).
- Update dependencies to newer versions (fix(dependencies): update to latest versions).

## 2018-02-14 - 1.0.5 - CI and offline robustness
CI improvements and fixes for offline usage.

- Update CI scripts/config (update ci).
- Prevent failures in offline mode (update to not fail in offline mode).

## 2017-08-16 - 1.0.3 - initial features & docs
Early feature additions and documentation.

- Added beautycolor dependency (1.0.3).
- Added README (1.0.2).
- Improvements to search and other initial fixes (1.0.1).