@platforma-sdk/bootstrap 3.5.19 → 3.5.20

package/dist/platforma.cjs

@@ -0,0 +1,169 @@
+'use strict';
+
+var os = require('node:os');
+var fs = require('node:fs');
+var https = require('node:https');
+var path = require('node:path');
+var tar = require('tar');
+var state = require('./state.cjs');
+var plDeployments = require('@milaboratories/pl-deployments');
+
+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 tar__namespace = /*#__PURE__*/_interopNamespaceDefault(tar);
+
+const OSes = ['linux', 'macos', 'windows'];
+function archiveOS(osName) {
+    const platform = os.platform();
+    switch (platform) {
+        case 'darwin':
+            return 'macos';
+        case 'linux':
+            return 'linux';
+        case 'win32':
+            return 'windows';
+        default:
+            throw new Error(`operating system '${platform}' is not currently supported by Platforma ecosystem. The list of OSes supported: `
+                + JSON.stringify(OSes));
+    }
+}
+const Arches = ['amd64', 'arm64'];
+function archiveArch(archName) {
+    const arch = os.arch();
+    switch (arch) {
+        case 'arm64':
+            return 'arm64';
+        case 'x64':
+            return 'amd64';
+        default:
+            throw new Error(`processor architecture '${arch}' is not currently supported by Platforma ecosystem. The list of architectures supported: `
+                + JSON.stringify(Arches));
+    }
+}
+function downloadArchive(logger, options) {
+    const version = options?.version ?? plDeployments.getDefaultPlVersion();
+    const showProgress = options?.showProgress ?? process.stdout.isTTY;
+    const archiveName = `pl-${version}-${archiveArch()}.tgz`;
+    const downloadURL = options?.downloadURL ?? `https://cdn.platforma.bio/software/pl/${archiveOS()}/${archiveName}`;
+    const archiveFilePath = options?.saveTo ?? state.binaries(archiveName);
+    if (fs.existsSync(archiveFilePath)) {
+        logger.info(`Platforma Backend archive download skipped: '${archiveFilePath}' already exists`);
+        return Promise.resolve(archiveFilePath);
+    }
+    fs.mkdirSync(path.dirname(archiveFilePath), { recursive: true });
+    logger.info(`Downloading Platforma Backend archive:\n  URL:     ${downloadURL}\n  Save to: ${archiveFilePath}`);
+    const request = https.get(downloadURL);
+    return new Promise((resolve, reject) => {
+        request.on('response', (response) => {
+            if (!response.statusCode) {
+                const err = new Error('failed to download archive: no HTTP status code in response from server');
+                request.destroy();
+                reject(err);
+                return;
+            }
+            if (response.statusCode !== 200) {
+                const err = new Error(`failed to download archive: ${response.statusCode} ${response.statusMessage}`);
+                request.destroy();
+                reject(err);
+                return;
+            }
+            const totalBytes = parseInt(response.headers['content-length'] || '0', 10);
+            let downloadedBytes = 0;
+            const archive = fs.createWriteStream(archiveFilePath);
+            response.pipe(archive);
+            response.on('data', (chunk) => {
+                downloadedBytes += chunk.length;
+                const progress = (downloadedBytes / totalBytes) * 100;
+                if (showProgress) {
+                    process.stdout.write(`  downloading: ${progress.toFixed(2)}%\r`);
+                }
+            });
+            response.on('error', (err) => {
+                fs.unlinkSync(archiveFilePath);
+                logger.error(`Failed to download Platforma Binary: ${err.message}`);
+                request.destroy();
+                reject(err);
+            });
+            archive.on('finish', () => {
+                archive.close();
+                logger.info(`  ... download done.`);
+                request.destroy();
+                resolve(archiveFilePath);
+            });
+        });
+    });
+}
+function extractArchive(logger, options) {
+    logger.debug('extracting archive...');
+    const version = options?.version ?? plDeployments.getDefaultPlVersion();
+    logger.debug(`  version: '${version}'`);
+    const archiveName = `${binaryDirName({ version })}.tgz`;
+    const archivePath = options?.archivePath ?? state.binaries(archiveName);
+    logger.debug(`  archive path: '${archivePath}'`);
+    const targetDir = options?.extractTo ?? trimExtension(archivePath);
+    logger.debug(`  target dir: '${targetDir}'`);
+    if (fs.existsSync(targetDir)) {
+        logger.info(`Platforma Backend binaries unpack skipped: '${targetDir}' exists`);
+        return targetDir;
+    }
+    if (!fs.existsSync(archivePath)) {
+        const msg = `Platforma Backend binary archive not found at '${archivePath}'`;
+        logger.error(msg);
+        throw new Error(msg);
+    }
+    if (!fs.existsSync(targetDir)) {
+        logger.debug(`  creating target dir '${targetDir}'`);
+        fs.mkdirSync(targetDir, { recursive: true });
+    }
+    logger.info(`Unpacking Platforma Backend archive:\n  Archive:   ${archivePath}\n  Target dir: ${targetDir}`);
+    tar__namespace.x({
+        file: archivePath,
+        cwd: targetDir,
+        gzip: true,
+        sync: true,
+    });
+    logger.info(`  ... unpack done.`);
+    return targetDir;
+}
+function getBinary(logger, options) {
+    return downloadArchive(logger, options).then((archivePath) => extractArchive(logger, { archivePath }));
+}
+function binaryDirName(options) {
+    const version = options?.version ?? plDeployments.getDefaultPlVersion();
+    return `pl-${version}-${archiveArch()}`;
+}
+function binaryPath(version, ...p) {
+    return state.binaries(binaryDirName({ version }), ...p);
+}
+function trimExtension(filename) {
+    const lastDotIndex = filename.lastIndexOf('.');
+    if (lastDotIndex === -1) {
+        return filename;
+    }
+    return filename.slice(0, lastDotIndex);
+}
+
+exports.Arches = Arches;
+exports.OSes = OSes;
+exports.archiveArch = archiveArch;
+exports.archiveOS = archiveOS;
+exports.binaryPath = binaryPath;
+exports.downloadArchive = downloadArchive;
+exports.extractArchive = extractArchive;
+exports.getBinary = getBinary;
+//# sourceMappingURL=platforma.cjs.map

