@contractual/changesets 0.1.0-dev.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (C) 2025 Omer Morad
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/changesets/consume.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Changeset consumption utilities
+ * Processes changesets for the version command
+ */
+import type { BumpType, ChangesetFile } from '@contractual/types';
+/**
+ * Aggregate bumps from multiple changesets
+ * For each contract, the highest bump type wins
+ *
+ * @param changesets - Array of parsed changeset files
+ * @returns Map of contract name to aggregated bump type
+ */
+export declare function aggregateBumps(changesets: readonly ChangesetFile[]): Record<string, BumpType>;
+/**
+ * Extract the markdown section for a specific contract from changesets
+ * Combines all change descriptions for the contract across all changesets
+ *
+ * @param changesets - Array of parsed changeset files
+ * @param contractName - Name of the contract to extract changes for
+ * @returns Combined markdown content for the contract
+ */
+export declare function extractContractChanges(changesets: readonly ChangesetFile[], contractName: string): string;
+//# sourceMappingURL=consume.d.ts.map

package/dist/changesets/consume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consume.d.ts","sourceRoot":"","sources":["../../changesets/consume.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAkBlE;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,SAAS,aAAa,EAAE,GACnC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAW1B;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,SAAS,aAAa,EAAE,EACpC,YAAY,EAAE,MAAM,GACnB,MAAM,CAiBR"}

package/dist/changesets/consume.js

@@ -0,0 +1,89 @@
+/**
+ * Changeset consumption utilities
+ * Processes changesets for the version command
+ */
+/**
+ * Bump type priority for comparison (higher = more significant)
+ */
+const BUMP_PRIORITY = {
+    major: 3,
+    minor: 2,
+    patch: 1,
+};
+/**
+ * Compare two bump types and return the higher priority one
+ */
+function higherBump(a, b) {
+    return BUMP_PRIORITY[a] >= BUMP_PRIORITY[b] ? a : b;
+}
+/**
+ * Aggregate bumps from multiple changesets
+ * For each contract, the highest bump type wins
+ *
+ * @param changesets - Array of parsed changeset files
+ * @returns Map of contract name to aggregated bump type
+ */
+export function aggregateBumps(changesets) {
+    const aggregated = {};
+    for (const changeset of changesets) {
+        for (const [contract, bump] of Object.entries(changeset.bumps)) {
+            const existing = aggregated[contract];
+            aggregated[contract] = existing ? higherBump(existing, bump) : bump;
+        }
+    }
+    return aggregated;
+}
+/**
+ * Extract the markdown section for a specific contract from changesets
+ * Combines all change descriptions for the contract across all changesets
+ *
+ * @param changesets - Array of parsed changeset files
+ * @param contractName - Name of the contract to extract changes for
+ * @returns Combined markdown content for the contract
+ */
+export function extractContractChanges(changesets, contractName) {
+    const sections = [];
+    for (const changeset of changesets) {
+        // Only process changesets that affect this contract
+        if (!(contractName in changeset.bumps)) {
+            continue;
+        }
+        // Extract the section for this contract from the body
+        const section = extractSectionFromBody(changeset.body, contractName);
+        if (section) {
+            sections.push(section);
+        }
+    }
+    return sections.join('\n\n');
+}
+/**
+ * Extract a contract's section from a changeset body
+ * Looks for ## ContractName and extracts content until the next ## or end
+ */
+function extractSectionFromBody(body, contractName) {
+    const lines = body.split('\n');
+    const headerPattern = new RegExp(`^##\\s+${escapeRegex(contractName)}\\s*$`);
+    let inSection = false;
+    const sectionLines = [];
+    for (const line of lines) {
+        if (headerPattern.test(line)) {
+            inSection = true;
+            continue;
+        }
+        if (inSection) {
+            // Check if we've hit the next section
+            if (line.startsWith('## ')) {
+                break;
+            }
+            sectionLines.push(line);
+        }
+    }
+    return sectionLines.join('\n').trim();
+}
+/**
+ * Escape special regex characters in a string
+ */
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=consume.js.map

