@socketsecurity/cli-with-sentry 1.1.14 → 1.1.17

package/external/@socketsecurity/registry/lib/logger.js

@@ -7,6 +7,12 @@ const { apply: ReflectApply, construct: ReflectConstruct } = Reflect
 const { applyLinePrefix, isBlankString } = /*@__PURE__*/ require('./strings')
 
 let _Console
+/**
+ * Construct a new Console instance.
+ * @param {...any} args - Arguments to pass to the Console constructor.
+ * @returns {Console} A new Console instance.
+ * @private
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function constructConsole(...args) {
   if (_Console === undefined) {
@@ -19,6 +25,11 @@ function constructConsole(...args) {
 }
 
 let _yoctocolors
+/**
+ * Get the yoctocolors module for terminal colors.
+ * @returns {Object} The yoctocolors module.
+ * @private
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function getYoctocolors() {
   if (_yoctocolors === undefined) {
@@ -109,6 +120,10 @@ const kGroupIndentationWidthSymbol =
   Symbol('kGroupIndentWidth')
 const lastWasBlankSymbol = Symbol.for('logger.lastWasBlank')
 
+/**
+ * Custom Logger class that wraps console with additional features.
+ * Supports indentation, symbols, and blank line tracking.
+ */
 /*@__PURE__*/
 class Logger {
   static LOG_SYMBOLS = LOG_SYMBOLS
@@ -134,6 +149,13 @@ class Logger {
     }
   }
 
+  /**
+   * Apply a console method with indentation.
+   * @param {string} methodName - Name of the console method to call.
+   * @param {any[]} args - Arguments to pass to the method.
+   * @returns {Logger} This Logger instance for chaining.
+   * @private
+   */
   #apply(methodName, args) {
     const con = privateConsole.get(this)
     const text = args.at(0)
@@ -147,6 +169,13 @@ class Logger {
     return this
   }
 
+  /**
+   * Apply a method with a symbol prefix.
+   * @param {string} symbolType - Type of symbol to use (fail, info, success, warn).
+   * @param {any[]} args - Arguments to pass to the method.
+   * @returns {Logger} This Logger instance for chaining.
+   * @private
+   */
   #symbolApply(symbolType, args) {
     const con = privateConsole.get(this)
     let text = args.at(0)
@@ -167,20 +196,39 @@ class Logger {
     return this
   }
 
+  /**
+   * Get the current log call count.
+   * @returns {number} The number of log calls made.
+   */
   get logCallCount() {
     return this.#logCallCount
   }
 
