@vltpkg/cli-sdk 0.0.0-30 → 0.0.0-32

package/dist/esm/commands/docs.js

@@ -0,0 +1,154 @@
+import { error } from '@vltpkg/error-cause';
+import { PackageInfoClient } from '@vltpkg/package-info';
+import { Spec } from '@vltpkg/spec';
+import { urlOpen } from '@vltpkg/url-open';
+import { actual } from '@vltpkg/graph';
+import { Query } from '@vltpkg/query';
+import { SecurityArchive } from '@vltpkg/security-archive';
+import { createHostContextsMap } from "../query-host-contexts.js";
+import { commandUsage } from "../config/usage.js";
+import hostedGitInfo from 'hosted-git-info';
+const { fromUrl: hostedGitInfoFromUrl } = hostedGitInfo;
+export const usage = () => commandUsage({
+    command: 'docs',
+    usage: ['[<spec>]', '[--target=<query>]'],
+    description: `Open documentation for a package in a web browser.
+                  Reads repository information from package.json or fetches
+                  manifest data for the specified package.`,
+    options: {
+        target: {
+            value: '<query>',
+            description: 'Query selector to filter packages using DSS syntax.',
+        },
+    },
+    examples: {
+        '': {
+            description: 'Open docs for the current package (reads local package.json)',
+        },
+        'abbrev@2.0.0': {
+            description: 'Open docs for a specific package version',
+        },
+        '--target=":root > *"': {
+            description: 'List documentation URLs for all direct dependencies',
+        },
+    },
+});
+export const views = {
+    human: r => {
+        if (Array.isArray(r)) {
+            let msg = 'Multiple package docs found:\n';
+            msg += r.map(item => `• ${item.name}: ${item.url}`).join('\n');
+            return msg;
+        }
+        return '';
+    },
+    json: r => r,
+};
+const getUrlFromManifest = (manifest) => {
+    const { name, homepage, repository } = manifest;
+    if (!name) {
+        throw error('No package name found');
+    }
+    // Extract repository URL
+    let url;
+    if (homepage) {
+        url = homepage;
+    }
+    else if (repository) {
+        const repoUrl = typeof repository === 'string' ? repository
+            : typeof repository === 'object' && 'url' in repository ?
+                repository.url
+                : /* c8 ignore next */ undefined;
+        if (repoUrl) {
+            // Try to get hosted git info
+            const info = hostedGitInfoFromUrl(repoUrl.replace(/^git\+/, ''));
+            if (info && typeof info.docs === 'function') {
+                url = info.docs();
+            }
+        }
+    }
+    // Fallback to npmjs.com package page
+    if (!url) {
+        url = `https://www.npmjs.com/package/${name}`;
+    }
+    return url;
+};
+export const command = async (conf) => {
+    const { projectRoot, packageJson } = conf.options;
+    const targetOption = conf.get('target');
+    // Handle --target query
+    if (targetOption) {
+        const mainManifest = packageJson.maybeRead(projectRoot);
+        if (!mainManifest) {
+            throw error('No package.json found in project root', {
+                path: projectRoot,
+            });
+        }
+        const graph = actual.load({
+            ...conf.options,
+            mainManifest,
+            monorepo: conf.options.monorepo,
+            loadManifests: true,
+        });
+        const securityArchive = Query.hasSecuritySelectors(targetOption) ?
+            await SecurityArchive.start({
+                nodes: [...graph.nodes.values()],
+            })
+            : undefined;
+        const hostContexts = await createHostContextsMap(conf);
+        const query = new Query({
+            nodes: new Set(graph.nodes.values()),
+            edges: graph.edges,
+            importers: graph.importers,
+            securityArchive,
+            hostContexts,
+        });
+        const { nodes } = await query.search(targetOption, {
+            signal: new AbortController().signal,
+        });
+        const results = [];
+        for (const node of nodes) {
+            if (!node.manifest)
+                continue;
+            const url = getUrlFromManifest(node.manifest);
+            results.push({
+                url,
+                name: node.name /* c8 ignore next */ ?? '(unknown)',
+            });
+        }
+        if (results.length === 0) {
+            throw error('No packages found matching target query', {
+                found: targetOption,
+            });
+        }
+        // If single result, open it
+        if (results.length === 1) {
+            const result = results[0];
+            /* c8 ignore next 3 */
+            if (!result) {
+                throw error('Unexpected empty result');
+            }
+            await urlOpen(result.url);
+            return result;
+        }
+        // Multiple results, return the list
+        return results;
+    }
+    // read the package spec from a positional argument or local package.json
+    const specArg = conf.positionals[0];
+    const manifest = conf.positionals.length === 0 ? packageJson.read(projectRoot)
+        : specArg ?
+            await new PackageInfoClient(conf.options).manifest(Spec.parseArgs(specArg, conf.options))
+            : /* c8 ignore next */ packageJson.read(projectRoot);
+    const url = getUrlFromManifest(manifest);
+    const { name } = manifest;
+    /* c8 ignore start - getUrlFromManifest already validates name */
+    if (!name) {
+        throw error('No package name found');
+    }
+    /* c8 ignore stop */
+    // Open the URL
+    await urlOpen(url);
+    return { url, name };
+};
+//# sourceMappingURL=docs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/commands/docs.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport { PackageInfoClient } from '@vltpkg/package-info'\nimport { Spec } from '@vltpkg/spec'\nimport { urlOpen } from '@vltpkg/url-open'\nimport { actual } from '@vltpkg/graph'\nimport { Query } from '@vltpkg/query'\nimport { SecurityArchive } from '@vltpkg/security-archive'\nimport { createHostContextsMap } from '../query-host-contexts.ts'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport type { Views } from '../view.ts'\nimport type { Manifest, NormalizedManifest } from '@vltpkg/types'\nimport hostedGitInfo from 'hosted-git-info'\nconst { fromUrl: hostedGitInfoFromUrl } = hostedGitInfo\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'docs',\n    usage: ['[<spec>]', '[--target=<query>]'],\n    description: `Open documentation for a package in a web browser.\n                  Reads repository information from package.json or fetches\n                  manifest data for the specified package.`,\n    options: {\n      target: {\n        value: '<query>',\n        description:\n          'Query selector to filter packages using DSS syntax.',\n      },\n    },\n    examples: {\n      '': {\n        description:\n          'Open docs for the current package (reads local package.json)',\n      },\n      'abbrev@2.0.0': {\n        description: 'Open docs for a specific package version',\n      },\n      '--target=\":root > *\"': {\n        description:\n          'List documentation URLs for all direct dependencies',\n      },\n    },\n  })\n\ntype CommandResultSingle = {\n  url: string\n  name: string\n}\n\ntype CommandResultMultiple = {\n  url: string\n  name: string\n}[]\n\nexport type CommandResult =\n  | CommandResultSingle\n  | CommandResultMultiple\n\nexport const views = {\n  human: r => {\n    if (Array.isArray(r)) {\n      let msg = 'Multiple package docs found:\\n'\n      msg += r.map(item => `• ${item.name}: ${item.url}`).join('\\n')\n      return msg\n    }\n    return ''\n  },\n  json: r => r,\n} as const satisfies Views<CommandResult>\n\nconst getUrlFromManifest = (\n  manifest: Manifest | NormalizedManifest,\n): string => {\n  const { name, homepage, repository } = manifest\n\n  if (!name) {\n    throw error('No package name found')\n  }\n\n  // Extract repository URL\n  let url: string | undefined\n\n  if (homepage) {\n    url = homepage\n  } else if (repository) {\n    const repoUrl =\n      typeof repository === 'string' ? repository\n      : typeof repository === 'object' && 'url' in repository ?\n        repository.url\n      : /* c8 ignore next */ undefined\n\n    if (repoUrl) {\n      // Try to get hosted git info\n\n      const info = hostedGitInfoFromUrl(repoUrl.replace(/^git\\+/, ''))\n\n      if (info && typeof info.docs === 'function') {\n        url = info.docs()\n      }\n    }\n  }\n\n  // Fallback to npmjs.com package page\n  if (!url) {\n    url = `https://www.npmjs.com/package/${name}`\n  }\n\n  return url\n}\n\nexport const command: CommandFn<CommandResult> = async conf => {\n  const { projectRoot, packageJson } = conf.options\n  const targetOption = conf.get('target')\n\n  // Handle --target query\n  if (targetOption) {\n    const mainManifest = packageJson.maybeRead(projectRoot)\n    if (!mainManifest) {\n      throw error('No package.json found in project root', {\n        path: projectRoot,\n      })\n    }\n\n    const graph = actual.load({\n      ...conf.options,\n      mainManifest,\n      monorepo: conf.options.monorepo,\n      loadManifests: true,\n    })\n\n    const securityArchive =\n      Query.hasSecuritySelectors(targetOption) ?\n        await SecurityArchive.start({\n          nodes: [...graph.nodes.values()],\n        })\n      : undefined\n\n    const hostContexts = await createHostContextsMap(conf)\n    const query = new Query({\n      nodes: new Set(graph.nodes.values()),\n      edges: graph.edges,\n      importers: graph.importers,\n      securityArchive,\n      hostContexts,\n    })\n\n    const { nodes } = await query.search(targetOption, {\n      signal: new AbortController().signal,\n    })\n\n    const results: CommandResultMultiple = []\n    for (const node of nodes) {\n      if (!node.manifest) continue\n      const url = getUrlFromManifest(node.manifest)\n      results.push({\n        url,\n        name: node.name /* c8 ignore next */ ?? '(unknown)',\n      })\n    }\n\n    if (results.length === 0) {\n      throw error('No packages found matching target query', {\n        found: targetOption,\n      })\n    }\n\n    // If single result, open it\n    if (results.length === 1) {\n      const result = results[0]\n      /* c8 ignore next 3 */\n      if (!result) {\n        throw error('Unexpected empty result')\n      }\n      await urlOpen(result.url)\n      return result\n    }\n\n    // Multiple results, return the list\n    return results\n  }\n\n  // read the package spec from a positional argument or local package.json\n  const specArg = conf.positionals[0]\n  const manifest =\n    conf.positionals.length === 0 ? packageJson.read(projectRoot)\n    : specArg ?\n      await new PackageInfoClient(conf.options).manifest(\n        Spec.parseArgs(specArg, conf.options),\n      )\n    : /* c8 ignore next */ packageJson.read(projectRoot)\n\n  const url = getUrlFromManifest(manifest)\n  const { name } = manifest\n  /* c8 ignore start - getUrlFromManifest already validates name */\n  if (!name) {\n    throw error('No package name found')\n  }\n  /* c8 ignore stop */\n  // Open the URL\n  await urlOpen(url)\n\n  return { url, name }\n}\n"]}

