feat: version utils

.husky/pre-commit

@@ -0,0 +1,36 @@
+#!/bin/sh
+
+# This script is an example of how a pre-commit hook might be set up 
+# to execute pre-commit scripts from @krauters/utils.
+#
+# Prerequisite: Make sure to install @krauters/utils and ts-node in your project
+# npm install --save-dev @krauters/utils ts-node
+
+RED='\033[1;31m'
+GREEN='\033[1;32m'
+NC='\033[0m'
+
+PREFIX='[CHECKS]'
+
+log() {
+    echo "${GREEN}${PREFIX}${NC} $1"
+}
+
+error() {
+    echo "${RED}${PREFIX}${NC} $1"
+}
+
+log 'Running pre-commit scripts...'
+
+# Adjust the path based on whether it's run from node_modules or locally as shown
+# if ! OUTPUT=$(npx ts-node ./node_modules/@krauters/utils/src/scripts/pre-commit.ts 2>&1); then
+if ! OUTPUT=$(npx ts-node ./src/scripts/pre-commit.ts 2>&1); then
+    error "Pre-commit check failed:\n\n${OUTPUT}\n"
+    error 'Aborting commit.'
+    error 'Run commit with '-n' to skip pre-commit hooks.'
+    exit 1
+fi
+
+log "Script output...\n\n${OUTPUT}\n"
+log 'Pre-commit checks passed.'
+exit 0

README.md

@@ -1,5 +1,5 @@
-# Typescript Core
-A TypeScript Repository that stands as a starting point for all other TypeScript repositories.
+# Utils
+A versatile TypeScript utility package packed with reusable, type-safe functions, scripts useful for all kinds of TypeScript projects, and precommit scripts to streamline your development workflow.
 
 ## Husky
 
@@ -11,6 +11,27 @@ Pre-commit hooks run scripts before a commit is finalized to catch issues or enf
 
 This project uses a custom pre-commit hook to run `npm run bundle`. This ensures that our bundled assets are always up to date before any commit (which is especially important for TypeScript GitHub Actions). Husky automates this, so no commits will go through without a fresh bundle, keeping everything streamlined.
 
+### Using Utils as Pre-Commit Hooks
+
+```sh
+./husky/pre-commit
+#!/bin/sh
+
+RED='\033[1;31m'
+GREEN='\033[1;32m'
+NC='\033[0m'
+
+PREFIX="${GREEN}[HUSKY]${NC} "
+
+if ! OUTPUT=$(npx ts-node ./node_modules/@krauters/utils/src/version.ts 2>&1); then
+    echo -e "${RED}${PREFIX}${OUTPUT}${NC}"
+    echo -e "${RED}${PREFIX}Aborting commit.${NC}"
+    echo -e "${RED}${PREFIX}Run commit with '-n' to skip pre-commit hooks.${NC}"
+    exit 1
+fi
+
+```
+
 ## Contributing
 
 The goal of this project is to continually evolve and improve its core features, making it more efficient and easier to use. Development happens openly here on GitHub, and we’re thankful to the community for contributing bug fixes, enhancements, and fresh ideas. Whether you're fixing a small bug or suggesting a major improvement, your input is invaluable.
@@ -23,6 +44,6 @@ This project is licensed under the ISC License. Please see the [LICENSE](./LICEN
 
 Thanks for spending time on this project.
 
-<a href="https://github.com/krauters/typescript-core/graphs/contributors">
-  <img src="https://contrib.rocks/image?repo=krauters/typescript-core" />
+<a href="https://github.com/krauters/utils/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=krauters/utils" />
 </a>

package.json

@@ -1,11 +1,11 @@
 {
-	"name": "@krauters/typescript-core",
-	"description": "A TypeScript Repository that stands as a starting point for all other TypeScript repositories.",
-	"version": "1.0.0",
-	"main": "app.ts",
+	"name": "@krauters/utils",
+	"description": "A versatile TypeScript utility package packed with reusable, type-safe functions, scripts useful for all kinds of TypeScript projects, and precommit scripts to streamline your development workflow.",
+	"version": "0.1.1",
+	"main": "index.ts",
 	"type": "commonjs",
 	"scripts": {
-		"build": "ts-node ./src/app.ts",
+		"build": "ts-node ./src/index.ts",
 		"example-1": "ts-node ./example/1.ts",
 		"fix": "npm run lint -- --fix",
 		"lint": "npx eslint src/**",

src/index.ts

@@ -0,0 +1 @@
+export * from './version'

src/scripts/README.md

@@ -0,0 +1,23 @@
+# Scripts
+
+This folder contains reusable TypeScript scripts intended for pre-commit checks and other automation tasks, designed to be used across multiple repositories.
+
+## Purpose
+
+- **Centralized Automation:** Provides a consistent way to enforce checks, such as version validation, before committing changes.
+- **Ease of Integration:** Ensures all consuming repositories maintain uniform pre-commit behavior.
+
+## Key Script
+
+- **`pre-commit.ts`**: This script handles pre-commit checks (like version validation). It’s meant to be executed via a bash script.
+
+## Usage
+
+1. **Install Dependencies**:
+    ```
+    npm install --save-dev @krauters/utils ts-node
+    ```
+2. **Set Up Your Pre-Commit Hook**:
+   - Use a bash script to call `pre-commit.ts` (or other specific scripst) in your repo.
+
+For a detailed example, see [example.sh](./example.sh).

src/scripts/example.sh

@@ -0,0 +1,36 @@
+#!/bin/sh
+
+# This script is an example of how a pre-commit hook might be set up 
+# to execute pre-commit scripts from @krauters/utils.
+#
+# Prerequisite: Make sure to install @krauters/utils and ts-node in your project
+# npm install --save-dev @krauters/utils ts-node
+
+RED='\033[1;31m'
+GREEN='\033[1;32m'
+NC='\033[0m'
+
+PREFIX='[CHECKS]'
+
+log() {
+    echo "${GREEN}${PREFIX}${NC} $1"
+}
+
+error() {
+    echo "${RED}${PREFIX}${NC} $1"
+}
+
+log 'Running pre-commit scripts...'
+
+# Adjust the path based on whether it's run from node_modules or locally as shown
+# if ! OUTPUT=$(npx ts-node ./node_modules/@krauters/utils/src/scripts/pre-commit.ts 2>&1); then
+if ! OUTPUT=$(npx ts-node ./pre-commit.ts 2>&1); then
+    error "Pre-commit check failed:\n\n${OUTPUT}\n"
+    error 'Aborting commit.'
+    error 'Run commit with '-n' to skip pre-commit hooks.'
+    exit 1
+fi
+
+log "Script output...\n\n${OUTPUT}\n"
+log 'Pre-commit checks passed.'
+exit 0

src/scripts/pre-commit.ts

@@ -0,0 +1 @@
+import './version'

src/scripts/version.ts

@@ -0,0 +1,3 @@
+const { compareVersions } = require('../version')
+
+compareVersions()