arcadible 0.0.1 → 0.1.1

package/README.md

@@ -0,0 +1,3 @@
+# Arcadible CLI
+
+The Arcadible command-line interface.

package/bin/arc-default.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+"use strict";
+
+// [import]
+
+const hideBin = require("yargs/helpers").hideBin;
+const yargs = require("yargs/yargs");
+
+// [import]
+
+const pkg = require("../package.json");
+
+// [declare]
+
+const CMD = "arc";
+
+// [function]
+
+const parse = function (cli) {
+  const argv = cli.parse();
+  if (!argv._.length) {
+    cli.showHelp();
+  }
+};
+
+// [function]
+
+const main = function (argv) {
+  return parse(
+    yargs(hideBin(argv))
+      .scriptName(CMD)
+      .usage("$0 <command> [options]")
+      .command("deploy", "Deploy to Arcadible")
+      .command("init", "Initialize a project")
+      .command("inspect", "Inspect project metadata")
+      .command("login", "Log in to Arcadible")
+      .command("logout", "Log out of Arcadible")
+      .command("pack", "Package for distribution")
+      .command("validate", "Validate workspace")
+      .command("whoami", "Show current account")
+      .help("help")
+      .alias("help", "h")
+      .version(pkg.version)
+      .alias("version", "v")
+      .strict(),
+  );
+};
+
+// [main]
+
+if (require.main === module) {
+  main(process.argv);
+}
+
+// [export]
+
+module.exports = { main };

package/bin/arc-deploy.js

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+"use strict";
+
+// [import]
+
+const path = require("node:path");
+
+// [import]
+
+const hideBin = require("yargs/helpers").hideBin;
+const yargs = require("yargs/yargs");
+
+// [import]
+
+const deploy = require("../src/cli/deploy");
+const log = require("../src/util/log");
+const output = require("../src/util/output");
+const pkg = require("../package.json");
+const rc = require("../src/util/rc");
+
+// [use]
+
+const findRc = rc.findRc;
+const print = output.print;
+const resolve = path.resolve;
+
+// [declare]
+
+const CMD = "arc";
+const SUBCMD = "deploy";
+
+// [define]
+
+const conf = {
+  git: false,
+  json: false,
+  production: false,
+  quiet: false,
+  ...findRc(CMD, SUBCMD, process.argv, ["--cwd", "-C"]),
+};
+
+// [function]
+
+const start = function (argv) {
+  const json = argv.json;
+  return deploy({
+    git: argv.git,
+    pre: !argv.production,
+    preId: "rc",
+    quiet: argv.quiet,
+    root: resolve(process.cwd(), argv.cwd),
+  }).catch((ex) => {
+    const message = ex.message;
+    if (json) {
+      print({ error: { message } });
+    } else {
+      log.hd("Deploy aborted.");
+      log.p(message);
+    }
+    process.exit(1);
+  });
+};
+
+// [function]
+
+const main = function (argv) {
+  return start(
+    yargs(hideBin(argv))
+      .scriptName(`${CMD} ${SUBCMD}`)
+      .usage("$0 [options]")
+      .option("production", {
+        alias: "p",
+        default: conf.production,
+        describe: "Deploy to production.",
+        type: "boolean",
+      })
+      .option("git", {
+        default: conf.git,
+        describe: "Deploy using Git.",
+        type: "boolean",
+      })
+      .option("json", {
+        alias: "j",
+        default: conf.json,
+        describe: "Format output as JSON.",
+        type: "boolean",
+      })
+      .option("quiet", {
+        alias: "q",
+        default: conf.quiet,
+        describe: "Output only errors.",
+        type: "boolean",
+      })
+      .option("cwd", {
+        alias: "C",
+        default: ".",
+        describe: "Set the working directory.",
+        type: "string",
+      })
+      .help("help")
+      .alias("help", "h")
+      .version(pkg.version)
+      .alias("version", "v")
+      .strict()
+      .parse(),
+  );
+};
+
+// [main]
+
+if (require.main === module) {
+  main(process.argv);
+}
+
+// [export]
+
+module.exports = { main };

package/bin/arc-init.js

