@vltpkg/output 0.0.0-3 → 0.0.0-31

package/dist/esm/error.d.ts

@@ -0,0 +1,28 @@
+export type ErrorCause = Record<string, unknown> & {
+    cause?: ErrorCause;
+};
+export type ParsedError = {
+    name: string;
+    message: string;
+    stack?: string;
+    cause?: ErrorCause | ParsedError;
+    [key: string]: unknown;
+};
+/**
+ * Parse an unknown value into an error. Will also take enumerable properties
+ * from legacy style Node errors and treat them as the cause.
+ */
+export declare const parseError: (err: unknown) => null | ParsedError;
+/**
+ * Find the root error from an unknown value, optionally matching a code.
+ */
+export declare const findRootError: (v: unknown, match?: {
+    code?: string;
+}) => ParsedError | null;
+/**
+ * Find the root error from an unknown value and throw if one is not found.
+ */
+export declare const asRootError: (v: unknown, match?: {
+    code?: string;
+}) => Omit<ParsedError, "cause"> & Required<Pick<ParsedError, "cause">>;
+//# sourceMappingURL=error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/error.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACjD,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,UAAU,GAAG,WAAW,CAAA;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,QAAS,OAAO,KAAG,IAAI,GAAG,WAsBhD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,MACrB,OAAO,UACF;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,KACxB,WAAW,GAAG,IAKhB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,MACnB,OAAO,UACF;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,KACxB,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,GAC3B,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAMpC,CAAA"}

package/dist/esm/error.js

@@ -0,0 +1,46 @@
+import { isError, isObject } from '@vltpkg/types';
+/**
+ * Parse an unknown value into an error. Will also take enumerable properties
+ * from legacy style Node errors and treat them as the cause.
+ */
+export const parseError = (err) => {
+    if (!isError(err)) {
+        return null;
+    }
+    // Assume that if the error has enumerable properties, then
+    // it is a legacy error and does not also have a cause.
+    const enumerable = Object.fromEntries(Object.entries(err));
+    if (Object.keys(enumerable).length) {
+        err.cause = enumerable;
+        return err;
+    }
+    if (isObject(err.cause)) {
+        if (isError(err.cause.cause)) {
+            err.cause.cause = parseError(err.cause.cause);
+        }
+    }
+    else if (isError(err.cause)) {
+        err.cause = parseError(err.cause);
+    }
+    return err;
+};
+/**
+ * Find the root error from an unknown value, optionally matching a code.
+ */
+export const findRootError = (v, match) => {
+    const err = parseError(v);
+    return !err || (match?.code && err.cause?.code !== match.code) ?
+        null
+        : err;
+};
+/**
+ * Find the root error from an unknown value and throw if one is not found.
+ */
+export const asRootError = (v, match) => {
+    const err = findRootError(v, match);
+    if (!err)
+        throw v;
+    err.cause = err.cause ?? {};
+    return err;
+};
+//# sourceMappingURL=error.js.map

