bumpcheck 0.0.0-stage → 0.1.0

package/dist/registry/provider.js

@@ -0,0 +1,164 @@
+import { spawn } from 'node:child_process';
+import { mkdir, readFile, readdir, rm, stat, cp } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import path from 'node:path';
+function defaultCacheDir() {
+    const xdg = process.env['XDG_CACHE_HOME'];
+    const base = xdg && xdg.length > 0 ? xdg : path.join(homedir(), '.cache');
+    return path.join(base, 'bumpcheck', 'npm');
+}
+function safeSegment(s) {
+    return s.replace(/[@/]/g, '_');
+}
+async function exists(p) {
+    try {
+        await stat(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function run(bin, args, cwd) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(bin, args, { cwd, stdio: ['ignore', 'ignore', 'pipe'] });
+        let stderr = '';
+        child.stderr.on('data', (d) => (stderr += d.toString()));
+        child.on('error', reject);
+        child.on('close', (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`${bin} ${args.join(' ')} failed (${code}):\n${stderr.trim()}`));
+        });
+    });
+}
+/**
+ * Installs the exact version with npm into a per-version overlay and caches it.
+ * Scripts never run. Peer dependencies are installed so declaration files
+ * that import them still resolve.
+ */
+export class NpmProvider {
+    cacheDir;
+    registry;
+    npm;
+    inflight = new Map();
+    constructor(opts = {}) {
+        this.cacheDir = opts.cacheDir ?? defaultCacheDir();
+        this.registry = opts.registry ?? process.env['BUMPCHECK_REGISTRY'];
+        this.npm = opts.npmBinary ?? 'npm';
+    }
+    ensure(pkg, version) {
+        const key = `${pkg}@${version}`;
+        let p = this.inflight.get(key);
+        if (!p) {
+            p = this.install(pkg, version);
+            this.inflight.set(key, p);
+        }
+        return p;
+    }
+    async install(pkg, version) {
+        const overlay = path.join(this.cacheDir, `${safeSegment(pkg)}@${safeSegment(version)}`);
+        const marker = path.join(overlay, '.bumpcheck-ok');
+        if (await exists(marker))
+            return overlay;
+        await rm(overlay, { recursive: true, force: true });
+        await mkdir(overlay, { recursive: true });
+        await writeJson(path.join(overlay, 'package.json'), { name: 'bumpcheck-overlay', private: true });
+        const args = [
+            'install',
+            `${pkg}@${version}`,
+            '--ignore-scripts',
+            '--no-package-lock',
+            '--no-audit',
+            '--no-fund',
+            '--no-bin-links',
+            '--loglevel=error',
+            '--save-exact',
+        ];
+        if (this.registry)
+            args.push(`--registry=${this.registry}`);
+        await run(this.npm, args, overlay);
+        const pkgDir = path.join(overlay, 'node_modules', pkg);
+        const manifest = JSON.parse(await readFile(path.join(pkgDir, 'package.json'), 'utf8'));
+        if (manifest.version !== version) {
+            throw new Error(`Expected ${pkg}@${version}, npm installed ${manifest.version ?? 'unknown'}`);
+        }
+        // Packages without their own declarations usually have a DefinitelyTyped
+        // package. Install the one matching this major, best effort, so the
+        // overlay resolves the way the consumer's node_modules would.
+        let types;
+        if (!(await shipsTypes(pkgDir, manifest))) {
+            const typesName = definitelyTypedName(pkg);
+            const major = version.split('.')[0];
+            for (const spec of [`${typesName}@${major}`, typesName]) {
+                try {
+                    await run(this.npm, [...args.slice(0, 1), spec, ...args.slice(2)], overlay);
+                    types = spec;
+                    break;
+                }
+                catch {
+                    // No matching @types package; the report will say so.
+                }
+            }
+        }
+        await writeJson(marker, { pkg, version, types, at: new Date().toISOString() });
+        return overlay;
+    }
+}
+async function shipsTypes(pkgDir, manifest) {
+    if (manifest.types || manifest.typings)
+        return true;
+    if (manifest.exports && JSON.stringify(manifest.exports).includes('"types"'))
+        return true;
+    const entries = await readdir(pkgDir).catch(() => []);
+    return entries.some((e) => e.endsWith('.d.ts') || e.endsWith('.d.mts') || e.endsWith('.d.cts'));
+}
+/** `@scope/name` becomes `@types/scope__name`, as DefinitelyTyped does. */
+export function definitelyTypedName(pkg) {
+    if (pkg.startsWith('@')) {
+        const [scope, name] = pkg.slice(1).split('/');
+        return `@types/${scope}__${name}`;
+    }
+    return `@types/${pkg}`;
+}
+export class LocalProvider {
+    sources;
+    workDir;
+    inflight = new Map();
+    constructor(sources, workDir) {
+        this.sources = sources;
+        this.workDir = workDir;
+    }
+    ensure(pkg, version) {
+        const key = `${pkg}@${version}`;
+        let p = this.inflight.get(key);
+        if (!p) {
+            p = this.materialize(pkg, key);
+            this.inflight.set(key, p);
+        }
+        return p;
+    }
+    async materialize(pkg, key) {
+        const raw = this.sources[key];
+        if (!raw)
+            throw new Error(`LocalProvider has no source for ${key}`);
+        const src = typeof raw === 'string' ? { dir: raw } : raw;
+        const overlay = path.join(this.workDir, safeSegment(key));
+        const dest = path.join(overlay, 'node_modules', pkg);
+        await rm(overlay, { recursive: true, force: true });
+        await mkdir(path.dirname(dest), { recursive: true });
+        await cp(src.dir, dest, { recursive: true });
+        for (const [name, dir] of Object.entries(src.deps ?? {})) {
+            const depDest = path.join(overlay, 'node_modules', name);
+            await mkdir(path.dirname(depDest), { recursive: true });
+            await cp(dir, depDest, { recursive: true });
+        }
+        return overlay;
+    }
+}
+async function writeJson(file, value) {
+    const { writeFile } = await import('node:fs/promises');
+    await writeFile(file, JSON.stringify(value, null, 2) + '\n');
+}
+//# sourceMappingURL=provider.js.map

