@contrast/common 1.30.0 → 1.31.0

package/lib/index.d.ts

@@ -5,6 +5,14 @@ export * from './primordials';
 interface TraverseCallback {
     (path: any[], type: 'Key' | 'Value', value: any, obj: any): unknown;
 }
+export declare const empties: {
+    OBJECT: Readonly<{}>;
+    ARRAY: readonly never[];
+    UNTRACKED_VALUE_OBJ: Readonly<{
+        value: null;
+        tracked: false;
+    }>;
+};
 /**
  * Returns true if the value passed is either a primitive string or a
  * String object.
@@ -25,4 +33,8 @@ export declare function groupResultsMap(resultsMap: Partial<ResultMap>): {
 };
 export declare function get(obj: any, name: string): any;
 export declare function set(obj: Record<string, any>, name: string, value: any): void;
+/** Suppresses output to stderr when installed by the universal agent */
+export declare function safeConsoleError(...args: Parameters<typeof console.error>): void;
+/** Suppresses output to stderr when installed by the universal agent */
+export declare function safeConsoleWarn(...args: Parameters<typeof console.warn>): void;
 //# sourceMappingURL=index.d.ts.map

package/lib/index.js

@@ -28,13 +28,19 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.set = exports.get = exports.groupResultsMap = exports.callChildComponentMethods = exports.callChildComponentMethodsSync = exports.traverseKeys = exports.traverseValues = exports.traverseKeysAndValues = exports.encodeString = exports.isNonEmptyObject = exports.isString = void 0;
+exports.safeConsoleWarn = exports.safeConsoleError = exports.set = exports.get = exports.groupResultsMap = exports.callChildComponentMethods = exports.callChildComponentMethodsSync = exports.traverseKeys = exports.traverseValues = exports.traverseKeysAndValues = exports.encodeString = exports.isNonEmptyObject = exports.isString = exports.empties = void 0;
 const constants_1 = require("./constants");
 const primordials_1 = require("./primordials");
 __exportStar(require("./constants"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./primordials"), exports);
+const { CONTRAST_INSTALLATION_TOOL = 'NONE' } = process.env;
 const { StringPrototypeSplit, BufferFrom, BufferPrototypeToString } = primordials_1.primordials;
+exports.empties = {
+    OBJECT: Object.freeze({}),
+    ARRAY: Object.freeze([]),
+    UNTRACKED_VALUE_OBJ: Object.freeze({ value: null, tracked: false })
+};
 /**
  * Returns true if the value passed is either a primitive string or a
  * String object.
@@ -205,4 +211,18 @@ function set(obj, name, value) {
     obj[lastProp] = value;
 }
 exports.set = set;
+/** Suppresses output to stderr when installed by the universal agent */
+function safeConsoleError(...args) {
+    if (CONTRAST_INSTALLATION_TOOL === 'NONE') {
+        console.error(...args);
+    }
+}
+exports.safeConsoleError = safeConsoleError;
+/** Suppresses output to stderr when installed by the universal agent */
+function safeConsoleWarn(...args) {
+    if (CONTRAST_INSTALLATION_TOOL === 'NONE') {
+        console.warn(...args);
+    }
+}
+exports.safeConsoleWarn = safeConsoleWarn;
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contrast/common",
-  "version": "1.30.0",
+  "version": "1.31.0",
   "description": "Shared constants and utilities for all Contrast Agent modules",
   "license": "UNLICENSED",
   "author": "Contrast Security <nodejs@contrastsecurity.com> (https://www.contrastsecurity.com)",