{"_id":"@bigfootds/unreal-semver-updater","_rev":"2-38918bfce19929f6fab072ec8a2ae4e9","name":"@bigfootds/unreal-semver-updater","dist-tags":{"latest":"0.0.2"},"versions":{"0.0.1":{"name":"@bigfootds/unreal-semver-updater","version":"0.0.1","keywords":["unreal","unreal-engine","semver","version","cli"],"author":{"name":"BigfootDS"},"license":"MIT","_id":"@bigfootds/unreal-semver-updater@0.0.1","maintainers":[{"name":"alexstormwood","email":"alex@bigfootds.com"}],"homepage":"https://github.com/BigfootDS/pkg-unreal-semver-updater#readme","bugs":{"url":"https://github.com/BigfootDS/pkg-unreal-semver-updater/issues"},"bin":{"unreal-semver-updater":"dist/cli.js"},"dist":{"shasum":"87652af6658ee8e5abfcd9e7d1d39bdd19ce19b5","tarball":"https://registry.npmjs.org/@bigfootds/unreal-semver-updater/-/unreal-semver-updater-0.0.1.tgz","fileCount":19,"integrity":"sha512-M4T8zCRzfqtb03zs/jEf6bX0gSPb+XHgm5AHS55pzIG3HCVFfftvLn/tCsj2zti4FTEmxKtzslU7quU67jPb2g==","signatures":[{"sig":"MEUCIQC/jBglCDzPH3XrAla2vi6qlGVIU9PMRabDLG6kRQEnKgIgfKrIBwBSYfWGhM3WImwCsxIwnW1lhddfsOKunNMRQhg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":25280},"main":"./dist/index.js","type":"commonjs","types":"./dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"463748f8f134434de03c80650295412116d7510d","scripts":{"test":"npm run build && node --test test/*.test.js","build":"tsc --project tsconfig.json","prepack":"npm run build","pack:check":"npm pack --dry-run"},"_npmUser":{"name":"alexstormwood","email":"alex@bigfootds.com"},"repository":{"url":"git+https://github.com/BigfootDS/pkg-unreal-semver-updater.git","type":"git"},"_npmVersion":"11.17.0","description":"Update an Unreal Engine project's game version from Node.js or the command line.","directories":{},"_nodeVersion":"25.6.1","publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^7.0.2","@types/node":"^24.13.3"},"_npmOperationalInternal":{"tmp":"tmp/unreal-semver-updater_0.0.1_1787290477869_0.4210151682257617","host":"s3://npm-registry-packages-npm-production"}},"0.0.2":{"name":"@bigfootds/unreal-semver-updater","version":"0.0.2","description":"Update an Unreal Engine project's game version from Node.js or the command line.","license":"MIT","author":{"name":"BigfootDS"},"scripts":{"build":"tsc --project tsconfig.json","test":"npm run build && node --test test/*.test.js","pack:check":"npm pack --dry-run","prepack":"npm run build"},"repository":{"type":"git","url":"git+https://github.com/BigfootDS/pkg-unreal-semver-updater.git"},"type":"commonjs","bugs":{"url":"https://github.com/BigfootDS/pkg-unreal-semver-updater/issues"},"homepage":"https://github.com/BigfootDS/pkg-unreal-semver-updater#readme","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","require":"./dist/index.js","default":"./dist/index.js"}},"bin":{"unreal-semver-updater":"dist/cli.js"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"keywords":["unreal","unreal-engine","semver","version","cli"],"devDependencies":{"@types/node":"^24.13.3","typescript":"^7.0.2"},"engines":{"node":">=20"},"gitHead":"a760ff4d8637e4b360ddda82dd146a73f93cfcd9","_id":"@bigfootds/unreal-semver-updater@0.0.2","_nodeVersion":"24.19.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-Po5h076obj7ZcFAAVmKI92cI+sVX3nV9e6LLMboI4HyA85dyCQ3PjNrWmna32Q8ceGa3ljvKWym8ZvladPiLUg==","shasum":"c89cb3f51400295e093ce881db5a35170b28de6e","tarball":"https://registry.npmjs.org/@bigfootds/unreal-semver-updater/-/unreal-semver-updater-0.0.2.tgz","fileCount":19,"unpackedSize":25281,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAVoDXcPr/KkHH5AY03zj+ZGMACsdiT93Nui4N0jUOxaAiEAz4k3kh/sWAxE8OE7Py2X96kTdcbaIZhXqhScoS6bvik="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:e0f9df51-4341-40bf-8744-0325cc1cbdbc"}},"directories":{},"maintainers":[{"name":"alexstormwood","email":"alex@bigfootds.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/unreal-semver-updater_0.0.2_1787290703254_0.8060257103158894"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-21T05:34:37.656Z","modified":"2026-08-21T05:38:23.545Z","0.0.1":"2026-08-21T05:34:38.041Z","0.0.2":"2026-08-21T05:38:23.388Z"},"bugs":{"url":"https://github.com/BigfootDS/pkg-unreal-semver-updater/issues"},"author":{"name":"BigfootDS"},"license":"MIT","homepage":"https://github.com/BigfootDS/pkg-unreal-semver-updater#readme","keywords":["unreal","unreal-engine","semver","version","cli"],"repository":{"type":"git","url":"git+https://github.com/BigfootDS/pkg-unreal-semver-updater.git"},"description":"Update an Unreal Engine project's game version from Node.js or the command line.","maintainers":[{"name":"alexstormwood","email":"alex@bigfootds.com"}],"readme":"# Unreal SemVer Updater\n\nUpdate an Unreal Engine project's game version from Node.js or the command line.\n\nBy default, the package updates `ProjectVersion` in Unreal's standard project settings location:\n\n```ini\n[/Script/EngineSettings.GeneralProjectSettings]\nProjectVersion=1.2.3\n```\n\n## Requirements\n\nNode.js 20 or later.\n\n## Command line\n\nRun the package without installing it globally:\n\n```sh\nnpx @bigfootds/unreal-semver-updater --version 1.2.3\n```\n\nThe default configuration file is `Config/DefaultGame.ini`. Override the file, section, or key for projects with a custom layout:\n\n```sh\nnpx @bigfootds/unreal-semver-updater \\\n  --project path/to/Config/DefaultGame.ini \\\n  --section Build \\\n  --key Version \\\n  --version 1.2.3-beta.1\n```\n\nVersions are validated as [semantic versions](https://semver.org/) by default. Use `--allow-non-semver` for a custom version string, `--strip-leading-v` for Git tags such as `v1.2.3`, and `--dry-run` to inspect an update without writing a file.\n\n## Library\n\n```ts\nimport { updateUnrealProjectVersion } from \"@bigfootds/unreal-semver-updater\";\n\nconst result = await updateUnrealProjectVersion({\n  projectPath: \"Config/DefaultGame.ini\",\n  version: \"1.2.3\",\n});\n\nconsole.log(result.previousVersion, result.version);\n```\n\nThe updater preserves unrelated settings and line endings, adds the version key or section when necessary, and preserves existing quoted values. Pass `section` and `key` to target a different INI setting, or `dryRun: true` to calculate the change without writing.\n\n## GitHub Actions\n\nAfter Node is available, the command fits directly into a workflow:\n\n```yaml\n- uses: actions/setup-node@v6\n  with:\n    node-version: 24\n\n- run: npx @bigfootds/unreal-semver-updater --version \"${{ github.ref_name }}\" --strip-leading-v\n```\n\n## Development\n\n```sh\nnpm ci\nnpm test\nnpm run pack:check\n```\n\n## Releases\n\nAfter the initial npm publication, CD releases every conventional commit that reaches `main`; do not manually edit `package.json`'s version or create release tags. The highest-impact commit since the previous release determines the version:\n\n- `feat:` creates a minor release.\n- `type!:` or a `BREAKING CHANGE:` footer creates a major release.\n- Any other conventional commit type creates a patch release.\n\nThe workflow rejects a non-conventional commit that reaches `main`, commits the generated version, creates its `vX.Y.Z` tag and GitHub release, then publishes with npm Trusted Publishing. All feature work should use conventional commits and be merged into `main` through a pull request. If squash-merging, ensure the resulting squash commit (usually the pull request title) is conventional too.\n\n","readmeFilename":"README.md"}