{"id":20109806,"url":"https://github.com/hyper63/hyper-ci-bump","last_synced_at":"2026-02-17T06:31:33.348Z","repository":{"id":46815959,"uuid":"382345942","full_name":"hyper63/hyper-ci-bump","owner":"hyper63","description":"Github Action to bump manifest files to a given version and commit","archived":false,"fork":false,"pushed_at":"2024-11-15T15:37:29.000Z","size":50871,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-02-11T04:30:02.781Z","etag":null,"topics":["changelog","git","github-actions","github-workflow","hyper","semver"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hyper63.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-07-02T12:54:09.000Z","updated_at":"2024-11-15T15:37:33.000Z","dependencies_parsed_at":"2025-06-07T23:21:12.066Z","dependency_job_id":null,"html_url":"https://github.com/hyper63/hyper-ci-bump","commit_stats":{"total_commits":33,"total_committers":3,"mean_commits":11.0,"dds":0.1515151515151515,"last_synced_commit":"6b010e4f8576c63a80d373236867cb0baab4258a"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/hyper63/hyper-ci-bump","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyper63%2Fhyper-ci-bump","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyper63%2Fhyper-ci-bump/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyper63%2Fhyper-ci-bump/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyper63%2Fhyper-ci-bump/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hyper63","download_url":"https://codeload.github.com/hyper63/hyper-ci-bump/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyper63%2Fhyper-ci-bump/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29535969,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-17T05:00:25.817Z","status":"ssl_error","status_checked_at":"2026-02-17T04:57:16.126Z","response_time":100,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["changelog","git","github-actions","github-workflow","hyper","semver"],"created_at":"2024-11-13T18:09:30.517Z","updated_at":"2026-02-17T06:31:33.325Z","avatar_url":"https://github.com/hyper63.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003ehyper-ci-bump\u003c/h1\u003e\n\u003cp align=\"center\"\u003eA Github action to bump manifest files based on the provided semver compatible version\u003c/p\u003e\n\u003c/p\u003e\n\n---\n\n## Table of Contents\n\n- [Getting Started](#getting-started)\n- [API](#api)\n- [License](#license)\n\n## Getting Started\n\nThis action can be used as part of any Github workflow.\n\n- Bump manifest files (according to latest semver compatible Git tag)\n- Generate changelog (disabled by default)\n- commit changes\n- tag new commit\n\nThis can then be pushed back to the repo using `git push --follow-tags`\n\n\u003e This module itself is versioned using `hyper-ci-bump`. Check out\n\u003e [the tag and release workflow](./.github/workflows/tag-and-release.yml)\n\n## Using in a workflow\n\nA great way to use this action is part of a\n[workflow dispatch](https://docs.github.com/en/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#workflow_dispatch)\n\nWith this, tagging and releasing can all be done via the Github UI!\n\n```yml\nname: 🔖 Tag and Release\n\non:\n  workflow_dispatch:\n    inputs:\n      # See https://github.com/hyper63/hyper-ci-bump#inputs for available inputs for the bump action\n      version:\n        description: the semver version to bump to\n        required: true\n\njobs:\n  release:\n    runs-on: ubuntu-latest\n    steps:\n      - name: ⬇️ Checkout repo\n        uses: actions/checkout@v3\n        with:\n          # Allows for pushes from this workflow to trigger subsequent workflows\n          token: ${{ secrets.GITHUB_TOKEN }}\n          # 0 means pull down all history, so all tags can be grep'd\n          fetch-depth: 0\n\n      - name: ⎔ Setup node\n        uses: actions/setup-node@v3\n        with:\n          node-version: 18.x\n\n      - name: 🤓 Set Git User\n        run: |\n          git config --global user.name \"${{ github.actor }}\"\n          git config --global user.email \"${{ github.actor }}@users.noreply.github.com\"\n\n      - name: ✊ Bump\n        id: bump\n        uses: hyper63/hyper-ci-bump@v2\n        with:\n          bump-to: ${{ github.event.inputs.version }}\n\n      - name: ⬆️ Push\n        run: |\n          git push --follow-tags\n\n      - name: 🤖 Create Github Release\n        if: steps.bump.outputs.tag\n        uses: softprops/action-gh-release@v1\n        with:\n          tag_name: ${{ steps.bump.outputs.tag }}\n        env:\n          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n```\n\nYou'll then see a new \"Run Workflow\" button on the `Actions` page of your repo:\n\n![Run Workflow Screenshot](./assets/run-workflow.png)\n\n### Triggering subsequent workflows\n\nWhen you use `GITHUB_TOKEN` in your actions, all of the interactions with the\nrepository are on behalf of the Github-actions bot. The operations act by\nGithub-actions bot cannot trigger a new workflow run. If you'd like to trigger\nsubsequent workflows ie. off the new commit or tag created, you will need to use\na personal access token, provided as `token` during the `actions/checkout@v3`\njob:\n\n```yml\njobs:\n  release:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v3\n        with:\n          fetch-depth: 0\n          # now pushes from this workflow can trigger subsequent workflows\n          token: ${{ secrets.YOUR_PAT }}\n...\n```\n\nYour token will need to have `repo` permissions:\n\n![CI Personal Access Token Permissions Screenshot](./assets/ci-pat.png)\n\n## API\n\n### Inputs\n\n- _string_ `bump-to` **Optional**: the semver comptaible version to bump to. If\n  the string \"semver\" or nothing is passed, then it will semver bump the package\n  based on commit messages, following conventional-commit standards. When semver\n  bumping, the most recent git tag is used as the base version. **If no base git\n  tag is found, `v1.0.0` is used as the base to bump from**.\n- _string_ `package` **Optional**: the package name that contains the files to\n  bump. Great for repos with multiple independently versioned packages ie. in a\n  monorepo. Example: `app-opine` will find a package in `*/**/app-opine`\n- _string_ `prefix` **Optional**: prefix to use for the git tag. Example:\n  `app-opine` prefix and `v1.3.2` version will result in a tag of\n  `app-opine@v1.3.2`. **default**: the `package` input.\n- _string_ `runtime` **Optional**: This dictates which manifest files are\n  bumped. Currently supports `node`, `deno`, or `javascript`. The following\n  table shows which manifest files will be bumped for each runtime. **default**:\n  `javascript`\n\n| runtime                      | manifest files bumped                                                    |\n| ---------------------------- | ------------------------------------------------------------------------ |\n| `deno`, `node`, `javascript` | `deno.json`, `jsr.json`, `egg.json`, `package.json`, `package-lock.json` |\n\nTODO: add some more run times\n\n### Outputs\n\n- _string_ `version`: The semver version bumped to\n- _string_ `tag`: The git tag created, if tagging was performed. Otherwise\n  `undefined`\n\n### Configuration\n\na `.versionrc` can be used to override behavior. For example, to enable\ngeneration of a changelog, create `.versionrc` file at the root of the project\nlike this:\n\n```json\n{\n  \"skip\": {\n    \"changelog\": false\n  }\n}\n```\n\nNow a changelog will be generated and/or appended to for the repo. Any of the\nfollowing lifecycle steps can be enabled/disabled using this method:\n\n`bump`, `changelog`, `commit`, `tag`\n\nBy default, `bump`, `commit`, and `tag` are enabled.\n\n## License\n\nApache-2.0\n\n## Contributing\n\nLogic can be found in `main.js` and dependencies are provided via `index.js`.\nThis is a github action, so `node_modules` are intentionally committed to the\nrepo.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyper63%2Fhyper-ci-bump","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhyper63%2Fhyper-ci-bump","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyper63%2Fhyper-ci-bump/lists"}