+  /**
+   * Increment the log call count.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   [incLogCallCountSymbol]() {
     this.#logCallCount += 1
     return this
   }
 
+  /**
+   * Set whether the last logged line was blank.
+   * @param {boolean} value - Whether the last line was blank.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   [lastWasBlankSymbol](value) {
     this.#lastWasBlank = !!value
     return this
   }
 
+  /**
+   * Log an assertion.
+   * @param {any} value - Value to assert.
+   * @param {...any} message - Message to log if assertion fails.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   assert(value, ...message) {
     const con = privateConsole.get(this)
     con.assert(value, ...message)
@@ -188,6 +236,10 @@ class Logger {
     return value ? this : this[incLogCallCountSymbol]()
   }
 
+  /**
+   * Clear the console.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   clear() {
     const con = privateConsole.get(this)
     con.clear()
@@ -198,6 +250,11 @@ class Logger {
     return this
   }
 
+  /**
+   * Log a count for the given label.
+   * @param {string} label - Label to count.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   count(label) {
     const con = privateConsole.get(this)
     con.count(label)
@@ -205,11 +262,22 @@ class Logger {
     return this[incLogCallCountSymbol]()
   }
 
+  /**
+   * Decrease indentation level.
+   * @param {number} [spaces=2] - Number of spaces to dedent.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   dedent(spaces = 2) {
     this.#indention = this.#indention.slice(0, -spaces)
     return this
   }
 
+  /**
+   * Display an object's properties.
+   * @param {any} obj - Object to display.
+   * @param {Object} [options] - Display options.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   dir(obj, options) {
     const con = privateConsole.get(this)
     con.dir(obj, options)
@@ -217,6 +285,11 @@ class Logger {
     return this[incLogCallCountSymbol]()
   }
 
+  /**
+   * Display data as XML.
+   * @param {...any} data - Data to display.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   dirxml(...data) {
     const con = privateConsole.get(this)
     con.dirxml(data)
@@ -224,18 +297,37 @@ class Logger {
     return this[incLogCallCountSymbol]()
   }
 
+  /**
+   * Log an error message.
+   * @param {...any} args - Arguments to log.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   error(...args) {
     return this.#apply('error', args)
   }
 
+  /**
+   * Log a newline to stderr if last line wasn't blank.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   errorNewline() {
     return this.#lastWasBlank ? this : this.error('')
   }
 
+  /**
+   * Log a failure message with symbol.
+   * @param {...any} args - Arguments to log.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   fail(...args) {
     return this.#symbolApply('fail', args)
   }
 
+  /**
+   * Start a new log group.
+   * @param {...any} label - Label for the group.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   group(...label) {
     const { length } = label
     if (length) {
@@ -249,43 +341,86 @@ class Logger {
     return this
   }
 
+  /**
+   * Start a new collapsed log group (alias for group).
+   * @param {...any} label - Label for the group.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   // groupCollapsed is an alias of group.
   // https://nodejs.org/api/console.html#consolegroupcollapsed
   groupCollapsed(...label) {
     return ReflectApply(this.group, this, label)
   }
 
+  /**
+   * End the current log group.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   groupEnd() {
     this.dedent(this[kGroupIndentationWidthSymbol])
     return this
   }
 
+  /**
+   * Increase indentation level.
+   * @param {number} [spaces=2] - Number of spaces to indent.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   indent(spaces = 2) {
     this.#indention += ' '.repeat(Math.min(spaces, maxIndentation))
     return this
   }
 
+  /**
+   * Log an info message with symbol.
+   * @param {...any} args - Arguments to log.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   info(...args) {
     return this.#symbolApply('info', args)
   }
 
+  /**
+   * Log a message.
+   * @param {...any} args - Arguments to log.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   log(...args) {
     return this.#apply('log', args)
   }
 
+  /**
+   * Log a newline to stdout if last line wasn't blank.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   logNewline() {
     return this.#lastWasBlank ? this : this.log('')
   }
 
+  /**
+   * Reset indentation to zero.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   resetIndent() {
     this.#indention = ''
     return this
   }
 
+  /**
+   * Log a success message with symbol.
+   * @param {...any} args - Arguments to log.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   success(...args) {
     return this.#symbolApply('success', args)
   }
 
+  /**
+   * Display data in a table format.
+   * @param {any} tabularData - Data to display.
+   * @param {string[]} [properties] - Properties to display.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   table(tabularData, properties) {
     const con = privateConsole.get(this)
     con.table(tabularData, properties)
@@ -293,6 +428,11 @@ class Logger {
     return this[incLogCallCountSymbol]()
   }
 
+  /**
+   * End a timer and log the elapsed time.
+   * @param {string} label - Timer label.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   timeEnd(label) {
     const con = privateConsole.get(this)
     con.timeEnd(label)
@@ -300,6 +440,12 @@ class Logger {
     return this[incLogCallCountSymbol]()
   }
 
+  /**
+   * Log the current timer value.
+   * @param {string} label - Timer label.
+   * @param {...any} data - Additional data to log.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   timeLog(label, ...data) {
     const con = privateConsole.get(this)
     con.timeLog(label, ...data)
@@ -307,6 +453,12 @@ class Logger {
     return this[incLogCallCountSymbol]()
   }
 
+  /**
+   * Log a stack trace.
+   * @param {string} message - Message to log with trace.
+   * @param {...any} args - Additional arguments.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   trace(message, ...args) {
     const con = privateConsole.get(this)
     con.trace(message, ...args)
@@ -314,6 +466,11 @@ class Logger {
     return this[incLogCallCountSymbol]()
   }
 
+  /**
+   * Log a warning message with symbol.
+   * @param {...any} args - Arguments to log.
+   * @returns {Logger} This Logger instance for chaining.
+   */
   warn(...args) {
     return this.#symbolApply('warn', args)
   }

package/external/@socketsecurity/registry/lib/objects.js

