@guiho/mirror 3.0.0-alpha.4 → 3.0.0-alpha.9

package/jsr.json

@@ -1,6 +1,6 @@
 {
   "name": "@guiho/mirror",
-  "version": "3.0.0-alpha.4",
+  "version": "3.0.0-alpha.9",
   "exports": "./source/guiho-mirror.ts",
   "publish": {
     "include": [

package/library/cli.d.ts

@@ -20,6 +20,10 @@ export declare const createMirrorCommand: () => import("citty").CommandDef<{
         type: "boolean";
         description: string;
     };
+    verbose: {
+        type: "boolean";
+        description: string;
+    };
 }>;
 export declare const runMirrorCli: (rawArgs?: string[]) => Promise<void>;
 //# sourceMappingURL=cli.d.ts.map

package/library/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../source/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AA+CH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;EAa5B,CAAA;AAEJ,eAAO,MAAM,YAAY,GAAU,kBAA+B,kBAyCjE,CAAA"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../source/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgDH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;EAa5B,CAAA;AAEJ,eAAO,MAAM,YAAY,GAAU,kBAA+B,kBAyEjE,CAAA"}

package/library/cli.js

@@ -18,6 +18,7 @@ const globalArgs = {
     cwd: { type: 'string', description: 'Run as if Mirror started in this directory' },
     format: { type: 'enum', options: ['text', 'json'], default: 'text', description: 'Output format' },
     'no-color': { type: 'boolean', description: 'Disable color output' },
+    verbose: { type: 'boolean', description: 'Show full error details and stack traces' },
 };
 const overrideArgs = {
     ...globalArgs,
@@ -53,6 +54,7 @@ export const createMirrorCommand = () => defineCommand({
 });
 export const runMirrorCli = async (rawArgs = process.argv.slice(2)) => {
     const effectiveArgs = rawArgs.length === 0 ? ['--help'] : rawArgs;
+    const verbose = effectiveArgs.includes('--verbose');
     const restoreColorOutput = effectiveArgs.includes('--no-color') ? stripColorFromProcessOutput() : () => { };
     try {
         if (effectiveArgs.includes('--no-color'))
@@ -78,19 +80,68 @@ export const runMirrorCli = async (rawArgs = process.argv.slice(2)) => {
                 ].join('\n') + '\n');
             });
         }
-        await runMain(createMirrorCommand(), { rawArgs: effectiveArgs });
+        // Intercept console.error during runMain to suppress citty's default
+        // ugly error dump (it does console.error(error, "\n") for non-CLIErrors).
+        // We capture the error object and handle it ourselves below.
+        let capturedError = undefined;
+        const originalConsoleError = console.error;
+        console.error = (...args) => {
+            // citty prints CLIError messages as strings — let those through
+            // citty prints non-CLIError errors as objects — capture those
+            if (args.length > 0 && args[0] instanceof Error) {
+                capturedError = args[0];
+                return;
+            }
+            originalConsoleError(...args);
+        };
+        const originalProcessExit = process.exit;
+        let exitCode;
+        process.exit = ((code) => {
+            // If runMain calls process.exit(1) after an error, intercept it
+            // so we can handle the error ourselves. Let exit(0) through (--help).
+            if (code !== 0 && capturedError) {
+                exitCode = code;
+                return undefined;
+            }
+            originalProcessExit(code);
+        });
+        try {
+            await runMain(createMirrorCommand(), { rawArgs: effectiveArgs });
+        }
+        finally {
+            console.error = originalConsoleError;
+            process.exit = originalProcessExit;
+        }
+        if (capturedError) {
+            handleCliError(capturedError, verbose, exitCode);
+        }
     }
     catch (error) {
-        if (error instanceof MirrorError) {
-            console.error(error.message);
-            process.exit(error.exitCode);
-        }
-        throw error;
+        handleCliError(error, verbose);
     }
     finally {
         restoreColorOutput();
     }
 };