package/dist/changesets/consume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consume.js","sourceRoot":"","sources":["../../changesets/consume.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,aAAa,GAAuC;IACxD,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;CACA,CAAC;AAEX;;GAEG;AACH,SAAS,UAAU,CAAC,CAAW,EAAE,CAAW;IAC1C,OAAO,aAAa,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,UAAoC;IAEpC,MAAM,UAAU,GAA6B,EAAE,CAAC;IAEhD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/D,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YACtC,UAAU,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACtE,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,UAAoC,EACpC,YAAoB;IAEpB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,oDAAoD;QACpD,IAAI,CAAC,CAAC,YAAY,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACvC,SAAS;QACX,CAAC;QAED,sDAAsD;QACtD,MAAM,OAAO,GAAG,sBAAsB,CAAC,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACrE,IAAI,OAAO,EAAE,CAAC;YACZ,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,SAAS,sBAAsB,CAAC,IAAY,EAAE,YAAoB;IAChE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,aAAa,GAAG,IAAI,MAAM,CAAC,UAAU,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAE7E,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,SAAS,GAAG,IAAI,CAAC;YACjB,SAAS;QACX,CAAC;QAED,IAAI,SAAS,EAAE,CAAC;YACd,sCAAsC;YACtC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3B,MAAM;YACR,CAAC;YACD,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC"}

package/dist/changesets/create.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Changeset creation utilities
+ * Creates changeset files from diff results
+ */
+import type { DiffResult, BumpType } from '@contractual/types';
+/**
+ * Result of creating a changeset file
+ */
+export interface CreateChangesetResult {
+    /** Generated filename (e.g., "brave-tigers-fly.md") */
+    filename: string;
+    /** Full content of the changeset file including frontmatter and body */
+    content: string;
+}
+/**
+ * Create a changeset from diff results
+ *
+ * @param results - Array of diff results from comparing specs
+ * @param overrides - Optional map of contract name to bump type overrides
+ * @returns Object with filename and content for the changeset file
+ */
+export declare function createChangeset(results: DiffResult[], overrides?: Readonly<Record<string, BumpType>>): CreateChangesetResult;
+//# sourceMappingURL=create.d.ts.map

package/dist/changesets/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../changesets/create.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAkB,MAAM,oBAAoB,CAAC;AAG/E;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;CACjB;AAgCD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,UAAU,EAAE,EACrB,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,GAC7C,qBAAqB,CA0CvB"}

package/dist/changesets/create.js

@@ -0,0 +1,72 @@
+/**
+ * Changeset creation utilities
+ * Creates changeset files from diff results
+ */
+import { generateChangesetName } from './naming.js';
+/**
+ * Severity label mapping for display purposes
+ */
+const SEVERITY_LABELS = {
+    breaking: 'BREAKING',
+    'non-breaking': 'minor',
+    patch: 'patch',
+    unknown: 'unknown',
+};
+/**
+ * Map change severity to display label
+ */
+function severityToLabel(severity) {
+    return SEVERITY_LABELS[severity];
+}
+/**
+ * Determine the suggested bump type for a contract based on its changes
+ */
+function determineBumpType(result) {
+    if (result.summary.breaking > 0) {
+        return 'major';
+    }
+    if (result.summary.nonBreaking > 0) {
+        return 'minor';
+    }
+    return 'patch';
+}
+/**
+ * Create a changeset from diff results
+ *
+ * @param results - Array of diff results from comparing specs
+ * @param overrides - Optional map of contract name to bump type overrides
+ * @returns Object with filename and content for the changeset file
+ */
+export function createChangeset(results, overrides) {
+    const filename = `${generateChangesetName()}.md`;
+    // Build YAML frontmatter
+    const bumps = {};
+    for (const result of results) {
+        if (result.changes.length === 0) {
+            continue;
+        }
+        const suggestedBump = determineBumpType(result);
+        bumps[result.contract] = overrides?.[result.contract] ?? suggestedBump;
+    }
+    // Generate YAML frontmatter
+    const yamlLines = Object.entries(bumps).map(([contract, bump]) => `"${contract}": ${bump}`);
+    const frontmatter = `---\n${yamlLines.join('\n')}\n---`;
+    // Generate markdown body with changes grouped by contract
+    const bodyParts = [];
+    for (const result of results) {
+        if (result.changes.length === 0) {
+            continue;
+        }
+        bodyParts.push(`## ${result.contract}`);
+        bodyParts.push('');
+        for (const change of result.changes) {
+            const label = severityToLabel(change.severity);
+            bodyParts.push(`- **[${label}]** ${change.message}`);
+        }
+        bodyParts.push('');
+    }
+    const body = bodyParts.join('\n').trim();
+    const content = `${frontmatter}\n\n${body}\n`;
+    return { filename, content };
+}
+//# sourceMappingURL=create.js.map

