@hyperfrontend/versioning 0.1.0

package/commits/parse/index.esm.js

@@ -0,0 +1,499 @@
+/**
+ * Safe copies of Error built-ins via factory functions.
+ *
+ * Since constructors cannot be safely captured via Object.assign, this module
+ * provides factory functions that use Reflect.construct internally.
+ *
+ * These references are captured at module initialization time to protect against
+ * prototype pollution attacks. Import only what you need for tree-shaking.
+ *
+ * @module @hyperfrontend/immutable-api-utils/built-in-copy/error
+ */
+// Capture references at module initialization time
+const _Error = globalThis.Error;
+const _Reflect = globalThis.Reflect;
+/**
+ * (Safe copy) Creates a new Error using the captured Error constructor.
+ * Use this instead of `new Error()`.
+ *
+ * @param message - Optional error message.
+ * @param options - Optional error options.
+ * @returns A new Error instance.
+ */
+const createError = (message, options) => _Reflect.construct(_Error, [message, options]);
+
+const COMMIT_TYPES = {
+    feat: { description: 'A new feature', semverBump: 'minor' },
+    fix: { description: 'A bug fix', semverBump: 'patch' },
+    docs: { description: 'Documentation only changes', semverBump: 'none' },
+    style: { description: 'Code style changes (formatting, etc.)', semverBump: 'none' },
+    refactor: { description: 'Code refactoring without feature or fix', semverBump: 'none' },
+    perf: { description: 'Performance improvements', semverBump: 'patch' },
+    test: { description: 'Adding or updating tests', semverBump: 'none' },
+    build: { description: 'Build system or dependencies', semverBump: 'none' },
+    ci: { description: 'CI/CD configuration', semverBump: 'none' },
+    chore: { description: 'Other changes', semverBump: 'none' },
+    revert: { description: 'Revert a previous commit', semverBump: 'patch' },
+};
+/**
+ * Checks if a commit type is a standard type.
+ *
+ * @param type - The commit type to check
+ * @returns True if the type is a standard conventional commit type
+ */
+function isStandardType(type) {
+    return type in COMMIT_TYPES;
+}
+
+/**
+ * Replaces all occurrences of a character in a string.
+ * Uses character-by-character iteration to avoid regex (ReDoS-safe).
+ *
+ * @param input - The input string
+ * @param target - The character to replace
+ * @param replacement - The replacement character
+ * @returns String with all occurrences replaced
+ */
+function replaceChar(input, target, replacement) {
+    const result = [];
+    for (let i = 0; i < input.length; i++) {
+        result.push(input[i] === target ? replacement : input[i]);
+    }
+    return result.join('');
+}
+/**
+ * Replaces all hyphens with spaces.
+ * Convenience wrapper for normalizing footer keys.
+ *
+ * @param input - The input string
+ * @returns String with hyphens replaced by spaces
+ */
+function hyphenToSpace(input) {
+    return replaceChar(input, '-', ' ');
+}
+
+/**
+ * Parses the body section of a commit message.
+ *
+ * The body starts after the first blank line and continues until
+ * we encounter a footer (key: value or key #value pattern) or end of message.
+ *
+ * @param lines - All lines of the commit message
+ * @param startIndex - Index to start looking for body (after header)
+ * @returns Parsed body or undefined if no body
+ */
+function parseBody(lines, startIndex) {
+    // Skip blank lines to find body start
+    let pos = startIndex;
+    while (pos < lines.length && lines[pos].trim() === '') {
+        pos++;
+    }
+    if (pos >= lines.length) {
+        return undefined;
+    }
+    // If the first non-blank line is a footer, there's no body
+    if (isFooterLine(lines[pos])) {
+        return undefined;
+    }
+    const bodyLines = [];
+    // Collect body lines until we hit a footer or end
+    while (pos < lines.length) {
+        const line = lines[pos];
+        // Check if this line looks like a footer
+        if (isFooterLine(line)) {
+            break;
+        }
+        // Check for blank line followed by a footer
+        if (line.trim() === '' && pos + 1 < lines.length && isFooterLine(lines[pos + 1])) {
+            break;
+        }
+        bodyLines.push(line);
+        pos++;
+    }
+    // Trim trailing blank lines from body
+    while (bodyLines.length > 0 && bodyLines[bodyLines.length - 1].trim() === '') {
+        bodyLines.pop();
+    }
+    if (bodyLines.length === 0) {
+        return undefined;
+    }
+    return {
+        body: bodyLines.join('\n'),
+        endIndex: pos,
+    };
+}
+/**
+ * Checks if a line looks like a footer.
+ *
+ * Footer format:
+ * - key: value
+ * - key #value (for issue references)
+ * - BREAKING CHANGE: description
+ * - BREAKING-CHANGE: description
+ *
+ * @param line - The line to check
+ * @returns True if the line looks like a footer
+ */
+function isFooterLine(line) {
+    if (!line)
+        return false;
+    const trimmed = line.trim();
+    if (trimmed === '')
+        return false;
+    // Check for BREAKING CHANGE or BREAKING-CHANGE
+    if (trimmed.startsWith('BREAKING CHANGE:') || trimmed.startsWith('BREAKING-CHANGE:')) {
+        return true;
+    }
+    // Check for token: value or token #value pattern
+    let pos = 0;
+    // Skip leading whitespace
+    while (pos < trimmed.length && trimmed[pos] === ' ') {
+        pos++;
+    }
+    // Read token (alphanumeric and hyphens)
+    const tokenStart = pos;
+    while (pos < trimmed.length) {
+        const char = trimmed[pos];
+        const code = char.charCodeAt(0);
+        if ((code >= 97 && code <= 122) || // a-z
+            (code >= 65 && code <= 90) || // A-Z
+            (code >= 48 && code <= 57) || // 0-9
+            code === 45 // -
+        ) {
+            pos++;
+        }
+        else {
+            break;
+        }
+    }
+    // Must have at least one character in token
+    if (pos === tokenStart)
+        return false;
+    // Must be followed by : or space-#
+    if (trimmed[pos] === ':') {
+        return true;
+    }
+    if (trimmed[pos] === ' ' && trimmed[pos + 1] === '#') {
+        return true;
+    }
+    return false;
+}
+
+/**
+ * Checks if a footer key indicates a breaking change.
+ *
+ * @param key - The footer key to check
+ * @returns True if the key indicates a breaking change
+ */
+function isBreakingFooterKey(key) {
+    const normalized = hyphenToSpace(key.toUpperCase());
+    return normalized === 'BREAKING CHANGE';
+}
+
+/**
+ * Parses the footer section of a commit message.
+ *
+ * @param lines - All lines of the commit message
+ * @param startIndex - Index where footers start
+ * @returns Parsed footers
+ */
+function parseFooters(lines, startIndex) {
+    const footers = [];
+    let breakingDescription;
+    let pos = startIndex;
+    // Skip blank lines
+    while (pos < lines.length && lines[pos].trim() === '') {
+        pos++;
+    }
+    while (pos < lines.length) {
+        const line = lines[pos];
+        const footer = parseFooterLine(line);
+        if (footer) {
+            footers.push(footer);
+            // Check for breaking change
+            if (isBreakingFooterKey(footer.key)) {
+                breakingDescription = footer.value;
+                // Breaking description may span multiple lines
+                pos++;
+                while (pos < lines.length && !isNewFooter(lines[pos])) {
+                    const nextLine = lines[pos];
+                    if (nextLine.trim() !== '') {
+                        breakingDescription += '\n' + nextLine;
+                    }
+                    pos++;
+                }
+                continue;
+            }
+        }
+        pos++;
+    }
+    return { footers, breakingDescription };
+}
+/**
+ * Parses a single footer line.
+ *
+ * @param line - The line to parse
+ * @returns The parsed CommitFooter or null if not a valid footer
+ */
+function parseFooterLine(line) {
+    if (!line)
+        return null;
+    const trimmed = line.trim();
+    if (trimmed === '')
+        return null;
+    // Check for BREAKING CHANGE or BREAKING-CHANGE
+    if (trimmed.startsWith('BREAKING CHANGE:')) {
+        return {
+            key: 'BREAKING CHANGE',
+            value: trimmed.slice(16).trim(),
+            separator: ':',
+        };
+    }
+    if (trimmed.startsWith('BREAKING-CHANGE:')) {
+        return {
+            key: 'BREAKING-CHANGE',
+            value: trimmed.slice(16).trim(),
+            separator: ':',
+        };
+    }
+    // Parse token: value or token #value
+    let pos = 0;
+    // Read token
+    const tokenStart = pos;
+    while (pos < trimmed.length) {
+        const char = trimmed[pos];
+        const code = char.charCodeAt(0);
+        if ((code >= 97 && code <= 122) || // a-z
+            (code >= 65 && code <= 90) || // A-Z
+            (code >= 48 && code <= 57) || // 0-9
+            code === 45 // -
+        ) {
+            pos++;
+        }
+        else {
+            break;
+        }
+    }
+    if (pos === tokenStart)
+        return null;
+    const key = trimmed.slice(tokenStart, pos);
+    // Check separator
+    let separator;
+    let valueStart;
+    if (trimmed[pos] === ':') {
+        separator = ':';
+        valueStart = pos + 1;
+    }
+    else if (trimmed[pos] === ' ' && trimmed[pos + 1] === '#') {
+        separator = ' #';
+        valueStart = pos + 2;
+    }
+    else {
+        return null;
+    }
+    // Skip whitespace after separator (for : case)
+    if (separator === ':') {
+        while (valueStart < trimmed.length && trimmed[valueStart] === ' ') {
+            valueStart++;
+        }
+    }
+    const value = trimmed.slice(valueStart);
+    return { key, value, separator };
+}
+/**
+ * Checks if a line starts a new footer.
+ *
+ * @param line - The line to check
+ * @returns True if the line starts a new footer
+ */
+function isNewFooter(line) {
+    if (!line)
+        return false;
+    return parseFooterLine(line) !== null;
+}
+
+/**
+ * Parses a conventional commit header line.
+ *
+ * @param line - The first line of the commit message
+ * @returns Parsed header with type, scope, subject, and breaking flag
+ */
+function parseHeader(line) {
+    let pos = 0;
+    const len = line.length;
+    // Extract type (alphanumeric characters until ( or : or !)
+    const typeStart = pos;
+    while (pos < len) {
+        const char = line[pos];
+        const code = char.charCodeAt(0);
+        // a-z, A-Z, 0-9
+        if ((code >= 97 && code <= 122) || (code >= 65 && code <= 90) || (code >= 48 && code <= 57)) {
+            pos++;
+        }
+        else {
+            break;
+        }
+    }
+    const type = line.slice(typeStart, pos).toLowerCase();
+    // Check for scope in parentheses
+    let scope;
+    if (line[pos] === '(') {
+        pos++; // skip (
+        const scopeStart = pos;
+        while (pos < len && line[pos] !== ')') {
+            pos++;
+        }
+        scope = line.slice(scopeStart, pos);
+        if (line[pos] === ')') {
+            pos++; // skip )
+        }
+    }
+    // Check for breaking change indicator (!)
+    const breaking = line[pos] === '!';
+    if (breaking) {
+        pos++;
+    }
+    // Expect colon
+    if (line[pos] === ':') {
+        pos++;
+    }
+    // Skip whitespace after colon
+    while (pos < len && line[pos] === ' ') {
+        pos++;
+    }
+    // Rest is subject
+    const subject = line.slice(pos).trim();
+    return {
+        type,
+        scope,
+        subject,
+        breaking,
+    };
+}
+
+/**
+ * Maximum commit message length (10KB)
+ */
+const MAX_MESSAGE_LENGTH = 10 * 1024;
+/**
+ * Parses a conventional commit message.
+ *
+ * @param message - The complete commit message
+ * @returns Parsed ConventionalCommit object
+ * @throws {Error} If message exceeds maximum length
+ */
+function parseConventionalCommit(message) {
+    if (message.length > MAX_MESSAGE_LENGTH) {
+        throw createError(`Commit message exceeds maximum length of ${MAX_MESSAGE_LENGTH} characters`);
+    }
+    const lines = splitLines(message);
+    if (lines.length === 0) {
+        return {
+            type: '',
+            subject: '',
+            footers: [],
+            breaking: false,
+            raw: message,
+        };
+    }
+    // Parse header (first line)
+    const header = parseHeader(lines[0]);
+    // Parse body and footers
+    let body;
+    let footersStartIndex = 1;
+    if (lines.length > 1) {
+        const bodyResult = parseBody(lines, 1);
+        if (bodyResult) {
+            body = bodyResult.body;
+            footersStartIndex = bodyResult.endIndex;
+        }
+    }
+    // Parse footers
+    const footersResult = parseFooters(lines, footersStartIndex);
+    const breakingDescriptionFromFooter = footersResult.breakingDescription;
+    // Determine breaking status
+    const breaking = header.breaking || footersResult.footers.some((f) => hyphenToSpace(f.key.toUpperCase()) === 'BREAKING CHANGE');
+    // Determine breaking description
+    let breakingDescription;
+    if (header.breaking && header.subject) {
+        // If breaking via !, the subject may describe the breaking change
+        breakingDescription = header.subject;
+    }
+    if (breakingDescriptionFromFooter) {
+        breakingDescription = breakingDescriptionFromFooter;
+    }
+    return {
+        type: header.type,
+        scope: header.scope,
+        subject: header.subject,
+        body,
+        footers: footersResult.footers,
+        breaking,
+        breakingDescription,
+        raw: message,
+    };
+}
+/**
+ * Splits a message into lines, handling different line endings.
+ *
+ * @param message - The message to split into lines
+ * @returns An array of lines from the message
+ */
+function splitLines(message) {
+    const lines = [];
+    let currentLine = '';
+    let i = 0;
+    while (i < message.length) {
+        const char = message[i];
+        if (char === '\r') {
+            lines.push(currentLine);
+            currentLine = '';
+            // Skip \n if this is \r\n
+            if (message[i + 1] === '\n') {
+                i++;
+            }
+        }
+        else if (char === '\n') {
+            lines.push(currentLine);
+            currentLine = '';
+        }
+        else {
+            currentLine += char;
+        }
+        i++;
+    }
+    // Add final line if not empty
+    if (currentLine || message.endsWith('\n') || message.endsWith('\r')) {
+        lines.push(currentLine);
+    }
+    return lines;
+}
+/**
+ * Checks if a commit message follows conventional commit format.
+ *
+ * @param message - The commit message to check
+ * @returns true if the message appears to be a conventional commit
+ */
+function isConventionalCommit(message) {
+    if (!message || message.trim() === '') {
+        return false;
+    }
+    const firstLine = message.split('\n')[0] ?? '';
+    const header = parseHeader(firstLine);
+    // Must have a type and subject
+    if (!header.type || !header.subject) {
+        return false;
+    }
+    // Type should not be too long (indicates not a type)
+    if (header.type.length > 20) {
+        return false;
+    }
+    // Type should be a recognized conventional commit type
+    if (!isStandardType(header.type)) {
+        return false;
+    }
+    return true;
+}
+
+export { isConventionalCommit, parseBody, parseConventionalCommit, parseFooters, parseHeader };
+//# sourceMappingURL=index.esm.js.map