package/dist/esm/commands/exec-cache.js

@@ -87,10 +87,14 @@ const install = async (conf, keys, view) => {
             code: 'EUSAGE',
         });
     }
+    const allowScripts = conf.get('allow-scripts') ?
+        String(conf.get('allow-scripts'))
+        : ':not(*)';
     return Promise.all(keys.map(async (key) => {
         const info = await vlx.install(key, {
             ...conf.options,
             query: undefined,
+            allowScripts,
         });
         view?.stdout(info);
         return info.path;
@@ -108,11 +112,15 @@ const ls = async (_conf, args, view) => {
     return results;
 };
 const info = async (conf, keys, view) => {
+    const allowScripts = conf.get('allow-scripts') ?
+        String(conf.get('allow-scripts'))
+        : ':not(*)';
     const results = [];
     for await (const key of keys.length ? keys : vlx.list()) {
         const info = vlx.info(key, {
             ...conf.options,
             query: undefined,
+            allowScripts,
         });
         results.push(info);
         view?.stdout(info);
@@ -120,10 +128,14 @@ const info = async (conf, keys, view) => {
     return results;
 };
 const deleteEntries = async (conf, keys, view) => {
+    const allowScripts = conf.get('allow-scripts') ?
+        String(conf.get('allow-scripts'))
+        : ':not(*)';
     const remover = new RollbackRemove();
     const removed = (await vlx.delete(keys, remover, {
         ...conf.options,
         query: undefined,
+        allowScripts,
     })).map(path => {
         view?.stdout(`- ${basename(path)}`);
         return path;

package/dist/esm/commands/exec-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"exec-cache.js","sourceRoot":"","sources":["../../../src/commands/exec-cache.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport { RollbackRemove } from '@vltpkg/rollback-remove'\nimport type { VlxInfo } from '@vltpkg/vlx'\nimport * as vlx from '@vltpkg/vlx'\nimport { basename } from 'node:path'\nimport type { LoadedConfig } from '../config/index.ts'\nimport type { CommandUsageDefinition } from '../config/usage.ts'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { stdout } from '../output.ts'\nimport type { ViewOptions, Views } from '../view.ts'\nimport { ViewClass } from '../view.ts'\n\nexport type ExecCacheSubcommands =\n  keyof (typeof usageDef)['subcommands']\n\nlet view: ExecCacheView\nexport class ExecCacheView extends ViewClass {\n  constructor(options: ViewOptions, conf: LoadedConfig) {\n    super(options, conf)\n    view = this\n  }\n  stdout(...args: unknown[]) {\n    stdout(...args)\n  }\n}\n\nexport const views: Views<void | string[] | VlxInfo[]> = {\n  human: ExecCacheView,\n}\n\nconst usageDef = {\n  command: 'exec-cache',\n  usage: '<command> [flags]',\n  description: 'Work with vlt exec-cache folders',\n\n  subcommands: {\n    ls: {\n      usage: '',\n      description: `Show previously installed packages used for \\`vlt exec\\`.\n                    Key provided can be either the package name, or the full\n                    key.`,\n    },\n\n    delete: {\n      usage: '[<key>...]',\n      description: `Delete previously installed packages used for\n                    \\`vlt exec\\`. If no keys are provided, then all entries\n                    will be deleted.`,\n    },\n\n    info: {\n      usage: '<key>',\n      description: `Show extended information about a given \\`vlt exec\\`\n                    installation.`,\n    },\n\n    install: {\n      usage: '<spec>...',\n      description: `Install the specified package(s) in the \\`vlt exec\\`\n                    central cache location. Metadata info about each\n                    installation will be printed.`,\n    },\n  },\n\n  examples: {\n    ls: {\n      description: `Show all the keys for the installations in the \\`vlt exec\\`\n                    cache.`,\n    },\n    'delete typescript': {\n      description: `Delete all versions of typescript installed for vlt exec`,\n    },\n    'info typescript-695bf962': {\n      description: `Show extended info about a specific version of typescript`,\n    },\n  },\n} as const satisfies CommandUsageDefinition\n\nexport const usage: CommandUsage = () => commandUsage(usageDef)\n\nexport const command: CommandFn<\n  string[] | VlxInfo[]\n> = async conf => {\n  const [sub, ...args] = conf.positionals\n  switch (sub) {\n    case 'ls':\n      return ls(conf, args, view)\n\n    case 'info':\n      return info(conf, args, view)\n\n    case 'install':\n      return install(conf, args, view)\n\n    case 'delete':\n      return deleteEntries(conf, args, view)\n\n    default: {\n      throw error('Unrecognized exec-cache command', {\n        code: 'EUSAGE',\n        found: sub,\n        validOptions: Object.keys(usageDef.subcommands),\n      })\n    }\n  }\n}\n\nconst install = async (\n  conf: LoadedConfig,\n  keys: string[],\n  view?: ExecCacheView,\n): Promise<string[]> => {\n  if (!keys.length) {\n    throw error('Must supply a package spec to install', {\n      code: 'EUSAGE',\n    })\n  }\n  return Promise.all(\n    keys.map(async key => {\n      const info = await vlx.install(key, {\n        ...conf.options,\n        query: undefined,\n      })\n      view?.stdout(info)\n      return info.path\n    }),\n  )\n}\n\nconst ls = async (\n  _conf: LoadedConfig,\n  args: string[],\n  view?: ExecCacheView,\n): Promise<string[]> => {\n  const results: string[] = []\n  for await (const path of vlx.list()) {\n    const key = basename(path)\n    if (args.length && !args.some(a => key.includes(a))) continue\n    results.push(key)\n    view?.stdout(key)\n  }\n  return results\n}\n\nconst info = async (\n  conf: LoadedConfig,\n  keys: string[],\n  view?: ExecCacheView,\n): Promise<VlxInfo[]> => {\n  const results: VlxInfo[] = []\n  for await (const key of keys.length ? keys : vlx.list()) {\n    const info = vlx.info(key, {\n      ...conf.options,\n      query: undefined,\n    })\n    results.push(info)\n    view?.stdout(info)\n  }\n  return results\n}\n\nconst deleteEntries = async (\n  conf: LoadedConfig,\n  keys: string[],\n  view?: ExecCacheView,\n): Promise<string[]> => {\n  const remover = new RollbackRemove()\n  const removed = (\n    await vlx.delete(keys, remover, {\n      ...conf.options,\n      query: undefined,\n    })\n  ).map(path => {\n    view?.stdout(`- ${basename(path)}`)\n    return path\n  })\n  remover.confirm()\n  return removed\n}\n"]}
+{"version":3,"file":"exec-cache.js","sourceRoot":"","sources":["../../../src/commands/exec-cache.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport { RollbackRemove } from '@vltpkg/rollback-remove'\nimport type { VlxInfo } from '@vltpkg/vlx'\nimport * as vlx from '@vltpkg/vlx'\nimport { basename } from 'node:path'\nimport type { LoadedConfig } from '../config/index.ts'\nimport type { CommandUsageDefinition } from '../config/usage.ts'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { stdout } from '../output.ts'\nimport type { ViewOptions, Views } from '../view.ts'\nimport { ViewClass } from '../view.ts'\n\nexport type ExecCacheSubcommands =\n  keyof (typeof usageDef)['subcommands']\n\nlet view: ExecCacheView\nexport class ExecCacheView extends ViewClass {\n  constructor(options: ViewOptions, conf: LoadedConfig) {\n    super(options, conf)\n    view = this\n  }\n  stdout(...args: unknown[]) {\n    stdout(...args)\n  }\n}\n\nexport const views: Views<void | string[] | VlxInfo[]> = {\n  human: ExecCacheView,\n}\n\nconst usageDef = {\n  command: 'exec-cache',\n  usage: '<command> [flags]',\n  description: 'Work with vlt exec-cache folders',\n\n  subcommands: {\n    ls: {\n      usage: '',\n      description: `Show previously installed packages used for \\`vlt exec\\`.\n                    Key provided can be either the package name, or the full\n                    key.`,\n    },\n\n    delete: {\n      usage: '[<key>...]',\n      description: `Delete previously installed packages used for\n                    \\`vlt exec\\`. If no keys are provided, then all entries\n                    will be deleted.`,\n    },\n\n    info: {\n      usage: '<key>',\n      description: `Show extended information about a given \\`vlt exec\\`\n                    installation.`,\n    },\n\n    install: {\n      usage: '<spec>...',\n      description: `Install the specified package(s) in the \\`vlt exec\\`\n                    central cache location. Metadata info about each\n                    installation will be printed.`,\n    },\n  },\n\n  examples: {\n    ls: {\n      description: `Show all the keys for the installations in the \\`vlt exec\\`\n                    cache.`,\n    },\n    'delete typescript': {\n      description: `Delete all versions of typescript installed for vlt exec`,\n    },\n    'info typescript-695bf962': {\n      description: `Show extended info about a specific version of typescript`,\n    },\n  },\n} as const satisfies CommandUsageDefinition\n\nexport const usage: CommandUsage = () => commandUsage(usageDef)\n\nexport const command: CommandFn<\n  string[] | VlxInfo[]\n> = async conf => {\n  const [sub, ...args] = conf.positionals\n  switch (sub) {\n    case 'ls':\n      return ls(conf, args, view)\n\n    case 'info':\n      return info(conf, args, view)\n\n    case 'install':\n      return install(conf, args, view)\n\n    case 'delete':\n      return deleteEntries(conf, args, view)\n\n    default: {\n      throw error('Unrecognized exec-cache command', {\n        code: 'EUSAGE',\n        found: sub,\n        validOptions: Object.keys(usageDef.subcommands),\n      })\n    }\n  }\n}\n\nconst install = async (\n  conf: LoadedConfig,\n  keys: string[],\n  view?: ExecCacheView,\n): Promise<string[]> => {\n  if (!keys.length) {\n    throw error('Must supply a package spec to install', {\n      code: 'EUSAGE',\n    })\n  }\n  const allowScripts =\n    conf.get('allow-scripts') ?\n      String(conf.get('allow-scripts'))\n    : ':not(*)'\n  return Promise.all(\n    keys.map(async key => {\n      const info = await vlx.install(key, {\n        ...conf.options,\n        query: undefined,\n        allowScripts,\n      })\n      view?.stdout(info)\n      return info.path\n    }),\n  )\n}\n\nconst ls = async (\n  _conf: LoadedConfig,\n  args: string[],\n  view?: ExecCacheView,\n): Promise<string[]> => {\n  const results: string[] = []\n  for await (const path of vlx.list()) {\n    const key = basename(path)\n    if (args.length && !args.some(a => key.includes(a))) continue\n    results.push(key)\n    view?.stdout(key)\n  }\n  return results\n}\n\nconst info = async (\n  conf: LoadedConfig,\n  keys: string[],\n  view?: ExecCacheView,\n): Promise<VlxInfo[]> => {\n  const allowScripts =\n    conf.get('allow-scripts') ?\n      String(conf.get('allow-scripts'))\n    : ':not(*)'\n  const results: VlxInfo[] = []\n  for await (const key of keys.length ? keys : vlx.list()) {\n    const info = vlx.info(key, {\n      ...conf.options,\n      query: undefined,\n      allowScripts,\n    })\n    results.push(info)\n    view?.stdout(info)\n  }\n  return results\n}\n\nconst deleteEntries = async (\n  conf: LoadedConfig,\n  keys: string[],\n  view?: ExecCacheView,\n): Promise<string[]> => {\n  const allowScripts =\n    conf.get('allow-scripts') ?\n      String(conf.get('allow-scripts'))\n    : ':not(*)'\n  const remover = new RollbackRemove()\n  const removed = (\n    await vlx.delete(keys, remover, {\n      ...conf.options,\n      query: undefined,\n      allowScripts,\n    })\n  ).map(path => {\n    view?.stdout(`- ${basename(path)}`)\n    return path\n  })\n  remover.confirm()\n  return removed\n}\n"]}

package/dist/esm/commands/exec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../../src/commands/exec.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAK3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEpD,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,eAAO,MAAM,KAAK,EAAE,YAoDhB,CAAA;AAGJ,eAAO,MAAM,UAAU,SAAU,MAAM,WAC2B,CAAA;AAElE,eAAO,MAAM,QAAQ,EAAE,QAyBtB,CAAA;AAED,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,UAAU,CAazC,CAAA"}
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../../src/commands/exec.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAK3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEpD,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,eAAO,MAAM,KAAK,EAAE,YAoDhB,CAAA;AAGJ,eAAO,MAAM,UAAU,SAAU,MAAM,WAC2B,CAAA;AAElE,eAAO,MAAM,QAAQ,EAAE,QAyBtB,CAAA;AAED,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,UAAU,CAoBzC,CAAA"}

package/dist/esm/commands/exec.js

@@ -68,9 +68,15 @@ Is this ok? (y) `);
     return response;
 };
 export const command = async (conf) => {
+    /* c8 ignore start */
+    const allowScripts = conf.get('allow-scripts') ?
+        String(conf.get('allow-scripts'))
+        : ':not(*)';
+    /* c8 ignore stop */
     const arg0 = await vlx.resolve(conf.positionals, {
         ...conf.options,
         query: undefined,
+        allowScripts,
     }, promptFn);
     if (arg0)
         conf.positionals[0] = arg0;

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

@@ -1 +1 @@
-{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../../src/commands/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAE1C,OAAO,KAAK,GAAG,MAAM,aAAa,CAAA;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,MAAM;IACf,KAAK,EAAE,gCAAgC;IACvC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmCZ;IACD,QAAQ,EAAE;QACR,4BAA4B,EAAE;YAC5B,WAAW,EAAE,0CAA0C;SACxD;QACD,oBAAoB,EAAE;YACpB,WAAW,EAAE,wCAAwC;SACtD;QACD,yBAAyB,EAAE;YACzB,WAAW,EACT,qDAAqD;SACxD;KACF;CACF,CAAC,CAAA;AAEJ,MAAM,IAAI,GAAG,OAAO,EAAE,CAAA;AACtB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAE,CACzC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AAElE,MAAM,CAAC,MAAM,QAAQ,GAAa,KAAK,EACrC,OAAO,EACP,IAAI,EACJ,UAAU,EACV,EAAE;IACF,MAAM,QAAQ,GAAG,MAAM,eAAe,CACpC,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,MAAM,CACf,CAAC,QAAQ,CACR,qBAAqB,eAAe,CAClC,CAAC,eAAe,EAAE,OAAO,EAAE,MAAM,CAAC,EAClC,MAAM,CAAC,OAAO,CAAC,CAChB;QACG,eAAe,CACjB,CAAC,eAAe,EAAE,OAAO,EAAE,MAAM,CAAC,EAClC,UAAU,CACX;QACG,eAAe,CACjB,CAAC,eAAe,EAAE,OAAO,EAAE,MAAM,CAAC,EAClC,UAAU,CAAC,IAAI,CAAC,CACjB;iBACY,CACd,CAAA;IACD,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IACrB,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,OAAO,GAA0B,KAAK,EAAC,IAAI,EAAC,EAAE;IACzD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAC5B,IAAI,CAAC,WAAW,EAChB;QACE,GAAG,IAAI,CAAC,OAAO;QACf,KAAK,EAAE,SAAS;KACjB,EACD,QAAQ,CACT,CAAA;IACD,IAAI,IAAI;QAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IACpC,mCAAmC;IACnC,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;IACnC,OAAO,MAAM,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,GAAG,EAAE,CAAA;AACxD,CAAC,CAAA","sourcesContent":["import { exec, execFG } from '@vltpkg/run'\nimport type { PromptFn } from '@vltpkg/vlx'\nimport * as vlx from '@vltpkg/vlx'\nimport { homedir } from 'node:os'\nimport { createInterface } from 'node:readline/promises'\nimport { commandUsage } from '../config/usage.ts'\nimport type { ExecResult } from '../exec-command.ts'\nimport { ExecCommand } from '../exec-command.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { styleTextStdout } from '../output.ts'\nexport { views } from '../exec-command.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'exec',\n    usage: '[--package=<pkg>] [command...]',\n    description: `Run a command defined by a package, installing it\n                  if necessary.\n\n                  If the package specifier is provided explicitly via the\n                  \\`--package\\` config, then that is what will be used. If\n                  a satisfying instance of the named package exists in the\n                  local \\`node_mnodules\\` folder, then that will be used.\n\n                  If \\`--package\\` is not set, then vlt will attempt to infer\n                  the package to be installed if necessary, in the following\n                  manner:\n\n                  - If the first argument is an executable found in the\n                    \\`node_modules/.bin\\` folder (ie, provided by an\n                    installed direct dependency), then that will be used.\n                    The search stops, and nothing will be installed.\n                  - Otherwise, vlt attempts to resolve the first argument\n                    as if it was a \\`--package\\` option, and then swap it\n                    out with the \"default\" executable provided by that\n                    package.\n\n                  The \"default\" executable provided by a package is:\n\n                  - If the package provides a single executable string in the\n                    \\`bin\\` field, then that is the executable to use.\n                  - Otherwise, if there is a \\`bin\\` with the same name\n                    as the package (or just the portion after the \\`/\\` in\n                    the case of scoped packages), then that will be used.\n\n                  If the appropriate excutable cannot be determined, then\n                  an error will be raised.\n\n                  At no point will \\`vlt exec\\` change the locally installed\n                  dependencies. Any installs it performs is done in vlt's XDG\n                  data directory.\n    `,\n    examples: {\n      '--package typescript@5 tsc': {\n        description: 'Run tsc provided by typescript version 5',\n      },\n      'eslint src/file.js': {\n        description: 'Run the default bin provided by eslint',\n      },\n      'eslint@9.24 src/file.js': {\n        description:\n          'Run the default bin provided by eslint version 9.24',\n      },\n    },\n  })\n\nconst HOME = homedir()\nexport const prettyPath = (path: string) =>\n  path.startsWith(HOME) ? `~${path.substring(HOME.length)}` : path\n\nexport const promptFn: PromptFn = async (\n  pkgSpec,\n  path,\n  resolution,\n) => {\n  const response = await createInterface(\n    process.stdin,\n    process.stdout,\n  ).question(\n    `About to install: ${styleTextStdout(\n      ['bgWhiteBright', 'black', 'bold'],\n      String(pkgSpec),\n    )}\nfrom: ${styleTextStdout(\n      ['bgWhiteBright', 'black', 'bold'],\n      resolution,\n    )}\ninto: ${styleTextStdout(\n      ['bgWhiteBright', 'black', 'bold'],\n      prettyPath(path),\n    )}\nIs this ok? (y) `,\n  )\n  process.stdin.pause()\n  return response\n}\n\nexport const command: CommandFn<ExecResult> = async conf => {\n  const arg0 = await vlx.resolve(\n    conf.positionals,\n    {\n      ...conf.options,\n      query: undefined,\n    },\n    promptFn,\n  )\n  if (arg0) conf.positionals[0] = arg0\n  // now we have arg0! let's gooooo!!\n  delete conf.options['script-shell']\n  return await new ExecCommand(conf, exec, execFG).run()\n}\n"]}
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../../src/commands/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAE1C,OAAO,KAAK,GAAG,MAAM,aAAa,CAAA;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,MAAM;IACf,KAAK,EAAE,gCAAgC;IACvC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmCZ;IACD,QAAQ,EAAE;QACR,4BAA4B,EAAE;YAC5B,WAAW,EAAE,0CAA0C;SACxD;QACD,oBAAoB,EAAE;YACpB,WAAW,EAAE,wCAAwC;SACtD;QACD,yBAAyB,EAAE;YACzB,WAAW,EACT,qDAAqD;SACxD;KACF;CACF,CAAC,CAAA;AAEJ,MAAM,IAAI,GAAG,OAAO,EAAE,CAAA;AACtB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAE,CACzC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AAElE,MAAM,CAAC,MAAM,QAAQ,GAAa,KAAK,EACrC,OAAO,EACP,IAAI,EACJ,UAAU,EACV,EAAE;IACF,MAAM,QAAQ,GAAG,MAAM,eAAe,CACpC,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,MAAM,CACf,CAAC,QAAQ,CACR,qBAAqB,eAAe,CAClC,CAAC,eAAe,EAAE,OAAO,EAAE,MAAM,CAAC,EAClC,MAAM,CAAC,OAAO,CAAC,CAChB;QACG,eAAe,CACjB,CAAC,eAAe,EAAE,OAAO,EAAE,MAAM,CAAC,EAClC,UAAU,CACX;QACG,eAAe,CACjB,CAAC,eAAe,EAAE,OAAO,EAAE,MAAM,CAAC,EAClC,UAAU,CAAC,IAAI,CAAC,CACjB;iBACY,CACd,CAAA;IACD,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IACrB,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,OAAO,GAA0B,KAAK,EAAC,IAAI,EAAC,EAAE;IACzD,qBAAqB;IACrB,MAAM,YAAY,GAChB,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC,CAAC,SAAS,CAAA;IACb,oBAAoB;IACpB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAC5B,IAAI,CAAC,WAAW,EAChB;QACE,GAAG,IAAI,CAAC,OAAO;QACf,KAAK,EAAE,SAAS;QAChB,YAAY;KACb,EACD,QAAQ,CACT,CAAA;IACD,IAAI,IAAI;QAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IACpC,mCAAmC;IACnC,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;IACnC,OAAO,MAAM,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,GAAG,EAAE,CAAA;AACxD,CAAC,CAAA","sourcesContent":["import { exec, execFG } from '@vltpkg/run'\nimport type { PromptFn } from '@vltpkg/vlx'\nimport * as vlx from '@vltpkg/vlx'\nimport { homedir } from 'node:os'\nimport { createInterface } from 'node:readline/promises'\nimport { commandUsage } from '../config/usage.ts'\nimport type { ExecResult } from '../exec-command.ts'\nimport { ExecCommand } from '../exec-command.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { styleTextStdout } from '../output.ts'\nexport { views } from '../exec-command.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'exec',\n    usage: '[--package=<pkg>] [command...]',\n    description: `Run a command defined by a package, installing it\n                  if necessary.\n\n                  If the package specifier is provided explicitly via the\n                  \\`--package\\` config, then that is what will be used. If\n                  a satisfying instance of the named package exists in the\n                  local \\`node_mnodules\\` folder, then that will be used.\n\n                  If \\`--package\\` is not set, then vlt will attempt to infer\n                  the package to be installed if necessary, in the following\n                  manner:\n\n                  - If the first argument is an executable found in the\n                    \\`node_modules/.bin\\` folder (ie, provided by an\n                    installed direct dependency), then that will be used.\n                    The search stops, and nothing will be installed.\n                  - Otherwise, vlt attempts to resolve the first argument\n                    as if it was a \\`--package\\` option, and then swap it\n                    out with the \"default\" executable provided by that\n                    package.\n\n                  The \"default\" executable provided by a package is:\n\n                  - If the package provides a single executable string in the\n                    \\`bin\\` field, then that is the executable to use.\n                  - Otherwise, if there is a \\`bin\\` with the same name\n                    as the package (or just the portion after the \\`/\\` in\n                    the case of scoped packages), then that will be used.\n\n                  If the appropriate excutable cannot be determined, then\n                  an error will be raised.\n\n                  At no point will \\`vlt exec\\` change the locally installed\n                  dependencies. Any installs it performs is done in vlt's XDG\n                  data directory.\n    `,\n    examples: {\n      '--package typescript@5 tsc': {\n        description: 'Run tsc provided by typescript version 5',\n      },\n      'eslint src/file.js': {\n        description: 'Run the default bin provided by eslint',\n      },\n      'eslint@9.24 src/file.js': {\n        description:\n          'Run the default bin provided by eslint version 9.24',\n      },\n    },\n  })\n\nconst HOME = homedir()\nexport const prettyPath = (path: string) =>\n  path.startsWith(HOME) ? `~${path.substring(HOME.length)}` : path\n\nexport const promptFn: PromptFn = async (\n  pkgSpec,\n  path,\n  resolution,\n) => {\n  const response = await createInterface(\n    process.stdin,\n    process.stdout,\n  ).question(\n    `About to install: ${styleTextStdout(\n      ['bgWhiteBright', 'black', 'bold'],\n      String(pkgSpec),\n    )}\nfrom: ${styleTextStdout(\n      ['bgWhiteBright', 'black', 'bold'],\n      resolution,\n    )}\ninto: ${styleTextStdout(\n      ['bgWhiteBright', 'black', 'bold'],\n      prettyPath(path),\n    )}\nIs this ok? (y) `,\n  )\n  process.stdin.pause()\n  return response\n}\n\nexport const command: CommandFn<ExecResult> = async conf => {\n  /* c8 ignore start */\n  const allowScripts =\n    conf.get('allow-scripts') ?\n      String(conf.get('allow-scripts'))\n    : ':not(*)'\n  /* c8 ignore stop */\n  const arg0 = await vlx.resolve(\n    conf.positionals,\n    {\n      ...conf.options,\n      query: undefined,\n      allowScripts,\n    },\n    promptFn,\n  )\n  if (arg0) conf.positionals[0] = arg0\n  // now we have arg0! let's gooooo!!\n  delete conf.options['script-shell']\n  return await new ExecCommand(conf, exec, execFG).run()\n}\n"]}

package/dist/esm/commands/install/reporter.d.ts

@@ -1,8 +1,9 @@
 import { ViewClass } from '../../view.ts';
+import type { InstallResult } from '../install.ts';
 export declare class InstallReporter extends ViewClass {
     #private;
     start(): void;
-    done(_result: unknown, { time }: {
+    done(_result: InstallResult, { time }: {
         time: number;
     }): Promise<undefined>;
     error(err: unknown): void;

package/dist/esm/commands/install/reporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../../../src/commands/install/reporter.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAkFzC,qBAAa,eAAgB,SAAQ,SAAS;;IAG5C,KAAK;IAIC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAKvD,KAAK,CAAC,GAAG,EAAE,OAAO;CAGnB"}
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../../../src/commands/install/reporter.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAEzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAqGlD,qBAAa,eAAgB,SAAQ,SAAS;;IAG5C,KAAK;IAIC,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAe7D,KAAK,CAAC,GAAG,EAAE,OAAO;CAGnB"}

package/dist/esm/commands/install/reporter.js

@@ -4,6 +4,11 @@ import Spinner from 'ink-spinner';
 import { createElement as $, Fragment, useEffect, useState, } from 'react';
 import { ViewClass } from "../../view.js";
 import { asError } from '@vltpkg/types';
+const labels = {
+    build: 'resolving dependencies',
+    actual: '',
+    reify: 'extracting files',
+};
 const GraphStep = ({ text, step }) => {
     if (step.state === 'waiting') {
         return $(Text, { color: 'gray' }, text);
@@ -15,6 +20,7 @@ const GraphStep = ({ text, step }) => {
 };
 const App = ({ trailer }) => {
     const [requests, setRequests] = useState(0);
+    const [cacheHit, setCacheHit] = useState(0);
     const [steps, setSteps] = useState({
         build: {
             state: 'waiting',
@@ -27,9 +33,16 @@ const App = ({ trailer }) => {
         },
     });
     useEffect(() => {
-        const update = () => setRequests(p => p + 1);
-        emitter.on('request', update);
-        return () => emitter.off('request', update);
+        const updateRequests = ({ state }) => {
+            if (state === 'start') {
+                setRequests(p => p + 1);
+            }
+            else if (state === 'cache' || state === 'stale') {
+                setCacheHit(p => p + 1);
+            }
+        };
+        emitter.on('request', updateRequests);
+        return () => emitter.off('request', updateRequests);
     }, []);
     useEffect(() => {
         const update = ({ step, state }) => {
@@ -46,8 +59,15 @@ const App = ({ trailer }) => {
     }, []);
     return $(Fragment, null, $(Box, null, ...['build', 'actual', 'reify'].map((step, idx, list) => {
         const separator = idx === list.length - 1 ? '' : ' > ';
-        return $(Text, { key: step }, $(GraphStep, { text: step, step: steps[step] }), $(Text, { color: 'gray' }, separator));
-    })), requests > 0 ? $(Text, null, `${requests} requests`) : null, trailer ? $(Text, null, trailer) : null);
+        const label = labels[step];
+        if (!label)
+            return null;
+        return $(Text, { key: step }, $(GraphStep, { text: label, step: steps[step] }), $(Text, { color: 'gray' }, separator));
+    })), cacheHit > 0 ?
+        $(Text, null, `${cacheHit} cache hit${cacheHit > 1 ? 's' : ''}`)
+        : null, requests > 0 ?
+        $(Text, null, `${requests} request${requests > 1 ? 's' : ''}`)
+        : null, trailer ? $(Text, null, trailer) : null);
 };
 export class InstallReporter extends ViewClass {
     #instance = null;
@@ -55,7 +75,16 @@ export class InstallReporter extends ViewClass {
         this.#instance = render($(App));
     }
     async done(_result, { time }) {
-        this.#instance?.rerender($(App, { trailer: `Done in ${time}ms` }));
+        let out = `Done in ${time}ms`;
+        // prints a very complete message explaining users the next steps
+        // in case there are packages to be built
+        if (_result.buildQueue?.length) {
+            out += `\n\n📦 ${_result.buildQueue.length} packages have install scripts defined & were not fully built\n`;
+            out += '🔎 Run `vlt query :scripts` to list them\n';
+            out +=
+                '🔨 Run `vlt build` to run all required scripts to build installed packages.\n';
+        }
+        this.#instance?.rerender($(App, { trailer: out }));
         return undefined;
     }
     error(err) {

package/dist/esm/commands/install/reporter.js.map

@@ -1 +1 @@
-{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../../../src/commands/install/reporter.ts"],"names":[],"mappings":"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","sourcesContent":["import { emitter } from '@vltpkg/output'\nimport type { Events } from '@vltpkg/output'\nimport { Box, render, Text } from 'ink'\nimport type { Instance } from 'ink'\nimport Spinner from 'ink-spinner'\nimport {\n  createElement as $,\n  Fragment,\n  useEffect,\n  useState,\n} from 'react'\nimport { ViewClass } from '../../view.ts'\nimport { asError } from '@vltpkg/types'\n\ntype Step = {\n  state: 'waiting' | 'in_progress' | 'completed'\n}\n\nconst GraphStep = ({ text, step }: { text: string; step: Step }) => {\n  if (step.state === 'waiting') {\n    return $(Text, { color: 'gray' }, text)\n  }\n  if (step.state === 'in_progress') {\n    return $(\n      Text,\n      { color: 'yellow' },\n      text + ' ',\n      $(Spinner, { type: 'dots' }),\n    )\n  }\n  return $(Text, { color: 'green' }, text, ' ✓')\n}\n\nconst App = ({ trailer }: { trailer?: string }) => {\n  const [requests, setRequests] = useState(0)\n\n  const [steps, setSteps] = useState<\n    Record<Events['graphStep']['step'], Step>\n  >({\n    build: {\n      state: 'waiting',\n    },\n    actual: {\n      state: 'waiting',\n    },\n    reify: {\n      state: 'waiting',\n    },\n  })\n\n  useEffect(() => {\n    const update = () => setRequests(p => p + 1)\n    emitter.on('request', update)\n    return () => emitter.off('request', update)\n  }, [])\n\n  useEffect(() => {\n    const update = ({ step, state }: Events['graphStep']) => {\n      setSteps(p => ({\n        ...p,\n        [step]: {\n          ...p[step],\n          state: state === 'start' ? 'in_progress' : 'completed',\n        },\n      }))\n    }\n    emitter.on('graphStep', update)\n    return () => emitter.off('graphStep', update)\n  }, [])\n\n  return $(\n    Fragment,\n    null,\n    $(\n      Box,\n      null,\n      ...(['build', 'actual', 'reify'] as const).map(\n        (step, idx, list) => {\n          const separator = idx === list.length - 1 ? '' : ' > '\n          return $(\n            Text,\n            { key: step },\n            $(GraphStep, { text: step, step: steps[step] }),\n            $(Text, { color: 'gray' }, separator),\n          )\n        },\n      ),\n    ),\n    requests > 0 ? $(Text, null, `${requests} requests`) : null,\n    trailer ? $(Text, null, trailer) : null,\n  )\n}\n\nexport class InstallReporter extends ViewClass {\n  #instance: Instance | null = null\n\n  start() {\n    this.#instance = render($(App))\n  }\n\n  async done(_result: unknown, { time }: { time: number }) {\n    this.#instance?.rerender($(App, { trailer: `Done in ${time}ms` }))\n    return undefined\n  }\n\n  error(err: unknown) {\n    this.#instance?.unmount(asError(err))\n  }\n}\n"]}
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../../../src/commands/install/reporter.ts"],"names":[],"mappings":"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","sourcesContent":["import { emitter } from '@vltpkg/output'\nimport type { Events } from '@vltpkg/output'\nimport { Box, render, Text } from 'ink'\nimport type { Instance } from 'ink'\nimport Spinner from 'ink-spinner'\nimport {\n  createElement as $,\n  Fragment,\n  useEffect,\n  useState,\n} from 'react'\nimport { ViewClass } from '../../view.ts'\nimport { asError } from '@vltpkg/types'\nimport type { InstallResult } from '../install.ts'\n\ntype Step = {\n  state: 'waiting' | 'in_progress' | 'completed'\n}\n\nconst labels: Record<Events['graphStep']['step'], string> = {\n  build: 'resolving dependencies',\n  actual: '',\n  reify: 'extracting files',\n}\n\nconst GraphStep = ({ text, step }: { text: string; step: Step }) => {\n  if (step.state === 'waiting') {\n    return $(Text, { color: 'gray' }, text)\n  }\n  if (step.state === 'in_progress') {\n    return $(\n      Text,\n      { color: 'yellow' },\n      text + ' ',\n      $(Spinner, { type: 'dots' }),\n    )\n  }\n  return $(Text, { color: 'green' }, text, ' ✓')\n}\n\nconst App = ({ trailer }: { trailer?: string }) => {\n  const [requests, setRequests] = useState(0)\n  const [cacheHit, setCacheHit] = useState(0)\n\n  const [steps, setSteps] = useState<\n    Record<Events['graphStep']['step'], Step>\n  >({\n    build: {\n      state: 'waiting',\n    },\n    actual: {\n      state: 'waiting',\n    },\n    reify: {\n      state: 'waiting',\n    },\n  })\n\n  useEffect(() => {\n    const updateRequests = ({ state }: Events['request']) => {\n      if (state === 'start') {\n        setRequests(p => p + 1)\n      } else if (state === 'cache' || state === 'stale') {\n        setCacheHit(p => p + 1)\n      }\n    }\n    emitter.on('request', updateRequests)\n    return () => emitter.off('request', updateRequests)\n  }, [])\n\n  useEffect(() => {\n    const update = ({ step, state }: Events['graphStep']) => {\n      setSteps(p => ({\n        ...p,\n        [step]: {\n          ...p[step],\n          state: state === 'start' ? 'in_progress' : 'completed',\n        },\n      }))\n    }\n    emitter.on('graphStep', update)\n    return () => emitter.off('graphStep', update)\n  }, [])\n\n  return $(\n    Fragment,\n    null,\n    $(\n      Box,\n      null,\n      ...(['build', 'actual', 'reify'] as const).map(\n        (step, idx, list) => {\n          const separator = idx === list.length - 1 ? '' : ' > '\n          const label = labels[step]\n          if (!label) return null\n          return $(\n            Text,\n            { key: step },\n            $(GraphStep, { text: label, step: steps[step] }),\n            $(Text, { color: 'gray' }, separator),\n          )\n        },\n      ),\n    ),\n    cacheHit > 0 ?\n      $(Text, null, `${cacheHit} cache hit${cacheHit > 1 ? 's' : ''}`)\n    : null,\n    requests > 0 ?\n      $(Text, null, `${requests} request${requests > 1 ? 's' : ''}`)\n    : null,\n    trailer ? $(Text, null, trailer) : null,\n  )\n}\n\nexport class InstallReporter extends ViewClass {\n  #instance: Instance | null = null\n\n  start() {\n    this.#instance = render($(App))\n  }\n\n  async done(_result: InstallResult, { time }: { time: number }) {\n    let out = `Done in ${time}ms`\n\n    // prints a very complete message explaining users the next steps\n    // in case there are packages to be built\n    if (_result.buildQueue?.length) {\n      out += `\\n\\n📦 ${_result.buildQueue.length} packages have install scripts defined & were not fully built\\n`\n      out += '🔎 Run `vlt query :scripts` to list them\\n'\n      out +=\n        '🔨 Run `vlt build` to run all required scripts to build installed packages.\\n'\n    }\n    this.#instance?.rerender($(App, { trailer: out }))\n    return undefined\n  }\n\n  error(err: unknown) {\n    this.#instance?.unmount(asError(err))\n  }\n}\n"]}

package/dist/esm/commands/install.d.ts

@@ -1,10 +1,28 @@
+import { InstallReporter } from './install/reporter.ts';
+import type { DepID } from '@vltpkg/dep-id';
 import type { Graph } from '@vltpkg/graph';
 import type { CommandFn, CommandUsage } from '../index.ts';
-import { InstallReporter } from './install/reporter.ts';
+/**
+ * The resulting object of an install operation. To be used by the view impl.
+ */
+export type InstallResult = {
+    /**
+     * A queue of package IDs that need to be built after the install is complete.
+     */
+    buildQueue?: DepID[];
+    /**
+     * The resulting graph structure at the end of an install.
+     */
+    graph: Graph;
+};
 export declare const usage: CommandUsage;
 export declare const views: {
-    readonly json: (g: Graph) => import("@vltpkg/graph").LockfileData;
+    readonly json: (i: InstallResult) => {
+        graph: import("@vltpkg/graph").LockfileData;
+        buildQueue?: DepID[] | undefined;
+        message?: string | undefined;
+    };
     readonly human: typeof InstallReporter;
 };
-export declare const command: CommandFn<Graph>;
+export declare const command: CommandFn<InstallResult>;
 //# sourceMappingURL=install.d.ts.map

package/dist/esm/commands/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/commands/install.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,eAAO,MAAM,KAAK,EAAE,YAMhB,CAAA;AAEJ,eAAO,MAAM,KAAK;;;CAGe,CAAA;AAEjC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,KAAK,CAcpC,CAAA"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/commands/install.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1D;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,UAAU,CAAC,EAAE,KAAK,EAAE,CAAA;IACpB;;OAEG;IACH,KAAK,EAAE,KAAK,CAAA;CACb,CAAA;AAED,eAAO,MAAM,KAAK,EAAE,YAMhB,CAAA;AAEJ,eAAO,MAAM,KAAK;;;;;;;CAWuB,CAAA;AAEzC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,aAAa,CAyB5C,CAAA"}

package/dist/esm/commands/install.js

@@ -9,19 +9,37 @@ export const usage = () => commandUsage({
                   vlt-lock.json appropriately.`,
 });
 export const views = {
-    json: g => g.toJSON(),
+    json: i => ({
+        ...(i.buildQueue?.length ?
+            {
+                buildQueue: i.buildQueue,
+                message: `${i.buildQueue.length} packages that will need to be built, run "vlt build" to complete the install.`,
+            }
+            : null),
+        graph: i.graph.toJSON(),
+    }),
     human: InstallReporter,
 };
 export const command = async (conf) => {
+    // TODO: we should probably throw an error if the user
+    // tries to install using either view=mermaid or view=gui
     const monorepo = conf.options.monorepo;
     const { add } = parseAddArgs(conf, monorepo);
     const frozenLockfile = conf.options['frozen-lockfile'];
     const expectLockfile = conf.options['expect-lockfile'];
-    const { graph } = await install({
+    const lockfileOnly = conf.options['lockfile-only'];
+    /* c8 ignore start */
+    const allowScripts = conf.get('allow-scripts') ?
+        String(conf.get('allow-scripts'))
+        : ':not(*)';
+    /* c8 ignore stop */
+    const { buildQueue, graph } = await install({
         ...conf.options,
         frozenLockfile,
         expectLockfile,
+        allowScripts,
+        lockfileOnly,
     }, add);
-    return graph;
+    return { buildQueue, graph };
 };
 //# sourceMappingURL=install.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/commands/install.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE;+CAC8B;CAC5C,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE;IACrB,KAAK,EAAE,eAAe;CACS,CAAA;AAEjC,MAAM,CAAC,MAAM,OAAO,GAAqB,KAAK,EAAC,IAAI,EAAC,EAAE;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAA;IACtC,MAAM,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC5C,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACtD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACtD,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAC7B;QACE,GAAG,IAAI,CAAC,OAAO;QACf,cAAc;QACd,cAAc;KACf,EACD,GAAG,CACJ,CAAA;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA","sourcesContent":["import type { Graph } from '@vltpkg/graph'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { install } from '@vltpkg/graph'\nimport { parseAddArgs } from '../parse-add-remove-args.ts'\nimport type { Views } from '../view.ts'\nimport { InstallReporter } from './install/reporter.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'install',\n    usage: '[packages ...]',\n    description: `Install the specified packages, updating package.json and\n                  vlt-lock.json appropriately.`,\n  })\n\nexport const views = {\n  json: g => g.toJSON(),\n  human: InstallReporter,\n} as const satisfies Views<Graph>\n\nexport const command: CommandFn<Graph> = async conf => {\n  const monorepo = conf.options.monorepo\n  const { add } = parseAddArgs(conf, monorepo)\n  const frozenLockfile = conf.options['frozen-lockfile']\n  const expectLockfile = conf.options['expect-lockfile']\n  const { graph } = await install(\n    {\n      ...conf.options,\n      frozenLockfile,\n      expectLockfile,\n    },\n    add,\n  )\n  return graph\n}\n"]}
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/commands/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAoBvD,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE;+CAC8B;CAC5C,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACV,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACxB;gBACE,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,OAAO,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,gFAAgF;aAChH;YACH,CAAC,CAAC,IAAI,CAAC;QACP,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE;KACxB,CAAC;IACF,KAAK,EAAE,eAAe;CACiB,CAAA;AAEzC,MAAM,CAAC,MAAM,OAAO,GAA6B,KAAK,EAAC,IAAI,EAAC,EAAE;IAC5D,sDAAsD;IACtD,yDAAyD;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAA;IACtC,MAAM,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC5C,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACtD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACtD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAA;IAClD,qBAAqB;IACrB,MAAM,YAAY,GAChB,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC,CAAC,SAAS,CAAA;IACb,oBAAoB;IACpB,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CACzC;QACE,GAAG,IAAI,CAAC,OAAO;QACf,cAAc;QACd,cAAc;QACd,YAAY;QACZ,YAAY;KACb,EACD,GAAG,CACJ,CAAA;IACD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;AAC9B,CAAC,CAAA","sourcesContent":["import { commandUsage } from '../config/usage.ts'\nimport { install } from '@vltpkg/graph'\nimport { parseAddArgs } from '../parse-add-remove-args.ts'\nimport { InstallReporter } from './install/reporter.ts'\nimport type { DepID } from '@vltpkg/dep-id'\nimport type { Graph } from '@vltpkg/graph'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport type { Views } from '../view.ts'\n\n/**\n * The resulting object of an install operation. To be used by the view impl.\n */\nexport type InstallResult = {\n  /**\n   * A queue of package IDs that need to be built after the install is complete.\n   */\n  buildQueue?: DepID[]\n  /**\n   * The resulting graph structure at the end of an install.\n   */\n  graph: Graph\n}\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'install',\n    usage: '[packages ...]',\n    description: `Install the specified packages, updating package.json and\n                  vlt-lock.json appropriately.`,\n  })\n\nexport const views = {\n  json: i => ({\n    ...(i.buildQueue?.length ?\n      {\n        buildQueue: i.buildQueue,\n        message: `${i.buildQueue.length} packages that will need to be built, run \"vlt build\" to complete the install.`,\n      }\n    : null),\n    graph: i.graph.toJSON(),\n  }),\n  human: InstallReporter,\n} as const satisfies Views<InstallResult>\n\nexport const command: CommandFn<InstallResult> = async conf => {\n  // TODO: we should probably throw an error if the user\n  // tries to install using either view=mermaid or view=gui\n  const monorepo = conf.options.monorepo\n  const { add } = parseAddArgs(conf, monorepo)\n  const frozenLockfile = conf.options['frozen-lockfile']\n  const expectLockfile = conf.options['expect-lockfile']\n  const lockfileOnly = conf.options['lockfile-only']\n  /* c8 ignore start */\n  const allowScripts =\n    conf.get('allow-scripts') ?\n      String(conf.get('allow-scripts'))\n    : ':not(*)'\n  /* c8 ignore stop */\n  const { buildQueue, graph } = await install(\n    {\n      ...conf.options,\n      frozenLockfile,\n      expectLockfile,\n      allowScripts,\n      lockfileOnly,\n    },\n    add,\n  )\n  return { buildQueue, graph }\n}\n"]}

package/dist/esm/commands/serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../src/commands/serve.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1D,eAAO,MAAM,KAAK,EAAE,YAyBhB,CAAA;AAEJ,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,eAAO,MAAM,KAAK;6BACA,WAAW;4BAcZ,WAAW;CACW,CAAA;AAEvC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,WAAW,CAgE1C,CAAA"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../src/commands/serve.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1D,eAAO,MAAM,KAAK,EAAE,YAyBhB,CAAA;AAEJ,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,eAAO,MAAM,KAAK;6BACA,WAAW;4BAcZ,WAAW;CACW,CAAA;AAEvC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,WAAW,CAuE1C,CAAA"}

package/dist/esm/commands/serve.js

@@ -61,9 +61,15 @@ export const command = async (conf) => {
         DAEMON_URL: `http://localhost:${actualGuiPort}`,
     };
     // runs the exec command internally
+    /* c8 ignore start */
+    const allowScripts = conf.get('allow-scripts') ?
+        String(conf.get('allow-scripts'))
+        : ':not(*)';
+    /* c8 ignore stop */
     const arg0 = await vlx.resolve(['@vltpkg/vsr'], {
         ...conf.options,
         query: undefined,
+        allowScripts,
     }, async () => 'y');
     if (arg0) {
         conf.positionals[0] = arg0;

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

@@ -1 +1 @@
-{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../../src/commands/serve.ts"],"names":[],"mappings":"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","sourcesContent":["import { onExit } from 'signal-exit'\nimport { error } from '@vltpkg/error-cause'\nimport { exec, execFG } from '@vltpkg/run'\nimport * as vlx from '@vltpkg/vlx'\nimport { ExecCommand } from '../exec-command.ts'\nimport { commandUsage } from '../config/usage.ts'\nimport { stdout, styleTextStdout } from '../output.ts'\nimport { startGUI } from '../start-gui.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport type { LoadedConfig } from '../config/index.ts'\nimport type { Views } from '../view.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'serve',\n    usage: '',\n    description: `Start a local development server that runs both the browser-based\n                  UI server and the VSR (vlt serverless registry) registry instance.\n\n                  The UI server will start first on port 8000 (or the next\n                  available port), and then the VSR registry will start on\n                  port 1337.\n\n                  This allows you to develop and test the full vlt ecosystem\n                  locally, including package publishing and installation from\n                  your local registry.`,\n    options: {\n      port: {\n        value: '<number>',\n        description:\n          'Port for the broser-based UI server (default: 8000)',\n      },\n      'registry-port': {\n        value: '<number>',\n        description: 'Port for the VSR registry (default: 1337)',\n      },\n    },\n  })\n\nexport type ServeResult = {\n  guiPort: number\n  registryPort: number\n  uiURL: string\n  registryURL: string\n}\n\nexport const views = {\n  human: (result: ServeResult) => {\n    stdout('')\n    stdout(\n      styleTextStdout(\n        ['bgWhiteBright', 'black', 'bold'],\n        ' vlt serve running ',\n      ),\n    )\n    stdout('')\n    stdout(`UI Server:       ${result.uiURL}`)\n    stdout(`VSR Registry:    ${result.registryURL}`)\n    stdout('')\n    stdout('Press Ctrl+C to stop both servers')\n  },\n  json: (result: ServeResult) => result,\n} as const satisfies Views<ServeResult>\n\nexport const command: CommandFn<ServeResult> = async (\n  conf: LoadedConfig,\n) => {\n  const registryPort = Number(conf.get('registry-port') ?? 1337)\n\n  // Start the GUI server first\n  stdout('Starting UI server...')\n  const server = await startGUI(conf, '/')\n  const actualGuiPort = server.port\n\n  if (!actualGuiPort) {\n    throw error('missing ui server port')\n  }\n\n  // Start the VSR registry with the GUI server port\n  stdout('Starting VSR registry...')\n\n  // Prepare environment for VSR registry\n  const registryEnv = {\n    ARG_DAEMON: 'true',\n    DAEMON_START_SERVER: 'false',\n    DAEMON_PORT: String(actualGuiPort),\n    DAEMON_URL: `http://localhost:${actualGuiPort}`,\n  }\n\n  // runs the exec command internally\n  const arg0 = await vlx.resolve(\n    ['@vltpkg/vsr'],\n    {\n      ...conf.options,\n      query: undefined,\n    },\n    async () => 'y',\n  )\n  if (arg0) {\n    conf.positionals[0] = arg0\n  }\n  delete conf.options['script-shell']\n  const ex = new ExecCommand(conf, exec, execFG)\n  ex.env = registryEnv\n  await ex.run()\n\n  // Handle process termination\n  /* c8 ignore start */\n  const cleanup = () => {\n    stdout('\\nShutting down servers...')\n    try {\n      void server.close()\n      stdout('UI server stopped')\n    } catch {}\n  }\n  onExit(cleanup)\n  /* c8 ignore stop */\n\n  // Return the server information\n  const result: ServeResult = {\n    guiPort: actualGuiPort,\n    registryPort,\n    uiURL: `http://localhost:${actualGuiPort}`,\n    registryURL: `http://localhost:${registryPort}`,\n  }\n\n  // This return will never be reached due to the infinite promise above\n  return result\n}\n"]}
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../../src/commands/serve.ts"],"names":[],"mappings":"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","sourcesContent":["import { onExit } from 'signal-exit'\nimport { error } from '@vltpkg/error-cause'\nimport { exec, execFG } from '@vltpkg/run'\nimport * as vlx from '@vltpkg/vlx'\nimport { ExecCommand } from '../exec-command.ts'\nimport { commandUsage } from '../config/usage.ts'\nimport { stdout, styleTextStdout } from '../output.ts'\nimport { startGUI } from '../start-gui.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport type { LoadedConfig } from '../config/index.ts'\nimport type { Views } from '../view.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'serve',\n    usage: '',\n    description: `Start a local development server that runs both the browser-based\n                  UI server and the VSR (vlt serverless registry) registry instance.\n\n                  The UI server will start first on port 8000 (or the next\n                  available port), and then the VSR registry will start on\n                  port 1337.\n\n                  This allows you to develop and test the full vlt ecosystem\n                  locally, including package publishing and installation from\n                  your local registry.`,\n    options: {\n      port: {\n        value: '<number>',\n        description:\n          'Port for the broser-based UI server (default: 8000)',\n      },\n      'registry-port': {\n        value: '<number>',\n        description: 'Port for the VSR registry (default: 1337)',\n      },\n    },\n  })\n\nexport type ServeResult = {\n  guiPort: number\n  registryPort: number\n  uiURL: string\n  registryURL: string\n}\n\nexport const views = {\n  human: (result: ServeResult) => {\n    stdout('')\n    stdout(\n      styleTextStdout(\n        ['bgWhiteBright', 'black', 'bold'],\n        ' vlt serve running ',\n      ),\n    )\n    stdout('')\n    stdout(`UI Server:       ${result.uiURL}`)\n    stdout(`VSR Registry:    ${result.registryURL}`)\n    stdout('')\n    stdout('Press Ctrl+C to stop both servers')\n  },\n  json: (result: ServeResult) => result,\n} as const satisfies Views<ServeResult>\n\nexport const command: CommandFn<ServeResult> = async (\n  conf: LoadedConfig,\n) => {\n  const registryPort = Number(conf.get('registry-port') ?? 1337)\n\n  // Start the GUI server first\n  stdout('Starting UI server...')\n  const server = await startGUI(conf, '/')\n  const actualGuiPort = server.port\n\n  if (!actualGuiPort) {\n    throw error('missing ui server port')\n  }\n\n  // Start the VSR registry with the GUI server port\n  stdout('Starting VSR registry...')\n\n  // Prepare environment for VSR registry\n  const registryEnv = {\n    ARG_DAEMON: 'true',\n    DAEMON_START_SERVER: 'false',\n    DAEMON_PORT: String(actualGuiPort),\n    DAEMON_URL: `http://localhost:${actualGuiPort}`,\n  }\n\n  // runs the exec command internally\n  /* c8 ignore start */\n  const allowScripts =\n    conf.get('allow-scripts') ?\n      String(conf.get('allow-scripts'))\n    : ':not(*)'\n  /* c8 ignore stop */\n  const arg0 = await vlx.resolve(\n    ['@vltpkg/vsr'],\n    {\n      ...conf.options,\n      query: undefined,\n      allowScripts,\n    },\n    async () => 'y',\n  )\n  if (arg0) {\n    conf.positionals[0] = arg0\n  }\n  delete conf.options['script-shell']\n  const ex = new ExecCommand(conf, exec, execFG)\n  ex.env = registryEnv\n  await ex.run()\n\n  // Handle process termination\n  /* c8 ignore start */\n  const cleanup = () => {\n    stdout('\\nShutting down servers...')\n    try {\n      void server.close()\n      stdout('UI server stopped')\n    } catch {}\n  }\n  onExit(cleanup)\n  /* c8 ignore stop */\n\n  // Return the server information\n  const result: ServeResult = {\n    guiPort: actualGuiPort,\n    registryPort,\n    uiURL: `http://localhost:${actualGuiPort}`,\n    registryURL: `http://localhost:${registryPort}`,\n  }\n\n  // This return will never be reached due to the infinite promise above\n  return result\n}\n"]}