@@ -0,0 +1,196 @@
+#!/usr/bin/env node
+"use strict";
+
+// [import]
+
+const path = require("node:path");
+
+// [import]
+
+const hideBin = require("yargs/helpers").hideBin;
+const prompts = require("@inquirer/prompts");
+const yargs = require("yargs/yargs");
+
+// [import]
+
+const cfgurl = require("../src/config/url");
+const init = require("../src/cli/init");
+const log = require("../src/util/log");
+const output = require("../src/util/output");
+const pkg = require("../package.json");
+const project = require("../src/prompt/project");
+const rc = require("../src/util/rc");
+const template = require("../src/prompt/template");
+
+// [use]
+
+const findRc = rc.findRc;
+const input = prompts.input;
+const print = output.print;
+const relative = path.relative;
+const resolve = path.resolve;
+const select = prompts.select;
+
+// [declare]
+
+const CMD = "arc";
+const SUBCMD = "init";
+
+// [define]
+
+const conf = {
+  force: false,
+  json: false,
+  quiet: false,
+  yes: false,
+  ...findRc(CMD, SUBCMD, process.argv, ["--cwd", "-C"]),
+};
+
+// [function]
+
+const handler = function ({ json, quiet }) {
+  return {
+    onBegin() {
+      if (!json && !quiet) {
+        log.p("Initializing project...");
+      }
+    },
+    onInfo() {},
+  };
+};
+
+// [function]
+
+const start = function (argv) {
+  const json = argv.json;
+  const quiet = argv.quiet;
+  const root = resolve(process.cwd(), argv.cwd);
+  return init({
+    force: argv.force,
+    handler: handler({ json, quiet }),
+    project: argv.project,
+    root,
+    template: argv.template,
+  })
+    .then((data) => {
+      const dir = relative(root, data.path);
+      if (json) {
+        print({ project: data });
+        return;
+      }
+      if (!quiet) {
+        log.hsnl("Initialized.");
+        log.h("Next steps:");
+        log.pnl(
+          [data.path === root ? null : `cd ${dir}`, "npm install", "arc deploy"]
+            .filter(Boolean)
+            .join(" && "),
+        );
+        log.h("Getting started:");
+        log.p(cfgurl.GETTING_STARTED);
+      }
+      // degit sometimes hangs
+      process.exit(0);
+    })
+    .catch((ex) => {
+      const message = ex.message;
+      if (json) {
+        print({ error: { message } });
+      } else {
+        log.hd("Init aborted.");
+        log.p(message);
+      }
+      process.exit(1);
+    });
+};
+
+// [function]
+
+const prompt = async function ({ yes, ...argv }) {
+  const opts = { ...argv };
+  if (yes) {
+    opts.project ??= project.input.default;
+    opts.template ??= template.select.default;
+    return opts;
+  }
+  if (!argv.project) {
+    opts.project = await input(project.input);
+  }
+  if (!argv.template) {
+    opts.template = await select(template.select);
+  }
+  return opts;
+};
+
+// [function]
+
+const main = function (argv) {
+  return prompt(
+    yargs(hideBin(argv))
+      .scriptName(`${CMD} ${SUBCMD}`)
+      .usage("$0 <project> [options]")
+      .command("$0 <project>", false, (cli) =>
+        cli.positional("project", {
+          describe: "Set the project directory.",
+          type: "string",
+        }),
+      )
+      .option("template", {
+        alias: "t",
+        describe: "Select a project template.",
+        type: "string",
+      })
+      .option("yes", {
+        alias: "y",
+        default: conf.yes,
+        describe: "Answer prompts using default values.",
+        type: "boolean",
+      })
+      .option("force", {
+        alias: "f",
+        default: conf.force,
+        describe: "Overwrite an existing directory.",
+        type: "boolean",
+      })
+      .option("json", {
+        alias: "j",
+        default: conf.json,
+        describe: "Format output as JSON.",
+        type: "boolean",
+      })
+      .option("quiet", {
+        alias: "q",
+        default: conf.quiet,
+        describe: "Output only errors.",
+        type: "boolean",
+      })
+      .option("cwd", {
+        alias: "C",
+        default: ".",
+        describe: "Set the working directory.",
+        type: "string",
+      })
+      .help("help")
+      .alias("help", "h")
+      .version(pkg.version)
+      .alias("version", "v")
+      .strict()
+      .parse(),
+  )
+    .then(start)
+    .catch((ex) => {
+      if (ex && ex.name === "ExitPromptError") {
+        process.exit(0);
+      }
+    });
+};
+
+// [main]
+
+if (require.main === module) {
+  main(process.argv);
+}
+
+// [export]
+
+module.exports = { main };

package/bin/arc-inspect.js

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+"use strict";
+
+// [import]
+
+const path = require("node:path");
+
+// [import]
+
+const hideBin = require("yargs/helpers").hideBin;
+const yargs = require("yargs/yargs");
+
+// [import]
+
+const inspect = require("../src/cli/inspect");
+const log = require("../src/util/log");
+const output = require("../src/util/output");
+const pkg = require("../package.json");
+const rc = require("../src/util/rc");
+
+// [use]
+
+const findRc = rc.findRc;
+const print = output.print;
+const resolve = path.resolve;
+
+// [declare]
+
+const CMD = "arc";
+const SUBCMD = "inspect";
+
+// [define]
+
+const conf = {
+  json: false,
+  key: "",
+  ...findRc(CMD, SUBCMD, process.argv, ["--cwd", "-C"]),
+};
+
+// [function]
+
+const start = function (argv) {
+  const json = argv.json;
+  const key = argv.key;
+  return inspect({
+    key,
+    root: resolve(process.cwd(), argv.cwd),
+  })
+    .then((data) => {
+      print(data, { key, toml: !json });
+    })
+    .catch((ex) => {
+      const message = ex.message;
+      if (json) {
+        print({ error: { message } });
+      } else {
+        log.hd("Inspect aborted.");
+        log.p(message);
+      }
+      process.exit(1);
+    });
+};
+
+// [function]
+
+const main = function (argv) {
+  return start(
+    yargs(hideBin(argv))
+      .scriptName(`${CMD} ${SUBCMD}`)
+      .usage("$0 [key] [options]")
+      .command("$0 [key]", false, (cli) =>
+        cli.positional("key", {
+          default: conf.key,
+          describe: "Select a metadata key.",
+          type: "string",
+        }),
+      )
+      .option("json", {
+        alias: "j",
+        default: conf.json,
+        describe: "Format output as JSON.",
+        type: "boolean",
+      })
+      .option("cwd", {
+        alias: "C",
+        default: ".",
+        describe: "Set the working directory.",
+        type: "string",
+      })
+      .help("help")
+      .alias("help", "h")
+      .version(pkg.version)
+      .alias("version", "v")
+      .strict()
+      .parse(),
+  );
+};
+
+// [main]
+
+if (require.main === module) {
+  main(process.argv);
+}
+
+// [export]
+
+module.exports = { main };