package/dist/changesets/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../changesets/create.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAYpD;;GAEG;AACH,MAAM,eAAe,GAAmC;IACtD,QAAQ,EAAE,UAAU;IACpB,cAAc,EAAE,OAAO;IACvB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;CACV,CAAC;AAEX;;GAEG;AACH,SAAS,eAAe,CAAC,QAAwB;IAC/C,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,MAAkB;IAC3C,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QACnC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAqB,EACrB,SAA8C;IAE9C,MAAM,QAAQ,GAAG,GAAG,qBAAqB,EAAE,KAAK,CAAC;IAEjD,yBAAyB;IACzB,MAAM,KAAK,GAA6B,EAAE,CAAC;IAC3C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,SAAS;QACX,CAAC;QACD,MAAM,aAAa,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAChD,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC;IACzE,CAAC;IAED,4BAA4B;IAC5B,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CACzC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,QAAQ,MAAM,IAAI,EAAE,CAC/C,CAAC;IACF,MAAM,WAAW,GAAG,QAAQ,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;IAExD,0DAA0D;IAC1D,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,SAAS;QACX,CAAC;QAED,SAAS,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEnB,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC/C,SAAS,CAAC,IAAI,CAAC,QAAQ,KAAK,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,GAAG,WAAW,OAAO,IAAI,IAAI,CAAC;IAE9C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC"}

package/dist/changesets/index.d.ts

@@ -0,0 +1,5 @@
+export * from './naming.js';
+export * from './create.js';
+export * from './read.js';
+export * from './consume.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/changesets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../changesets/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC"}

package/dist/changesets/index.js

@@ -0,0 +1,5 @@
+export * from './naming.js';
+export * from './create.js';
+export * from './read.js';
+export * from './consume.js';
+//# sourceMappingURL=index.js.map

package/dist/changesets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../changesets/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC"}

package/dist/changesets/naming.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Changeset naming utilities
+ * Generates random three-word names for changeset files
+ */
+/**
+ * Generate a random three-word changeset name
+ * Format: adjective-noun-verb (e.g., "brave-tigers-fly")
+ */
+export declare function generateChangesetName(): string;
+/**
+ * Generate a unique changeset name that doesn't collide with existing names
+ * Retries with new random names until a unique one is found
+ *
+ * @param existingNames - Array of existing changeset names to avoid
+ * @param maxRetries - Maximum number of retries before giving up (default: 100)
+ * @returns A unique changeset name
+ * @throws Error if unable to generate a unique name after max retries
+ */
+export declare function generateUniqueChangesetName(existingNames: string[], maxRetries?: number): string;
+//# sourceMappingURL=naming.d.ts.map

package/dist/changesets/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../changesets/naming.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqFH;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAM9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,MAAM,EAAE,EACvB,UAAU,SAAM,GACf,MAAM,CAaR"}