package/dist/registry/provider.js.map

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

package/dist/report/render.d.ts

@@ -0,0 +1,5 @@
+import type { Report } from '../types.js';
+/** Plain text for terminals. No color codes, so it pastes cleanly anywhere. */
+export declare function renderText(r: Report): string;
+/** GitHub-flavored markdown for a pull request comment. */
+export declare function renderMarkdown(r: Report): string;

package/dist/report/render.js

@@ -0,0 +1,227 @@
+const MAX_SIG = 160;
+function loc(l) {
+    return `${l.file}:${l.line}:${l.column}`;
+}
+function clip(s) {
+    if (!s)
+        return '';
+    const one = s.replace(/\n/g, ' ⏎ ');
+    return one.length > MAX_SIG ? one.slice(0, MAX_SIG - 1) + '…' : one;
+}
+/**
+ * Before/after excerpts centered on the first difference, so a change deep
+ * inside a long declaration is visible instead of two identical prefixes.
+ */
+function diffClips(before, after) {
+    const a = (before ?? '').replace(/\n/g, ' ⏎ ');
+    const b = (after ?? '').replace(/\n/g, ' ⏎ ');
+    let i = 0;
+    while (i < a.length && i < b.length && a[i] === b[i])
+        i++;
+    const start = Math.max(0, i - Math.floor(MAX_SIG / 3));
+    const cut = (s) => {
+        const slice = s.slice(start, start + MAX_SIG);
+        return (start > 0 ? '…' : '') + slice + (start + MAX_SIG < s.length ? '…' : '');
+    };
+    return { before: cut(a), after: cut(b) };
+}
+/**
+ * One line per distinct cause. 79 "Property 'errors' does not exist" lines
+ * are one fact with 79 sites; the JSON report keeps every site.
+ */
+function groupBreaks(breaks) {
+    const groups = new Map();
+    for (const b of breaks) {
+        const message = generalize(b.message);
+        const key = `${b.symbol ?? ''}\u0000${b.code}\u0000${message}`;
+        const g = groups.get(key);
+        if (g)
+            g.sites.push(b.location);
+        else
+            groups.set(key, { symbol: b.symbol, message, kind: b.kind, code: b.code, sites: [b.location] });
+    }
+    return [...groups.values()].sort((x, y) => y.sites.length - x.sites.length);
+}
+/** Drops the per-site type arguments so identical causes share a line. */
+function generalize(message) {
+    return message
+        .replace(/<[^<>]*(?:<[^<>]*>[^<>]*)*>/g, '<…>')
+        .replace(/'\{[^']*\}'/g, "'{…}'")
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+function headline(r) {
+    const n = r.summary.importedSymbols;
+    const what = n === 1 ? '1 symbol' : `${n} symbols`;
+    if (r.meta.untyped) {
+        return `You import ${what} from ${r.package}. ${r.to} ships no type declarations, so nothing could be checked.`;
+    }
+    if (n === 0) {
+        return `Nothing in this repo imports ${r.package}.`;
+    }
+    const s = r.summary;
+    const parts = [];
+    if (s.breaks > 0) {
+        const affected = s.removed + s.breaking;
+        const where = affected > 0 ? ` in ${affected} symbol${affected === 1 ? '' : 's'}` : '';
+        parts.push(`${s.breaks} break${s.breaks === 1 ? '' : 's'}${where}`);
+    }
+    if (s.changed > 0)
+        parts.push(`${s.changed} changed but still typecheck${s.changed === 1 ? 's' : ''}`);
+    if (s.unknown > 0)
+        parts.push(`${s.unknown} could not be checked`);
+    const tail = parts.length === 0 ? 'None changed.' : parts.join(', ') + '.';
+    return `You import ${what} from ${r.package}. ${tail} Behavior not checked.`;
+}
+function groupLines(g, maxSites) {
+    const sym = g.symbol ? `${g.symbol}  ` : '';
+    const count = g.sites.length === 1 ? '' : `  (${g.sites.length} sites)`;
+    const lines = [`  ${sym}${g.message}  TS${g.code}${count}`];
+    for (const l of g.sites.slice(0, maxSites))
+        lines.push(`    ${loc(l)}`);
+    if (g.sites.length > maxSites)
+        lines.push(`    … ${g.sites.length - maxSites} more, see --format json`);
+    return lines;
+}
+function section(title, items, out) {
+    if (items.length === 0)
+        return;
+    out.push(title);
+    for (const s of items)
+        out.push(symbolLine(s));
+    out.push('');
+}
+function symbolLine(s) {
+    const d = diffClips(s.change?.before, s.change?.after);
+    const sig = s.status === 'changed' || s.status === 'breaking'
+        ? `\n    before: ${d.before}\n    after:  ${d.after}`
+        : s.status === 'removed'
+            ? `\n    was: ${clip(s.change?.before)}`
+            : '';
+    const locs = s.locations.map((l) => `    ${loc(l)}`).join('\n');
+    return `  ${s.name}  [${s.specifier}]${sig}\n${locs}`;
+}
+/** Plain text for terminals. No color codes, so it pastes cleanly anywhere. */
+export function renderText(r) {
+    const out = [];
+    out.push(`${r.package} ${r.from} -> ${r.to}`);
+    out.push(headline(r));
+    out.push('');
+    if (r.breaks.length > 0) {
+        out.push('BREAKS');
+        for (const g of groupBreaks(r.breaks))
+            out.push(...groupLines(g, 5));
+        out.push('');
+    }
+    section('REMOVED', r.imports.filter((i) => i.status === 'removed'), out);
+    section('CHANGED, BREAKS ABOVE', r.imports.filter((i) => i.status === 'breaking'), out);
+    section('CHANGED, STILL TYPECHECKS', r.imports.filter((i) => i.status === 'changed'), out);
+    section('COULD NOT BE CHECKED', r.imports.filter((i) => i.status === 'unknown'), out);
+    if (r.unanalyzed.length > 0) {
+        out.push('NOT ANALYZED');
+        for (const u of r.unanalyzed) {
+            out.push(`  ${u.reason}`);
+            for (const l of u.locations)
+                out.push(`    ${loc(l)}`);
+        }
+        out.push('');
+    }
+    const unchanged = r.imports.filter((i) => i.status === 'unchanged');
+    if (unchanged.length > 0) {
+        out.push(`UNCHANGED (${unchanged.length})`);
+        out.push('  ' + unchanged.map((s) => s.name).join(', '));
+        out.push('');
+    }
+    out.push(`Checked ${r.files.length} file${r.files.length === 1 ? '' : 's'} with TypeScript ${r.meta.typescript} in ${r.meta.durationMs} ms.`);
+    return out.join('\n');
+}
+/** GitHub-flavored markdown for a pull request comment. */
+export function renderMarkdown(r) {
+    const out = [];
+    out.push(`### \`${r.package}\` ${r.from} → ${r.to}`);
+    out.push('');
+    out.push(headline(r));
+    out.push('');
+    if (r.breaks.length > 0) {
+        out.push('**Breaks**');
+        out.push('');
+        for (const g of groupBreaks(r.breaks)) {
+            const sym = g.symbol ? `\`${g.symbol}\` ` : '';
+            if (g.sites.length === 1) {
+                out.push(`- ${sym}${g.message}  `);
+                out.push(`  \`${loc(g.sites[0])}\` (TS${g.code})`);
+            }
+            else {
+                out.push(`- ${sym}${g.message} (TS${g.code})  `);
+                out.push(`  <details><summary>${g.sites.length} sites</summary>`);
+                out.push('');
+                for (const l of g.sites)
+                    out.push(`  - \`${loc(l)}\``);
+                out.push('');
+                out.push('  </details>');
+            }
+        }
+        out.push('');
+    }
+    const removed = r.imports.filter((i) => i.status === 'removed');
+    if (removed.length > 0) {
+        out.push('**Removed**');
+        out.push('');
+        for (const s of removed) {
+            out.push(`- \`${s.name}\` from \`${s.specifier}\``);
+            for (const l of s.locations)
+                out.push(`  - \`${loc(l)}\``);
+        }
+        out.push('');
+    }
+    const breaking = r.imports.filter((i) => i.status === 'breaking');
+    if (breaking.length > 0) {
+        out.push('**Changed, see breaks above**');
+        out.push('');
+        for (const s of breaking) {
+            const d = diffClips(s.change?.before, s.change?.after);
+            out.push(`- \`${s.name}\` from \`${s.specifier}\``);
+            out.push(`  - before: \`${d.before}\``);
+            out.push(`  - after: \`${d.after}\``);
+        }
+        out.push('');
+    }
+    const changed = r.imports.filter((i) => i.status === 'changed');
+    if (changed.length > 0) {
+        out.push('<details><summary><b>Changed, still typechecks</b> (' + changed.length + ')</summary>');
+        out.push('');
+        for (const s of changed) {
+            const d = diffClips(s.change?.before, s.change?.after);
+            out.push(`- \`${s.name}\` from \`${s.specifier}\``);
+            out.push(`  - before: \`${d.before}\``);
+            out.push(`  - after: \`${d.after}\``);
+            for (const l of s.locations)
+                out.push(`  - \`${loc(l)}\``);
+        }
+        out.push('');
+        out.push('</details>');
+        out.push('');
+    }
+    const unknown = r.imports.filter((i) => i.status === 'unknown');
+    if (unknown.length > 0 || r.unanalyzed.length > 0) {
+        out.push('<details><summary><b>Could not be checked</b></summary>');
+        out.push('');
+        for (const s of unknown) {
+            out.push(`- \`${s.name}\` from \`${s.specifier}\``);
+            for (const l of s.locations)
+                out.push(`  - \`${loc(l)}\``);
+        }
+        for (const u of r.unanalyzed) {
+            out.push(`- ${u.reason}`);
+            for (const l of u.locations)
+                out.push(`  - \`${loc(l)}\``);
+        }
+        out.push('');
+        out.push('</details>');
+        out.push('');
+    }
+    out.push(`<sub>Checked ${r.files.length} file${r.files.length === 1 ? '' : 's'} with TypeScript ${r.meta.typescript}. ` +
+        `Facts only: declarations of both versions against this repo's source. Runtime behavior is not checked.</sub>`);
+    return out.join('\n');
+}
+//# sourceMappingURL=render.js.map