package/bin/arc-login.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+"use strict";
+
+// [import]
+
+const hideBin = require("yargs/helpers").hideBin;
+const open = require("open");
+const yargs = require("yargs/yargs");
+
+// [import]
+
+const log = require("../src/util/log");
+const login = require("../src/cli/login");
+const pkg = require("../package.json");
+const rc = require("../src/util/rc");
+
+// [use]
+
+const findRc = rc.findRc;
+
+// [declare]
+
+const CMD = "arc";
+const SUBCMD = "login";
+
+// [define]
+
+const conf = {
+  browser: true,
+  ...findRc(CMD, SUBCMD, process.argv, ["--cwd", "-C"]),
+};
+
+// [function]
+
+const onEnter = function (fn) {
+  const stdin = process.stdin;
+  if (!stdin.isTTY) {
+    return;
+  }
+  const cleanup = function () {
+    stdin.setRawMode(false);
+    stdin.pause();
+    stdin.removeAllListeners("data");
+  };
+  stdin.setRawMode(true);
+  stdin.resume();
+  stdin.once("data", (buf) => {
+    cleanup();
+    if (buf[0] === 3) {
+      process.kill(process.pid, "SIGINT");
+      return;
+    }
+    if (buf[0] === 13) {
+      fn();
+    }
+  });
+};
+
+// [function]
+
+const handler = function ({ browser }) {
+  return {
+    onCreated({ code, url }) {
+      log.p(url);
+      log.h(code.toUpperCase());
+      if (browser) {
+        log.p("");
+        log.p("Press Enter to open the URL.");
+        onEnter(() => {
+          open(url).catch(() => {});
+        });
+      }
+    },
+    onPoll() {},
+  };
+};
+
+// [function]
+
+const start = function (argv) {
+  const browser = argv.browser;
+  log.pnl("Starting login...");
+  return login({ handler: handler({ browser }) })
+    .then(({ profile }) => {
+      process.stdin.pause();
+      log.p("");
+      log.p("Logged in as:");
+      log.hs(profile.display_name);
+    })
+    .catch((ex) => {
+      process.stdin.pause();
+      log.hd("Login aborted.");
+      log.p(ex.message);
+      process.exit(1);
+    });
+};
+
+// [function]
+
+const main = function (argv) {
+  return start(
+    yargs(hideBin(argv))
+      .scriptName(`${CMD} ${SUBCMD}`)
+      .usage("$0 [options]")
+      .option("browser", {
+        default: conf.browser,
+        describe: "Open a web browser automatically.",
+        type: "boolean",
+      })
+      .help("help")
+      .alias("help", "h")
+      .version(pkg.version)
+      .alias("version", "v")
+      .strict()
+      .parse(),
+  );
+};
+
+// [main]
+
+if (require.main === module) {
+  main(process.argv);
+}
+
+// [export]
+
+module.exports = { main };

package/bin/arc-logout.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+"use strict";
+
+// [import]
+
+const hideBin = require("yargs/helpers").hideBin;
+const yargs = require("yargs/yargs");
+
+// [import]
+
+const log = require("../src/util/log");
+const logout = require("../src/cli/logout");
+const pkg = require("../package.json");
+
+// [declare]
+
+const CMD = "arc";
+const SUBCMD = "logout";
+
+// [function]
+
+const start = function () {
+  return logout()
+    .then(() => {
+      log.hs("Logged out.");
+    })
+    .catch((ex) => {
+      log.hd("Logout aborted.");
+      log.p(ex.message);
+      process.exit(1);
+    });
+};
+
+// [function]
+
+const main = function (argv) {
+  return start(
+    yargs(hideBin(argv))
+      .scriptName(`${CMD} ${SUBCMD}`)
+      .usage("$0 [options]")
+      .help("help")
+      .alias("help", "h")
+      .version(pkg.version)
+      .alias("version", "v")
+      .strict()
+      .parse(),
+  );
+};
+
+// [main]
+
+if (require.main === module) {
+  main(process.argv);
+}
+
+// [export]
+
+module.exports = { main };