package/dist/platforma.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"platforma.cjs","sources":["../src/platforma.ts"],"sourcesContent":["import os from 'node:os';\nimport fs from 'node:fs';\nimport https from 'https';\nimport path from 'node:path';\n\nimport * as tar from 'tar';\nimport type winston from 'winston';\nimport state from './state';\nimport { getDefaultPlVersion } from '@milaboratories/pl-deployments';\n\nexport const OSes = ['linux', 'macos', 'windows'] as const;\nexport type OSType = (typeof OSes)[number];\n\nexport function archiveOS(osName?: string): OSType {\n  const platform = osName ?? os.platform();\n\n  switch (platform) {\n    case 'darwin':\n      return 'macos';\n    case 'linux':\n      return 'linux';\n    case 'win32':\n      return 'windows';\n    default:\n      throw new Error(\n        `operating system '${platform}' is not currently supported by Platforma ecosystem. The list of OSes supported: `\n        + JSON.stringify(OSes),\n      );\n  }\n}\n\nexport const Arches = ['amd64', 'arm64'] as const;\nexport type ArchType = (typeof Arches)[number];\n\nexport function archiveArch(archName?: string): ArchType {\n  const arch = archName ?? os.arch();\n\n  switch (arch) {\n    case 'arm64':\n      return 'arm64';\n    case 'x64':\n      return 'amd64';\n    default:\n      throw new Error(\n        `processor architecture '${arch}' is not currently supported by Platforma ecosystem. The list of architectures supported: `\n        + JSON.stringify(Arches),\n      );\n  }\n}\n\nexport function downloadArchive(\n  logger: winston.Logger,\n  options?: {\n    version?: string;\n    showProgress?: boolean;\n    downloadURL?: string;\n    saveTo?: string;\n  },\n): Promise<string> {\n  const version = options?.version ?? getDefaultPlVersion();\n  const showProgress = options?.showProgress ?? process.stdout.isTTY;\n\n  const archiveName = `pl-${version}-${archiveArch()}.tgz`;\n  const downloadURL = options?.downloadURL ?? `https://cdn.platforma.bio/software/pl/${archiveOS()}/${archiveName}`;\n\n  const archiveFilePath = options?.saveTo ?? state.binaries(archiveName);\n  if (fs.existsSync(archiveFilePath)) {\n    logger.info(`Platforma Backend archive download skipped: '${archiveFilePath}' already exists`);\n    return Promise.resolve(archiveFilePath);\n  }\n\n  fs.mkdirSync(path.dirname(archiveFilePath), { recursive: true });\n\n  logger.info(`Downloading Platforma Backend archive:\\n  URL:     ${downloadURL}\\n  Save to: ${archiveFilePath}`);\n\n  const request = https.get(downloadURL);\n\n  return new Promise((resolve, reject) => {\n    request.on('response', (response) => {\n      if (!response.statusCode) {\n        const err = new Error('failed to download archive: no HTTP status code in response from server');\n        request.destroy();\n        reject(err);\n        return;\n      }\n      if (response.statusCode !== 200) {\n        const err = new Error(`failed to download archive: ${response.statusCode} ${response.statusMessage}`);\n        request.destroy();\n        reject(err);\n        return;\n      }\n\n      const totalBytes = parseInt(response.headers['content-length'] || '0', 10);\n      let downloadedBytes = 0;\n\n      const archive = fs.createWriteStream(archiveFilePath);\n\n      response.pipe(archive);\n      response.on('data', (chunk) => {\n        downloadedBytes += chunk.length;\n        const progress = (downloadedBytes / totalBytes) * 100;\n        if (showProgress) {\n          process.stdout.write(`  downloading: ${progress.toFixed(2)}%\\r`);\n        }\n      });\n\n      response.on('error', (err: Error) => {\n        fs.unlinkSync(archiveFilePath);\n        logger.error(`Failed to download Platforma Binary: ${err.message}`);\n        request.destroy();\n        reject(err);\n      });\n\n      archive.on('finish', () => {\n        archive.close();\n        logger.info(`  ... download done.`);\n        request.destroy();\n        resolve(archiveFilePath);\n      });\n    });\n  });\n}\n\nexport function extractArchive(\n  logger: winston.Logger,\n  options?: {\n    version?: string;\n    archivePath?: string;\n    extractTo?: string;\n  },\n): string {\n  logger.debug('extracting archive...');\n\n  const version = options?.version ?? getDefaultPlVersion();\n  logger.debug(`  version: '${version}'`);\n  const archiveName = `${binaryDirName({ version })}.tgz`;\n\n  const archivePath = options?.archivePath ?? state.binaries(archiveName);\n  logger.debug(`  archive path: '${archivePath}'`);\n\n  const targetDir = options?.extractTo ?? trimExtension(archivePath);\n  logger.debug(`  target dir: '${targetDir}'`);\n\n  if (fs.existsSync(targetDir)) {\n    logger.info(`Platforma Backend binaries unpack skipped: '${targetDir}' exists`);\n    return targetDir;\n  }\n\n  if (!fs.existsSync(archivePath)) {\n    const msg = `Platforma Backend binary archive not found at '${archivePath}'`;\n    logger.error(msg);\n    throw new Error(msg);\n  }\n\n  if (!fs.existsSync(targetDir)) {\n    logger.debug(`  creating target dir '${targetDir}'`);\n    fs.mkdirSync(targetDir, { recursive: true });\n  }\n\n  logger.info(`Unpacking Platforma Backend archive:\\n  Archive:   ${archivePath}\\n  Target dir: ${targetDir}`);\n\n  tar.x({\n    file: archivePath,\n    cwd: targetDir,\n    gzip: true,\n    sync: true,\n  });\n\n  logger.info(`  ... unpack done.`);\n\n  return targetDir;\n}\n\nexport function getBinary(\n  logger: winston.Logger,\n  options?: { version?: string; showProgress?: boolean },\n): Promise<string> {\n  return downloadArchive(logger, options).then((archivePath) => extractArchive(logger, { archivePath }));\n}\n\nfunction binaryDirName(options?: { version?: string }): string {\n  const version = options?.version ?? getDefaultPlVersion();\n  return `pl-${version}-${archiveArch()}`;\n}\n\nexport function binaryPath(version?: string, ...p: string[]): string {\n  return state.binaries(binaryDirName({ version }), ...p);\n}\n\nfunction trimExtension(filename: string): string {\n  const lastDotIndex = filename.lastIndexOf('.');\n  if (lastDotIndex === -1) {\n    return filename;\n  }\n  return filename.slice(0, lastDotIndex);\n}\n"],"names":["getDefaultPlVersion","tar"],"mappings":"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"}

