@fuzdev/fuz_gitops 0.72.0 → 0.74.0

package/src/lib/semver.ts

@@ -1,170 +0,0 @@
-// TODO: candidate for extraction to `@fuzdev/fuz_util`
-
-/**
- * Semantic Versioning 2.0.0 utilities
- * @see https://semver.org/
- *
- * @module
- */
-
-export type BumpType = 'major' | 'minor' | 'patch';
-
-export interface Semver {
-	major: number;
-	minor: number;
-	patch: number;
-	prerelease?: string;
-	build?: string;
-}
-
-/**
- * SemVer 2.0.0 validation regex.
- * @see https://semver.org/#is-there-a-suggested-regular-expression-regex-to-check-a-semver-string
- */
-const SEMVER_REGEX =
-	/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
-
-/**
- * Parses a semver version string.
- * Accepts optional 'v' prefix for convenience.
- */
-const semver_parse = (version: string): Semver => {
-	// Remove leading 'v' if present (common in git tags)
-	const clean = version.replace(/^v/, '');
-
-	// Validate the cleaned version
-	if (!SEMVER_REGEX.test(clean)) {
-		throw new Error(`Invalid semver: ${version}`);
-	}
-
-	const match = SEMVER_REGEX.exec(clean)!;
-	return {
-		major: parseInt(match[1]!, 10),
-		minor: parseInt(match[2]!, 10),
-		patch: parseInt(match[3]!, 10),
-		prerelease: match[4],
-		build: match[5],
-	};
-};
-
-const semver_to_string = (semver: Semver): string => {
-	let version = `${semver.major}.${semver.minor}.${semver.patch}`;
-	if (semver.prerelease) {
-		version += `-${semver.prerelease}`;
-	}
-	if (semver.build) {
-		version += `+${semver.build}`;
-	}
-	return version;
-};
-
-/**
- * Compares two prerelease versions according to SemVer 2.0.0 spec.
- * Returns -1 if a < b, 0 if a === b, 1 if a > b.
- */
-const semver_compare_prerelease = (a: string | undefined, b: string | undefined): number => {
-	// Handle missing prereleases
-	if (!a && !b) return 0;
-	if (!a) return 1; // normal version > prerelease
-	if (!b) return -1; // prerelease < normal version
-
-	// Split into identifiers
-	const a_parts = a.split('.');
-	const b_parts = b.split('.');
-
-	// Compare each identifier
-	const min_length = Math.min(a_parts.length, b_parts.length);
-	for (let i = 0; i < min_length; i++) {
-		const a_part = a_parts[i]!;
-		const b_part = b_parts[i]!;
-
-		// Check if numeric
-		const a_is_numeric = /^\d+$/.test(a_part);
-		const b_is_numeric = /^\d+$/.test(b_part);
-
-		if (a_is_numeric && b_is_numeric) {
-			// Both numeric - compare numerically
-			const a_num = parseInt(a_part, 10);
-			const b_num = parseInt(b_part, 10);
-			if (a_num !== b_num) {
-				return a_num < b_num ? -1 : 1;
-			}
-		} else if (a_is_numeric && !b_is_numeric) {
-			// Numeric identifiers always have lower precedence
-			return -1;
-		} else if (!a_is_numeric && b_is_numeric) {
-			// Numeric identifiers always have lower precedence
-			return 1;
-		} else {
-			// Both alphanumeric - compare lexically
-			const cmp = a_part.localeCompare(b_part);
-			if (cmp !== 0) {
-				return cmp < 0 ? -1 : 1;
-			}
-		}
-	}
-
-	// All identifiers equal - larger set has higher precedence
-	if (a_parts.length !== b_parts.length) {
-		return a_parts.length < b_parts.length ? -1 : 1;
-	}
-
-	return 0;
-};
-
-/**
- * Compares two semver versions according to SemVer 2.0.0 spec.
- * Returns -1 if a < b, 0 if a === b, 1 if a > b.
- * Build metadata is ignored in precedence comparison.
- */
-export const semver_compare_versions = (a: string, b: string): number => {
-	const v1 = semver_parse(a);
-	const v2 = semver_parse(b);
-
-	// Compare major
-	if (v1.major !== v2.major) {
-		return v1.major < v2.major ? -1 : 1;
-	}
-
-	// Compare minor
-	if (v1.minor !== v2.minor) {
-		return v1.minor < v2.minor ? -1 : 1;
-	}
-
-	// Compare patch
-	if (v1.patch !== v2.patch) {
-		return v1.patch < v2.patch ? -1 : 1;
-	}
-
-	// Compare prerelease (build metadata is ignored)
-	return semver_compare_prerelease(v1.prerelease, v2.prerelease);
-};
-
-/**
- * Bumps a version according to the specified type.
- * Resets lower version numbers per SemVer spec.
- */
-export const semver_bump_version = (version: string, type: BumpType): string => {
-	const semver = semver_parse(version);
-
-	switch (type) {
-		case 'major':
-			semver.major++;
-			semver.minor = 0;
-			semver.patch = 0;
-			break;
-		case 'minor':
-			semver.minor++;
-			semver.patch = 0;
-			break;
-		case 'patch':
-			semver.patch++;
-			break;
-	}
-
-	// Remove prerelease and build when bumping
-	semver.prerelease = undefined;
-	semver.build = undefined;
-
-	return semver_to_string(semver);
-};

