@aidra/pmx-io 0.0.0-stage → 9.13.0

package/preload.mjs

@@ -0,0 +1,25 @@
+// Copyright (c) 2026 Mike Warriner. All rights reserved. Proprietary — see LICENSE.
+
+// ES module preload, injected with `--import` only when ESM instrumentation (tracing) is
+// enabled (02 D-05, 80 INJ-010). It shares state with preload.cjs (which Node runs first),
+// activates on its own when used alone, and registers the module customization hooks that wrap
+// ES-module libraries when tracing is on (NIO-085, NIO-210). It never registers a hook otherwise.
+
+import { createRequire } from 'node:module'
+
+const require = createRequire(import.meta.url)
+
+try {
+  const env = process.env
+  const alreadyActive = Boolean(globalThis[Symbol.for('@pmx/io:preload-state')])
+  if (alreadyActive || ((env.PMX_IO === '1' || (!env.PMX_IO && env.PMX_IO_HUB && env.PMX_IO_STANDALONE !== '1')) &&
+      env.pmx !== 'false' && env.automation !== 'false')) {
+    const activation = require('./lib/activate.js')
+    activation.activate()
+    activation.registerEsmHooks()
+  }
+} catch (err) {
+  try {
+    process.stderr.write('[pmx] instrumentation disabled: ' + (err && err.message) + '\n')
+  } catch (_) {}
+}

package/standalone.cjs

@@ -0,0 +1,16 @@
+// Copyright (c) 2026 Mike Warriner. All rights reserved. Proprietary — see LICENSE.
+'use strict'
+
+// Standalone preload entry `@aidra/pmx-io/standalone` (80 NIO-261): for
+// `node --require @aidra/pmx-io/standalone app.js`, NODE_OPTIONS and the `pmx-io-node` launcher. Sets
+// PMX_IO_STANDALONE=1 (and PMX_IO_ROOT_PID when unset), adds itself to NODE_OPTIONS so that Node
+// descendants load it too, then activates as the tree's root or as a relay (NIO-263). Any failure
+// leaves the app untouched.
+
+try {
+  require('./lib/standalone/activate.js').fromPreload()
+} catch (err) {
+  try {
+    process.stderr.write('[@pm2/io] standalone mode disabled: ' + (err && err.message) + '\n')
+  } catch (_) {}
+}

package/standalone.mjs

@@ -0,0 +1,17 @@
+// Copyright (c) 2026 Mike Warriner. All rights reserved. Proprietary — see LICENSE.
+
+// Standalone preload entry for `--import` (80 NIO-261): activates like standalone.cjs and, when
+// tracing is enabled, registers the module customization hooks of NIO-085.
+
+import { createRequire } from 'node:module'
+
+const require = createRequire(import.meta.url)
+
+try {
+  require('./lib/standalone/activate.js').fromPreload()
+  require('./lib/activate.js').registerEsmHooks()
+} catch (err) {
+  try {
+    process.stderr.write('[@pm2/io] standalone mode disabled: ' + (err && err.message) + '\n')
+  } catch (_) {}
+}