brignano 1.0.0 → 1.1.0

package/src/menu.ts

@@ -0,0 +1,84 @@
+import chalk from 'chalk';
+import clipboard from 'clipboardy';
+import open from 'open';
+import { profile } from './data.js';
+import { renderQr } from './qrcode.js';
+import { buildVCard, writeAndOpenVCard } from './vcard.js';
+
+// --- Action helpers (kept as named functions so flags and the menu share them) ---
+
+export async function copyEmail(): Promise<void> {
+  try {
+    await clipboard.write(profile.email);
+    console.log(`\n${chalk.green('Copied')} ${profile.email} to your clipboard.\n`);
+  } catch {
+    // Clipboard access fails in headless/SSH environments — degrade gracefully.
+    console.log(`\nMy email is ${chalk.green(profile.email)} — drop me a line!\n`);
+  }
+}
+
+export async function sendEmail(): Promise<void> {
+  try {
+    await open(`mailto:${profile.email}`);
+    console.log('\nOpened your mail client — see you in the inbox.\n');
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`Failed to open mail client: ${message}`);
+    console.error(`Reach me directly at ${profile.email}`);
+  }
+}
+
+export async function openUrl(url: string, label: string): Promise<void> {
+  try {
+    await open(url);
+    console.log(`\nOpened ${label}: ${url}\n`);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`Failed to open ${label}: ${message}`);
+    console.error(`Here it is: ${url}`);
+  }
+}
+
+export async function viewResume(): Promise<void> {
+  await openUrl(profile.resume, 'resume');
+}
+
+export async function showContactQr(): Promise<void> {
+  const qr = await renderQr(buildVCard());
+  console.log('\nScan to save my contact:\n');
+  console.log(qr);
+}
+
+// --- Menu definition ---
+
+export interface MenuChoice {
+  name: string;
+  value: () => void | Promise<void>;
+}
+
+export function buildChoices(): MenuChoice[] {
+  return [
+    { name: `Copy my ${chalk.green.bold('email')} to clipboard`, value: copyEmail },
+    { name: `Send me an ${chalk.green.bold('email')}`, value: sendEmail },
+    {
+      name: `Open my ${chalk.green.bold('GitHub')}`,
+      value: () => openUrl(profile.github, 'GitHub'),
+    },
+    {
+      name: `Open my ${chalk.blue.bold('LinkedIn')}`,
+      value: () => openUrl(profile.linkedin, 'LinkedIn'),
+    },
+    { name: `View my ${chalk.magentaBright.bold('resume')}`, value: viewResume },
+    {
+      name: `Save my ${chalk.cyan.bold('contact')} (.vcf)`,
+      value: writeAndOpenVCard,
+    },
+    { name: `Show a ${chalk.yellow.bold('contact QR')} code`, value: showContactQr },
+    {
+      name: 'Just quit',
+      value: () => {
+        console.log('\nHave a great day!\n');
+      },
+    },
+  ];
+}

package/src/qrcode.ts

@@ -0,0 +1,9 @@
+import qrcode from 'qrcode-terminal';
+
+// Promisified wrapper around qrcode-terminal's callback API. `small: true` keeps
+// the code compact enough for most terminals.
+export function renderQr(text: string): Promise<string> {
+  return new Promise((resolve) => {
+    qrcode.generate(text, { small: true }, (output: string) => resolve(output));
+  });
+}

package/src/reveal.ts

@@ -0,0 +1,25 @@
+// Tiny animation helpers — no dependencies. Line-by-line reveal is immune to the
+// ANSI-escape-splitting problem a per-character typewriter would hit, and the
+// total budget stays well under a second.
+
+export function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// Prints `text` one line at a time, pausing `perLineMs` between lines.
+// When `animate` is false, prints everything at once (CI / piped / --no-animation).
+export async function reveal(
+  text: string,
+  perLineMs = 35,
+  animate = true,
+): Promise<void> {
+  if (!animate) {
+    console.log(text);
+    return;
+  }
+  const lines = text.split('\n');
+  for (const line of lines) {
+    console.log(line);
+    await sleep(perLineMs);
+  }
+}

package/src/types/qrcode-terminal.d.ts

@@ -0,0 +1,13 @@
+// qrcode-terminal ships no official types and is CJS. Minimal ambient shim.
+declare module 'qrcode-terminal' {
+  interface GenerateOptions {
+    small?: boolean;
+  }
+  function generate(
+    input: string,
+    options?: GenerateOptions,
+    callback?: (output: string) => void,
+  ): void;
+  const qrcode: { generate: typeof generate };
+  export default qrcode;
+}

package/src/vcard.ts

@@ -0,0 +1,41 @@
+import { writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import open from 'open';
+import { profile } from './data.js';
+
+// Builds a valid vCard 3.0 string (broadest contact-app compatibility) with the
+// spec-required CRLF line endings.
+export function buildVCard(): string {
+  const lines = [
+    'BEGIN:VCARD',
+    'VERSION:3.0',
+    `N:${profile.lastName};${profile.firstName};;;`,
+    `FN:${profile.fullName}`,
+    `ORG:${profile.org}`,
+    `TITLE:${profile.title}`,
+    `EMAIL;TYPE=INTERNET,PREF:${profile.email}`,
+    `URL:${profile.website}`,
+    `X-SOCIALPROFILE;TYPE=github:${profile.github}`,
+    `X-SOCIALPROFILE;TYPE=linkedin:${profile.linkedin}`,
+    'NOTE:npx brignano',
+    'END:VCARD',
+  ];
+  return lines.join('\r\n') + '\r\n';
+}
+
+// Writes the vCard to a temp file and asks the OS to open it (Contacts on
+// macOS/iOS, the default handler elsewhere). On failure, prints the path so the
+// user can open it manually — never throws.
+export async function writeAndOpenVCard(): Promise<void> {
+  const file = join(tmpdir(), 'anthony-brignano.vcf');
+  try {
+    writeFileSync(file, buildVCard(), 'utf8');
+    await open(file);
+    console.log(`\nSaved my contact card to: ${file}\n`);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`\nCouldn't open the contact card automatically (${message}).`);
+    console.error(`It's saved here — open it manually: ${file}\n`);
+  }
+}

package/vhs/demo.tape

@@ -0,0 +1,40 @@
+# Demo recording for `npx brignano`.
+# Regenerate with:  vhs vhs/demo.tape   (requires: brew install vhs)
+# Renders the gradient banner, the live card, menu navigation, and a contact QR.
+
+Output demo.gif
+Require node
+
+Set Shell "zsh"
+Set FontSize 14
+Set Width 1000
+Set Height 1000
+Set Padding 20
+Set Theme "GitHub Dark"
+Set TypingSpeed 55ms
+
+# Launch the local build so the demo reflects this branch (not the published npm version).
+Type "node dist/card.js"
+Sleep 400ms
+Enter
+
+# Banner animation + card reveal + live GitHub stats.
+Sleep 4s
+
+# Walk down the menu to showcase the actions.
+Down
+Sleep 600ms
+Down
+Sleep 600ms
+Down
+Sleep 600ms
+Down
+Sleep 600ms
+Down
+Sleep 600ms
+Down
+Sleep 800ms
+
+# Land on "Show a contact QR code" and select it.
+Enter
+Sleep 3s