@muverse/core 0.1.0

package/dist/utils/properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../src/utils/properties.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC,CAgDf"}

package/dist/utils/properties.js

@@ -0,0 +1,62 @@
+import { promises as fs } from "fs";
+import { exists } from "./file.js";
+/**
+ * Updates or inserts a single property in a Java-style properties file.
+ * @param propertiesPath - Path to the properties file
+ * @param key - Property key to update or insert
+ * @param value - Property value to set
+ */
+export async function upsertProperty(propertiesPath, key, value) {
+    // Delegate to batch function with single-entry map
+    await upsertProperties(propertiesPath, new Map([[key, value]]));
+}
+/**
+ * Updates or inserts multiple properties in a Java-style properties file.
+ * Updates existing properties in place, appends new ones to the end.
+ * @param propertiesPath - Path to the properties file
+ * @param properties - Map of property keys to values
+ * @throws {Error} If file operations fail
+ */
+export async function upsertProperties(propertiesPath, properties) {
+    // Early return for empty updates (optimization)
+    if (properties.size === 0) {
+        return; // Nothing to update
+    }
+    // Check if properties file already exists
+    const propertiesExist = await exists(propertiesPath);
+    let updatedContent;
+    if (propertiesExist) {
+        // File exists - read current content and update properties
+        let content = await fs.readFile(propertiesPath, "utf8");
+        // Process each property update
+        for (const [key, value] of properties) {
+            // Escape special regex characters in property key
+            // This ensures keys like 'my.app.version' don't become regex patterns
+            const escapedKey = key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+            // Match property lines: key=value or key:value (with optional whitespace)
+            // Anchored to line start (^) and end ($) with multiline flag (m)
+            const propertyRegex = new RegExp(`^${escapedKey}\\s*[=:]\\s*.*$`, "m");
+            if (propertyRegex.test(content)) {
+                // Property exists - replace the line with updated value
+                content = content.replace(propertyRegex, `${key}=${value}`);
+            }
+            else {
+                // Property doesn't exist - append to end of file
+                // Add newline separator if file doesn't end with one
+                const separator = content.endsWith("\n") ? "" : "\n";
+                content = content + separator + `${key}=${value}\n`;
+            }
+        }
+        updatedContent = content;
+    }
+    else {
+        // File doesn't exist - create new properties content
+        const lines = [];
+        for (const [key, value] of properties) {
+            lines.push(`${key}=${value}`);
+        }
+        updatedContent = lines.join("\n") + "\n";
+    }
+    // Write updated content to file (creates or overwrites)
+    await fs.writeFile(propertiesPath, updatedContent, "utf8");
+}

package/dist/utils/versioning.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Applies the '-SNAPSHOT' suffix to a version string.
+ * Idempotent - returns unchanged if already ends with '-SNAPSHOT'.
+ * @param version - Version string to convert to a snapshot version
+ * @returns Version string with '-SNAPSHOT' suffix
+ */
+export declare function applySnapshotSuffix(version: string): string;
+//# sourceMappingURL=versioning.d.ts.map

package/dist/utils/versioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.d.ts","sourceRoot":"","sources":["../../src/utils/versioning.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAS3D"}

package/dist/utils/versioning.js

@@ -0,0 +1,17 @@
+/** Suffix appended to version strings to denote a snapshot (development) version ('-SNAPSHOT'). */
+const SNAPSHOT_SUFFIX = "-SNAPSHOT";
+/**
+ * Applies the '-SNAPSHOT' suffix to a version string.
+ * Idempotent - returns unchanged if already ends with '-SNAPSHOT'.
+ * @param version - Version string to convert to a snapshot version
+ * @returns Version string with '-SNAPSHOT' suffix
+ */
+export function applySnapshotSuffix(version) {
+    // Don't add -SNAPSHOT if it's already there
+    // This makes the function idempotent and prevents duplicates like '1.0.0-SNAPSHOT-SNAPSHOT'
+    if (version.endsWith(SNAPSHOT_SUFFIX)) {
+        return version;
+    }
+    // Append the snapshot suffix to mark this as a development version
+    return `${version}${SNAPSHOT_SUFFIX}`;
+}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@muverse/core",
+  "version": "0.1.0",
+  "description": "μVERSE Core - Version Engine for Repo Semantic Evolution (core business logic)",
+  "type": "module",
+  "main": "dist/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "scripts": {
+    "build": "npm run build:esm",
+    "build:esm": "tsc --project tsconfig.json --outDir dist && npm run copy-assets",
+    "build:cjs": "tsc --project tsconfig.cjs.json --outDir dist && npm run copy-assets",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage",
+    "lint": "eslint src/**/*.ts",
+    "format": "prettier --write src/**/*.ts",
+    "copy-assets": "cpx \"src/adapters/gradle/init-project-information.gradle.kts\" \"dist/adapters/gradle/\""
+  },
+  "keywords": [
+    "muverse",
+    "core",
+    "semantic-versioning",
+    "conventional-commits",
+    "version-engine",
+    "dependency-cascade",
+    "monorepo"
+  ],
+  "author": "tvcsantos",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tvcsantos/muverse.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tvcsantos/muverse/issues"
+  },
+  "homepage": "https://github.com/tvcsantos/muverse#readme",
+  "files": [
+    "dist"
+  ],
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "conventional-commits-parser": "^6.2.1",
+    "cosmiconfig": "^9.0.0",
+    "deepmerge": "^4.3.1",
+    "execa": "^9.6.1",
+    "semver": "^7.5.4",
+    "yaml": "^2.3.4",
+    "zod": "^4.1.12"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.23",
+    "@types/semver": "^7.5.6",
+    "@typescript-eslint/eslint-plugin": "^6.15.0",
+    "@typescript-eslint/parser": "^6.15.0",
+    "@vitest/coverage-v8": "^1.1.0",
+    "cpx": "^1.5.0",
+    "eslint": "^8.56.0",
+    "prettier": "^3.1.1",
+    "typescript": "^5.3.3",
+    "vitest": "^1.1.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}