@milaboratories/pl-deployments 2.4.6 → 2.4.8

package/dist/local/pl.cjs

@@ -0,0 +1,217 @@
+'use strict';
+
+var process$1 = require('./process.cjs');
+var pl_binary = require('../common/pl_binary.cjs');
+var tsHelpers = require('@milaboratories/ts-helpers');
+var pid = require('./pid.cjs');
+var trace = require('./trace.cjs');
+var upath = require('upath');
+var fsp = require('node:fs/promises');
+var os = require('node:os');
+
+function _interopNamespaceDefault(e) {
+    var n = Object.create(null);
+    if (e) {
+        Object.keys(e).forEach(function (k) {
+            if (k !== 'default') {
+                var d = Object.getOwnPropertyDescriptor(e, k);
+                Object.defineProperty(n, k, d.get ? d : {
+                    enumerable: true,
+                    get: function () { return e[k]; }
+                });
+            }
+        });
+    }
+    n.default = e;
+    return Object.freeze(n);
+}
+
+var os__namespace = /*#__PURE__*/_interopNamespaceDefault(os);
+
+const LocalConfigYaml = 'config-local.yaml';
+/**
+ * Represents a local running pl-core,
+ * and has methods to start, check if it's running, stop and wait for stopping it.
+ * Also, a hook on pl-core closed can be provided.
+ */
+class LocalPl {
+    logger;
+    workingDir;
+    startOptions;
+    initialStartHistory;
+    onClose;
+    onError;
+    onCloseAndError;
+    onCloseAndErrorNoStop;
+    instance;
+    pid;
+    nRuns = 0;
+    lastRunHistory = {};
+    wasStopped = false;
+    constructor(logger, workingDir, startOptions, initialStartHistory, onClose, onError, onCloseAndError, onCloseAndErrorNoStop) {
+        this.logger = logger;
+        this.workingDir = workingDir;
+        this.startOptions = startOptions;
+        this.initialStartHistory = initialStartHistory;
+        this.onClose = onClose;
+        this.onError = onError;
+        this.onCloseAndError = onCloseAndError;
+        this.onCloseAndErrorNoStop = onCloseAndErrorNoStop;
+    }
+    async start() {
+        await trace.withTrace(this.logger, async (trace, t) => {
+            this.wasStopped = false;
+            const instance = process$1.processRun(this.logger, this.startOptions);
+            instance.on('error', (e) => {
+                this.logger.error(`error '${e}', while running platforma, started opts: ${JSON.stringify(this.debugInfo())}`);
+                // keep in mind there are no awaits here, it will be asynchronous
+                if (this.onError !== undefined)
+                    void this.onError(this);
+                if (this.onCloseAndError !== undefined)
+                    void this.onCloseAndError(this);
+                if (this.onCloseAndErrorNoStop !== undefined && !this.wasStopped)
+                    void this.onCloseAndErrorNoStop(this);
+            });
+            instance.on('close', () => {
+                this.logger.warn(`platforma was closed, started opts: ${JSON.stringify(this.debugInfo())}`);
+                // keep in mind there are no awaits here, it will be asynchronous
+                if (this.onClose !== undefined)
+                    void this.onClose(this);
+                if (this.onCloseAndError !== undefined)
+                    void this.onCloseAndError(this);
+                if (this.onCloseAndErrorNoStop !== undefined && !this.wasStopped)
+                    void this.onCloseAndErrorNoStop(this);
+            });
+            trace('started', true);
+            const pidFile = trace('pidFile', pid.filePid(this.workingDir));
+            trace('pid', tsHelpers.notEmpty(instance.pid));
+            trace('pidWritten', await pid.writePid(pidFile, tsHelpers.notEmpty(instance.pid)));
+            this.nRuns++;
+            this.instance = instance;
+            this.pid = instance.pid;
+            this.lastRunHistory = t;
+        });
+    }
+    stop() {
+        // TODO use this.instance to stop the process
+        this.wasStopped = true;
+        process$1.processStop(tsHelpers.notEmpty(this.pid));
+    }
+    async waitStopped() {
+        await process$1.processWaitStopped(tsHelpers.notEmpty(this.pid), 15000);
+    }
+    stopped() {
+        return this.wasStopped;
+    }
+    async isAlive() {
+        return await process$1.isProcessAlive(tsHelpers.notEmpty(this.pid));
+    }
+    debugInfo() {
+        return {
+            lastRunHistory: this.lastRunHistory,
+            nRuns: this.nRuns,
+            pid: this.pid,
+            workingDir: this.workingDir,
+            initialStartHistory: this.initialStartHistory,
+            wasStopped: this.wasStopped,
+        };
+    }
+}
+/**
+ * Starts pl-core, if the option was provided downloads a binary, reads license environments etc.
+ */
+async function localPlatformaInit(logger, _ops) {
+    // filling-in default values
+    // Backend could consume a lot of CPU power,
+    // we want to keep at least a couple for UI and other apps to work.
+    const numCpu = Math.max(os__namespace.cpus().length - 2, 1);
+    const ops = mergeDefaultOps(_ops, numCpu);
+    return await trace.withTrace(logger, async (trace, t) => {
+        trace('startOptions', { ...ops, config: 'too wordy' });
+        const workDir = upath.resolve(ops.workingDir);
+        if (ops.closeOld) {
+            trace('closeOld', await localPlatformaReadPidAndStop(logger, workDir));
+        }
+        const configPath = upath.join(workDir, LocalConfigYaml);
+        logger.info(`writing configuration '${configPath}'...`);
+        await fsp.writeFile(configPath, ops.config);
+        const plBinPath = upath.join(workDir, 'binaries');
+        const baseBinaryPath = await pl_binary.resolveLocalPlBinaryPath(logger, plBinPath, ops.plBinary);
+        const binaryPath = trace('binaryPath', upath.join('binaries', baseBinaryPath));
+        const processOpts = plProcessOps(binaryPath, configPath, ops, workDir, process.env);
+        trace('processOpts', {
+            cmd: processOpts.cmd,
+            args: processOpts.args,
+            cwd: processOpts.opts.cwd,
+        });
+        const pl = new LocalPl(logger, ops.workingDir, processOpts, t, ops.onClose, ops.onError, ops.onCloseAndError, ops.onCloseAndErrorNoStop);
+        await pl.start();
+        return pl;
+    });
+}
+/** Reads a pid of the old pl-core if it was started in the same working directory,
+ * and closes it. */
+async function localPlatformaReadPidAndStop(logger, workingDir) {
+    return await trace.withTrace(logger, async (trace, t) => {
+        const file = trace('pidFilePath', pid.filePid(workingDir));
+        const oldPid = trace('pid', await pid.readPid(file));
+        const alive = trace('wasAlive', await process$1.isProcessAlive(oldPid));
+        if (oldPid !== undefined && alive) {
+            trace('stopped', process$1.processStop(oldPid));
+            trace('waitStopped', await process$1.processWaitStopped(oldPid, 10_000));
+        }
+        return t;
+    });
+}
+/** Gets default options for the whole init process
+ * and overrides them with the provided options. */
+function mergeDefaultOps(ops, numCpu) {
+    const result = {
+        plBinary: pl_binary.newDefaultPlBinarySource(),
+        spawnOptions: {
+            env: {
+                GOMAXPROCS: String(numCpu),
+            },
+        },
+        closeOld: true,
+    };
+    if (ops.spawnOptions?.env) {
+        result.spawnOptions.env = { ...result.spawnOptions.env, ...ops.spawnOptions.env };
+    }
+    if (ops.spawnOptions) {
+        const withoutEnv = { ...ops.spawnOptions };
+        delete withoutEnv['env'];
+        result.spawnOptions = { ...result.spawnOptions, ...withoutEnv };
+    }
+    const withoutSpawnOps = { ...ops };
+    delete withoutSpawnOps['spawnOptions'];
+    return { ...result, ...withoutSpawnOps };
+}
+/** Gets default options for a platforma local binary
+ * and overrides them with the provided options. */
+function plProcessOps(binaryPath, configPath, ops, workDir, defaultEnv) {
+    const result = {
+        cmd: binaryPath,
+        args: ['--config', configPath],
+        opts: {
+            env: { ...defaultEnv },
+            cwd: workDir,
+            stdio: ['pipe', 'ignore', 'inherit'],
+            windowsHide: true, // hide a terminal on Windows
+        },
+    };
+    if (ops.spawnOptions?.env) {
+        result.opts.env = { ...result.opts.env, ...ops.spawnOptions.env };
+    }
+    const withoutEnv = { ...ops.spawnOptions };
+    delete withoutEnv['env'];
+    result.opts = { ...result.opts, ...withoutEnv };
+    return result;
+}
+
+exports.LocalConfigYaml = LocalConfigYaml;
+exports.LocalPl = LocalPl;
+exports.localPlatformaInit = localPlatformaInit;
+exports.mergeDefaultOps = mergeDefaultOps;
+exports.plProcessOps = plProcessOps;
+//# sourceMappingURL=pl.cjs.map

