@vltpkg/cli-sdk 0.0.0-13 → 0.0.0-14

package/dist/esm/commands/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/commands/config.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport { asRootError } from '@vltpkg/output/error'\nimport { isObject } from '@vltpkg/types'\nimport { spawnSync } from 'node:child_process'\nimport { getSortedKeys } from '../config/definition.ts'\nimport type {\n  ConfigDefinitions,\n  ConfigFileData,\n  LoadedConfig,\n  RecordPairs,\n} from '../config/index.ts'\nimport {\n  definition,\n  isRecordField,\n  pairsToRecords,\n  recordsToPairs,\n} from '../config/index.ts'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'config',\n    usage: '<command> [flags]',\n    description: 'Work with vlt configuration',\n\n    subcommands: {\n      get: {\n        usage: '<key> [<key> ...]',\n        description: 'Print the named config value',\n      },\n\n      list: {\n        description:\n          'Print all configuration settings currently in effect',\n      },\n\n      set: {\n        usage:\n          '<key>=<value> [<key>=<value> ...] [--config=<user | project>]',\n        description: `Set config values. By default, these are\n                      written to the project config file, \\`vlt.json\\`\n                      in the root of the project. To set things for all\n                      projects, run with \\`--config=user\\``,\n      },\n\n      del: {\n        usage: '<key> [<key> ...] [--config=<user | project>]',\n        description: `Delete the named config fields. If no values remain in\n                      the config file, delete the file as well. By default,\n                      operates on the \\`vlt.json\\` file in the root of the\n                      current project. To delete a config field from the user\n                      config file, specify \\`--config=user\\`.`,\n      },\n\n      edit: {\n        usage: '[--config=<user | project>]',\n        description: 'Edit the configuration file',\n      },\n\n      help: {\n        usage: '[field ...]',\n        description: `Get information about a config field, or show a list\n                      of known config field names.`,\n      },\n    },\n  })\n\nexport const command: CommandFn<\n  string | number | boolean | void | string[] | RecordPairs\n> = async conf => {\n  const sub = conf.positionals[0]\n  switch (sub) {\n    case 'set':\n      return set(conf)\n\n    case 'get':\n      return get(conf)\n\n    case 'ls':\n    case 'list':\n      return list(conf)\n\n    case 'edit':\n      return edit(conf)\n\n    case 'help':\n      return help(conf)\n\n    case 'del':\n      return del(conf)\n\n    default: {\n      throw error('Unrecognized config command', {\n        code: 'EUSAGE',\n        found: sub,\n        validOptions: ['set', 'get', 'list', 'edit', 'help', 'del'],\n      })\n    }\n  }\n}\n\nconst help = (conf: LoadedConfig) => {\n  const j = definition.toJSON()\n  const fields = conf.positionals.slice(1)\n  if (!fields.length) {\n    return [\n      'Specify one or more options to see information:',\n      ...Object.keys(j)\n        .sort((a, b) => a.localeCompare(b, 'en'))\n        .map(c => `  ${c}`),\n    ].join('\\n')\n  }\n\n  // TODO: some kind of fuzzy search?\n  const res: string[] = []\n  for (const f of fields) {\n    const def = j[f]\n    if (!def) {\n      res.push(`unknown config field: ${f}`)\n    } else {\n      const hint = def.hint ? `=<${def.hint}>` : ''\n      const type =\n        isRecordField(f) ?\n          'Record<string, string>'\n        : def.type + (def.multiple ? '[]' : '')\n\n      res.push(`--${f}${hint}`)\n      res.push(`  type: ${type}`)\n      if (def.default) {\n        res.push(`  default: ${JSON.stringify(def.default)}`)\n      }\n      if (def.description) {\n        res.push(def.description)\n      }\n    }\n  }\n  return res.join('\\n')\n}\n\nconst list = (conf: LoadedConfig) => {\n  return recordsToPairs(conf.options)\n}\n\nconst del = async (conf: LoadedConfig) => {\n  const fields = conf.positionals.slice(1)\n  if (!fields.length) {\n    throw error('At least one key is required', {\n      code: 'EUSAGE',\n    })\n  }\n  await conf.deleteConfigKeys(conf.get('config'), fields)\n}\n\nconst get = async (conf: LoadedConfig) => {\n  const keys = conf.positionals.slice(1)\n  const k = keys[0]\n  if (!k || keys.length > 1) {\n    throw error('Exactly one key is required', {\n      code: 'EUSAGE',\n    })\n  }\n  return conf.get(k as keyof ConfigDefinitions)\n}\n\nconst edit = async (conf: LoadedConfig) => {\n  const [command, ...args] = conf.get('editor').split(' ')\n  if (!command) {\n    throw error(`editor is empty`)\n  }\n  await conf.editConfigFile(conf.get('config'), file => {\n    args.push(file)\n    const res = spawnSync(command, args, {\n      stdio: 'inherit',\n    })\n    if (res.status !== 0) {\n      throw error(`${command} command failed`, {\n        ...res,\n        command,\n        args,\n      })\n    }\n  })\n}\n\nconst set = async (conf: LoadedConfig) => {\n  const pairs = conf.positionals.slice(1)\n  if (!pairs.length) {\n    throw error('At least one key=value pair is required', {\n      code: 'EUSAGE',\n    })\n  }\n  let parsed: ConfigFileData['config'] | null = null\n  try {\n    parsed = conf.jack.parseRaw(pairs.map(kv => `--${kv}`)).values\n  } catch (er) {\n    const { name, found, value, wanted, validOptions } =\n      asRootError(er).cause\n    // when a boolean gets a value, it throw a parse error\n    if (\n      isObject(found) &&\n      typeof found.name === 'string' &&\n      typeof found.value === 'string'\n    ) {\n      const { name, value } = found\n      throw error(\n        `Boolean flag must be \"${name}\" or \"no-${name}\", not a value`,\n        {\n          code: 'ECONFIG',\n          name,\n          found: `${name}=${value}`,\n        },\n      )\n    }\n    if (wanted && !value && typeof name === 'string') {\n      throw error(\n        `No value provided for ${JSON.stringify(name.replace(/^-+/, ''))}`,\n        {\n          code: 'ECONFIG',\n          wanted,\n        },\n      )\n    }\n    if (Array.isArray(validOptions)) {\n      throw error(`Invalid value provided for ${name}`, {\n        code: 'ECONFIG',\n        found,\n        validOptions,\n      })\n    }\n    // an unknown property\n    throw error('Invalid config keys', {\n      code: 'ECONFIG',\n      found: pairs.map(kv => kv.split('=')[0]),\n      validOptions: getSortedKeys(),\n    })\n  }\n  await conf.addConfigToFile(\n    conf.get('config'),\n    pairsToRecords(parsed),\n  )\n}\n"]}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/commands/config.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport { asRootError } from '@vltpkg/output/error'\nimport { isObject } from '@vltpkg/types'\nimport { spawnSync } from 'node:child_process'\nimport { getSortedKeys } from '../config/definition.ts'\nimport type {\n  ConfigDefinitions,\n  ConfigFileData,\n  LoadedConfig,\n  RecordPairs,\n} from '../config/index.ts'\nimport {\n  definition,\n  isRecordField,\n  pairsToRecords,\n  recordsToPairs,\n} from '../config/index.ts'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'config',\n    usage: '<command> [flags]',\n    description: 'Work with vlt configuration',\n\n    subcommands: {\n      get: {\n        usage: '<key> [<key> ...]',\n        description: 'Print the named config value',\n      },\n\n      list: {\n        description:\n          'Print all configuration settings currently in effect',\n      },\n\n      set: {\n        usage:\n          '<key>=<value> [<key>=<value> ...] [--config=<user | project>]',\n        description: `Set config values. By default, these are\n                      written to the project config file, \\`vlt.json\\`\n                      in the root of the project. To set things for all\n                      projects, run with \\`--config=user\\``,\n      },\n\n      del: {\n        usage: '<key> [<key> ...] [--config=<user | project>]',\n        description: `Delete the named config fields. If no values remain in\n                      the config file, delete the file as well. By default,\n                      operates on the \\`vlt.json\\` file in the root of the\n                      current project. To delete a config field from the user\n                      config file, specify \\`--config=user\\`.`,\n      },\n\n      edit: {\n        usage: '[--config=<user | project>]',\n        description: 'Edit the configuration file',\n      },\n\n      help: {\n        usage: '[field ...]',\n        description: `Get information about a config field, or show a list\n                      of known config field names.`,\n      },\n    },\n  })\n\nexport const command: CommandFn<\n  string | number | boolean | void | string[] | RecordPairs\n> = async conf => {\n  const sub = conf.positionals[0]\n  switch (sub) {\n    case 'set':\n      return set(conf)\n\n    case 'get':\n      return get(conf)\n\n    case 'ls':\n    case 'list':\n      return list(conf)\n\n    case 'edit':\n      return edit(conf)\n\n    case 'help':\n      return help(conf)\n\n    case 'del':\n      return del(conf)\n\n    default: {\n      throw error('Unrecognized config command', {\n        code: 'EUSAGE',\n        found: sub,\n        validOptions: ['set', 'get', 'list', 'edit', 'help', 'del'],\n      })\n    }\n  }\n}\n\nconst help = (conf: LoadedConfig) => {\n  const j = definition.toJSON()\n  const fields = conf.positionals.slice(1)\n  if (!fields.length) {\n    return [\n      'Specify one or more options to see information:',\n      ...Object.keys(j)\n        .sort((a, b) => a.localeCompare(b, 'en'))\n        .map(c => `  ${c}`),\n    ].join('\\n')\n  }\n\n  // TODO: some kind of fuzzy search?\n  const res: string[] = []\n  for (const f of fields) {\n    const def = j[f]\n    if (!def) {\n      res.push(`unknown config field: ${f}`)\n    } else {\n      const hint = def.hint ? `=<${def.hint}>` : ''\n      const type =\n        isRecordField(f) ?\n          'Record<string, string>'\n        : def.type + (def.multiple ? '[]' : '')\n\n      res.push(`--${f}${hint}`)\n      res.push(`  type: ${type}`)\n      if (def.default) {\n        res.push(`  default: ${JSON.stringify(def.default)}`)\n      }\n      if (def.description) {\n        res.push(def.description)\n      }\n    }\n  }\n  return res.join('\\n')\n}\n\nconst list = (conf: LoadedConfig) => {\n  return recordsToPairs(conf.options)\n}\n\nconst del = async (conf: LoadedConfig) => {\n  const fields = conf.positionals.slice(1)\n  if (!fields.length) {\n    throw error('At least one key is required', {\n      code: 'EUSAGE',\n    })\n  }\n  await conf.deleteConfigKeys(conf.get('config'), fields)\n}\n\nconst get = async (conf: LoadedConfig) => {\n  const keys = conf.positionals.slice(1)\n  const k = keys[0]\n  if (!k || keys.length > 1) {\n    throw error('Exactly one key is required', {\n      code: 'EUSAGE',\n    })\n  }\n  return conf.get(k as keyof ConfigDefinitions)\n}\n\nconst edit = async (conf: LoadedConfig) => {\n  const [command, ...args] = conf.get('editor').split(' ')\n  if (!command) {\n    throw error(`editor is empty`)\n  }\n  await conf.editConfigFile(conf.get('config'), file => {\n    args.push(file)\n    const res = spawnSync(command, args, {\n      stdio: 'inherit',\n    })\n    if (res.status !== 0) {\n      throw error(`${command} command failed`, {\n        ...res,\n        command,\n        args,\n      })\n    }\n  })\n}\n\nconst set = async (conf: LoadedConfig) => {\n  const pairs = conf.positionals.slice(1)\n  if (!pairs.length) {\n    throw error('At least one key=value pair is required', {\n      code: 'EUSAGE',\n    })\n  }\n  let parsed: ConfigFileData | null = null\n  try {\n    parsed = conf.jack.parseRaw(pairs.map(kv => `--${kv}`)).values\n  } catch (er) {\n    const { name, found, value, wanted, validOptions } =\n      asRootError(er).cause\n    // when a boolean gets a value, it throw a parse error\n    if (\n      isObject(found) &&\n      typeof found.name === 'string' &&\n      typeof found.value === 'string'\n    ) {\n      const { name, value } = found\n      throw error(\n        `Boolean flag must be \"${name}\" or \"no-${name}\", not a value`,\n        {\n          code: 'ECONFIG',\n          name,\n          found: `${name}=${value}`,\n        },\n      )\n    }\n    if (wanted && !value && typeof name === 'string') {\n      throw error(\n        `No value provided for ${JSON.stringify(name.replace(/^-+/, ''))}`,\n        {\n          code: 'ECONFIG',\n          wanted,\n        },\n      )\n    }\n    if (Array.isArray(validOptions)) {\n      throw error(`Invalid value provided for ${name}`, {\n        code: 'ECONFIG',\n        found,\n        validOptions,\n      })\n    }\n    // an unknown property\n    throw error('Invalid config keys', {\n      code: 'ECONFIG',\n      found: pairs.map(kv => kv.split('=')[0]),\n      validOptions: getSortedKeys(),\n    })\n  }\n  await conf.addConfigToFile(\n    conf.get('config'),\n    pairsToRecords(parsed),\n  )\n}\n"]}

package/dist/esm/config/index.d.ts

@@ -22,41 +22,52 @@
  */
 import { PackageInfoClient } from '@vltpkg/package-info';
 import { PackageJson } from '@vltpkg/package-json';
+import type { SpecOptions } from '@vltpkg/spec';
+import type { WhichConfig } from '@vltpkg/vlt-json';
 import { Monorepo } from '@vltpkg/workspaces';
 import type { Jack, OptionsResults, Unwrap } from 'jackspeak';
 import { PathScurry } from 'path-scurry';
-import { kIndent, kNewline } from 'polite-json';
 import type { Commands, RecordField } from './definition.ts';
 import { commands, definition, isRecordField, recordFields } from './definition.ts';
 export { commands, definition, isRecordField, recordFields, type Commands, };
 export declare const kCustomInspect: unique symbol;
 export type RecordPairs = Record<string, unknown>;
 export type RecordString = Record<string, string>;
-export type ConfigFiles = Record<string, ConfigFileData['config']>;
-export type PairsAsRecords = Omit<ConfigOptions, 'projectRoot' | 'scurry' | 'packageJson' | 'monorepo' | 'packageInfo'> & {
-    command?: Record<string, ConfigOptions>;
+export type PairsAsRecords = ConfigOptionsNoExtras & {
+    command?: {
+        [k in keyof Commands]?: ConfigOptionsNoExtras;
+    };
 };
-export declare const pairsToRecords: (obj: NonNullable<ConfigFileData["config"]>) => PairsAsRecords;
+export declare const pairsToRecords: (obj: NonNullable<ConfigFileData> | OptionsResults<ConfigDefinitions>) => PairsAsRecords;
 export declare const recordsToPairs: (obj: RecordPairs) => RecordPairs;
+export type ConfigDataNoCommand = {
+    [k in keyof OptionsResults<ConfigDefinitions>]?: OptionsResults<ConfigDefinitions>[k];
+};
 /**
  * Config data can be any options, and also a 'command' field which
  * contains command names and override options for that command.
  */
-export type ConfigData = OptionsResults<ConfigDefinitions> & {
-    command?: Record<string, OptionsResults<ConfigDefinitions>>;
+export type ConfigData = ConfigDataNoCommand & {
+    command?: {
+        [k in keyof Commands]?: ConfigDataNoCommand;
+    };
+};
+export type ConfigFileDataNoCommand = {
+    [k in keyof ConfigDataNoCommand]: k extends (OptListKeys<ConfigDataNoCommand>) ? RecordString | string[] : ConfigDataNoCommand[k];
 };
 /**
- * Config data as it appears in config files, with kv pair lists
- * stored as `Record<string, string>`.
+ * Config data as it appears in the config field of the vlt.json, with kv pair
+ * lists stored as `Record<string, string>` and
  */
-export type ConfigFileData = {
-    config?: {
-        [k in keyof ConfigData]?: k extends OptListKeys<ConfigData> ? RecordString | string[] : k extends 'command' ? ConfigFiles : ConfigData[k];
+export type ConfigFileData = ConfigFileDataNoCommand & {
+    command?: {
+        [k in keyof Commands]?: ConfigFileDataNoCommand;
     };
 };
-export type ConfigOptions = {
-    [k in keyof ConfigData]: k extends RecordField ? RecordString : k extends 'command' ? never : ConfigData[k];
-} & {
+export type ConfigOptionsNoExtras = {
+    [k in keyof OptionsResults<ConfigDefinitions>]: k extends (RecordField) ? RecordString : k extends 'command' ? never : OptionsResults<ConfigDefinitions>[k];
+};
+export type ConfigOptions = ConfigOptionsNoExtras & Pick<SpecOptions, 'catalog' | 'catalogs'> & {
     packageJson: PackageJson;
     scurry: PathScurry;
     projectRoot: string;
@@ -83,11 +94,6 @@ export declare class Config {
      * representing vlt's configuration
      */
     jack: Jack<ConfigDefinitions>;
-    stringifyOptions: {
-        [kIndent]: string;
-        [kNewline]: string;
-    };
-    configFiles: ConfigFiles;
     /**
      * Parsed values in effect
      */
@@ -157,100 +163,17 @@ export declare class Config {
     /**
      * Write the config values to the user or project config file.
      */
-    writeConfigFile(which: 'project' | 'user', values: NonNullable<ConfigFiles['config']>): Promise<{
-        color?: boolean | undefined;
-        'no-color'?: boolean | undefined;
-        registry?: string | undefined;
-        registries?: string[] | RecordString | undefined;
-        'scope-registries'?: string[] | RecordString | undefined;
-        'jsr-registries'?: string[] | RecordString | undefined;
-        'git-hosts'?: string[] | RecordString | undefined;
-        'git-host-archives'?: string[] | RecordString | undefined;
-        cache?: string | undefined;
-        tag?: string | undefined;
-        before?: string | undefined;
-        os?: string | undefined;
-        arch?: string | undefined;
-        'node-version'?: string | undefined;
-        'git-shallow'?: boolean | undefined;
-        'fetch-retries'?: number | undefined;
-        'fetch-retry-factor'?: number | undefined;
-        'fetch-retry-mintimeout'?: number | undefined;
-        'fetch-retry-maxtimeout'?: number | undefined;
-        'stale-while-revalidate-factor'?: number | undefined;
-        identity?: string | undefined;
-        workspace?: string[] | RecordString | undefined;
-        'workspace-group'?: string[] | RecordString | undefined;
-        recursive?: boolean | undefined;
-        bail?: boolean | undefined;
-        'no-bail'?: boolean | undefined;
-        config?: "user" | "project" | undefined;
-        editor?: string | undefined;
-        'script-shell'?: string | undefined;
-        'fallback-command'?: string | undefined;
-        package?: string | undefined;
-        view?: "human" | "json" | "gui" | "mermaid" | "inspect" | undefined;
-        'dashboard-root'?: string[] | RecordString | undefined;
-        'save-dev'?: boolean | undefined;
-        'save-optional'?: boolean | undefined;
-        'save-peer'?: boolean | undefined;
-        'save-prod'?: boolean | undefined;
-        'expect-results'?: string | undefined;
-        yes?: boolean | undefined;
-        version?: boolean | undefined;
-        help?: boolean | undefined;
-        command?: ConfigFiles | undefined;
-    }>;
+    writeConfigFile(this: LoadedConfig, which: WhichConfig, values: NonNullable<ConfigFileData>): Promise<void>;
     /**
      * Fold in the provided fields with the existing properties
      * in the config file.
      */
-    addConfigToFile(which: 'project' | 'user', values: NonNullable<ConfigFileData['config']>): Promise<{
-        color?: boolean | undefined;
-        'no-color'?: boolean | undefined;
-        registry?: string | undefined;
-        registries?: string[] | RecordString | undefined;
-        'scope-registries'?: string[] | RecordString | undefined;
-        'jsr-registries'?: string[] | RecordString | undefined;
-        'git-hosts'?: string[] | RecordString | undefined;
-        'git-host-archives'?: string[] | RecordString | undefined;
-        cache?: string | undefined;
-        tag?: string | undefined;
-        before?: string | undefined;
-        os?: string | undefined;
-        arch?: string | undefined;
-        'node-version'?: string | undefined;
-        'git-shallow'?: boolean | undefined;
-        'fetch-retries'?: number | undefined;
-        'fetch-retry-factor'?: number | undefined;
-        'fetch-retry-mintimeout'?: number | undefined;
-        'fetch-retry-maxtimeout'?: number | undefined;
-        'stale-while-revalidate-factor'?: number | undefined;
-        identity?: string | undefined;
-        workspace?: string[] | RecordString | undefined;
-        'workspace-group'?: string[] | RecordString | undefined;
-        recursive?: boolean | undefined;
-        bail?: boolean | undefined;
-        'no-bail'?: boolean | undefined;
-        config?: "user" | "project" | undefined;
-        editor?: string | undefined;
-        'script-shell'?: string | undefined;
-        'fallback-command'?: string | undefined;
-        package?: string | undefined;
-        view?: "human" | "json" | "gui" | "mermaid" | "inspect" | undefined;
-        'dashboard-root'?: string[] | RecordString | undefined;
-        'save-dev'?: boolean | undefined;
-        'save-optional'?: boolean | undefined;
-        'save-peer'?: boolean | undefined;
-        'save-prod'?: boolean | undefined;
-        'expect-results'?: string | undefined;
-        yes?: boolean | undefined;
-        version?: boolean | undefined;
-        help?: boolean | undefined;
-        command?: ConfigFiles | undefined;
-    }>;
-    getFilename(which?: 'project' | 'user'): string;
-    deleteConfigKeys(which: 'project' | 'user', fields: string[]): Promise<boolean>;
+    addConfigToFile(this: LoadedConfig, which: WhichConfig, values: NonNullable<ConfigFileData>): Promise<void>;
+    /**
+     * Deletes the specified config fields from the named file
+     * Returns `true` if anything was changed.
+     */
+    deleteConfigKeys(this: LoadedConfig, which: WhichConfig, fields: string[]): Promise<boolean>;
     /**
      * Edit the user or project configuration file.
      *
@@ -261,14 +184,10 @@ export declare class Config {
      * file after editing, then it's restored to what it was before, which might
      * mean deleting the file.
      */
-    editConfigFile(which: 'project' | 'user', edit: (file: string) => Promise<void> | void): Promise<void>;
+    editConfigFile(this: LoadedConfig, which: WhichConfig, edit: (file: string) => Promise<void> | void): Promise<void>;
     /**
      * Find the local config file and load both it and the user-level config in
      * the XDG config home.
-     *
-     * Note: if working in a workspaces monorepo, then the vlt.json file MUST
-     * be in the same folder as the vlt.json file, because we stop
-     * looking when we find either one.
      */
     loadConfigFile(): Promise<this>;
     /**

package/dist/esm/config/index.d.ts.map

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

package/dist/esm/config/index.js

@@ -23,15 +23,12 @@
 import { error } from '@vltpkg/error-cause';
 import { PackageInfoClient } from '@vltpkg/package-info';
 import { PackageJson } from '@vltpkg/package-json';
+import { assertRecordStringString, assertRecordStringT, isRecordStringString, } from '@vltpkg/types';
+import { find, load, reload, save } from '@vltpkg/vlt-json';
 import { Monorepo } from '@vltpkg/workspaces';
-import { XDG } from '@vltpkg/xdg';
-import { readFileSync, rmSync, writeFileSync } from 'node:fs';
-import { lstat, mkdir, readFile, writeFile } from 'node:fs/promises';
-import { homedir } from 'node:os';
-import { dirname, resolve } from 'node:path';
+import { readFile, rm, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
 import { PathScurry } from 'path-scurry';
-import { parse as jsonParse, stringify as jsonStringify, kIndent, kNewline, } from 'polite-json';
-import { walkUp } from 'walk-up-path';
 import { commands, definition, getCommand, isRecordField, recordFields, } from "./definition.js";
 import { merge } from "./merge.js";
 export { commands, definition, isRecordField, recordFields, };
@@ -86,9 +83,6 @@ export const recordsToPairs = (obj) => {
     ]));
 };
 const kRecord = Symbol('parsed key=value record');
-const exists = (f) => lstat(f).then(() => true, () => false);
-const home = homedir();
-const xdg = new XDG('vlt');
 /**
  * Class that handles configuration for vlt.
  *
@@ -100,8 +94,6 @@ export class Config {
      * representing vlt's configuration
      */
     jack;
-    stringifyOptions = { [kIndent]: '  ', [kNewline]: '\n' };
-    configFiles = {};
     /**
      * Parsed values in effect
      */
@@ -127,6 +119,8 @@ export class Config {
                 scurry,
                 packageJson,
             }),
+            catalog: load('catalog', assertRecordStringString),
+            catalogs: load('catalogs', o => assertRecordStringT(o, isRecordStringString, 'Record<string, Record<string, string>>')),
         };
         const options = Object.assign(asRecords, extras);
         this.#options = Object.assign(options, {
@@ -250,90 +244,52 @@ export class Config {
      * Write the config values to the user or project config file.
      */
     async writeConfigFile(which, values) {
-        const f = this.getFilename(which);
-        await mkdir(dirname(f), { recursive: true });
-        const vals = Object.assign(pairsToRecords(values), this.stringifyOptions);
-        const data = await readFile(f, 'utf8')
-            .then(data => jsonParse(data))
-            .catch(() => ({ config: {} }));
-        data.config = vals;
-        await writeFile(f, jsonStringify(data));
-        this.configFiles[f] = vals;
-        return values;
+        return save('config', pairsToRecords(values), which);
     }
     /**
      * Fold in the provided fields with the existing properties
      * in the config file.
      */
     async addConfigToFile(which, values) {
-        const f = this.getFilename(which);
-        return this.writeConfigFile(which, merge((await this.#maybeLoadConfigFile(f)) ?? {}, values));
+        return this.writeConfigFile(which, merge((await this.#maybeLoadConfigFile(which)) ?? {}, values));
     }
-    /**
-     * if the file exists, parse and load it. returns object if data was
-     * loaded, or undefined if not.
-     */
-    async #maybeLoadConfigFile(file) {
-        const result = await this.#readConfigFile(file);
-        if (result) {
-            const { command, ...values } = recordsToPairs(result);
-            if (command) {
-                for (const [c, opts] of Object.entries(command)) {
-                    const cmd = getCommand(c);
-                    if (cmd) {
-                        this.commandValues[cmd] = merge(this.commandValues[cmd] ?? {}, opts);
-                    }
-                }
-            }
-            this.jack.setConfigValues(values, file);
-            return result;
-        }
-    }
-    async #readConfigFile(file) {
-        if (this.configFiles[file])
-            return this.configFiles[file];
-        const data = await readFile(file, 'utf8').catch(() => { });
-        if (!data)
-            return undefined;
-        let result;
-        try {
-            result = jsonParse(data);
-            if (result && typeof result === 'object') {
-                if (result[kIndent] !== undefined)
-                    this.stringifyOptions[kIndent] = result[kIndent];
-                if (result[kNewline] !== undefined)
-                    this.stringifyOptions[kNewline] = result[kNewline];
-            }
-        }
-        catch (er) {
-            throw error('failed to parse vlt config file', {
+    // called in this weird bound way so that it can be used by the
+    // vlt-json config loading module.
+    #validator = function (c, file) {
+        this.#validateConfig(c, file);
+    }.bind(this);
+    #validateConfig(c, file) {
+        if (!c || typeof c !== 'object' || Array.isArray(c)) {
+            throw error('invalid config, expected object', {
                 path: file,
-                cause: er,
+                found: c,
+                wanted: 'ConfigFileData',
             });
         }
-        if (!result ||
-            typeof result !== 'object' ||
-            Array.isArray(result) ||
-            // if it has a config field, must be an object
-            ('config' in result &&
-                (!result.config || typeof result.config !== 'object'))) {
-            throw error('invalid config, expected object with "config" member', {
-                path: file,
-                found: result,
-                wanted: '{ "config"?: ConfigFileData }',
-            });
+        const { command, ...values } = recordsToPairs(c);
+        if (command) {
+            for (const [c, opts] of Object.entries(command)) {
+                const cmd = getCommand(c);
+                if (cmd) {
+                    this.commandValues[cmd] = merge(this.commandValues[cmd] ?? {}, opts);
+                }
+            }
         }
-        this.configFiles[file] = result.config;
-        return this.configFiles[file];
+        this.jack.setConfigValues(values, file);
     }
-    getFilename(which = 'project') {
-        return which === 'user' ?
-            xdg.config('vlt.json')
-            : resolve(this.projectRoot, 'vlt.json');
+    /**
+     * if the file exists, parse and load it. returns object if data was
+     * loaded, or undefined if not.
+     */
+    async #maybeLoadConfigFile(whichConfig) {
+        return load('config', this.#validator, whichConfig);
     }
+    /**
+     * Deletes the specified config fields from the named file
+     * Returns `true` if anything was changed.
+     */
     async deleteConfigKeys(which, fields) {
-        const file = this.getFilename(which);
-        const data = await this.#maybeLoadConfigFile(file);
+        const data = await this.#maybeLoadConfigFile(which);
         if (!data)
             return false;
         let didSomething = false;
@@ -369,7 +325,8 @@ export class Config {
                 delete data[k];
             }
         }
-        await this.writeConfigFile(which, data);
+        if (didSomething)
+            await this.writeConfigFile(which, data);
         return didSomething;
     }
     /**
@@ -383,42 +340,33 @@ export class Config {
      * mean deleting the file.
      */
     async editConfigFile(which, edit) {
-        const file = this.getFilename(which);
-        const backup = await readFile(file, 'utf8')
-            .then(data => jsonParse(data))
-            .catch(() => null);
+        // load the file as a backup
+        // call the edit function
+        // reload it
+        const file = find(which);
+        const backup = await readFile(file, 'utf8').catch(() => undefined);
         if (!backup) {
-            writeFileSync(file, JSON.stringify({ config: {} }, null, 2) + '\n');
+            await writeFile(file, JSON.stringify({ config: {} }, null, 2) + '\n');
         }
         let valid = false;
         try {
             await edit(file);
-            const res = jsonParse(readFileSync(file, 'utf8'));
-            if (!res ||
-                typeof res !== 'object' ||
-                Array.isArray(res) ||
-                ('config' in res &&
-                    (!res.config || typeof res.config !== 'object'))) {
-                throw error('Invalid configuration, expected object with config member', {
-                    path: file,
-                    found: res,
-                    wanted: '{ config: ConfigData }',
-                });
-            }
-            const { config } = res;
-            if (config) {
-                this.jack.setConfigValues(recordsToPairs(config));
-                this.configFiles[file] = config;
-            }
+            // force it to reload the file and validate it again
+            // if this fails, we roll back.
+            const result = reload('config', which);
+            save('config', result ?? {}, which);
             valid = true;
         }
         finally {
             if (!valid) {
+                // TODO: maybe write the file to a re-edit backup location?
+                // then you could do `vlt config edit retry` or something.
                 if (backup) {
-                    writeFileSync(file, jsonStringify(backup));
+                    await writeFile(file, backup);
+                    reload(which);
                 }
                 else {
-                    rmSync(file, { force: true });
+                    await rm(file, { force: true });
                 }
             }
         }
@@ -426,45 +374,11 @@ export class Config {
     /**
      * Find the local config file and load both it and the user-level config in
      * the XDG config home.
-     *
-     * Note: if working in a workspaces monorepo, then the vlt.json file MUST
-     * be in the same folder as the vlt.json file, because we stop
-     * looking when we find either one.
      */
     async loadConfigFile() {
-        const userConfig = xdg.config('vlt.json');
-        await this.#maybeLoadConfigFile(userConfig);
-        let lastKnownRoot = resolve(this.projectRoot);
-        for (const dir of walkUp(this.projectRoot)) {
-            // don't look in ~
-            if (dir === home)
-                break;
-            // finding a project config file stops the search
-            const projectConfig = resolve(dir, 'vlt.json');
-            if (projectConfig === userConfig)
-                break;
-            if ((await exists(projectConfig)) &&
-                (await this.#maybeLoadConfigFile(projectConfig))) {
-                lastKnownRoot = dir;
-                break;
-            }
-            // stat existence of these files
-            const [hasPackage, hasModules, hasProject, hasGit] = await Promise.all([
-                exists(resolve(dir, 'package.json')),
-                exists(resolve(dir, 'node_modules')),
-                exists(resolve(dir, 'vlt.json')),
-                exists(resolve(dir, '.git')),
-            ]);
-            // treat these as potential roots
-            if (hasPackage || hasModules || hasProject) {
-                lastKnownRoot = dir;
-            }
-            // define backstops
-            if (hasProject || hasGit) {
-                break;
-            }
-        }
-        this.projectRoot = lastKnownRoot;
+        await this.#maybeLoadConfigFile('user');
+        this.projectRoot = dirname(find('project', this.projectRoot));
+        await this.#maybeLoadConfigFile('project');
         return this;
     }
     /**

package/dist/esm/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Module that handles all vlt configuration needs\n *\n * Project-level configs are set in a `vlt.json` file in the local project\n * if present. This will override the user-level configs in the appropriate\n * XDG config path.\n *\n * Command-specific configuration can be specified by putting options in a\n * field in the `command` object. For example:\n *\n * ```json\n * {\n *   \"registry\": \"https://registry.npmjs.org/\",\n *   \"command\": {\n *     \"publish\": {\n *       \"registry\": \"http://registry.internal\"\n *     }\n *   }\n * }\n * ```\n * @module\n */\n\nimport { error } from '@vltpkg/error-cause'\nimport { PackageInfoClient } from '@vltpkg/package-info'\nimport { PackageJson } from '@vltpkg/package-json'\nimport { Monorepo } from '@vltpkg/workspaces'\nimport { XDG } from '@vltpkg/xdg'\nimport type { Jack, OptionsResults, Unwrap } from 'jackspeak'\nimport { readFileSync, rmSync, writeFileSync } from 'node:fs'\nimport { lstat, mkdir, readFile, writeFile } from 'node:fs/promises'\nimport { homedir } from 'node:os'\nimport { dirname, resolve } from 'node:path'\nimport { PathScurry } from 'path-scurry'\nimport type { JSONResult } from 'polite-json'\nimport {\n  parse as jsonParse,\n  stringify as jsonStringify,\n  kIndent,\n  kNewline,\n} from 'polite-json'\nimport { walkUp } from 'walk-up-path'\nimport type { Commands, RecordField } from './definition.ts'\nimport {\n  commands,\n  definition,\n  getCommand,\n  isRecordField,\n  recordFields,\n} from './definition.ts'\nimport { merge } from './merge.ts'\nexport {\n  commands,\n  definition,\n  isRecordField,\n  recordFields,\n  type Commands,\n}\n\nexport const kCustomInspect = Symbol.for('nodejs.util.inspect.custom')\n\nexport type RecordPairs = Record<string, unknown>\nexport type RecordString = Record<string, string>\nexport type ConfigFiles = Record<string, ConfigFileData['config']>\n\n// turn a set of pairs into a Record object.\n// if a kv pair doesn't have a = character, set to `''`\nconst reducePairs = <T extends string[]>(\n  pairs: T,\n): RecordString | T => {\n  const record: RecordString = {}\n  for (const kv of pairs) {\n    const eq = kv.indexOf('=')\n    if (eq === -1) record[kv] = ''\n    else {\n      const key = kv.substring(0, eq)\n      const val = kv.substring(eq + 1)\n      record[key] = val\n    }\n  }\n  return record\n}\n\nconst isRecordFieldValue = (k: string, v: unknown): v is string[] =>\n  Array.isArray(v) &&\n  recordFields.includes(k as (typeof recordFields)[number])\n\nexport type PairsAsRecords = Omit<\n  ConfigOptions,\n  | 'projectRoot'\n  | 'scurry'\n  | 'packageJson'\n  | 'monorepo'\n  | 'packageInfo'\n> & {\n  command?: Record<string, ConfigOptions>\n}\n\nexport const pairsToRecords = (\n  obj: NonNullable<ConfigFileData['config']>,\n): PairsAsRecords => {\n  return Object.fromEntries(\n    Object.entries(obj).map(([k, v]) => [\n      k,\n      k === 'command' && v && typeof v === 'object' ?\n        Object.fromEntries(\n          Object.entries(v).map(([k, v]) => [\n            k,\n            pairsToRecords(\n              v as NonNullable<ConfigFileData['config']>,\n            ),\n          ]),\n        )\n      : isRecordFieldValue(k, v) ? reducePairs(v)\n      : v,\n    ]),\n    // hard cast because TS can't see through the entries/fromEntries\n  ) as unknown as PairsAsRecords\n}\n\nexport const recordsToPairs = (obj: RecordPairs): RecordPairs => {\n  return Object.fromEntries(\n    Object.entries(obj)\n      .filter(\n        ([k]) =>\n          !(\n            k === 'scurry' ||\n            k === 'packageJson' ||\n            k === 'monorepo' ||\n            k === 'projectRoot' ||\n            k === 'packageInfo'\n          ),\n      )\n      .map(([k, v]) => [\n        k,\n        k === 'command' && v && typeof v === 'object' ?\n          recordsToPairs(v as RecordPairs)\n        : (\n          !v ||\n          typeof v !== 'object' ||\n          Array.isArray(v) ||\n          !isRecordField(k)\n        ) ?\n          v\n        : Object.entries(v).map(([k, v]) => `${k}=${v}`),\n      ]),\n  )\n}\n\nconst kRecord = Symbol('parsed key=value record')\nconst exists = (f: string) =>\n  lstat(f).then(\n    () => true,\n    () => false,\n  )\n\nconst home = homedir()\nconst xdg = new XDG('vlt')\n\n/**\n * Config data can be any options, and also a 'command' field which\n * contains command names and override options for that command.\n */\nexport type ConfigData = OptionsResults<ConfigDefinitions> & {\n  command?: Record<string, OptionsResults<ConfigDefinitions>>\n}\n\n/**\n * Config data as it appears in config files, with kv pair lists\n * stored as `Record<string, string>`.\n */\nexport type ConfigFileData = {\n  config?: {\n    [k in keyof ConfigData]?: k extends OptListKeys<ConfigData> ?\n      RecordString | string[]\n    : k extends 'command' ? ConfigFiles\n    : ConfigData[k]\n  }\n}\n\nexport type ConfigOptions = {\n  [k in keyof ConfigData]: k extends RecordField ? RecordString\n  : k extends 'command' ? never\n  : ConfigData[k]\n} & {\n  packageJson: PackageJson\n  scurry: PathScurry\n  projectRoot: string\n  monorepo?: Monorepo\n  packageInfo: PackageInfoClient\n}\n\n/**\n * The base config definition set as a type\n */\nexport type ConfigDefinitions = Unwrap<typeof definition>\n\nexport type StringListKeys<O> = {\n  [k in keyof O]: O[k] extends string[] | undefined ? k : never\n}\nexport type OptListKeys<O> = Exclude<\n  StringListKeys<O>[keyof StringListKeys<O>],\n  undefined\n>\n\n/**\n * Class that handles configuration for vlt.\n *\n * Call {@link Config.load} to get one of these.\n */\nexport class Config {\n  /**\n   * The {@link https://npmjs.com/jackspeak | JackSpeak} object\n   * representing vlt's configuration\n   */\n  jack: Jack<ConfigDefinitions>\n\n  stringifyOptions: {\n    [kIndent]: string\n    [kNewline]: string\n  } = { [kIndent]: '  ', [kNewline]: '\\n' }\n\n  configFiles: ConfigFiles = {}\n\n  /**\n   * Parsed values in effect\n   */\n  values?: OptionsResults<ConfigDefinitions>\n\n  /**\n   * Command-specific config values\n   */\n  commandValues: {\n    [cmd in Commands[keyof Commands]]?: ConfigData\n  } = {}\n\n  /**\n   * A flattened object of the parsed configuration\n   */\n  get options(): ConfigOptions {\n    if (this.#options) return this.#options\n    const scurry = new PathScurry(this.projectRoot)\n    const packageJson = new PackageJson()\n    const asRecords = pairsToRecords(this.parse().values)\n    const extras = {\n      projectRoot: this.projectRoot,\n      scurry,\n      packageJson,\n      monorepo: Monorepo.maybeLoad(this.projectRoot, {\n        scurry,\n        packageJson,\n      }),\n    }\n    const options: Omit<ConfigOptions, 'packageInfo'> = Object.assign(\n      asRecords,\n      extras,\n    )\n    this.#options = Object.assign(options, {\n      packageInfo: new PackageInfoClient(options),\n      [kCustomInspect]() {\n        return Object.fromEntries(\n          Object.entries(options).filter(\n            ([k]) =>\n              k !== 'monorepo' &&\n              k !== 'scurry' &&\n              k !== 'packageJson' &&\n              k !== 'packageInfo',\n          ),\n        )\n      },\n    })\n    return this.#options\n  }\n\n  /**\n   * Reset the options value, optionally setting a new project root\n   * to recalculate the options.\n   */\n  resetOptions(projectRoot: string = process.cwd()) {\n    this.projectRoot = projectRoot\n    this.#options = undefined\n  }\n\n  // memoized options() getter value\n  #options?: ConfigOptions\n\n  /**\n   * positional arguments to the vlt process\n   */\n  positionals?: string[]\n\n  /**\n   * The root of the project where a vlt.json, vlt.json,\n   * package.json, or .git was found. Not necessarily the `process.cwd()`,\n   * though that is the default location.\n   *\n   * Never walks up as far as `$HOME`. So for example, if a project is in\n   * `~/projects/xyz`, then the highest dir it will check is `~/projects`\n   */\n  projectRoot: string\n\n  /**\n   * `Record<alias, canonical name>` to dereference command aliases.\n   */\n  commands: Commands\n\n  /**\n   * Which command name to use for overriding with command-specific values,\n   * determined from the argv when parse() is called.\n   */\n  command?: Commands[keyof Commands]\n\n  constructor(\n    jack: Jack<ConfigDefinitions> = definition,\n    projectRoot = process.cwd(),\n  ) {\n    this.projectRoot = projectRoot\n    this.commands = commands\n    this.jack = jack\n  }\n\n  /**\n   * Parse the arguments and set configuration and positionals accordingly.\n   */\n  parse(args: string[] = process.argv): this & ParsedConfig {\n    if (isParsed(this)) return this\n\n    this.jack.loadEnvDefaults()\n    const p = this.jack.parseRaw(args)\n\n    const fallback = getCommand(p.values['fallback-command'])\n    this.command = getCommand(p.positionals[0])\n\n    const cmdOrFallback = this.command ?? fallback\n    const cmdSpecific =\n      cmdOrFallback && this.commandValues[cmdOrFallback]\n    if (cmdSpecific) {\n      this.jack.setConfigValues(recordsToPairs(cmdSpecific))\n    }\n\n    // ok, applied cmd-specific defaults, do rest of the parse\n    this.jack.applyDefaults(p)\n    this.jack.writeEnv(p)\n\n    if (this.command) p.positionals.shift()\n    else this.command = getCommand(p.values['fallback-command'])\n\n    Object.assign(this, p)\n\n    /* c8 ignore start - unpossible */\n    if (!isParsed(this)) throw error('failed to parse config')\n    /* c8 ignore stop */\n\n    return this\n  }\n\n  /**\n   * Get a `key=value` list option value as an object.\n   *\n   * For example, a list option with a vlaue of `['key=value', 'xyz=as=df' ]`\n   * would be returned as `{key: 'value', xyz: 'as=df'}`\n   *\n   * Results are memoized, so subsequent calls for the same key will return the\n   * same object. If new strings are added to the list, then the memoized value\n   * is *not* updated, so only use once configurations have been fully loaded.\n   *\n   * If the config value is not set at all, an empty object is returned.\n   */\n  getRecord(k: OptListKeys<ConfigData>): RecordString {\n    const pairs = this.get(k) as\n      | (string[] & { [kRecord]?: RecordString })\n      | undefined\n    if (!pairs) return {}\n    if (pairs[kRecord]) return pairs[kRecord]\n    const kv = pairs.reduce((kv: RecordString, pair) => {\n      const eq = pair.indexOf('=')\n      if (eq === -1) return kv\n      const key = pair.substring(0, eq)\n      const val = pair.substring(eq + 1)\n      kv[key] = val\n      return kv\n    }, {})\n    Object.assign(pairs, { [kRecord]: kv })\n    return kv\n  }\n\n  /**\n   * Get a configuration value.\n   *\n   * Note: `key=value` pair configs are returned as a string array. To get them\n   * as an object, use {@link Config#getRecord}.\n   */\n  get<K extends keyof OptionsResults<ConfigDefinitions>>(\n    k: K,\n  ): OptionsResults<ConfigDefinitions>[K] {\n    /* c8 ignore next -- impossible but TS doesn't know that */\n    return (this.values ?? this.parse().values)[k]\n  }\n\n  /**\n   * Write the config values to the user or project config file.\n   */\n  async writeConfigFile(\n    which: 'project' | 'user',\n    values: NonNullable<ConfigFiles['config']>,\n  ) {\n    const f = this.getFilename(which)\n    await mkdir(dirname(f), { recursive: true })\n    const vals = Object.assign(\n      pairsToRecords(values),\n      this.stringifyOptions,\n    )\n    const data = await readFile(f, 'utf8')\n      .then(data => jsonParse(data) as unknown as ConfigFileData)\n      .catch(() => ({ config: {} }))\n    data.config = vals\n    await writeFile(f, jsonStringify(data))\n    this.configFiles[f] = vals\n    return values\n  }\n\n  /**\n   * Fold in the provided fields with the existing properties\n   * in the config file.\n   */\n  async addConfigToFile(\n    which: 'project' | 'user',\n    values: NonNullable<ConfigFileData['config']>,\n  ) {\n    const f = this.getFilename(which)\n    return this.writeConfigFile(\n      which,\n      merge((await this.#maybeLoadConfigFile(f)) ?? {}, values),\n    )\n  }\n\n  /**\n   * if the file exists, parse and load it. returns object if data was\n   * loaded, or undefined if not.\n   */\n  async #maybeLoadConfigFile(\n    file: string,\n  ): Promise<ConfigFileData['config']> {\n    const result = await this.#readConfigFile(file)\n\n    if (result) {\n      const { command, ...values } = recordsToPairs(result)\n      if (command) {\n        for (const [c, opts] of Object.entries(command)) {\n          const cmd = getCommand(c)\n          if (cmd) {\n            this.commandValues[cmd] = merge<ConfigData>(\n              this.commandValues[cmd] ?? ({} as ConfigData),\n              opts as ConfigData,\n            )\n          }\n        }\n      }\n      this.jack.setConfigValues(values, file)\n      return result\n    }\n  }\n\n  async #readConfigFile(\n    file: string,\n  ): Promise<ConfigFileData['config']> {\n    if (this.configFiles[file]) return this.configFiles[file]\n    const data = await readFile(file, 'utf8').catch(() => {})\n    if (!data) return undefined\n    let result: JSONResult\n    try {\n      result = jsonParse(data)\n      if (result && typeof result === 'object') {\n        if (result[kIndent] !== undefined)\n          this.stringifyOptions[kIndent] = result[kIndent]\n        if (result[kNewline] !== undefined)\n          this.stringifyOptions[kNewline] = result[kNewline]\n      }\n    } catch (er) {\n      throw error('failed to parse vlt config file', {\n        path: file,\n        cause: er,\n      })\n    }\n    if (\n      !result ||\n      typeof result !== 'object' ||\n      Array.isArray(result) ||\n      // if it has a config field, must be an object\n      ('config' in result &&\n        (!result.config || typeof result.config !== 'object'))\n    ) {\n      throw error(\n        'invalid config, expected object with \"config\" member',\n        {\n          path: file,\n          found: result,\n          wanted: '{ \"config\"?: ConfigFileData }',\n        },\n      )\n    }\n    this.configFiles[file] = result.config as ConfigFileData['config']\n    return this.configFiles[file]\n  }\n\n  getFilename(which: 'project' | 'user' = 'project'): string {\n    return which === 'user' ?\n        xdg.config('vlt.json')\n      : resolve(this.projectRoot, 'vlt.json')\n  }\n\n  async deleteConfigKeys(\n    which: 'project' | 'user',\n    fields: string[],\n  ) {\n    const file = this.getFilename(which)\n    const data = await this.#maybeLoadConfigFile(file)\n    if (!data) return false\n    let didSomething = false\n    for (const f of fields) {\n      const [key, ...sk] = f.split('.') as [\n        h: string,\n        ...rest: string[],\n      ]\n      const subs = sk.join('.')\n      const k = key as keyof ConfigDefinitions\n      const v = data[k]\n      if (v === undefined) continue\n      if (subs && v && typeof v === 'object') {\n        if (Array.isArray(v)) {\n          const i = v.findIndex(subvalue =>\n            subvalue.startsWith(`${subs}=`),\n          )\n          if (i !== -1) {\n            if (v.length === 1) delete data[k]\n            else v.splice(i, 1)\n            didSomething = true\n          }\n        } else {\n          if (v[subs] !== undefined) {\n            delete v[subs]\n            if (Object.keys(v).length === 0) delete data[k]\n            didSomething = true\n          }\n        }\n      } else {\n        didSomething = true\n        delete data[k]\n      }\n    }\n    await this.writeConfigFile(which, data)\n    return didSomething\n  }\n\n  /**\n   * Edit the user or project configuration file.\n   *\n   * If the file isn't present, then it starts with `{}` so the user has\n   * something to work with.\n   *\n   * If the result is not valid, or no config settings are contained in the\n   * file after editing, then it's restored to what it was before, which might\n   * mean deleting the file.\n   */\n  async editConfigFile(\n    which: 'project' | 'user',\n    edit: (file: string) => Promise<void> | void,\n  ) {\n    const file = this.getFilename(which)\n    const backup = await readFile(file, 'utf8')\n      .then(data => jsonParse(data))\n      .catch(() => null)\n    if (!backup) {\n      writeFileSync(\n        file,\n        JSON.stringify({ config: {} }, null, 2) + '\\n',\n      )\n    }\n    let valid = false\n    try {\n      await edit(file)\n      const res = jsonParse(readFileSync(file, 'utf8'))\n      if (\n        !res ||\n        typeof res !== 'object' ||\n        Array.isArray(res) ||\n        ('config' in res &&\n          (!res.config || typeof res.config !== 'object'))\n      ) {\n        throw error(\n          'Invalid configuration, expected object with config member',\n          {\n            path: file,\n            found: res,\n            wanted: '{ config: ConfigData }',\n          },\n        )\n      }\n      const { config } = res as unknown as ConfigFileData\n      if (config) {\n        this.jack.setConfigValues(recordsToPairs(config))\n        this.configFiles[file] = config\n      }\n      valid = true\n    } finally {\n      if (!valid) {\n        if (backup) {\n          writeFileSync(file, jsonStringify(backup))\n        } else {\n          rmSync(file, { force: true })\n        }\n      }\n    }\n  }\n\n  /**\n   * Find the local config file and load both it and the user-level config in\n   * the XDG config home.\n   *\n   * Note: if working in a workspaces monorepo, then the vlt.json file MUST\n   * be in the same folder as the vlt.json file, because we stop\n   * looking when we find either one.\n   */\n  async loadConfigFile(): Promise<this> {\n    const userConfig = xdg.config('vlt.json')\n    await this.#maybeLoadConfigFile(userConfig)\n\n    let lastKnownRoot = resolve(this.projectRoot)\n    for (const dir of walkUp(this.projectRoot)) {\n      // don't look in ~\n      if (dir === home) break\n\n      // finding a project config file stops the search\n      const projectConfig = resolve(dir, 'vlt.json')\n      if (projectConfig === userConfig) break\n      if (\n        (await exists(projectConfig)) &&\n        (await this.#maybeLoadConfigFile(projectConfig))\n      ) {\n        lastKnownRoot = dir\n        break\n      }\n\n      // stat existence of these files\n      const [hasPackage, hasModules, hasProject, hasGit] =\n        await Promise.all([\n          exists(resolve(dir, 'package.json')),\n          exists(resolve(dir, 'node_modules')),\n          exists(resolve(dir, 'vlt.json')),\n          exists(resolve(dir, '.git')),\n        ])\n\n      // treat these as potential roots\n      if (hasPackage || hasModules || hasProject) {\n        lastKnownRoot = dir\n      }\n\n      // define backstops\n      if (hasProject || hasGit) {\n        break\n      }\n    }\n    this.projectRoot = lastKnownRoot\n    return this\n  }\n\n  /**\n   * cache of the loaded config\n   */\n  static #loaded: LoadedConfig | undefined\n\n  /**\n   * Load the configuration and return a Promise to a\n   * {@link Config} object\n   */\n  static async load(\n    projectRoot = process.cwd(),\n    argv = process.argv,\n    /**\n     * only used in tests, resets the memoization\n     * @internal\n     */\n    reload = false,\n  ): Promise<LoadedConfig> {\n    if (this.#loaded && !reload) return this.#loaded\n    const a = new Config(definition, projectRoot)\n    const b = await a.loadConfigFile()\n    this.#loaded = b.parse(argv) as LoadedConfig\n    return this.#loaded\n  }\n}\n\nconst isParsed = (c: Config): c is ParsedConfig =>\n  !!(c.values && c.positionals && c.command)\n\nexport type ParsedConfig = Config & {\n  command: NonNullable<Config['command']>\n  values: OptionsResults<ConfigDefinitions>\n  positionals: string[]\n}\n\n/**\n * A fully loaded {@link Config} object\n */\nexport type LoadedConfig = ParsedConfig\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Module that handles all vlt configuration needs\n *\n * Project-level configs are set in a `vlt.json` file in the local project\n * if present. This will override the user-level configs in the appropriate\n * XDG config path.\n *\n * Command-specific configuration can be specified by putting options in a\n * field in the `command` object. For example:\n *\n * ```json\n * {\n *   \"registry\": \"https://registry.npmjs.org/\",\n *   \"command\": {\n *     \"publish\": {\n *       \"registry\": \"http://registry.internal\"\n *     }\n *   }\n * }\n * ```\n * @module\n */\n\nimport { error } from '@vltpkg/error-cause'\nimport { PackageInfoClient } from '@vltpkg/package-info'\nimport { PackageJson } from '@vltpkg/package-json'\nimport type { SpecOptions } from '@vltpkg/spec'\nimport {\n  assertRecordStringString,\n  assertRecordStringT,\n  isRecordStringString,\n} from '@vltpkg/types'\nimport type { Validator, WhichConfig } from '@vltpkg/vlt-json'\nimport { find, load, reload, save } from '@vltpkg/vlt-json'\nimport { Monorepo } from '@vltpkg/workspaces'\nimport type { Jack, OptionsResults, Unwrap } from 'jackspeak'\nimport { readFile, rm, writeFile } from 'node:fs/promises'\nimport { dirname } from 'node:path'\nimport { PathScurry } from 'path-scurry'\nimport type { Commands, RecordField } from './definition.ts'\nimport {\n  commands,\n  definition,\n  getCommand,\n  isRecordField,\n  recordFields,\n} from './definition.ts'\nimport { merge } from './merge.ts'\nexport {\n  commands,\n  definition,\n  isRecordField,\n  recordFields,\n  type Commands,\n}\n\nexport const kCustomInspect = Symbol.for('nodejs.util.inspect.custom')\n\nexport type RecordPairs = Record<string, unknown>\nexport type RecordString = Record<string, string>\n\n// turn a set of pairs into a Record object.\n// if a kv pair doesn't have a = character, set to `''`\nconst reducePairs = <T extends string[]>(\n  pairs: T,\n): RecordString | T => {\n  const record: RecordString = {}\n  for (const kv of pairs) {\n    const eq = kv.indexOf('=')\n    if (eq === -1) record[kv] = ''\n    else {\n      const key = kv.substring(0, eq)\n      const val = kv.substring(eq + 1)\n      record[key] = val\n    }\n  }\n  return record\n}\n\nconst isRecordFieldValue = (k: string, v: unknown): v is string[] =>\n  Array.isArray(v) &&\n  recordFields.includes(k as (typeof recordFields)[number])\n\nexport type PairsAsRecords = ConfigOptionsNoExtras & {\n  command?: {\n    [k in keyof Commands]?: ConfigOptionsNoExtras\n  }\n}\n\nexport const pairsToRecords = (\n  obj:\n    | NonNullable<ConfigFileData>\n    | OptionsResults<ConfigDefinitions>,\n): PairsAsRecords => {\n  return Object.fromEntries(\n    Object.entries(obj).map(([k, v]) => [\n      k,\n      k === 'command' && v && typeof v === 'object' ?\n        Object.fromEntries(\n          Object.entries(v).map(([k, v]) => [\n            k,\n            pairsToRecords(v as NonNullable<ConfigFileData>),\n          ]),\n        )\n      : isRecordFieldValue(k, v) ? reducePairs(v)\n      : v,\n    ]),\n    // hard cast because TS can't see through the entries/fromEntries\n  ) as unknown as PairsAsRecords\n}\n\nexport const recordsToPairs = (obj: RecordPairs): RecordPairs => {\n  return Object.fromEntries(\n    Object.entries(obj)\n      .filter(\n        ([k]) =>\n          !(\n            k === 'scurry' ||\n            k === 'packageJson' ||\n            k === 'monorepo' ||\n            k === 'projectRoot' ||\n            k === 'packageInfo'\n          ),\n      )\n      .map(([k, v]) => [\n        k,\n        k === 'command' && v && typeof v === 'object' ?\n          recordsToPairs(v as RecordPairs)\n        : (\n          !v ||\n          typeof v !== 'object' ||\n          Array.isArray(v) ||\n          !isRecordField(k)\n        ) ?\n          v\n        : Object.entries(v).map(([k, v]) => `${k}=${v}`),\n      ]),\n  )\n}\n\nconst kRecord = Symbol('parsed key=value record')\n\nexport type ConfigDataNoCommand = {\n  [k in keyof OptionsResults<ConfigDefinitions>]?: OptionsResults<ConfigDefinitions>[k]\n}\n\n/**\n * Config data can be any options, and also a 'command' field which\n * contains command names and override options for that command.\n */\nexport type ConfigData = ConfigDataNoCommand & {\n  command?: {\n    [k in keyof Commands]?: ConfigDataNoCommand\n  }\n}\n\nexport type ConfigFileDataNoCommand = {\n  [k in keyof ConfigDataNoCommand]: k extends (\n    OptListKeys<ConfigDataNoCommand>\n  ) ?\n    RecordString | string[]\n  : ConfigDataNoCommand[k]\n}\n\n/**\n * Config data as it appears in the config field of the vlt.json, with kv pair\n * lists stored as `Record<string, string>` and\n */\nexport type ConfigFileData = ConfigFileDataNoCommand & {\n  command?: {\n    [k in keyof Commands]?: ConfigFileDataNoCommand\n  }\n}\n\nexport type ConfigOptionsNoExtras = {\n  [k in keyof OptionsResults<ConfigDefinitions>]: k extends (\n    RecordField\n  ) ?\n    RecordString\n  : k extends 'command' ? never\n  : OptionsResults<ConfigDefinitions>[k]\n}\n\nexport type ConfigOptions = ConfigOptionsNoExtras &\n  Pick<SpecOptions, 'catalog' | 'catalogs'> & {\n    packageJson: PackageJson\n    scurry: PathScurry\n    projectRoot: string\n    monorepo?: Monorepo\n    packageInfo: PackageInfoClient\n  }\n\n/**\n * The base config definition set as a type\n */\nexport type ConfigDefinitions = Unwrap<typeof definition>\n\nexport type StringListKeys<O> = {\n  [k in keyof O]: O[k] extends string[] | undefined ? k : never\n}\nexport type OptListKeys<O> = Exclude<\n  StringListKeys<O>[keyof StringListKeys<O>],\n  undefined\n>\n\n/**\n * Class that handles configuration for vlt.\n *\n * Call {@link Config.load} to get one of these.\n */\nexport class Config {\n  /**\n   * The {@link https://npmjs.com/jackspeak | JackSpeak} object\n   * representing vlt's configuration\n   */\n  jack: Jack<ConfigDefinitions>\n\n  /**\n   * Parsed values in effect\n   */\n  values?: OptionsResults<ConfigDefinitions>\n\n  /**\n   * Command-specific config values\n   */\n  commandValues: {\n    [cmd in Commands[keyof Commands]]?: ConfigData\n  } = {}\n\n  /**\n   * A flattened object of the parsed configuration\n   */\n  get options(): ConfigOptions {\n    if (this.#options) return this.#options\n    const scurry = new PathScurry(this.projectRoot)\n    const packageJson = new PackageJson()\n    const asRecords = pairsToRecords(this.parse().values)\n    const extras = {\n      projectRoot: this.projectRoot,\n      scurry,\n      packageJson,\n      monorepo: Monorepo.maybeLoad(this.projectRoot, {\n        scurry,\n        packageJson,\n      }),\n      catalog: load<Record<string, string>>(\n        'catalog',\n        assertRecordStringString,\n      ),\n      catalogs: load<Record<string, Record<string, string>>>(\n        'catalogs',\n        o =>\n          assertRecordStringT(\n            o,\n            isRecordStringString,\n            'Record<string, Record<string, string>>',\n          ),\n      ),\n    }\n\n    const options: Omit<ConfigOptions, 'packageInfo'> = Object.assign(\n      asRecords,\n      extras,\n    )\n\n    this.#options = Object.assign(options, {\n      packageInfo: new PackageInfoClient(options),\n      [kCustomInspect]() {\n        return Object.fromEntries(\n          Object.entries(options).filter(\n            ([k]) =>\n              k !== 'monorepo' &&\n              k !== 'scurry' &&\n              k !== 'packageJson' &&\n              k !== 'packageInfo',\n          ),\n        )\n      },\n    })\n    return this.#options\n  }\n\n  /**\n   * Reset the options value, optionally setting a new project root\n   * to recalculate the options.\n   */\n  resetOptions(projectRoot: string = process.cwd()) {\n    this.projectRoot = projectRoot\n    this.#options = undefined\n  }\n\n  // memoized options() getter value\n  #options?: ConfigOptions\n\n  /**\n   * positional arguments to the vlt process\n   */\n  positionals?: string[]\n\n  /**\n   * The root of the project where a vlt.json, vlt.json,\n   * package.json, or .git was found. Not necessarily the `process.cwd()`,\n   * though that is the default location.\n   *\n   * Never walks up as far as `$HOME`. So for example, if a project is in\n   * `~/projects/xyz`, then the highest dir it will check is `~/projects`\n   */\n  projectRoot: string\n\n  /**\n   * `Record<alias, canonical name>` to dereference command aliases.\n   */\n  commands: Commands\n\n  /**\n   * Which command name to use for overriding with command-specific values,\n   * determined from the argv when parse() is called.\n   */\n  command?: Commands[keyof Commands]\n\n  constructor(\n    jack: Jack<ConfigDefinitions> = definition,\n    projectRoot = process.cwd(),\n  ) {\n    this.projectRoot = projectRoot\n    this.commands = commands\n    this.jack = jack\n  }\n\n  /**\n   * Parse the arguments and set configuration and positionals accordingly.\n   */\n  parse(args: string[] = process.argv): this & ParsedConfig {\n    if (isParsed(this)) return this\n\n    this.jack.loadEnvDefaults()\n    const p = this.jack.parseRaw(args)\n\n    const fallback = getCommand(p.values['fallback-command'])\n    this.command = getCommand(p.positionals[0])\n\n    const cmdOrFallback = this.command ?? fallback\n    const cmdSpecific =\n      cmdOrFallback && this.commandValues[cmdOrFallback]\n    if (cmdSpecific) {\n      this.jack.setConfigValues(recordsToPairs(cmdSpecific))\n    }\n\n    // ok, applied cmd-specific defaults, do rest of the parse\n    this.jack.applyDefaults(p)\n    this.jack.writeEnv(p)\n\n    if (this.command) p.positionals.shift()\n    else this.command = getCommand(p.values['fallback-command'])\n\n    Object.assign(this, p)\n\n    /* c8 ignore start - unpossible */\n    if (!isParsed(this)) throw error('failed to parse config')\n    /* c8 ignore stop */\n\n    return this\n  }\n\n  /**\n   * Get a `key=value` list option value as an object.\n   *\n   * For example, a list option with a vlaue of `['key=value', 'xyz=as=df' ]`\n   * would be returned as `{key: 'value', xyz: 'as=df'}`\n   *\n   * Results are memoized, so subsequent calls for the same key will return the\n   * same object. If new strings are added to the list, then the memoized value\n   * is *not* updated, so only use once configurations have been fully loaded.\n   *\n   * If the config value is not set at all, an empty object is returned.\n   */\n  getRecord(k: OptListKeys<ConfigData>): RecordString {\n    const pairs = this.get(k) as\n      | (string[] & { [kRecord]?: RecordString })\n      | undefined\n    if (!pairs) return {}\n    if (pairs[kRecord]) return pairs[kRecord]\n    const kv = pairs.reduce((kv: RecordString, pair) => {\n      const eq = pair.indexOf('=')\n      if (eq === -1) return kv\n      const key = pair.substring(0, eq)\n      const val = pair.substring(eq + 1)\n      kv[key] = val\n      return kv\n    }, {})\n    Object.assign(pairs, { [kRecord]: kv })\n    return kv\n  }\n\n  /**\n   * Get a configuration value.\n   *\n   * Note: `key=value` pair configs are returned as a string array. To get them\n   * as an object, use {@link Config#getRecord}.\n   */\n  get<K extends keyof OptionsResults<ConfigDefinitions>>(\n    k: K,\n  ): OptionsResults<ConfigDefinitions>[K] {\n    /* c8 ignore next -- impossible but TS doesn't know that */\n    return (this.values ?? this.parse().values)[k]\n  }\n\n  /**\n   * Write the config values to the user or project config file.\n   */\n  async writeConfigFile(\n    this: LoadedConfig,\n    which: WhichConfig,\n    values: NonNullable<ConfigFileData>,\n  ) {\n    return save('config', pairsToRecords(values), which)\n  }\n\n  /**\n   * Fold in the provided fields with the existing properties\n   * in the config file.\n   */\n  async addConfigToFile(\n    this: LoadedConfig,\n    which: WhichConfig,\n    values: NonNullable<ConfigFileData>,\n  ) {\n    return this.writeConfigFile(\n      which,\n      merge((await this.#maybeLoadConfigFile(which)) ?? {}, values),\n    )\n  }\n\n  // called in this weird bound way so that it can be used by the\n  // vlt-json config loading module.\n  #validator: Validator<ConfigFileData> = function (\n    this: Config,\n    c: unknown,\n    file: string,\n  ) {\n    this.#validateConfig(c, file)\n  }.bind(this)\n\n  #validateConfig(\n    c: unknown,\n    file: string,\n  ): asserts c is ConfigFileData {\n    if (!c || typeof c !== 'object' || Array.isArray(c)) {\n      throw error('invalid config, expected object', {\n        path: file,\n        found: c,\n        wanted: 'ConfigFileData',\n      })\n    }\n\n    const { command, ...values } = recordsToPairs(c as RecordPairs)\n    if (command) {\n      for (const [c, opts] of Object.entries(command)) {\n        const cmd = getCommand(c)\n        if (cmd) {\n          this.commandValues[cmd] = merge<ConfigData>(\n            this.commandValues[cmd] ?? ({} as ConfigData),\n            opts as ConfigData,\n          )\n        }\n      }\n    }\n    this.jack.setConfigValues(values, file)\n  }\n\n  /**\n   * if the file exists, parse and load it. returns object if data was\n   * loaded, or undefined if not.\n   */\n  async #maybeLoadConfigFile(whichConfig: WhichConfig) {\n    return load('config', this.#validator, whichConfig)\n  }\n\n  /**\n   * Deletes the specified config fields from the named file\n   * Returns `true` if anything was changed.\n   */\n  async deleteConfigKeys(\n    this: LoadedConfig,\n    which: WhichConfig,\n    fields: string[],\n  ) {\n    const data = await this.#maybeLoadConfigFile(which)\n    if (!data) return false\n    let didSomething = false\n    for (const f of fields) {\n      const [key, ...sk] = f.split('.') as [\n        h: string,\n        ...rest: string[],\n      ]\n      const subs = sk.join('.')\n      const k = key as keyof ConfigDefinitions\n      const v = data[k]\n      if (v === undefined) continue\n      if (subs && v && typeof v === 'object') {\n        if (Array.isArray(v)) {\n          const i = v.findIndex(subvalue =>\n            subvalue.startsWith(`${subs}=`),\n          )\n          if (i !== -1) {\n            if (v.length === 1) delete data[k]\n            else v.splice(i, 1)\n            didSomething = true\n          }\n        } else {\n          if (v[subs] !== undefined) {\n            delete v[subs]\n            if (Object.keys(v).length === 0) delete data[k]\n            didSomething = true\n          }\n        }\n      } else {\n        didSomething = true\n        delete data[k]\n      }\n    }\n    if (didSomething) await this.writeConfigFile(which, data)\n    return didSomething\n  }\n\n  /**\n   * Edit the user or project configuration file.\n   *\n   * If the file isn't present, then it starts with `{}` so the user has\n   * something to work with.\n   *\n   * If the result is not valid, or no config settings are contained in the\n   * file after editing, then it's restored to what it was before, which might\n   * mean deleting the file.\n   */\n  async editConfigFile(\n    this: LoadedConfig,\n    which: WhichConfig,\n    edit: (file: string) => Promise<void> | void,\n  ) {\n    // load the file as a backup\n    // call the edit function\n    // reload it\n    const file = find(which)\n    const backup = await readFile(file, 'utf8').catch(() => undefined)\n    if (!backup) {\n      await writeFile(\n        file,\n        JSON.stringify({ config: {} }, null, 2) + '\\n',\n      )\n    }\n    let valid = false\n    try {\n      await edit(file)\n      // force it to reload the file and validate it again\n      // if this fails, we roll back.\n      const result = reload('config', which)\n      save('config', result ?? {}, which)\n      valid = true\n    } finally {\n      if (!valid) {\n        // TODO: maybe write the file to a re-edit backup location?\n        // then you could do `vlt config edit retry` or something.\n        if (backup) {\n          await writeFile(file, backup)\n          reload(which)\n        } else {\n          await rm(file, { force: true })\n        }\n      }\n    }\n  }\n\n  /**\n   * Find the local config file and load both it and the user-level config in\n   * the XDG config home.\n   */\n  async loadConfigFile(): Promise<this> {\n    await this.#maybeLoadConfigFile('user')\n    this.projectRoot = dirname(find('project', this.projectRoot))\n    await this.#maybeLoadConfigFile('project')\n    return this\n  }\n\n  /**\n   * cache of the loaded config\n   */\n  static #loaded: LoadedConfig | undefined\n\n  /**\n   * Load the configuration and return a Promise to a\n   * {@link Config} object\n   */\n  static async load(\n    projectRoot = process.cwd(),\n    argv = process.argv,\n    /**\n     * only used in tests, resets the memoization\n     * @internal\n     */\n    reload = false,\n  ): Promise<LoadedConfig> {\n    if (this.#loaded && !reload) return this.#loaded\n    const a = new Config(definition, projectRoot)\n    const b = await a.loadConfigFile()\n    this.#loaded = b.parse(argv) as LoadedConfig\n    return this.#loaded\n  }\n}\n\nconst isParsed = (c: Config): c is ParsedConfig =>\n  !!(c.values && c.positionals && c.command)\n\nexport type ParsedConfig = Config & {\n  command: NonNullable<Config['command']>\n  values: OptionsResults<ConfigDefinitions>\n  positionals: string[]\n}\n\n/**\n * A fully loaded {@link Config} object\n */\nexport type LoadedConfig = ParsedConfig\n"]}

package/dist/esm/output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/output.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,SAAS,IAAI,aAAa,EAC3B,MAAM,WAAW,CAAA;AAGlB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzC,OAAO,KAAK,EAAE,IAAI,EAAe,KAAK,EAAE,MAAM,WAAW,CAAA;AAWzD,eAAO,MAAM,MAAM,YAAa,OAAO,EAAE,SAAyB,CAAA;AAElE,eAAO,MAAM,MAAM,YAAa,OAAO,EAAE,SAA2B,CAAA;AAEpE,KAAK,WAAW,GAAG,CACjB,MAAM,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,EAC3C,CAAC,EAAE,MAAM,KACN,MAAM,CAAA;AAUX,eAAO,IAAI,eAAe,EAAE,WAAyB,CAAA;AACrD,eAAO,IAAI,eAAe,EAAE,WAAyB,CAAA;AAKrD,eAAO,MAAM,OAAO,GAAI,CAAC,QACjB,YAAY,UACV,KAAK,CAAC,CAAC,CAAC,KACf,IAAI,CAAC,CAAC,CAyBR,CAAA;AAED,MAAM,MAAM,MAAM,CAAC,CAAC,IAChB,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GACjC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,CAAA;AAsC5B;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAU,CAAC,cACvB,OAAO,CAAC,CAAC,CAAC,QAChB,YAAY,cACP;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,kBAoD7B,CAAA"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/output.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,SAAS,IAAI,aAAa,EAC3B,MAAM,WAAW,CAAA;AAGlB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzC,OAAO,KAAK,EAAE,IAAI,EAAe,KAAK,EAAE,MAAM,WAAW,CAAA;AAWzD,eAAO,MAAM,MAAM,YAAa,OAAO,EAAE,SAAyB,CAAA;AAElE,eAAO,MAAM,MAAM,YAAa,OAAO,EAAE,SAA2B,CAAA;AAEpE,KAAK,WAAW,GAAG,CACjB,MAAM,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,EAC3C,CAAC,EAAE,MAAM,KACN,MAAM,CAAA;AASX,eAAO,IAAI,eAAe,EAAE,WAAyB,CAAA;AACrD,eAAO,IAAI,eAAe,EAAE,WAAyB,CAAA;AAKrD,eAAO,MAAM,OAAO,GAAI,CAAC,QACjB,YAAY,UACV,KAAK,CAAC,CAAC,CAAC,KACf,IAAI,CAAC,CAAC,CAyBR,CAAA;AAED,MAAM,MAAM,MAAM,CAAC,CAAC,IAChB,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GACjC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,CAAA;AAsC5B;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAU,CAAC,cACvB,OAAO,CAAC,CAAC,CAAC,QAChB,YAAY,cACP;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,kBAoD7B,CAAA"}

package/dist/esm/output.js

@@ -15,9 +15,7 @@ export const stdout = (...args) => console.log(...args);
 // eslint-disable-next-line no-console
 export const stderr = (...args) => console.error(...args);
 /* c8 ignore start */
-const styleText = (f, s) => 
-// @ts-expect-error -- styleText 3rd argument is not in types/node
-utilStyleText(f, s, { validateStream: false });
+const styleText = (f, s) => utilStyleText(f, s, { validateStream: false });
 /* c8 ignore stop */
 // TODO: stop exporting mutable variables once exec output is refactored
 /* c8 ignore start */

package/dist/esm/output.js.map

@@ -1 +1 @@
-{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/output.ts"],"names":[],"mappings":"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","sourcesContent":["import type { WriteStream } from 'node:tty'\nimport {\n  formatWithOptions,\n  styleText as utilStyleText,\n} from 'node:util'\nimport { createSupportsColor } from 'supports-color'\nimport { defaultView } from './config/definition.ts'\nimport type { LoadedConfig } from './config/index.ts'\nimport type { Command } from './index.ts'\nimport { printErr, formatOptions } from './print-err.ts'\nimport type { View, ViewOptions, Views } from './view.ts'\nimport { isViewClass } from './view.ts'\n\nconst supportsColor = (stream: WriteStream) => {\n  const res = createSupportsColor(stream, { sniffFlags: false })\n  if (res === false) return false\n  /* c8 ignore next */\n  return res.level > 0\n}\n\n// eslint-disable-next-line no-console\nexport const stdout = (...args: unknown[]) => console.log(...args)\n// eslint-disable-next-line no-console\nexport const stderr = (...args: unknown[]) => console.error(...args)\n\ntype StyleTextFn = (\n  format: Parameters<typeof utilStyleText>[0],\n  s: string,\n) => string\n\n/* c8 ignore start */\nconst styleText: StyleTextFn = (f, s) =>\n  // @ts-expect-error -- styleText 3rd argument is not in types/node\n  utilStyleText(f, s, { validateStream: false })\n/* c8 ignore stop */\n\n// TODO: stop exporting mutable variables once exec output is refactored\n/* c8 ignore start */\nexport let styleTextStdout: StyleTextFn = (_, s) => s\nexport let styleTextStderr: StyleTextFn = (_, s) => s\n/* c8 ignore stop */\n\nconst identity = <T>(x: T): T => x\n\nexport const getView = <T>(\n  conf: LoadedConfig,\n  views?: Views<T>,\n): View<T> => {\n  const viewName = conf.values.view\n\n  const viewFn =\n    viewName === 'inspect' ? identity\n    : typeof views === 'function' ? views\n    : views && typeof views === 'object' ? views[viewName]\n    : identity\n\n  // if the user specified a view that doesn't exist, then set it back to the\n  // default, and try again. This will fall back to identity if it's also\n  // missing. We also always treat 'json' as a valid view that falls back to\n  // identity. This allows the explicit use of `--view=json` to work even\n  // when the default view is `human`.\n  if (\n    !viewFn &&\n    conf.values.view !== defaultView &&\n    conf.values.view !== 'json'\n  ) {\n    conf.values.view = defaultView\n    process.env.VLT_VIEW = defaultView\n    return getView(conf, views)\n  }\n\n  return viewFn ?? identity\n}\n\nexport type OnDone<T> =\n  | ((result: T) => Promise<unknown>)\n  | ((result: T) => unknown)\n\n/**\n * If the view is a View class, then instantiate and start it.\n * If it's a view function, then just define the onDone method.\n */\nconst startView = <T>(\n  conf: LoadedConfig,\n  opts: ViewOptions,\n  views?: Views<T>,\n  { start }: { start: number } = { start: Date.now() },\n): {\n  onDone: OnDone<T>\n  onError?: (err: unknown) => void\n} => {\n  const View = getView<T>(conf, views)\n\n  if (isViewClass(View)) {\n    const view = new View(opts, conf)\n    view.start()\n    return {\n      onDone(r) {\n        return view.done(r, { time: Date.now() - start })\n      },\n      onError(err) {\n        view.error(err)\n      },\n    }\n  }\n\n  return {\n    async onDone(r) {\n      if (r === undefined) return\n      return View(r, opts, conf)\n    },\n  }\n}\n\n/**\n * Main export. Run the command appropriately, displaying output using\n * the user-requested view, or the default if the user requested a view\n * that is not defined for this command.\n */\nexport const outputCommand = async <T>(\n  cliCommand: Command<T>,\n  conf: LoadedConfig,\n  { start }: { start: number } = { start: Date.now() },\n) => {\n  const { usage, views, command } = cliCommand\n\n  if (conf.values.help) {\n    return stdout(usage().usage())\n  }\n\n  const stdoutColor =\n    conf.values.color ?? supportsColor(process.stdout)\n  const stderrColor =\n    conf.values.color ?? supportsColor(process.stderr)\n\n  /* c8 ignore start */\n  if (stdoutColor) styleTextStdout = styleText\n  if (stderrColor) styleTextStderr = styleText\n  /* c8 ignore stop */\n\n  const { onDone, onError } = startView(\n    conf,\n    // assume views will always output to stdout so use color support from there\n    { colors: stdoutColor },\n    views,\n    { start },\n  )\n\n  try {\n    const output = await onDone(await command(conf))\n    if (output !== undefined) {\n      stdout(\n        conf.values.view === 'json' ?\n          JSON.stringify(output, null, 2)\n        : formatWithOptions(\n            {\n              ...formatOptions,\n              colors: stdoutColor,\n            },\n            output,\n          ),\n      )\n    }\n  } catch (err) {\n    onError?.(err)\n    process.exitCode ||= 1\n\n    printErr(err, usage, stderr, {\n      ...formatOptions,\n      colors: stderrColor,\n    })\n\n    process.exit(process.exitCode)\n  }\n}\n"]}
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/output.ts"],"names":[],"mappings":"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","sourcesContent":["import type { WriteStream } from 'node:tty'\nimport {\n  formatWithOptions,\n  styleText as utilStyleText,\n} from 'node:util'\nimport { createSupportsColor } from 'supports-color'\nimport { defaultView } from './config/definition.ts'\nimport type { LoadedConfig } from './config/index.ts'\nimport type { Command } from './index.ts'\nimport { printErr, formatOptions } from './print-err.ts'\nimport type { View, ViewOptions, Views } from './view.ts'\nimport { isViewClass } from './view.ts'\n\nconst supportsColor = (stream: WriteStream) => {\n  const res = createSupportsColor(stream, { sniffFlags: false })\n  if (res === false) return false\n  /* c8 ignore next */\n  return res.level > 0\n}\n\n// eslint-disable-next-line no-console\nexport const stdout = (...args: unknown[]) => console.log(...args)\n// eslint-disable-next-line no-console\nexport const stderr = (...args: unknown[]) => console.error(...args)\n\ntype StyleTextFn = (\n  format: Parameters<typeof utilStyleText>[0],\n  s: string,\n) => string\n\n/* c8 ignore start */\nconst styleText: StyleTextFn = (f, s) =>\n  utilStyleText(f, s, { validateStream: false })\n/* c8 ignore stop */\n\n// TODO: stop exporting mutable variables once exec output is refactored\n/* c8 ignore start */\nexport let styleTextStdout: StyleTextFn = (_, s) => s\nexport let styleTextStderr: StyleTextFn = (_, s) => s\n/* c8 ignore stop */\n\nconst identity = <T>(x: T): T => x\n\nexport const getView = <T>(\n  conf: LoadedConfig,\n  views?: Views<T>,\n): View<T> => {\n  const viewName = conf.values.view\n\n  const viewFn =\n    viewName === 'inspect' ? identity\n    : typeof views === 'function' ? views\n    : views && typeof views === 'object' ? views[viewName]\n    : identity\n\n  // if the user specified a view that doesn't exist, then set it back to the\n  // default, and try again. This will fall back to identity if it's also\n  // missing. We also always treat 'json' as a valid view that falls back to\n  // identity. This allows the explicit use of `--view=json` to work even\n  // when the default view is `human`.\n  if (\n    !viewFn &&\n    conf.values.view !== defaultView &&\n    conf.values.view !== 'json'\n  ) {\n    conf.values.view = defaultView\n    process.env.VLT_VIEW = defaultView\n    return getView(conf, views)\n  }\n\n  return viewFn ?? identity\n}\n\nexport type OnDone<T> =\n  | ((result: T) => Promise<unknown>)\n  | ((result: T) => unknown)\n\n/**\n * If the view is a View class, then instantiate and start it.\n * If it's a view function, then just define the onDone method.\n */\nconst startView = <T>(\n  conf: LoadedConfig,\n  opts: ViewOptions,\n  views?: Views<T>,\n  { start }: { start: number } = { start: Date.now() },\n): {\n  onDone: OnDone<T>\n  onError?: (err: unknown) => void\n} => {\n  const View = getView<T>(conf, views)\n\n  if (isViewClass(View)) {\n    const view = new View(opts, conf)\n    view.start()\n    return {\n      onDone(r) {\n        return view.done(r, { time: Date.now() - start })\n      },\n      onError(err) {\n        view.error(err)\n      },\n    }\n  }\n\n  return {\n    async onDone(r) {\n      if (r === undefined) return\n      return View(r, opts, conf)\n    },\n  }\n}\n\n/**\n * Main export. Run the command appropriately, displaying output using\n * the user-requested view, or the default if the user requested a view\n * that is not defined for this command.\n */\nexport const outputCommand = async <T>(\n  cliCommand: Command<T>,\n  conf: LoadedConfig,\n  { start }: { start: number } = { start: Date.now() },\n) => {\n  const { usage, views, command } = cliCommand\n\n  if (conf.values.help) {\n    return stdout(usage().usage())\n  }\n\n  const stdoutColor =\n    conf.values.color ?? supportsColor(process.stdout)\n  const stderrColor =\n    conf.values.color ?? supportsColor(process.stderr)\n\n  /* c8 ignore start */\n  if (stdoutColor) styleTextStdout = styleText\n  if (stderrColor) styleTextStderr = styleText\n  /* c8 ignore stop */\n\n  const { onDone, onError } = startView(\n    conf,\n    // assume views will always output to stdout so use color support from there\n    { colors: stdoutColor },\n    views,\n    { start },\n  )\n\n  try {\n    const output = await onDone(await command(conf))\n    if (output !== undefined) {\n      stdout(\n        conf.values.view === 'json' ?\n          JSON.stringify(output, null, 2)\n        : formatWithOptions(\n            {\n              ...formatOptions,\n              colors: stdoutColor,\n            },\n            output,\n          ),\n      )\n    }\n  } catch (err) {\n    onError?.(err)\n    process.exitCode ||= 1\n\n    printErr(err, usage, stderr, {\n      ...formatOptions,\n      colors: stderrColor,\n    })\n\n    process.exit(process.exitCode)\n  }\n}\n"]}

package/dist/esm/print-err.d.ts

@@ -1,5 +1,5 @@
-import type { CommandUsage } from './index.ts';
 import type { InspectOptions } from 'node:util';
+import type { CommandUsage } from './index.ts';
 export declare const formatOptions: {
     readonly depth: number;
     readonly maxArrayLength: number;

package/dist/esm/print-err.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"print-err.d.ts","sourceRoot":"","sources":["../../src/print-err.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAM/C,eAAO,MAAM,aAAa;;;;CAIS,CAAA;AAEnC,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,CACtB,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE,kBAAkB,KACzB,MAAM,CAAA;AAQX,eAAO,MAAM,MAAM,UAAW,MAAM,yBAIrB,CAAA;AAoBf,eAAO,MAAM,QAAQ,MAChB,OAAO,SACH,YAAY,UACX,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,aACrB,kBAAkB,SAwC9B,CAAA"}
+{"version":3,"file":"print-err.d.ts","sourceRoot":"","sources":["../../src/print-err.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,eAAO,MAAM,aAAa;;;;CAIS,CAAA;AAEnC,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,CACtB,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE,kBAAkB,KACzB,MAAM,CAAA;AAWX,eAAO,MAAM,MAAM,UAAW,MAAM,yBAIrB,CAAA;AAoBf,eAAO,MAAM,QAAQ,MAChB,OAAO,SACH,YAAY,UACX,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,aACrB,kBAAkB,SAwC9B,CAAA"}

package/dist/esm/print-err.js

@@ -1,13 +1,17 @@
+import { splitDepID } from '@vltpkg/dep-id';
 import { parseError } from '@vltpkg/output/error';
-import { formatWithOptions } from 'node:util';
+import { isErrorWithCause, isObject } from '@vltpkg/types';
 import { XDG } from '@vltpkg/xdg';
+import { isGraphRunError } from 'graph-run';
+import { mkdirSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { writeFileSync, mkdirSync } from 'node:fs';
+import { formatWithOptions } from 'node:util';
 export const formatOptions = {
     depth: Infinity,
     maxArrayLength: Infinity,
     maxStringLength: Infinity,
 };
+const isNonEmptyString = (v) => !!v && typeof v === 'string';
 const formatURL = (v, format) => v instanceof URL ? v.toString() : /* c8 ignore next */ format(v);
 const formatArray = (v, format, joiner = ', ') => Array.isArray(v) ? v.join(joiner) : /* c8 ignore next */ format(v);
 export const indent = (lines, num = 2) => lines
@@ -69,6 +73,45 @@ const printCode = (err, usage, stderr, format) => {
     if (!err)
         return;
     switch (err.cause?.code) {
+        case 'GRAPHRUN_TRAVERSAL': {
+            if (!isGraphRunError(err))
+                break;
+            const { node, path, cause } = err.cause;
+            stderr(`Graph traversal failure at: ${splitDepID(node.id).join(' ')}`);
+            if (Array.isArray(path) && path.length) {
+                stderr(indent(`Path: ${path.map(n => n.id).join(',')}`));
+            }
+            if (isErrorWithCause(cause) &&
+                isObject(cause.cause) &&
+                'command' in cause.cause &&
+                'stdout' in cause.cause &&
+                'stderr' in cause.cause &&
+                'status' in cause.cause &&
+                'signal' in cause.cause &&
+                'cwd' in cause.cause) {
+                const { command, args, cwd, stdout: cmdStdout, stderr: cmdStderr, status, signal, } = cause.cause;
+                stderr(`Command: ${command}`);
+                if (args && Array.isArray(args) && args.length) {
+                    stderr(`Args: ${args.map(a => JSON.stringify(a)).join(', ')}`);
+                }
+                stderr(`Cwd: ${cwd}`);
+                if (cmdStderr || cmdStdout) {
+                    stderr('');
+                    if (isNonEmptyString(cmdStderr)) {
+                        stderr(cmdStderr);
+                    }
+                    if (isNonEmptyString(cmdStdout)) {
+                        stderr(cmdStdout);
+                    }
+                    stderr('');
+                }
+                if (signal !== null)
+                    stderr(`Signal: ${format(signal)}`);
+                if (status !== null)
+                    stderr(`Status: ${format(status)}`);
+            }
+            return { file: true };
+        }
         case 'EUSAGE': {
             const { found, validOptions } = err.cause;
             stderr(usage().usage());

package/dist/esm/print-err.js.map

@@ -1 +1 @@
-{"version":3,"file":"print-err.js","sourceRoot":"","sources":["../../src/print-err.ts"],"names":[],"mappings":"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","sourcesContent":["import { parseError } from '@vltpkg/output/error'\nimport type { ParsedError } from '@vltpkg/output/error'\nimport type { CommandUsage } from './index.ts'\nimport type { InspectOptions } from 'node:util'\nimport { formatWithOptions } from 'node:util'\nimport { XDG } from '@vltpkg/xdg'\nimport { join } from 'node:path'\nimport { writeFileSync, mkdirSync } from 'node:fs'\n\nexport const formatOptions = {\n  depth: Infinity,\n  maxArrayLength: Infinity,\n  maxStringLength: Infinity,\n} as const satisfies InspectOptions\n\nexport type ErrorFormatOptions = InspectOptions & {\n  maxLines?: number\n}\n\nexport type Formatter = (\n  arg: unknown,\n  options?: ErrorFormatOptions,\n) => string\n\nconst formatURL = (v: unknown, format: Formatter) =>\n  v instanceof URL ? v.toString() : /* c8 ignore next */ format(v)\n\nconst formatArray = (v: unknown, format: Formatter, joiner = ', ') =>\n  Array.isArray(v) ? v.join(joiner) : /* c8 ignore next */ format(v)\n\nexport const indent = (lines: string, num = 2) =>\n  lines\n    .split('\\n')\n    .map(l => ' '.repeat(num) + l)\n    .join('\\n')\n\nconst writeErrorLog = (e: unknown, format: Formatter) => {\n  try {\n    const dir = new XDG('vlt/error-logs').data()\n    const file = join(dir, `error-${process.pid}.log`)\n    mkdirSync(dir, { recursive: true })\n    writeFileSync(\n      file,\n      format(e, {\n        colors: false,\n        maxLines: Infinity,\n      }),\n    )\n    return file\n  } catch {\n    return null\n  }\n}\n\nexport const printErr = (\n  e: unknown,\n  usage: CommandUsage,\n  stderr: (...a: string[]) => void,\n  baseOpts?: ErrorFormatOptions,\n) => {\n  const format: Formatter = (arg: unknown, opts) => {\n    const { maxLines = 200, ...rest } = {\n      ...formatOptions,\n      ...baseOpts,\n      ...opts,\n    }\n    const lines = formatWithOptions(rest, arg).split('\\n')\n    const totalLines = lines.length\n    if (totalLines > maxLines) {\n      lines.length = maxLines\n      lines.push(`... ${totalLines - maxLines} lines hidden ...`)\n    }\n    return lines.join('\\n')\n  }\n\n  const err = parseError(e)\n  const knownError = printCode(err, usage, stderr, format)\n  const fileWritten =\n    !knownError || knownError.file ? writeErrorLog(e, format) : null\n\n  // We could not write an error log and its not a know error,\n  // so we print the entire formatted value.\n  if (!fileWritten && !knownError) {\n    return stderr(format(e))\n  }\n\n  if (err && !knownError) {\n    stderr(`${err.name}: ${err.message}`)\n  }\n  if (fileWritten) {\n    stderr('')\n    stderr(`Full details written to: ${fileWritten}`)\n  }\n  if (!knownError || knownError.bug) {\n    stderr('')\n    stderr('Open an issue with the full error details at:')\n    stderr(indent('https://github.com/vltpkg/vltpkg/issues/new'))\n  }\n}\n\nconst printCode = (\n  err: ParsedError | null,\n  usage: CommandUsage,\n  stderr: (...a: string[]) => void,\n  format: Formatter,\n): void | { bug?: boolean; file?: boolean } => {\n  if (!err) return\n\n  switch (err.cause?.code) {\n    case 'EUSAGE': {\n      const { found, validOptions } = err.cause\n      stderr(usage().usage())\n      stderr(`Usage Error: ${err.message}`)\n      if (found) {\n        stderr(indent(`Found: ${format(found)}`))\n      }\n      if (validOptions) {\n        stderr(\n          indent(\n            `Valid options: ${formatArray(validOptions, format)}`,\n          ),\n        )\n      }\n      return {}\n    }\n\n    case 'ERESOLVE': {\n      const { url, from, response, spec } = err.cause\n      stderr(`Resolve Error: ${err.message}`)\n      if (url) {\n        stderr(indent(`While fetching: ${formatURL(url, format)}`))\n      }\n      if (spec) {\n        stderr(indent(`To satisfy: ${format(spec)}`))\n      }\n      if (from) {\n        stderr(indent(`From: ${format(from)}`))\n      }\n      if (response) {\n        stderr(indent(`Response: ${format(response)}`))\n      }\n      return { file: true }\n    }\n\n    case 'EREQUEST': {\n      const { url, method } = err.cause\n      const { code, syscall } = err.cause.cause ?? {}\n      stderr(`Request Error: ${err.message}`)\n      if (code) {\n        stderr(indent(`Code: ${format(code)}`))\n      }\n      if (syscall) {\n        stderr(indent(`Syscall: ${format(syscall)}`))\n      }\n      if (url) {\n        stderr(indent(`URL: ${formatURL(url, format)}`))\n      }\n      if (method) {\n        stderr(indent(`Method: ${format(method)}`))\n      }\n      return { file: true }\n    }\n\n    case 'ECONFIG': {\n      const { found, wanted, validOptions } = err.cause\n      stderr(`Config Error: ${err.message}`)\n      if (found) {\n        stderr(indent(`Found: ${format(found)}`))\n      }\n      if (wanted) {\n        stderr(indent(`Wanted: ${format(wanted)}`))\n      }\n      if (validOptions) {\n        stderr(indent(`Valid Options: ${format(validOptions)}`))\n      }\n      return {}\n    }\n  }\n}\n"]}
+{"version":3,"file":"print-err.js","sourceRoot":"","sources":["../../src/print-err.ts"],"names":[],"mappings":"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","sourcesContent":["import { splitDepID } from '@vltpkg/dep-id'\nimport type { Node } from '@vltpkg/graph'\nimport type { ParsedError } from '@vltpkg/output/error'\nimport { parseError } from '@vltpkg/output/error'\nimport { isErrorWithCause, isObject } from '@vltpkg/types'\nimport { XDG } from '@vltpkg/xdg'\nimport { isGraphRunError } from 'graph-run'\nimport { mkdirSync, writeFileSync } from 'node:fs'\nimport { join } from 'node:path'\nimport type { InspectOptions } from 'node:util'\nimport { formatWithOptions } from 'node:util'\nimport type { CommandUsage } from './index.ts'\n\nexport const formatOptions = {\n  depth: Infinity,\n  maxArrayLength: Infinity,\n  maxStringLength: Infinity,\n} as const satisfies InspectOptions\n\nexport type ErrorFormatOptions = InspectOptions & {\n  maxLines?: number\n}\n\nexport type Formatter = (\n  arg: unknown,\n  options?: ErrorFormatOptions,\n) => string\n\nconst isNonEmptyString = (v: unknown): v is string =>\n  !!v && typeof v === 'string'\n\nconst formatURL = (v: unknown, format: Formatter) =>\n  v instanceof URL ? v.toString() : /* c8 ignore next */ format(v)\n\nconst formatArray = (v: unknown, format: Formatter, joiner = ', ') =>\n  Array.isArray(v) ? v.join(joiner) : /* c8 ignore next */ format(v)\n\nexport const indent = (lines: string, num = 2) =>\n  lines\n    .split('\\n')\n    .map(l => ' '.repeat(num) + l)\n    .join('\\n')\n\nconst writeErrorLog = (e: unknown, format: Formatter) => {\n  try {\n    const dir = new XDG('vlt/error-logs').data()\n    const file = join(dir, `error-${process.pid}.log`)\n    mkdirSync(dir, { recursive: true })\n    writeFileSync(\n      file,\n      format(e, {\n        colors: false,\n        maxLines: Infinity,\n      }),\n    )\n    return file\n  } catch {\n    return null\n  }\n}\n\nexport const printErr = (\n  e: unknown,\n  usage: CommandUsage,\n  stderr: (...a: string[]) => void,\n  baseOpts?: ErrorFormatOptions,\n) => {\n  const format: Formatter = (arg: unknown, opts) => {\n    const { maxLines = 200, ...rest } = {\n      ...formatOptions,\n      ...baseOpts,\n      ...opts,\n    }\n    const lines = formatWithOptions(rest, arg).split('\\n')\n    const totalLines = lines.length\n    if (totalLines > maxLines) {\n      lines.length = maxLines\n      lines.push(`... ${totalLines - maxLines} lines hidden ...`)\n    }\n    return lines.join('\\n')\n  }\n\n  const err = parseError(e)\n  const knownError = printCode(err, usage, stderr, format)\n  const fileWritten =\n    !knownError || knownError.file ? writeErrorLog(e, format) : null\n\n  // We could not write an error log and its not a know error,\n  // so we print the entire formatted value.\n  if (!fileWritten && !knownError) {\n    return stderr(format(e))\n  }\n\n  if (err && !knownError) {\n    stderr(`${err.name}: ${err.message}`)\n  }\n  if (fileWritten) {\n    stderr('')\n    stderr(`Full details written to: ${fileWritten}`)\n  }\n  if (!knownError || knownError.bug) {\n    stderr('')\n    stderr('Open an issue with the full error details at:')\n    stderr(indent('https://github.com/vltpkg/vltpkg/issues/new'))\n  }\n}\n\nconst printCode = (\n  err: ParsedError | null,\n  usage: CommandUsage,\n  stderr: (...a: string[]) => void,\n  format: Formatter,\n): void | { bug?: boolean; file?: boolean } => {\n  if (!err) return\n\n  switch (err.cause?.code) {\n    case 'GRAPHRUN_TRAVERSAL': {\n      if (!isGraphRunError<Node>(err)) break\n      const { node, path, cause } = err.cause\n      stderr(\n        `Graph traversal failure at: ${splitDepID(node.id).join(' ')}`,\n      )\n      if (Array.isArray(path) && path.length) {\n        stderr(indent(`Path: ${path.map(n => n.id).join(',')}`))\n      }\n      if (\n        isErrorWithCause(cause) &&\n        isObject(cause.cause) &&\n        'command' in cause.cause &&\n        'stdout' in cause.cause &&\n        'stderr' in cause.cause &&\n        'status' in cause.cause &&\n        'signal' in cause.cause &&\n        'cwd' in cause.cause\n      ) {\n        const {\n          command,\n          args,\n          cwd,\n          stdout: cmdStdout,\n          stderr: cmdStderr,\n          status,\n          signal,\n        } = cause.cause\n        stderr(`Command: ${command}`)\n        if (args && Array.isArray(args) && args.length) {\n          stderr(\n            `Args: ${args.map(a => JSON.stringify(a)).join(', ')}`,\n          )\n        }\n        stderr(`Cwd: ${cwd}`)\n\n        if (cmdStderr || cmdStdout) {\n          stderr('')\n          if (isNonEmptyString(cmdStderr)) {\n            stderr(cmdStderr)\n          }\n          if (isNonEmptyString(cmdStdout)) {\n            stderr(cmdStdout)\n          }\n          stderr('')\n        }\n\n        if (signal !== null) stderr(`Signal: ${format(signal)}`)\n        if (status !== null) stderr(`Status: ${format(status)}`)\n      }\n      return { file: true }\n    }\n\n    case 'EUSAGE': {\n      const { found, validOptions } = err.cause\n      stderr(usage().usage())\n      stderr(`Usage Error: ${err.message}`)\n      if (found) {\n        stderr(indent(`Found: ${format(found)}`))\n      }\n      if (validOptions) {\n        stderr(\n          indent(\n            `Valid options: ${formatArray(validOptions, format)}`,\n          ),\n        )\n      }\n      return {}\n    }\n\n    case 'ERESOLVE': {\n      const { url, from, response, spec } = err.cause\n      stderr(`Resolve Error: ${err.message}`)\n      if (url) {\n        stderr(indent(`While fetching: ${formatURL(url, format)}`))\n      }\n      if (spec) {\n        stderr(indent(`To satisfy: ${format(spec)}`))\n      }\n      if (from) {\n        stderr(indent(`From: ${format(from)}`))\n      }\n      if (response) {\n        stderr(indent(`Response: ${format(response)}`))\n      }\n      return { file: true }\n    }\n\n    case 'EREQUEST': {\n      const { url, method } = err.cause\n      const { code, syscall } = err.cause.cause ?? {}\n      stderr(`Request Error: ${err.message}`)\n      if (code) {\n        stderr(indent(`Code: ${format(code)}`))\n      }\n      if (syscall) {\n        stderr(indent(`Syscall: ${format(syscall)}`))\n      }\n      if (url) {\n        stderr(indent(`URL: ${formatURL(url, format)}`))\n      }\n      if (method) {\n        stderr(indent(`Method: ${format(method)}`))\n      }\n      return { file: true }\n    }\n\n    case 'ECONFIG': {\n      const { found, wanted, validOptions } = err.cause\n      stderr(`Config Error: ${err.message}`)\n      if (found) {\n        stderr(indent(`Found: ${format(found)}`))\n      }\n      if (wanted) {\n        stderr(indent(`Wanted: ${format(wanted)}`))\n      }\n      if (validOptions) {\n        stderr(indent(`Valid Options: ${format(validOptions)}`))\n      }\n      return {}\n    }\n  }\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vltpkg/cli-sdk",
   "description": "The source for the vlt CLI",
-  "version": "0.0.0-13",
+  "version": "0.0.0-14",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/vltpkg/vltpkg.git",
@@ -23,49 +23,49 @@
   },
   "dependencies": {
     "ansi-to-pre": "^1.0.6",
-    "ink": "^5.2.0",
+    "graph-run": "^1.1.0",
+    "ink": "^5.2.1",
     "ink-spinner": "^5.0.0",
-    "jackspeak": "^4.1.0",
+    "jackspeak": "^4.1.1",
     "package-json-from-dist": "^1.0.1",
     "path-scurry": "^2.0.0",
-    "polite-json": "^5.0.0",
     "pretty-bytes": "^6.1.1",
     "react": "^18.3.1",
     "react-devtools-core": "^4.28.5",
     "supports-color": "^10.0.0",
-    "walk-up-path": "^4.0.0",
-    "@vltpkg/dep-id": "0.0.0-13",
-    "@vltpkg/dot-prop": "0.0.0-13",
-    "@vltpkg/error-cause": "0.0.0-13",
-    "@vltpkg/graph": "0.0.0-13",
-    "@vltpkg/init": "0.0.0-13",
-    "@vltpkg/package-info": "0.0.0-13",
-    "@vltpkg/package-json": "0.0.0-13",
-    "@vltpkg/query": "0.0.0-13",
-    "@vltpkg/registry-client": "0.0.0-13",
-    "@vltpkg/output": "0.0.0-13",
-    "@vltpkg/rollback-remove": "0.0.0-13",
-    "@vltpkg/security-archive": "0.0.0-13",
-    "@vltpkg/spec": "0.0.0-13",
-    "@vltpkg/run": "0.0.0-13",
-    "@vltpkg/server": "0.0.0-13",
-    "@vltpkg/types": "0.0.0-13",
-    "@vltpkg/url-open": "0.0.0-13",
-    "@vltpkg/vlx": "0.0.0-13",
-    "@vltpkg/workspaces": "0.0.0-13",
-    "@vltpkg/xdg": "0.0.0-13"
+    "@vltpkg/dot-prop": "0.0.0-14",
+    "@vltpkg/dep-id": "0.0.0-14",
+    "@vltpkg/graph": "0.0.0-14",
+    "@vltpkg/init": "0.0.0-14",
+    "@vltpkg/output": "0.0.0-14",
+    "@vltpkg/error-cause": "0.0.0-14",
+    "@vltpkg/package-info": "0.0.0-14",
+    "@vltpkg/package-json": "0.0.0-14",
+    "@vltpkg/query": "0.0.0-14",
+    "@vltpkg/rollback-remove": "0.0.0-14",
+    "@vltpkg/registry-client": "0.0.0-14",
+    "@vltpkg/server": "0.0.0-14",
+    "@vltpkg/run": "0.0.0-14",
+    "@vltpkg/security-archive": "0.0.0-14",
+    "@vltpkg/url-open": "0.0.0-14",
+    "@vltpkg/vlx": "0.0.0-14",
+    "@vltpkg/vlt-json": "0.0.0-14",
+    "@vltpkg/spec": "0.0.0-14",
+    "@vltpkg/types": "0.0.0-14",
+    "@vltpkg/workspaces": "0.0.0-14",
+    "@vltpkg/xdg": "0.0.0-14"
   },
   "devDependencies": {
-    "@eslint/js": "^9.25.1",
-    "@types/node": "^22.15.3",
-    "@types/react": "^18.3.20",
-    "eslint": "^9.25.1",
+    "@eslint/js": "^9.28.0",
+    "@types/node": "^22.15.29",
+    "@types/react": "^18.3.23",
+    "eslint": "^9.28.0",
     "prettier": "^3.5.3",
     "tap": "^21.1.0",
     "tshy": "^3.0.2",
     "typedoc": "~0.27.9",
     "typescript": "5.7.3",
-    "typescript-eslint": "^8.31.1"
+    "typescript-eslint": "^8.33.1"
   },
   "license": "BSD-2-Clause-Patent",
   "engines": {