@hashgraph/solo/dist/src/core/lock/lock-holder.js

An opinionated CLI tool to deploy and manage private Hedera Networks.

// SPDX-License-Identifier: Apache-2.0
import { MissingArgumentError } from '../errors/missing-argument-error.js';
import os from 'node:os';
import process from 'node:process';
/**
 * A representation of a leaseholder who is identified by a username, hostname, and process id (PID). This implementation
 * is serializable to/from a JSON object and is comparable to other leaseholders.
 */
export class LockHolder {
    /** The user's identity which is typically the OS login username. */
    _username;
    /** The machine's identity which is typically the hostname. */
    _hostname;
    /** The process identifier which is typically the OS PID. */
    _processId;
    /**
     * Constructs a new leaseholder with the given username, hostname, and process id. This constructor is private and
     * should not be called directly. Use the static factory methods to create a new instance.
     *
     * @param username - the user's identity.
     * @param hostname - the machine's identity.
     * @param processId - the process identifier.
     */
    constructor(username, hostname, processId) {
        if (!username) {
            throw new MissingArgumentError('username is required');
        }
        if (!hostname) {
            throw new MissingArgumentError('hostname is required');
        }
        if (!processId) {
            throw new MissingArgumentError('pid is required');
        }
        this._username = username;
        this._hostname = hostname;
        this._processId = processId;
    }
    /**
     * Creates a new leaseholder with the given username. The hostname is set to the current machine's hostname and the
     * process id is set to the current process's PID.
     * @param username - the user's identity.
     * @returns a new leaseholder instance.
     */
    static of(username) {
        return new LockHolder(username, os.hostname(), process.pid);
    }
    /**
     * Creates a new leaseholder by retrieving the current user's identity, the current machine's hostname, and the
     * current process's PID.
     * @returns a new leaseholder instance.
     */
    static default() {
        return LockHolder.of(os.userInfo().username);
    }
    /**
     * The user's identity which is typically the OS login username.
     * @returns the user's identity.
     */
    get username() {
        return this._username;
    }
    /**
     * The machine's identity which is typically the hostname.
     * @returns the machine's identity.
     */
    get hostname() {
        return this._hostname;
    }
    /**
     * The process identifier which is typically the OS PID.
     * @returns the process identifier.
     */
    get processId() {
        return this._processId;
    }
    /**
     * Returns a plain object representation of this leaseholder. This object may be serialized to JSON.
     * @returns a plain object representation of this leaseholder.
     */
    toObject() {
        return {
            username: this._username,
            hostname: this._hostname,
            pid: this._processId,
        };
    }
    /**
     * Compares this leaseholder to another leaseholder to determine if they are equal. Two leaseholders are equal if
     * their username, hostname, and process id are the same.
     * @param other - the other leaseholder to compare.
     * @returns true if the leaseholders are equal; false otherwise.
     */
    equals(other) {
        return this.username === other.username && this.hostname === other.hostname && this.processId === other.processId;
    }
    /**
     * Compares this leaseholder to another leaseholder to determine if they are the same machine. Two leaseholders are
     * the same machine if their username and hostname are the same.
     * @param other - the other leaseholder to compare.
     * @returns true if the leaseholders are the same machine; false otherwise.
     */
    isSameMachineIdentity(other) {
        return this.username === other.username && this.hostname === other.hostname;
    }
    /**
     * Determines if the process associated with this leaseholder is still alive. This method will return false if the
     * process is not alive or an error occurs while checking the process status.
     * @returns true if the process is alive; false otherwise.
     */
    isProcessAlive() {
        try {
            return process.kill(this.processId, 0);
        }
        catch (error) {
            return error.code === 'EPERM';
        }
    }
    /**
     * Serializes this leaseholder to a JSON string representation.
     * @returns a JSON string representation of this leaseholder.
     */
    toJson() {
        return JSON.stringify(this.toObject());
    }
    /**
     * Deserializes a JSON string representation of a leaseholder into a new leaseholder instance.
     * @param json - the JSON string representation of a leaseholder.
     * @returns a new leaseholder instance.
     */
    static fromJson(json) {
        const object = JSON.parse(json);
        return new LockHolder(object.username, object.hostname, object.pid);
    }
}
//# sourceMappingURL=lock-holder.js.map