@vault77/summon 2.0.1

package/utils/keychain.js

@@ -0,0 +1,86 @@
+import keytar from "keytar";
+import { KeychainError } from "../lib/errors.js";
+import { logger } from "./logger.js";
+
+const SERVICE = "summonTheWarlord";
+const ACCOUNT = "wallet-private-key";
+
+/**
+ * Normalize a pasted secret by coercing to string and trimming whitespace/newlines.
+ * @param {any} secret
+ * @returns {string}
+ */
+function normalizeSecret(secret) {
+  return String(secret ?? "").trim();
+}
+
+/**
+ * Stores the Solana private key in the macOS Keychain.
+ * Accepts Base58 or a JSON array string; we store it as-is.
+ * @param {string} secret - The private key string.
+ */
+export async function storePrivateKey(secret) {
+  const normalized = normalizeSecret(secret);
+  if (!normalized) {
+    throw new KeychainError("No private key provided. Paste your Base58 string or JSON array.");
+  }
+  try {
+    await keytar.setPassword(SERVICE, ACCOUNT, normalized);
+    console.log("🔐 Private key securely stored in macOS Keychain.");
+  } catch (err) {
+    logger.error("Failed to store private key.", { error: err?.message });
+    throw new KeychainError("Failed to store private key in Keychain.", { cause: err });
+  }
+}
+
+/**
+ * Retrieves the private key from the macOS Keychain.
+ * Throws if not found.
+ * @returns {Promise<string>}
+ */
+export async function getPrivateKey() {
+  try {
+    const key = await keytar.getPassword(SERVICE, ACCOUNT);
+    if (!key) {
+      throw new KeychainError("Private key not found. Run `summon keychain store` to save it.");
+    }
+    return key.trim();
+  } catch (err) {
+    if (err instanceof KeychainError) throw err;
+    logger.error("Failed to read private key from Keychain.", { error: err?.message });
+    throw new KeychainError("Failed to read private key from Keychain.", { cause: err });
+  }
+}
+
+/**
+ * Returns true if a private key exists in the Keychain.
+ * @returns {Promise<boolean>}
+ */
+export async function hasPrivateKey() {
+  try {
+    const key = await keytar.getPassword(SERVICE, ACCOUNT);
+    return typeof key === "string" && key.length > 0;
+  } catch (err) {
+    logger.error("Failed to check Keychain for private key.", { error: err?.message });
+    return false;
+  }
+}
+
+/**
+ * Deletes the private key from Keychain.
+ * @returns {Promise<boolean>} true if an entry was deleted, false if nothing existed
+ */
+export async function deletePrivateKey() {
+  try {
+    const deleted = await keytar.deletePassword(SERVICE, ACCOUNT);
+    if (deleted) {
+      console.log("💥 Private key removed from macOS Keychain.");
+    } else {
+      console.log("ℹ️ No private key found in macOS Keychain.");
+    }
+    return deleted;
+  } catch (err) {
+    logger.error("Failed to delete private key from Keychain.", { error: err?.message });
+    throw new KeychainError("Failed to delete private key from Keychain.", { cause: err });
+  }
+}

package/utils/logger.js

@@ -0,0 +1,45 @@
+const LEVELS = {
+  debug: 10,
+  info: 20,
+  warn: 30,
+  error: 40,
+};
+
+const DEFAULT_LEVEL = (process.env.WARLORD_LOG_LEVEL || (process.env.NODE_ENV === "development" ? "debug" : "info")).toLowerCase();
+const LOG_JSON = process.env.WARLORD_LOG_JSON === "1";
+
+function shouldLog(level) {
+  const current = LEVELS[DEFAULT_LEVEL] ?? LEVELS.info;
+  return LEVELS[level] >= current;
+}
+
+function formatPayload(level, message, meta) {
+  if (LOG_JSON) {
+    return JSON.stringify({ level, message, ...meta });
+  }
+  if (meta && Object.keys(meta).length) {
+    return `[${level.toUpperCase()}] ${message} ${JSON.stringify(meta)}`;
+  }
+  return `[${level.toUpperCase()}] ${message}`;
+}
+
+function log(level, message, meta = {}) {
+  if (!shouldLog(level)) return;
+  const payload = formatPayload(level, message, meta);
+  if (level === "error") {
+    console.error(payload);
+  } else if (level === "warn") {
+    console.warn(payload);
+  } else if (level === "debug") {
+    console.debug(payload);
+  } else {
+    console.log(payload);
+  }
+}
+
+export const logger = {
+  debug: (message, meta) => log("debug", message, meta),
+  info: (message, meta) => log("info", message, meta),
+  warn: (message, meta) => log("warn", message, meta),
+  error: (message, meta) => log("error", message, meta),
+};

package/utils/notify.js

@@ -0,0 +1,58 @@
+import { spawnSync } from "node:child_process";
+import { NotificationError } from "../lib/errors.js";
+import { logger } from "./logger.js";
+
+function escapeAppleScriptString(str) {
+  return str
+    .replace(/\\/g, "\\\\")
+    .replace(/"/g, "\\\"")
+    .replace(/\n/g, "\\n");
+}
+
+/**
+ * Display a macOS native notification using osascript.
+ * @param {Object} options
+ * @param {string} [options.title="summonTheWarlord"]
+ * @param {string} [options.message=""]
+ * @param {string} [options.subtitle=""]
+ * @param {string} [options.sound]
+ */
+export function notify({
+  title = "summonTheWarlord",
+  message = "",
+  subtitle = "",
+  sound,
+  throwOnError = false,
+} = {}) {
+  if (process.platform !== "darwin") {
+    const bell = "\u0007";
+    console.log(`${bell} ${title}: ${message}${subtitle ? ` - ${subtitle}` : ""}`);
+    return false;
+  }
+
+  try {
+    const escTitle = escapeAppleScriptString(title);
+    const escMessage = escapeAppleScriptString(message);
+    const escSubtitle = escapeAppleScriptString(subtitle);
+    let script = `display notification "${escMessage}" with title "${escTitle}"`;
+    if (subtitle) {
+      script += ` subtitle "${escSubtitle}"`;
+    }
+    if (sound) {
+      script += ` sound name "${escapeAppleScriptString(sound)}"`;
+    }
+
+    const result = spawnSync("osascript", ["-e", script], { stdio: "ignore" });
+    if (result.error || result.status !== 0) {
+      throw new NotificationError(`osascript exited with ${result.status}`, { cause: result.error });
+    }
+    return true;
+  } catch (err) {
+    logger.warn("Notification failed.", { error: err?.message });
+    if (throwOnError) {
+      throw err;
+    }
+    console.log(`🔔 ${title}: ${message}${subtitle ? ` - ${subtitle}` : ""}`);
+    return false;
+  }
+}