ee-core 4.1.5 → 5.0.0-beta.5

package/dist/esm/utils/index.d.ts

@@ -0,0 +1,113 @@
+/**
+ * @module utils
+ * @description Utility module entry point. Uniformly exports all sub-module public APIs for
+ * other framework modules and business code to reference via `import { xxx } from 'ee-core/utils'`.
+ *
+ * Export sources:
+ * - extend: object deep merge
+ * - is: Electron runtime environment detection (process type, OS, architecture)
+ * - json: JSON file synchronous/asynchronous read/write
+ * - pargv: command line argument parsing
+ * - wrap: file path to property path conversion
+ * - helper: common utility functions (debounce, sleep, version comparison, etc.)
+ * - port: TCP port allocation
+ * - ip: public IP query
+ */
+export * from './extend.js';
+export * from './is.js';
+export * from './json.js';
+export * from './pargv.js';
+export * from './wrap.js';
+export * from './helper.js';
+export * from './port/index.js';
+export { publicIpv4, publicIpv6 } from './ip.js';
+import * as is from './is.js';
+/**
+ * Get package.json content from the project root directory
+ *
+ * Reads and parses the package.json file in the project root directory,
+ * used to obtain application name, version number, and other metadata.
+ *
+ * @returns Parsed package.json object
+ */
+export declare function getPackage(): unknown;
+/**
+ * Get the first valid MAC address
+ *
+ * Traverses local network interfaces, returns the first non-zero MAC address.
+ * Zero MAC addresses (00:00:00:00:00:00) typically indicate virtual interfaces and are skipped.
+ *
+ * @param iface - Specify network interface name; if omitted, all interfaces are traversed
+ * @returns First valid MAC address string
+ * @throws Error - Throws when specified interface doesn't exist, has no valid MAC, or no valid MAC globally
+ */
+export declare function getMAC(iface?: string): string;
+/**
+ * Check if input is a valid MAC address format
+ *
+ * MAC address format: XX:XX:XX:XX:XX:XX or XX-XX-XX-XX-XX-XX,
+ * each segment 1-2 hexadecimal characters.
+ *
+ * @param macAddress - String to check
+ * @returns true if it matches MAC address format
+ */
+export declare function isMAC(macAddress: string): boolean;
+/**
+ * Check if protocol is a file protocol
+ *
+ * @param protocol - Protocol string
+ * @returns true if it is file:// protocol
+ */
+export declare function isFileProtocol(protocol: string): boolean;
+/**
+ * Check if protocol is a web protocol (http or https)
+ *
+ * @param protocol - Protocol string
+ * @returns true if it is http:// or https:// protocol
+ */
+export declare function isWebProtocol(protocol: string): boolean;
+/**
+ * Check if the project is a JavaScript project (not TypeScript)
+ *
+ * Determines by checking if the entry file main.js or index.js exists.
+ * TypeScript projects use main.ts as the entry point.
+ *
+ * @param baseDir - Project root directory
+ * @returns true if it is a JS project
+ */
+export declare function isJsProject(baseDir: string): boolean;
+/**
+ * Synchronously get machine unique identifier (hash value)
+ *
+ * Obtains machine identifier by executing platform-specific commands, returns SHA-256 hash by default.
+ * Set original to true to return the raw value.
+ *
+ * @param original - Whether to return the original value instead of hash, default false
+ * @returns Machine unique identifier string
+ * @throws Error - Unsupported OS platform
+ */
+export declare function machineIdSync(original?: boolean): string;
+/**
+ * Asynchronously get machine unique identifier (hash value)
+ *
+ * Obtains machine identifier by asynchronously executing platform-specific commands, returns SHA-256 hash by default.
+ * Suitable for scenarios where blocking the event loop is undesirable.
+ *
+ * @param original - Whether to return the original value instead of hash, default false
+ * @returns Promise of machine unique identifier string
+ * @throws Error - Unsupported OS platform or command execution failure
+ */
+export declare function machineId(original?: boolean): Promise<string>;
+/**
+ * Get platform identifier string
+ *
+ * Returns a combined identifier of current OS and architecture, used for build artifact naming and platform detection.
+ *
+ * @param delimiter - Separator, default '_'
+ * @param isDiffArch - Whether to distinguish architecture bitness (only effective on Windows), default false
+ * @returns Platform identifier (e.g. 'windows_64', 'macos_apple', 'linux')
+ */
+export declare function getPlatform(delimiter?: string, isDiffArch?: boolean): string;
+/** Export all environment detection functions from the is module for external use */
+export { is };
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AASjD,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AA6B9B;;;;;;;GAOG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAGpC;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CA2B7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAGjD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAIpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,QAAQ,UAAQ,GAAG,MAAM,CAOtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,QAAQ,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAc3D;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,SAAS,SAAM,EAAE,UAAU,UAAQ,GAAG,MAAM,CAcvE;AAwED,qFAAqF;AACrF,OAAO,EAAE,EAAE,EAAE,CAAC"}

