@vltpkg/cli-sdk 1.0.0-rc.8 → 1.0.1

package/dist/telemetry.js

@@ -0,0 +1,170 @@
+/**
+ * Anonymized telemetry for the vlt CLI.
+ *
+ * - Sends anonymous, non-PII events to PostHog.
+ * - Generates a random UUID on first run, stored in XDG data dir.
+ * - Respects opt-out via `DO_NOT_TRACK=1`, `VLT_TELEMETRY=0`,
+ *   or the `--telemetry=false` config flag.
+ * - Flush is awaited with a timeout cap so it never blocks CLI exit for long.
+ * - Fails silently on any network or runtime error.
+ * @module
+ */
+import { randomUUID } from 'node:crypto';
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { XDG } from '@vltpkg/xdg';
+const POSTHOG_API_KEY = 'phc_k9xCAgC6sPIBLb5UhjhnGWpt1mos0hLV4mmEhZTGPpO';
+const POSTHOG_HOST = 'https://us.i.posthog.com';
+/** Timeout (ms) we wait for PostHog to flush before giving up. */
+const SHUTDOWN_TIMEOUT_MS = 2_000;
+const xdg = new XDG('vlt');
+/**
+ * Check whether telemetry is disabled via environment variables.
+ *
+ * - `DO_NOT_TRACK=1` — https://consoledonottrack.com/
+ * - `VLT_TELEMETRY=0`
+ */
+export const isOptedOut = () => process.env.DO_NOT_TRACK === '1' ||
+    process.env.VLT_TELEMETRY === '0';
+/**
+ * Return (or create) a stable anonymous distinct ID.
+ * Stored at `<XDG_DATA_HOME>/vlt/telemetry-id`.
+ */
+const getAnonymousId = () => {
+    const dir = xdg.data();
+    const file = xdg.data('telemetry-id');
+    try {
+        const existing = readFileSync(file, 'utf8').trim();
+        if (existing)
+            return existing;
+    }
+    catch {
+        // file doesn't exist yet — create it below
+    }
+    const id = randomUUID();
+    try {
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(file, id + '\n');
+    }
+    catch {
+        // best-effort — if we can't persist, just use a transient id
+    }
+    return id;
+};
+// ---------------------------------------------------------------------------
+// PostHog client — lazily initialised
+// ---------------------------------------------------------------------------
+let _posthog;
+let _initFailed = false;
+const getClient = () => {
+    if (_posthog)
+        return _posthog;
+    if (_initFailed)
+        return undefined;
+    try {
+        // Dynamic import would be async; posthog-node also ships a
+        // synchronous constructor, so we use createRequire to keep
+        // the hot-path synchronous in this ESM package.
+        const req = createRequire(import.meta.url);
+        const { PostHog } = req('posthog-node');
+        _posthog = new PostHog(POSTHOG_API_KEY, {
+            host: POSTHOG_HOST,
+            // Buffer up to 20 events and flush every 10 s — but we always
+            // call shutdown at the end so this is just a safety net.
+            flushAt: 20,
+            flushInterval: 10_000,
+        });
+        return _posthog;
+        /* c8 ignore next 4 */
+    }
+    catch {
+        _initFailed = true;
+        return undefined;
+    }
+};
+/**
+ * Capture a `cli_command` event.
+ */
+export const trackCommand = (ev, telemetryFlag) => {
+    if (telemetryFlag === false || isOptedOut())
+        return;
+    const ph = getClient();
+    if (!ph)
+        return;
+    try {
+        ph.capture({
+            distinctId: getAnonymousId(),
+            event: 'cli_command',
+            properties: { ...ev },
+        });
+    }
+    catch {
+        // fail silently
+    }
+};
+/**
+ * Capture a `cli_install` event.
+ */
+export const trackInstall = (ev, telemetryFlag) => {
+    if (telemetryFlag === false || isOptedOut())
+        return;
+    const ph = getClient();
+    if (!ph)
+        return;
+    try {
+        ph.capture({
+            distinctId: getAnonymousId(),
+            event: 'cli_install',
+            properties: { ...ev },
+        });
+    }
+    catch {
+        // fail silently
+    }
+};
+/**
+ * Capture a `cli_error` event.
+ */
+export const trackError = (ev, telemetryFlag) => {
+    if (telemetryFlag === false || isOptedOut())
+        return;
+    const ph = getClient();
+    if (!ph)
+        return;
+    try {
+        ph.capture({
+            distinctId: getAnonymousId(),
+            event: 'cli_error',
+            properties: { ...ev },
+        });
+    }
+    catch {
+        // fail silently
+    }
+};
+/**
+ * Flush pending events. Returns a promise that resolves once flushing
+ * completes **or** when `SHUTDOWN_TIMEOUT_MS` elapses — whichever
+ * comes first. Never rejects.
+ *
+ * The safety-net timer is unreffed so it cannot keep the process alive
+ * on its own — if the caller does not `await` this, Node will still
+ * exit promptly once all other handles are drained.
+ */
+export const flush = () => {
+    const ph = _posthog;
+    if (!ph)
+        return Promise.resolve();
+    // Clear the reference so no further events are captured and
+    // PostHog's internal timers can be garbage-collected.
+    _posthog = undefined;
+    return Promise.race([
+        ph.shutdown().catch(() => { }),
+        new Promise(r => {
+            const t = setTimeout(r, SHUTDOWN_TIMEOUT_MS);
+            // Unref so this timer alone won't keep the process alive.
+            if (typeof t === 'object' && 'unref' in t)
+                t.unref();
+        }),
+    ]);
+};