package/dist/platforma.d.ts

@@ -21,4 +21,3 @@ export declare function getBinary(logger: winston.Logger, options?: {
     showProgress?: boolean;
 }): Promise<string>;
 export declare function binaryPath(version?: string, ...p: string[]): string;
-//# sourceMappingURL=platforma.d.ts.map

package/dist/platforma.js

@@ -0,0 +1,141 @@
+import os__default from 'node:os';
+import fs from 'node:fs';
+import https from 'node:https';
+import path from 'node:path';
+import * as tar from 'tar';
+import state from './state.js';
+import { getDefaultPlVersion } from '@milaboratories/pl-deployments';
+
+const OSes = ['linux', 'macos', 'windows'];
+function archiveOS(osName) {
+    const platform = os__default.platform();
+    switch (platform) {
+        case 'darwin':
+            return 'macos';
+        case 'linux':
+            return 'linux';
+        case 'win32':
+            return 'windows';
+        default:
+            throw new Error(`operating system '${platform}' is not currently supported by Platforma ecosystem. The list of OSes supported: `
+                + JSON.stringify(OSes));
+    }
+}
+const Arches = ['amd64', 'arm64'];
+function archiveArch(archName) {
+    const arch = os__default.arch();
+    switch (arch) {
+        case 'arm64':
+            return 'arm64';
+        case 'x64':
+            return 'amd64';
+        default:
+            throw new Error(`processor architecture '${arch}' is not currently supported by Platforma ecosystem. The list of architectures supported: `
+                + JSON.stringify(Arches));
+    }
+}
+function downloadArchive(logger, options) {
+    const version = options?.version ?? getDefaultPlVersion();
+    const showProgress = options?.showProgress ?? process.stdout.isTTY;
+    const archiveName = `pl-${version}-${archiveArch()}.tgz`;
+    const downloadURL = options?.downloadURL ?? `https://cdn.platforma.bio/software/pl/${archiveOS()}/${archiveName}`;
+    const archiveFilePath = options?.saveTo ?? state.binaries(archiveName);
+    if (fs.existsSync(archiveFilePath)) {
+        logger.info(`Platforma Backend archive download skipped: '${archiveFilePath}' already exists`);
+        return Promise.resolve(archiveFilePath);
+    }
+    fs.mkdirSync(path.dirname(archiveFilePath), { recursive: true });
+    logger.info(`Downloading Platforma Backend archive:\n  URL:     ${downloadURL}\n  Save to: ${archiveFilePath}`);
+    const request = https.get(downloadURL);
+    return new Promise((resolve, reject) => {
+        request.on('response', (response) => {
+            if (!response.statusCode) {
+                const err = new Error('failed to download archive: no HTTP status code in response from server');
+                request.destroy();
+                reject(err);
+                return;
+            }
+            if (response.statusCode !== 200) {
+                const err = new Error(`failed to download archive: ${response.statusCode} ${response.statusMessage}`);
+                request.destroy();
+                reject(err);
+                return;
+            }
+            const totalBytes = parseInt(response.headers['content-length'] || '0', 10);
+            let downloadedBytes = 0;
+            const archive = fs.createWriteStream(archiveFilePath);
+            response.pipe(archive);
+            response.on('data', (chunk) => {
+                downloadedBytes += chunk.length;
+                const progress = (downloadedBytes / totalBytes) * 100;
+                if (showProgress) {
+                    process.stdout.write(`  downloading: ${progress.toFixed(2)}%\r`);
+                }
+            });
+            response.on('error', (err) => {
+                fs.unlinkSync(archiveFilePath);
+                logger.error(`Failed to download Platforma Binary: ${err.message}`);
+                request.destroy();
+                reject(err);
+            });
+            archive.on('finish', () => {
+                archive.close();
+                logger.info(`  ... download done.`);
+                request.destroy();
+                resolve(archiveFilePath);
+            });
+        });
+    });
+}
+function extractArchive(logger, options) {
+    logger.debug('extracting archive...');
+    const version = options?.version ?? getDefaultPlVersion();
+    logger.debug(`  version: '${version}'`);
+    const archiveName = `${binaryDirName({ version })}.tgz`;
+    const archivePath = options?.archivePath ?? state.binaries(archiveName);
+    logger.debug(`  archive path: '${archivePath}'`);
+    const targetDir = options?.extractTo ?? trimExtension(archivePath);
+    logger.debug(`  target dir: '${targetDir}'`);
+    if (fs.existsSync(targetDir)) {
+        logger.info(`Platforma Backend binaries unpack skipped: '${targetDir}' exists`);
+        return targetDir;
+    }
+    if (!fs.existsSync(archivePath)) {
+        const msg = `Platforma Backend binary archive not found at '${archivePath}'`;
+        logger.error(msg);
+        throw new Error(msg);
+    }
+    if (!fs.existsSync(targetDir)) {
+        logger.debug(`  creating target dir '${targetDir}'`);
+        fs.mkdirSync(targetDir, { recursive: true });
+    }
+    logger.info(`Unpacking Platforma Backend archive:\n  Archive:   ${archivePath}\n  Target dir: ${targetDir}`);
+    tar.x({
+        file: archivePath,
+        cwd: targetDir,
+        gzip: true,
+        sync: true,
+    });
+    logger.info(`  ... unpack done.`);
+    return targetDir;
+}
+function getBinary(logger, options) {
+    return downloadArchive(logger, options).then((archivePath) => extractArchive(logger, { archivePath }));
+}
+function binaryDirName(options) {
+    const version = options?.version ?? getDefaultPlVersion();
+    return `pl-${version}-${archiveArch()}`;
+}
+function binaryPath(version, ...p) {
+    return state.binaries(binaryDirName({ version }), ...p);
+}
+function trimExtension(filename) {
+    const lastDotIndex = filename.lastIndexOf('.');
+    if (lastDotIndex === -1) {
+        return filename;
+    }
+    return filename.slice(0, lastDotIndex);
+}
+
+export { Arches, OSes, archiveArch, archiveOS, binaryPath, downloadArchive, extractArchive, getBinary };
+//# sourceMappingURL=platforma.js.map