package/dist/report/render.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,99 @@
+/**
+ * The report is the product. Every surface (CLI, PR comment, JSON) renders
+ * from this structure. Keep it small and keep every field a verifiable fact.
+ */
+export declare const SCHEMA_VERSION: 1;
+export interface Location {
+    /** Path relative to the repo root, POSIX separators. */
+    file: string;
+    /** 1-based line. */
+    line: number;
+    /** 1-based column. */
+    column: number;
+}
+export type SymbolStatus = 
+/** Declaration text is identical between versions. */
+'unchanged'
+/** Declaration changed, but every use still typechecks. */
+ | 'changed'
+/** Declaration changed and at least one use no longer typechecks. */
+ | 'breaking'
+/** Symbol no longer exported by the new version. */
+ | 'removed'
+/** Could not be resolved in one or both versions (untyped, `any`, missing types). */
+ | 'unknown';
+export interface ImportedSymbol {
+    /** Exported name as seen by the consumer. `default` for default imports. */
+    name: string;
+    /** Module specifier as written, e.g. `axios` or `axios/lib/adapters`. */
+    specifier: string;
+    status: SymbolStatus;
+    /** Every place the symbol is imported or accessed. */
+    locations: Location[];
+    /** Present when status is `changed` or `removed`. */
+    change?: SymbolChange;
+}
+export interface SymbolChange {
+    /** Normalized declaration text in the old version, if any. */
+    before?: string;
+    /** Normalized declaration text in the new version, if any. */
+    after?: string;
+}
+export type BreakKind = 
+/** Import of a name the new version no longer exports. */
+'removed-export'
+/** Subpath or entry the new version no longer resolves. */
+ | 'missing-module'
+/** Call passes the wrong number of arguments for the new signature. */
+ | 'arity'
+/** Argument, assignment, or return no longer matches the new types. */
+ | 'type-mismatch'
+/** Property or member access that the new types do not have. */
+ | 'missing-member'
+/** A TypeScript error attributable to the bump that fits no bucket above. */
+ | 'other';
+export interface Break {
+    kind: BreakKind;
+    location: Location;
+    /** TypeScript's own message, flattened to one line. */
+    message: string;
+    /** TypeScript diagnostic code, so a reader can look it up. */
+    code: number;
+    /** The imported symbol this error involves, when it can be determined. */
+    symbol?: string;
+    /** How it was determined: the error names it, the statement uses it, or a type declared under it is involved. */
+    attribution?: 'message' | 'binding' | 'type';
+}
+export interface Unanalyzed {
+    reason: string;
+    locations: Location[];
+}
+export interface Summary {
+    importedSymbols: number;
+    unchanged: number;
+    changed: number;
+    breaking: number;
+    removed: number;
+    unknown: number;
+    breaks: number;
+    unanalyzed: number;
+}
+export interface Report {
+    schemaVersion: typeof SCHEMA_VERSION;
+    ecosystem: 'npm';
+    package: string;
+    from: string;
+    to: string;
+    /** Files in the repo that import the package, relative paths. */
+    files: string[];
+    imports: ImportedSymbol[];
+    breaks: Break[];
+    unanalyzed: Unanalyzed[];
+    summary: Summary;
+    meta: {
+        typescript: string;
+        durationMs: number;
+        /** True when the new version ships no type declarations; nothing could be proven. */
+        untyped: boolean;
+    };
+}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * The report is the product. Every surface (CLI, PR comment, JSON) renders
+ * from this structure. Keep it small and keep every field a verifiable fact.
+ */
+export const SCHEMA_VERSION = 1;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAU,CAAC"}

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "bumpcheck",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Prove whether a dependency bump breaks the code that imports it. Facts with line numbers, nothing else.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "bin": {
+    "bumpcheck": "dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint src test",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+  },
+  "keywords": [
+    "dependencies",
+    "dependabot",
+    "renovate",
+    "breaking-changes",
+    "typescript",
+    "upgrade"
+  ],
+  "dependencies": {
+    "semver": "^7.8.5",
+    "typescript": "^5.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/semver": "^7.8.0",
+    "tsx": "^4.19.0",
+    "vitest": "^2.1.0"
+  }
+}