package/dist/verbose-log.d.ts

@@ -0,0 +1,31 @@
+import type { Events } from '@vltpkg/output';
+/**
+ * Diagnostic logging levels, ordered from least to most verbose.
+ * Mirrors the `loglevel` option in the config definition.
+ */
+export type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'verbose' | 'debug';
+/** True when the given level should emit per-request logging. */
+export declare const isVerbose: (level: LogLevel) => boolean;
+/** The subset of `styleText` color names this module applies. */
+export type StyleColor = 'green' | 'red' | 'gray';
+/**
+ * Minimal signature compatible with the `styleText` helpers exported by
+ * `./output.ts` (which accept a wider set of format names). Defaults to an
+ * identity function so this module can be tested without color support.
+ */
+export type StyleFn = (format: StyleColor, s: string) => string;
+/**
+ * Format a single `request` event into a human-readable log line.
+ * Exported for testing.
+ */
+export declare const formatRequestEvent: (event: Events["request"], style?: StyleFn) => string;
+/**
+ * Subscribe to registry request events and stream them to `write` when
+ * the configured `level` is `verbose` or higher. The `start` event is only
+ * logged at `debug` level to avoid duplicate lines (each network request
+ * also emits a `complete`/`304` line with its status and duration).
+ *
+ * Returns a cleanup function that detaches the subscription. When `level`
+ * is below `verbose`, nothing is subscribed and the cleanup is a no-op.
+ */
+export declare const startRequestLog: (level: LogLevel, write: (line: string) => void, style?: StyleFn) => (() => void);

package/dist/verbose-log.js

@@ -0,0 +1,62 @@
+import { emitter } from '@vltpkg/output';
+const rank = {
+    silent: 0,
+    error: 1,
+    warn: 2,
+    info: 3,
+    verbose: 4,
+    debug: 5,
+};
+/** True when the given level should emit per-request logging. */
+export const isVerbose = (level) => rank[level] >= rank.verbose;
+const isDebug = (level) => rank[level] >= rank.debug;
+const identityStyle = (_f, s) => s;
+const tagStyle = (state, statusCode) => {
+    switch (state) {
+        case 'cache':
+        case 'stale':
+        case '304':
+            return 'green';
+        case 'start':
+            return 'gray';
+        case 'complete':
+            return statusCode !== undefined && statusCode >= 400 ?
+                'red'
+                : 'green';
+    }
+};
+/**
+ * Format a single `request` event into a human-readable log line.
+ * Exported for testing.
+ */
+export const formatRequestEvent = (event, style = identityStyle) => {
+    const { url, state, method = 'GET', statusCode, durationMs } = event;
+    // For completed network requests show the status code rather than the
+    // literal word "complete"; everything else shows the cache/fetch state.
+    const tag = state === 'complete' ? String(statusCode ?? '') : state;
+    const duration = durationMs === undefined ? '' : (style('gray', ` (${durationMs}ms)`));
+    return `${style(tagStyle(state, statusCode), tag.padEnd(8))} ${method} ${String(url)}${duration}`;
+};
+/**
+ * Subscribe to registry request events and stream them to `write` when
+ * the configured `level` is `verbose` or higher. The `start` event is only
+ * logged at `debug` level to avoid duplicate lines (each network request
+ * also emits a `complete`/`304` line with its status and duration).
+ *
+ * Returns a cleanup function that detaches the subscription. When `level`
+ * is below `verbose`, nothing is subscribed and the cleanup is a no-op.
+ */
+export const startRequestLog = (level, write, style = identityStyle) => {
+    if (!isVerbose(level))
+        return () => { };
+    const debug = isDebug(level);
+    const handler = (event) => {
+        // At verbose level, skip the `start` event so each request produces a
+        // single completion line; at debug level, show it too.
+        if (event.state === 'start' && !debug)
+            return;
+        write(formatRequestEvent(event, style));
+    };
+    emitter.on('request', handler);
+    return () => emitter.off('request', handler);
+};

package/dist/{esm/view.d.ts → view.d.ts}