package/dist/platforma.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platforma.js","sources":["../src/platforma.ts"],"sourcesContent":["import os from 'node:os';\nimport fs from 'node:fs';\nimport https from 'https';\nimport path from 'node:path';\n\nimport * as tar from 'tar';\nimport type winston from 'winston';\nimport state from './state';\nimport { getDefaultPlVersion } from '@milaboratories/pl-deployments';\n\nexport const OSes = ['linux', 'macos', 'windows'] as const;\nexport type OSType = (typeof OSes)[number];\n\nexport function archiveOS(osName?: string): OSType {\n  const platform = osName ?? os.platform();\n\n  switch (platform) {\n    case 'darwin':\n      return 'macos';\n    case 'linux':\n      return 'linux';\n    case 'win32':\n      return 'windows';\n    default:\n      throw new Error(\n        `operating system '${platform}' is not currently supported by Platforma ecosystem. The list of OSes supported: `\n        + JSON.stringify(OSes),\n      );\n  }\n}\n\nexport const Arches = ['amd64', 'arm64'] as const;\nexport type ArchType = (typeof Arches)[number];\n\nexport function archiveArch(archName?: string): ArchType {\n  const arch = archName ?? os.arch();\n\n  switch (arch) {\n    case 'arm64':\n      return 'arm64';\n    case 'x64':\n      return 'amd64';\n    default:\n      throw new Error(\n        `processor architecture '${arch}' is not currently supported by Platforma ecosystem. The list of architectures supported: `\n        + JSON.stringify(Arches),\n      );\n  }\n}\n\nexport function downloadArchive(\n  logger: winston.Logger,\n  options?: {\n    version?: string;\n    showProgress?: boolean;\n    downloadURL?: string;\n    saveTo?: string;\n  },\n): Promise<string> {\n  const version = options?.version ?? getDefaultPlVersion();\n  const showProgress = options?.showProgress ?? process.stdout.isTTY;\n\n  const archiveName = `pl-${version}-${archiveArch()}.tgz`;\n  const downloadURL = options?.downloadURL ?? `https://cdn.platforma.bio/software/pl/${archiveOS()}/${archiveName}`;\n\n  const archiveFilePath = options?.saveTo ?? state.binaries(archiveName);\n  if (fs.existsSync(archiveFilePath)) {\n    logger.info(`Platforma Backend archive download skipped: '${archiveFilePath}' already exists`);\n    return Promise.resolve(archiveFilePath);\n  }\n\n  fs.mkdirSync(path.dirname(archiveFilePath), { recursive: true });\n\n  logger.info(`Downloading Platforma Backend archive:\\n  URL:     ${downloadURL}\\n  Save to: ${archiveFilePath}`);\n\n  const request = https.get(downloadURL);\n\n  return new Promise((resolve, reject) => {\n    request.on('response', (response) => {\n      if (!response.statusCode) {\n        const err = new Error('failed to download archive: no HTTP status code in response from server');\n        request.destroy();\n        reject(err);\n        return;\n      }\n      if (response.statusCode !== 200) {\n        const err = new Error(`failed to download archive: ${response.statusCode} ${response.statusMessage}`);\n        request.destroy();\n        reject(err);\n        return;\n      }\n\n      const totalBytes = parseInt(response.headers['content-length'] || '0', 10);\n      let downloadedBytes = 0;\n\n      const archive = fs.createWriteStream(archiveFilePath);\n\n      response.pipe(archive);\n      response.on('data', (chunk) => {\n        downloadedBytes += chunk.length;\n        const progress = (downloadedBytes / totalBytes) * 100;\n        if (showProgress) {\n          process.stdout.write(`  downloading: ${progress.toFixed(2)}%\\r`);\n        }\n      });\n\n      response.on('error', (err: Error) => {\n        fs.unlinkSync(archiveFilePath);\n        logger.error(`Failed to download Platforma Binary: ${err.message}`);\n        request.destroy();\n        reject(err);\n      });\n\n      archive.on('finish', () => {\n        archive.close();\n        logger.info(`  ... download done.`);\n        request.destroy();\n        resolve(archiveFilePath);\n      });\n    });\n  });\n}\n\nexport function extractArchive(\n  logger: winston.Logger,\n  options?: {\n    version?: string;\n    archivePath?: string;\n    extractTo?: string;\n  },\n): string {\n  logger.debug('extracting archive...');\n\n  const version = options?.version ?? getDefaultPlVersion();\n  logger.debug(`  version: '${version}'`);\n  const archiveName = `${binaryDirName({ version })}.tgz`;\n\n  const archivePath = options?.archivePath ?? state.binaries(archiveName);\n  logger.debug(`  archive path: '${archivePath}'`);\n\n  const targetDir = options?.extractTo ?? trimExtension(archivePath);\n  logger.debug(`  target dir: '${targetDir}'`);\n\n  if (fs.existsSync(targetDir)) {\n    logger.info(`Platforma Backend binaries unpack skipped: '${targetDir}' exists`);\n    return targetDir;\n  }\n\n  if (!fs.existsSync(archivePath)) {\n    const msg = `Platforma Backend binary archive not found at '${archivePath}'`;\n    logger.error(msg);\n    throw new Error(msg);\n  }\n\n  if (!fs.existsSync(targetDir)) {\n    logger.debug(`  creating target dir '${targetDir}'`);\n    fs.mkdirSync(targetDir, { recursive: true });\n  }\n\n  logger.info(`Unpacking Platforma Backend archive:\\n  Archive:   ${archivePath}\\n  Target dir: ${targetDir}`);\n\n  tar.x({\n    file: archivePath,\n    cwd: targetDir,\n    gzip: true,\n    sync: true,\n  });\n\n  logger.info(`  ... unpack done.`);\n\n  return targetDir;\n}\n\nexport function getBinary(\n  logger: winston.Logger,\n  options?: { version?: string; showProgress?: boolean },\n): Promise<string> {\n  return downloadArchive(logger, options).then((archivePath) => extractArchive(logger, { archivePath }));\n}\n\nfunction binaryDirName(options?: { version?: string }): string {\n  const version = options?.version ?? getDefaultPlVersion();\n  return `pl-${version}-${archiveArch()}`;\n}\n\nexport function binaryPath(version?: string, ...p: string[]): string {\n  return state.binaries(binaryDirName({ version }), ...p);\n}\n\nfunction trimExtension(filename: string): string {\n  const lastDotIndex = filename.lastIndexOf('.');\n  if (lastDotIndex === -1) {\n    return filename;\n  }\n  return filename.slice(0, lastDotIndex);\n}\n"],"names":["os"],"mappings":"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"}