package/commits/parse/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../../../../../../../../../../libs/utils/immutable-api/src/built-in-copy/error/index.ts","../../../../../../../../../../libs/versioning/src/commits/models/commit-type.ts","../../../../../../../../../../libs/versioning/src/commits/utils/replace-char.ts","../../../../../../../../../../libs/versioning/src/commits/parse/body.ts","../../../../../../../../../../libs/versioning/src/commits/models/breaking.ts","../../../../../../../../../../libs/versioning/src/commits/parse/footer.ts","../../../../../../../../../../libs/versioning/src/commits/parse/header.ts","../../../../../../../../../../libs/versioning/src/commits/parse/message.ts"],"sourcesContent":[null,null,null,null,null,null,null,null],"names":[],"mappings":"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"}

package/commits/parse/message.d.ts

@@ -0,0 +1,17 @@
+import type { ConventionalCommit } from '../models/conventional';
+/**
+ * Parses a conventional commit message.
+ *
+ * @param message - The complete commit message
+ * @returns Parsed ConventionalCommit object
+ * @throws {Error} If message exceeds maximum length
+ */
+export declare function parseConventionalCommit(message: string): ConventionalCommit;
+/**
+ * Checks if a commit message follows conventional commit format.
+ *
+ * @param message - The commit message to check
+ * @returns true if the message appears to be a conventional commit
+ */
+export declare function isConventionalCommit(message: string): boolean;
+//# sourceMappingURL=message.d.ts.map

