default
Nagare (流れ) is a comprehensive release management library for JavaScript/TypeScript projects that automates version bumping, changelog generation, and GitHub releases using conventional commits and semantic versioning.
Additional export configuration for version files
Built-in file handlers for common project files
Bump types for version increments
ChangelogGenerator - CHANGELOG.md management with PR awareness
Commit type to changelog section mapping
Default configuration - UPDATED with safer patterns
Type for error code values
Standard error codes for common Nagare errors
- CONFIG_INVALID
- CONFIG_MISSING_REQUIRED
- CONFIG_NOT_FOUND
- DEPENDENCY_NOT_FOUND
- FILE_HANDLER_NOT_FOUND
- FILE_JSON_INVALID
- FILE_NOT_FOUND
- FILE_PATTERN_NO_MATCH
- FILE_UPDATE_FAILED
- GITHUB_AUTH_FAILED
- GITHUB_CLI_NOT_FOUND
- GITHUB_RELEASE_FAILED
- GIT_NOT_INITIALIZED
- GIT_NO_COMMITS
- GIT_REMOTE_ERROR
- GIT_TAG_EXISTS
- GIT_UNCOMMITTED_CHANGES
- GIT_USER_NOT_CONFIGURED
- OPERATION_CANCELLED
- PERMISSION_DENIED
- RELEASE_FAILED
- SECURITY_EMPTY_GIT_REF
- SECURITY_GIT_TAG_TOO_LONG
- SECURITY_INVALID_CLI_ARG_TYPE
- SECURITY_INVALID_COMMIT_HASH
- SECURITY_INVALID_FILE_PATH
- SECURITY_INVALID_GIT_REF
- SECURITY_INVALID_GIT_REF_CHARS
- SECURITY_INVALID_GIT_REF_PATTERN
- SECURITY_INVALID_SEMVER_FORMAT
- SECURITY_INVALID_VERSION
- SECURITY_NULL_BYTE_INJECTION
- SECURITY_PATH_ESCAPE
- SECURITY_PATH_TRAVERSAL
- SECURITY_SHELL_INJECTION
- TEMPLATE_INVALID
- TEMPLATE_PROCESSING_FAILED
- TEMPLATE_SECURITY_VIOLATION
- UNKNOWN_ERROR
- VERSION_BUMP_INVALID
- VERSION_FILE_NOT_FOUND
- VERSION_INVALID_FORMAT
- VERSION_NOT_FOUND
Factory class for creating common Nagare errors with consistent formatting
File handler definition for intelligent file updates
File handler manager for intelligent file updates
File update pattern for additional files to update during release
GitHubIntegration - GitHub release management
Handles all Git-related operations for releases
- commitAndTag
- config
- deleteLocalTag
- deleteRemoteTag
- extractPRNumber
- getCommitsInPR
- getCommitsSinceLastRelease
- getCurrentBranch
- getCurrentCommitHash
- getGitUser
- getLastCommitMessage
- getLastReleaseTag
- getLocalTags
- getMergeCommits
- hasUncommittedChanges
- isGitRepository
- logger
- parseConventionalCommit
- pushToRemote
- remoteTagExists
- resetToCommit
- runCommand
Log levels
Main configuration interface for Nagare
Enhanced error class for Nagare with actionable suggestions
Pattern builder for creating safe version patterns
Main ReleaseManager class - coordinates the entire release process
- attemptAutoFix
- attemptPreflightAutoFix
- backupManager
- buildSafeReplacement
- changelogGenerator
- config
- createProgressIndicator
- directJsrVerification
- docGenerator
- fileHandlerManager
- formatChangedFiles
- generateReleaseNotes
- getConfig
- getFilesToBackup
- getPreflightChecks
- getTemplateValue
- git
- github
- logger
- mergeWithDefaults
- performPreflightChecks
- previewFileUpdates
- previewRelease
- release
- shouldVerifyJsrPublish
- stateTracker
- templateProcessor
- updateCustomFile
- updateFiles
- updateVersionFile
- validateConfig
- validateEnvironment
- validateFileUpdatePatterns
- validateFileUpdatePatternsEnhanced
- verifyJsrPublication
- versionUtils
Result of a release operation with comprehensive feedback
Template data for Vento template processing
Supported template formats for version file generation
Template processing and file generation using Vento.
All available translation keys as string literals
Version file configuration for template-based version file generation
VersionUtils - Semantic versioning operations