arcadible 0.0.1 → 0.1.1

package/bin/arc-pack.js

@@ -0,0 +1,126 @@
+#!/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 log = require("../src/util/log");
+const output = require("../src/util/output");
+const pack = require("../src/cli/pack");
+const pkg = require("../package.json");
+const rc = require("../src/util/rc");
+const validate = require("../src/cli/validate");
+
+// [use]
+
+const findRc = rc.findRc;
+const print = output.print;
+const resolve = path.resolve;
+
+// [declare]
+
+const CMD = "arc";
+const SUBCMD = "pack";
+
+// [define]
+
+const conf = {
+  json: false,
+  output: "package.zip",
+  quiet: false,
+  ...findRc(CMD, SUBCMD, process.argv, ["--cwd", "-C"]),
+};
+
+// [function]
+
+const start = function (argv) {
+  const json = argv.json;
+  const quiet = argv.quiet;
+  const root = resolve(process.cwd(), argv.cwd);
+  return validate({ root })
+    .then((issues) => {
+      const valid = !issues.length;
+      if (!valid) {
+        throw new Error("Validation failed. Run `arc validate` for details.");
+      }
+      return pack({ output: argv.output, root });
+    })
+    .then((data) => {
+      if (json) {
+        print({ artifact: data });
+        return;
+      }
+      if (!quiet) {
+        log.hs("Packed.");
+        print(data, { toml: true });
+      }
+    })
+    .catch((ex) => {
+      const message = ex.message;
+      if (json) {
+        print({ error: { message } });
+      } else {
+        log.hd("Pack aborted.");
+        log.p(message);
+      }
+      process.exit(1);
+    });
+};
+
+// [function]
+
+const main = function (argv) {
+  return start(
+    yargs(hideBin(argv))
+      .scriptName(`${CMD} ${SUBCMD}`)
+      .usage("$0 [options]")
+      .option("output", {
+        alias: "o",
+        default: conf.output,
+        describe: "Set the output path.",
+        type: "string",
+      })
+      .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-validate.js

@@ -0,0 +1,114 @@
+#!/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 log = require("../src/util/log");
+const output = require("../src/util/output");
+const pkg = require("../package.json");
+const rc = require("../src/util/rc");
+const validate = require("../src/cli/validate");
+
+// [use]
+
+const findRc = rc.findRc;
+const print = output.print;
+const resolve = path.resolve;
+
+// [declare]
+
+const CMD = "arc";
+const SUBCMD = "validate";
+
+// [define]
+
+const conf = {
+  json: false,
+  quiet: false,
+  ...findRc(CMD, SUBCMD, process.argv, ["--cwd", "-C"]),
+};
+
+// [function]
+
+const start = function (argv) {
+  const json = argv.json;
+  const quiet = argv.quiet;
+  return validate({ root: resolve(process.cwd(), argv.cwd) })
+    .then((issues) => {
+      const valid = !issues.length;
+      if (json) {
+        print({ issues });
+      } else if (valid) {
+        if (!quiet) {
+          log.hs("Passed.");
+        }
+      } else {
+        log.hd("Failed.");
+        log.p(issues.map((error) => `✖ ${error}`));
+      }
+      process.exit(valid ? 0 : 1);
+    })
+    .catch((ex) => {
+      const message = ex.message;
+      if (json) {
+        print({ error: { message } });
+      } else {
+        log.hd("Validate aborted.");
+        log.p(message);
+      }
+      process.exit(1);
+    });
+};
+
+// [function]
+
+const main = function (argv) {
+  return start(
+    yargs(hideBin(argv))
+      .scriptName(`${CMD} ${SUBCMD}`)
+      .usage("$0 [options]")
+      .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-whoami.js

@@ -0,0 +1,111 @@
+#!/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 output = require("../src/util/output");
+const pkg = require("../package.json");
+const rc = require("../src/util/rc");
+const whoami = require("../src/cli/whoami");
+
+// [use]
+
+const findRc = rc.findRc;
+const print = output.print;
+
+// [declare]
+
+const CMD = "arc";
+const SUBCMD = "whoami";
+
+// [define]
+
+const conf = {
+  json: false,
+  ...findRc(CMD, SUBCMD, process.argv, ["--cwd", "-C"]),
+};
+
+// [function]
+
+const handler = function ({ json }) {
+  return {
+    onRefresh(refresh) {
+      if (!json) {
+        log.p("Checking login...");
+      }
+      return refresh(true);
+    },
+  };
+};
+
+// [function]
+
+const start = function (argv) {
+  const json = argv.json;
+  return whoami({ handler: handler({ json }) })
+    .then((current) => {
+      if (!current || !current.profile) {
+        if (json) {
+          print({ profile: null });
+        } else {
+          log.p("Not logged in.");
+        }
+        return;
+      }
+      const profile = current.profile;
+      if (json) {
+        print({ profile });
+      } else {
+        log.p("Logged in as:");
+        log.hs(profile.display_name);
+      }
+    })
+    .catch((ex) => {
+      const message = ex.message;
+      if (json) {
+        print({ error: { message } });
+      } else {
+        log.hd("Whoami aborted.");
+        log.p(message);
+      }
+      process.exit(1);
+    });
+};
+
+// [function]
+
+const main = function (argv) {
+  return start(
+    yargs(hideBin(argv))
+      .scriptName(`${CMD} ${SUBCMD}`)
+      .usage("$0 [options]")
+      .option("json", {
+        alias: "j",
+        default: conf.json,
+        describe: "Format output as JSON.",
+        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.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+"use strict";
+
+// [import]
+
+const fs = require("fs-extra");
+
+// [import]
+
+const log = require("../src/util/log");
+const pkg = require("../package.json");
+
+// [use]
+
+const pathExists = fs.pathExists;
+
+// [declare]
+
+const CMD = "arc";
+
+// [function]
+
+const dispatch = function (argv) {
+  const args = [...argv];
+  const subcmds = Object.keys(pkg.bin)
+    .filter((key) => key !== CMD)
+    .map((key) => key.slice(CMD.length + 1));
+  if (!subcmds.includes(args[2])) {
+    args.splice(2, 0, "default");
+  }
+  return args;
+};
+
+// [function]
+
+const normalize = function (argv) {
+  const args = [...argv];
+  args[1] = args[1].endsWith(".js")
+    ? args[1].replace(/\.js$/u, `-${args[2]}.js`)
+    : args[1].concat(`-${args[2]}`);
+  args.splice(2, 1);
+  return args;
+};
+
+// [function]
+
+const main = function (argv, load) {
+  const args = normalize(dispatch(argv));
+  pathExists(args[1], (err, exists) => {
+    if (err || !exists) {
+      log.hd("Command aborted.");
+      log.p(`Unable to find: ${args[1]}`);
+      process.exit(1);
+    }
+    const command = load(args[1]);
+    command.main(args);
+  });
+};
+
+// [main]
+
+if (require.main === module) {
+  main(process.argv, require);
+}

package/package.json

@@ -1,5 +1,53 @@
 {
+  "bin": {
+    "arc": "bin/arc.js",
+    "arc-deploy": "bin/arc-deploy.js",
+    "arc-init": "bin/arc-init.js",
+    "arc-inspect": "bin/arc-inspect.js",
+    "arc-login": "bin/arc-login.js",
+    "arc-logout": "bin/arc-logout.js",
+    "arc-pack": "bin/arc-pack.js",
+    "arc-validate": "bin/arc-validate.js",
+    "arc-whoami": "bin/arc-whoami.js"
+  },
+  "dependencies": {
+    "@iarna/toml": "^2.2.5",
+    "@inquirer/prompts": "^8.5.2",
+    "adm-zip": "^0.5.16",
+    "chalk": "^4.1.2",
+    "degit": "^2.8.6",
+    "dompurify": "^3.3.1",
+    "dot-prop": "^6.0.1",
+    "fs-extra": "^11.3.2",
+    "image-size": "^2.0.2",
+    "jsdom": "^27.3.0",
+    "marked": "^17.0.1",
+    "mp4box": "^2.3.0",
+    "open": "^8.4.2",
+    "rc": "^1.2.8",
+    "yargs": "^17.7.2",
+    "zod": "^4.1.13"
+  },
+  "description": "The Arcadible command-line interface.",
+  "engines": {
+    "node": ">=24.11.1"
+  },
+  "exports": {
+    "./deploy": "./src/cli/deploy.js",
+    "./init": "./src/cli/init.js",
+    "./inspect": "./src/cli/inspect.js",
+    "./login": "./src/cli/login.js",
+    "./logout": "./src/cli/logout.js",
+    "./pack": "./src/cli/pack.js",
+    "./validate": "./src/cli/validate.js",
+    "./whoami": "./src/cli/whoami.js"
+  },
+  "keywords": [
+    "arcadible",
+    "cli"
+  ],
   "license": "Apache-2.0",
+  "main": "./src/cli/index.js",
   "name": "arcadible",
-  "version": "0.0.1"
+  "version": "0.1.1"
 }

package/src/action/deploy/tool.js

@@ -0,0 +1,11 @@
+"use strict";
+
+// [function]
+
+const main = function () {
+  return Promise.reject(new Error("Unimplemented command."));
+};
+
+// [export]
+
+module.exports = main;

package/src/action/deploy-git/git.js

@@ -0,0 +1,23 @@
+"use strict";
+
+// [import]
+
+const execFile = require("node:child_process").execFile;
+
+// [function]
+
+const isDirty = function (root, cb) {
+  execFile("git", ["-C", root, "diff", "--quiet"], (err) => {
+    if (err) {
+      cb(true);
+      return;
+    }
+    execFile("git", ["-C", root, "diff", "--cached", "--quiet"], (err) => {
+      cb(Boolean(err));
+    });
+  });
+};
+
+// [export]
+
+module.exports = { isDirty };

package/src/action/deploy-git/release.js

@@ -0,0 +1,74 @@
+"use strict";
+
+// [import]
+
+const execFile = require("node:child_process").execFile;
+
+// [import]
+
+const strs = require("../../util/strs");
+
+// [use]
+
+const trimWhitespace = strs.trimWhitespace;
+
+// [declare]
+
+const RE_TAG_EXISTS = /tag\s+'([^']+)'\s+already\s+exists/iu;
+
+// [function]
+
+const knownErr = function (stdErr) {
+  const tagExists = stdErr.match(RE_TAG_EXISTS);
+  if (tagExists) {
+    return [
+      `Git tag exists: ${tagExists[1]}`,
+      "The package version has been synchronized.",
+      "Try again.",
+    ].join("\n");
+  }
+  return stdErr;
+};
+
+// [function]
+
+const npm = function (root, pre, preId) {
+  return [
+    "--prefix",
+    root,
+    "version",
+    pre ? "prerelease" : "patch",
+    "--preid",
+    preId,
+    "-m",
+    pre ? "Prerelease v%s" : "Release v%s",
+  ];
+};
+
+// [function]
+
+const git = function (root) {
+  return ["-C", root, "push", "--follow-tags"];
+};
+
+// [function]
+
+const main = function (root, { pre, preId }, cb) {
+  execFile("npm", npm(root, pre, preId), (err, stdOut, stdErr) => {
+    if (err) {
+      cb(new Error(knownErr(stdErr), { cause: err }));
+      return;
+    }
+    execFile("git", git(root), (err) => {
+      if (err) {
+        cb(new Error(knownErr(stdErr), { cause: err }));
+        return;
+      }
+      cb(null, trimWhitespace(stdOut));
+    });
+  });
+};
+
+// [export]
+
+module.exports = main;

package/src/action/deploy-git/tool.js

@@ -0,0 +1,11 @@
+"use strict";
+
+// [function]
+
+const main = function () {
+  return Promise.reject(new Error("Unimplemented command."));
+};
+
+// [export]
+
+module.exports = main;

package/src/action/init/tool.js

@@ -0,0 +1,44 @@
+"use strict";
+
+// [import]
+
+const path = require("node:path");
+
+// [import]
+
+const degit = require("degit");
+const fs = require("fs-extra");
+
+// [use]
+
+const pathExists = fs.pathExists;
+const remove = fs.remove;
+const resolve = path.resolve;
+
+// [function]
+
+const init = function (src, dest, { onBegin, onInfo }) {
+  onBegin({ dest, src });
+  return degit(src, { cache: false, force: true, verbose: false })
+    .on("info", onInfo)
+    .clone(dest)
+    .then(() => remove(resolve(dest, "LICENSE")));
+};
+
+// [function]
+
+const main = function ({ force, project, root, template }, handler) {
+  const dest = resolve(root, project);
+  return pathExists(dest)
+    .then((exists) => {
+      if (exists && !force) {
+        throw new Error("Directory exists. Run with `--force` to overwrite.");
+      }
+      return init(template, dest, handler);
+    })
+    .then(() => ({ path: dest }));
+};
+
+// [export]
+
+module.exports = main;

package/src/action/inspect/tool.js

@@ -0,0 +1,25 @@
+"use strict";
+
+// [import]
+
+const dotProp = require("dot-prop");
+
+// [import]
+
+const project = require("../../parser/project");
+
+// [function]
+
+const inspect = function (proj, key) {
+  return key ? dotProp.get(proj, key, null) : proj;
+};
+
+// [function]
+
+const main = function ({ key, root }) {
+  return project.parse(root).then((proj) => inspect(proj, key));
+};
+
+// [export]
+
+module.exports = main;