package/commits/parse/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/versioning/src/commits/parse/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAahE;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CA2D3E;AAyCD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAwB7D"}

package/commits/utils/replace-char.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Replaces all occurrences of a character in a string.
+ * Uses character-by-character iteration to avoid regex (ReDoS-safe).
+ *
+ * @param input - The input string
+ * @param target - The character to replace
+ * @param replacement - The replacement character
+ * @returns String with all occurrences replaced
+ */
+export declare function replaceChar(input: string, target: string, replacement: string): string;
+/**
+ * Replaces all hyphens with spaces.
+ * Convenience wrapper for normalizing footer keys.
+ *
+ * @param input - The input string
+ * @returns String with hyphens replaced by spaces
+ */
+export declare function hyphenToSpace(input: string): string;
+//# sourceMappingURL=replace-char.d.ts.map

package/commits/utils/replace-char.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-char.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/versioning/src/commits/utils/replace-char.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAQtF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/flow/executor/execute.d.ts

@@ -0,0 +1,72 @@
+import type { Logger } from '@hyperfrontend/logging';
+import type { Tree } from '@hyperfrontend/project-scope';
+import type { GitClient } from '../../git/factory';
+import type { Registry } from '../../registry/models/registry';
+import type { VersionFlow } from '../models/flow';
+import type { FlowResult } from '../models/types';
+/**
+ * Options for flow execution.
+ */
+export interface ExecuteOptions {
+    /** Dry run - don't commit changes to disk */
+    dryRun?: boolean;
+    /** Verbose logging */
+    verbose?: boolean;
+    /** Custom logger (defaults to console) */
+    logger?: Logger;
+    /** Custom Tree instance (for testing) */
+    tree?: Tree;
+    /** Custom Registry instance (for testing) */
+    registry?: Registry;
+    /** Custom GitClient instance (for testing) */
+    git?: GitClient;
+}
+/**
+ * Executes a version flow.
+ *
+ * This is the main entry point for running a versioning workflow.
+ * Steps are executed in order, with state accumulated between steps.
+ *
+ * @param flow - The version flow to execute
+ * @param projectName - Name of the project to version (e.g., 'lib-versioning')
+ * @param workspaceRoot - Absolute path to workspace root
+ * @param options - Execution options
+ * @returns Flow execution result
+ *
+ * @example
+ * ```typescript
+ * import { createConventionalFlow, executeFlow } from '@hyperfrontend/versioning'
+ *
+ * const flow = createConventionalFlow({ dryRun: true })
+ * const result = await executeFlow(flow, 'lib-utils', '/path/to/workspace')
+ *
+ * console.log(result.summary)
+ * // "Flow success in 234ms: 8 completed, 0 skipped, 0 failed. Version: 1.2.3 → 1.3.0"
+ * ```
+ */
+export declare function executeFlow(flow: VersionFlow, projectName: string, workspaceRoot: string, options?: ExecuteOptions): Promise<FlowResult>;
+/**
+ * Executes a flow in dry-run mode.
+ *
+ * Convenience wrapper that sets dryRun: true.
+ *
+ * @param flow - The version flow to execute
+ * @param projectName - Name of the project to version
+ * @param workspaceRoot - Absolute path to workspace root
+ * @param options - Execution options (dryRun forced to true)
+ * @returns Flow execution result (no actual changes made)
+ */
+export declare function dryRun(flow: VersionFlow, projectName: string, workspaceRoot: string, options?: Omit<ExecuteOptions, 'dryRun'>): Promise<FlowResult>;
+/**
+ * Validates a flow before execution.
+ *
+ * Checks for:
+ * - Duplicate step IDs
+ * - Invalid dependency references
+ * - Circular dependencies
+ *
+ * @param flow - The flow to validate
+ * @returns Array of validation errors (empty if valid)
+ */
+export declare function validateFlow(flow: VersionFlow): readonly string[];
+//# sourceMappingURL=execute.d.ts.map

package/flow/executor/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/versioning/src/flow/executor/execute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,KAAK,EAA2B,UAAU,EAA+C,MAAM,iBAAiB,CAAA;AAYvH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAA;IAEhB,sBAAsB;IACtB,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,yCAAyC;IACzC,IAAI,CAAC,EAAE,IAAI,CAAA;IAEX,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,QAAQ,CAAA;IAEnB,8CAA8C;IAC9C,GAAG,CAAC,EAAE,SAAS,CAAA;CAChB;AA2FD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,UAAU,CAAC,CA4JrB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,MAAM,CAC1B,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAM,GAC3C,OAAO,CAAC,UAAU,CAAC,CAKrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,MAAM,EAAE,CA6DjE"}