@matterbridge/utils 3.10.14-dev-20261014-ad770e2 → 3.10.14-dev-20261015-97e1ff6

package/dist/export.d.ts

@@ -16,6 +16,7 @@ export * from './measurementUtils.js';
 export * from './network.js';
 export * from './npmPrefix.js';
 export * from './npmVersion.js';
+export * from './runtime.js';
 export * from './runtimeBun.js';
 export * from './runtimeDocker.js';
 export * from './tracker.js';

package/dist/export.js

@@ -16,6 +16,7 @@ export * from './measurementUtils.js';
 export * from './network.js';
 export * from './npmPrefix.js';
 export * from './npmVersion.js';
+export * from './runtime.js';
 export * from './runtimeBun.js';
 export * from './runtimeDocker.js';
 export * from './tracker.js';

package/dist/runtime.d.ts

@@ -0,0 +1,2 @@
+export declare function isRoot(): boolean;
+export declare function hasPasswordlessSudo(): boolean;

package/dist/runtime.js

@@ -0,0 +1,18 @@
+import { spawnSync } from 'node:child_process';
+import { logModuleLoaded } from './loader.js';
+logModuleLoaded('Runtime');
+const SUDO_PROBE_TIMEOUT_MS = 5000;
+export function isRoot() {
+    return process.getuid?.() === 0;
+}
+export function hasPasswordlessSudo() {
+    if (process.platform === 'win32')
+        return false;
+    try {
+        const result = spawnSync('sudo', ['-n', 'true'], { stdio: 'ignore', timeout: SUDO_PROBE_TIMEOUT_MS });
+        return !result.error && result.status === 0;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/runtimeDocker.d.ts

@@ -1,2 +1,21 @@
+import os from 'node:os';
+export declare const DOCKERENV_FILE = "/.dockerenv";
+export declare const CONTAINERENV_FILE = "/run/.containerenv";
+export declare const DOCKER_BUILD_CONFIG_FILE = "/matterbridge/.dockerbuild.json";
 export declare const DOCKER_MARKER_FILES: readonly string[];
+export type ContainerKind = 'codespaces' | 'devcontainer' | 'kubernetes' | 'podman' | 'docker';
+export interface DockerRuntimeInfo {
+    container: boolean;
+    kind: ContainerKind | undefined;
+    dockerParameter: boolean;
+    imageBuildConfig: Record<string, unknown> | undefined;
+    bridgeNetwork: boolean;
+}
+export interface DockerRuntimeFiles {
+    dockerenv?: string;
+    containerenv?: string;
+    buildConfig?: string;
+}
 export declare function isDocker(markerFiles?: readonly string[]): boolean;
+export declare function isDockerBridgeNetwork(interfaces?: NodeJS.Dict<os.NetworkInterfaceInfo[]>): boolean;
+export declare function getDockerRuntimeInfo(files?: DockerRuntimeFiles, interfaces?: NodeJS.Dict<os.NetworkInterfaceInfo[]>): DockerRuntimeInfo;

package/dist/runtimeDocker.js

@@ -1,7 +1,13 @@
-import { existsSync } from 'node:fs';
+import { existsSync, readFileSync } from 'node:fs';
+import os from 'node:os';
+import { hasParameter } from './commandLine.js';
 import { logModuleLoaded } from './loader.js';
+import { isValidObject } from './validate.js';
 logModuleLoaded('RuntimeDocker');
-export const DOCKER_MARKER_FILES = ['/.dockerenv', '/run/.containerenv'];
+export const DOCKERENV_FILE = '/.dockerenv';
+export const CONTAINERENV_FILE = '/run/.containerenv';
+export const DOCKER_BUILD_CONFIG_FILE = '/matterbridge/.dockerbuild.json';
+export const DOCKER_MARKER_FILES = [DOCKERENV_FILE, CONTAINERENV_FILE];
 export function isDocker(markerFiles = DOCKER_MARKER_FILES) {
     if (process.platform !== 'linux')
         return false;
@@ -9,3 +15,49 @@ export function isDocker(markerFiles = DOCKER_MARKER_FILES) {
         return true;
     return markerFiles.some((file) => existsSync(file));
 }
+function isDockerBridgeAddress(address) {
+    const [first, second] = address.split('.').map(Number);
+    return first === 172 && second >= 16 && second <= 31;
+}
+export function isDockerBridgeNetwork(interfaces = os.networkInterfaces()) {
+    const addresses = Object.values(interfaces)
+        .flatMap((infos) => infos ?? [])
+        .filter((info) => info.family === 'IPv4' && !info.internal)
+        .map((info) => info.address);
+    return addresses.length > 0 && addresses.every(isDockerBridgeAddress);
+}
+function getContainerKind(files) {
+    if (process.platform !== 'linux')
+        return undefined;
+    if (process.env.CODESPACES === 'true')
+        return 'codespaces';
+    if (process.env.REMOTE_CONTAINERS === 'true')
+        return 'devcontainer';
+    if (process.env.KUBERNETES_SERVICE_HOST)
+        return 'kubernetes';
+    if (existsSync(files.containerenv ?? CONTAINERENV_FILE))
+        return 'podman';
+    if (existsSync(files.dockerenv ?? DOCKERENV_FILE))
+        return 'docker';
+    return undefined;
+}
+function readImageBuildConfig(file) {
+    try {
+        const config = JSON.parse(readFileSync(file, 'utf-8'));
+        return isValidObject(config) ? Object.fromEntries(Object.entries(config)) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function getDockerRuntimeInfo(files = {}, interfaces) {
+    const kind = getContainerKind(files);
+    const container = kind !== undefined;
+    return {
+        container,
+        kind,
+        dockerParameter: hasParameter('docker'),
+        imageBuildConfig: container ? readImageBuildConfig(files.buildConfig ?? DOCKER_BUILD_CONFIG_FILE) : undefined,
+        bridgeNetwork: container && isDockerBridgeNetwork(interfaces),
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matterbridge/utils",
-  "version": "3.10.14-dev-20261014-ad770e2",
+  "version": "3.10.14-dev-20261015-97e1ff6",
   "description": "Matterbridge utils library",
   "author": "https://github.com/Luligu",
   "homepage": "https://matterbridge.io/",