@learncard/cli 3.4.5 → 3.4.6

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @learncard/cli
 
+## 3.4.6
+
+### Patch Changes
+
+-   [#1303](https://github.com/learningeconomy/LearnCard/pull/1303) [`59d79e9c2aed145284d6cc3de4c53ef0d3415299`](https://github.com/learningeconomy/LearnCard/commit/59d79e9c2aed145284d6cc3de4c53ef0d3415299) Thanks [@TaylorBeeston](https://github.com/TaylorBeeston)! - Switch workspace development to Bun source-mode resolution while preserving package build outputs for npm publishing.
+
+-   Updated dependencies [[`59d79e9c2aed145284d6cc3de4c53ef0d3415299`](https://github.com/learningeconomy/LearnCard/commit/59d79e9c2aed145284d6cc3de4c53ef0d3415299), [`8bcccce23f919e9bcd0d22d87e7d33242b557930`](https://github.com/learningeconomy/LearnCard/commit/8bcccce23f919e9bcd0d22d87e7d33242b557930), [`8bcccce23f919e9bcd0d22d87e7d33242b557930`](https://github.com/learningeconomy/LearnCard/commit/8bcccce23f919e9bcd0d22d87e7d33242b557930), [`8bcccce23f919e9bcd0d22d87e7d33242b557930`](https://github.com/learningeconomy/LearnCard/commit/8bcccce23f919e9bcd0d22d87e7d33242b557930)]:
+    -   @learncard/holder-continuity@0.2.6
+    -   @learncard/core@9.4.25
+    -   @learncard/init@2.4.4
+    -   @learncard/types@5.17.5
+    -   @learncard/didkit-plugin@1.9.5
+    -   @learncard/learn-cloud-plugin@2.3.30
+    -   @learncard/ler-rs-plugin@0.1.16
+    -   @learncard/linked-claims-plugin@0.2.25
+    -   @learncard/open-badge-v2-plugin@1.1.26
+    -   @learncard/render-method-plugin@3.0.5
+    -   @learncard/simple-signing-plugin@1.1.29
+
 ## 3.4.5
 
 ### Patch Changes

package/dist/index.js

@@ -3,9 +3,9 @@
 
 var fs = require('fs/promises');
 var dns = require('node:dns');
+var node_readline = require('node:readline');
 var promises = require('node:readline/promises');
 var node_stream = require('node:stream');
-var repl = require('pretty-repl');
 var core = require('@learncard/core');
 var init = require('@learncard/init');
 var simpleSigningPlugin = require('@learncard/simple-signing-plugin');
@@ -23,10 +23,27 @@ var holderContinuity = require('@learncard/holder-continuity');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
+function _interopNamespace(e) {
+    if (e && e.__esModule) return 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 fs__default = /*#__PURE__*/_interopDefaultLegacy(fs);
 var dns__default = /*#__PURE__*/_interopDefaultLegacy(dns);
-var repl__default = /*#__PURE__*/_interopDefaultLegacy(repl);
-var types__default = /*#__PURE__*/_interopDefaultLegacy(types);
+var types__namespace = /*#__PURE__*/_interopNamespace(types);
 var gradient__default = /*#__PURE__*/_interopDefaultLegacy(gradient);
 var figlet__default = /*#__PURE__*/_interopDefaultLegacy(figlet);
 var clipboard__default = /*#__PURE__*/_interopDefaultLegacy(clipboard);
@@ -70,12 +87,14 @@ const createRestoreLearnCardFromBundleHelper = (restoreBundle, defaultInit) => {
 };
 
 var name = "@learncard/cli";
-var version = "3.4.5";
+var version = "3.4.6";
 var description = "Command Line Interface for LearnCard";
 var main = "dist/index.js";
 var bin = "dist/index.js";
 var scripts = {
-	start: "rollup -c && node --enable-source-maps dist/index.js",
+	start: "bun --conditions=development src/index.tsx",
+	"start:built": "rollup -c && node --enable-source-maps dist/index.js",
+	dev: "bun --conditions=development src/index.tsx",
 	build: "rollup -c",
 	test: "vitest run"
 };
@@ -134,22 +153,56 @@ var packageJson = {
 	bugs: bugs
 };
 
+var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name);
+var __forAwait = (obj, it, method) => (it = obj[__knownSymbol("asyncIterator")]) ? it.call(obj) : (obj = obj[__knownSymbol("iterator")](), it = {}, method = (key, fn) => (fn = obj[key]) && (it[key] = (arg) => new Promise((yes, no, done) => (arg = fn.call(obj, arg), done = arg.done, Promise.resolve(arg.value).then((value) => yes({ value, done }), no)))), method("next"), method("return"), it);
 dns__default["default"].setDefaultResultOrder("ipv4first");
+const replGlobals = [
+  "learnCard",
+  "emptyLearnCard",
+  "learnCardFromSeed",
+  "initLearnCard",
+  "seed",
+  "generateRandomSeed",
+  "types",
+  "getTestCache",
+  "copy",
+  "getLearnCardBundlePassword",
+  "exportLearnCardBundle",
+  "importLearnCardBundle",
+  "createLearnCardBundle",
+  "readLearnCardBundle",
+  "restoreLearnCardFromBundle"
+];
+const replCommands = [".exit"];
+const identifierPattern = /^[A-Za-z_$][\w$]*$/;
+const colorizeName = (name) => {
+  const colorizedName = gradient__default["default"](["cyan", "green"])(name);
+  if (colorizedName !== name || !process.stdout.isTTY) return colorizedName;
+  return `\x1B[36m${name}\x1B[39m`;
+};
 const g = {
-  learnCard: gradient__default["default"](["cyan", "green"])("learnCard"),
-  emptyLearnCard: gradient__default["default"](["cyan", "green"])("emptyLearnCard"),
-  learnCardFromKey: gradient__default["default"](["cyan", "green"])("learnCardFromKey"),
-  initLearnCard: gradient__default["default"](["cyan", "green"])("initLearnCard"),
-  seed: gradient__default["default"](["cyan", "green"])("seed"),
-  generateRandomSeed: gradient__default["default"](["cyan", "green"])("generateRandomSeed"),
-  types: gradient__default["default"](["cyan", "green"])("types"),
-  getLearnCardBundlePassword: gradient__default["default"](["cyan", "green"])("getLearnCardBundlePassword"),
-  copy: gradient__default["default"](["cyan", "green"])("copy"),
-  exportLearnCardBundle: gradient__default["default"](["cyan", "green"])("exportLearnCardBundle"),
-  importLearnCardBundle: gradient__default["default"](["cyan", "green"])("importLearnCardBundle"),
-  createLearnCardBundle: gradient__default["default"](["cyan", "green"])("createLearnCardBundle"),
-  readLearnCardBundle: gradient__default["default"](["cyan", "green"])("readLearnCardBundle"),
-  restoreLearnCardFromBundle: gradient__default["default"](["cyan", "green"])("restoreLearnCardFromBundle")
+  learnCard: colorizeName("learnCard"),
+  emptyLearnCard: colorizeName("emptyLearnCard"),
+  learnCardFromSeed: colorizeName("learnCardFromSeed"),
+  initLearnCard: colorizeName("initLearnCard"),
+  seed: colorizeName("seed"),
+  generateRandomSeed: colorizeName("generateRandomSeed"),
+  types: colorizeName("types"),
+  getTestCache: colorizeName("getTestCache"),
+  getLearnCardBundlePassword: colorizeName("getLearnCardBundlePassword"),
+  copy: colorizeName("copy"),
+  exportLearnCardBundle: colorizeName("exportLearnCardBundle"),
+  importLearnCardBundle: colorizeName("importLearnCardBundle"),
+  createLearnCardBundle: colorizeName("createLearnCardBundle"),
+  readLearnCardBundle: colorizeName("readLearnCardBundle"),
+  restoreLearnCardFromBundle: colorizeName("restoreLearnCardFromBundle")
+};
+const colorizeReplInput = (input) => {
+  return [...replGlobals].sort((a, b) => b.length - a.length).reduce((output, name) => {
+    const colorizedName = g[name];
+    if (!colorizedName) return output;
+    return output.replace(new RegExp(`\\b${name}\\b`, "g"), colorizedName);
+  }, input);
 };
 const copyFunction = (text) => {
   if (typeof text === "object") {
@@ -183,6 +236,277 @@ const getLearnCardBundlePassword = async (prompt = "Bundle password: ") => {
     process.stdout.write("\n");
   }
 };
+const globalAssignmentPattern = /^(?:const|let|var)\s+([A-Za-z_$][\w$]*)\s*=\s*([\s\S]*?);?\s*$/;
+const parseGlobalAssignment = (source) => {
+  const match = source.match(globalAssignmentPattern);
+  if (!match) return;
+  const [, name, initializer] = match;
+  return { name, initializer };
+};
+const getCurrentToken = (line) => {
+  var _a, _b;
+  return (_b = (_a = line.match(/(?:[A-Za-z_$][\w$]*\.)*[A-Za-z_$][\w$]*\.?$/)) == null ? void 0 : _a[0]) != null ? _b : "";
+};
+const getCompletionBase = (token) => {
+  const lastDotIndex = token.lastIndexOf(".");
+  if (lastDotIndex === -1) return;
+  return token.slice(0, lastDotIndex);
+};
+const getCompletionPrefix = (token) => {
+  const lastDotIndex = token.lastIndexOf(".");
+  if (lastDotIndex === -1) return token;
+  return token.slice(lastDotIndex + 1);
+};
+const getOwnPropertyNames = (value) => {
+  if (value === null || value === void 0) return [];
+  const names = /* @__PURE__ */ new Set();
+  let current = Object(value);
+  while (current && current !== Object.prototype) {
+    for (const name of Object.getOwnPropertyNames(current)) names.add(name);
+    current = Object.getPrototypeOf(current);
+  }
+  return [...names];
+};
+const completeBunReplInput = (line) => {
+  const token = getCurrentToken(line);
+  if (!token) return [replCommands, ""];
+  const base = getCompletionBase(token);
+  const prefix = getCompletionPrefix(token);
+  if (!base) {
+    const completions = [...replCommands, ...replGlobals].filter(
+      (name) => name.startsWith(prefix)
+    );
+    return [completions.length ? completions : replGlobals, token];
+  }
+  try {
+    const target = globalThis.eval(base);
+    const completions = getOwnPropertyNames(target).filter((name) => identifierPattern.test(name)).filter((name) => name.startsWith(prefix)).map((name) => `${base}.${name}`);
+    return [completions, token];
+  } catch (e) {
+    return [[], token];
+  }
+};
+const evaluateBunReplInput = async (source) => {
+  try {
+    return await globalThis.eval(`(async () => (${source}))()`);
+  } catch (e) {
+    const globalAssignment = parseGlobalAssignment(source);
+    if (globalAssignment) {
+      const value = await globalThis.eval(
+        `(async () => (${globalAssignment.initializer}))()`
+      );
+      globalThis[globalAssignment.name] = value;
+      return value;
+    }
+    return await globalThis.eval(`(async () => { ${source} })()`);
+  }
+};
+const getSharedCompletion = (matches) => {
+  if (!matches.length) return;
+  return matches.reduce((prefix, match) => {
+    let index = 0;
+    while (index < prefix.length && prefix[index] === match[index]) index += 1;
+    return prefix.slice(0, index);
+  });
+};
+const renderBunReplLine = (prompt, line, cursor, colorize) => {
+  process.stdout.clearLine(0);
+  process.stdout.cursorTo(0);
+  process.stdout.write(prompt + colorize(line));
+  const trailingLength = line.length - cursor;
+  if (trailingLength > 0) process.stdout.write(`\x1B[${trailingLength}D`);
+};
+const startReadlineRepl = async (colorize) => {
+  const rl = promises.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    prompt: "> ",
+    completer: completeBunReplInput
+  });
+  rl.prompt();
+  try {
+    for (var iter = __forAwait(rl), more, temp, error; more = !(temp = await iter.next()).done; more = false) {
+      const line = temp.value;
+      const source = line.trim();
+      if (source === ".exit") break;
+      if (!source) {
+        rl.prompt();
+        continue;
+      }
+      try {
+        const result = await evaluateBunReplInput(source);
+        if (result !== void 0) console.dir(result, { depth: 6 });
+      } catch (error2) {
+        console.error(error2);
+      }
+      if (colorize) process.stdout.write(colorize(""));
+      rl.prompt();
+    }
+  } catch (temp) {
+    error = [temp];
+  } finally {
+    try {
+      more && (temp = iter.return) && await temp.call(iter);
+    } finally {
+      if (error)
+        throw error[0];
+    }
+  }
+  rl.close();
+};
+const startBunRepl = async (colorize) => {
+  if (!process.stdin.isTTY || !process.stdin.setRawMode) {
+    await startReadlineRepl(colorize);
+    return;
+  }
+  const prompt = "> ";
+  const history = [];
+  let line = "";
+  let cursor = 0;
+  let historyIndex = 0;
+  let draft = "";
+  let pending = Promise.resolve();
+  const resetHistory = () => {
+    historyIndex = history.length;
+    draft = "";
+  };
+  const setLine = (nextLine) => {
+    line = nextLine;
+    cursor = line.length;
+    renderBunReplLine(prompt, line, cursor, colorize);
+  };
+  const insertText = (text) => {
+    line = line.slice(0, cursor) + text + line.slice(cursor);
+    cursor += text.length;
+    renderBunReplLine(prompt, line, cursor, colorize);
+  };
+  const applyCompletion = () => {
+    const linePrefix = line.slice(0, cursor);
+    const [matches, token] = completeBunReplInput(linePrefix);
+    const completion = matches.length === 1 ? matches[0] : getSharedCompletion(matches);
+    if (completion && completion !== token) {
+      line = line.slice(0, cursor - token.length) + completion + line.slice(cursor);
+      cursor += completion.length - token.length;
+      renderBunReplLine(prompt, line, cursor, colorize);
+      return;
+    }
+    if (matches.length > 1) {
+      process.stdout.write(`
+${matches.join("    ")}
+`);
+      renderBunReplLine(prompt, line, cursor, colorize);
+    }
+  };
+  const evaluateLine = async () => {
+    process.stdout.write("\n");
+    const source = line.trim();
+    if (source === ".exit") return false;
+    if (source) {
+      history.push(source);
+      try {
+        const result = await evaluateBunReplInput(source);
+        if (result !== void 0) console.dir(result, { depth: 6 });
+      } catch (error) {
+        console.error(error);
+      }
+    }
+    line = "";
+    cursor = 0;
+    resetHistory();
+    renderBunReplLine(prompt, line, cursor, colorize);
+    return true;
+  };
+  const handleKey = async (input, key) => {
+    var _a, _b;
+    if (key.ctrl && key.name === "c") return false;
+    if (key.name === "return" || key.name === "enter") return await evaluateLine();
+    if (key.ctrl && key.name === "d" && !line) return false;
+    if (key.name === "tab") {
+      applyCompletion();
+      return true;
+    }
+    if (key.name === "backspace") {
+      if (cursor === 0) return true;
+      line = line.slice(0, cursor - 1) + line.slice(cursor);
+      cursor -= 1;
+      renderBunReplLine(prompt, line, cursor, colorize);
+      return true;
+    }
+    if (key.name === "delete") {
+      if (cursor >= line.length) return true;
+      line = line.slice(0, cursor) + line.slice(cursor + 1);
+      renderBunReplLine(prompt, line, cursor, colorize);
+      return true;
+    }
+    if (key.name === "left") {
+      if (cursor > 0) cursor -= 1;
+      renderBunReplLine(prompt, line, cursor, colorize);
+      return true;
+    }
+    if (key.name === "right") {
+      if (cursor < line.length) cursor += 1;
+      renderBunReplLine(prompt, line, cursor, colorize);
+      return true;
+    }
+    if (key.name === "home") {
+      cursor = 0;
+      renderBunReplLine(prompt, line, cursor, colorize);
+      return true;
+    }
+    if (key.name === "end") {
+      cursor = line.length;
+      renderBunReplLine(prompt, line, cursor, colorize);
+      return true;
+    }
+    if (key.name === "up") {
+      if (historyIndex === history.length) draft = line;
+      if (historyIndex > 0) historyIndex -= 1;
+      setLine((_a = history[historyIndex]) != null ? _a : draft);
+      return true;
+    }
+    if (key.name === "down") {
+      if (historyIndex < history.length) historyIndex += 1;
+      setLine(historyIndex === history.length ? draft : (_b = history[historyIndex]) != null ? _b : "");
+      return true;
+    }
+    if (input && !key.ctrl && input >= " ") {
+      insertText(input);
+      resetHistory();
+    }
+    return true;
+  };
+  await new Promise((resolve) => {
+    var _a, _b;
+    const onKeypress = (input, key) => {
+      pending = pending.then(async () => {
+        const keepRunning = await handleKey(input, key);
+        if (!keepRunning) cleanup();
+      });
+    };
+    const cleanup = () => {
+      var _a2, _b2;
+      process.stdin.off("keypress", onKeypress);
+      (_b2 = (_a2 = process.stdin).setRawMode) == null ? void 0 : _b2.call(_a2, false);
+      process.stdin.pause();
+      process.stdout.write("\n");
+      resolve();
+    };
+    node_readline.emitKeypressEvents(process.stdin);
+    (_b = (_a = process.stdin).setRawMode) == null ? void 0 : _b.call(_a, true);
+    process.stdin.resume();
+    console.log("Bun dev REPL ready. Tab completes globals/properties. Type .exit to quit.");
+    renderBunReplLine(prompt, line, cursor, colorize);
+    process.stdin.on("keypress", onKeypress);
+  });
+};
+const startCliRepl = async (colorize) => {
+  if (!("Bun" in globalThis)) {
+    const repl = await Promise.resolve().then(function () { return /*#__PURE__*/_interopNamespace(require('pretty-repl')); });
+    repl.default.start({ colorize });
+    return;
+  }
+  await startBunRepl(colorize);
+};
 commander.program.version(packageJson.version).argument("[seed]").action(async (_seed = generateRandomSeed()) => {
   var _a, _b, _c, _d;
   console.clear();
@@ -219,7 +543,7 @@ commander.program.version(packageJson.version).argument("[seed]").action(async (
   globalThis.learnCard = await globalThis.learnCard.addPlugin(
     renderMethodPlugin.getRenderMethodPlugin(globalThis.learnCard)
   );
-  globalThis.types = types__default["default"];
+  globalThis.types = types__namespace;
   globalThis.getTestCache = core.getTestCache;
   globalThis.copy = copyFunction;
   globalThis.getLearnCardBundlePassword = getLearnCardBundlePassword;
@@ -303,9 +627,5 @@ commander.program.version(packageJson.version).argument("[seed]").action(async (
     "\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518"
   );
   console.log("");
-  repl__default["default"].start({
-    colorize: (input) => {
-      return input.replace("emptyLearnCard", g.emptyLearnCard).replace("learnCardFromKey", g.learnCardFromKey).replace("initLearnCard", g.initLearnCard).replace("learnCard", g.learnCard).replace("seed", g.seed).replace("generateRandomSeed", g.generateRandomSeed).replace("copy", g.copy).replace("getLearnCardBundlePassword", g.getLearnCardBundlePassword).replace("exportLearnCardBundle", g.exportLearnCardBundle).replace("importLearnCardBundle", g.importLearnCardBundle).replace("createLearnCardBundle", g.createLearnCardBundle).replace("readLearnCardBundle", g.readLearnCardBundle).replace("restoreLearnCardFromBundle", g.restoreLearnCardFromBundle);
-    }
-  });
+  await startCliRepl(colorizeReplInput);
 }).parse(process.argv);

package/package.json

@@ -1,51 +1,53 @@
 {
-  "name": "@learncard/cli",
-  "version": "3.4.5",
-  "description": "Command Line Interface for LearnCard",
-  "main": "dist/index.js",
-  "bin": "dist/index.js",
-  "author": "Learning Economy Foundation (www.learningeconomy.io)",
-  "license": "MIT",
-  "dependencies": {
-    "@rollup/plugin-json": "^4.1.0",
-    "clipboardy": "^4.0.0",
-    "commander": "^9.3.0",
-    "figlet": "^1.5.2",
-    "gradient-string": "^2.0.1",
-    "pretty-repl": "^3.1.1",
-    "rollup": "^2.80.0",
-    "rollup-plugin-esbuild": "^4.9.1",
-    "@learncard/core": "9.4.24",
-    "@learncard/didkit-plugin": "^1.9.4",
-    "@learncard/learn-cloud-plugin": "2.3.29",
-    "@learncard/linked-claims-plugin": "0.2.24",
-    "@learncard/ler-rs-plugin": "0.1.15",
-    "@learncard/open-badge-v2-plugin": "1.1.25",
-    "@learncard/render-method-plugin": "3.0.4",
-    "@learncard/simple-signing-plugin": "1.1.28",
-    "@learncard/holder-continuity": "0.2.5",
-    "@learncard/types": "5.17.4",
-    "@learncard/init": "^2.4.3"
-  },
-  "devDependencies": {
-    "@types/cors": "^2.8.12",
-    "@types/figlet": "^1.5.4",
-    "@types/node": "^18.0.0",
-    "nodemon": "^2.0.16",
-    "ts-node": "^10.8.1",
-    "vitest": "^1.6.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/learningeconomy/LearnCard"
-  },
-  "homepage": "https://github.com/learningeconomy/LearnCard/tree/main/packages/learn-card-cli/README.md",
-  "bugs": {
-    "url": "https://github.com/learningeconomy/LearnCard/issues"
-  },
-  "scripts": {
-    "start": "rollup -c && node --enable-source-maps dist/index.js",
-    "build": "rollup -c",
-    "test": "vitest run"
-  }
-}
+    "name": "@learncard/cli",
+    "version": "3.4.6",
+    "description": "Command Line Interface for LearnCard",
+    "main": "dist/index.js",
+    "bin": "dist/index.js",
+    "scripts": {
+        "start": "bun --conditions=development src/index.tsx",
+        "start:built": "rollup -c && node --enable-source-maps dist/index.js",
+        "dev": "bun --conditions=development src/index.tsx",
+        "build": "rollup -c",
+        "test": "vitest run"
+    },
+    "author": "Learning Economy Foundation (www.learningeconomy.io)",
+    "license": "MIT",
+    "dependencies": {
+        "@learncard/core": "workspace:*",
+        "@learncard/didkit-plugin": "workspace:^",
+        "@learncard/init": "workspace:^",
+        "@learncard/learn-cloud-plugin": "workspace:*",
+        "@learncard/ler-rs-plugin": "workspace:*",
+        "@learncard/linked-claims-plugin": "workspace:*",
+        "@learncard/open-badge-v2-plugin": "workspace:*",
+        "@learncard/render-method-plugin": "workspace:*",
+        "@learncard/simple-signing-plugin": "workspace:*",
+        "@learncard/holder-continuity": "workspace:*",
+        "@learncard/types": "workspace:*",
+        "@rollup/plugin-json": "^4.1.0",
+        "clipboardy": "^4.0.0",
+        "commander": "^9.3.0",
+        "figlet": "^1.5.2",
+        "gradient-string": "^2.0.1",
+        "pretty-repl": "^3.1.1",
+        "rollup": "^2.80.0",
+        "rollup-plugin-esbuild": "^4.9.1"
+    },
+    "devDependencies": {
+        "@types/cors": "^2.8.12",
+        "@types/figlet": "^1.5.4",
+        "@types/node": "^18.0.0",
+        "nodemon": "^2.0.16",
+        "ts-node": "^10.8.1",
+        "vitest": "^1.6.0"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/learningeconomy/LearnCard"
+    },
+    "homepage": "https://github.com/learningeconomy/LearnCard/tree/main/packages/learn-card-cli/README.md",
+    "bugs": {
+        "url": "https://github.com/learningeconomy/LearnCard/issues"
+    }
+}

package/project.json

@@ -35,7 +35,7 @@
             "executor": "./tools/executors/workspace:run-command",
             "dependsOn": ["^build"],
             "options": {
-                "command": "pnpm start",
+                "command": "bun run start",
                 "cwd": "{root}/packages/learn-card-cli"
             }
         }

package/src/index.tsx

@@ -1,14 +1,14 @@
 import fs from 'fs/promises';
 import dns from 'node:dns';
+import { emitKeypressEvents } from 'node:readline';
 import { createInterface } from 'node:readline/promises';
 import { Writable } from 'node:stream';
 
-import repl from 'pretty-repl';
 import { getTestCache } from '@learncard/core';
 import { initLearnCard, emptyLearnCard, learnCardFromSeed } from '@learncard/init';
 import { getSimpleSigningPlugin } from '@learncard/simple-signing-plugin';
 import { openBadgeV2Plugin } from '@learncard/open-badge-v2-plugin';
-import types from '@learncard/types';
+import * as types from '@learncard/types';
 import { getLinkedClaimsPlugin } from '@learncard/linked-claims-plugin';
 import gradient from 'gradient-string';
 import figlet from 'figlet';
@@ -35,21 +35,71 @@ import packageJson from '../package.json';
 
 dns.setDefaultResultOrder('ipv4first');
 
+type ReplCompletion = [string[], string];
+type ReplKey = {
+    ctrl?: boolean;
+    name?: string;
+    sequence?: string;
+};
+
+const replGlobals = [
+    'learnCard',
+    'emptyLearnCard',
+    'learnCardFromSeed',
+    'initLearnCard',
+    'seed',
+    'generateRandomSeed',
+    'types',
+    'getTestCache',
+    'copy',
+    'getLearnCardBundlePassword',
+    'exportLearnCardBundle',
+    'importLearnCardBundle',
+    'createLearnCardBundle',
+    'readLearnCardBundle',
+    'restoreLearnCardFromBundle',
+];
+
+const replCommands = ['.exit'];
+
+const identifierPattern = /^[A-Za-z_$][\w$]*$/;
+
+const colorizeName = (name: string): string => {
+    const colorizedName = gradient(['cyan', 'green'])(name);
+
+    if (colorizedName !== name || !process.stdout.isTTY) return colorizedName;
+
+    return `\x1b[36m${name}\x1b[39m`;
+};
+
 const g = {
-    learnCard: gradient(['cyan', 'green'])('learnCard'),
-    emptyLearnCard: gradient(['cyan', 'green'])('emptyLearnCard'),
-    learnCardFromKey: gradient(['cyan', 'green'])('learnCardFromKey'),
-    initLearnCard: gradient(['cyan', 'green'])('initLearnCard'),
-    seed: gradient(['cyan', 'green'])('seed'),
-    generateRandomSeed: gradient(['cyan', 'green'])('generateRandomSeed'),
-    types: gradient(['cyan', 'green'])('types'),
-    getLearnCardBundlePassword: gradient(['cyan', 'green'])('getLearnCardBundlePassword'),
-    copy: gradient(['cyan', 'green'])('copy'),
-    exportLearnCardBundle: gradient(['cyan', 'green'])('exportLearnCardBundle'),
-    importLearnCardBundle: gradient(['cyan', 'green'])('importLearnCardBundle'),
-    createLearnCardBundle: gradient(['cyan', 'green'])('createLearnCardBundle'),
-    readLearnCardBundle: gradient(['cyan', 'green'])('readLearnCardBundle'),
-    restoreLearnCardFromBundle: gradient(['cyan', 'green'])('restoreLearnCardFromBundle'),
+    learnCard: colorizeName('learnCard'),
+    emptyLearnCard: colorizeName('emptyLearnCard'),
+    learnCardFromSeed: colorizeName('learnCardFromSeed'),
+    initLearnCard: colorizeName('initLearnCard'),
+    seed: colorizeName('seed'),
+    generateRandomSeed: colorizeName('generateRandomSeed'),
+    types: colorizeName('types'),
+    getTestCache: colorizeName('getTestCache'),
+    getLearnCardBundlePassword: colorizeName('getLearnCardBundlePassword'),
+    copy: colorizeName('copy'),
+    exportLearnCardBundle: colorizeName('exportLearnCardBundle'),
+    importLearnCardBundle: colorizeName('importLearnCardBundle'),
+    createLearnCardBundle: colorizeName('createLearnCardBundle'),
+    readLearnCardBundle: colorizeName('readLearnCardBundle'),
+    restoreLearnCardFromBundle: colorizeName('restoreLearnCardFromBundle'),
+};
+
+const colorizeReplInput = (input: string): string => {
+    return [...replGlobals]
+        .sort((a, b) => b.length - a.length)
+        .reduce((output, name) => {
+            const colorizedName = g[name as keyof typeof g];
+
+            if (!colorizedName) return output;
+
+            return output.replace(new RegExp(`\\b${name}\\b`, 'g'), colorizedName);
+        }, input);
 };
 
 const copyFunction = (text: string | object | number) => {
@@ -88,6 +138,372 @@ const getLearnCardBundlePassword = async (prompt = 'Bundle password: '): Promise
     }
 };
 
+const globalAssignmentPattern = /^(?:const|let|var)\s+([A-Za-z_$][\w$]*)\s*=\s*([\s\S]*?);?\s*$/;
+
+const parseGlobalAssignment = (
+    source: string
+): { name: string; initializer: string } | undefined => {
+    const match = source.match(globalAssignmentPattern);
+
+    if (!match) return;
+
+    const [, name, initializer] = match;
+
+    return { name, initializer };
+};
+
+const getCurrentToken = (line: string): string => {
+    return line.match(/(?:[A-Za-z_$][\w$]*\.)*[A-Za-z_$][\w$]*\.?$/)?.[0] ?? '';
+};
+
+const getCompletionBase = (token: string): string | undefined => {
+    const lastDotIndex = token.lastIndexOf('.');
+
+    if (lastDotIndex === -1) return;
+
+    return token.slice(0, lastDotIndex);
+};
+
+const getCompletionPrefix = (token: string): string => {
+    const lastDotIndex = token.lastIndexOf('.');
+
+    if (lastDotIndex === -1) return token;
+
+    return token.slice(lastDotIndex + 1);
+};
+
+const getOwnPropertyNames = (value: unknown): string[] => {
+    if (value === null || value === undefined) return [];
+
+    const names = new Set<string>();
+
+    let current: unknown = Object(value);
+
+    while (current && current !== Object.prototype) {
+        for (const name of Object.getOwnPropertyNames(current)) names.add(name);
+
+        current = Object.getPrototypeOf(current);
+    }
+
+    return [...names];
+};
+
+const completeBunReplInput = (line: string): ReplCompletion => {
+    const token = getCurrentToken(line);
+
+    if (!token) return [replCommands, ''];
+
+    const base = getCompletionBase(token);
+    const prefix = getCompletionPrefix(token);
+
+    if (!base) {
+        const completions = [...replCommands, ...replGlobals].filter(name =>
+            name.startsWith(prefix)
+        );
+
+        return [completions.length ? completions : replGlobals, token];
+    }
+
+    try {
+        const target = globalThis.eval(base) as unknown;
+        const completions = getOwnPropertyNames(target)
+            .filter(name => identifierPattern.test(name))
+            .filter(name => name.startsWith(prefix))
+            .map(name => `${base}.${name}`);
+
+        return [completions, token];
+    } catch {
+        return [[], token];
+    }
+};
+
+const evaluateBunReplInput = async (source: string): Promise<unknown> => {
+    try {
+        return await globalThis.eval(`(async () => (${source}))()`);
+    } catch {
+        const globalAssignment = parseGlobalAssignment(source);
+
+        if (globalAssignment) {
+            const value = await globalThis.eval(
+                `(async () => (${globalAssignment.initializer}))()`
+            );
+            (globalThis as Record<string, unknown>)[globalAssignment.name] = value;
+            return value;
+        }
+
+        return await globalThis.eval(`(async () => { ${source} })()`);
+    }
+};
+
+const getSharedCompletion = (matches: string[]): string | undefined => {
+    if (!matches.length) return;
+
+    return matches.reduce((prefix, match) => {
+        let index = 0;
+
+        while (index < prefix.length && prefix[index] === match[index]) index += 1;
+
+        return prefix.slice(0, index);
+    });
+};
+
+const renderBunReplLine = (
+    prompt: string,
+    line: string,
+    cursor: number,
+    colorize: (input: string) => string
+): void => {
+    process.stdout.clearLine(0);
+    process.stdout.cursorTo(0);
+    process.stdout.write(prompt + colorize(line));
+
+    const trailingLength = line.length - cursor;
+
+    if (trailingLength > 0) process.stdout.write(`\x1b[${trailingLength}D`);
+};
+
+const startReadlineRepl = async (colorize?: (input: string) => string): Promise<void> => {
+    const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        prompt: '> ',
+        completer: completeBunReplInput,
+    });
+
+    rl.prompt();
+
+    for await (const line of rl) {
+        const source = line.trim();
+
+        if (source === '.exit') break;
+
+        if (!source) {
+            rl.prompt();
+
+            continue;
+        }
+
+        try {
+            const result = await evaluateBunReplInput(source);
+
+            if (result !== undefined) console.dir(result, { depth: 6 });
+        } catch (error) {
+            console.error(error);
+        }
+
+        if (colorize) process.stdout.write(colorize(''));
+
+        rl.prompt();
+    }
+
+    rl.close();
+};
+
+const startBunRepl = async (colorize: (input: string) => string): Promise<void> => {
+    if (!process.stdin.isTTY || !process.stdin.setRawMode) {
+        await startReadlineRepl(colorize);
+
+        return;
+    }
+
+    const prompt = '> ';
+    const history: string[] = [];
+
+    let line = '';
+    let cursor = 0;
+    let historyIndex = 0;
+    let draft = '';
+    let pending = Promise.resolve();
+
+    const resetHistory = (): void => {
+        historyIndex = history.length;
+        draft = '';
+    };
+
+    const setLine = (nextLine: string): void => {
+        line = nextLine;
+        cursor = line.length;
+        renderBunReplLine(prompt, line, cursor, colorize);
+    };
+
+    const insertText = (text: string): void => {
+        line = line.slice(0, cursor) + text + line.slice(cursor);
+        cursor += text.length;
+        renderBunReplLine(prompt, line, cursor, colorize);
+    };
+
+    const applyCompletion = (): void => {
+        const linePrefix = line.slice(0, cursor);
+        const [matches, token] = completeBunReplInput(linePrefix);
+        const completion = matches.length === 1 ? matches[0] : getSharedCompletion(matches);
+
+        if (completion && completion !== token) {
+            line = line.slice(0, cursor - token.length) + completion + line.slice(cursor);
+            cursor += completion.length - token.length;
+            renderBunReplLine(prompt, line, cursor, colorize);
+
+            return;
+        }
+
+        if (matches.length > 1) {
+            process.stdout.write(`\n${matches.join('    ')}\n`);
+            renderBunReplLine(prompt, line, cursor, colorize);
+        }
+    };
+
+    const evaluateLine = async (): Promise<boolean> => {
+        process.stdout.write('\n');
+
+        const source = line.trim();
+
+        if (source === '.exit') return false;
+
+        if (source) {
+            history.push(source);
+
+            try {
+                const result = await evaluateBunReplInput(source);
+
+                if (result !== undefined) console.dir(result, { depth: 6 });
+            } catch (error) {
+                console.error(error);
+            }
+        }
+
+        line = '';
+        cursor = 0;
+        resetHistory();
+        renderBunReplLine(prompt, line, cursor, colorize);
+
+        return true;
+    };
+
+    const handleKey = async (input: string, key: ReplKey): Promise<boolean> => {
+        if (key.ctrl && key.name === 'c') return false;
+
+        if (key.name === 'return' || key.name === 'enter') return await evaluateLine();
+
+        if (key.ctrl && key.name === 'd' && !line) return false;
+
+        if (key.name === 'tab') {
+            applyCompletion();
+
+            return true;
+        }
+
+        if (key.name === 'backspace') {
+            if (cursor === 0) return true;
+
+            line = line.slice(0, cursor - 1) + line.slice(cursor);
+            cursor -= 1;
+            renderBunReplLine(prompt, line, cursor, colorize);
+
+            return true;
+        }
+
+        if (key.name === 'delete') {
+            if (cursor >= line.length) return true;
+
+            line = line.slice(0, cursor) + line.slice(cursor + 1);
+            renderBunReplLine(prompt, line, cursor, colorize);
+
+            return true;
+        }
+
+        if (key.name === 'left') {
+            if (cursor > 0) cursor -= 1;
+
+            renderBunReplLine(prompt, line, cursor, colorize);
+
+            return true;
+        }
+
+        if (key.name === 'right') {
+            if (cursor < line.length) cursor += 1;
+
+            renderBunReplLine(prompt, line, cursor, colorize);
+
+            return true;
+        }
+
+        if (key.name === 'home') {
+            cursor = 0;
+            renderBunReplLine(prompt, line, cursor, colorize);
+
+            return true;
+        }
+
+        if (key.name === 'end') {
+            cursor = line.length;
+            renderBunReplLine(prompt, line, cursor, colorize);
+
+            return true;
+        }
+
+        if (key.name === 'up') {
+            if (historyIndex === history.length) draft = line;
+            if (historyIndex > 0) historyIndex -= 1;
+
+            setLine(history[historyIndex] ?? draft);
+
+            return true;
+        }
+
+        if (key.name === 'down') {
+            if (historyIndex < history.length) historyIndex += 1;
+
+            setLine(historyIndex === history.length ? draft : history[historyIndex] ?? '');
+
+            return true;
+        }
+
+        if (input && !key.ctrl && input >= ' ') {
+            insertText(input);
+            resetHistory();
+        }
+
+        return true;
+    };
+
+    await new Promise<void>(resolve => {
+        const onKeypress = (input: string, key: ReplKey): void => {
+            pending = pending.then(async () => {
+                const keepRunning = await handleKey(input, key);
+
+                if (!keepRunning) cleanup();
+            });
+        };
+
+        const cleanup = (): void => {
+            process.stdin.off('keypress', onKeypress);
+            process.stdin.setRawMode?.(false);
+            process.stdin.pause();
+            process.stdout.write('\n');
+            resolve();
+        };
+
+        emitKeypressEvents(process.stdin);
+        process.stdin.setRawMode?.(true);
+        process.stdin.resume();
+
+        console.log('Bun dev REPL ready. Tab completes globals/properties. Type .exit to quit.');
+        renderBunReplLine(prompt, line, cursor, colorize);
+        process.stdin.on('keypress', onKeypress);
+    });
+};
+
+const startCliRepl = async (colorize: (input: string) => string): Promise<void> => {
+    if (!('Bun' in globalThis)) {
+        const repl = await import('pretty-repl');
+
+        repl.default.start({ colorize });
+
+        return;
+    }
+
+    await startBunRepl(colorize);
+};
+
 program
     .version(packageJson.version)
     .argument('[seed]')
@@ -237,23 +653,6 @@ program
 
         console.log('');
 
-        repl.start({
-            colorize: (input: string) => {
-                return input
-                    .replace('emptyLearnCard', g.emptyLearnCard)
-                    .replace('learnCardFromKey', g.learnCardFromKey)
-                    .replace('initLearnCard', g.initLearnCard)
-                    .replace('learnCard', g.learnCard)
-                    .replace('seed', g.seed)
-                    .replace('generateRandomSeed', g.generateRandomSeed)
-                    .replace('copy', g.copy)
-                    .replace('getLearnCardBundlePassword', g.getLearnCardBundlePassword)
-                    .replace('exportLearnCardBundle', g.exportLearnCardBundle)
-                    .replace('importLearnCardBundle', g.importLearnCardBundle)
-                    .replace('createLearnCardBundle', g.createLearnCardBundle)
-                    .replace('readLearnCardBundle', g.readLearnCardBundle)
-                    .replace('restoreLearnCardFromBundle', g.restoreLearnCardFromBundle);
-            },
-        });
+        await startCliRepl(colorizeReplInput);
     })
     .parse(process.argv);

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Learning Economy Foundation <sdk@learningeconomy.io>
-
-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.