package/dist/esm/utils/index.js

@@ -0,0 +1,344 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+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);
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.is = exports.publicIpv6 = exports.publicIpv4 = void 0;
+exports.getPackage = getPackage;
+exports.getMAC = getMAC;
+exports.isMAC = isMAC;
+exports.isFileProtocol = isFileProtocol;
+exports.isWebProtocol = isWebProtocol;
+exports.isJsProject = isJsProject;
+exports.machineIdSync = machineIdSync;
+exports.machineId = machineId;
+exports.getPlatform = getPlatform;
+/**
+ * @module utils
+ * @description Utility module entry point. Uniformly exports all sub-module public APIs for
+ * other framework modules and business code to reference via `import { xxx } from 'ee-core/utils'`.
+ *
+ * Export sources:
+ * - extend: object deep merge
+ * - is: Electron runtime environment detection (process type, OS, architecture)
+ * - json: JSON file synchronous/asynchronous read/write
+ * - pargv: command line argument parsing
+ * - wrap: file path to property path conversion
+ * - helper: common utility functions (debounce, sleep, version comparison, etc.)
+ * - port: TCP port allocation
+ * - ip: public IP query
+ */
+__exportStar(require("./extend.js"), exports);
+__exportStar(require("./is.js"), exports);
+__exportStar(require("./json.js"), exports);
+__exportStar(require("./pargv.js"), exports);
+__exportStar(require("./wrap.js"), exports);
+__exportStar(require("./helper.js"), exports);
+__exportStar(require("./port/index.js"), exports);
+var ip_js_1 = require("./ip.js");
+Object.defineProperty(exports, "publicIpv4", { enumerable: true, get: function () { return ip_js_1.publicIpv4; } });
+Object.defineProperty(exports, "publicIpv6", { enumerable: true, get: function () { return ip_js_1.publicIpv6; } });
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const child_process_1 = require("child_process");
+const crypto_1 = require("crypto");
+const index_js_1 = require("../ps/index.js");
+const json_js_1 = require("./json.js");
+const is = __importStar(require("./is.js"));
+exports.is = is;
+const { platform } = process;
+/** Windows registry binary paths (distinguishing 32-bit and 64-bit architectures) */
+const win32RegBinPath = {
+    /** Native architecture (64-bit Node on 64-bit system) */
+    native: '%windir%\\System32',
+    /** Mixed architecture (32-bit Node on 64-bit system, needs sysnative redirect) */
+    mixed: '%windir%\\sysnative\\cmd.exe /c %windir%\\System32',
+};
+/**
+ * Commands to get machine unique identifiers per platform
+ *
+ * - macOS: reads IOPlatformUUID via ioreg
+ * - Windows: reads MachineGuid from registry
+ * - Linux: reads /var/lib/dbus/machine-id or /etc/machine-id
+ * - FreeBSD: reads UUID via kenv or sysctl
+ */
+const MachineGuid = {
+    darwin: 'ioreg -rd1 -c IOPlatformExpertDevice',
+    win32: `${win32RegBinPath[_isWindowsProcessMixedOrNativeArchitecture()]}\\REG.exe ` +
+        'QUERY HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Cryptography ' +
+        '/v MachineGuid',
+    linux: '( cat /var/lib/dbus/machine-id /etc/machine-id 2> /dev/null || hostname ) | head -n 1 || :',
+    freebsd: 'kenv -q smbios.system.uuid || sysctl -n kern.hostuuid',
+};
+/**
+ * Get package.json content from the project root directory
+ *
+ * Reads and parses the package.json file in the project root directory,
+ * used to obtain application name, version number, and other metadata.
+ *
+ * @returns Parsed package.json object
+ */
+function getPackage() {
+    const json = (0, json_js_1.readSync)(path_1.default.join((0, index_js_1.getBaseDir)(), 'package.json'));
+    return json;
+}
+/**
+ * Get the first valid MAC address
+ *
+ * Traverses local network interfaces, returns the first non-zero MAC address.
+ * Zero MAC addresses (00:00:00:00:00:00) typically indicate virtual interfaces and are skipped.
+ *
+ * @param iface - Specify network interface name; if omitted, all interfaces are traversed
+ * @returns First valid MAC address string
+ * @throws Error - Throws when specified interface doesn't exist, has no valid MAC, or no valid MAC globally
+ */
+function getMAC(iface) {
+    const zeroRegex = /(?:[0]{1,2}[:-]){5}[0]{1,2}/;
+    const list = os_1.default.networkInterfaces();
+    if (iface) {
+        // Search in the specified interface
+        const parts = list[iface];
+        if (!parts) {
+            throw new Error(`interface ${iface} was not found`);
+        }
+        for (const part of parts) {
+            if (zeroRegex.test(part.mac) === false) {
+                return part.mac;
+            }
+        }
+        throw new Error(`interface ${iface} had no valid mac addresses`);
+    }
+    else {
+        // Traverse all interfaces to find the first valid MAC
+        for (const [, parts] of Object.entries(list)) {
+            if (!parts)
+                continue;
+            for (const part of parts) {
+                if (zeroRegex.test(part.mac) === false) {
+                    return part.mac;
+                }
+            }
+        }
+    }
+    throw new Error('failed to get the MAC address');
+}
+/**
+ * Check if input is a valid MAC address format
+ *
+ * MAC address format: XX:XX:XX:XX:XX:XX or XX-XX-XX-XX-XX-XX,
+ * each segment 1-2 hexadecimal characters.
+ *
+ * @param macAddress - String to check
+ * @returns true if it matches MAC address format
+ */
+function isMAC(macAddress) {
+    const macRegex = /(?:[a-z0-9]{1,2}[:-]){5}[a-z0-9]{1,2}/i;
+    return macRegex.test(macAddress);
+}
+/**
+ * Check if protocol is a file protocol
+ *
+ * @param protocol - Protocol string
+ * @returns true if it is file:// protocol
+ */
+function isFileProtocol(protocol) {
+    return protocol === 'file://';
+}
+/**
+ * Check if protocol is a web protocol (http or https)
+ *
+ * @param protocol - Protocol string
+ * @returns true if it is http:// or https:// protocol
+ */
+function isWebProtocol(protocol) {
+    return ['http://', 'https://'].includes(protocol);
+}
+/**
+ * Check if the project is a JavaScript project (not TypeScript)
+ *
+ * Determines by checking if the entry file main.js or index.js exists.
+ * TypeScript projects use main.ts as the entry point.
+ *
+ * @param baseDir - Project root directory
+ * @returns true if it is a JS project
+ */
+function isJsProject(baseDir) {
+    const entryFile1 = path_1.default.join(baseDir, 'electron', 'main.js');
+    const entryFile2 = path_1.default.join(baseDir, 'electron', 'index.js');
+    return fs_1.default.existsSync(entryFile1) || fs_1.default.existsSync(entryFile2);
+}
+/**
+ * Synchronously get machine unique identifier (hash value)
+ *
+ * Obtains machine identifier by executing platform-specific commands, returns SHA-256 hash by default.
+ * Set original to true to return the raw value.
+ *
+ * @param original - Whether to return the original value instead of hash, default false
+ * @returns Machine unique identifier string
+ * @throws Error - Unsupported OS platform
+ */
+function machineIdSync(original = false) {
+    const cmd = MachineGuid[platform];
+    if (!cmd) {
+        throw new Error(`Unsupported platform: ${platform}`);
+    }
+    const id = _expose((0, child_process_1.execSync)(cmd).toString());
+    return original ? id : _hash(id);
+}
+/**
+ * Asynchronously get machine unique identifier (hash value)
+ *
+ * Obtains machine identifier by asynchronously executing platform-specific commands, returns SHA-256 hash by default.
+ * Suitable for scenarios where blocking the event loop is undesirable.
+ *
+ * @param original - Whether to return the original value instead of hash, default false
+ * @returns Promise of machine unique identifier string
+ * @throws Error - Unsupported OS platform or command execution failure
+ */
+function machineId(original = false) {
+    return new Promise((resolve, reject) => {
+        const cmd = MachineGuid[platform];
+        if (!cmd) {
+            return reject(new Error(`Unsupported platform: ${platform}`));
+        }
+        (0, child_process_1.exec)(cmd, {}, (err, stdout) => {
+            if (err) {
+                return reject(new Error(`Error while obtaining machine id: ${err.stack}`));
+            }
+            const id = _expose(stdout.toString());
+            return resolve(original ? id : _hash(id));
+        });
+    });
+}
+/**
+ * Get platform identifier string
+ *
+ * Returns a combined identifier of current OS and architecture, used for build artifact naming and platform detection.
+ *
+ * @param delimiter - Separator, default '_'
+ * @param isDiffArch - Whether to distinguish architecture bitness (only effective on Windows), default false
+ * @returns Platform identifier (e.g. 'windows_64', 'macos_apple', 'linux')
+ */
+function getPlatform(delimiter = '_', isDiffArch = false) {
+    if (process.platform === 'win32') {
+        let os = 'windows';
+        if (isDiffArch) {
+            os += delimiter + (process.arch === 'x64' ? '64' : '32');
+        }
+        return os;
+    }
+    if (process.platform === 'darwin') {
+        // macOS distinguishes Intel (x64) and Apple Silicon (arm64)
+        const core = process.arch === 'arm64' ? 'apple' : 'intel';
+        return 'macos' + delimiter + core;
+    }
+    return 'linux';
+}
+/**
+ * Detect if Node.js process architecture is mixed mode on Windows
+ *
+ * Returns 'mixed' when running 32-bit Node.js on 64-bit Windows,
+ * 'native' otherwise.
+ * Used to determine the correct system path for registry access.
+ *
+ * @returns 'mixed' (32-bit Node on 64-bit Windows) or 'native'
+ */
+function _isWindowsProcessMixedOrNativeArchitecture() {
+    if (process.platform !== 'win32') {
+        return '';
+    }
+    // When 32-bit Node runs on 64-bit Windows, PROCESSOR_ARCHITEW6432 exists in environment variables
+    if (process.arch === 'ia32' && process.env.hasOwnProperty('PROCESSOR_ARCHITEW6432')) {
+        return 'mixed';
+    }
+    return 'native';
+}
+/**
+ * SHA-256 hash the machine identifier
+ *
+ * Hashes the original identifier before returning, to avoid exposing real machine information.
+ *
+ * @param guid - Original machine identifier string
+ * @returns SHA-256 hashed hexadecimal string
+ */
+function _hash(guid) {
+    return (0, crypto_1.createHash)('sha256').update(guid).digest('hex');
+}
+/**
+ * Extract machine identifier from command output
+ *
+ * Command output format varies by platform; this function is responsible for parsing and
+ * extracting the pure identifier value.
+ *
+ * @param result - Command execution output string
+ * @returns Cleaned machine identifier string
+ * @throws Error - Unsupported platform
+ */
+function _expose(result) {
+    switch (platform) {
+        case 'darwin': {
+            // In ioreg output, IOPlatformUUID is followed by the UUID value
+            const parts = result.split('IOPlatformUUID');
+            const part = parts[1];
+            if (!part)
+                return '';
+            const lines = part.split('\n');
+            const line = lines[0];
+            if (!line)
+                return '';
+            return line.replace(/\=|\s+|"/gi, '').toLowerCase();
+        }
+        case 'win32': {
+            // In REG QUERY output, REG_SZ is followed by the value
+            const parts = result.toString().split('REG_SZ');
+            const part = parts[1];
+            if (!part)
+                return '';
+            return part.replace(/\r+|\n+|\s+/gi, '').toLowerCase();
+        }
+        case 'linux':
+            return result.toString().replace(/\r+|\n+|\s+/gi, '').toLowerCase();
+        case 'freebsd':
+            return result.toString().replace(/\r+|\n+|\s+/gi, '').toLowerCase();
+        default:
+            throw new Error(`Unsupported platform: ${process.platform}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/utils/ip.d.ts

@@ -0,0 +1,42 @@
+/** IP query options */
+interface IpOptions {
+    /** Query timeout (ms) */
+    timeout?: number;
+    /** Query method */
+    type?: 'http' | 'dns' | 'all';
+    /** Fallback HTTPS URL list, used when default URLs all fail */
+    fallbackUrls?: string[];
+}
+/**
+ * Query public IPv4 address
+ *
+ * @param options - Query options (type, timeout, fallbackUrls)
+ * @returns Promise of IPv4 address string, with cancel() method to cancel the query
+ *
+ * @example
+ * ```ts
+ * const p = publicIpv4({ type: 'http', timeout: 5000 });
+ * const ip = await p;
+ * // Or cancel the query
+ * p.cancel();
+ * ```
+ */
+export declare function publicIpv4(options?: IpOptions): Promise<string> & {
+    cancel?: () => void;
+};
+/**
+ * Query public IPv6 address
+ *
+ * @param options - Query options (type, timeout, fallbackUrls)
+ * @returns Promise of IPv6 address string, with cancel() method to cancel the query
+ *
+ * @example
+ * ```ts
+ * const ip = await publicIpv6({ type: 'dns' });
+ * ```
+ */
+export declare function publicIpv6(options?: IpOptions): Promise<string> & {
+    cancel?: () => void;
+};
+export {};
+//# sourceMappingURL=ip.d.ts.map

package/dist/esm/utils/ip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip.d.ts","sourceRoot":"","sources":["../../../src/utils/ip.ts"],"names":[],"mappings":"AAqHA,uBAAuB;AACvB,UAAU,SAAS;IACjB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;IAC9B,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AA2JD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,CAgBzF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,CAezF"}