@edcalderon/versioning 1.0.3 → 1.0.4

package/README.md

@@ -11,6 +11,7 @@ A comprehensive versioning and changelog management tool designed for monorepos
 - 📦 NPM publishable
 - 🏷️ Git tagging and committing
 - ✅ Validation of version sync
+- 🔌 **Extensible plugin system** for custom business logic
 
 ## Installation
 
@@ -22,21 +23,34 @@ pnpm add -g @edcalderon/versioning
 yarn global add @edcalderon/versioning
 ```
 
+## Extensions
+
+The versioning tool supports a **composable extension system** that allows you to add custom business logic and commands. Extensions can:
+
+- Add new CLI commands
+- Hook into existing workflows (pre/post version bumps, releases, etc.)
+- Integrate with external services
+- Implement custom versioning strategies
+
+Extensions are loaded automatically from:
+- Built-in extensions in the `src/extensions/` directory
+- External packages listed in `versioning.config.json`
+
 ## Quick Start
 
 1. Initialize configuration:
 ```bash
-ed-version init
+versioning init
 ```
 
 2. Bump version and generate changelog:
 ```bash
-ed-version bump patch
+versioning bump patch
 ```
 
 3. Sync versions across packages (for monorepos):
 ```bash
-ed-version sync
+versioning sync
 ```
 
 ### Edward's Monorepo Example
@@ -45,7 +59,7 @@ For this specific monorepo with dashboard app:
 
 ```bash
 # Initialize config
-ed-version init
+versioning init
 
 # Edit versioning.config.json to:
 {
@@ -54,10 +68,10 @@ ed-version init
 }
 
 # Sync dashboard with main version
-ed-version patch --packages "apps/dashboard"
+versioning patch --packages "apps/dashboard"
 
 # Versioning package maintains its own version
-cd packages/versioning && ed-version patch --skip-sync
+cd packages/versioning && versioning patch --skip-sync
 ```
 
 ## Configuration
@@ -101,39 +115,39 @@ For monorepos:
 
 ### Release Commands
 
-#### `ed-version patch [options]`
+#### `versioning patch [options]`
 
 Create a patch release (bumps 1.0.0 → 1.0.1)
 
 ```bash
-ed-version patch
-ed-version patch --packages "packages/app1,packages/app2" --message "Fix critical bug"
+versioning patch
+versioning patch --packages "packages/app1,packages/app2" --message "Fix critical bug"
 ```
 
-#### `ed-version minor [options]`
+#### `versioning minor [options]`
 
 Create a minor release (bumps 1.0.0 → 1.1.0)
 
 ```bash
-ed-version minor
-ed-version minor --packages "apps/dashboard" --message "Add new features"
+versioning minor
+versioning minor --packages "apps/dashboard" --message "Add new features"
 ```
 
-#### `ed-version major [options]`
+#### `versioning major [options]`
 
 Create a major release (bumps 1.0.0 → 2.0.0)
 
 ```bash
-ed-version major --message "Breaking changes"
+versioning major --message "Breaking changes"
 ```
 
-#### `ed-version release <version> [options]`
+#### `versioning release <version> [options]`
 
 Create a custom release with specific version
 
 ```bash
-ed-version release 1.2.3 --message "Custom release"
-ed-version release 2.0.0-beta.1 --skip-sync
+versioning release 1.2.3 --message "Custom release"
+versioning release 2.0.0-beta.1 --skip-sync
 ```
 
 **Options for release commands:**
@@ -156,7 +170,7 @@ Options:
 - `--no-commit`: Don't commit changes
 - `--no-tag`: Don't create git tag
 
-### `ed-version changelog [options]`
+### `versioning changelog [options]`
 
 Generate changelog from commits.
 
@@ -165,7 +179,7 @@ Options:
 - `-t, --to <commit>`: To commit
 - `-c, --config <file>`: Config file path
 
-### `ed-version sync [options]`
+### `versioning sync [options]`
 
 Sync versions across all packages.
 
@@ -173,14 +187,14 @@ Options:
 - `-v, --version <version>`: Target version to sync to
 - `-c, --config <file>`: Config file path
 
-### `ed-version validate [options]`
+### `versioning validate [options]`
 
 Validate that all packages have the correct version.
 
 Options:
 - `-c, --config <file>`: Config file path
 
-### `ed-version init [options]`
+### `versioning init [options]`
 
 Initialize a new versioning config file.
 
@@ -205,7 +219,7 @@ Add to your release workflow:
 Use with husky for automated versioning:
 
 ```bash
-npx husky add .husky/pre-commit "ed-version validate"
+npx husky add .husky/pre-commit "versioning validate"
 ```
 
 ## Conventional Commits
@@ -232,7 +246,7 @@ This package uses GitHub Actions for automated publishing to NPM when version ta
 
 1. **Update Version**: Use the versioning commands to bump version and update changelog
    ```bash