package/dist/changesets/naming.js

@@ -0,0 +1,115 @@
+/**
+ * Changeset naming utilities
+ * Generates random three-word names for changeset files
+ */
+const ADJECTIVES = [
+    'brave',
+    'calm',
+    'eager',
+    'fancy',
+    'gentle',
+    'happy',
+    'jolly',
+    'kind',
+    'lively',
+    'mighty',
+    'noble',
+    'proud',
+    'quick',
+    'ready',
+    'sharp',
+    'swift',
+    'tender',
+    'vivid',
+    'warm',
+    'zesty',
+];
+const NOUNS = [
+    'bears',
+    'cats',
+    'dogs',
+    'eagles',
+    'foxes',
+    'geese',
+    'hawks',
+    'ibis',
+    'jays',
+    'kites',
+    'lions',
+    'mice',
+    'newts',
+    'owls',
+    'pandas',
+    'quails',
+    'ravens',
+    'seals',
+    'tigers',
+    'wolves',
+];
+const VERBS = [
+    'fly',
+    'run',
+    'jump',
+    'swim',
+    'dance',
+    'sing',
+    'play',
+    'rest',
+    'hunt',
+    'roam',
+    'climb',
+    'glide',
+    'soar',
+    'leap',
+    'dash',
+    'drift',
+    'march',
+    'prowl',
+    'race',
+    'sprint',
+];
+/**
+ * Get a random element from an array
+ * @throws {Error} If the array is empty
+ */
+function randomElement(array) {
+    if (array.length === 0) {
+        throw new Error('Cannot get random element from empty array');
+    }
+    const index = Math.floor(Math.random() * array.length);
+    const element = array[index];
+    // This assertion is safe because we've checked array.length > 0 and index is within bounds
+    return element;
+}
+/**
+ * Generate a random three-word changeset name
+ * Format: adjective-noun-verb (e.g., "brave-tigers-fly")
+ */
+export function generateChangesetName() {
+    const adjective = randomElement(ADJECTIVES);
+    const noun = randomElement(NOUNS);
+    const verb = randomElement(VERBS);
+    return `${adjective}-${noun}-${verb}`;
+}
+/**
+ * Generate a unique changeset name that doesn't collide with existing names
+ * Retries with new random names until a unique one is found
+ *
+ * @param existingNames - Array of existing changeset names to avoid
+ * @param maxRetries - Maximum number of retries before giving up (default: 100)
+ * @returns A unique changeset name
+ * @throws Error if unable to generate a unique name after max retries
+ */
+export function generateUniqueChangesetName(existingNames, maxRetries = 100) {
+    const existingSet = new Set(existingNames);
+    for (let i = 0; i < maxRetries; i++) {
+        const name = generateChangesetName();
+        if (!existingSet.has(name)) {
+            return name;
+        }
+    }
+    // Fallback: append timestamp to ensure uniqueness
+    const baseName = generateChangesetName();
+    return `${baseName}-${Date.now()}`;
+}
+//# sourceMappingURL=naming.js.map

package/dist/changesets/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../../changesets/naming.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,GAAG;IACjB,OAAO;IACP,MAAM;IACN,OAAO;IACP,OAAO;IACP,QAAQ;IACR,OAAO;IACP,OAAO;IACP,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,QAAQ;IACR,OAAO;IACP,MAAM;IACN,OAAO;CACC,CAAC;AAEX,MAAM,KAAK,GAAG;IACZ,OAAO;IACP,MAAM;IACN,MAAM;IACN,QAAQ;IACR,OAAO;IACP,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,MAAM;IACN,OAAO;IACP,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,QAAQ;CACA,CAAC;AAEX,MAAM,KAAK,GAAG;IACZ,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;IACP,MAAM;IACN,QAAQ;CACA,CAAC;AAEX;;;GAGG;AACH,SAAS,aAAa,CAAI,KAAmB;IAC3C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,2FAA2F;IAC3F,OAAO,OAAY,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,SAAS,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAElC,OAAO,GAAG,SAAS,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;AACxC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,2BAA2B,CACzC,aAAuB,EACvB,UAAU,GAAG,GAAG;IAEhB,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;IAE3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,qBAAqB,EAAE,CAAC;QACrC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAC;IACzC,OAAO,GAAG,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;AACrC,CAAC"}

