zephinax 1.0.0 → 1.1.0

package/README.md

@@ -1,18 +1,28 @@
 <div align="center">
-<h2>Zephinax's Stats</h2>
+  <img src="./logo.svg" alt="Zephinax Logo" width="100" />
+  <h1>Amirali Rajabi (Zephinax)</h1>
+  <p><em>Interdisciplinary engineer turning ideas into functional products.</em></p>
+
+  <p>
+    <a href="https://www.npmjs.com/package/zephinax"><img src="https://img.shields.io/npm/v/zephinax?color=006aff&label=CLI%20Version" alt="npm version" /></a>
+    <a href="https://zephinax.com"><img src="https://img.shields.io/badge/Website-zephinax.com-006aff" alt="Website" /></a>
+    <a href="mailto:zephinax@gmail.com"><img src="https://img.shields.io/badge/Email-zephinax%40gmail.com-006aff" alt="Email" /></a>
+  </p>
+
+  <pre><code>npx zephinax</code></pre>
+  <p><sub>Interactive by default in terminal. Use <code>--json</code> for machine-readable output or <code>--static</code> for non-interactive.</sub></p>
 </div>
 
 <br>
 
+<div align="center">
+  <h2>Activity & Stats</h2>
+</div>
+
 <p align="center">
-  <img alt="Mark streak" src="https://streak-stats.demolab.com/?user=Zephinax&hide_border=true&theme=transparent"/> 
+  <img alt="Streak Stats" src="https://streak-stats.demolab.com/?user=Zephinax&hide_border=true&theme=transparent"/> 
 </p>
 
-<!-- <div align="center">
-  <img align="center" src="http://github-profile-summary-cards.vercel.app/api/cards/stats?username=Zephinax&theme=transparent" height="180em" alt="Stats"/>
-  <img align="center" src="http://github-profile-summary-cards.vercel.app/api/cards/productive-time?username=Zephinax&theme=transparent&utcOffset=3.5" height="180em" alt="Time Graph"/>
-  <img align="center" src="http://github-profile-summary-cards.vercel.app/api/cards/profile-details?username=Zephinax&theme=transparent" height="180em" alt="Commitments"/>
-</div> -->
-
-<img src="./profile-3d-contrib/profile-3d-contrib.svg" alt="profile" >
-
+<p align="center">
+  <img src="./profile-3d-contrib/profile-3d-contrib.svg" alt="3D Profile Contributions" width="100%">
+</p>

package/bin/index.js

@@ -2,57 +2,96 @@
 "use strict";
 
 const https = require("https");
+const { exec, spawnSync } = require("child_process");
+const readline = require("readline");
 
+const PKG = require("../package.json");
 const API_URL = process.env.ZEPHINAX_API_URL || "https://zephinax.com/api/user";
+const CONTENT_MARGIN = 1;
+
+const DEFAULT_SKILLS = {
+  Stack: "Next.js • React • Node.js • Express • MongoDB",
+  Systems: "Embedded C/C++ • Firmware • Mechatronics",
+  DevOps: "Docker • Docker Compose • Git • Linux"
+};
+
+const FALLBACK_PROFILE = {
+  firstName: "Amirali",
+  lastName: "Rajabi",
+  displayName: "Zephinax",
+  username: "zephinax",
+  gender: "male",
+  pronouns: "he/him",
+  bio: "Interdisciplinary engineer turning ideas into functional products.",
+  address: "Tehran, Iran",
+  email: "zephinax@gmail.com",
+  website: "https://zephinax.com",
+  jobTitle: "Systems Engineer",
+  about: `I'm Amirali, an interdisciplinary engineer with a background in mechatronics and practical experience across software development, hardware engineering, product development, and system integration.
+My primary focus is turning ideas into functional products across the entire lifecycle — from system architecture, PCB design, and embedded firmware to full-stack web applications and cloud deployments.
+I specialize in building complete systems: combining microcontrollers and embedded devices (ESP32, Arduino, Raspberry Pi) with modern web platforms (Next.js, React, Express, MongoDB, Docker). I enjoy designing scalable architectures, bridging physical hardware with web services, and solving real-world operational challenges.
+Currently completing my studies in Industrial Mechatronics while working as a Systems Engineer, continually refining practical engineering and technical leadership skills.`,
+  quote: "Zephinax represents the endless pursuit of innovation in the world of technology.",
+  skills: DEFAULT_SKILLS,
+  timeZone: "Asia/Tehran"
+};
 
 const color = {
   cyan: (str) => `\x1b[36m${str}\x1b[0m`,
   magenta: (str) => `\x1b[35m${str}\x1b[0m`,
   yellow: (str) => `\x1b[33m${str}\x1b[0m`,
+  green: (str) => `\x1b[32m${str}\x1b[0m`,
+  blue: (str) => `\x1b[34m${str}\x1b[0m`,
   bold: (str) => `\x1b[1m${str}\x1b[0m`,
-  dim: (str) => `\x1b[2m${str}\x1b[0m`
+  dim: (str) => `\x1b[2m${str}\x1b[0m`,
+  italic: (str) => `\x1b[3m${str}\x1b[0m`
 };
 
