@tmlmobilidade/repo-version 20251006.1125.28

package/README.md

@@ -0,0 +1,25 @@
+### @tmlmobilidade/bump-version 🧼
+
+Bump version is a small util to update the package.json version string using the current timestamp.
+
+#### Usage:
+
+```
+npx @tmlmobilidade/repo-version --output=<path-to-package.json | console> --format=<default | code> --prefix=<your-prefix>
+```
+
+##### `--format`
+- "string" - Output as a formatted string (e.g. `20250101.1026.12`)
+- "code" - Output as number (e.g. `20250101102612`)
+
+##### `--prefix`
+- an optional value to prepend to the version string (only in default format)
+
+##### `--suffix`
+- an optional value to append to the version string (only in default format)
+
+##### `--output`
+- "<path-to-package.json>" - Modify the package.json.
+- "console" - Output to the console. This will hide any other logs.
+
+:)

package/dist/index.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+/* * */
+import { Dates } from '@tmlmobilidade/utils';
+import fs from 'node:fs';
+/* * */
+//
+// Parse command-line arguments
+const args = process.argv.slice(2);
+const prefixArg = args.find(arg => arg.startsWith('--prefix='));
+const prefix = prefixArg ? prefixArg.split('=')[1] : '';
+const suffixArg = args.find(arg => arg.startsWith('--suffix='));
+const suffix = suffixArg ? suffixArg.split('=')[1] : '';
+const formatArg = args.find(arg => arg.startsWith('--format='));
+const format = formatArg ? formatArg.split('=')[1] : '';
+const outputArg = args.find(arg => arg.startsWith('--output='));
+const output = outputArg ? outputArg.split('=')[1] : '';
+//
+// Generate the new version based on the current date and time
+const dateValue = Dates.now('Europe/Lisbon');
+//
+// Format the version string.
+// For "default" format: [prefix]YYYYMMDD.HHMM.SS
+// For "code" format: YYYYMMDDHHMMSS (as a single number, no prefix)
+let futurePackageVersion = '';
+if (!format || format === 'default') {
+    futurePackageVersion = `${prefix}${dateValue.toFormat('yyyyMMdd.HHmm.ss')}${suffix}`;
+}
+if (format === 'code') {
+    futurePackageVersion = String(Number(dateValue.toFormat('yyyyMMddHHmmss')));
+}
+//
+// If the ouput is set to "console",
+// just print the version to the console and exit.
+if (output === 'console') {
+    console.log(futurePackageVersion);
+    process.exit(0);
+}
+//
+// If there is a package.json path argument,
+// read the file and parse its content.
+if (!output) {
+    console.error('✘ Error: No path to package.json provided.');
+    process.exit(1);
+}
+const packageJsonFile = fs.readFileSync(output, 'utf8');
+const packageJsonData = JSON.parse(packageJsonFile);
+//
+// Update the package.json file with the new version
+// and log the change to the console.
+const currentPackageVersion = packageJsonData.version;
+packageJsonData.version = futurePackageVersion;
+fs.writeFileSync(output, JSON.stringify(packageJsonData, null, '\t'));
+console.log(`✓ Package Version updated from "${currentPackageVersion}" to "${futurePackageVersion}".`);

package/package.json

@@ -0,0 +1,31 @@
+{
+	"name": "@tmlmobilidade/repo-version",
+	"description": "A CLI tool to bump the version of a NodeJS package.",
+	"version": "20251006.1125.28",
+	"author": "João de Vasconcelos & Jusi Monteiro",
+	"license": "AGPL-3.0-or-later",
+	"type": "module",
+	"files": [
+		"dist/"
+	],
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"scripts": {
+		"build": "tsc && resolve-tspaths",
+		"lint": "eslint .",
+		"lint:fix": "eslint . --fix",
+		"start": "tsc && resolve-tspaths && node dist/index.js"
+	},
+	"bin": {
+		"repo-version": "./dist/index.js"
+	},
+	"dependencies": {
+		"@tmlmobilidade/utils": "*"
+	},
+	"devDependencies": {
+		"@carrismetropolitana/eslint": "20250622.1204.50",
+		"@types/node": "24.7.0",
+		"resolve-tspaths": "0.8.23",
+		"typescript": "5.9.3"
+	}
+}