+const handleCliError = (error, verbose, exitCode) => {
+    if (error instanceof MirrorError) {
+        console.error(`error: ${error.message}`);
+        if (verbose)
+            console.error(error.stack);
+        process.exit(error.exitCode);
+    }
+    if (error instanceof Error) {
+        console.error(`error: ${error.message}`);
+        if (verbose)
+            console.error(error.stack);
+    }
+    else {
+        console.error('error: An unexpected error occurred.');
+        if (verbose)
+            console.error(error);
+    }
+    process.exit(exitCode ?? 1);
+};
 const createInitCommand = () => defineCommand({
     meta: { name: 'init', description: 'Create a Mirror configuration file.' },
     subCommands: {
@@ -214,6 +265,7 @@ const cliOptions = (rawArgs, args) => {
         push: parsed.push || args['push'] === true,
         allowDirty: parsed.allowDirty || args['allowDirty'] === true,
         yes: parsed.yes || args['yes'] === true,
+        verbose: parsed.verbose || args['verbose'] === true,
     };
 };
 const stringArg = (value) => (typeof value === 'string' ? value : undefined);

package/library/flags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../source/flags.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAqB,gBAAgB,EAAgB,MAAM,SAAS,CAAA;AAehF,eAAO,MAAM,qBAAqB,GAAI,SAAS,MAAM,EAAE,KAAG,gBAsDzD,CAAA"}
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../source/flags.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAqB,gBAAgB,EAAgB,MAAM,SAAS,CAAA;AAehF,eAAO,MAAM,qBAAqB,GAAI,SAAS,MAAM,EAAE,KAAG,gBAuDzD,CAAA"}

package/library/flags.js

@@ -2,7 +2,7 @@
  * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
  */
 import { MirrorError } from './errors';
-const booleanFlags = new Set(['dry-run', 'commit', 'push', 'allow-dirty', 'yes', 'no-color', 'help', 'version']);
+const booleanFlags = new Set(['dry-run', 'commit', 'push', 'allow-dirty', 'yes', 'no-color', 'verbose', 'help', 'version']);
 const adapterNames = new Set(['package.json', 'jsr.json', 'git']);
 const shortFlagAliases = {
     '-dy': '--dry-run',
@@ -55,6 +55,7 @@ export const parseMirrorCliOptions = (rawArgs) => {
         push: parsed['push'] === true,
         allowDirty: parsed['allowDirty'] === true,
         yes: parsed['yes'] === true,
+        verbose: parsed['verbose'] === true,
     };
 };
 const assertAdapter = (value, flagName) => {

package/library/types.d.ts

@@ -74,6 +74,7 @@ export type MirrorCliOptions = {
     push?: boolean;
     allowDirty?: boolean;
     yes?: boolean;
+    verbose?: boolean;
 };
 export type MirrorConfigDiscovery = {
     path?: string;

package/library/types.d.ts.map

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

package/package.json

@@ -1,12 +1,29 @@
 {
   "name": "@guiho/mirror",
   "description": "Open source project versioning for Bun, npm, JSR, and Git.",
-  "version": "3.0.0-alpha.4",
-  "main": "library/guiho-mirror.js",
-  "types": "library/guiho-mirror.d.ts",
-  "module": "source/guiho-mirror.ts",
+  "version": "3.0.0-alpha.9",
   "type": "module",
-  "readmeFilename": "README.md",
+  "main": "./library/guiho-mirror.js",
+  "types": "./library/guiho-mirror.d.ts",
+  "exports": {
+    ".": {
+      "types": "./library/guiho-mirror.d.ts",
+      "import": "./library/guiho-mirror.js"
+    }
+  },
+  "bin": {
+    "mirror": "./library/guiho-mirror-bin.js"
+  },
+  "files": [
+    "README.md",
+    "library/",
+    "docs/",
+    "bin/",
+    "jsr.json",
+    "CHANGELOG.md",
+    "LICENSE.md",
+    "docs.md"
+  ],
   "keywords": [
     "bun",
     "cli",
@@ -22,16 +39,6 @@
     "url": "https://guiho.co/cg"
   },
   "sideEffects": false,
-  "exports": {
-    ".": {
-      "types": "./library/guiho-mirror.d.ts",
-      "import": "./library/guiho-mirror.js"
-    },
-    "./source": "./source/guiho-mirror.ts"
-  },
-  "bin": {
-    "mirror": "./library/guiho-mirror-bin.js"
-  },
   "publishConfig": {
     "access": "public"
   },
@@ -53,22 +60,13 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+ssh://git@github.com/CGuiho/mirror.git",
+    "url": "git+https://github.com/CGuiho/mirror.git",
     "directory": "mirror"
   },
   "homepage": "https://github.com/CGuiho/mirror#readme",
-  "bugs": "https://github.com/CGuiho/mirror/issues",
-  "files": [
-    "README.md",
-    "library/",
-    "source/",
-    "docs/",
-    "bin/",
-    "jsr.json",
-    "CHANGELOG.md",
-    "LICENSE.md",
-    "docs.md"
-  ],
+  "bugs": {
+    "url": "https://github.com/CGuiho/mirror/issues"
+  },
   "dependencies": {
     "citty": "^0.2.2",
     "semver": "^7.8.0"

package/source/adapters.ts

@@ -1,176 +0,0 @@
-/**
- * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
- */
-
-import { $ } from 'bun'
-import { existsSync } from 'node:fs'
-import type { MirrorConfig, MirrorJsonObject } from './types'
-import { MirrorError } from './errors'
-import { assertValidSemver, sortSemverDescending } from './version'
-import { resolveMirrorPath } from './config'
-
-export const supportedGitTagTemplates = ['v{version}', '{name}@{version}', '{name}/v{version}'] as const
-
-export const readPackageJson = async (path: string): Promise<MirrorJsonObject> => readJsonObject(path, 'package.json')
-export const readJsrJson = async (path: string): Promise<MirrorJsonObject> => readJsonObject(path, 'jsr.json')
-
-export const writeJsonObject = async (path: string, object: MirrorJsonObject) => {
-  await Bun.write(path, `${JSON.stringify(object, null, 2)}\n`)
-}
-
-export const readPackageVersion = async (config: MirrorConfig) => readVersionField(resolveMirrorPath(config.cwd, config.package.path), 'package.json')
-export const readJsrVersion = async (config: MirrorConfig) => readVersionField(resolveMirrorPath(config.cwd, config.jsr.path), 'jsr.json')
-export const readPackageName = async (config: MirrorConfig) => readNameField(resolveMirrorPath(config.cwd, config.package.path), 'package.json')
-export const readJsrName = async (config: MirrorConfig) => readNameField(resolveMirrorPath(config.cwd, config.jsr.path), 'jsr.json')
-
-export const writePackageVersion = async (config: MirrorConfig, nextVersion: string) =>
-  writeVersionField(resolveMirrorPath(config.cwd, config.package.path), 'package.json', nextVersion)
-
-export const writeJsrVersion = async (config: MirrorConfig, nextVersion: string) =>
-  writeVersionField(resolveMirrorPath(config.cwd, config.jsr.path), 'jsr.json', nextVersion)
-
-export const ensureAdapterFiles = async (config: MirrorConfig) => {
-  if (usesAdapter(config, 'package.json')) ensureFile(resolveMirrorPath(config.cwd, config.package.path), 'package.json')
-  if (usesAdapter(config, 'jsr.json')) ensureFile(resolveMirrorPath(config.cwd, config.jsr.path), 'jsr.json')
-  if (usesAdapter(config, 'git')) await ensureGitRepository(config.cwd)
-}
-
-export const resolveProjectName = async (config: MirrorConfig) => {
-  if (config.project.name) return config.project.name
-  if (config.project.nameSource === 'package.json') return readPackageName(config)
-  if (config.project.nameSource === 'jsr.json') return readJsrName(config)
-  return undefined
-}
-
-export const readCurrentVersion = async (config: MirrorConfig, projectName?: string) => {
-  if (config.version.source === 'package.json') return readPackageVersion(config)
-  if (config.version.source === 'jsr.json') return readJsrVersion(config)
-  return readGitVersion(config, projectName)
-}
-
-export const readGitVersion = async (config: MirrorConfig, projectName?: string) => {
-  await ensureGitRepository(config.cwd)
-
-  const tagsOutput = await $`git -C ${config.cwd} tag --list`.text()
-  const versions = tagsOutput
-    .split(/\r?\n/)
-    .map((line) => line.trim())
-    .filter(Boolean)
-    .map((tag) => versionFromTag(config.git.tagTemplate, tag, projectName))
-    .filter((version): version is string => Boolean(version))
-
-  if (versions.length === 0) throw new MirrorError(`No Git tags match template: ${config.git.tagTemplate}`)
-
-  return sortSemverDescending(versions)[0] ?? ''
-}
-
-export const renderGitTag = (template: string, version: string, projectName?: string) => {
-  assertSupportedGitTagTemplate(template)
-  assertValidSemver(version, 'Git tag version')
-
-  if (template.includes('{name}') && !projectName) throw new MirrorError(`Tag template requires a project name: ${template}`)
-
-  return template.replaceAll('{version}', version).replaceAll('{name}', projectName ?? '')
-}
-
-export const versionFromTag = (template: string, tag: string, projectName?: string) => {
-  assertSupportedGitTagTemplate(template)
-
-  if (template.includes('{name}') && !projectName) throw new MirrorError(`Tag template requires a project name: ${template}`)
-
-  const escapedTemplate = escapeRegex(template)
-    .replaceAll('\\{version\\}', '(?<version>.+)')
-    .replaceAll('\\{name\\}', escapeRegex(projectName ?? ''))
-  const match = new RegExp(`^${escapedTemplate}$`).exec(tag)
-  const version = match?.groups?.['version']
-
-  if (!version) return undefined
-
-  try {
-    assertValidSemver(version, 'Git tag version')
-    return version
-  } catch {
-    return undefined
-  }
-}
-
-export const assertSupportedGitTagTemplate = (template: string) => {
-  if (!(supportedGitTagTemplates as readonly string[]).includes(template)) {
-    throw new MirrorError(`Unsupported Git tag template: ${template}. Expected v{version}, {name}@{version}, or {name}/v{version}.`)
-  }
-}
-
-export const isGitRepository = async (cwd: string) => {
-  try {
-    await $`git -C ${cwd} rev-parse --is-inside-work-tree`.quiet()
-    return true
-  } catch {
-    return false
-  }
-}
-
-export const isGitDirty = async (cwd: string) => {
-  const output = await $`git -C ${cwd} status --porcelain`.quiet().text()
-  return output.trim().length > 0
-}
-
-export const createGitCommit = async (cwd: string, paths: string[], message: string) => {
-  for (const path of paths) await $`git -C ${cwd} add ${path}`.quiet()
-  await $`git -C ${cwd} commit -m ${message}`.quiet()
-}
-
-export const createGitTag = async (cwd: string, tag: string) => {
-  await $`git -C ${cwd} tag ${tag} -m ${`Release ${tag}`}`.quiet()
-}
-
-export const pushGitRefs = async (cwd: string, includeCommit: boolean, includeTags: boolean) => {
-  if (includeCommit) await $`git -C ${cwd} push`.quiet()
-  if (includeTags) await $`git -C ${cwd} push --tags`.quiet()
-}
-
-const readJsonObject = async (path: string, label: string): Promise<MirrorJsonObject> => {
-  ensureFile(path, label)
-  const json = await Bun.file(path).json()
-
-  if (typeof json !== 'object' || json === null || Array.isArray(json)) throw new MirrorError(`${label} must contain a JSON object: ${path}`)
-
-  return json as MirrorJsonObject
-}
-
-const readVersionField = async (path: string, label: string): Promise<string> => {
-  const json = await readJsonObject(path, label)
-  const version = json['version']
-
-  if (typeof version !== 'string') throw new MirrorError(`${label} must contain a string version field: ${path}`)
-  assertValidSemver(version, `${label} version`)
-
-  return version
-}
-
-const readNameField = async (path: string, label: string): Promise<string> => {
-  const json = await readJsonObject(path, label)
-  const name = json['name']
-
-  if (typeof name !== 'string' || name.length === 0) throw new MirrorError(`${label} must contain a string name field: ${path}`)
-
-  return name
-}
-
-const writeVersionField = async (path: string, label: string, nextVersion: string) => {
-  const json = await readJsonObject(path, label)
-  json['version'] = nextVersion
-  await writeJsonObject(path, json)
-}
-
-const ensureFile = (path: string, label: string) => {
-  if (!existsSync(path)) throw new MirrorError(`${label} file not found: ${path}`)
-}
-
-const ensureGitRepository = async (cwd: string) => {
-  if (!(await isGitRepository(cwd))) throw new MirrorError(`Not a Git repository: ${cwd}`)
-}
-
-const usesAdapter = (config: MirrorConfig, adapter: 'package.json' | 'jsr.json' | 'git') =>
-  config.version.source === adapter || config.version.output.includes(adapter)
-
-const escapeRegex = (value: string) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')