-const CONTENT_MARGIN = 1;
+function hyperlink(text, url) {
+  if (!url) return text;
+  return `\u001b]8;;${url}\u0007${text}\u001b]8;;\u0007`;
+}
 
-async function fetchProfile(url) {
-  if (typeof fetch === "function") {
-    const res = await fetch(url);
-    if (!res.ok) throw new Error(`Request failed with status ${res.status}`);
-    return res.json();
-  }
+function stripAnsi(str = "") {
+  return str
+    .replace(/\u001b\]8;;[^\u0007\x1b]*(\u0007|\u001b\\)/g, "")
+    .replace(/\u001b\[[0-9;]*[a-zA-Z]/g, "")
+    .replace(/[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g, "");
+}
 
-  // Fallback for environments without global fetch.
-  return new Promise((resolve, reject) => {
-    https
-      .get(url, (res) => {
-        let data = "";
-        res.on("data", (chunk) => (data += chunk));
-        res.on("end", () => {
-          if (res.statusCode < 200 || res.statusCode >= 300) {
-            return reject(new Error(`Request failed with status ${res.statusCode}`));
-          }
-          try {
-            resolve(JSON.parse(data));
-          } catch (err) {
-            reject(err);
-          }
-        });
-      })
-      .on("error", reject);
-  });
+function visibleLength(str = "") {
+  return stripAnsi(str).length;
 }
 
-function clean(text) {
-  if (!text) return "";
-  return text
-    .replace(/\*\*/g, "") // remove bold markers
-    .replace(/^>\s?/gm, "") // strip block quotes
-    .replace(/\r?\n\s*/g, "\n") // normalize whitespace
-    .trim();
+function parseAboutAndQuote(text) {
+  if (!text) return { about: "", quote: "" };
+  const lines = text.split(/\r?\n/);
+  const quoteLines = [];
+  const regularLines = [];
+
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (trimmed.startsWith(">")) {
+      quoteLines.push(trimmed.replace(/^>\s*/, ""));
+    } else {
+      regularLines.push(line);
+    }
+  }
+
+  const cleanText = (str) =>
+    str
+      .replace(/\*\*(.*?)\*\*/g, "$1")
+      .replace(/^\s*also a\b/im, "Also a")
+      .replace(/\r?\n\s*/g, "\n")
+      .trim();
+
+  return {
+    about: cleanText(regularLines.join("\n")),
+    quote: cleanText(quoteLines.join(" "))
+  };
 }
 
-function wrapText(text, width, indent) {
+function wrapText(text, width, indent = 0) {
   if (!text) return [];
   const indentStr = " ".repeat(indent);
   return text
@@ -66,7 +105,7 @@ function wrapText(text, width, indent) {
 
       words.forEach((word) => {
         const candidate = current ? `${current} ${word}` : word;
-        if (candidate.length > width) {
+        if (visibleLength(candidate) > width) {
           if (current) lines.push(current);
           current = word;
         } else {
@@ -79,19 +118,7 @@ function wrapText(text, width, indent) {
 }
 
 function divider(char = "-", length = 60) {
-  return char.repeat(length);
-}
-
-function stripAnsi(str = "") {
-  return str.replace(
-    // eslint-disable-next-line no-control-regex
-    /[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g,
-    ""
-  );
-}
-
-function visibleLength(str = "") {
-  return stripAnsi(str).length;
+  return char.repeat(Math.max(0, length));
 }
 
 function boxTop(label, width) {
@@ -121,54 +148,330 @@ function boxDivider(label, width) {
   return `├${tag}${divider("─", lineLen)}┤`;
 }
 
-function fieldLine(label, value, width) {
+function fieldLine(label, value, width, linkUrl = null) {
   if (!value) return null;
-  const labelText = `${label}:`.padEnd(8);
-  return boxLine(`${color.yellow(labelText)} ${value}`, width);
+  const labelText = `${label}:`.padEnd(10);
+  const formattedVal = linkUrl ? hyperlink(color.cyan(value), linkUrl) : value;
+  return boxLine(`${color.yellow(labelText)} ${formattedVal}`, width);
 }
 
-function render(profile) {
-  const about = clean(profile.about || profile.bio);
+function render(profile, widthOverride) {
+  const { about, quote } = parseAboutAndQuote(profile.about);
+  const finalQuote = profile.quote || quote;
+  const skills = profile.skills || DEFAULT_SKILLS;
+
   const header =
-    `${color.bold(profile.displayName || profile.username || "Zephinax")} ${profile.pronouns ? `(${profile.pronouns})` : ""}`.trim();
+    `${color.bold(profile.displayName || profile.username || "Zephinax")} ${profile.pronouns ? color.dim(`(${profile.pronouns})`) : ""}`.trim();
   const fullName =
     profile.firstName || profile.lastName
       ? `${profile.firstName || ""} ${profile.lastName || ""}`.trim()
       : null;
 
-  const width = Math.max(60, Math.min(process.stdout.columns || 80, 100));
+  const terminalCols = process.stdout.columns || 80;
+  const width = widthOverride || Math.max(68, Math.min(terminalCols, 96));
   const contentWidth = Math.max(0, width - 4 - CONTENT_MARGIN * 2);
 
   const primary = color.cyan(header);
   const secondary = fullName ? color.dim(fullName) : null;
-  const aboutLines = about ? wrapText(about, contentWidth - 2, 0) : [];
+  const tagline = profile.bio ? color.italic(`"${profile.bio}"`) : null;
+  const aboutLines = about ? wrapText(about, contentWidth, 0) : [];
+  const quoteLines = finalQuote ? wrapText(`"${finalQuote}"`, contentWidth, 0) : [];
+
+  const githubUrl = `https://github.com/${profile.username || "zephinax"}`;
 
   const lines = [
     boxTop("Profile", width),
     boxLine(primary, width),
     secondary ? boxLine(secondary, width) : null,
+    tagline ? boxLine(tagline, width) : null,
     boxDivider("details", width),
     fieldLine("Role", profile.jobTitle, width),
+    fieldLine("Location", profile.address, width),
     fieldLine("Timezone", profile.timeZone, width),
     boxDivider("contact", width),
-    fieldLine("Email", profile.email, width),
-    fieldLine("Web", profile.website, width),
+    fieldLine("Web", profile.website, width, profile.website),
+    fieldLine("GitHub", githubUrl, width, githubUrl),
+    fieldLine("Email", profile.email, width, profile.email ? `mailto:${profile.email}` : null),
+    boxDivider("skills", width),
+    ...Object.entries(skills).map(([key, val]) => fieldLine(key, val, width)),
     aboutLines.length ? boxDivider("about", width) : null,
     ...aboutLines.map((l) => boxLine(l, width)),
+    quoteLines.length ? boxDivider("philosophy", width) : null,
+    ...quoteLines.map((l) => boxLine(color.italic(l), width)),
     boxBottom(width)
   ].filter(Boolean);
 
   return lines.join("\n");
 }
 
-async function main() {
+function renderPlain(profile) {
+  const { about, quote } = parseAboutAndQuote(profile.about);
+  const finalQuote = profile.quote || quote;
+  const fullName = [profile.firstName, profile.lastName].filter(Boolean).join(" ");
+  const skills = profile.skills || DEFAULT_SKILLS;
+  const githubUrl = `https://github.com/${profile.username || "zephinax"}`;
+
+  const lines = [
+    `${profile.displayName || profile.username || "Zephinax"}${profile.pronouns ? ` (${profile.pronouns})` : ""}`,
+    fullName || null,
+    profile.bio ? `"${profile.bio}"` : null,
+    "",
+    "--- DETAILS ---",
+    profile.jobTitle ? `Role:     ${profile.jobTitle}` : null,
+    profile.address ? `Location: ${profile.address}` : null,
+    profile.timeZone ? `Timezone: ${profile.timeZone}` : null,
+    "",
+    "--- CONTACT ---",
+    profile.website ? `Web:      ${profile.website}` : null,
+    `GitHub:   ${githubUrl}`,
+    profile.email ? `Email:    ${profile.email}` : null,
+    "",
+    "--- SKILLS ---",
+    ...Object.entries(skills).map(([key, val]) => `${(key + ":").padEnd(10)} ${val}`),
+    "",
+    about ? "--- ABOUT ---" : null,
+    about || null,
+    "",
+    finalQuote ? "--- PHILOSOPHY ---" : null,
+    finalQuote ? `"${finalQuote}"` : null
+  ].filter((l) => l !== null);
+
+  return lines.join("\n");
+}
+
+function openUrl(url) {
+  const platform = process.platform;
+  let cmd;
+  if (platform === "darwin") {
+    cmd = `open "${url}"`;
+  } else if (platform === "win32") {
+    cmd = `start "" "${url}"`;
+  } else {
+    cmd = `xdg-open "${url}"`;
+  }
+  exec(cmd, () => {});
+}
+
+function copyToClipboard(text) {
+  const platform = process.platform;
   try {
-    const data = await fetchProfile(API_URL);
-    if (!data || !data.data) throw new Error("No profile data returned.");
-    console.log(render(data.data));
+    if (platform === "darwin") {
+      spawnSync("pbcopy", { input: text });
+      return true;
+    } else if (platform === "win32") {
+      spawnSync("clip", { input: text });
+      return true;
+    } else {
+      const resXclip = spawnSync("which", ["xclip"]);
+      if (resXclip.status === 0) {
+        spawnSync("xclip", ["-selection", "clipboard"], { input: text });
+        return true;
+      }
+      const resWl = spawnSync("which", ["wl-copy"]);
+      if (resWl.status === 0) {
+        spawnSync("wl-copy", { input: text });
+        return true;
+      }
+      return false;
+    }
+  } catch {
+    return false;
+  }
+}
+
+function runInteractive(profile) {
+  return new Promise((resolve) => {
+    const email = profile.email || "zephinax@gmail.com";
+    const web = profile.website || "https://zephinax.com";
+    const github = `https://github.com/${profile.username || "zephinax"}`;
+
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+
+    console.log("\n" + color.bold(color.cyan("Actions:")));
+    console.log(`  ${color.yellow("[1]")} 🌐 Open Website  ${color.dim(`(${web})`)}`);
+    console.log(`  ${color.yellow("[2]")} 🐙 Open GitHub   ${color.dim(`(${github})`)}`);
+    console.log(`  ${color.yellow("[3]")} ✉️  Send Email    ${color.dim(`(${email})`)}`);
+    console.log(`  ${color.yellow("[4]")} 📋 Copy Email    ${color.dim(`(${email})`)}`);
+    console.log(`  ${color.yellow("[q]")} 🚪 Exit\n`);
+
+    const ask = () => {
+      rl.question(color.cyan("Select an option (1-4, or press Enter/q to exit): "), (answer) => {
+        const choice = answer.trim().toLowerCase();
+        switch (choice) {
+          case "1":
+            console.log(color.dim(`Opening ${web}...`));
+            openUrl(web);
+            ask();
+            break;
+          case "2":
+            console.log(color.dim(`Opening ${github}...`));
+            openUrl(github);
+            ask();
+            break;
+          case "3":
+            console.log(color.dim(`Opening email client...`));
+            openUrl(`mailto:${email}`);
+            ask();
+            break;
+          case "4": {
+            const ok = copyToClipboard(email);
+            if (ok) {
+              console.log(color.green(`✓ Email copied to clipboard!`));
+            } else {
+              console.log(color.yellow(`Clipboard unavailable. Email: ${email}`));
+            }
+            ask();
+            break;
+          }
+          case "":
+          case "q":
+          case "quit":
+          case "exit":
+            console.log(color.dim("Thanks for stopping by!"));
+            rl.close();
+            resolve();
+            break;
+          default:
+            console.log(color.magenta("Invalid option. Please enter 1, 2, 3, 4, or q."));
+            ask();
+            break;
+        }
+      });
+    };
+
+    rl.on("close", resolve);
+    ask();
+  });
+}
+
+async function fetchProfile(url, timeoutMs = 3000) {
+  let controller;
+  let timeoutId;
+  if (typeof AbortController !== "undefined") {
+    controller = new AbortController();
+    timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+  }
+
+  try {
+    if (typeof fetch === "function") {
+      const res = await fetch(url, {
+        signal: controller ? controller.signal : undefined,
+        headers: { "User-Agent": "zephinax-cli-cv" }
+      });
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      const json = await res.json();
+      return { profile: json.data || json, fromNetwork: true };
+    }
+
+    return await new Promise((resolve, reject) => {
+      const req = https.get(url, { timeout: timeoutMs }, (res) => {
+        let data = "";
+        res.on("data", (chunk) => (data += chunk));
+        res.on("end", () => {
+          if (res.statusCode < 200 || res.statusCode >= 300) {
+            return reject(new Error(`HTTP ${res.statusCode}`));
+          }
+          try {
+            const json = JSON.parse(data);
+            resolve({ profile: json.data || json, fromNetwork: true });
+          } catch (err) {
+            reject(err);
+          }
+        });
+      });
+      req.on("error", reject);
+      req.on("timeout", () => {
+        req.destroy();
+        reject(new Error("Request timed out"));
+      });
+    });
   } catch (err) {
-    console.error(`${color.magenta("Error:")} ${err.message}`);
-    process.exitCode = 1;
+    return { profile: FALLBACK_PROFILE, fromNetwork: false, error: err.message };
+  } finally {
+    if (timeoutId) clearTimeout(timeoutId);
+  }
+}
+
+function showHelp() {
+  console.log(`
+${color.bold("Zephinax (Amirali Rajabi)")} - CLI Portfolio & CV
+
+${color.yellow("Usage:")}
+  npx zephinax [options]
+
+${color.yellow("Options:")}
+  -s, --static         Print card without interactive action prompt
+  -j, --json           Output profile data in raw JSON format
+  -p, --plain          Output clean plain text without borders or ANSI colors
+      --offline        Use embedded profile data without making network requests
+  -h, --help           Show this help message
+  -v, --version        Show version number
+`);
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.includes("-h") || args.includes("--help")) {
+    showHelp();
+    return;
+  }
+
+  if (args.includes("-v") || args.includes("--version")) {
+    console.log(PKG.version);
+    return;
+  }
+
+  const isJson = args.includes("-j") || args.includes("--json");
+  const isPlain = args.includes("-p") || args.includes("--plain");
+  const isOffline = args.includes("--offline");
+  const isStatic =
+    args.includes("-s") ||
+    args.includes("--static") ||
+    args.includes("--no-interactive");
+
+  let profile;
+  let fromNetwork = false;
+
+  if (isOffline) {
+    profile = FALLBACK_PROFILE;
+  } else {
+    const res = await fetchProfile(API_URL);
+    profile = { ...FALLBACK_PROFILE, ...res.profile };
+    fromNetwork = res.fromNetwork;
+  }
+
+  if (isJson) {
+    const { about, quote } = parseAboutAndQuote(profile.about);
+    console.log(
+      JSON.stringify(
+        {
+          ...profile,
+          skills: profile.skills || DEFAULT_SKILLS,
+          quote: profile.quote || quote,
+          about: about || profile.about,
+          source: fromNetwork ? "network" : "offline_cache"
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+
+  if (isPlain) {
+    console.log(renderPlain(profile));
+    return;
+  }
+
+  console.log(render(profile));
+
+  const isInteractiveTerminal = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+  if (isInteractiveTerminal && !isStatic) {
+    await runInteractive(profile);
   }
 }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zephinax",
-  "version": "1.0.0",
-  "description": "CLI portfolio for Zephinax. Fetches live profile data and prints it to the terminal.",
+  "version": "1.1.0",
+  "description": "Interactive CLI portfolio and CV for Amirali Rajabi (Zephinax).",
   "bin": {
     "zephinax": "bin/index.js"
   },
@@ -11,10 +11,22 @@
   "keywords": [
     "portfolio",
     "cli",
-    "zephinax"
+    "cv",
+    "resume",
+    "zephinax",
+    "terminal-card",
+    "interactive"
   ],
   "author": "Zephinax <zephinax@gmail.com>",
   "license": "MIT",
+  "homepage": "https://zephinax.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zephinax/zephinax.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zephinax/zephinax/issues"
+  },
   "engines": {
     "node": ">=18"
   }