package/src/lib/serialization_types.ts

@@ -1,92 +0,0 @@
-/**
- * JSON-serializable types for command output formats.
- *
- * Gitops commands support `--format json` and `--format markdown` output modes
- * in addition to styled terminal output. These types define the JSON schema for:
- * - Dependency graph structures (`SerializedGraph`)
- * - Publishing plan predictions (`SerializedPublishingPlan`)
- *
- * Used by `gitops_analyze`, `gitops_plan`, and `gitops_publish` (dry run) when
- * `--format json` or `--outfile` is specified.
- *
- * @module
- */
-
-import type {DependencyGraph} from './dependency_graph.js';
-
-export interface SerializedNode {
-	name: string;
-	version: string;
-	dependencies: Array<{
-		name: string;
-		type: string;
-		version: string;
-	}>;
-	dependents: Array<string>;
-	publishable: boolean;
-}
-
-export interface SerializedGraph {
-	nodes: Array<SerializedNode>;
-	edges: Array<[string, string]>;
-}
-
-export interface SerializedPublishingPlan {
-	publishing_order: Array<string>;
-	version_changes: Array<{
-		package_name: string;
-		from: string;
-		to: string;
-		bump_type: string;
-		breaking: boolean;
-		has_changesets: boolean;
-		will_generate_changeset?: boolean;
-		needs_bump_escalation?: boolean;
-		existing_bump?: string;
-		required_bump?: string;
-	}>;
-	dependency_updates: Array<{
-		dependent_package: string;
-		updated_dependency: string;
-		new_version: string;
-		type: string;
-		causes_republish: boolean;
-	}>;
-	breaking_cascades: Record<string, Array<string>>;
-	warnings: Array<string>;
-	errors: Array<string>;
-}
-
-/**
- * Serializes a dependency graph to a JSON-safe format.
- */
-export const serialize_graph = (graph: DependencyGraph): SerializedGraph => {
-	const nodes: Array<SerializedNode> = [];
-	const edges: Array<[string, string]> = [];
-
-	// Serialize nodes
-	for (const node of graph.nodes.values()) {
-		const dependencies = Array.from(node.dependencies, ([dep_name, spec]) => ({
-			name: dep_name,
-			type: spec.type,
-			version: spec.version,
-		}));
-
-		nodes.push({
-			name: node.name,
-			version: node.version,
-			dependencies,
-			dependents: Array.from(node.dependents),
-			publishable: node.publishable,
-		});
-	}
-
-	// Serialize edges
-	for (const [from, tos] of graph.edges) {
-		for (const to of tos) {
-			edges.push([from, to]);
-		}
-	}
-
-	return {nodes, edges};
-};