@vltpkg/cli-sdk 0.0.0-9 → 1.0.0-rc.1

package/dist/esm/commands/list.js

@@ -1,32 +1,57 @@
-import { actual, humanReadableOutput, jsonOutput, mermaidOutput, } from '@vltpkg/graph';
+import { actual, asNode, humanReadableOutput, jsonOutput, mermaidOutput, GraphModifier, } from '@vltpkg/graph';
+import LZString from 'lz-string';
 import { Query } from '@vltpkg/query';
 import { SecurityArchive } from '@vltpkg/security-archive';
+import { error } from '@vltpkg/error-cause';
 import { commandUsage } from "../config/usage.js";
 import { startGUI } from "../start-gui.js";
+import { createHostContextsMap } from "../query-host-contexts.js";
 export const usage = () => commandUsage({
     command: 'ls',
-    usage: ['', '<query> --view=[human | json | mermaid | gui]'],
-    description: `List installed dependencies matching the provided query.
-                  Defaults to listing direct dependencies of a project and
-                  any configured workspace.`,
+    usage: [
+        '',
+        '[package-names...] [--view=human | json | mermaid | gui]',
+        '[--scope=<query>] [--target=<query>] [--view=human | json | mermaid | gui]',
+    ],
+    description: `List installed dependencies matching given package names or query selectors.
+
+      Package names provided as positional arguments will be used to filter
+      the results to show only dependencies with those names.
+
+      The --scope and --target options accepts DSS query selectors to filter
+      packages. Using --scope, you can specify which packages to treat as the
+      top-level items in the output graph. The --target option allows you to
+      filter what dependencies to include in the output. Using both options
+      allows you to render subgraphs of the dependency graph.
+
+      Defaults to listing direct dependencies of a project and any configured
+      workspace.`,
     examples: {
         '': {
             description: 'List direct dependencies of the current project / workspace',
         },
-        '"*"': {
-            description: 'List all dependencies for the current project / workspace',
-        },
         'foo bar baz': {
             description: `List all dependencies named 'foo', 'bar', or 'baz'`,
         },
-        [`'[name="@scoped/package"] > *'`]: {
-            description: 'Lists direct dependencies of a specific package',
+        '--scope=":root > #dependency-name"': {
+            description: 'Defines a direct dependency as the output top-level scope',
+        },
+        '--target="*"': {
+            description: 'List all dependencies using a query selector',
         },
-        [`'*.workspace > *.peer'`]: {
+        '--target=":workspace > *:peer"': {
             description: 'List all peer dependencies of all workspaces',
         },
     },
     options: {
+        scope: {
+            value: '<query>',
+            description: 'Query selector to select top-level packages using the DSS query language syntax.',
+        },
+        target: {
+            value: '<query>',
+            description: 'Query selector to filter packages using the DSS query language syntax.',
+        },
         view: {
             value: '[human | json | mermaid | gui]',
             description: 'Output format. Defaults to human-readable or json if no tty.',
@@ -38,62 +63,137 @@ export const views = {
     mermaid: mermaidOutput,
     human: humanReadableOutput,
     gui: async ({ queryString }, _, conf) => {
-        await startGUI(conf, '/explore?query=' + encodeURIComponent(queryString));
+        await startGUI(conf, `/explore/${LZString.compressToEncodedURIComponent(queryString)}/overview`);
     },
 };
 export const command = async (conf) => {
+    const modifiers = GraphModifier.maybeLoad(conf.options);
     const monorepo = conf.options.monorepo;
-    const mainManifest = conf.options.packageJson.read(conf.options.projectRoot);
-    const graph = actual.load({
-        ...conf.options,
-        mainManifest,
-        monorepo,
-        loadManifests: true,
-    });
-    const queryString = conf.positionals
-        .map(k => (/^[@\w-]/.test(k) ? `#${k.replace(/\//, '\\/')}` : k))
+    const mainManifest = conf.options.packageJson.maybeRead(conf.options.projectRoot);
+    let graph;
+    let securityArchive;
+    // optionally load the cwd graph if we found a package.json file
+    if (mainManifest) {
+        graph = actual.load({
+            ...conf.options,
+            mainManifest,
+            modifiers,
+            monorepo,
+            loadManifests: true,
+        });
+        securityArchive = await SecurityArchive.start({
+            nodes: [...graph.nodes.values()],
+        });
+    }
+    // Validate positional arguments - only allow package names, not direct queries
+    for (const arg of conf.positionals) {
+        if (!/^[@\w-]/.test(arg)) {
+            throw error(`Direct queries are not supported as positional arguments. Use package names only.`, {
+                code: 'EUSAGE',
+                cause: `Argument '${arg}' appears to be a query syntax. Only package names are allowed as positional arguments.`,
+            });
+        }
+    }
+    // retrieve default values and set up host contexts
+    const positionalQueryString = conf.positionals
+        .map(k => `#${k.replace(/\//, '\\/')}`)
         .join(', ');
-    const securityArchive = Query.hasSecuritySelectors(queryString) ?
-        await SecurityArchive.start({
-            graph,
-            specOptions: conf.options,
-        })
-        : undefined;
-    const query = new Query({
-        graph,
-        specOptions: conf.options,
-        securityArchive,
-    });
-    const projectQueryString = ':project, :project > *';
+    const targetQueryString = conf.get('target');
+    const scopeQueryString = conf.get('scope');
+    const queryString = targetQueryString || positionalQueryString;
+    const projectQueryString = ':workspace, :project > *';
     const selectImporters = [];
+    const hostContexts = await createHostContextsMap(conf);
     const importers = new Set();
-    if (monorepo) {
-        for (const workspace of monorepo.filter(conf.values)) {
-            const w = graph.nodes.get(workspace.id);
-            if (w) {
-                importers.add(w);
-                selectImporters.push(`[name="${w.name}"]`);
-                selectImporters.push(`[name="${w.name}"] > *`);
-            }
+    const scopeIDs = [];
+    // handle --scope option to add scope nodes as importers
+    let scopeNodes;
+    if (scopeQueryString) {
+        // run scope query to get all matching nodes
+        /* c8 ignore start */
+        const edges = graph?.edges ?? new Set();
+        const nodes = graph?.nodes ?
+            new Set(graph.nodes.values())
+            : new Set();
+        const importers = graph?.importers ?? new Set();
+        /* c8 ignore stop */
+        const scopeQuery = new Query({
+            nodes,
+            edges,
+            importers,
+            securityArchive,
+            hostContexts,
+        });
+        const { nodes: resultNodes } = await scopeQuery.search(scopeQueryString, {
+            signal: new AbortController().signal,
+        });
+        scopeNodes = resultNodes;
+    }
+    if (scopeQueryString && scopeNodes) {
+        // Add all scope nodes to importers Set (treat them as top-level items)
+        for (const queryNode of scopeNodes) {
+            importers.add(asNode(queryNode));
         }
     }
-    if (importers.size === 0) {
-        for (const importer of graph.importers) {
-            importers.add(importer);
+    else if ('workspace' in conf.values) {
+        // if in a workspace environment, select only the specified
+        // workspaces as top-level items
+        if (monorepo && graph) {
+            for (const workspace of monorepo.filter(conf.values)) {
+                const w = graph.nodes.get(workspace.id);
+                if (w) {
+                    importers.add(w);
+                    selectImporters.push(`[name="${w.name}"]`);
+                    selectImporters.push(`[name="${w.name}"] > *`);
+                    scopeIDs.push(workspace.id);
+                }
+            }
         }
     }
+    // build a default query string to use in the target search
     const selectImportersQueryString = selectImporters.join(', ');
-    const defaultQueryString = (selectImporters.length &&
+    const defaultProjectQueryString = (graph &&
+        selectImporters.length &&
         selectImporters.length < graph.importers.size) ?
         selectImportersQueryString
         : projectQueryString;
-    const { edges, nodes } = await query.search(queryString || defaultQueryString);
+    const defaultLocalScopeQueryString = ':host(local) :root > *';
+    // retrieve the selected nodes and edges
+    /* c8 ignore start */
+    const edges_ = graph?.edges ?? new Set();
+    const nodes_ = graph?.nodes ?
+        new Set(graph.nodes.values())
+        : new Set();
+    const importers_ = importers.size === 0 && graph ?
+        new Set([graph.mainImporter])
+        : importers;
+    /* c8 ignore stop */
+    const q = new Query({
+        nodes: nodes_,
+        edges: edges_,
+        importers: importers_,
+        securityArchive,
+        hostContexts,
+    });
+    const query = queryString ||
+        /* c8 ignore next */
+        (graph ? defaultProjectQueryString : defaultLocalScopeQueryString);
+    const { edges, nodes, importers: queryResultImporters, } = await q.search(query, {
+        signal: new AbortController().signal,
+        scopeIDs: scopeIDs.length > 0 ? scopeIDs : undefined,
+    });
     return {
-        importers,
+        importers: importers.size === 0 ?
+            new Set(queryResultImporters)
+            : importers,
         edges,
         nodes,
-        queryString: queryString || defaultQueryString,
-        highlightSelection: !!queryString,
+        highlightSelection: !!(targetQueryString || positionalQueryString),
+        queryString: queryString ||
+            (graph ?
+                /* c8 ignore next 2 */
+                defaultProjectQueryString
+                : defaultLocalScopeQueryString),
     };
 };
 //# sourceMappingURL=list.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/list.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  HumanReadableOutputGraph,\n  JSONOutputGraph,\n  MermaidOutputGraph,\n  Node,\n} from '@vltpkg/graph'\nimport {\n  actual,\n  humanReadableOutput,\n  jsonOutput,\n  mermaidOutput,\n} from '@vltpkg/graph'\nimport { Query } from '@vltpkg/query'\nimport { SecurityArchive } from '@vltpkg/security-archive'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { startGUI } from '../start-gui.ts'\nimport type { Views } from '../view.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'ls',\n    usage: ['', '<query> --view=[human | json | mermaid | gui]'],\n    description: `List installed dependencies matching the provided query.\n                  Defaults to listing direct dependencies of a project and\n                  any configured workspace.`,\n    examples: {\n      '': {\n        description:\n          'List direct dependencies of the current project / workspace',\n      },\n      '\"*\"': {\n        description:\n          'List all dependencies for the current project / workspace',\n      },\n      'foo bar baz': {\n        description: `List all dependencies named 'foo', 'bar', or 'baz'`,\n      },\n      [`'[name=\"@scoped/package\"] > *'`]: {\n        description:\n          'Lists direct dependencies of a specific package',\n      },\n      [`'*.workspace > *.peer'`]: {\n        description: 'List all peer dependencies of all workspaces',\n      },\n    },\n    options: {\n      view: {\n        value: '[human | json | mermaid | gui]',\n        description:\n          'Output format. Defaults to human-readable or json if no tty.',\n      },\n    },\n  })\n\nexport type ListResult = JSONOutputGraph &\n  MermaidOutputGraph &\n  HumanReadableOutputGraph & { queryString: string }\n\nexport const views = {\n  json: jsonOutput,\n  mermaid: mermaidOutput,\n  human: humanReadableOutput,\n  gui: async ({ queryString }, _, conf) => {\n    await startGUI(\n      conf,\n      '/explore?query=' + encodeURIComponent(queryString),\n    )\n  },\n} as const satisfies Views<ListResult>\n\nexport const command: CommandFn<ListResult> = async conf => {\n  const monorepo = conf.options.monorepo\n  const mainManifest = conf.options.packageJson.read(\n    conf.options.projectRoot,\n  )\n  const graph = actual.load({\n    ...conf.options,\n    mainManifest,\n    monorepo,\n    loadManifests: true,\n  })\n\n  const queryString = conf.positionals\n    .map(k => (/^[@\\w-]/.test(k) ? `#${k.replace(/\\//, '\\\\/')}` : k))\n    .join(', ')\n  const securityArchive =\n    Query.hasSecuritySelectors(queryString) ?\n      await SecurityArchive.start({\n        graph,\n        specOptions: conf.options,\n      })\n    : undefined\n  const query = new Query({\n    graph,\n    specOptions: conf.options,\n    securityArchive,\n  })\n  const projectQueryString = ':project, :project > *'\n  const selectImporters: string[] = []\n\n  const importers = new Set<Node>()\n  if (monorepo) {\n    for (const workspace of monorepo.filter(conf.values)) {\n      const w: Node | undefined = graph.nodes.get(workspace.id)\n      if (w) {\n        importers.add(w)\n        selectImporters.push(`[name=\"${w.name}\"]`)\n        selectImporters.push(`[name=\"${w.name}\"] > *`)\n      }\n    }\n  }\n  if (importers.size === 0) {\n    for (const importer of graph.importers) {\n      importers.add(importer)\n    }\n  }\n\n  const selectImportersQueryString = selectImporters.join(', ')\n  const defaultQueryString =\n    (\n      selectImporters.length &&\n      selectImporters.length < graph.importers.size\n    ) ?\n      selectImportersQueryString\n    : projectQueryString\n\n  const { edges, nodes } = await query.search(\n    queryString || defaultQueryString,\n  )\n\n  return {\n    importers,\n    edges,\n    nodes,\n    queryString: queryString || defaultQueryString,\n    highlightSelection: !!queryString,\n  }\n}\n"]}
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/list.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  actual,\n  asNode,\n  humanReadableOutput,\n  jsonOutput,\n  mermaidOutput,\n  GraphModifier,\n} from '@vltpkg/graph'\nimport LZString from 'lz-string'\nimport { Query } from '@vltpkg/query'\nimport { SecurityArchive } from '@vltpkg/security-archive'\nimport { error } from '@vltpkg/error-cause'\nimport { commandUsage } from '../config/usage.ts'\nimport { startGUI } from '../start-gui.ts'\nimport { createHostContextsMap } from '../query-host-contexts.ts'\nimport type {\n  HumanReadableOutputGraph,\n  JSONOutputGraph,\n  MermaidOutputGraph,\n  Node,\n  Graph,\n} from '@vltpkg/graph'\nimport type { DepID } from '@vltpkg/dep-id'\nimport type { NodeLike } from '@vltpkg/types'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport type { Views } from '../view.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'ls',\n    usage: [\n      '',\n      '[package-names...] [--view=human | json | mermaid | gui]',\n      '[--scope=<query>] [--target=<query>] [--view=human | json | mermaid | gui]',\n    ],\n    description: `List installed dependencies matching given package names or query selectors.\n\n      Package names provided as positional arguments will be used to filter\n      the results to show only dependencies with those names.\n\n      The --scope and --target options accepts DSS query selectors to filter\n      packages. Using --scope, you can specify which packages to treat as the\n      top-level items in the output graph. The --target option allows you to\n      filter what dependencies to include in the output. Using both options\n      allows you to render subgraphs of the dependency graph.\n\n      Defaults to listing direct dependencies of a project and any configured\n      workspace.`,\n    examples: {\n      '': {\n        description:\n          'List direct dependencies of the current project / workspace',\n      },\n      'foo bar baz': {\n        description: `List all dependencies named 'foo', 'bar', or 'baz'`,\n      },\n      '--scope=\":root > #dependency-name\"': {\n        description:\n          'Defines a direct dependency as the output top-level scope',\n      },\n      '--target=\"*\"': {\n        description: 'List all dependencies using a query selector',\n      },\n      '--target=\":workspace > *:peer\"': {\n        description: 'List all peer dependencies of all workspaces',\n      },\n    },\n    options: {\n      scope: {\n        value: '<query>',\n        description:\n          'Query selector to select top-level packages using the DSS query language syntax.',\n      },\n      target: {\n        value: '<query>',\n        description:\n          'Query selector to filter packages using the DSS query language syntax.',\n      },\n      view: {\n        value: '[human | json | mermaid | gui]',\n        description:\n          'Output format. Defaults to human-readable or json if no tty.',\n      },\n    },\n  })\n\nexport type ListResult = JSONOutputGraph &\n  MermaidOutputGraph &\n  HumanReadableOutputGraph & { queryString: string }\n\nexport const views = {\n  json: jsonOutput,\n  mermaid: mermaidOutput,\n  human: humanReadableOutput,\n  gui: async ({ queryString }, _, conf) => {\n    await startGUI(\n      conf,\n      `/explore/${LZString.compressToEncodedURIComponent(queryString)}/overview`,\n    )\n  },\n} as const satisfies Views<ListResult>\n\nexport const command: CommandFn<ListResult> = async conf => {\n  const modifiers = GraphModifier.maybeLoad(conf.options)\n  const monorepo = conf.options.monorepo\n  const mainManifest = conf.options.packageJson.maybeRead(\n    conf.options.projectRoot,\n  )\n  let graph: Graph | undefined\n  let securityArchive: SecurityArchive | undefined\n\n  // optionally load the cwd graph if we found a package.json file\n  if (mainManifest) {\n    graph = actual.load({\n      ...conf.options,\n      mainManifest,\n      modifiers,\n      monorepo,\n      loadManifests: true,\n    })\n    securityArchive = await SecurityArchive.start({\n      nodes: [...graph.nodes.values()],\n    })\n  }\n\n  // Validate positional arguments - only allow package names, not direct queries\n  for (const arg of conf.positionals) {\n    if (!/^[@\\w-]/.test(arg)) {\n      throw error(\n        `Direct queries are not supported as positional arguments. Use package names only.`,\n        {\n          code: 'EUSAGE',\n          cause: `Argument '${arg}' appears to be a query syntax. Only package names are allowed as positional arguments.`,\n        },\n      )\n    }\n  }\n\n  // retrieve default values and set up host contexts\n  const positionalQueryString = conf.positionals\n    .map(k => `#${k.replace(/\\//, '\\\\/')}`)\n    .join(', ')\n  const targetQueryString = conf.get('target')\n  const scopeQueryString = conf.get('scope')\n  const queryString = targetQueryString || positionalQueryString\n  const projectQueryString = ':workspace, :project > *'\n  const selectImporters: string[] = []\n  const hostContexts = await createHostContextsMap(conf)\n  const importers = new Set<Node>()\n  const scopeIDs: DepID[] = []\n\n  // handle --scope option to add scope nodes as importers\n  let scopeNodes\n  if (scopeQueryString) {\n    // run scope query to get all matching nodes\n    /* c8 ignore start */\n    const edges = graph?.edges ?? new Set()\n    const nodes =\n      graph?.nodes ?\n        new Set<NodeLike>(graph.nodes.values())\n      : new Set<NodeLike>()\n    const importers = graph?.importers ?? new Set()\n    /* c8 ignore stop */\n    const scopeQuery = new Query({\n      nodes,\n      edges,\n      importers,\n      securityArchive,\n      hostContexts,\n    })\n    const { nodes: resultNodes } = await scopeQuery.search(\n      scopeQueryString,\n      {\n        signal: new AbortController().signal,\n      },\n    )\n    scopeNodes = resultNodes\n  }\n\n  if (scopeQueryString && scopeNodes) {\n    // Add all scope nodes to importers Set (treat them as top-level items)\n    for (const queryNode of scopeNodes) {\n      importers.add(asNode(queryNode))\n    }\n  } else if ('workspace' in conf.values) {\n    // if in a workspace environment, select only the specified\n    // workspaces as top-level items\n    if (monorepo && graph) {\n      for (const workspace of monorepo.filter(conf.values)) {\n        const w: Node | undefined = graph.nodes.get(workspace.id)\n        if (w) {\n          importers.add(w)\n          selectImporters.push(`[name=\"${w.name}\"]`)\n          selectImporters.push(`[name=\"${w.name}\"] > *`)\n          scopeIDs.push(workspace.id)\n        }\n      }\n    }\n  }\n\n  // build a default query string to use in the target search\n  const selectImportersQueryString = selectImporters.join(', ')\n  const defaultProjectQueryString =\n    (\n      graph &&\n      selectImporters.length &&\n      selectImporters.length < graph.importers.size\n    ) ?\n      selectImportersQueryString\n    : projectQueryString\n  const defaultLocalScopeQueryString = ':host(local) :root > *'\n\n  // retrieve the selected nodes and edges\n  /* c8 ignore start */\n  const edges_ = graph?.edges ?? new Set()\n  const nodes_ =\n    graph?.nodes ?\n      new Set<NodeLike>(graph.nodes.values())\n    : new Set<NodeLike>()\n  const importers_ =\n    importers.size === 0 && graph ?\n      new Set([graph.mainImporter])\n    : importers\n  /* c8 ignore stop */\n  const q = new Query({\n    nodes: nodes_,\n    edges: edges_,\n    importers: importers_,\n    securityArchive,\n    hostContexts,\n  })\n  const query =\n    queryString ||\n    /* c8 ignore next */\n    (graph ? defaultProjectQueryString : defaultLocalScopeQueryString)\n  const {\n    edges,\n    nodes,\n    importers: queryResultImporters,\n  } = await q.search(query, {\n    signal: new AbortController().signal,\n    scopeIDs: scopeIDs.length > 0 ? scopeIDs : undefined,\n  })\n\n  return {\n    importers:\n      importers.size === 0 ?\n        new Set(queryResultImporters)\n      : importers,\n    edges,\n    nodes,\n    highlightSelection: !!(\n      targetQueryString || positionalQueryString\n    ),\n    queryString:\n      queryString ||\n      (graph ?\n        /* c8 ignore next 2 */\n        defaultProjectQueryString\n      : defaultLocalScopeQueryString),\n  }\n}\n"]}

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

@@ -0,0 +1,32 @@
+import type { CommandFn, CommandUsage } from '../index.ts';
+import type { LoadedConfig } from '../config/index.ts';
+export declare const usage: CommandUsage;
+export type CommandResultSingle = {
+    id: string;
+    name: string;
+    version: string;
+    filename: string;
+    files: string[];
+    size: number;
+    unpackedSize: number;
+    shasum?: string;
+    integrity?: string;
+};
+export type CommandResult = CommandResultSingle | CommandResultSingle[];
+export declare const views: {
+    readonly human: (results: CommandResult) => string;
+    readonly json: (r: CommandResult) => CommandResult;
+};
+export declare const command: CommandFn<CommandResult>;
+export declare const commandSingle: (location: string, conf: LoadedConfig) => Promise<{
+    id: string;
+    name: string;
+    version: string;
+    filename: string;
+    files: string[];
+    size: number;
+    unpackedSize: number;
+    shasum: string | undefined;
+    integrity: string | undefined;
+}>;
+//# sourceMappingURL=pack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pack.d.ts","sourceRoot":"","sources":["../../../src/commands/pack.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAM1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAItD,eAAO,MAAM,KAAK,EAAE,YAchB,CAAA;AAEJ,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,aAAa,GACrB,mBAAmB,GACnB,mBAAmB,EAAE,CAAA;AAEzB,eAAO,MAAM,KAAK;;;CAoBuB,CAAA;AAEzC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,aAAa,CAiE5C,CAAA;AAED,eAAO,MAAM,aAAa,aACd,MAAM,QACV,YAAY;;;;;;;;;;EA0DnB,CAAA"}

package/dist/esm/commands/pack.js

@@ -0,0 +1,147 @@
+import { writeFile } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import assert from 'node:assert';
+import { run } from '@vltpkg/run';
+import { commandUsage } from "../config/usage.js";
+import { packTarball } from "../pack-tarball.js";
+import prettyBytes from 'pretty-bytes';
+import { actual } from '@vltpkg/graph';
+import { Query } from '@vltpkg/query';
+import { error } from '@vltpkg/error-cause';
+import { createHostContextsMap } from "../query-host-contexts.js";
+export const usage = () => commandUsage({
+    command: 'pack',
+    usage: '',
+    description: `Create a tarball from a package in the current directory or specified folder.
+    
+    The tarball will be saved to the current directory with the name
+    <name>-<version>.tgz.`,
+    options: {
+        'dry-run': {
+            description: 'Show what would be packed without creating a tarball',
+        },
+    },
+});
+export const views = {
+    human: results => {
+        const item = (r) => {
+            const lines = [
+                `📦 Package: ${r.id}`,
+                `📄 File: ${r.filename}`,
+                `📁 ${r.files.length} Files`,
+                ...r.files.map(f => `  - ${f}`),
+                `📊 Package Size: ${prettyBytes(r.size)}`,
+                `📂 Unpacked Size: ${prettyBytes(r.unpackedSize)}`,
+            ];
+            if (r.shasum)
+                lines.push(`🔒 Shasum: ${r.shasum}`);
+            if (r.integrity)
+                lines.push(`🔐 Integrity: ${r.integrity}`);
+            return lines.join('\n');
+        };
+        return Array.isArray(results) ?
+            results.map(item).join('\n\n')
+            : item(results);
+    },
+    json: r => r,
+};
+export const command = async (conf) => {
+    const { options, projectRoot } = conf;
+    const queryString = conf.get('scope');
+    const paths = conf.get('workspace');
+    const groups = conf.get('workspace-group');
+    const recursive = conf.get('recursive');
+    const locations = [];
+    let single = null;
+    if (queryString) {
+        const mainManifest = options.packageJson.maybeRead(projectRoot);
+        let graph;
+        if (mainManifest) {
+            graph = actual.load({
+                ...options,
+                mainManifest,
+                monorepo: options.monorepo,
+                loadManifests: false,
+            });
+        }
+        const hostContexts = await createHostContextsMap(conf);
+        const query = new Query({
+            /* c8 ignore next */
+            nodes: graph ? new Set(graph.nodes.values()) : new Set(),
+            edges: graph?.edges ?? new Set(),
+            importers: graph?.importers ?? new Set(),
+            securityArchive: undefined,
+            hostContexts,
+        });
+        const { nodes } = await query.search(queryString, {
+            signal: new AbortController().signal,
+        });
+        for (const node of nodes) {
+            const { location } = node.toJSON();
+            assert(location, error(`node ${node.id} has no location`, {
+                found: node,
+            }));
+            locations.push(resolve(projectRoot, location));
+        }
+    }
+    else if (paths?.length || groups?.length || recursive) {
+        for (const workspace of options.monorepo ?? []) {
+            locations.push(workspace.fullpath);
+        }
+    }
+    else {
+        single = options.packageJson.find(process.cwd()) ?? projectRoot;
+    }
+    if (single) {
+        return commandSingle(single, conf);
+    }
+    assert(locations.length > 0, error('No workspaces or query results found'));
+    const results = [];
+    for (const location of locations) {
+        results.push(await commandSingle(location, conf));
+    }
+    return results;
+};
+export const commandSingle = async (location, conf) => {
+    const manifestPath = conf.options.packageJson.find(location);
+    assert(manifestPath, 'No package.json found');
+    const manifestDir = dirname(manifestPath);
+    const manifest = conf.options.packageJson.read(manifestDir);
+    const isDryRun = conf.options['dry-run'];
+    const runOptions = {
+        cwd: manifestDir,
+        projectRoot: conf.projectRoot,
+        packageJson: conf.options.packageJson,
+        manifest,
+        ignoreMissing: true,
+        ignorePrePost: true,
+    };
+    await run({
+        ...runOptions,
+        arg0: 'prepack',
+    });
+    await run({
+        ...runOptions,
+        arg0: 'prepare',
+    });
+    const { name, version, filename, tarballData, unpackedSize, files, integrity, shasum, } = await packTarball(manifest, manifestDir, conf);
+    if (!isDryRun) {
+        await writeFile(join(manifestDir, filename), tarballData);
+    }
+    await run({
+        ...runOptions,
+        arg0: 'postpack',
+    });
+    return {
+        id: `${name}@${version}`,
+        name,
+        version,
+        filename,
+        files,
+        size: tarballData.length,
+        unpackedSize,
+        shasum,
+        integrity,
+    };
+};
+//# sourceMappingURL=pack.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pack.js","sourceRoot":"","sources":["../../../src/commands/pack.ts"],"names":[],"mappings":"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","sourcesContent":["import { writeFile } from 'node:fs/promises'\nimport { dirname, join, resolve } from 'node:path'\nimport assert from 'node:assert'\nimport { run } from '@vltpkg/run'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { packTarball } from '../pack-tarball.ts'\nimport type { Views } from '../view.ts'\nimport prettyBytes from 'pretty-bytes'\nimport { actual } from '@vltpkg/graph'\nimport { Query } from '@vltpkg/query'\nimport type { LoadedConfig } from '../config/index.ts'\nimport { error } from '@vltpkg/error-cause'\nimport { createHostContextsMap } from '../query-host-contexts.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'pack',\n    usage: '',\n    description: `Create a tarball from a package in the current directory or specified folder.\n    \n    The tarball will be saved to the current directory with the name\n    <name>-<version>.tgz.`,\n    options: {\n      'dry-run': {\n        description:\n          'Show what would be packed without creating a tarball',\n      },\n    },\n  })\n\nexport type CommandResultSingle = {\n  id: string\n  name: string\n  version: string\n  filename: string\n  files: string[]\n  size: number\n  unpackedSize: number\n  shasum?: string\n  integrity?: string\n}\n\nexport type CommandResult =\n  | CommandResultSingle\n  | CommandResultSingle[]\n\nexport const views = {\n  human: results => {\n    const item = (r: CommandResultSingle) => {\n      const lines = [\n        `📦 Package: ${r.id}`,\n        `📄 File: ${r.filename}`,\n        `📁 ${r.files.length} Files`,\n        ...r.files.map(f => `  - ${f}`),\n        `📊 Package Size: ${prettyBytes(r.size)}`,\n        `📂 Unpacked Size: ${prettyBytes(r.unpackedSize)}`,\n      ]\n      if (r.shasum) lines.push(`🔒 Shasum: ${r.shasum}`)\n      if (r.integrity) lines.push(`🔐 Integrity: ${r.integrity}`)\n      return lines.join('\\n')\n    }\n    return Array.isArray(results) ?\n        results.map(item).join('\\n\\n')\n      : item(results)\n  },\n  json: r => r,\n} as const satisfies Views<CommandResult>\n\nexport const command: CommandFn<CommandResult> = async conf => {\n  const { options, projectRoot } = conf\n  const queryString = conf.get('scope')\n  const paths = conf.get('workspace')\n  const groups = conf.get('workspace-group')\n  const recursive = conf.get('recursive')\n\n  const locations: string[] = []\n  let single: string | null = null\n\n  if (queryString) {\n    const mainManifest = options.packageJson.maybeRead(projectRoot)\n    let graph\n    if (mainManifest) {\n      graph = actual.load({\n        ...options,\n        mainManifest,\n        monorepo: options.monorepo,\n        loadManifests: false,\n      })\n    }\n    const hostContexts = await createHostContextsMap(conf)\n    const query = new Query({\n      /* c8 ignore next */\n      nodes: graph ? new Set(graph.nodes.values()) : new Set(),\n      edges: graph?.edges ?? new Set(),\n      importers: graph?.importers ?? new Set(),\n      securityArchive: undefined,\n      hostContexts,\n    })\n    const { nodes } = await query.search(queryString, {\n      signal: new AbortController().signal,\n    })\n    for (const node of nodes) {\n      const { location } = node.toJSON()\n      assert(\n        location,\n        error(`node ${node.id} has no location`, {\n          found: node,\n        }),\n      )\n      locations.push(resolve(projectRoot, location))\n    }\n  } else if (paths?.length || groups?.length || recursive) {\n    for (const workspace of options.monorepo ?? []) {\n      locations.push(workspace.fullpath)\n    }\n  } else {\n    single = options.packageJson.find(process.cwd()) ?? projectRoot\n  }\n\n  if (single) {\n    return commandSingle(single, conf)\n  }\n\n  assert(\n    locations.length > 0,\n    error('No workspaces or query results found'),\n  )\n\n  const results: CommandResultSingle[] = []\n  for (const location of locations) {\n    results.push(await commandSingle(location, conf))\n  }\n  return results\n}\n\nexport const commandSingle = async (\n  location: string,\n  conf: LoadedConfig,\n) => {\n  const manifestPath = conf.options.packageJson.find(location)\n  assert(manifestPath, 'No package.json found')\n  const manifestDir = dirname(manifestPath)\n  const manifest = conf.options.packageJson.read(manifestDir)\n\n  const isDryRun = conf.options['dry-run']\n  const runOptions = {\n    cwd: manifestDir,\n    projectRoot: conf.projectRoot,\n    packageJson: conf.options.packageJson,\n    manifest,\n    ignoreMissing: true,\n    ignorePrePost: true,\n  }\n\n  await run({\n    ...runOptions,\n    arg0: 'prepack',\n  })\n\n  await run({\n    ...runOptions,\n    arg0: 'prepare',\n  })\n\n  const {\n    name,\n    version,\n    filename,\n    tarballData,\n    unpackedSize,\n    files,\n    integrity,\n    shasum,\n  } = await packTarball(manifest, manifestDir, conf)\n\n  if (!isDryRun) {\n    await writeFile(join(manifestDir, filename), tarballData)\n  }\n\n  await run({\n    ...runOptions,\n    arg0: 'postpack',\n  })\n\n  return {\n    id: `${name}@${version}`,\n    name,\n    version,\n    filename,\n    files,\n    size: tarballData.length,\n    unpackedSize,\n    shasum,\n    integrity,\n  }\n}\n"]}

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

@@ -1,7 +1,6 @@
-import type { LoadedConfig } from '../config/index.ts';
 import type { CommandFn, CommandUsage } from '../index.ts';
 export declare const views: {
-    readonly human: (results: unknown, options: import("../view.ts").ViewOptions, config: LoadedConfig) => unknown;
+    readonly human: (results: unknown, _: import("../view.ts").ViewOptions, config: import("../config/index.ts").ParsedConfig) => string;
 };
 export declare const usage: CommandUsage;
 export declare const command: CommandFn;

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

@@ -1 +1 @@
-{"version":3,"file":"pkg.d.ts","sourceRoot":"","sources":["../../../src/commands/pkg.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAM1D,eAAO,MAAM,KAAK;;CAaQ,CAAA;AAE1B,eAAO,MAAM,KAAK,EAAE,YAoChB,CAAA;AAEJ,eAAO,MAAM,OAAO,EAAE,SA6BrB,CAAA"}
+{"version":3,"file":"pkg.d.ts","sourceRoot":"","sources":["../../../src/commands/pkg.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1D,eAAO,MAAM,KAAK;;CAgBQ,CAAA;AAE1B,eAAO,MAAM,KAAK,EAAE,YAoChB,CAAA;AAEJ,eAAO,MAAM,OAAO,EAAE,SAqGrB,CAAA"}