@01/launcher 0.2.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 01 Alchemist
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+# Nodejs Process Launcher
+## Usage
+```ts
+import {launch} from '@01/launcher'
+
+await launch({
+  cmds:['echo', 'Hello']
+})
+
+```
+
+## Options
+```ts
+type Options = {
+  env?: string | string[];
+  cmds?: string[];
+  cwd?: string;
+  mode?: LaunchMode;
+  exitProcessOnClose?: boolean;
+  silent?: boolean;
+} & SpawnOptions;
+```
+### env
+Option to pass custom environment variable to child process.
+- `env:'ENV_VAR=value'`
+- `env:['ENV1=v1', 'ENV2=v2']`
+- `env:'ENV1=v1,ENV2=v2'`
+### cmds
+Child process cmd with arguments. First element is the program location or name and remaining elements are it's arguments.
+```
+cmds: ['echo', 'Hello']
+```
+### cwd
+Current working directory. Path is absolute if it's starts with slash `/` otherwise relative.
+- `cwd: './relative/path'`
+- `cwd: '/absolute/path'`
+### mode
+Launch mode
+- `cli` Exit program on exceptions
+- `program` Throw error on exceptions
+### exitProcessOnClose
+Exit parent node process on close.
+### silent
+Skip verbose logs

package/cli/index

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+const { launch } = require("../dist/index.js");
+
+launch({
+  mode: "cli",
+  exitProcessOnClose: true
+});

package/dist/index.js

@@ -0,0 +1,109 @@
+import * as S from "child_process";
+import * as E from "readline";
+import * as O from "fs";
+import * as j from "path";
+const l = {
+  log: (...t) => {
+    process.stdout.write(
+      t.reduce((o, e) => `${o} ${e}`) + `
+`,
+      "utf-8"
+    );
+  }
+}, k = require("minimist"), A = require("chalk"), { cursorTo: P } = E, { spawn: R } = S, { white: w, red: y, bgRed: v } = A, $ = {
+  mode: "program",
+  stdio: "inherit",
+  exitProcessOnClose: !1
+}, g = process.cwd();
+let p = `${g}/env/${process.env.USER}.env`;
+O.existsSync(p) || (p = `${g}/.env`);
+O.existsSync(p) && (l.log(`Loading env vars from: ${p}`), require("dotenv").config({
+  path: p
+}));
+function x(t, o) {
+  return Array.isArray(t) && Array.isArray(o) ? [...t, ...o] : typeof t == "object" && typeof o == "object" ? {
+    ...t,
+    ...o
+  } : o;
+}
+function C(t, o, e, c) {
+  let n;
+  return o && (n = o), e && (n = x(n, e)), c && (n = x(n, c)), {
+    name: t,
+    value: n
+  };
+}
+function D(t = {}, o = []) {
+  const e = k(o);
+  return Object.keys($).concat(Object.keys(t)).concat(Object.keys(e)).map((i) => C(
+    i,
+    $[i],
+    t[i],
+    e[i]
+  )).reduce(
+    (i, s) => (i[s.name] = s.value, i),
+    {}
+  );
+}
+async function q(t = {}) {
+  const o = t.mode === "cli" ? process.argv.slice(2) : [], e = D(t, o);
+  e.env && (e.env instanceof Array ? e.env : e.env.split(",")).forEach((d) => {
+    const [f, m] = d.split("="), r = m.indexOf("process.env.") > -1;
+    process.env[f] = r ? process.env[m.slice(12)] : m;
+  });
+  const c = e.cmds || process.argv.slice(2).filter((a) => a.indexOf("--cwd") === -1);
+  let n = g;
+  if (e.cwd && (n = e.cwd[0] === "/" ? e.cwd : j.resolve(g, e.cwd)), !c || c.length === 0) {
+    const a = e.mode === "cli", d = "Oops 😬, Did you forgot to pass";
+    if (a) {
+      const f = y(
+        `
+ ${d} ${v(
+          w(" program ")
+        )}?. Please tell me, which program you want to launch!
+`
+      ) + `
+   Example: launch echo "Hello World"
+`;
+      l.log(f), process.exit(1);
+    } else {
+      const f = y(
+        `${d} option ${v(
+          w(" cmds ")
+        )}?. Please tell me, which program you want to launch!
+`
+      ) + `
+   Example: launch({cmds:["echo", "Hello World"]});
+`;
+      throw new Error(f);
+    }
+  }
+  e.silent || (l.log(
+    "###############################################################################################################"
+  ), l.log("#  🚀  Launching   : " + c.join(" ")), l.log("#  📂  CWD         : " + n), l.log(
+    "###############################################################################################################"
+  ));
+  const { stdio: u, shell: i } = e, s = R(c[0], c.slice(1), {
+    stdio: u,
+    cwd: n,
+    shell: i
+  });
+  s.name = c[0];
+  function b(a) {
+    s && (P(process.stdout, 0), l.log(`Killing [${s.name}] instance.pid: ${s.pid}`), s.kill(a || "SIGTERM"));
+  }
+  return process.on("SIGINT", b), new Promise(function(a, d) {
+    let f = "", m = "";
+    u !== "inherit" && (s.stdout && s.stdout.on("data", function(r) {
+      const h = r.toString();
+      h && (f += h);
+    }), s.stderr && s.stderr.on("data", function(r) {
+      m = r.toString();
+    })), s.on("close", async (r) => {
+      e.exitProcessOnClose ? (l.log(`[${s.name}] exit code:${r}`), process.exit(r || void 0)) : (l.log(`[${s.name}] exit code:${r}`), r === 0 ? a(f) : d(m));
+    });
+  });
+}
+export {
+  q as launch
+};

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@01/launcher",
+  "version": "0.2.3",
+  "author": "01 Alchemist <01@01alchemist.com>",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/01alchemist/web-service-lib.git",
+    "directory": "packages/launcher"
+  },
+  "license": "UNLICENSED",
+  "keywords": [
+    "process",
+    "launcher",
+    "spawn"
+  ],
+  "engines": {
+    "node": ">=8"
+  },
+  "main": "dist/index.js",
+  "umd:main": "dist/index.js",
+  "module": "dist/index.js",
+  "typings": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "cli"
+  ],
+  "bin": {
+    "launch": "./cli/index"
+  },
+  "scripts": {
+    "yalc:publish": "yalc publish --push --sig",
+    "start": "vite",
+    "build.dev": "vite build",
+    "dev.build": "NODE_ENV=production vite build && yalc push",
+    "build": "NODE_ENV=production vite build",
+    "yalc.retreat": "yalc retreat --all",
+    "publish-pkg": "../../scripts/publish-package.js $PWD",
+    "precommit": "lint-staged",
+    "test": "echo no tests",
+    "prettier": "prettier --write '**/*.{js,json,ts,gql,graphql}'",
+    "lint": "prettier --check '**/*.{js,json,ts,gql,graphql}'"
+  },
+  "lint-staged": {
+    "*.ts": [
+      "prettier --write",
+      "git add"
+    ]
+  },
+  "dependencies": {
+    "chalk": "3.0.0",
+    "dotenv": "^16.3.1",
+    "minimist": "^1.2.8",
+    "tslib": "^2.6.2"
+  },
+  "devDependencies": {
+    "@01/core-tools": "^0.3.3",
+    "@types/jest": "^29.5.1",
+    "@types/minimist": "^1.2.2",
+    "@types/node": "^20.1.7",
+    "jest": "^29.5.0",
+    "jest-cli": "^29.5.0",
+    "prettier": "^2.8.8",
+    "terser": "^5.17.4",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.0.4"
+  }
+}