package/dist/esm/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAcjD;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAY,EAAsB,EAAE;IAC7D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAClB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,2DAA2D;IAC3D,uDAAuD;IACvD,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAA;IAC1D,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,CAAC;QACnC,GAAG,CAAC,KAAK,GAAG,UAAU,CAAA;QACtB,OAAO,GAAkB,CAAA;IAC3B,CAAC;IAED,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QAC/C,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,GAAG,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACnC,CAAC;IAED,OAAO,GAAkB,CAAA;AAC3B,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,CAAU,EACV,KAAyB,EACL,EAAE;IACtB,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;IACzB,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5D,IAAI;QACN,CAAC,CAAC,GAAG,CAAA;AACT,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,CAAU,EACV,KAAyB,EAEY,EAAE;IACvC,MAAM,GAAG,GAAG,aAAa,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;IACnC,IAAI,CAAC,GAAG;QAAE,MAAM,CAAC,CAAA;IACjB,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,EAAE,CAAA;IAC3B,OAAO,GAC+B,CAAA;AACxC,CAAC,CAAA","sourcesContent":["import { isError, isObject } from '@vltpkg/types'\n\nexport type ErrorCause = Record<string, unknown> & {\n  cause?: ErrorCause\n}\n\nexport type ParsedError = {\n  name: string\n  message: string\n  stack?: string\n  cause?: ErrorCause | ParsedError\n  [key: string]: unknown\n}\n\n/**\n * Parse an unknown value into an error. Will also take enumerable properties\n * from legacy style Node errors and treat them as the cause.\n */\nexport const parseError = (err: unknown): null | ParsedError => {\n  if (!isError(err)) {\n    return null\n  }\n\n  // Assume that if the error has enumerable properties, then\n  // it is a legacy error and does not also have a cause.\n  const enumerable = Object.fromEntries(Object.entries(err))\n  if (Object.keys(enumerable).length) {\n    err.cause = enumerable\n    return err as ParsedError\n  }\n\n  if (isObject(err.cause)) {\n    if (isError(err.cause.cause)) {\n      err.cause.cause = parseError(err.cause.cause)\n    }\n  } else if (isError(err.cause)) {\n    err.cause = parseError(err.cause)\n  }\n\n  return err as ParsedError\n}\n\n/**\n * Find the root error from an unknown value, optionally matching a code.\n */\nexport const findRootError = (\n  v: unknown,\n  match?: { code?: string },\n): ParsedError | null => {\n  const err = parseError(v)\n  return !err || (match?.code && err.cause?.code !== match.code) ?\n      null\n    : err\n}\n\n/**\n * Find the root error from an unknown value and throw if one is not found.\n */\nexport const asRootError = (\n  v: unknown,\n  match?: { code?: string },\n): Omit<ParsedError, 'cause'> &\n  Required<Pick<ParsedError, 'cause'>> => {\n  const err = findRootError(v, match)\n  if (!err) throw v\n  err.cause = err.cause ?? {}\n  return err as Omit<ParsedError, 'cause'> &\n    Required<Pick<ParsedError, 'cause'>>\n}\n"]}

package/dist/esm/index.d.ts

@@ -1,7 +1,7 @@
 export type Events = {
     request: {
         url: URL | string;
-        state: 'start' | 'complete' | '304' | 'cache';
+        state: 'start' | 'complete' | '304' | 'cache' | 'stale';
     };
     graphStep: {
         step: 'build' | 'actual' | 'reify';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,MAAM,GAAG;IACnB,OAAO,EAAE;QACP,GAAG,EAAE,GAAG,GAAG,MAAM,CAAA;QACjB,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,KAAK,GAAG,OAAO,CAAA;KAC9C,CAAA;IACD,SAAS,EAAE;QACT,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAA;QAClC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAA;KACxB,CAAA;CACF,CAAA;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAqB;IAEpC,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAI7D,EAAE,CAAC,CAAC,SAAS,MAAM,MAAM,EACvB,SAAS,EAAE,CAAC,EACZ,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI;IAKvC,GAAG,CAAC,CAAC,SAAS,MAAM,MAAM,EACxB,SAAS,EAAE,CAAC,EACZ,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI;CAIxC;AAID,eAAO,MAAM,OAAO,eAAsB,CAAA;AAE1C,eAAO,MAAM,UAAU,QAChB,GAAG,GAAG,MAAM,SACV,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,SAGlC,CAAA;AAED,eAAO,MAAM,SAAS,SAAU,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,eAG1D,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,MAAM,GAAG;IACnB,OAAO,EAAE;QACP,GAAG,EAAE,GAAG,GAAG,MAAM,CAAA;QACjB,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,CAAA;KACxD,CAAA;IACD,SAAS,EAAE;QACT,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAA;QAClC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAA;KACxB,CAAA;CACF,CAAA;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAqB;IAEpC,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAI7D,EAAE,CAAC,CAAC,SAAS,MAAM,MAAM,EACvB,SAAS,EAAE,CAAC,EACZ,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI;IAKvC,GAAG,CAAC,CAAC,SAAS,MAAM,MAAM,EACxB,SAAS,EAAE,CAAC,EACZ,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI;CAIxC;AAID,eAAO,MAAM,OAAO,eAAsB,CAAA;AAE1C,eAAO,MAAM,UAAU,QAChB,GAAG,GAAG,MAAM,SACV,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,SAGlC,CAAA;AAED,eAAO,MAAM,SAAS,SAAU,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,eAG1D,CAAA"}

package/dist/esm/index.js

@@ -1,4 +1,4 @@
-import EventEmitter from 'events';
+import EventEmitter from 'node:events';
 export class OutputEmitter {
     emitter = new EventEmitter();
     emit(eventName, payload) {

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,QAAQ,CAAA;AAajC,MAAM,OAAO,aAAa;IAChB,OAAO,GAAG,IAAI,YAAY,EAAE,CAAA;IAEpC,IAAI,CAAyB,SAAY,EAAE,OAAkB;QAC3D,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IACvC,CAAC;IAED,EAAE,CACA,SAAY,EACZ,OAAqC;QAErC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IACrC,CAAC;IAED,GAAG,CACD,SAAY,EACZ,OAAqC;QAErC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IACtC,CAAC;CACF;AAED,+CAA+C;AAC/C,6DAA6D;AAC7D,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAA;AAE1C,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,GAAiB,EACjB,KAAiC,EACjC,EAAE;IACF,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAA;AACzC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAiC,EAAE,EAAE;IAC7D,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;IACnD,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;AACjE,CAAC,CAAA","sourcesContent":["import EventEmitter from 'events'\n\nexport type Events = {\n  request: {\n    url: URL | string\n    state: 'start' | 'complete' | '304' | 'cache'\n  }\n  graphStep: {\n    step: 'build' | 'actual' | 'reify'\n    state: 'start' | 'stop'\n  }\n}\n\nexport class OutputEmitter {\n  private emitter = new EventEmitter()\n\n  emit<T extends keyof Events>(eventName: T, payload: Events[T]) {\n    this.emitter.emit(eventName, payload)\n  }\n\n  on<T extends keyof Events>(\n    eventName: T,\n    handler: (payload: Events[T]) => void,\n  ) {\n    this.emitter.on(eventName, handler)\n  }\n\n  off<T extends keyof Events>(\n    eventName: T,\n    handler: (payload: Events[T]) => void,\n  ) {\n    this.emitter.off(eventName, handler)\n  }\n}\n\n// Exported event emitter to coordinate events.\n// There must be one version of output across the entire CLI.\nexport const emitter = new OutputEmitter()\n\nexport const logRequest = (\n  url: URL | string,\n  state: Events['request']['state'],\n) => {\n  emitter.emit('request', { url, state })\n}\n\nexport const graphStep = (step: Events['graphStep']['step']) => {\n  emitter.emit('graphStep', { step, state: 'start' })\n  return () => emitter.emit('graphStep', { step, state: 'stop' })\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,aAAa,CAAA;AAatC,MAAM,OAAO,aAAa;IAChB,OAAO,GAAG,IAAI,YAAY,EAAE,CAAA;IAEpC,IAAI,CAAyB,SAAY,EAAE,OAAkB;QAC3D,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IACvC,CAAC;IAED,EAAE,CACA,SAAY,EACZ,OAAqC;QAErC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IACrC,CAAC;IAED,GAAG,CACD,SAAY,EACZ,OAAqC;QAErC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IACtC,CAAC;CACF;AAED,+CAA+C;AAC/C,6DAA6D;AAC7D,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAA;AAE1C,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,GAAiB,EACjB,KAAiC,EACjC,EAAE;IACF,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAA;AACzC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAiC,EAAE,EAAE;IAC7D,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;IACnD,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;AACjE,CAAC,CAAA","sourcesContent":["import EventEmitter from 'node:events'\n\nexport type Events = {\n  request: {\n    url: URL | string\n    state: 'start' | 'complete' | '304' | 'cache' | 'stale'\n  }\n  graphStep: {\n    step: 'build' | 'actual' | 'reify'\n    state: 'start' | 'stop'\n  }\n}\n\nexport class OutputEmitter {\n  private emitter = new EventEmitter()\n\n  emit<T extends keyof Events>(eventName: T, payload: Events[T]) {\n    this.emitter.emit(eventName, payload)\n  }\n\n  on<T extends keyof Events>(\n    eventName: T,\n    handler: (payload: Events[T]) => void,\n  ) {\n    this.emitter.on(eventName, handler)\n  }\n\n  off<T extends keyof Events>(\n    eventName: T,\n    handler: (payload: Events[T]) => void,\n  ) {\n    this.emitter.off(eventName, handler)\n  }\n}\n\n// Exported event emitter to coordinate events.\n// There must be one version of output across the entire CLI.\nexport const emitter = new OutputEmitter()\n\nexport const logRequest = (\n  url: URL | string,\n  state: Events['request']['state'],\n) => {\n  emitter.emit('request', { url, state })\n}\n\nexport const graphStep = (step: Events['graphStep']['step']) => {\n  emitter.emit('graphStep', { step, state: 'start' })\n  return () => emitter.emit('graphStep', { step, state: 'stop' })\n}\n"]}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@vltpkg/output",
   "description": "Generate output from the vlt CLI",
-  "version": "0.0.0-3",
+  "version": "0.0.0-31",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/vltpkg/vltpkg.git",
     "directory": "src/output"
   },
+  "author": "vlt technology inc. <support@vlt.sh> (http://vlt.sh)",
   "tshy": {
     "selfLink": false,
     "liveDev": true,
@@ -15,20 +16,23 @@
     ],
     "exports": {
       "./package.json": "./package.json",
-      ".": "./src/index.ts"
+      ".": "./src/index.ts",
+      "./error": "./src/error.ts"
     }
   },
+  "dependencies": {
+    "@vltpkg/types": "0.0.0-31"
+  },
   "devDependencies": {
-    "@eslint/js": "^9.20.0",
-    "@types/eslint__js": "^8.42.3",
-    "@types/node": "^22.13.1",
-    "eslint": "^9.20.0",
-    "prettier": "^3.4.2",
+    "@eslint/js": "^9.34.0",
+    "@types/node": "^22.17.2",
+    "eslint": "^9.34.0",
+    "prettier": "^3.6.2",
     "tap": "^21.1.0",
     "tshy": "^3.0.2",
-    "typedoc": "0.27.6",
+    "typedoc": "~0.27.9",
     "typescript": "5.7.3",
-    "typescript-eslint": "^8.23.0"
+    "typescript-eslint": "^8.40.0"
   },
   "license": "BSD-2-Clause-Patent",
   "engines": {
@@ -47,6 +51,12 @@
         "types": "./dist/esm/index.d.ts",
         "default": "./dist/esm/index.js"
       }
+    },
+    "./error": {
+      "import": {
+        "types": "./dist/esm/error.d.ts",
+        "default": "./dist/esm/error.js"
+      }
     }
   },
   "files": [
@@ -60,6 +70,7 @@
     "snap": "tap",
     "test": "tap",
     "posttest": "tsc --noEmit",
+    "tshy": "tshy",
     "typecheck": "tsc --noEmit"
   }
 }