package/dist/local/pl.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pl.cjs","sources":["../../src/local/pl.ts"],"sourcesContent":["import type {\n  ProcessOptions } from './process';\nimport {\n  isProcessAlive,\n  processStop,\n  processWaitStopped,\n  processRun,\n} from './process';\nimport type { PlBinarySource } from '../common/pl_binary';\nimport { newDefaultPlBinarySource, resolveLocalPlBinaryPath } from '../common/pl_binary';\nimport type { MiLogger } from '@milaboratories/ts-helpers';\nimport { notEmpty } from '@milaboratories/ts-helpers';\nimport type { ChildProcess, SpawnOptions } from 'node:child_process';\nimport { filePid, readPid, writePid } from './pid';\nimport type { Trace } from './trace';\nimport { withTrace } from './trace';\nimport upath from 'upath';\nimport fsp from 'node:fs/promises';\nimport type { Required } from 'utility-types';\nimport * as os from 'node:os';\n\nexport const LocalConfigYaml = 'config-local.yaml';\n\n/**\n * Represents a local running pl-core,\n * and has methods to start, check if it's running, stop and wait for stopping it.\n * Also, a hook on pl-core closed can be provided.\n */\nexport class LocalPl {\n  private instance?: ChildProcess;\n  public pid?: number;\n  private nRuns: number = 0;\n  private lastRunHistory: Trace = {};\n  private wasStopped = false;\n\n  constructor(\n    private readonly logger: MiLogger,\n    private readonly workingDir: string,\n    private readonly startOptions: ProcessOptions,\n    private readonly initialStartHistory: Trace,\n    private readonly onClose?: (pl: LocalPl) => Promise<void>,\n    private readonly onError?: (pl: LocalPl) => Promise<void>,\n    private readonly onCloseAndError?: (pl: LocalPl) => Promise<void>,\n    private readonly onCloseAndErrorNoStop?: (pl: LocalPl) => Promise<void>,\n  ) {}\n\n  async start() {\n    await withTrace(this.logger, async (trace, t) => {\n      this.wasStopped = false;\n      const instance = processRun(this.logger, this.startOptions);\n      instance.on('error', (e: any) => {\n        this.logger.error(\n          `error '${e}', while running platforma, started opts: ${JSON.stringify(this.debugInfo())}`,\n        );\n\n        // keep in mind there are no awaits here, it will be asynchronous\n        if (this.onError !== undefined) void this.onError(this);\n        if (this.onCloseAndError !== undefined) void this.onCloseAndError(this);\n        if (this.onCloseAndErrorNoStop !== undefined && !this.wasStopped)\n          void this.onCloseAndErrorNoStop(this);\n      });\n      instance.on('close', () => {\n        this.logger.warn(`platforma was closed, started opts: ${JSON.stringify(this.debugInfo())}`);\n\n        // keep in mind there are no awaits here, it will be asynchronous\n        if (this.onClose !== undefined) void this.onClose(this);\n        if (this.onCloseAndError !== undefined) void this.onCloseAndError(this);\n        if (this.onCloseAndErrorNoStop !== undefined && !this.wasStopped)\n          void this.onCloseAndErrorNoStop(this);\n      });\n\n      trace('started', true);\n\n      const pidFile = trace('pidFile', filePid(this.workingDir));\n      trace('pid', notEmpty(instance.pid));\n      trace('pidWritten', await writePid(pidFile, notEmpty(instance.pid)));\n\n      this.nRuns++;\n      this.instance = instance;\n      this.pid = instance.pid;\n      this.lastRunHistory = t;\n    });\n  }\n\n  stop() {\n    // TODO use this.instance to stop the process\n    this.wasStopped = true;\n    processStop(notEmpty(this.pid));\n  }\n\n  async waitStopped() {\n    await processWaitStopped(notEmpty(this.pid), 15000);\n  }\n\n  stopped() {\n    return this.wasStopped;\n  }\n\n  async isAlive(): Promise<boolean> {\n    return await isProcessAlive(notEmpty(this.pid));\n  }\n\n  debugInfo() {\n    return {\n      lastRunHistory: this.lastRunHistory,\n      nRuns: this.nRuns,\n      pid: this.pid,\n      workingDir: this.workingDir,\n      initialStartHistory: this.initialStartHistory,\n      wasStopped: this.wasStopped,\n    };\n  }\n}\n\n/** Options to start a local pl-core. */\nexport type LocalPlOptions = {\n  /** From what directory start a process. */\n  readonly workingDir: string;\n  /** A string representation of yaml config. */\n  readonly config: string;\n  /** How to get a binary, download it or get an existing one (default: download latest version) */\n  readonly plBinary?: PlBinarySource;\n  /** Additional options for a process, environments, stdout, stderr etc. */\n  readonly spawnOptions?: SpawnOptions;\n  /**\n   * If the previous pl-core was started from the same directory,\n   * we can check if it's still running and then stop it before starting a new one.\n   * (default: true)\n   */\n  readonly closeOld?: boolean;\n\n  readonly onClose?: (pl: LocalPl) => Promise<void>;\n  readonly onError?: (pl: LocalPl) => Promise<void>;\n  readonly onCloseAndError?: (pl: LocalPl) => Promise<void>;\n  readonly onCloseAndErrorNoStop?: (pl: LocalPl) => Promise<void>;\n};\n\nexport type LocalPlOptionsFull = Required<LocalPlOptions, 'plBinary' | 'spawnOptions' | 'closeOld'>;\n\n/**\n * Starts pl-core, if the option was provided downloads a binary, reads license environments etc.\n */\nexport async function localPlatformaInit(logger: MiLogger, _ops: LocalPlOptions): Promise<LocalPl> {\n  // filling-in default values\n\n  // Backend could consume a lot of CPU power,\n  // we want to keep at least a couple for UI and other apps to work.\n  const numCpu = Math.max(os.cpus().length - 2, 1);\n  const ops = mergeDefaultOps(_ops, numCpu);\n\n  return await withTrace(logger, async (trace, t) => {\n    trace('startOptions', { ...ops, config: 'too wordy' });\n\n    const workDir = upath.resolve(ops.workingDir);\n\n    if (ops.closeOld) {\n      trace('closeOld', await localPlatformaReadPidAndStop(logger, workDir));\n    }\n\n    const configPath = upath.join(workDir, LocalConfigYaml);\n\n    logger.info(`writing configuration '${configPath}'...`);\n    await fsp.writeFile(configPath, ops.config);\n\n    const plBinPath = upath.join(workDir, 'binaries');\n    const baseBinaryPath = await resolveLocalPlBinaryPath(logger, plBinPath, ops.plBinary);\n    const binaryPath = trace('binaryPath', upath.join('binaries', baseBinaryPath));\n\n    const processOpts = plProcessOps(binaryPath, configPath, ops, workDir, process.env);\n    trace('processOpts', {\n      cmd: processOpts.cmd,\n      args: processOpts.args,\n      cwd: processOpts.opts.cwd,\n    });\n\n    const pl = new LocalPl(\n      logger,\n      ops.workingDir,\n      processOpts,\n      t,\n      ops.onClose,\n      ops.onError,\n      ops.onCloseAndError,\n      ops.onCloseAndErrorNoStop,\n    );\n    await pl.start();\n\n    return pl;\n  });\n}\n\n/** Reads a pid of the old pl-core if it was started in the same working directory,\n * and closes it. */\nasync function localPlatformaReadPidAndStop(\n  logger: MiLogger,\n  workingDir: string,\n): Promise<Record<string, any>> {\n  return await withTrace(logger, async (trace, t) => {\n    const file = trace('pidFilePath', filePid(workingDir));\n\n    const oldPid = trace('pid', await readPid(file));\n    const alive = trace('wasAlive', await isProcessAlive(oldPid));\n\n    if (oldPid !== undefined && alive) {\n      trace('stopped', processStop(oldPid));\n      trace('waitStopped', await processWaitStopped(oldPid, 10_000));\n    }\n\n    return t;\n  });\n}\n\n/** Gets default options for the whole init process\n * and overrides them with the provided options. */\nexport function mergeDefaultOps(ops: LocalPlOptions, numCpu: number): LocalPlOptionsFull {\n  const result: {\n    plBinary: PlBinarySource;\n    spawnOptions: SpawnOptions;\n    closeOld: boolean;\n  } = {\n    plBinary: newDefaultPlBinarySource(),\n    spawnOptions: {\n      env: {\n        GOMAXPROCS: String(numCpu),\n      },\n    },\n    closeOld: true,\n  };\n\n  if (ops.spawnOptions?.env) {\n    result.spawnOptions.env = { ...result.spawnOptions.env, ...ops.spawnOptions.env };\n  }\n\n  if (ops.spawnOptions) {\n    const withoutEnv = { ...ops.spawnOptions };\n    delete withoutEnv['env'];\n    result.spawnOptions = { ...result.spawnOptions, ...withoutEnv };\n  }\n\n  const withoutSpawnOps = { ...ops };\n  delete withoutSpawnOps['spawnOptions'];\n\n  return { ...result, ...withoutSpawnOps };\n}\n\n/** Gets default options for a platforma local binary\n * and overrides them with the provided options. */\nexport function plProcessOps(\n  binaryPath: any,\n  configPath: string,\n  ops: LocalPlOptionsFull,\n  workDir: string,\n  defaultEnv: Record<string, string | undefined>,\n): ProcessOptions {\n  const result: ProcessOptions = {\n    cmd: binaryPath,\n    args: ['--config', configPath],\n    opts: {\n      env: { ...defaultEnv },\n      cwd: workDir,\n      stdio: ['pipe', 'ignore', 'inherit'],\n      windowsHide: true, // hide a terminal on Windows\n    },\n  };\n\n  if (ops.spawnOptions?.env) {\n    result.opts.env = { ...result.opts.env, ...ops.spawnOptions.env };\n  }\n\n  const withoutEnv = { ...ops.spawnOptions };\n  delete withoutEnv['env'];\n  result.opts = { ...result.opts, ...withoutEnv };\n\n  return result;\n}\n"],"names":["withTrace","processRun","filePid","notEmpty","writePid","processStop","processWaitStopped","isProcessAlive","os","resolveLocalPlBinaryPath","readPid","newDefaultPlBinarySource"],"mappings":"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"}

package/dist/local/pl.d.ts

@@ -71,4 +71,3 @@ export declare function mergeDefaultOps(ops: LocalPlOptions, numCpu: number): Lo
 /** Gets default options for a platforma local binary
  * and overrides them with the provided options. */
 export declare function plProcessOps(binaryPath: any, configPath: string, ops: LocalPlOptionsFull, workDir: string, defaultEnv: Record<string, string | undefined>): ProcessOptions;
-//# sourceMappingURL=pl.d.ts.map

package/dist/local/pl.js

@@ -0,0 +1,192 @@
+import { processStop, processWaitStopped, isProcessAlive, processRun } from './process.js';
+import { newDefaultPlBinarySource, resolveLocalPlBinaryPath } from '../common/pl_binary.js';
+import { notEmpty } from '@milaboratories/ts-helpers';
+import { filePid, writePid, readPid } from './pid.js';
+import { withTrace } from './trace.js';
+import upath from 'upath';
+import fsp from 'node:fs/promises';
+import * as os from 'node:os';
+
+const LocalConfigYaml = 'config-local.yaml';
+/**
+ * Represents a local running pl-core,
+ * and has methods to start, check if it's running, stop and wait for stopping it.
+ * Also, a hook on pl-core closed can be provided.
+ */
+class LocalPl {
+    logger;
+    workingDir;
+    startOptions;
+    initialStartHistory;
+    onClose;
+    onError;
+    onCloseAndError;
+    onCloseAndErrorNoStop;
+    instance;
+    pid;
+    nRuns = 0;
+    lastRunHistory = {};
+    wasStopped = false;
+    constructor(logger, workingDir, startOptions, initialStartHistory, onClose, onError, onCloseAndError, onCloseAndErrorNoStop) {
+        this.logger = logger;
+        this.workingDir = workingDir;
+        this.startOptions = startOptions;
+        this.initialStartHistory = initialStartHistory;
+        this.onClose = onClose;
+        this.onError = onError;
+        this.onCloseAndError = onCloseAndError;
+        this.onCloseAndErrorNoStop = onCloseAndErrorNoStop;
+    }
+    async start() {
+        await withTrace(this.logger, async (trace, t) => {
+            this.wasStopped = false;
+            const instance = processRun(this.logger, this.startOptions);
+            instance.on('error', (e) => {
+                this.logger.error(`error '${e}', while running platforma, started opts: ${JSON.stringify(this.debugInfo())}`);
+                // keep in mind there are no awaits here, it will be asynchronous
+                if (this.onError !== undefined)
+                    void this.onError(this);
+                if (this.onCloseAndError !== undefined)
+                    void this.onCloseAndError(this);
+                if (this.onCloseAndErrorNoStop !== undefined && !this.wasStopped)
+                    void this.onCloseAndErrorNoStop(this);
+            });
+            instance.on('close', () => {
+                this.logger.warn(`platforma was closed, started opts: ${JSON.stringify(this.debugInfo())}`);
+                // keep in mind there are no awaits here, it will be asynchronous
+                if (this.onClose !== undefined)
+                    void this.onClose(this);
+                if (this.onCloseAndError !== undefined)
+                    void this.onCloseAndError(this);
+                if (this.onCloseAndErrorNoStop !== undefined && !this.wasStopped)
+                    void this.onCloseAndErrorNoStop(this);
+            });
+            trace('started', true);
+            const pidFile = trace('pidFile', filePid(this.workingDir));
+            trace('pid', notEmpty(instance.pid));
+            trace('pidWritten', await writePid(pidFile, notEmpty(instance.pid)));
+            this.nRuns++;
+            this.instance = instance;
+            this.pid = instance.pid;
+            this.lastRunHistory = t;
+        });
+    }
+    stop() {
+        // TODO use this.instance to stop the process
+        this.wasStopped = true;
+        processStop(notEmpty(this.pid));
+    }
+    async waitStopped() {
+        await processWaitStopped(notEmpty(this.pid), 15000);
+    }
+    stopped() {
+        return this.wasStopped;
+    }
+    async isAlive() {
+        return await isProcessAlive(notEmpty(this.pid));
+    }
+    debugInfo() {
+        return {
+            lastRunHistory: this.lastRunHistory,
+            nRuns: this.nRuns,
+            pid: this.pid,
+            workingDir: this.workingDir,
+            initialStartHistory: this.initialStartHistory,
+            wasStopped: this.wasStopped,
+        };
+    }
+}
+/**
+ * Starts pl-core, if the option was provided downloads a binary, reads license environments etc.
+ */
+async function localPlatformaInit(logger, _ops) {
+    // filling-in default values
+    // Backend could consume a lot of CPU power,
+    // we want to keep at least a couple for UI and other apps to work.
+    const numCpu = Math.max(os.cpus().length - 2, 1);
+    const ops = mergeDefaultOps(_ops, numCpu);
+    return await withTrace(logger, async (trace, t) => {
+        trace('startOptions', { ...ops, config: 'too wordy' });
+        const workDir = upath.resolve(ops.workingDir);
+        if (ops.closeOld) {
+            trace('closeOld', await localPlatformaReadPidAndStop(logger, workDir));
+        }
+        const configPath = upath.join(workDir, LocalConfigYaml);
+        logger.info(`writing configuration '${configPath}'...`);
+        await fsp.writeFile(configPath, ops.config);
+        const plBinPath = upath.join(workDir, 'binaries');
+        const baseBinaryPath = await resolveLocalPlBinaryPath(logger, plBinPath, ops.plBinary);
+        const binaryPath = trace('binaryPath', upath.join('binaries', baseBinaryPath));
+        const processOpts = plProcessOps(binaryPath, configPath, ops, workDir, process.env);
+        trace('processOpts', {
+            cmd: processOpts.cmd,
+            args: processOpts.args,
+            cwd: processOpts.opts.cwd,
+        });
+        const pl = new LocalPl(logger, ops.workingDir, processOpts, t, ops.onClose, ops.onError, ops.onCloseAndError, ops.onCloseAndErrorNoStop);
+        await pl.start();
+        return pl;
+    });
+}
+/** Reads a pid of the old pl-core if it was started in the same working directory,
+ * and closes it. */
+async function localPlatformaReadPidAndStop(logger, workingDir) {
+    return await withTrace(logger, async (trace, t) => {
+        const file = trace('pidFilePath', filePid(workingDir));
+        const oldPid = trace('pid', await readPid(file));
+        const alive = trace('wasAlive', await isProcessAlive(oldPid));
+        if (oldPid !== undefined && alive) {
+            trace('stopped', processStop(oldPid));
+            trace('waitStopped', await processWaitStopped(oldPid, 10_000));
+        }
+        return t;
+    });
+}
+/** Gets default options for the whole init process
+ * and overrides them with the provided options. */
+function mergeDefaultOps(ops, numCpu) {
+    const result = {
+        plBinary: newDefaultPlBinarySource(),
+        spawnOptions: {
+            env: {
+                GOMAXPROCS: String(numCpu),
+            },
+        },
+        closeOld: true,
+    };
+    if (ops.spawnOptions?.env) {
+        result.spawnOptions.env = { ...result.spawnOptions.env, ...ops.spawnOptions.env };
+    }
+    if (ops.spawnOptions) {
+        const withoutEnv = { ...ops.spawnOptions };
+        delete withoutEnv['env'];
+        result.spawnOptions = { ...result.spawnOptions, ...withoutEnv };
+    }
+    const withoutSpawnOps = { ...ops };
+    delete withoutSpawnOps['spawnOptions'];
+    return { ...result, ...withoutSpawnOps };
+}
+/** Gets default options for a platforma local binary
+ * and overrides them with the provided options. */
+function plProcessOps(binaryPath, configPath, ops, workDir, defaultEnv) {
+    const result = {
+        cmd: binaryPath,
+        args: ['--config', configPath],
+        opts: {
+            env: { ...defaultEnv },
+            cwd: workDir,
+            stdio: ['pipe', 'ignore', 'inherit'],
+            windowsHide: true, // hide a terminal on Windows
+        },
+    };
+    if (ops.spawnOptions?.env) {
+        result.opts.env = { ...result.opts.env, ...ops.spawnOptions.env };
+    }
+    const withoutEnv = { ...ops.spawnOptions };
+    delete withoutEnv['env'];
+    result.opts = { ...result.opts, ...withoutEnv };
+    return result;
+}
+
+export { LocalConfigYaml, LocalPl, localPlatformaInit, mergeDefaultOps, plProcessOps };
+//# sourceMappingURL=pl.js.map

package/dist/local/pl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pl.js","sources":["../../src/local/pl.ts"],"sourcesContent":["import type {\n  ProcessOptions } from './process';\nimport {\n  isProcessAlive,\n  processStop,\n  processWaitStopped,\n  processRun,\n} from './process';\nimport type { PlBinarySource } from '../common/pl_binary';\nimport { newDefaultPlBinarySource, resolveLocalPlBinaryPath } from '../common/pl_binary';\nimport type { MiLogger } from '@milaboratories/ts-helpers';\nimport { notEmpty } from '@milaboratories/ts-helpers';\nimport type { ChildProcess, SpawnOptions } from 'node:child_process';\nimport { filePid, readPid, writePid } from './pid';\nimport type { Trace } from './trace';\nimport { withTrace } from './trace';\nimport upath from 'upath';\nimport fsp from 'node:fs/promises';\nimport type { Required } from 'utility-types';\nimport * as os from 'node:os';\n\nexport const LocalConfigYaml = 'config-local.yaml';\n\n/**\n * Represents a local running pl-core,\n * and has methods to start, check if it's running, stop and wait for stopping it.\n * Also, a hook on pl-core closed can be provided.\n */\nexport class LocalPl {\n  private instance?: ChildProcess;\n  public pid?: number;\n  private nRuns: number = 0;\n  private lastRunHistory: Trace = {};\n  private wasStopped = false;\n\n  constructor(\n    private readonly logger: MiLogger,\n    private readonly workingDir: string,\n    private readonly startOptions: ProcessOptions,\n    private readonly initialStartHistory: Trace,\n    private readonly onClose?: (pl: LocalPl) => Promise<void>,\n    private readonly onError?: (pl: LocalPl) => Promise<void>,\n    private readonly onCloseAndError?: (pl: LocalPl) => Promise<void>,\n    private readonly onCloseAndErrorNoStop?: (pl: LocalPl) => Promise<void>,\n  ) {}\n\n  async start() {\n    await withTrace(this.logger, async (trace, t) => {\n      this.wasStopped = false;\n      const instance = processRun(this.logger, this.startOptions);\n      instance.on('error', (e: any) => {\n        this.logger.error(\n          `error '${e}', while running platforma, started opts: ${JSON.stringify(this.debugInfo())}`,\n        );\n\n        // keep in mind there are no awaits here, it will be asynchronous\n        if (this.onError !== undefined) void this.onError(this);\n        if (this.onCloseAndError !== undefined) void this.onCloseAndError(this);\n        if (this.onCloseAndErrorNoStop !== undefined && !this.wasStopped)\n          void this.onCloseAndErrorNoStop(this);\n      });\n      instance.on('close', () => {\n        this.logger.warn(`platforma was closed, started opts: ${JSON.stringify(this.debugInfo())}`);\n\n        // keep in mind there are no awaits here, it will be asynchronous\n        if (this.onClose !== undefined) void this.onClose(this);\n        if (this.onCloseAndError !== undefined) void this.onCloseAndError(this);\n        if (this.onCloseAndErrorNoStop !== undefined && !this.wasStopped)\n          void this.onCloseAndErrorNoStop(this);\n      });\n\n      trace('started', true);\n\n      const pidFile = trace('pidFile', filePid(this.workingDir));\n      trace('pid', notEmpty(instance.pid));\n      trace('pidWritten', await writePid(pidFile, notEmpty(instance.pid)));\n\n      this.nRuns++;\n      this.instance = instance;\n      this.pid = instance.pid;\n      this.lastRunHistory = t;\n    });\n  }\n\n  stop() {\n    // TODO use this.instance to stop the process\n    this.wasStopped = true;\n    processStop(notEmpty(this.pid));\n  }\n\n  async waitStopped() {\n    await processWaitStopped(notEmpty(this.pid), 15000);\n  }\n\n  stopped() {\n    return this.wasStopped;\n  }\n\n  async isAlive(): Promise<boolean> {\n    return await isProcessAlive(notEmpty(this.pid));\n  }\n\n  debugInfo() {\n    return {\n      lastRunHistory: this.lastRunHistory,\n      nRuns: this.nRuns,\n      pid: this.pid,\n      workingDir: this.workingDir,\n      initialStartHistory: this.initialStartHistory,\n      wasStopped: this.wasStopped,\n    };\n  }\n}\n\n/** Options to start a local pl-core. */\nexport type LocalPlOptions = {\n  /** From what directory start a process. */\n  readonly workingDir: string;\n  /** A string representation of yaml config. */\n  readonly config: string;\n  /** How to get a binary, download it or get an existing one (default: download latest version) */\n  readonly plBinary?: PlBinarySource;\n  /** Additional options for a process, environments, stdout, stderr etc. */\n  readonly spawnOptions?: SpawnOptions;\n  /**\n   * If the previous pl-core was started from the same directory,\n   * we can check if it's still running and then stop it before starting a new one.\n   * (default: true)\n   */\n  readonly closeOld?: boolean;\n\n  readonly onClose?: (pl: LocalPl) => Promise<void>;\n  readonly onError?: (pl: LocalPl) => Promise<void>;\n  readonly onCloseAndError?: (pl: LocalPl) => Promise<void>;\n  readonly onCloseAndErrorNoStop?: (pl: LocalPl) => Promise<void>;\n};\n\nexport type LocalPlOptionsFull = Required<LocalPlOptions, 'plBinary' | 'spawnOptions' | 'closeOld'>;\n\n/**\n * Starts pl-core, if the option was provided downloads a binary, reads license environments etc.\n */\nexport async function localPlatformaInit(logger: MiLogger, _ops: LocalPlOptions): Promise<LocalPl> {\n  // filling-in default values\n\n  // Backend could consume a lot of CPU power,\n  // we want to keep at least a couple for UI and other apps to work.\n  const numCpu = Math.max(os.cpus().length - 2, 1);\n  const ops = mergeDefaultOps(_ops, numCpu);\n\n  return await withTrace(logger, async (trace, t) => {\n    trace('startOptions', { ...ops, config: 'too wordy' });\n\n    const workDir = upath.resolve(ops.workingDir);\n\n    if (ops.closeOld) {\n      trace('closeOld', await localPlatformaReadPidAndStop(logger, workDir));\n    }\n\n    const configPath = upath.join(workDir, LocalConfigYaml);\n\n    logger.info(`writing configuration '${configPath}'...`);\n    await fsp.writeFile(configPath, ops.config);\n\n    const plBinPath = upath.join(workDir, 'binaries');\n    const baseBinaryPath = await resolveLocalPlBinaryPath(logger, plBinPath, ops.plBinary);\n    const binaryPath = trace('binaryPath', upath.join('binaries', baseBinaryPath));\n\n    const processOpts = plProcessOps(binaryPath, configPath, ops, workDir, process.env);\n    trace('processOpts', {\n      cmd: processOpts.cmd,\n      args: processOpts.args,\n      cwd: processOpts.opts.cwd,\n    });\n\n    const pl = new LocalPl(\n      logger,\n      ops.workingDir,\n      processOpts,\n      t,\n      ops.onClose,\n      ops.onError,\n      ops.onCloseAndError,\n      ops.onCloseAndErrorNoStop,\n    );\n    await pl.start();\n\n    return pl;\n  });\n}\n\n/** Reads a pid of the old pl-core if it was started in the same working directory,\n * and closes it. */\nasync function localPlatformaReadPidAndStop(\n  logger: MiLogger,\n  workingDir: string,\n): Promise<Record<string, any>> {\n  return await withTrace(logger, async (trace, t) => {\n    const file = trace('pidFilePath', filePid(workingDir));\n\n    const oldPid = trace('pid', await readPid(file));\n    const alive = trace('wasAlive', await isProcessAlive(oldPid));\n\n    if (oldPid !== undefined && alive) {\n      trace('stopped', processStop(oldPid));\n      trace('waitStopped', await processWaitStopped(oldPid, 10_000));\n    }\n\n    return t;\n  });\n}\n\n/** Gets default options for the whole init process\n * and overrides them with the provided options. */\nexport function mergeDefaultOps(ops: LocalPlOptions, numCpu: number): LocalPlOptionsFull {\n  const result: {\n    plBinary: PlBinarySource;\n    spawnOptions: SpawnOptions;\n    closeOld: boolean;\n  } = {\n    plBinary: newDefaultPlBinarySource(),\n    spawnOptions: {\n      env: {\n        GOMAXPROCS: String(numCpu),\n      },\n    },\n    closeOld: true,\n  };\n\n  if (ops.spawnOptions?.env) {\n    result.spawnOptions.env = { ...result.spawnOptions.env, ...ops.spawnOptions.env };\n  }\n\n  if (ops.spawnOptions) {\n    const withoutEnv = { ...ops.spawnOptions };\n    delete withoutEnv['env'];\n    result.spawnOptions = { ...result.spawnOptions, ...withoutEnv };\n  }\n\n  const withoutSpawnOps = { ...ops };\n  delete withoutSpawnOps['spawnOptions'];\n\n  return { ...result, ...withoutSpawnOps };\n}\n\n/** Gets default options for a platforma local binary\n * and overrides them with the provided options. */\nexport function plProcessOps(\n  binaryPath: any,\n  configPath: string,\n  ops: LocalPlOptionsFull,\n  workDir: string,\n  defaultEnv: Record<string, string | undefined>,\n): ProcessOptions {\n  const result: ProcessOptions = {\n    cmd: binaryPath,\n    args: ['--config', configPath],\n    opts: {\n      env: { ...defaultEnv },\n      cwd: workDir,\n      stdio: ['pipe', 'ignore', 'inherit'],\n      windowsHide: true, // hide a terminal on Windows\n    },\n  };\n\n  if (ops.spawnOptions?.env) {\n    result.opts.env = { ...result.opts.env, ...ops.spawnOptions.env };\n  }\n\n  const withoutEnv = { ...ops.spawnOptions };\n  delete withoutEnv['env'];\n  result.opts = { ...result.opts, ...withoutEnv };\n\n  return result;\n}\n"],"names":[],"mappings":";;;;;;;;;AAqBO,MAAM,eAAe,GAAG;AAE/B;;;;AAIG;MACU,OAAO,CAAA;AAQC,IAAA,MAAA;AACA,IAAA,UAAA;AACA,IAAA,YAAA;AACA,IAAA,mBAAA;AACA,IAAA,OAAA;AACA,IAAA,OAAA;AACA,IAAA,eAAA;AACA,IAAA,qBAAA;AAdX,IAAA,QAAQ;AACT,IAAA,GAAG;IACF,KAAK,GAAW,CAAC;IACjB,cAAc,GAAU,EAAE;IAC1B,UAAU,GAAG,KAAK;AAE1B,IAAA,WAAA,CACmB,MAAgB,EAChB,UAAkB,EAClB,YAA4B,EAC5B,mBAA0B,EAC1B,OAAwC,EACxC,OAAwC,EACxC,eAAgD,EAChD,qBAAsD,EAAA;QAPtD,IAAA,CAAA,MAAM,GAAN,MAAM;QACN,IAAA,CAAA,UAAU,GAAV,UAAU;QACV,IAAA,CAAA,YAAY,GAAZ,YAAY;QACZ,IAAA,CAAA,mBAAmB,GAAnB,mBAAmB;QACnB,IAAA,CAAA,OAAO,GAAP,OAAO;QACP,IAAA,CAAA,OAAO,GAAP,OAAO;QACP,IAAA,CAAA,eAAe,GAAf,eAAe;QACf,IAAA,CAAA,qBAAqB,GAArB,qBAAqB;IACrC;AAEH,IAAA,MAAM,KAAK,GAAA;AACT,QAAA,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,KAAK,EAAE,CAAC,KAAI;AAC9C,YAAA,IAAI,CAAC,UAAU,GAAG,KAAK;AACvB,YAAA,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC;YAC3D,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAM,KAAI;AAC9B,gBAAA,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,CAAA,OAAA,EAAU,CAAC,CAAA,0CAAA,EAA6C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA,CAAE,CAC3F;;AAGD,gBAAA,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;AAAE,oBAAA,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;AACvD,gBAAA,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS;AAAE,oBAAA,KAAK,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;gBACvE,IAAI,IAAI,CAAC,qBAAqB,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,UAAU;AAC9D,oBAAA,KAAK,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC;AACzC,YAAA,CAAC,CAAC;AACF,YAAA,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAK;AACxB,gBAAA,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uCAAuC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA,CAAE,CAAC;;AAG3F,gBAAA,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;AAAE,oBAAA,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;AACvD,gBAAA,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS;AAAE,oBAAA,KAAK,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;gBACvE,IAAI,IAAI,CAAC,qBAAqB,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,UAAU;AAC9D,oBAAA,KAAK,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC;AACzC,YAAA,CAAC,CAAC;AAEF,YAAA,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC;AAEtB,YAAA,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC1D,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACpC,YAAA,KAAK,CAAC,YAAY,EAAE,MAAM,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;YAEpE,IAAI,CAAC,KAAK,EAAE;AACZ,YAAA,IAAI,CAAC,QAAQ,GAAG,QAAQ;AACxB,YAAA,IAAI,CAAC,GAAG,GAAG,QAAQ,CAAC,GAAG;AACvB,YAAA,IAAI,CAAC,cAAc,GAAG,CAAC;AACzB,QAAA,CAAC,CAAC;IACJ;IAEA,IAAI,GAAA;;AAEF,QAAA,IAAI,CAAC,UAAU,GAAG,IAAI;QACtB,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC;AAEA,IAAA,MAAM,WAAW,GAAA;QACf,MAAM,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC;IACrD;IAEA,OAAO,GAAA;QACL,OAAO,IAAI,CAAC,UAAU;IACxB;AAEA,IAAA,MAAM,OAAO,GAAA;QACX,OAAO,MAAM,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjD;IAEA,SAAS,GAAA;QACP,OAAO;YACL,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;YAC7C,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B;IACH;AACD;AA2BD;;AAEG;AACI,eAAe,kBAAkB,CAAC,MAAgB,EAAE,IAAoB,EAAA;;;;AAK7E,IAAA,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC;IAEzC,OAAO,MAAM,SAAS,CAAC,MAAM,EAAE,OAAO,KAAK,EAAE,CAAC,KAAI;AAChD,QAAA,KAAK,CAAC,cAAc,EAAE,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAEtD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;AAE7C,QAAA,IAAI,GAAG,CAAC,QAAQ,EAAE;YAChB,KAAK,CAAC,UAAU,EAAE,MAAM,4BAA4B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACxE;QAEA,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC;AAEvD,QAAA,MAAM,CAAC,IAAI,CAAC,0BAA0B,UAAU,CAAA,IAAA,CAAM,CAAC;QACvD,MAAM,GAAG,CAAC,SAAS,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC;QAE3C,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC;AACjD,QAAA,MAAM,cAAc,GAAG,MAAM,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC;AACtF,QAAA,MAAM,UAAU,GAAG,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;AAE9E,QAAA,MAAM,WAAW,GAAG,YAAY,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC;QACnF,KAAK,CAAC,aAAa,EAAE;YACnB,GAAG,EAAE,WAAW,CAAC,GAAG;YACpB,IAAI,EAAE,WAAW,CAAC,IAAI;AACtB,YAAA,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG;AAC1B,SAAA,CAAC;AAEF,QAAA,MAAM,EAAE,GAAG,IAAI,OAAO,CACpB,MAAM,EACN,GAAG,CAAC,UAAU,EACd,WAAW,EACX,CAAC,EACD,GAAG,CAAC,OAAO,EACX,GAAG,CAAC,OAAO,EACX,GAAG,CAAC,eAAe,EACnB,GAAG,CAAC,qBAAqB,CAC1B;AACD,QAAA,MAAM,EAAE,CAAC,KAAK,EAAE;AAEhB,QAAA,OAAO,EAAE;AACX,IAAA,CAAC,CAAC;AACJ;AAEA;AACoB;AACpB,eAAe,4BAA4B,CACzC,MAAgB,EAChB,UAAkB,EAAA;IAElB,OAAO,MAAM,SAAS,CAAC,MAAM,EAAE,OAAO,KAAK,EAAE,CAAC,KAAI;QAChD,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtD,QAAA,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAChD,QAAA,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,EAAE,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;AAE7D,QAAA,IAAI,MAAM,KAAK,SAAS,IAAI,KAAK,EAAE;YACjC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;YACrC,KAAK,CAAC,aAAa,EAAE,MAAM,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChE;AAEA,QAAA,OAAO,CAAC;AACV,IAAA,CAAC,CAAC;AACJ;AAEA;AACmD;AAC7C,SAAU,eAAe,CAAC,GAAmB,EAAE,MAAc,EAAA;AACjE,IAAA,MAAM,MAAM,GAIR;QACF,QAAQ,EAAE,wBAAwB,EAAE;AACpC,QAAA,YAAY,EAAE;AACZ,YAAA,GAAG,EAAE;AACH,gBAAA,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;AAC3B,aAAA;AACF,SAAA;AACD,QAAA,QAAQ,EAAE,IAAI;KACf;AAED,IAAA,IAAI,GAAG,CAAC,YAAY,EAAE,GAAG,EAAE;QACzB,MAAM,CAAC,YAAY,CAAC,GAAG,GAAG,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,EAAE;IACnF;AAEA,IAAA,IAAI,GAAG,CAAC,YAAY,EAAE;QACpB,MAAM,UAAU,GAAG,EAAE,GAAG,GAAG,CAAC,YAAY,EAAE;AAC1C,QAAA,OAAO,UAAU,CAAC,KAAK,CAAC;AACxB,QAAA,MAAM,CAAC,YAAY,GAAG,EAAE,GAAG,MAAM,CAAC,YAAY,EAAE,GAAG,UAAU,EAAE;IACjE;AAEA,IAAA,MAAM,eAAe,GAAG,EAAE,GAAG,GAAG,EAAE;AAClC,IAAA,OAAO,eAAe,CAAC,cAAc,CAAC;AAEtC,IAAA,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,eAAe,EAAE;AAC1C;AAEA;AACmD;AAC7C,SAAU,YAAY,CAC1B,UAAe,EACf,UAAkB,EAClB,GAAuB,EACvB,OAAe,EACf,UAA8C,EAAA;AAE9C,IAAA,MAAM,MAAM,GAAmB;AAC7B,QAAA,GAAG,EAAE,UAAU;AACf,QAAA,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;AAC9B,QAAA,IAAI,EAAE;AACJ,YAAA,GAAG,EAAE,EAAE,GAAG,UAAU,EAAE;AACtB,YAAA,GAAG,EAAE,OAAO;AACZ,YAAA,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC;YACpC,WAAW,EAAE,IAAI;AAClB,SAAA;KACF;AAED,IAAA,IAAI,GAAG,CAAC,YAAY,EAAE,GAAG,EAAE;QACzB,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,EAAE;IACnE;IAEA,MAAM,UAAU,GAAG,EAAE,GAAG,GAAG,CAAC,YAAY,EAAE;AAC1C,IAAA,OAAO,UAAU,CAAC,KAAK,CAAC;AACxB,IAAA,MAAM,CAAC,IAAI,GAAG,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,GAAG,UAAU,EAAE;AAE/C,IAAA,OAAO,MAAM;AACf;;;;"}

package/dist/local/process.cjs

@@ -0,0 +1,42 @@
+'use strict';
+
+var node_child_process = require('node:child_process');
+var tsHelpers = require('@milaboratories/ts-helpers');
+
+function processRun(logger, opts) {
+    logger.info(`Running:
+cmd: ${JSON.stringify([opts.cmd, ...opts.args])}
+wd: ${opts.opts.cwd}`);
+    logger.info('  spawning child process');
+    return node_child_process.spawn(opts.cmd, opts.args, opts.opts);
+}
+// eslint-disable-next-line @typescript-eslint/require-await
+async function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (_e) {
+        return false;
+    }
+}
+function processStop(pid) {
+    return process.kill(pid, 'SIGINT');
+}
+async function processWaitStopped(pid, maxMs) {
+    const sleepMs = 100;
+    let total = 0;
+    while (await isProcessAlive(pid)) {
+        await tsHelpers.sleep(sleepMs);
+        total += sleepMs;
+        if (total > maxMs) {
+            throw new Error(`The process did not stopped after ${maxMs} ms.`);
+        }
+    }
+}
+
+exports.isProcessAlive = isProcessAlive;
+exports.processRun = processRun;
+exports.processStop = processStop;
+exports.processWaitStopped = processWaitStopped;
+//# sourceMappingURL=process.cjs.map

package/dist/local/process.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.cjs","sources":["../../src/local/process.ts"],"sourcesContent":["import type { SpawnOptions, ChildProcess } from 'node:child_process';\nimport { spawn } from 'node:child_process';\nimport type { MiLogger } from '@milaboratories/ts-helpers';\nimport { sleep } from '@milaboratories/ts-helpers';\n\nexport type ProcessOptions = {\n  cmd: string;\n  args: string[];\n  opts: SpawnOptions;\n};\n\nexport function processRun(logger: MiLogger, opts: ProcessOptions): ChildProcess {\n  logger.info(`Running:\ncmd: ${JSON.stringify([opts.cmd, ...opts.args])}\nwd: ${opts.opts.cwd}`);\n\n  logger.info('  spawning child process');\n  return spawn(opts.cmd, opts.args, opts.opts);\n}\n\n// eslint-disable-next-line @typescript-eslint/require-await\nexport async function isProcessAlive(pid: number) {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch (_e) {\n    return false;\n  }\n}\n\nexport function processStop(pid: number) {\n  return process.kill(pid, 'SIGINT');\n}\n\nexport async function processWaitStopped(pid: number, maxMs: number) {\n  const sleepMs = 100;\n  let total = 0;\n  while (await isProcessAlive(pid)) {\n    await sleep(sleepMs);\n    total += sleepMs;\n    if (total > maxMs) {\n      throw new Error(`The process did not stopped after ${maxMs} ms.`);\n    }\n  }\n}\n"],"names":["spawn","sleep"],"mappings":";;;;;AAWM,SAAU,UAAU,CAAC,MAAgB,EAAE,IAAoB,EAAA;IAC/D,MAAM,CAAC,IAAI,CAAC,CAAA;AACP,KAAA,EAAA,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;AACzC,IAAA,EAAA,IAAI,CAAC,IAAI,CAAC,GAAG,CAAA,CAAE,CAAC;AAEpB,IAAA,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC;AACvC,IAAA,OAAOA,wBAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;AAC9C;AAEA;AACO,eAAe,cAAc,CAAC,GAAW,EAAA;AAC9C,IAAA,IAAI;AACF,QAAA,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;AACpB,QAAA,OAAO,IAAI;IACb;IAAE,OAAO,EAAE,EAAE;AACX,QAAA,OAAO,KAAK;IACd;AACF;AAEM,SAAU,WAAW,CAAC,GAAW,EAAA;IACrC,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC;AACpC;AAEO,eAAe,kBAAkB,CAAC,GAAW,EAAE,KAAa,EAAA;IACjE,MAAM,OAAO,GAAG,GAAG;IACnB,IAAI,KAAK,GAAG,CAAC;AACb,IAAA,OAAO,MAAM,cAAc,CAAC,GAAG,CAAC,EAAE;AAChC,QAAA,MAAMC,eAAK,CAAC,OAAO,CAAC;QACpB,KAAK,IAAI,OAAO;AAChB,QAAA,IAAI,KAAK,GAAG,KAAK,EAAE;AACjB,YAAA,MAAM,IAAI,KAAK,CAAC,qCAAqC,KAAK,CAAA,IAAA,CAAM,CAAC;QACnE;IACF;AACF;;;;;;;"}

package/dist/local/process.d.ts

@@ -9,4 +9,3 @@ export declare function processRun(logger: MiLogger, opts: ProcessOptions): Chil
 export declare function isProcessAlive(pid: number): Promise<boolean>;
 export declare function processStop(pid: number): true;
 export declare function processWaitStopped(pid: number, maxMs: number): Promise<void>;
-//# sourceMappingURL=process.d.ts.map

package/dist/local/process.js

@@ -0,0 +1,37 @@
+import { spawn } from 'node:child_process';
+import { sleep } from '@milaboratories/ts-helpers';
+
+function processRun(logger, opts) {
+    logger.info(`Running:
+cmd: ${JSON.stringify([opts.cmd, ...opts.args])}
+wd: ${opts.opts.cwd}`);
+    logger.info('  spawning child process');
+    return spawn(opts.cmd, opts.args, opts.opts);
+}
+// eslint-disable-next-line @typescript-eslint/require-await
+async function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (_e) {
+        return false;
+    }
+}
+function processStop(pid) {
+    return process.kill(pid, 'SIGINT');
+}
+async function processWaitStopped(pid, maxMs) {
+    const sleepMs = 100;
+    let total = 0;
+    while (await isProcessAlive(pid)) {
+        await sleep(sleepMs);
+        total += sleepMs;
+        if (total > maxMs) {
+            throw new Error(`The process did not stopped after ${maxMs} ms.`);
+        }
+    }
+}
+
+export { isProcessAlive, processRun, processStop, processWaitStopped };
+//# sourceMappingURL=process.js.map

package/dist/local/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sources":["../../src/local/process.ts"],"sourcesContent":["import type { SpawnOptions, ChildProcess } from 'node:child_process';\nimport { spawn } from 'node:child_process';\nimport type { MiLogger } from '@milaboratories/ts-helpers';\nimport { sleep } from '@milaboratories/ts-helpers';\n\nexport type ProcessOptions = {\n  cmd: string;\n  args: string[];\n  opts: SpawnOptions;\n};\n\nexport function processRun(logger: MiLogger, opts: ProcessOptions): ChildProcess {\n  logger.info(`Running:\ncmd: ${JSON.stringify([opts.cmd, ...opts.args])}\nwd: ${opts.opts.cwd}`);\n\n  logger.info('  spawning child process');\n  return spawn(opts.cmd, opts.args, opts.opts);\n}\n\n// eslint-disable-next-line @typescript-eslint/require-await\nexport async function isProcessAlive(pid: number) {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch (_e) {\n    return false;\n  }\n}\n\nexport function processStop(pid: number) {\n  return process.kill(pid, 'SIGINT');\n}\n\nexport async function processWaitStopped(pid: number, maxMs: number) {\n  const sleepMs = 100;\n  let total = 0;\n  while (await isProcessAlive(pid)) {\n    await sleep(sleepMs);\n    total += sleepMs;\n    if (total > maxMs) {\n      throw new Error(`The process did not stopped after ${maxMs} ms.`);\n    }\n  }\n}\n"],"names":[],"mappings":";;;AAWM,SAAU,UAAU,CAAC,MAAgB,EAAE,IAAoB,EAAA;IAC/D,MAAM,CAAC,IAAI,CAAC,CAAA;AACP,KAAA,EAAA,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;AACzC,IAAA,EAAA,IAAI,CAAC,IAAI,CAAC,GAAG,CAAA,CAAE,CAAC;AAEpB,IAAA,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC;AACvC,IAAA,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;AAC9C;AAEA;AACO,eAAe,cAAc,CAAC,GAAW,EAAA;AAC9C,IAAA,IAAI;AACF,QAAA,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;AACpB,QAAA,OAAO,IAAI;IACb;IAAE,OAAO,EAAE,EAAE;AACX,QAAA,OAAO,KAAK;IACd;AACF;AAEM,SAAU,WAAW,CAAC,GAAW,EAAA;IACrC,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC;AACpC;AAEO,eAAe,kBAAkB,CAAC,GAAW,EAAE,KAAa,EAAA;IACjE,MAAM,OAAO,GAAG,GAAG;IACnB,IAAI,KAAK,GAAG,CAAC;AACb,IAAA,OAAO,MAAM,cAAc,CAAC,GAAG,CAAC,EAAE;AAChC,QAAA,MAAM,KAAK,CAAC,OAAO,CAAC;QACpB,KAAK,IAAI,OAAO;AAChB,QAAA,IAAI,KAAK,GAAG,KAAK,EAAE;AACjB,YAAA,MAAM,IAAI,KAAK,CAAC,qCAAqC,KAAK,CAAA,IAAA,CAAM,CAAC;QACnE;IACF;AACF;;;;"}

package/dist/local/trace.cjs

@@ -0,0 +1,27 @@
+'use strict';
+
+function newTrace() {
+    return {};
+}
+function trace(t, k, v) {
+    t[k] = v;
+    return v;
+}
+/** Creates a trace and runs a function with it. The function can record all its
+ * logs or traces using `trace` fn. */
+async function withTrace(logger, fn) {
+    const t = newTrace();
+    try {
+        const result = await fn((k, v) => trace(t, k, v), t);
+        return result;
+    }
+    catch (e) {
+        logger.error(`error ${e} while doing traced operation, state: ${JSON.stringify(t)}`);
+        throw e;
+    }
+}
+
+exports.newTrace = newTrace;
+exports.trace = trace;
+exports.withTrace = withTrace;
+//# sourceMappingURL=trace.cjs.map

package/dist/local/trace.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.cjs","sources":["../../src/local/trace.ts"],"sourcesContent":["import type { MiLogger } from '@milaboratories/ts-helpers';\n\n/** Records all inputs and outputs of one's choice, so if the error happened\n * one can check how it was by just printing this structure. */\nexport type Trace = Record<string, any>;\n\nexport function newTrace(): Trace {\n  return {};\n}\n\nexport function trace(t: Trace, k: string, v: any) {\n  t[k] = v;\n  return v;\n}\n\n/** Creates a trace and runs a function with it. The function can record all its\n * logs or traces using `trace` fn. */\nexport async function withTrace<T>(\n  logger: MiLogger,\n  fn: (trace: (k: string, v: any) => typeof v, t: Trace) => Promise<T>,\n): Promise<T> {\n  const t = newTrace();\n  try {\n    const result = await fn((k: string, v: any) => trace(t, k, v), t);\n    return result;\n  } catch (e: any) {\n    logger.error(`error ${e} while doing traced operation, state: ${JSON.stringify(t)}`);\n    throw e;\n  }\n}\n"],"names":[],"mappings":";;SAMgB,QAAQ,GAAA;AACtB,IAAA,OAAO,EAAE;AACX;SAEgB,KAAK,CAAC,CAAQ,EAAE,CAAS,EAAE,CAAM,EAAA;AAC/C,IAAA,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACR,IAAA,OAAO,CAAC;AACV;AAEA;AACsC;AAC/B,eAAe,SAAS,CAC7B,MAAgB,EAChB,EAAoE,EAAA;AAEpE,IAAA,MAAM,CAAC,GAAG,QAAQ,EAAE;AACpB,IAAA,IAAI;QACF,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC,CAAS,EAAE,CAAM,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AACjE,QAAA,OAAO,MAAM;IACf;IAAE,OAAO,CAAM,EAAE;AACf,QAAA,MAAM,CAAC,KAAK,CAAC,CAAA,MAAA,EAAS,CAAC,CAAA,sCAAA,EAAyC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA,CAAE,CAAC;AACpF,QAAA,MAAM,CAAC;IACT;AACF;;;;;;"}

package/dist/local/trace.d.ts

@@ -7,4 +7,3 @@ export declare function trace(t: Trace, k: string, v: any): any;
 /** Creates a trace and runs a function with it. The function can record all its
  * logs or traces using `trace` fn. */
 export declare function withTrace<T>(logger: MiLogger, fn: (trace: (k: string, v: any) => typeof v, t: Trace) => Promise<T>): Promise<T>;
-//# sourceMappingURL=trace.d.ts.map

package/dist/local/trace.js

@@ -0,0 +1,23 @@
+function newTrace() {
+    return {};
+}
+function trace(t, k, v) {
+    t[k] = v;
+    return v;
+}
+/** Creates a trace and runs a function with it. The function can record all its
+ * logs or traces using `trace` fn. */
+async function withTrace(logger, fn) {
+    const t = newTrace();
+    try {
+        const result = await fn((k, v) => trace(t, k, v), t);
+        return result;
+    }
+    catch (e) {
+        logger.error(`error ${e} while doing traced operation, state: ${JSON.stringify(t)}`);
+        throw e;
+    }
+}
+
+export { newTrace, trace, withTrace };
+//# sourceMappingURL=trace.js.map