package/dist/changesets/read.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Changeset reading and parsing utilities
+ * Parses changeset files from the .contractual/changesets directory
+ */
+import type { BumpType, ChangesetFile } from '@contractual/types';
+/**
+ * Error thrown when parsing a changeset file fails
+ */
+export declare class ChangesetParseError extends Error {
+    readonly filename?: string | undefined;
+    constructor(message: string, filename?: string | undefined);
+}
+/**
+ * Parsed changeset content (before wrapping with filename)
+ */
+export interface ParsedChangesetContent {
+    /** Map of contract name to bump type */
+    bumps: Record<string, BumpType>;
+    /** Markdown body with change descriptions */
+    body: string;
+}
+/**
+ * Parse a changeset file content into its components
+ *
+ * @param content - Raw content of the changeset file
+ * @returns Parsed bumps and body
+ * @throws {ChangesetParseError} If the content is malformed
+ */
+export declare function parseChangeset(content: string): ParsedChangesetContent;
+/**
+ * Read all changeset files from a directory
+ *
+ * @param changesetsDir - Path to the changesets directory
+ * @returns Array of parsed changeset files
+ */
+export declare function readChangesets(changesetsDir: string): Promise<ChangesetFile[]>;
+//# sourceMappingURL=read.d.ts.map

package/dist/changesets/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../changesets/read.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOlE;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,QAAQ,CAAC,EAAE,MAAM;gBADjC,OAAO,EAAE,MAAM,EACC,QAAQ,CAAC,EAAE,MAAM,YAAA;CAKpC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAChC,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;CACd;AASD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,CA4CtE;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAoCpF"}

package/dist/changesets/read.js

