feat(git): properly handle commits and tagging (#19)

Co-authored-by: Jan Soukup <soukup@u.plus>

README.md

@@ -14,6 +14,9 @@ And includes CLI and custom server handler to integrate with ApiGw.
   - [Packaging](#packaging)
     - [Server handler](#server-handler-1)
     - [Static assets](#static-assets)
+- [Versioning](#versioning)
+  - [Guess](#guess)
+  - [Shipit](#shipit)
 - [TODO](#todo)
 - [Disclaimer](#disclaimer)
 
@@ -280,6 +283,23 @@ Cloudfront paths used:
 - `_next/*`
 - `assets/*`
 
+# Versioning
+
+This package exposes two CLI functions intended to deal with versioning your application and releasing.
+
+Motivation behind is to get rid of huge dependencies and over-kill implementations such as @auto-it, release-it or semver. Those are bulky and unncessarily complex.
+
+## Guess
+
+Simple CLI command that takes commit message and current version and outputs (stdout) next version based on keywords inside commit message.
+
+## Shipit
+
+Similar to guess command, however, it automatically tags a commit on current branch and creates release branch for you so hooking up pipelines is as simple as it can be. Version is automatically bumped in common NPM and PHP files (package.json, package-lock.json and composer.json).
+
+Simply call `@sladg/next-lambda shipit` on any branch and be done.
+
+
 # TODO
 
 - Explain scripts used for packaging Next app,

lib/cli.ts

@@ -5,10 +5,12 @@ import path from 'path'
 import packageJson from '../package.json'
 import { simpleGit } from 'simple-git'
 import { Command } from 'commander'
-import { bumpCalculator, bumpMapping, BumpType, isValidTag } from './utils'
+import { bumpCalculator, bumpMapping, BumpType, isValidTag, replaceVersionInCommonFiles } from './utils'
 
 const exec = util.promisify(child_exec)
 
+const skipCiFlag = '[skip ci]'
+
 const scriptDir = path.dirname(__filename)
 const scriptPath = path.resolve(`${scriptDir}/../../scripts/pack-nextjs.sh`)
 const handlerPath = path.resolve(`${scriptDir}/../server-handler/index.js`)
@@ -86,6 +88,7 @@ program
 
 		const latestCommit = log.latest?.hash
 		const latestTag = tags.latest ?? '0.0.0'
+		const currentTag = latestTag.replace(tagPrefix, '')
 
 		if (!isValidTag(latestTag, tagPrefix)) {
 			throw new Error(`Invalid tag found - ${latestTag}!`)
@@ -120,17 +123,31 @@ program
 			bumps.push(BumpType.Patch)
 		}
 
-		const nextTag = bumps.reduce((acc, curr) => bumpCalculator(acc, curr), latestTag.replace(tagPrefix, ''))
+		const nextTag = bumps.reduce((acc, curr) => bumpCalculator(acc, curr), currentTag)
 		const nextTagWithPrefix = tagPrefix + nextTag
 		const releaseBranch = `${releaseBranchPrefix}${nextTagWithPrefix}`
-
 		console.log(`Next version is - ${nextTagWithPrefix}!`)
 
+		const replacementResults = replaceVersionInCommonFiles(currentTag, nextTag)
+		console.log(`Replaced version in files.`, replacementResults)
+
+		// Commit changed files (versions) and create a release commit with skip ci flag.
+		await git
+			//
+			.add('./*')
+			.commit(`Release: ${nextTagWithPrefix} ${skipCiFlag}`)
+			.push(remote.name, branch.current)
+
+		// As current branch commit includes skip ci flag, we want to ommit this flag for release branch so pipeline can run (omitting infinite loop).
+		// So we are overwriting last commit message and pushing to release branch.
+		await git
+			//
+			.raw(`--message Release: ${nextTagWithPrefix}`, '--amend')
+			.push(remote.name, `${branch.current}:${releaseBranch}`)
+
 		// Create tag and push it to master.
 		// @Note: CI/CD should not be listening for tags in master, it should listen to release branch.
-		await git.addTag(nextTagWithPrefix)
-		await git.pushTags()
-		await git.push(remote.name, `${branch.current}:${releaseBranch}`)
+		await git.addTag(nextTagWithPrefix).pushTags()
 
 		console.log(`Successfuly tagged and created new branch - ${releaseBranch}`)
 	})

lib/utils.ts

@@ -1,5 +1,6 @@
 import { GetObjectCommand, S3Client } from '@aws-sdk/client-s3'
 import { IncomingMessage, ServerResponse } from 'http'
+import { replaceInFileSync } from 'replace-in-file'
 import { NextUrlWithParsedQuery } from 'next/dist/server/request-meta'
 import { Readable } from 'stream'
 
@@ -143,3 +144,41 @@ export const bumpCalculator = (version: string, bumpType: BumpType) => {
 
 	throw new Error(`Unknown bump type - ${bumpType}!`)
 }
+
+export const replaceVersionInCommonFiles = (oldVersion: string, newVersion: string) => {
+	const results = replaceInFileSync({
+		allowEmptyPaths: true,
+		ignore: [
+			'**/node_modules',
+			'**/.venv',
+			'**/vendor',
+			'**/.git',
+			//
+		],
+		files: [
+			'package.json',
+			'package-lock.json',
+			'package-lock.json', // duplicate because lock file contains two occurences.
+			// 'yarn.lock', Yarn3 lock file does not contain version from package.json
+			'composer.json',
+			// 'composer.lock', Composer2 lock file does not include version from composer.json
+			'pyproject.toml',
+			'**/__init__.py',
+		],
+		from: [
+			`"version": "${oldVersion}"`, // npm/php style
+			`"version":"${oldVersion}"`, // uglified npm/php style
+			`version = "${oldVersion}"`, // python style
+			`__version__ = '${oldVersion}'`, // python style
+		],
+		to: [
+			`"version": "${newVersion}"`,
+			`"version":"${newVersion}"`,
+			`version = "${newVersion}"`,
+			`__version__ = '${newVersion}'`,
+			//
+		],
+	})
+
+	return results
+}