@@ -27,4 +27,3 @@ export type ViewFn<T = unknown> = (result: T, options: ViewOptions, conf: Loaded
 export type View<T = unknown> = ViewFn<T> | typeof ViewClass<T>;
 export declare const isViewClass: <T = unknown>(view: View<T>) => view is typeof ViewClass<T>;
 export type Views<T = unknown> = View<T> | Record<string, View<T>>;
-//# sourceMappingURL=view.d.ts.map

package/dist/{esm/view.js → view.js}

@@ -17,7 +17,7 @@ export class ViewClass {
         this.config = config;
     }
     // TODO: maybe have start() return a flag to say "i got this, do not
-    // run the command", for example to have the gui just open a web browser
+    // run the command", for example to just open a web browser
     // to the page relevant to a given thing, rather than computing it twice
     start() { }
     async done(_result, _opts) {
@@ -28,4 +28,3 @@ export class ViewClass {
 export const isViewClass = (view) => typeof view === 'function' &&
     'prototype' in view &&
     view.prototype instanceof ViewClass;
-//# sourceMappingURL=view.js.map

package/package.json

@@ -1,120 +1,117 @@
 {
   "name": "@vltpkg/cli-sdk",
   "description": "The source for the vlt CLI",
-  "version": "1.0.0-rc.8",
+  "version": "1.0.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/vltpkg/vltpkg.git",
     "directory": "src/cli-sdk"
   },
-  "author": "vlt technology inc. <support@vlt.sh> (http://vlt.sh)",
-  "tshy": {
-    "selfLink": false,
-    "liveDev": true,
-    "dialects": [
-      "esm"
-    ],
-    "exports": {
-      "./package.json": "./package.json",
-      ".": "./src/index.ts",
-      "./config": "./src/config/index.ts",
-      "./definition": "./src/config/definition.ts",
-      "./view": "./src/view.ts"
-    }
+  "author": {
+    "name": "vlt technology inc.",
+    "email": "support@vlt.sh",
+    "url": "http://vlt.sh"
   },
   "dependencies": {
+    "@resvg/resvg-wasm": "^2.6.2",
+    "@vltpkg/config": "1.0.1",
+    "@vltpkg/dep-id": "1.0.1",
+    "@vltpkg/dot-prop": "1.0.1",
+    "@vltpkg/error-cause": "1.0.1",
+    "@vltpkg/git": "1.0.1",
+    "@vltpkg/graph": "1.0.1",
+    "@vltpkg/graph-run": "1.0.1",
+    "@vltpkg/init": "1.0.1",
+    "@vltpkg/output": "1.0.1",
+    "@vltpkg/package-info": "1.0.1",
+    "@vltpkg/package-json": "1.0.1",
+    "@vltpkg/promise-spawn": "1.0.1",
+    "@vltpkg/query": "1.0.1",
+    "@vltpkg/registry-client": "1.0.1",
+    "@vltpkg/rollback-remove": "1.0.1",
+    "@vltpkg/run": "1.0.1",
+    "@vltpkg/security-archive": "1.0.1",
+    "@vltpkg/spec": "1.0.1",
+    "@vltpkg/types": "1.0.1",
+    "@vltpkg/url-open": "1.0.1",
+    "@vltpkg/vlt-json": "1.0.1",
+    "@vltpkg/vlx": "1.0.1",
+    "@vltpkg/workspaces": "1.0.1",
+    "@vltpkg/xdg": "1.0.1",
     "ansi-to-pre": "^1.0.6",
+    "beautiful-mermaid": "^1.1.3",
     "chalk": "^5.6.2",
-    "graph-run": "^1.1.0",
-    "hosted-git-info": "^8.1.0",
-    "ink": "^6.2.2",
+    "hosted-git-info": "^9.0.2",
+    "ignore": "^7.0.5",
+    "ink": "^6.5.1",
     "ink-spinner": "^5.0.0",
     "jackspeak": "^4.1.1",
-    "lz-string": "^1.5.0",
-    "minimatch": "^10.0.3",
+    "minimatch": "^10.1.1",
     "package-json-from-dist": "^1.0.1",
-    "path-scurry": "^2.0.0",
+    "path-scurry": "^2.0.1",
     "polite-json": "^5.0.0",
-    "pretty-bytes": "^7.0.1",
-    "react": "^19.1.1",
+    "posthog-node": "^4.0.0",
+    "pretty-bytes": "^7.1.0",
+    "promise-call-limit": "^3.0.2",
+    "react": "^19.2.1",
     "react-devtools-core": "^4.28.5",
-    "react-dom": "^19.1.1",
-    "signal-exit": "^4.1.0",
-    "ssri": "^12.0.0",
-    "supports-color": "^10.2.0",
-    "tar": "^7.4.3",
-    "@vltpkg/config": "1.0.0-rc.8",
-    "@vltpkg/dep-id": "1.0.0-rc.8",
-    "@vltpkg/dot-prop": "1.0.0-rc.8",
-    "@vltpkg/error-cause": "1.0.0-rc.8",
-    "@vltpkg/graph": "1.0.0-rc.8",
-    "@vltpkg/git": "1.0.0-rc.8",
-    "@vltpkg/output": "1.0.0-rc.8",
-    "@vltpkg/package-info": "1.0.0-rc.8",
-    "@vltpkg/init": "1.0.0-rc.8",
-    "@vltpkg/package-json": "1.0.0-rc.8",
-    "@vltpkg/query": "1.0.0-rc.8",
-    "@vltpkg/promise-spawn": "1.0.0-rc.8",
-    "@vltpkg/registry-client": "1.0.0-rc.8",
-    "@vltpkg/rollback-remove": "1.0.0-rc.8",
-    "@vltpkg/server": "1.0.0-rc.8",
-    "@vltpkg/spec": "1.0.0-rc.8",
-    "@vltpkg/security-archive": "1.0.0-rc.8",
-    "@vltpkg/run": "1.0.0-rc.8",
-    "@vltpkg/types": "1.0.0-rc.8",
-    "@vltpkg/url-open": "1.0.0-rc.8",
-    "@vltpkg/vlx": "1.0.0-rc.8",
-    "@vltpkg/workspaces": "1.0.0-rc.8",
-    "@vltpkg/xdg": "1.0.0-rc.8",
-    "@vltpkg/vlt-json": "1.0.0-rc.8"
+    "ssri": "^13.0.0",
+    "supports-color": "^10.2.2",
+    "tar": "^7.5.2"
   },
   "devDependencies": {
-    "@eslint/js": "^9.34.0",
-    "@types/node": "^22.17.2",
-    "@types/react": "^19.1.11",
+    "@eslint/js": "^9.39.1",
+    "@types/node": "^22.19.2",
+    "@types/react": "^18.3.27",
     "@types/ssri": "^7.1.5",
-    "eslint": "^9.34.0",
-    "prettier": "^3.6.2",
-    "tap": "^21.1.0",
-    "tshy": "^3.0.2",
+    "eslint": "^9.39.1",
+    "prettier": "^3.7.4",
+    "tap": "^21.5.0",
     "typedoc": "~0.27.9",
     "typescript": "5.7.3",
-    "typescript-eslint": "^8.40.0"
+    "typescript-eslint": "^8.49.0"
   },
   "license": "BSD-2-Clause-Patent",
   "engines": {
-    "node": ">=22"
+    "node": ">=22.22.0"
+  },
+  "scripts": {
+    "format": "prettier --write . --log-level warn --ignore-path ../../.prettierignore --cache",
+    "format:check": "prettier --check . --ignore-path ../../.prettierignore --cache",
+    "lint": "eslint . --fix",
+    "lint:check": "eslint .",
+    "prepack": "tsc -p tsconfig.publish.json && ../../scripts/update-dist-exports.ts",
+    "snap": "tap",
+    "test": "tap",
+    "posttest": "tsc --noEmit",
+    "typecheck": "tsc --noEmit"
   },
   "tap": {
     "extends": "../../tap-config.yaml"
   },
   "prettier": "../../.prettierrc.js",
-  "module": "./dist/esm/index.js",
+  "module": "./dist/index.js",
   "type": "module",
   "exports": {
     "./package.json": "./package.json",
     ".": {
       "import": {
-        "types": "./dist/esm/index.d.ts",
-        "default": "./dist/esm/index.js"
+        "default": "./dist/index.js"
       }
     },
     "./config": {
       "import": {
-        "types": "./dist/esm/config/index.d.ts",
-        "default": "./dist/esm/config/index.js"
+        "default": "./dist/config/index.js"
       }
     },
     "./definition": {
       "import": {
-        "types": "./dist/esm/config/definition.d.ts",
-        "default": "./dist/esm/config/definition.js"
+        "default": "./dist/config/definition.js"
       }
     },
     "./view": {
       "import": {
-        "types": "./dist/esm/view.d.ts",
-        "default": "./dist/esm/view.js"
+        "default": "./dist/view.js"
       }
     }
   },
@@ -124,15 +121,11 @@
   "keywords": [
     "vltpkg"
   ],
-  "scripts": {
-    "format": "prettier --write . --log-level warn --ignore-path ../../.prettierignore --cache",
-    "format:check": "prettier --check . --ignore-path ../../.prettierignore --cache",
-    "lint": "eslint . --fix",
-    "lint:check": "eslint .",
-    "snap": "tap",
-    "test": "tap",
-    "posttest": "tsc --noEmit",
-    "tshy": "tshy",
-    "typecheck": "tsc --noEmit"
-  }
-}
+  "bugs": [
+    {
+      "type": "link",
+      "url": "https://github.com/vltpkg/vltpkg/issues"
+    }
+  ],
+  "homepage": "https://github.com/vltpkg/vltpkg/tree/main/src/cli-sdk#readme"
+}

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

@@ -1 +0,0 @@
-{"version":3,"file":"bugs.d.ts","sourceRoot":"","sources":["../../../src/commands/bugs.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAQ1D,eAAO,MAAM,KAAK,EAAE,YA2BhB,CAAA;AAEJ,KAAK,mBAAmB,GAAG;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,KAAK,qBAAqB,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;CACb,EAAE,CAAA;AAEH,MAAM,MAAM,aAAa,GACrB,mBAAmB,GACnB,qBAAqB,CAAA;AAEzB,eAAO,MAAM,KAAK;;;CAUuB,CAAA;AAkDzC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,aAAa,CA4F5C,CAAA"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"bugs.js","sourceRoot":"","sources":["../../../src/commands/bugs.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 as {\n  fromUrl: (url: string) => { bugs?: () => string } | null\n}\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'bugs',\n    usage: ['[<spec>]', '[--target=<query>]'],\n    description: `Open bug tracker for a package in a web browser.\n                  Reads bug tracker 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 bugs for the current package (reads local package.json)',\n      },\n      'abbrev@2.0.0': {\n        description: 'Open bugs for a specific package version',\n      },\n      '--target=\":root > *\"': {\n        description:\n          'List bug tracker 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 bug trackers 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, bugs, repository } = manifest\n\n  if (!name) {\n    throw error('No package name found')\n  }\n\n  let url: string | undefined\n\n  // Check bugs field first\n  if (bugs) {\n    if (typeof bugs === 'string') {\n      url = bugs\n    } else if (typeof bugs === 'object') {\n      if ('url' in bugs && bugs.url) {\n        url = bugs.url\n      } else if ('email' in bugs && bugs.email) {\n        url = `mailto:${bugs.email}`\n      }\n    }\n  }\n\n  // Try repository if no bugs field\n  if (!url && 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      const info = hostedGitInfoFromUrl(repoUrl.replace(/^git\\+/, ''))\n      if (info?.bugs && typeof info.bugs === 'function') {\n        url = info.bugs()\n      }\n    }\n  }\n\n  // Fallback to vlt.io package page\n  if (!url) {\n    url = `https://vlt.io/explore/npm/${name}/overview`\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/build.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/commands/build.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAQ,MAAM,eAAe,CAAA;AAGtD,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1D,eAAO,MAAM,KAAK;6BACA,WAAW,KAAG,MAAM;4BAqBrB,WAAW;;;;;;;;;;;;;CAqBW,CAAA;AAEvC,eAAO,MAAM,KAAK,EAAE,YAsBhB,CAAA;AAWJ;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,WAAW,CAqC1C,CAAA"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"build.js","sourceRoot":"","sources":["../../../src/commands/build.ts"],"names":[],"mappings":"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","sourcesContent":["import { build } from '@vltpkg/graph'\nimport type { BuildResult, Node } from '@vltpkg/graph'\nimport { error } from '@vltpkg/error-cause'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport type { Views } from '../view.ts'\nimport { isErrorWithCause } from '@vltpkg/types'\n\nexport const views = {\n  human: (result: BuildResult): string => {\n    const successCount = result.success.length\n    const failureCount = result.failure.length\n    const messages: string[] = []\n\n    if (successCount > 0) {\n      messages.push(\n        `🔨 Built ${successCount} package${successCount === 1 ? '' : 's'} successfully.`,\n      )\n    } else {\n      messages.push('📦 All packages are already built.')\n    }\n\n    if (failureCount > 0) {\n      messages.push(\n        `🔎 ${failureCount} optional package${/* c8 ignore next */ failureCount === 1 ? '' : 's'} failed to build.`,\n      )\n    }\n\n    return messages.join('\\n')\n  },\n  json: (result: BuildResult) => {\n    const successList = result.success.map(node => ({\n      id: node.id,\n      name: node.name,\n      version: node.version,\n    }))\n    const failureList = result.failure.map(node => ({\n      id: node.id,\n      name: node.name,\n      version: node.version,\n    }))\n\n    return {\n      success: successList,\n      failure: failureList,\n      message:\n        successList.length > 0 ?\n          `Built ${successList.length} package${successList.length === 1 ? '' : 's'}.`\n        : 'No packages needed building.',\n    }\n  },\n} as const satisfies Views<BuildResult>\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'build',\n    usage: ['[query]', '[--target=<query>]'],\n    description: `Build the project based on the current dependency graph.\n\n    This command processes the installed packages in node_modules and runs\n    any necessary build steps, such as lifecycle scripts and binary linking.\n    \n    The build process is idempotent and will only perform work that is\n    actually needed based on the current state of the dependency graph.\n    \n    Use --target option or provide a query as a positional argument to filter\n    packages using DSS query language syntax, otherwise it will target\n    all packages with scripts (:scripts) by default.`,\n    options: {\n      target: {\n        value: '<query>',\n        description:\n          'Query selector to filter packages using DSS syntax.',\n      },\n    },\n  })\n\nconst isGraphRunError = (\n  error: unknown,\n): error is Error & { code: string; node: Node } =>\n  typeof error === 'object' &&\n  error !== null &&\n  'code' in error &&\n  error.code === 'GRAPHRUN_TRAVERSAL' &&\n  'node' in error\n\n/**\n * Build command implementation. Runs any required \"postinstall\"\n * lifecycle scripts and binary linking.\n */\nexport const command: CommandFn<BuildResult> = async conf => {\n  const { options, projectRoot } = conf\n\n  try {\n    // Get target from option or first positional, default to all scripts\n    const targetOption = conf.get('target')\n    const targetPositional = conf.positionals[0]\n    const target =\n      targetOption ||\n      targetPositional ||\n      ':scripts:not(:built):not(:malware)'\n\n    // Run the build process using the graph build function\n    const result = await build({\n      ...options,\n      projectRoot,\n      packageJson: options.packageJson,\n      monorepo: options.monorepo,\n      scurry: options.scurry,\n      target,\n    })\n\n    return result\n  } catch (cause) {\n    const graphRunError =\n      isErrorWithCause(cause) && isGraphRunError(cause.cause) ?\n        cause.cause\n      : undefined\n    if (graphRunError?.code === 'GRAPHRUN_TRAVERSAL') {\n      throw error(\n        'Build failed:\\n  Failed to build package: ' +\n          `${graphRunError.node.name}@${graphRunError.node.version}`,\n        { cause },\n      )\n    }\n    throw error('Build failed', { cause })\n  }\n}\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/commands/cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAIpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAGtD,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEtC,MAAM,MAAM,QAAQ,GAAG,MAAM,CAC3B,MAAM,EACN,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CACjC,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,QAAQ,CAAC,CAAC,aAAa,CAAC,CAAA;AAGrE,qBAAa,SAAU,SAAQ,SAAS;gBAC1B,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY;IAIpD,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;CAG1B;AAED,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,IAAI,GAAG,QAAQ,CAExC,CAAA;AAED,QAAA,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoE6B,CAAA;AAE3C,eAAO,MAAM,KAAK,EAAE,YAA2C,CAAA;AAE/D,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,IAAI,GAAG,QAAQ,CAgC9C,CAAA"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/commands/cache.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport { CacheEntry } from '@vltpkg/registry-client'\nimport { Spec } from '@vltpkg/spec'\nimport { mkdir, rm } from 'node:fs/promises'\nimport prettyBytes from 'pretty-bytes'\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 { stderr, stdout } from '../output.ts'\nimport type { ViewOptions, Views } from '../view.ts'\nimport { ViewClass } from '../view.ts'\n\nexport type CacheMap = Record<\n  string,\n  ReturnType<CacheEntry['toJSON']>\n>\n\nexport type CacheSubcommands = keyof (typeof usageDef)['subcommands']\n\nlet view: CacheView\nexport class CacheView 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 | CacheMap> = {\n  human: CacheView,\n}\n\nconst usageDef = {\n  command: 'cache',\n  usage: '<command> [flags]',\n  description: 'Work with vlt cache folders',\n\n  subcommands: {\n    add: {\n      usage: '<package-spec> [<package-spec>...]',\n      description: `Resolve the referenced package identifiers and ensure they\n                    are cached.`,\n    },\n\n    ls: {\n      usage: '[<key>...]',\n      description: `Show cache entries. If no keys are provided, then a list of\n                    available keys will be printed. If one or more keys are\n                    provided, then details will be shown for the specified\n                    items.`,\n    },\n\n    info: {\n      usage: '<key>',\n      description: `Print metadata details for the specified cache key to\n                    stderr, and the response body to stdout.`,\n    },\n\n    clean: {\n      usage: '[<key>...]',\n      description: `Purge expired cache entries. If one or more keys are\n                    provided, then only those cache entries will be\n                    considered.`,\n    },\n\n    delete: {\n      usage: '<key> [<key>...]',\n      description: `Purge items explicitly, whether expired or not.  If one or\n                    more keys are provided, then only those cache entries will\n                    be considered.`,\n    },\n\n    'delete-before': {\n      usage: '<date>',\n      description: `Purge all cache items from before a given date. Date can be\n                    provided in any format that JavaScript can parse.`,\n    },\n\n    'delete-all': {\n      usage: '',\n      description: `Delete the entire cache folder to make vlt slower.`,\n    },\n  },\n  examples: {\n    'vlt cache ls https://registry.npmjs.org/typescript': {\n      description: `Show cache metadata for a given registry URL`,\n    },\n    'vlt cache add eslint@latest': {\n      description: `Add a given package specifier to the cache by fetching\n                    its resolved value.`,\n    },\n    'vlt cache info https://registry.npmjs.org/eslint/-/eslint-9.25.1.tgz > eslint.tgz':\n      {\n        description: `Print the cache metadata to stderr, and write the tarball\n                    on stdout, redirecting to a file.`,\n      },\n    'vlt cache delete-before 2025-01-01': {\n      description: 'Delete all entries created before Jan 1, 2025',\n    },\n  },\n} as const satisfies CommandUsageDefinition\n\nexport const usage: CommandUsage = () => commandUsage(usageDef)\n\nexport const command: CommandFn<void | CacheMap> = 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 'add':\n      return add(conf, args, view)\n\n    case 'clean':\n      return clean(conf, args, view)\n\n    case 'delete':\n      return deleteKeys(conf, args, view)\n\n    case 'delete-before':\n      return deleteBefore(conf, args, view)\n\n    case 'delete-all':\n      return deleteAll(conf, args, view)\n\n    default: {\n      throw error('Unrecognized cache command', {\n        code: 'EUSAGE',\n        found: sub,\n        validOptions: Object.keys(usageDef.subcommands),\n      })\n    }\n  }\n}\n\nconst ls = async (\n  conf: LoadedConfig,\n  keys: string[],\n  view?: CacheView,\n): Promise<CacheMap> =>\n  keys.length ?\n    await fetchKeys(\n      conf,\n      keys,\n      (entry: CacheEntry, key: string) => {\n        view?.stdout(\n          key.includes(' ') ? JSON.stringify(key) : key,\n          entry,\n        )\n        return true\n      },\n      view,\n    )\n  : await fetchAll(conf, (_, key) => {\n      view?.stdout(key.includes(' ') ? JSON.stringify(key) : key)\n      return true\n    })\n\nconst info = async (\n  conf: LoadedConfig,\n  keys: string[],\n  view?: CacheView,\n): Promise<void> => {\n  const [key] = keys\n  if (keys.length !== 1 || !key) {\n    throw error('Must provide exactly one cache key', {\n      code: 'EUSAGE',\n    })\n  }\n  await fetchKeys(\n    conf,\n    [key],\n    (entry: CacheEntry, key: string) => {\n      stderr(\n        /* c8 ignore next */\n        key.includes(' ') ? JSON.stringify(key) : key,\n        entry,\n      )\n      if (entry.isJSON) {\n        stdout(JSON.stringify(entry.body, null, 2))\n        /* c8 ignore start - annoying to test, corrupts TAP output */\n      } else {\n        process.stdout.write(entry.body as Buffer)\n      }\n      /* c8 ignore stop */\n      return true\n    },\n    view,\n  )\n}\n\nconst fetchAll = async (\n  conf: LoadedConfig,\n  test: (entry: CacheEntry, key: string, val: Buffer) => boolean,\n) => {\n  const rc = conf.options.packageInfo.registryClient\n  const { cache } = rc\n  const map: CacheMap = {}\n  for await (const [key, val] of cache) {\n    const entry = CacheEntry.decode(val)\n    if (!test(entry, key, val)) continue\n    map[key] = entry.toJSON()\n  }\n  return map\n}\n\nconst fetchKeys = async (\n  conf: LoadedConfig,\n  keys: string[],\n  test: (entry: CacheEntry, key: string, buf: Buffer) => boolean,\n  view?: CacheView,\n) => {\n  const rc = conf.options.packageInfo.registryClient\n  const { cache } = rc\n  const map: CacheMap = {}\n  const results: [string, Buffer | undefined][] = await Promise.all(\n    keys.map(async key => {\n      return [key, await cache.fetch(key)]\n    }),\n  )\n  for (const [key, val] of results) {\n    if (!val) {\n      view?.stdout('Not found:', key)\n    } else {\n      const entry = CacheEntry.decode(val)\n      if (!test(entry, key, val)) continue\n      map[key] = entry.toJSON()\n    }\n  }\n\n  return map\n}\n\nconst deleteEntries = async (\n  conf: LoadedConfig,\n  keys: string[],\n  test: (entry: CacheEntry) => boolean,\n  view?: CacheView,\n) => {\n  const rc = conf.options.packageInfo.registryClient\n  const { cache } = rc\n\n  let count = 0\n  let size = 0\n  const testAction = (\n    entry: CacheEntry,\n    key: string,\n    val: Buffer,\n  ) => {\n    if (!test(entry)) {\n      return false\n    }\n    count++\n    const s = val.byteLength + key.length\n    cache.delete(key, true, entry.integrity)\n    const k = key.includes(' ') ? JSON.stringify(key) : key\n    view?.stdout('-', k, s)\n    size += s\n    return true\n  }\n\n  const map = await (keys.length ?\n    fetchKeys(conf, keys, testAction, view)\n  : fetchAll(conf, testAction))\n\n  const pb = prettyBytes(size, { binary: true })\n\n  const s = count === 1 ? '' : 's'\n  await cache.promise()\n  view?.stdout(`Removed ${count} item${s} totalling ${pb}`)\n  return map\n}\n\nconst clean = async (\n  conf: LoadedConfig,\n  keys: string[],\n  view?: CacheView,\n) => deleteEntries(conf, keys, entry => !entry.valid, view)\n\nconst deleteBefore = async (\n  conf: LoadedConfig,\n  args: string[],\n  view?: CacheView,\n) => {\n  if (!args.length) {\n    throw error('Must provide a date to delete before', {\n      code: 'EUSAGE',\n    })\n  }\n  const now = new Date()\n  const before = new Date(args.join(' '))\n  if (before >= now) {\n    throw error('Cannot delete cache entries from the future', {\n      code: 'EUSAGE',\n      found: before,\n    })\n  }\n  return deleteEntries(\n    conf,\n    [],\n    entry => !!entry.date && entry.date < before,\n    view,\n  )\n}\n\nconst deleteKeys = async (\n  conf: LoadedConfig,\n  keys: string[],\n  view?: CacheView,\n) => {\n  if (!keys.length) {\n    throw error('Must provide cache keys to delete', {\n      code: 'EUSAGE',\n    })\n  }\n  return deleteEntries(conf, keys, () => true, view)\n}\n\nconst deleteAll = async (\n  conf: LoadedConfig,\n  _: string[],\n  view?: CacheView,\n) => {\n  const { cache } = conf.options.packageInfo.registryClient\n  await rm(cache.path(), { recursive: true, force: true })\n  await mkdir(cache.path(), { recursive: true })\n  view?.stdout('Deleted all cache entries.')\n}\n\nconst add = async (\n  conf: LoadedConfig,\n  specs: string[],\n  view?: CacheView,\n) => {\n  if (!specs.length) {\n    throw error('Must provide specs to add to the cache', {\n      code: 'EUSAGE',\n    })\n  }\n  const { packageInfo } = conf.options\n  const promises: Promise<void>[] = []\n\n  for (const spec of specs) {\n    const p = packageInfo\n      .resolve(Spec.parseArgs(spec, conf.options), {\n        staleWhileRevalidate: false,\n      })\n      .then(async r => {\n        const { resolved, integrity } = r\n        await packageInfo.registryClient.request(resolved, {\n          ...conf.options,\n          integrity,\n          staleWhileRevalidate: false,\n          query: undefined,\n        })\n        view?.stdout('+', spec, r.resolved)\n      })\n\n    promises.push(p)\n  }\n\n  await Promise.all(promises)\n}\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"ci.d.ts","sourceRoot":"","sources":["../../../src/commands/ci.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAA;AAExD,eAAO,MAAM,KAAK,EAAE,YAWhB,CAAA;AAEJ,eAAO,MAAM,KAAK;;;CAGkB,CAAA;AAEpC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,QAAQ,CAavC,CAAA"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"ci.js","sourceRoot":"","sources":["../../../src/commands/ci.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAOvD,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,EAAE;IACT,WAAW,EAAE;;;kEAGiD;IAC9D,QAAQ,EAAE;QACR,EAAE,EAAE,EAAE,WAAW,EAAE,6BAA6B,EAAE;KACnD;CACF,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE;IAC3B,KAAK,EAAE,eAAe;CACY,CAAA;AAEpC,MAAM,CAAC,MAAM,OAAO,GAAwB,KAAK,EAAC,IAAI,EAAC,EAAE;IACvD,MAAM,SAAS,GAAG;QAChB,GAAG,IAAI,CAAC,OAAO;QACf,sEAAsE;QACtE,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,GAAG;QAC9C,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,IAAI;QACpB,YAAY,EAAE,IAAI;QAClB,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC;KAC5C,CAAA;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAA;IAC1C,OAAO,EAAE,KAAK,EAAE,CAAA;AAClB,CAAC,CAAA","sourcesContent":["import { install } from '@vltpkg/graph'\nimport { commandUsage } from '../config/usage.ts'\nimport { InstallReporter } from './install/reporter.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport type { Views } from '../view.ts'\nimport type { InstallResult } from './install.ts'\n\nexport type CIResult = Omit<InstallResult, 'buildQueue'>\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'ci',\n    usage: '',\n    description: `Clean install from lockfile. Deletes node_modules and installs \n                  dependencies exactly as specified in vlt-lock.json. This is \n                  similar to running 'vlt install --expect-lockfile' but performs \n                  a clean install by removing node_modules first.`,\n    examples: {\n      '': { description: 'Clean install from lockfile' },\n    },\n  })\n\nexport const views = {\n  json: i => i.graph.toJSON(),\n  human: InstallReporter,\n} as const satisfies Views<CIResult>\n\nexport const command: CommandFn<CIResult> = async conf => {\n  const ciOptions = {\n    ...conf.options,\n    // allow all scripts by default on ci (unless user specifies a filter)\n    allowScripts: conf.get('allow-scripts') ?? '*',\n    expectLockfile: true,\n    frozenLockfile: true,\n    cleanInstall: true,\n    lockfileOnly: conf.options['lockfile-only'],\n  }\n\n  const { graph } = await install(ciOptions)\n  return { graph }\n}\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/commands/config.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAKvC,eAAO,MAAM,KAAK,EAAE,KAUM,CAAA;AAE1B,eAAO,MAAM,KAAK,EAAE,YAwDhB,CAAA;AAEJ,eAAO,MAAM,OAAO,EAAE,SA8DrB,CAAA"}