@@ -0,0 +1,111 @@
+/**
+ * Changeset reading and parsing utilities
+ * Parses changeset files from the .contractual/changesets directory
+ */
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+/**
+ * Valid bump type values
+ */
+const VALID_BUMP_TYPES = ['major', 'minor', 'patch'];
+/**
+ * Error thrown when parsing a changeset file fails
+ */
+export class ChangesetParseError extends Error {
+    filename;
+    constructor(message, filename) {
+        super(filename ? `Failed to parse changeset "${filename}": ${message}` : message);
+        this.filename = filename;
+        this.name = 'ChangesetParseError';
+    }
+}
+/**
+ * Validate that a value is a valid bump type
+ */
+function isValidBumpType(value) {
+    return VALID_BUMP_TYPES.includes(value);
+}
+/**
+ * Parse a changeset file content into its components
+ *
+ * @param content - Raw content of the changeset file
+ * @returns Parsed bumps and body
+ * @throws {ChangesetParseError} If the content is malformed
+ */
+export function parseChangeset(content) {
+    const trimmed = content.trim();
+    // Check for frontmatter delimiter
+    if (!trimmed.startsWith('---')) {
+        throw new ChangesetParseError('Changeset must start with YAML frontmatter (---)');
+    }
+    // Find the closing frontmatter delimiter
+    const secondDelimiter = trimmed.indexOf('---', 3);
+    if (secondDelimiter === -1) {
+        throw new ChangesetParseError('Changeset frontmatter must be closed with ---');
+    }
+    // Extract YAML and body
+    const yamlContent = trimmed.slice(3, secondDelimiter).trim();
+    const body = trimmed.slice(secondDelimiter + 3).trim();
+    // Parse YAML
+    let parsed;
+    try {
+        parsed = parseYaml(yamlContent);
+    }
+    catch (yamlError) {
+        const message = yamlError instanceof Error ? yamlError.message : 'Invalid YAML';
+        throw new ChangesetParseError(`Invalid YAML in frontmatter: ${message}`);
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new ChangesetParseError('Changeset frontmatter must contain a YAML object');
+    }
+    // Validate and extract bumps
+    const bumps = {};
+    for (const [key, value] of Object.entries(parsed)) {
+        if (!isValidBumpType(value)) {
+            throw new ChangesetParseError(`Invalid bump type "${String(value)}" for contract "${key}". Must be ${VALID_BUMP_TYPES.join(', ')}.`);
+        }
+        bumps[key] = value;
+    }
+    return { bumps, body };
+}
+/**
+ * Read all changeset files from a directory
+ *
+ * @param changesetsDir - Path to the changesets directory
+ * @returns Array of parsed changeset files
+ */
+export async function readChangesets(changesetsDir) {
+    let files;
+    try {
+        files = await readdir(changesetsDir);
+    }
+    catch (error) {
+        // Directory doesn't exist or can't be read - no changesets
+        if (error.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+    // Filter to only .md files
+    const mdFiles = files.filter((file) => file.endsWith('.md'));
+    const changesets = [];
+    for (const filename of mdFiles) {
+        const filePath = join(changesetsDir, filename);
+        const content = await readFile(filePath, 'utf-8');
+        try {
+            const { bumps, body } = parseChangeset(content);
+            changesets.push({ filename, path: filePath, bumps, body });
+        }
+        catch (error) {
+            // Re-throw with filename context
+            if (error instanceof ChangesetParseError) {
+                throw new ChangesetParseError(error.message, filename);
+            }
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            throw new ChangesetParseError(message, filename);
+        }
+    }
+    return changesets;
+}
+//# sourceMappingURL=read.js.map

package/dist/changesets/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../changesets/read.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { generateChangesetName, generateUniqueChangesetName, } from './changesets/naming.js';
+export { createChangeset, type CreateChangesetResult } from './changesets/create.js';
+export { parseChangeset, readChangesets, ChangesetParseError, type ParsedChangesetContent, } from './changesets/read.js';
+export { aggregateBumps, extractContractChanges } from './changesets/consume.js';
+export { VersionManager, PreReleaseManager, VERSIONS_FILE, SNAPSHOTS_DIR, CHANGESETS_DIR, PRE_RELEASE_FILE, DEFAULT_VERSION, SPEC_EXTENSIONS, incrementVersion, incrementVersionWithPreRelease, VersionError, type BumpOperationResult, } from './versioning/manager.js';
+export { formatDate, appendChangelog } from './versioning/changelog.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACrF,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,KAAK,sBAAsB,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAGjF,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,8BAA8B,EAC9B,YAAY,EACZ,KAAK,mBAAmB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// Changesets
+export { generateChangesetName, generateUniqueChangesetName, } from './changesets/naming.js';
+export { createChangeset } from './changesets/create.js';
+export { parseChangeset, readChangesets, ChangesetParseError, } from './changesets/read.js';
+export { aggregateBumps, extractContractChanges } from './changesets/consume.js';
+// Versioning
+export { VersionManager, PreReleaseManager, VERSIONS_FILE, SNAPSHOTS_DIR, CHANGESETS_DIR, PRE_RELEASE_FILE, DEFAULT_VERSION, SPEC_EXTENSIONS, incrementVersion, incrementVersionWithPreRelease, VersionError, } from './versioning/manager.js';
+export { formatDate, appendChangelog } from './versioning/changelog.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,OAAO,EACL,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAA8B,MAAM,wBAAwB,CAAC;AACrF,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,GAEpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjF,aAAa;AACb,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,8BAA8B,EAC9B,YAAY,GAEb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC"}