package/dist/run.cjs

@@ -0,0 +1,68 @@
+'use strict';
+
+var node_child_process = require('node:child_process');
+require('./state.cjs');
+
+function runCommands(logger, cmds, options) {
+    const buffers = [];
+    const children = [];
+    for (const cmd of cmds) {
+        const opts = {
+            cwd: cmd.workdir,
+            env: {
+                ...cmd.envs,
+                ...options?.env,
+            },
+            ...cmd.runOpts,
+            ...options,
+        };
+        if (cmd.async) {
+            const child = run(logger, cmd.cmd, cmd.args, opts);
+            children.push(child);
+        }
+        else {
+            const result = runSync(logger, cmd.cmd, cmd.args, opts);
+            buffers.push(result);
+            if (result.error || result.status !== 0) {
+                break;
+            }
+        }
+    }
+    return {
+        executed: buffers,
+        spawned: children,
+    };
+}
+function run(logger, cmd, args, options) {
+    logger.debug(`Running:\n  cmd: ${JSON.stringify([cmd, ...args])}\n  wd: ${options.cwd?.toString()}`);
+    options.env = { ...process.env, ...options.env };
+    logger.debug('  spawning child process');
+    const child = node_child_process.spawn(cmd, args, options);
+    let exitAfterChild = false;
+    //
+    // Ensure Ctrl+C causes right finalization order: first stop child process, then stop the parent.
+    //
+    const sigintHandler = () => {
+        child.kill('SIGINT');
+        exitAfterChild = true;
+    };
+    logger.debug('  setting up signal handler');
+    process.on('SIGINT', sigintHandler);
+    child.on('close', (code) => {
+        process.removeListener('SIGINT', sigintHandler);
+        if (exitAfterChild) {
+            process.exit(code);
+        }
+    });
+    return child;
+}
+function runSync(logger, cmd, args, options) {
+    logger.debug(`Running:\n  cmd: ${JSON.stringify([cmd, ...args])}\n  opts: ${JSON.stringify(options)}`);
+    options.env = { ...process.env, ...options.env };
+    return node_child_process.spawnSync(cmd, args, options);
+}
+
+exports.run = run;
+exports.runCommands = runCommands;
+exports.runSync = runSync;
+//# sourceMappingURL=run.cjs.map