-   ed-version patch  # or minor, major
+   versioning patch  # or minor, major
    ```
 
 2. **Create Git Tag**: The package includes a helper script to create and push version tags

package/dist/cli.js

@@ -40,11 +40,12 @@ const versioning_1 = require("./versioning");
 const changelog_1 = require("./changelog");
 const sync_1 = require("./sync");
 const release_1 = require("./release");
+const extensions_1 = require("./extensions");
 const program = new commander_1.Command();
 program
-    .name('ed-version')
+    .name('versioning')
     .description('Comprehensive versioning and changelog management for monorepos')
-    .version('1.0.0');
+    .version('1.0.4');
 program
     .command('bump <type>')
     .description('Bump version (patch, minor, major, prerelease)')
@@ -290,7 +291,8 @@ program
             changelogFile: 'CHANGELOG.md',
             conventionalCommits: true,
             syncDependencies: false,
-            ignorePackages: []
+            ignorePackages: [],
+            extensions: [] // Add extensions array to config
         };
         await fs.writeJson(configPath, defaultConfig, { spaces: 2 });
         console.log('✅ Initialized versioning config at versioning.config.json');
@@ -302,9 +304,22 @@ program
 });
 async function loadConfig(configPath) {
     if (!(await fs.pathExists(configPath))) {
-        throw new Error(`Config file not found: ${configPath}. Run 'ed-version init' to create one.`);
+        throw new Error(`Config file not found: ${configPath}. Run 'versioning init' to create one.`);
     }
     return await fs.readJson(configPath);
 }
 program.parse();
+async function main() {
+    try {
+        // Load and register extensions
+        await (0, extensions_1.loadExtensions)(program);
+        // Parse command line arguments
+        program.parse();
+    }
+    catch (error) {
+        console.error('❌ Error loading extensions:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+main();
 //# sourceMappingURL=cli.js.map

package/dist/extensions.d.ts

@@ -0,0 +1,17 @@
+import { Command } from 'commander';
+export interface VersioningExtension {
+    name: string;
+    description: string;
+    version: string;
+    register: (program: Command, config: any) => void | Promise<void>;
+}
+export interface ExtensionContext {
+    config: any;
+    versionManager?: any;
+    changelogManager?: any;
+    syncManager?: any;
+    releaseManager?: any;
+}
+export declare function loadExtensions(program: Command): Promise<void>;
+export declare function createExtensionContext(config: any): ExtensionContext;
+//# sourceMappingURL=extensions.d.ts.map

package/dist/extensions.js

@@ -0,0 +1,104 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadExtensions = loadExtensions;
+exports.createExtensionContext = createExtensionContext;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+async function loadExtensions(program) {
+    try {
+        // Try to load config to get extensions list
+        let config = {};
+        if (await fs.pathExists('versioning.config.json')) {
+            config = await fs.readJson('versioning.config.json');
+        }
+        const extensions = config.extensions || [];
+        // Load built-in extensions from local extensions directory
+        const extensionsDir = path.join(__dirname, 'extensions');
+        if (await fs.pathExists(extensionsDir)) {
+            const extensionFiles = await fs.readdir(extensionsDir);
+            for (const file of extensionFiles) {
+                if (file.endsWith('.js') || file.endsWith('.ts')) {
+                    try {
+                        const extensionPath = path.join(extensionsDir, file);
+                        const extension = require(extensionPath);
+                        if (extension && typeof extension.register === 'function') {
+                            await extension.register(program, config);
+                            console.log(`✅ Loaded extension: ${extension.name}@${extension.version}`);
+                        }
+                    }
+                    catch (error) {
+                        console.warn(`⚠️  Failed to load extension ${file}:`, error instanceof Error ? error.message : String(error));
+                    }
+                }
+            }
+        }
+        // Load external extensions from node_modules or specified paths
+        for (const extConfig of extensions) {
+            try {
+                let extension;
+                if (typeof extConfig === 'string') {
+                    // Load from node_modules
+                    extension = require(extConfig);
+                }
+                else if (extConfig.path) {
+                    // Load from custom path
+                    extension = require(path.resolve(extConfig.path));
+                }
+                else {
+                    continue;
+                }
+                if (extension && typeof extension.register === 'function') {
+                    await extension.register(program, config);
+                    console.log(`✅ Loaded external extension: ${extension.name}@${extension.version}`);
+                }
+            }
+            catch (error) {
+                console.warn(`⚠️  Failed to load external extension:`, error instanceof Error ? error.message : String(error));
+            }
+        }
+    }
+    catch (error) {
+        // Don't fail if extensions can't be loaded, just warn
+        console.warn('⚠️  Could not load extensions:', error instanceof Error ? error.message : String(error));
+    }
+}
+function createExtensionContext(config) {
+    return {
+        config,
+        // Managers will be injected when available
+    };
+}
+//# sourceMappingURL=extensions.js.map

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@edcalderon/versioning",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "A comprehensive versioning and changelog management tool for monorepos",
   "main": "dist/index.js",
   "bin": {
-    "ed-version": "dist/cli.js"
+    "versioning": "dist/cli.js"
   },
   "scripts": {
     "build": "tsc",