@contrast/core 1.47.0 → 1.48.0

package/lib/ioc/core.js

@@ -0,0 +1,94 @@
+/*
+ * Copyright: 2025 Contrast Security, Inc
+ * Contact: support@contrastsecurity.com
+ * License: Commercial
+
+ * NOTICE: This Software and the patented inventions embodied within may only be
+ * used as part of Contrast Security’s commercial offerings. Even though it is
+ * made available through public repositories, use of this Software is subject to
+ * the applicable End User Licensing Agreement found at
+ * https://www.contrastsecurity.com/enduser-terms-0317a or as otherwise agreed
+ * between Contrast Security and the End User. The Software may not be reverse
+ * engineered, modified, repackaged, sold, redistributed or otherwise used in a
+ * way not consistent with the End User License Agreement.
+ */
+
+'use strict';
+
+const EventEmitter = require('events');
+const Perf = require('@contrast/perf');
+
+const kComponentName = Symbol('kComponentName');
+
+class Core {
+  constructor(initData = {}) {
+    const core = this;
+    // setup perf tools
+
+    this.Perf = Perf;
+    this.perf = new Perf('core');
+    Perf.setInterval();
+
+    // setup messaging
+    this.messages = new EventEmitter();
+    // pad for number of components that listen for server-settings-update messages
+    this.messages.setMaxListeners(10 + this.messages.getMaxListeners());
+
+    // merge init data
+    Object.assign(this, { ...initData });
+
+    if (process.env.CONTRAST_EXT_PATH) {
+      require(process.env.CONTRAST_EXT_PATH)(this);
+    }
+
+    this.messages.on('ext:core.init', (fullName) => {
+      // if scopes is composed, then run our event handlers in a no-instrumentation scope
+      if (fullName == 'scopes') {
+        const store = { name: 'core.messages.emit', lock: true };
+        const emit = core.messages.emit.bind(core.messages);
+        core.messages.emit = function(...args) {
+          return core.scopes.instrumentation.isLocked() ?
+            core.scopes.instrumentation.run(store, emit, ...args) :
+            emit(...args);
+        };
+      }
+    });
+  }
+
+  /**
+   * Given a component factory and spec name will initialize the factory using perf.
+   * @param {function} factory the component factory function
+   * @param {string} specName id used by perf
+   */
+  initComponentFactory(factory, specName) {
+    this.perf.wrapInit(factory, specName)(this);
+  }
+
+  /**
+   * If component factory is decorated with metadata, then we can
+   * use the metadata to hook into core's extension events.
+   * @param {function} component
+   * @param {string} component.fullName
+   * @throws {Error} if component doesn't have appropriate metadata
+   */
+  initComponentSync(component) {
+    this.perf.wrapInit(component, component[kComponentName])(this);
+    this.messages.emit('ext:core.init', component[kComponentName]);
+  }
+
+  static isComponent(target) {
+    return typeof target == 'function' && target[kComponentName]?.length > 0;
+  }
+
+  static makeComponent(meta) {
+    if (!meta.factory || !meta.name) throw new Error('makeComponent requires factory and name');
+
+    // decorate with metadata
+    meta.factory[kComponentName] = meta.name;
+
+    return meta.factory;
+  }
+}
+
+module.exports = Core;
+module.exports.Core = Core;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contrast/core",
-  "version": "1.47.0",
+  "version": "1.48.0",
   "description": "Preconfigured Contrast agent core services and models",
   "license": "SEE LICENSE IN LICENSE",
   "author": "Contrast Security <nodejs@contrastsecurity.com> (https://www.contrastsecurity.com)",
@@ -19,12 +19,13 @@
     "test": "../scripts/test.sh"
   },
   "dependencies": {
-    "@contrast/common": "1.31.0",
-    "@contrast/config": "1.42.0",
+    "@contrast/common": "1.32.0",
+    "@contrast/config": "1.43.0",
     "@contrast/find-package-json": "^1.1.0",
     "@contrast/fn-inspect": "^4.3.0",
-    "@contrast/logger": "1.20.0",
-    "@contrast/patcher": "1.19.0",
+    "@contrast/logger": "1.21.0",
+    "@contrast/patcher": "1.20.0",
+    "@contrast/perf": "1.3.1",
     "@tsxper/crc32": "^2.1.3",
     "axios": "^1.7.4",
     "semver": "^7.6.0"