@@ -14,6 +14,13 @@ const {
 const { __defineGetter__ } = Object.prototype
 const { ownKeys: ReflectOwnKeys } = Reflect
 
+/**
+ * Create a lazy getter function that memoizes its result.
+ * @param {string | symbol} name - The property name for the getter.
+ * @param {Function} getter - The function to compute the value.
+ * @param {{initialized?: Set<string | symbol>}} [stats] - Statistics tracking object.
+ * @returns {Function} The lazy getter function.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function createLazyGetter(name, getter, stats) {
   const UNDEFINED_TOKEN = /*@__PURE__*/ require('./constants/undefined-token')
@@ -31,6 +38,15 @@ function createLazyGetter(name, getter, stats) {
   return lazyGetter
 }
 
+/**
+ * Create a frozen constants object with lazy getters and internal properties.
+ * @param {Object} props - Properties to include in the constants object.
+ * @param {Object} [options_] - Configuration options.
+ * @param {Object} [options_.getters] - Lazy getter definitions.
+ * @param {Object} [options_.internals] - Internal properties.
+ * @param {Object} [options_.mixin] - Properties to mix in.
+ * @returns {Object} The frozen constants object.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function createConstantsObject(props, options_) {
   const options = { __proto__: null, ...options_ }
@@ -95,17 +111,39 @@ function createConstantsObject(props, options_) {
   return ObjectFreeze(object)
 }
 
+/**
+ * Define a getter property on an object.
+ * @param {Object} object - The object to define the getter on.
+ * @param {string | symbol} propKey - The property key.
+ * @param {Function} getter - The getter function.
+ * @returns {Object} The object with the getter defined.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function defineGetter(object, propKey, getter) {
   __defineGetter__.call(object, propKey, getter)
   return object
 }
 
+/**
+ * Define a lazy getter property on an object.
+ * @param {Object} object - The object to define the lazy getter on.
+ * @param {string | symbol} propKey - The property key.
+ * @param {Function} getter - The getter function.
+ * @param {{initialized?: Set<string | symbol>}} [stats] - Statistics tracking object.
+ * @returns {Object} The object with the lazy getter defined.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function defineLazyGetter(object, propKey, getter, stats) {
   return defineGetter(object, propKey, createLazyGetter(propKey, getter, stats))
 }
 
+/**
+ * Define multiple lazy getter properties on an object.
+ * @param {Object} object - The object to define the lazy getters on.
+ * @param {Object | null} getterDefObj - Object mapping property keys to getter functions.
+ * @param {{initialized?: Set<string | symbol>}} [stats] - Statistics tracking object.
+ * @returns {Object} The object with the lazy getters defined.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function defineLazyGetters(object, getterDefObj, stats) {
   if (getterDefObj !== null && typeof getterDefObj === 'object') {
@@ -123,6 +161,13 @@ function defineLazyGetters(object, getterDefObj, stats) {
 }
 
 let _localeCompare
+/**
+ * Compare two entry arrays by their keys for sorting.
+ * @param {[any, any]} a - First entry tuple.
+ * @param {[any, any]} b - Second entry tuple.
+ * @returns {number} Comparison result for sorting.
+ * @private
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function entryKeyComparator(a, b) {
   if (_localeCompare === undefined) {
@@ -136,11 +181,22 @@ function entryKeyComparator(a, b) {
   return _localeCompare(strKeyA, strKeyB)
 }
 
+/**
+ * Get the enumerable own property keys of an object.
+ * @param {any} obj - The object to get keys from.
+ * @returns {string[]} Array of property keys, or empty array if not an object.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function getKeys(obj) {
   return isObject(obj) ? ObjectKeys(obj) : []
 }
 
+/**
+ * Get an own property value from an object safely.
+ * @param {any} obj - The object to get the property from.
+ * @param {string | symbol} propKey - The property key.
+ * @returns {any} The property value or undefined.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function getOwn(obj, propKey) {
   if (obj === null || obj === undefined) {
@@ -149,6 +205,11 @@ function getOwn(obj, propKey) {
   return ObjectHasOwn(obj, propKey) ? obj[propKey] : undefined
 }
 
+/**
+ * Get all own property values from an object.
+ * @param {any} obj - The object to get values from.
+ * @returns {any[]} Array of property values.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function getOwnPropertyValues(obj) {
   if (obj === null || obj === undefined) {
@@ -163,6 +224,11 @@ function getOwnPropertyValues(obj) {
   return values
 }
 
+/**
+ * Check if an object has any enumerable own properties.
+ * @param {any} obj - The object to check.
+ * @returns {boolean} True if the object has at least one own property.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function hasKeys(obj) {
   if (obj === null || obj === undefined) {
@@ -176,6 +242,12 @@ function hasKeys(obj) {
   return false
 }
 
+/**
+ * Check if an object has an own property.
+ * @param {any} obj - The object to check.
+ * @param {string | symbol} propKey - The property key.
+ * @returns {boolean} True if the object has the own property.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function hasOwn(obj, propKey) {
   if (obj === null || obj === undefined) {
@@ -184,16 +256,31 @@ function hasOwn(obj, propKey) {
   return ObjectHasOwn(obj, propKey)
 }
 
+/**
+ * Check if a value is an object (including arrays).
+ * @param {any} value - The value to check.
+ * @returns {boolean} True if the value is an object.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function isObject(value) {
   return value !== null && typeof value === 'object'
 }
 
+/**
+ * Check if a value is a plain object (not an array).
+ * @param {any} value - The value to check.
+ * @returns {boolean} True if the value is a plain object.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function isObjectObject(value) {
   return value !== null && typeof value === 'object' && !ArrayIsArray(value)
 }
 
+/**
+ * Get all own property entries (key-value pairs) from an object.
+ * @param {any} obj - The object to get entries from.
+ * @returns {Array<[string | symbol, any]>} Array of [key, value] tuples.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function objectEntries(obj) {
   if (obj === null || obj === undefined) {
@@ -209,6 +296,12 @@ function objectEntries(obj) {
   return entries
 }
 
+/**
+ * Deep merge source object into target object.
+ * @param {any} target - The target object to merge into.
+ * @param {any} source - The source object to merge from.
+ * @returns {any} The modified target object.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function merge(target, source) {
   if (!isObject(target) || !isObject(source)) {
@@ -272,11 +365,21 @@ function merge(target, source) {
   return target
 }
 
+/**
+ * Convert an object to a new object with sorted keys.
+ * @param {Object} obj - The object to sort.
+ * @returns {Object} A new object with keys in sorted order.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function toSortedObject(obj) {
   return toSortedObjectFromEntries(objectEntries(obj))
 }
 
+/**
+ * Create an object from entries with sorted keys.
+ * @param {Iterable<[string | symbol, any]>} entries - The entries to create an object from.
+ * @returns {Object} A new object with keys in sorted order.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function toSortedObjectFromEntries(entries) {
   const otherEntries = []