package/dist/run.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.cjs","sources":["../src/run.ts"],"sourcesContent":["import type { SpawnOptions, SpawnSyncReturns, ChildProcess } from 'node:child_process';\nimport { spawnSync, spawn } from 'node:child_process';\nimport type { instanceCommand } from './state';\nimport state from './state';\nimport type winston from 'winston';\n\ntype runResult = {\n  executed: SpawnSyncReturns<Buffer>[];\n  spawned: ChildProcess[];\n};\n\nexport function runCommands(logger: winston.Logger, cmds: instanceCommand[], options?: SpawnOptions): runResult {\n  const buffers: SpawnSyncReturns<Buffer>[] = [];\n  const children: ChildProcess[] = [];\n  for (const cmd of cmds) {\n    const opts = {\n      cwd: cmd.workdir,\n      env: {\n        ...cmd.envs,\n        ...options?.env,\n      },\n      ...cmd.runOpts,\n      ...options,\n    };\n\n    if (cmd.async) {\n      const child = run(logger, cmd.cmd, cmd.args, opts);\n      children.push(child);\n    } else {\n      const result = runSync(logger, cmd.cmd, cmd.args, opts);\n      buffers.push(result);\n      if (result.error || result.status !== 0) {\n        break;\n      }\n    }\n  };\n\n  return {\n    executed: buffers,\n    spawned: children,\n  };\n}\n\nexport function rerunLast(logger: winston.Logger, options: SpawnOptions): runResult {\n  const instance = state.currentInstance;\n\n  if (!instance) {\n    throw new Error('no previous run info found: this is the first run after package installation');\n  }\n\n  return runCommands(logger, instance.upCommands, options);\n}\n\nexport function run(logger: winston.Logger, cmd: string, args: readonly string[], options: SpawnOptions): ChildProcess {\n  logger.debug(\n    `Running:\\n  cmd: ${JSON.stringify([cmd, ...args])}\\n  wd: ${options.cwd?.toString()}`,\n  );\n\n  options.env = { ...process.env, ...options.env };\n  logger.debug('  spawning child process');\n  const child = spawn(cmd, args, options);\n  let exitAfterChild: boolean = false;\n\n  //\n  // Ensure Ctrl+C causes right finalization order: first stop child process, then stop the parent.\n  //\n  const sigintHandler = () => {\n    child.kill('SIGINT');\n    exitAfterChild = true;\n  };\n\n  logger.debug('  setting up signal handler');\n  process.on('SIGINT', sigintHandler);\n\n  child.on('close', (code) => {\n    process.removeListener('SIGINT', sigintHandler);\n    if (exitAfterChild) {\n      process.exit(code);\n    }\n  });\n\n  return child;\n}\n\nexport function runSync(\n  logger: winston.Logger,\n  cmd: string,\n  args: readonly string[],\n  options: SpawnOptions,\n): SpawnSyncReturns<Buffer> {\n  logger.debug(\n    `Running:\\n  cmd: ${JSON.stringify([cmd, ...args])}\\n  opts: ${JSON.stringify(options)}`,\n  );\n\n  options.env = { ...process.env, ...options.env };\n  return spawnSync(cmd, args, options);\n}\n"],"names":["spawn","spawnSync"],"mappings":"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"}

package/dist/run.d.ts

@@ -10,4 +10,3 @@ export declare function rerunLast(logger: winston.Logger, options: SpawnOptions)
 export declare function run(logger: winston.Logger, cmd: string, args: readonly string[], options: SpawnOptions): ChildProcess;
 export declare function runSync(logger: winston.Logger, cmd: string, args: readonly string[], options: SpawnOptions): SpawnSyncReturns<Buffer>;
 export {};
-//# sourceMappingURL=run.d.ts.map

package/dist/run.js

@@ -0,0 +1,64 @@
+import { spawn, spawnSync } from 'node:child_process';
+import './state.js';
+
+function runCommands(logger, cmds, options) {
+    const buffers = [];
+    const children = [];
+    for (const cmd of cmds) {
+        const opts = {
+            cwd: cmd.workdir,
+            env: {
+                ...cmd.envs,
+                ...options?.env,
+            },
+            ...cmd.runOpts,
+            ...options,
+        };
+        if (cmd.async) {
+            const child = run(logger, cmd.cmd, cmd.args, opts);
+            children.push(child);
+        }
+        else {
+            const result = runSync(logger, cmd.cmd, cmd.args, opts);
+            buffers.push(result);
+            if (result.error || result.status !== 0) {
+                break;
+            }
+        }
+    }
+    return {
+        executed: buffers,
+        spawned: children,
+    };
+}
+function run(logger, cmd, args, options) {
+    logger.debug(`Running:\n  cmd: ${JSON.stringify([cmd, ...args])}\n  wd: ${options.cwd?.toString()}`);
+    options.env = { ...process.env, ...options.env };
+    logger.debug('  spawning child process');
+    const child = spawn(cmd, args, options);
+    let exitAfterChild = false;
+    //
+    // Ensure Ctrl+C causes right finalization order: first stop child process, then stop the parent.
+    //
+    const sigintHandler = () => {
+        child.kill('SIGINT');
+        exitAfterChild = true;
+    };
+    logger.debug('  setting up signal handler');
+    process.on('SIGINT', sigintHandler);
+    child.on('close', (code) => {
+        process.removeListener('SIGINT', sigintHandler);
+        if (exitAfterChild) {
+            process.exit(code);
+        }
+    });
+    return child;
+}
+function runSync(logger, cmd, args, options) {
+    logger.debug(`Running:\n  cmd: ${JSON.stringify([cmd, ...args])}\n  opts: ${JSON.stringify(options)}`);
+    options.env = { ...process.env, ...options.env };
+    return spawnSync(cmd, args, options);
+}
+
+export { run, runCommands, runSync };
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sources":["../src/run.ts"],"sourcesContent":["import type { SpawnOptions, SpawnSyncReturns, ChildProcess } from 'node:child_process';\nimport { spawnSync, spawn } from 'node:child_process';\nimport type { instanceCommand } from './state';\nimport state from './state';\nimport type winston from 'winston';\n\ntype runResult = {\n  executed: SpawnSyncReturns<Buffer>[];\n  spawned: ChildProcess[];\n};\n\nexport function runCommands(logger: winston.Logger, cmds: instanceCommand[], options?: SpawnOptions): runResult {\n  const buffers: SpawnSyncReturns<Buffer>[] = [];\n  const children: ChildProcess[] = [];\n  for (const cmd of cmds) {\n    const opts = {\n      cwd: cmd.workdir,\n      env: {\n        ...cmd.envs,\n        ...options?.env,\n      },\n      ...cmd.runOpts,\n      ...options,\n    };\n\n    if (cmd.async) {\n      const child = run(logger, cmd.cmd, cmd.args, opts);\n      children.push(child);\n    } else {\n      const result = runSync(logger, cmd.cmd, cmd.args, opts);\n      buffers.push(result);\n      if (result.error || result.status !== 0) {\n        break;\n      }\n    }\n  };\n\n  return {\n    executed: buffers,\n    spawned: children,\n  };\n}\n\nexport function rerunLast(logger: winston.Logger, options: SpawnOptions): runResult {\n  const instance = state.currentInstance;\n\n  if (!instance) {\n    throw new Error('no previous run info found: this is the first run after package installation');\n  }\n\n  return runCommands(logger, instance.upCommands, options);\n}\n\nexport function run(logger: winston.Logger, cmd: string, args: readonly string[], options: SpawnOptions): ChildProcess {\n  logger.debug(\n    `Running:\\n  cmd: ${JSON.stringify([cmd, ...args])}\\n  wd: ${options.cwd?.toString()}`,\n  );\n\n  options.env = { ...process.env, ...options.env };\n  logger.debug('  spawning child process');\n  const child = spawn(cmd, args, options);\n  let exitAfterChild: boolean = false;\n\n  //\n  // Ensure Ctrl+C causes right finalization order: first stop child process, then stop the parent.\n  //\n  const sigintHandler = () => {\n    child.kill('SIGINT');\n    exitAfterChild = true;\n  };\n\n  logger.debug('  setting up signal handler');\n  process.on('SIGINT', sigintHandler);\n\n  child.on('close', (code) => {\n    process.removeListener('SIGINT', sigintHandler);\n    if (exitAfterChild) {\n      process.exit(code);\n    }\n  });\n\n  return child;\n}\n\nexport function runSync(\n  logger: winston.Logger,\n  cmd: string,\n  args: readonly string[],\n  options: SpawnOptions,\n): SpawnSyncReturns<Buffer> {\n  logger.debug(\n    `Running:\\n  cmd: ${JSON.stringify([cmd, ...args])}\\n  opts: ${JSON.stringify(options)}`,\n  );\n\n  options.env = { ...process.env, ...options.env };\n  return spawnSync(cmd, args, options);\n}\n"],"names":[],"mappings":"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"}