{"id":41891347,"url":"https://github.com/kurone-kito/is-prerelease","last_synced_at":"2026-01-25T14:07:49.871Z","repository":{"id":329516899,"uuid":"1119382430","full_name":"kurone-kito/is-prerelease","owner":"kurone-kito","description":"🆕 The simple CLI app based on Node.js that determines whether the project is a pre-release version; since 2025.12","archived":false,"fork":false,"pushed_at":"2025-12-20T03:57:24.000Z","size":338,"stargazers_count":1,"open_issues_count":8,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-13T10:42:16.084Z","etag":null,"topics":["empty","yet"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kurone-kito.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.ja.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.ja.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-19T07:25:57.000Z","updated_at":"2025-12-20T02:45:20.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kurone-kito/is-prerelease","commit_stats":null,"previous_names":["kurone-kito/is-prerelease"],"tags_count":0,"template":false,"template_full_name":"kurone-kito/pnpm-project-template","purl":"pkg:github/kurone-kito/is-prerelease","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kurone-kito%2Fis-prerelease","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kurone-kito%2Fis-prerelease/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kurone-kito%2Fis-prerelease/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kurone-kito%2Fis-prerelease/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kurone-kito","download_url":"https://codeload.github.com/kurone-kito/is-prerelease/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kurone-kito%2Fis-prerelease/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28754155,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-25T13:59:49.818Z","status":"ssl_error","status_checked_at":"2026-01-25T13:59:33.728Z","response_time":113,"last_error":"SSL_read: 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":["empty","yet"],"created_at":"2026-01-25T14:07:49.515Z","updated_at":"2026-01-25T14:07:49.858Z","avatar_url":"https://github.com/kurone-kito.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🆕 `@kurone-kito/is-prerelease`\n\nA simple CLI app based on Node.js that determines whether a given version\nis a pre-release version using [semver](https://www.npmjs.com/package/semver).\n\n## Features\n\n- Detects pre-release versions (e.g., `1.0.0-alpha.1`, `2.0.0-beta.3`)\n- Returns exit codes for easy CI/CD integration\n- Zero configuration required\n\n## Requirements\n\n- Node.js `^20.11 || ^22 || \u003e=24`\n\n## Installation\n\n```sh\nnpm i -D @kurone-kito/is-prerelease\n```\n\n## Usage\n\n### Command Syntax\n\n```sh\nis-prerelease \u003cversion\u003e [pre]\n```\n\n### Arguments\n\n| Argument  | Required | Description                                                                     |\n| --------- | -------- | ------------------------------------------------------------------------------- |\n| `version` | Yes      | The version string to check (JSON format, e.g., `\"1.0.0\"` or `\"1.0.0-alpha.1\"`) |\n| `pre`     | No       | If provided, the command expects a pre-release version                          |\n\n### Exit Codes\n\n| Condition                                              | Exit Code     |\n| ------------------------------------------------------ | ------------- |\n| Pre-release version **and** `pre` argument provided    | `0` (success) |\n| Stable version **and** `pre` argument **not** provided | `0` (success) |\n| Otherwise                                              | `1` (failure) |\n\n### Examples\n\n#### Check if a version is a pre-release\n\n```sh\n# Returns exit code 0 if pre-release\nis-prerelease '\"1.0.0-alpha.1\"' pre\n\n# Returns exit code 0 if stable release\nis-prerelease '\"1.0.0\"'\n```\n\n#### Integration with npm scripts\n\n```json\n{\n  \"scripts\": {\n    \"is:prerelease\": \"is-prerelease $(npm pkg get version) pre\",\n    \"is:release\": \"is-prerelease $(npm pkg get version)\"\n  }\n}\n```\n\n\u003e **Note:** `npm pkg get version` outputs a JSON-formatted string\n\u003e (e.g., `\"1.0.0\"`), which is the expected input format.\n\n#### CI/CD Usage Example\n\n```sh\n# Publish to npm only if it's a pre-release version\nif npm run is:prerelease; then\n  npm publish --tag next\nfi\n\n# Publish to npm only if it's a stable release\nif npm run is:release; then\n  npm publish --tag latest\nfi\n```\n\n## How It Works\n\nThis CLI uses the `prerelease()` function from the\n[semver](https://www.npmjs.com/package/semver) package to detect\npre-release identifiers in version strings.\n\n- `1.0.0` → Stable release (no pre-release identifier)\n- `1.0.0-alpha.1` → Pre-release (identifier: `['alpha', 1]`)\n- `2.0.0-beta.3` → Pre-release (identifier: `['beta', 3]`)\n\n## Contributing\n\nWelcome to contribute to this repository! For more details,\nplease refer to [CONTRIBUTING.md](.github/CONTRIBUTING.md).\n\n## License\n\n[MIT](./LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkurone-kito%2Fis-prerelease","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkurone-kito%2Fis-prerelease","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkurone-kito%2Fis-prerelease/lists"}